页面UI替换1远程遥控和各项弹窗和作业主页面和子页面+路径规划的主页面重构等
This commit is contained in:
@@ -0,0 +1,240 @@
|
||||
import 'package:latlong2/latlong.dart';
|
||||
|
||||
/// 跨环境统一的作业运行态:UI 只认这一套枚举。
|
||||
/// 各环境自己的任务状态码(NEW/EXECUTING/PAUSE/… 或别的后端字段)
|
||||
/// 由各自的 gateway 实现映射到这里,页面不感知原始状态码。
|
||||
enum WorkRunState {
|
||||
idle, // 准备:没有任何任务
|
||||
queued, // 已下发,等待设备接单
|
||||
running, // 执行中
|
||||
paused, // 暂停 / 中断
|
||||
finished, // 正常结束或被终止
|
||||
failed, // 异常失败
|
||||
}
|
||||
|
||||
extension WorkRunStateX on WorkRunState {
|
||||
bool get hasTask => this != WorkRunState.idle;
|
||||
bool get isRunning => this == WorkRunState.running;
|
||||
bool get isPaused => this == WorkRunState.paused;
|
||||
bool get isQueued => this == WorkRunState.queued;
|
||||
bool get isFinished => this == WorkRunState.finished;
|
||||
|
||||
/// 顶部 5 段阶段胶囊的分组:failed 归到「暂停/中断」
|
||||
WorkRunState get chipGroup =>
|
||||
this == WorkRunState.failed ? WorkRunState.paused : this;
|
||||
|
||||
String get label => switch (this) {
|
||||
WorkRunState.idle => '准备',
|
||||
WorkRunState.queued => '待执行',
|
||||
WorkRunState.running => '执行中',
|
||||
WorkRunState.paused => '暂停/中断',
|
||||
WorkRunState.finished => '已结束',
|
||||
WorkRunState.failed => '异常中断',
|
||||
};
|
||||
}
|
||||
|
||||
/// 路线库中的一条可执行路线(对应路径规划列表里的一条作业记录)
|
||||
class WorkRouteOption {
|
||||
const WorkRouteOption({
|
||||
required this.id,
|
||||
required this.name,
|
||||
this.pathPoints = const <LatLng>[],
|
||||
this.outerPoints = const <LatLng>[],
|
||||
this.planModeLabel,
|
||||
this.imageUrl,
|
||||
this.metaText,
|
||||
this.coverageMode = true,
|
||||
this.extras = const <String, dynamic>{},
|
||||
});
|
||||
|
||||
/// 统一用字符串:A 环境是 int routeId,B 环境可能是 uuid / 名称
|
||||
final String id;
|
||||
final String name;
|
||||
final List<LatLng> pathPoints;
|
||||
final List<LatLng> outerPoints;
|
||||
final String? planModeLabel;
|
||||
final String? imageUrl;
|
||||
final String? metaText;
|
||||
|
||||
/// 是否「覆盖模式」(A 环境 planModel == 0)。
|
||||
/// 与路径规划页一致:覆盖模式画 outer 灰色半透明边界框,自定义模式不画。
|
||||
final bool coverageMode;
|
||||
|
||||
/// 环境专有字段放这里,页面不解析
|
||||
final Map<String, dynamic> extras;
|
||||
|
||||
bool get hasGeometry => pathPoints.isNotEmpty || outerPoints.isNotEmpty;
|
||||
List<LatLng> get previewPoints =>
|
||||
pathPoints.isNotEmpty ? pathPoints : outerPoints;
|
||||
|
||||
/// 预览时要画的边界框:只有覆盖模式才画(与路径规划选中路线的行为一致)
|
||||
List<LatLng> get previewOuter =>
|
||||
coverageMode ? outerPoints : const <LatLng>[];
|
||||
|
||||
/// 补齐几何时用:列表接口只给元数据,详情接口才给 path/outer。
|
||||
WorkRouteOption copyWith({
|
||||
String? id,
|
||||
String? name,
|
||||
List<LatLng>? pathPoints,
|
||||
List<LatLng>? outerPoints,
|
||||
String? planModeLabel,
|
||||
String? imageUrl,
|
||||
String? metaText,
|
||||
bool? coverageMode,
|
||||
Map<String, dynamic>? extras,
|
||||
}) {
|
||||
return WorkRouteOption(
|
||||
id: id ?? this.id,
|
||||
name: name ?? this.name,
|
||||
pathPoints: pathPoints ?? this.pathPoints,
|
||||
outerPoints: outerPoints ?? this.outerPoints,
|
||||
planModeLabel: planModeLabel ?? this.planModeLabel,
|
||||
imageUrl: imageUrl ?? this.imageUrl,
|
||||
metaText: metaText ?? this.metaText,
|
||||
coverageMode: coverageMode ?? this.coverageMode,
|
||||
extras: extras ?? this.extras,
|
||||
);
|
||||
}
|
||||
}
|
||||
|
||||
/// 任务快照:跨环境统一的只读视图
|
||||
class WorkTaskSnapshot {
|
||||
const WorkTaskSnapshot({
|
||||
required this.taskId,
|
||||
required this.deviceId,
|
||||
required this.state,
|
||||
this.routeId,
|
||||
this.routeName,
|
||||
this.rawStatus = '',
|
||||
this.createdAt,
|
||||
this.progress,
|
||||
this.coveredArea,
|
||||
this.plannedArea,
|
||||
this.extras = const <String, dynamic>{},
|
||||
});
|
||||
|
||||
final String taskId;
|
||||
final String deviceId;
|
||||
final WorkRunState state;
|
||||
final String? routeId;
|
||||
final String? routeName;
|
||||
|
||||
/// 环境原始状态码,仅用于展示/排障
|
||||
final String rawStatus;
|
||||
final String? createdAt;
|
||||
|
||||
/// 0~1;null 表示该环境不提供进度(页面显示不确定进度条)
|
||||
final double? progress;
|
||||
final double? coveredArea;
|
||||
final double? plannedArea;
|
||||
final Map<String, dynamic> extras;
|
||||
|
||||
bool get isActive =>
|
||||
state == WorkRunState.queued ||
|
||||
state == WorkRunState.running ||
|
||||
state == WorkRunState.paused;
|
||||
|
||||
WorkTaskSnapshot copyWith({
|
||||
WorkRunState? state,
|
||||
String? rawStatus,
|
||||
String? routeId,
|
||||
String? routeName,
|
||||
double? progress,
|
||||
}) {
|
||||
return WorkTaskSnapshot(
|
||||
taskId: taskId,
|
||||
deviceId: deviceId,
|
||||
state: state ?? this.state,
|
||||
routeId: routeId ?? this.routeId,
|
||||
routeName: routeName ?? this.routeName,
|
||||
rawStatus: rawStatus ?? this.rawStatus,
|
||||
createdAt: createdAt,
|
||||
progress: progress ?? this.progress,
|
||||
coveredArea: coveredArea,
|
||||
plannedArea: plannedArea,
|
||||
extras: extras,
|
||||
);
|
||||
}
|
||||
}
|
||||
|
||||
/// 环境能力声明:页面据此隐藏/禁用入口,而不是假设「所有环境功能一样」
|
||||
class WorkSceneCapabilities {
|
||||
const WorkSceneCapabilities({
|
||||
this.routeLibrary = true,
|
||||
this.taskQueue = true,
|
||||
this.pause = true,
|
||||
this.resume = true,
|
||||
this.stop = true,
|
||||
this.cancelQueued = true,
|
||||
this.schedule = false,
|
||||
this.routeEditing = false,
|
||||
this.progress = false,
|
||||
this.multiActiveTaskResolve = false,
|
||||
});
|
||||
|
||||
final bool routeLibrary;
|
||||
final bool taskQueue;
|
||||
final bool pause;
|
||||
final bool resume;
|
||||
final bool stop;
|
||||
final bool cancelQueued;
|
||||
final bool schedule;
|
||||
final bool routeEditing;
|
||||
|
||||
/// 是否下发真实进度(false 时页面不臆造百分比)
|
||||
final bool progress;
|
||||
|
||||
/// 是否可能出现「多个活跃任务需要用户选择」
|
||||
final bool multiActiveTaskResolve;
|
||||
|
||||
static const WorkSceneCapabilities none = WorkSceneCapabilities(
|
||||
routeLibrary: false,
|
||||
taskQueue: false,
|
||||
pause: false,
|
||||
resume: false,
|
||||
stop: false,
|
||||
cancelQueued: false,
|
||||
);
|
||||
}
|
||||
|
||||
/// 作业作用域:场站/组织等环境相关的上下文
|
||||
class WorkScope {
|
||||
const WorkScope({this.siteId, this.orgId});
|
||||
|
||||
final int? siteId;
|
||||
final int? orgId;
|
||||
|
||||
bool get hasSite => siteId != null;
|
||||
}
|
||||
|
||||
/// 下发作业的入参
|
||||
class WorkStartRequest {
|
||||
const WorkStartRequest({
|
||||
required this.deviceId,
|
||||
required this.route,
|
||||
this.siteId,
|
||||
this.orgId,
|
||||
this.reuseTaskId,
|
||||
this.extras = const <String, dynamic>{},
|
||||
});
|
||||
|
||||
final String deviceId;
|
||||
final WorkRouteOption route;
|
||||
final int? siteId;
|
||||
final int? orgId;
|
||||
|
||||
/// 复用设备上已存在的活跃任务(不再重复 createDeviceTask)
|
||||
final String? reuseTaskId;
|
||||
final Map<String, dynamic> extras;
|
||||
}
|
||||
|
||||
/// 统一返回:不把 Either/Failure 泄漏给 UI,任何环境实现都能套
|
||||
class WorkResult<T> {
|
||||
const WorkResult.ok(T this.data) : error = null;
|
||||
const WorkResult.fail(String this.error) : data = null;
|
||||
|
||||
final T? data;
|
||||
final String? error;
|
||||
|
||||
bool get isOk => error == null;
|
||||
}
|
||||
@@ -0,0 +1,93 @@
|
||||
import 'package:latlong2/latlong.dart';
|
||||
|
||||
import '../entities/work_session_models.dart';
|
||||
|
||||
/// 自主作业的业务门面。
|
||||
///
|
||||
/// 一套页面功能,多套环境实现:
|
||||
/// - A 环境(作业记录 + 任务池接口)→ PathPlanningWorkGateway
|
||||
/// - B 环境(另一套后端 / 本地离线)→ 新增一个 implements 类即可,页面零改动
|
||||
///
|
||||
/// 约定:
|
||||
/// 1. 所有方法与流都用 [WorkRunState] / [WorkTaskSnapshot] 表达,禁止把各自
|
||||
/// 后端的原始实体、原始状态码泄漏到表现层;
|
||||
/// 2. 能力差异通过 [capabilities] 声明,页面据此决定入口/按钮的可见与可用;
|
||||
/// 3. 失败不抛异常,统一返回 [WorkResult.fail]。
|
||||
abstract class AutonomousWorkGateway {
|
||||
/// 环境标识(日志/排障用),如 path_planning / local_demo
|
||||
String get gatewayId;
|
||||
|
||||
/// 当前环境支持哪些能力
|
||||
WorkSceneCapabilities get capabilities;
|
||||
|
||||
/// 解析作业作用域(场站/组织)。不同环境来源不同:
|
||||
/// A 环境取「当前选中场站」,B 环境可能取设备绑定信息或固定值。
|
||||
Future<WorkScope> resolveScope({required String deviceId});
|
||||
|
||||
/// 路线库:一条记录 = 一条可执行路线
|
||||
Future<WorkResult<List<WorkRouteOption>>> loadRoutes({required int siteId});
|
||||
|
||||
/// 补齐一条路线的完整几何(轨迹 + 作业区域边界),用于「选中即在地图上画线」。
|
||||
///
|
||||
/// 列表接口往往只返回元数据(A 环境 selectBySiteId 的 jsonData 可能是空标签),
|
||||
/// 所以选中后要像路径规划那样按作业名回查一次详情。
|
||||
/// 实现返回的路线 id 必须与入参一致,页面据此替换当前选中项。
|
||||
Future<WorkResult<WorkRouteOption>> resolveRouteGeometry({
|
||||
required String deviceId,
|
||||
required WorkRouteOption route,
|
||||
});
|
||||
|
||||
/// 任务队列:设备当前的活跃任务
|
||||
Future<WorkResult<List<WorkTaskSnapshot>>> loadTasks({
|
||||
required String deviceId,
|
||||
});
|
||||
|
||||
/// 保存圈地结果(1:1 复刻路径规划「保存区域」链路)。
|
||||
///
|
||||
/// - [path]:作业几何;[outer]:作业区边界(自定义模式传空)
|
||||
/// - [planModel]:0 = 覆盖模式、2 = 自定义模式(与 mode 字段同源)
|
||||
/// - [imageBase64]:地图截图(jpg,不带 data url 前缀),截图失败传 null
|
||||
///
|
||||
/// 环境差异(接口地址/鉴权/截图是否必需)全部封在实现里,页面只负责取几何。
|
||||
Future<WorkResult<bool>> saveRouteRecord({
|
||||
required String deviceId,
|
||||
required String name,
|
||||
required List<LatLng> path,
|
||||
required List<LatLng> outer,
|
||||
required int planModel,
|
||||
String? imageBase64,
|
||||
});
|
||||
|
||||
/// 当前任务实时状态流(null 表示设备上没有活跃任务)
|
||||
Stream<WorkTaskSnapshot?> watchTask({required String deviceId});
|
||||
|
||||
Future<WorkResult<WorkTaskSnapshot>> startWork(WorkStartRequest request);
|
||||
|
||||
Future<WorkResult<WorkTaskSnapshot>> pauseWork({
|
||||
required String deviceId,
|
||||
required WorkTaskSnapshot task,
|
||||
});
|
||||
|
||||
Future<WorkResult<WorkTaskSnapshot>> resumeWork({
|
||||
required String deviceId,
|
||||
required WorkTaskSnapshot task,
|
||||
});
|
||||
|
||||
Future<WorkResult<WorkTaskSnapshot>> stopWork({
|
||||
required String deviceId,
|
||||
required WorkTaskSnapshot task,
|
||||
});
|
||||
|
||||
/// 只取消尚未执行的任务
|
||||
Future<WorkResult<WorkTaskSnapshot>> cancelQueued({
|
||||
required String deviceId,
|
||||
required WorkTaskSnapshot task,
|
||||
});
|
||||
|
||||
/// 把某条已有任务切成「当前任务」:任务队列里点选一条作业后,
|
||||
/// 主窗口状态与地图路线都跟着切到它(对应路径规划点击列表项的行为)。
|
||||
Future<WorkResult<WorkTaskSnapshot>> activateTask({
|
||||
required String deviceId,
|
||||
required WorkTaskSnapshot task,
|
||||
});
|
||||
}
|
||||
Reference in New Issue
Block a user