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 后不可改写。
预约工单
外围样板的 peripheral_sample.work_orders 是演示工单的管理来源；activity 只记录实际发生的创建、修改和现场反馈，不由总状态补造阶段。同步器将有效工单写入 workbench.operational_tasks 的 external_work_order 投影。原有三张独立演示工单也已迁入外围样板，并由同一面板管理。
resources/sql/011_workbench_work_orders.sql 和 017_workbench_schema_comments.sql 属于历史基线；021_retire_workbench_work_orders.sql 在验证三个迁入目标及其任务投影后，仅在 tjwater_v2 删除旧表。不要重放 011 重建它。GET /api/v1/workbench/runtime 暂保留空的 work_orders 字段作为接口兼容。其他项目数据库没有旧表，不需要应用 021。
告警事件表需要 SELECT, INSERT，告警状态表需要 SELECT, INSERT, UPDATE。迁移及扩展门禁见 workbench-database-rollout.md。