docs: record authorized conflict protection requirements

This commit is contained in:
Ed1s0nZ committed 2026-10-10 17:14:29 +08:00
1 parent 65f947c9df
commit 7e6feeb96b
1 file changed
+10
@@ -9,3 +9,13 @@ Workflow Gate:P10 缺陷反馈 → P7 局部修复 → P9 验证。上游为
Maintainability Gate:config.go 2940 行、tool_guard.go 175 行、tool-guard.js 732 行。风险高,按 narrow_fix 执行;config.go 只加一个受现有锁保护的版本字段,行为放在现有专项 handler;不新增全局配置职责,不做无关重构。前后端接口联动,需 handler race 测试和现有前端测试。
Lifecycle Report:F0–F6;影响 handler、调用拦截 JS 和文档;权限和业务规则保持原有约束。GET/PUT 增加版本头,旧无条件 PUT 将拒绝,这是用户要求的覆盖保护所必需;客户端须先读取版本。阶段文档使用本文件,逐阶段提交推送。未要求合并、发布或部署。
## F1 Requirements
依据:用户已明确提出只有一个用户修改成功、其他用户失败并提示,随后明确要求实施修复且指定开源仓库。此处记录已有授权,不将未被确认的新文档标成用户批准。
- REQ-001 / AC-001:两个或更多客户端基于同一配置版本保存,只有一次成功;失败请求不改变成功方配置。
- REQ-002 / AC-002:冲突有合理错误提示;本地草稿保留,刷新获取最新配置后可以重新编辑保存。
- REQ-003 / AC-003:输入校验、权限、试匹配、落盘失败保持原策略行为继续成立。
- 范围解释:现接口提交整个列表,按整份配置保护,避免不同规则的旧快照相互覆盖。无需等待用户退出编辑,正常刷新后的后续修改允许保存。
- 非目标:编辑期间占用租约、多实例共享配置支持、发布或部署。