docs(v25): 更新退场权限审计收口说明

This commit is contained in:
2026-07-08 17:10:10 +08:00
parent 988d659fcc
commit a1007fd33d
5 changed files with 123 additions and 33 deletions

View File

@@ -221,6 +221,20 @@ pnpm appdata:archive:verify -- --archive backups/appdata-archive-20260708120000.
生产环境执行导出前需要确保 `DATABASE_URL` 指向当前 PostgreSQL。默认输出文件名为 `appdata-archive-<timestamp>.json`,该模式已加入 `.gitignore`;真实归档应放入服务器备份目录或对象存储,不提交到代码仓库。
## V2.5 一致性校验
完成数据库 migration、AppData 写冻结和归档导出后,建议在发布窗口内运行一致性校验:
```bash
pnpm consistency:v25 -- --url http://localhost/api/v1/consistency
```
本地开发默认检查 `http://localhost:3001/api/v1/consistency`,也可以不传 `--url`。校验内容包括 counts、分区键、孤儿引用和审计覆盖
- `error` 必须在发布前修复。
- `warn` 需要记录原因;历史数据没有审计事件属于预期 warning不阻断 V2.5。
- 后台页面 `/admin/consistency` 展示同一份报告,需要当前用户具备 `consistency:view`
## 升级流程
```bash