远程遥控相关

This commit is contained in:
2026-11-06 08:34:19 +08:00
parent eb8dec2868
commit d882db7995
42 changed files with 5023 additions and 631 deletions

View File

@@ -1,6 +1,18 @@
import 'package:latlong2/latlong.dart';
import '../entities/work_session_models.dart';
import '../entities/return_plan_models.dart';
/// 可查询真实任务记录的新版实现;未实现时页面明确显示不可用。
abstract interface class WorkTaskHistorySource {
Future<WorkResult<List<WorkTaskSnapshot>>> loadTaskHistory({
required String deviceId,
});
}
abstract interface class WorkTaskQueueSource {
Stream<WorkTaskSnapshot?> watchTaskChanges({required String deviceId});
}
/// 自主作业的业务门面。
///
@@ -46,6 +58,9 @@ abstract class AutonomousWorkGateway {
///
/// - [path]:作业几何;[outer]:作业区边界(自定义模式传空)
/// - [planModel]:0 = 覆盖模式、2 = 自定义模式(与 mode 字段同源)
/// - [routeType]:后端 workRecord.routeType,取 RouteType 枚举的 code
/// (如 'MOWING_TASK')。后端必填、与 mode 平级,缺失会报「未选择规划类型」;
/// 这里用 String 而不是枚举,避免 domain 层反向依赖 presentation。
/// - [imageBase64]:地图截图(jpg,不带 data url 前缀),截图失败传 null
///
/// 环境差异(接口地址/鉴权/截图是否必需)全部封在实现里,页面只负责取几何。
@@ -55,9 +70,29 @@ abstract class AutonomousWorkGateway {
required List<LatLng> path,
required List<LatLng> outer,
required int planModel,
required String routeType,
String? imageBase64,
});
/// 保存一键返航方案(返航点 + 线上禁行区)→ /system/siteMapInfo/save。
///
/// 接口地址、后端字段名(size_x / tempObstaclePoints / source 等)、
/// 鉴权与 id 语义(有 id=更新、无 id=新建)全部封在实现里;
/// 页面只交出业务数据 [ReturnPlanDraft]。
/// 返回 data = 后端回写的 siteMapInfo 主键(拿不到则为 null,仅表示无法回填更新)。
Future<WorkResult<int?>> saveReturnPlan(ReturnPlanDraft draft);
/// 查询某场站已有的一键返航方案 → /system/siteMapInfo/selectBySiteId。
///
/// 一个场站业务上只允许一条方案,接口直接返回带完整几何的单体:
/// - 有 → data 为回填好的 [ReturnPlanDraft](id 非空 = 修改态)
/// - 无 → data 为 null(进入空白新建态)
/// 接口地址 / 后端字段名(size_x / tempObstaclePoints 等)/ 鉴权全部封在实现里,
/// 页面只按 data 是否为 null 决定「修改」还是「新建」。
Future<WorkResult<ReturnPlanDraft?>> fetchReturnPlanBySiteId({
required int siteId,
});
/// 当前任务实时状态流(null 表示设备上没有活跃任务)
Stream<WorkTaskSnapshot?> watchTask({required String deviceId});