1.5 KiB
1.5 KiB
工作台工单与告警存储契约
工作台只聚合预约工单与任务主动推送的告警。浏览器不推导告警，也不写正式工单。
任务告警
DDL 位于 resources/sql/008_workbench_alert_events.sql。任务通过 POST /api/v1/workbench/task-alert-events 推送 raised、acknowledged 或 resolved 事件。来源包含 task_type、task_id 和 run_id，生产者由认证项目身份绑定。event_id 在项目和生产者范围内幂等，告警事实在首次 raised 后不可改写。
预约工单
workbench.work_orders 的 DDL 位于 resources/sql/011_workbench_work_orders.sql。每行保存一个只读工单投影，文档必须满足 WorkbenchRuntimeWorkOrder：
- 一张主工单包含一个或多个
subtasks。 - 每个子任务保存自己的位置、班组、时间窗和复令要求。
- 每个子任务包含一个或多个有序
stages，sequence从 1 连续递增，阶段编号在子任务内唯一，最多只有一个current阶段。 - 阶段名称不写死为固定枚举。演示数据使用派发、执行、复令，正式工单适配器可以按业务定义其他阶段。
演示数据可以先运行 scripts/seed_peripheral_sample.py，再运行 scripts/seed_workbench_work_orders.py 投影。工作台会显示一张主工单，三项外围核查分别作为子任务展示。
工作台运行账号对工单表只需 SELECT，同步账号使用独立受控写权限；对告警事件表需要 SELECT, INSERT，对告警状态表需要 SELECT, INSERT, UPDATE。