页面UI替换1远程遥控和各项弹窗和作业主页面和子页面+路径规划的主页面重构等

This commit is contained in:
2026-10-28 14:38:24 +08:00
parent 8a41113c92
commit eb8dec2868
64 changed files with 25316 additions and 1174 deletions

View File

@@ -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;
}

View File

@@ -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,
});
}