docs: adopt harness coding workflow

docs/routes.md

@@ -0,0 +1,46 @@
+# 路由与页面结构
+
+> Bell 前端框架和最终信息架构尚未冻结。本文件先固定页面职责与规模约束，具体 URL 在 UI 原型任务中确认。
+
+## 管理 Web 候选路由
+
+| 候选路由 | 页面职责 | 关键约束 |
+| --- | --- | --- |
+| `/overview` | 站点、设备、事件和预警摘要 | 业务预警与运维告警分区 |
+| `/sites` | 站点列表、配额与状态 | 显示 16 默认/128 上限，不暗示单机能力 |
+| `/sites/:siteId/devices` | 设备列表、批量导入/启停、健康 | 分页/虚拟列表、逐项结果、不泄露凭据 |
+| `/events` | 事件筛选与批量处置入口 | 事件与预警状态分开显示 |
+| `/events/:eventId` | 事实、证据、时间线、outcome | 权限最小化；弱网渐进加载 |
+| `/alerts` | 待 ack、升级中、已结束预警 | 清楚区分投递/送达/看到/ack |
+| `/rules` | 场景包、规则继承、区域/时段配置 | 显示继承来源与试运行状态 |
+| `/escalations` | 联系人、通道、超时与静默 | 双路径；静默 ≤4h，无永久项 |
+| `/operations` | 设备/流/分片/对账运维 | 不与业务预警混在同一队列 |
+| `/audit` | 审计查询 | 只读、分页、按权限脱敏 |
+
+这些是页面职责占位，不等于已冻结 URL；实现任务须更新本文件后再编码。
+
+## App 候选导航
+
+- 预警：待确认与升级中的事件。
+- 事件：有权限的历史事件与证据。
+- 设备：最小健康状态，不提供未经授权的常态监控。
+- 我的：联系人、通知偏好和限时静默。
+
+## 值班台/大屏
+
+- 实时事件流与高优先级预警。
+- 地图/平面图点位和列表双向定位。
+- 声光提示、ack 与交接班记录。
+
+## 路由守卫
+
+- 所有资源先验证租户与站点范围，再加载数据。
+- 人脸相关路由在未授权租户完全不存在。
+- 深链打开无权限或已删除资源时给出统一、安全的反馈。
+- 128 路规模页面不得通过前端一次性全量加载、隐藏后分页。
+
+## 组件归属
+
+- 业务组件放 `Bell/web/`，不放进 Sense 或 Brain。
+- 流状态只通过 Bell/Sense 的受控业务 API 展示，不直接把 MediaMTX 管理端暴露给业务用户。
+- 共用筛选、分页、批量结果和状态时间线组件在前端脚手架确定后再分层，不提前臆造目录。