docs: document device edit request boundary (#56)

This commit is contained in:
ila
2026-08-13 22:40:17 +08:00
parent e18502ee67
commit b2cf37cccb
+6 -2
View File
@@ -2,8 +2,8 @@
generated: true (请先修改 Gitea Wiki,禁止直接编辑本文件)
wiki_page: Business-Rules-and-Glossary
wiki_url: https://git.ilapage.cn/ila/yovision/wiki/Business-Rules-and-Glossary.-
wiki_revision: 06b68d16bf907decdaf85a813d417896f7920f4c
synchronized_at: 2026-08-13T14:06:00Z
wiki_revision: f9c089d2b993478e586f4abdb1845952a3cd3c51
synchronized_at: 2026-08-13T14:37:00Z
<!-- gitea-wiki-mirror:end -->
# 业务规则与术语
@@ -97,4 +97,8 @@ synchronized_at: 2026-08-13T14:06:00Z
- **close**:只有处置人或管理员可以完成;必须选择“确认有危险、误报、现场正常、无法确认”之一,可附备注。相同重复请求幂等,其他改变结果的请求被拒绝。
- **审计事实**:成功生命周期事实只追加;失败、重复和拒绝尝试写入安全审计,但不记录令牌、密码或连接密钥。
<!-- bell-mvp:end -->
## 设备编辑请求边界
- 新建设备请求显式提交名称、安装位置、设备类型和能力;编辑设备请求只提交名称、安装位置、能力和版本,不提交新建专用的 `modality` 或响应中的只读字段。
- 设备名称和安装位置允许 UTF-8 中文;后端继续严格拒绝未知 JSON 字段,前端必须使用字段白名单构造请求,不得直接展开整个表单或响应对象。