验证状态与依据#

本手册统一验证口径为：已源码核验、未联调（无 app 调用图）。文档状态严格区分以下层级：

状态	含义
已源码核验、未联调	结论来自后端源码（Controller、Service、DTO、安全配置、契约测试）；未宣称真实环境验证。本手册当前全部页面处于此档
已联调验证	另有受控真实交互记录；不由构建或静态检查推导。本手册当前没有页面达到此档

「未联调」对开发者意味着什么#

• 字段名、路径、错误文案与装配行为以源码为契约证据，可以按此实现；但真实环境的时序表现（缓存生效、在线状态刷新、异步删除完成时机等）没有 App 实测佐证。
• 手册结论没有手机 app 源码调用图佐证——「App 现役依据」由旧 app 文档收录记录、两代接口分工语义与后端持续维护迹象推出，属源码核验结论。
• 开发者应据此兜底：对响应字段做空值与未知枚举兜底；对错误码保留未知码分支；上线前自行安排联调用例覆盖关键路径。

逐页基线 commit 要求#

每张操作页与流程页在页首以一行验证状态记录核验日期与后端基线（仓库分支 + HEAD commit），公共约定页保留「依据」节：

• 核验结论只对记录的基线有效。后端前进后，未复核的页面不得当作已核验；复核按基线间 diff 增量进行，不重读全仓。
• 静态检查和站点构建只验证文档结构，不验证接口行为。
• 若某条结论无法闭合到源码或协议证据，页面必须按覆盖与缺口栏目的方式具名缺口，不得写推测。

依据#

适用后端基线：源码归纳 @ 2026-09-14。「无 app 调用图」是本手册规划的既定边界（手机 app 源码不在工作区）；事实源优先级为后端源码 > research 三表 > 旧 app 文档仓（仅参考材料）。具体操作页须在编写时重新核对相关源码是否漂移。