docs: record Sense MediaMTX sharding (#77)

2026-08-28 16:00:55 +08:00
parent 578ddbaae3
commit 999eb1aee3
1 changed files with 11 additions and 0 deletions
@@ -191,3 +191,14 @@
 - 状态转换写入不可变事件；列表和详情读取写入脱敏操作审计，不记录凭据或原始心跳载荷。
 - 合成夹具必须显式调用，生产迁移和启动不得自动写入节点。
 <!-- sense-edge-nodes:end -->
+
+<!-- sense-media-shards:start -->
+## Sense MediaMTX 分片规则
+
+- **媒体分片**是一个独立 MediaMTX Control API 及其配置容量的 Sense 本地投影，不是 Brain 分片，也不是跨产品共享节点身份。
+- 主分片容量优先读取显式 `SENSE_MEDIAMTX_CAPACITY`；未设置时读取 Sense PostgreSQL 的当前统一配额。额外分片容量逐项来自仓库外 JSON 配置。16 和 128 均不得作为分配算法硬上限。
+- 新媒体路径只在状态为运行正常或等待首次探测、且仍有配置容量的分片中确定性分配；同一路径重复处理必须保持原归属。
+- 分片异常、停用或状态陈旧都不得自动改写已有路径归属。详情必须能定位受影响的设备、位置、Profile 和媒体路径，同时不返回 Control API、RTSP URI 或凭据。
+- 跨分片迁移预检是只读操作，只检查源状态、全部受影响路径和候选目标容量；即使预检通过也不授予执行权限。实际迁移必须另建高风险工单并取得人工确认。
+- 额外分片只能配置为 external，Control API 必须使用无用户信息、无查询参数、无路径的本机回环 HTTP 地址。Sense 不停止外部实例。
+<!-- sense-media-shards:end -->