docs: record Sense edge node status (#76)

2026-08-28 14:12:49 +08:00
parent dcbdcf5630
commit 8f81b925af
1 changed files with 11 additions and 0 deletions
@@ -180,3 +180,14 @@
 - 32/64/128 只展示当前配置和目标硬件性能测试状态。未验证不得解释为支持或稳定承载承诺。
 - 配额调整必须记录旧值、新值、操作人、时间和原因；viewer 与实施/运维角色只读，只有站点管理员可调整配额和重新启用设备。
 <!-- sense-quota:end -->
+
+<!-- sense-edge-nodes:start -->
+## Sense 边缘节点状态规则
+
+- **边缘节点投影**：Sense 保存的节点最后已知运行状态，不是 Brain/Bell 的共享机器身份或跨产品事实源。
+- **在线**：最近心跳距读取时刻不超过 90 秒，且没有未完成的恢复阶段。
+- **离线**：最近心跳距读取时刻超过 90 秒。离线是读取时推导状态，不得用“未知”覆盖最后已知的控制隧道、视频数据面、负载和回填队列；所有这些值必须同时标明陈旧。
+- **恢复中**：心跳已经恢复，但控制隧道、视频数据面或回填通道仍在独立收敛。只有恢复阶段明确收敛后才显示在线。
+- 状态转换写入不可变事件；列表和详情读取写入脱敏操作审计，不记录凭据或原始心跳载荷。
+- 合成夹具必须显式调用，生产迁移和启动不得自动写入节点。
+<!-- sense-edge-nodes:end -->