21 lines
1.5 KiB
Markdown
21 lines
1.5 KiB
Markdown
# 工作台工单与告警存储契约
|
||
|
||
工作台只聚合预约工单与任务主动推送的告警。浏览器不推导告警，也不写正式工单。
|
||
|
||
## 任务告警
|
||
|
||
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`。
|