docs: 跟踪 Monitor 架构与持久化重构
Pipelines as Code CI / hwlab-web-probe-sentinel-nc01- Success
Pipelines as Code CI / platform-infra-gitea-nc01- Success
Pipelines as Code CI / unidesk-host- Success

This commit is contained in:
Codex
2026-07-12 21:29:18 +02:00
parent 2333091bba
commit 6065d5a717
@@ -1,7 +1,7 @@
# Web 哨兵运行时可靠性
# Monitor / Web 哨兵运行时与持久化
- 范围:Web sentinel 调度、observe/analyze 终态、报告产物、SQLite/index 与 latest 查询的一致性。
- 权威路径:沿用 YAML-first Web sentinel、既有 observe/analyze、报告产物和单一索引,不建立旁路 scheduler、store 或补洞入口。
- 范围:Monitor / Web Sentinel 的需求与架构、调度、runner 执行、observe/analyze 终态、报告产物、统一持久化、查询 API、monitor-web 与运行时可靠性。
- 权威路径:遵循 YAML-first;每个阶段只保留一个调度权威和一个持久化/查询权威,不建立旁路 scheduler、永久双写、fallback store 或补洞入口。
## R1 [in_progress]
@@ -23,3 +23,23 @@ PR 合并后只等待自动发布链,使用受控 Web sentinel 原入口产生
### R1.4 [in_progress]
核对 [#1861](https://github.com/pikasTech/unidesk/issues/1861) 的小时级实际探测 cadence 与 10 分钟 scheduler heartbeat/扫描间隔;若只读报告语义误导则纠正字段和文档,若 owning YAML 未生效则修正渲染,验收 CronJob 与报告明确区分二者,完成任务后将详细报告写入[任务报告](./details/web-sentinel-runtime-reliability/R1.4_Task_Report.md)。
## R2 [in_progress]
推进 [UniDesk #1868](https://github.com/pikasTech/unidesk/issues/1868):按当前多 runner、全局查询与 Dashboard 复杂度重构 Monitor 平台,评估并实施分散 SQLite 到 NC01 YAML-first Host PostgreSQL 的统一迁移;P0 先冻结架构、数据模型和切换边界,再实现、自动发布和原入口验收,不以迁移掩盖 [#1861](https://github.com/pikasTech/unidesk/issues/1861),不保留永久双写或第二权威,完成任务后将详细报告写入[任务报告](./details/web-sentinel-runtime-reliability/R2_Task_Report.md)。
### R2.1 [in_progress]
完成 [#1869](https://github.com/pikasTech/unidesk/issues/1869) 的需求演进、组件职责与复杂度失效边界审计,形成目标架构 must/should/out-of-scope 和候选方案,完成任务后将详细报告写入[任务报告](./details/web-sentinel-runtime-reliability/R2.1_Task_Report.md)。
### R2.2 [in_progress]
完成 [#1871](https://github.com/pikasTech/unidesk/issues/1871) 的 SQLite 实例、schema、数据规模与生命周期盘点,设计 NC01 Host PG schema、YAML role/database/export、一次性迁移、校验、切换和回滚,完成任务后将详细报告写入[任务报告](./details/web-sentinel-runtime-reliability/R2.2_Task_Report.md)。
### R2.3 [in_progress]
完成 [#1870](https://github.com/pikasTech/unidesk/issues/1870) 的 service/scheduler/runner API/monitor-web 调用链审计,冻结中心 Monitor 服务拆分、唯一写入/查询权威和故障隔离边界,完成任务后将详细报告写入[任务报告](./details/web-sentinel-runtime-reliability/R2.3_Task_Report.md)。
### R2.4
由主代理汇总 R2.1-R2.3 冻结 [#1868](https://github.com/pikasTech/unidesk/issues/1868) 架构规格,再按规格拆实施 issue/PR,迁移已有数据,等待自动 CI/CD,并用 CLI、Monitor 页面和 Web Sentinel 原入口完成一致性验收及旧 SQLite 权威退役,完成任务后将详细报告写入[任务报告](./details/web-sentinel-runtime-reliability/R2.4_Task_Report.md)。