docs: complete Chinese project documentation
This commit is contained in:
64
docs/product/acceptance/blueprint-readiness.md
Normal file
64
docs/product/acceptance/blueprint-readiness.md
Normal file
@@ -0,0 +1,64 @@
|
||||
# 产品蓝图统一验收
|
||||
|
||||
## 目的
|
||||
|
||||
`report_blueprint_readiness` 将产品蓝图阶段 2~6 的最终退出条件收敛为一个机器可读报告。
|
||||
报告不会因为工程测试通过而替代真实案例或真实环境证据,也不会把合成案例计入阶段退出。
|
||||
|
||||
当前共检查 9 个门槛:
|
||||
|
||||
1. 阶段 2 脱敏真实案例智能建单指标。
|
||||
2. 阶段 3 脱敏真实案例支持闭环指标。
|
||||
3. 阶段 3 PostgreSQL、Embedding 与重排基准。
|
||||
4. 阶段 4 真实模型知识蒸馏、独立审核、发布与重新检索。
|
||||
5. 阶段 4 MinIO、ClamAV、PostgreSQL、Embedding 和六类文档导入。
|
||||
6. 阶段 6 企业渠道签名、收发、回执与幂等。
|
||||
7. 阶段 6 OIDC、组织声明、故障降级与 LDAP 目录同步。
|
||||
8. 阶段 6 真实告警、备份调度与异地加密副本。
|
||||
9. 阶段 6 数据库与对象存储隔离一致性恢复。
|
||||
|
||||
## 准备证据
|
||||
|
||||
阶段 2、3 的业务指标从平台评审记录实时计算。先按对应说明导入案例并逐案评审:
|
||||
|
||||
- `stage2-evaluation.md`
|
||||
- `stage3-evaluation.md`
|
||||
|
||||
其余真实环境验收从以下模板开始:
|
||||
|
||||
```powershell
|
||||
Copy-Item `
|
||||
docs/product/acceptance/blueprint-external-evidence.template.json `
|
||||
docs/product/acceptance/blueprint-external-evidence.json
|
||||
```
|
||||
|
||||
只能填写验收结果、环境代号、指标和证据文件引用。清单会递归拒绝字段名包含
|
||||
`password`、`secret`、`token` 或 `credential` 的内容,不得在其中保存任何真实凭据。
|
||||
每个通过项必须包含带时区的 `verified_at`、`reviewer` 和至少一个 `artifact_refs`。
|
||||
|
||||
## 运行
|
||||
|
||||
目标数据库必须先应用当前迁移:
|
||||
|
||||
```powershell
|
||||
cd backend
|
||||
python manage.py migrate
|
||||
python manage.py report_blueprint_readiness `
|
||||
--evidence ../docs/product/acceptance/blueprint-external-evidence.json `
|
||||
--output ../docs/product/acceptance/blueprint-readiness.current.json
|
||||
```
|
||||
|
||||
CI 或正式退出评审使用非零退出码阻断未满足项:
|
||||
|
||||
```powershell
|
||||
python manage.py report_blueprint_readiness `
|
||||
--evidence ../docs/product/acceptance/blueprint-external-evidence.json `
|
||||
--format json `
|
||||
--fail-on-not-ready
|
||||
```
|
||||
|
||||
若数据库未迁移、证据文件缺失、契约字段不完整、恢复记录无效或任一业务指标未达标,
|
||||
命令都会输出 `not_ready`。只有 9 个门槛全部通过时,顶层 `exit_ready` 才会为 `true`。
|
||||
|
||||
仓库中的 `blueprint-readiness.current.json` 是当前环境快照,不是永久通过证明;每次正式
|
||||
验收都应重新生成,并保留它引用的原始指标、运行日志、截图或审批记录。
|
||||
Reference in New Issue
Block a user