ctms/docs/guides/release-checklist.md

立项配置发布清单

状态: active 适用范围: setup-config 最后更新: 2026-03-30

1. 构建与迁移

• docker compose run --rm --build backend-init
• cd backend && python3 -m compileall app scripts
• cd frontend && npm run build

1.1 容器构建校验

• docker compose config 渲染成功
• 后端 /code/app/uploads 已持久化挂载到宿主机 backend/app/uploads
• docker compose build backend frontend 成功
• docker compose run --rm --build backend-init 成功

2. 接口与权限回归

• ADMIN 账号可 GET/PUT/PUBLISH/IMPORT-EXCEL/EXPORT-EXCEL
• PM 账号可 GET/PUT/PUBLISH/IMPORT-EXCEL/EXPORT-EXCEL
• CRA 账号可 GET/EXPORT-EXCEL，PUT/PUBLISH/IMPORT-EXCEL 返回 403
• 非项目成员访问返回 403

3. 并发冲突回归

• 双开两个窗口同项目配置
• A 保存后，B 再保存触发 409
• 前端显示冲突对比弹窗（可读 diff + JSON）
• 选择“使用服务器版本”后版本同步
• 选择“用本地草稿覆盖”后保存成功且版本递增
• 409 响应结构包含 detail.code=SETUP_CONFIG_VERSION_CONFLICT

3.1 业务校验回归（422）

• enrollmentPlan.startDate > endDate 返回 422
• 非本项目 siteId 返回 422
• centerConfirm 状态为“已确认”但无 confirmDate 返回 422
• 422 响应包含 detail.errors[].field 与 detail.errors[].message

4. 发布快照回归

• 草稿保存后 publish_status=DRAFT
• 发布后 publish_status=PUBLISHED
• 发布后可切换“已发布快照”并只读
• 再修改草稿后状态回到 DRAFT

5. 导入导出回归

• 导出 Excel 文件可打开且结构完整
• 导入有效 Excel 成功，页面数据刷新
• 导入非法 Excel 给出错误提示
• 导入冲突时触发 409 提示并刷新版本

6. 锁定与审计回归

• 项目锁定后 PUT/PUBLISH/IMPORT-EXCEL 返回 403
• 页面进入只读态，编辑按钮不可用
• 审计日志可按对象类型筛选 立项配置
• 审计事件包含:
  • CREATE_SETUP_CONFIG
  • UPDATE_SETUP_CONFIG
  • PUBLISH_SETUP_CONFIG
  • IMPORT_SETUP_CONFIG_EXCEL

7. 监控埋点回归

• 访问 GET /health/setup-config-stats 可返回 JSON
• by_endpoint 中可看到 setup-config 各接口 2xx/4xx/5xx 计数
• 人为制造一次冲突或锁定写入后，4xx 计数增加

8. 冒烟脚本

• cd backend && docker compose exec -T backend python scripts/smoke_setup_config.py
• 使用 BASE_URL/EMAIL/PASSWORD/STUDY_ID 环境变量执行一次（覆盖指定项目）
• BASE_URL=http://localhost:8888 EMAIL=... PASSWORD=... STUDY_ID=... bash docs/setup-config-curl-smoke.sh
• 导入并执行 Postman 集合 docs/postman/setup-config.postman_collection.json

9. 发布前确认

• 文档已更新：docs/guides/setup-config-api.md
• 本清单已全量勾选
• 发布说明已包含新增接口与权限规则

10. Enterprise UI 发布门禁

• cd frontend && npm run ui:contract
• cd frontend && npm run type-check
• cd frontend && npm run build
• docs/audits/enterprise-ui-acceptance-checklist.md 状态为 PASS 且记录审阅日期
• 管理层演示路径已走查：/project/overview -> /project/milestones -> /risk-issues/sae -> /fees/contracts -> /file-versions -> /admin/projects/:id