hyb-oa/issues/2026-04-26_r66-small-team-trialrun-readiness.csv 位于 main - hyb-oa - Gitea: Git with a cup of tea

文件

T

wangsli a15bbcbadb R66 A1-A6：小团队试点收敛与上线验收

2026-04-26 13:24:24 +08:00

8.7 KiB

原始文件 永久链接 Blame 文件历史

1	ID	Title	Description	Acceptance	Test_Method	Tools	Dev_Status	Review1_Status	Regression_Status	Files	Dependencies	Notes
2	A1	R66 执行合同建档与范围冻结	创建并校验 R66 小团队试点收敛与上线验收执行合同 CSV，冻结范围：1) 面向 10 人以下团队收敛主路径；2) 建立 4 周试点观测闭环；3) 补齐上线前安全与恢复演练口径；4) 不新增 Prisma 迁移，不新增 npm 依赖，不改审批状态机与 auth API 协议。	issues/2026-04-26_r66-small-team-trialrun-readiness.csv 列完整、Dependencies 为 JSON 数组字符串、A2-A6 范围与批准方案一致，Notes 明确无迁移、无新依赖、不改 workflow/auth 协议与回滚方式。	命令：python3 - <<'PY' 手工解析 CSV 并校验 12 列、状态值、Dependencies JSON 数组字符串；业务：对照 AGENTS.md 与 issues/README.md 检查 A2-A6 是否只覆盖小团队试点收敛、观测、上线安全恢复与验收门禁。	manual	DONE	DONE	DONE	issues/2026-04-26_r66-small-team-trialrun-readiness.csv	[]	回滚路径：删除本次 CSV 不影响业务。无 Prisma 迁移，无新依赖，不改 workflow/auth API 协议。验证：CSV 结构校验通过。
3	A2	小团队主路径与备用模块收敛	收敛 10 人以下团队试点可见范围，明确普通员工、管理者、管理员三类入口：主路径保留 Portal、团队、请假、报销、资产、周报、待办、公告、项目；采购、差旅、预算、支付批次、AP 运营、ERP、AI 等模块降级为管理员备用或开关控制。	1) docs/admin-handbook.md 与 deploy/trialrun/checklist.md 的小团队上线口径一致；2) Portal/导航主路径与员工快速上手文档一致；3) 备用模块不作为普通员工首屏或主导航默认路径；4) 不删除历史模块与数据，只收敛可见入口和上线说明。	命令：cd client && npm run typecheck && npm run build；业务：使用 employee、manager、admin 试点账号分别检查 Portal 首屏与导航，确认普通员工只看到高频主路径，管理员仍可进入备用模块。	manual	DONE	DONE	TODO	docs/admin-handbook.md\|docs/employee-quickstart.md\|deploy/trialrun/checklist.md\|client/src/layouts/AppShellLayout.tsx\|client/src/router/index.tsx\|client/src/pages/PortalHomePage.tsx	["A1"]	回滚路径：恢复导航与文档到 R65 口径；不删除模块，不做数据迁移。若实现需改前端，仅限入口显隐与文案收敛。验证：client typecheck/build 与 workspaceSettings.navigation.test 通过；待试点账号人工复核。
4	A3	4 周试点观测闭环	把小团队试点观测从模板变成可执行周循环：完善观测模板、README 与导出说明，必要时增强现有 small-team observation 导出脚本，覆盖登录覆盖率、周报提交率、团队状态覆盖率、项目更新、聊天/表格绕行案例与管理员结论。	1) deploy/trialrun/observations/README.md 明确 week-01 到 week-04 产出方式；2) observation-template.md 包含量化指标、人工观察、阻塞、下周调整和验收结论；3) 导出脚本可生成基础报告或明确缺失数据的人工补录点；4) 观测流程不依赖新增外部服务。	命令：cd server && node --check src/scripts/export-small-team-observation.js && npm run report:small-team-observation -- --out ../deploy/trialrun/observations/week-00.md；业务：管理员可按模板在每周五完成一次试点复盘，并能识别是否应继续隐藏或恢复某模块。	manual	DONE	DONE	DONE	deploy/trialrun/observation-template.md\|deploy/trialrun/observations/README.md\|server/src/scripts/export-small-team-observation.js\|docs/admin-handbook.md	["A1"]	回滚路径：恢复观测模板与导出脚本到 R65 口径；无 Prisma 迁移，无新依赖。验证：node --check 通过；已使用本地试点数据库导出 deploy/trialrun/observations/week-00.md，人工补录区与 4 周循环说明齐全。
5	A4	上线前安全与备份恢复演练包	将公网试点前的最小安全、备份、恢复、账号与权限审计动作收敛为一套可执行 Runbook，强调 JWT_SECRET、COOKIE_SECURE、OPENAPI_DOCS_ENABLED、管理员账号清单、最小权限、DB+文件存储备份与至少一次恢复演练。	1) deploy/trialrun/runbook.md 与 checklist.md 明确上线前必须完成安全检查、备份、恢复演练和管理员账号核对；2) docs/ops/non-functional-baseline.md 同步小团队上线最低安全口径；3) scripts/backup-db.sh、backup-storage.sh、restore-db.sh、restore-storage.sh 的使用路径在文档中可复现；4) 不引入新的安全产品或外部依赖。	命令：bash -n scripts/backup-db.sh && bash -n scripts/backup-storage.sh && bash -n scripts/restore-db.sh && bash -n scripts/restore-storage.sh && node deploy/trialrun/validate-env-contract.js；业务：在试点环境完成一次备份恢复演练并记录备份文件名、恢复目标、/ready 结果和回滚负责人。	manual	DONE	DONE	TODO	deploy/trialrun/runbook.md\|deploy/trialrun/checklist.md\|docs/ops/non-functional-baseline.md\|scripts/backup-db.sh\|scripts/backup-storage.sh\|scripts/restore-db.sh\|scripts/restore-storage.sh	["A1"]	回滚路径：恢复 Runbook 与 checklist 文档；脚本若有改动仅限帮助信息或校验提示，不改变备份格式。验证：备份/恢复脚本 bash -n 与 validate-env-contract 通过；实际备份恢复演练待试点环境执行。
6	A5	试点发布门禁与验收矩阵收口	定义 R66 试点发布的最小门禁和验收矩阵：本地静态门禁、核心后端回归、前端 typecheck/build、smoke-local、可选 live smoke、4 周观测结论；避免每次发布依赖大量手工点检。	1) checklist.md 中 R66 放行条件清晰区分必须项、建议项和人工观测项；2) docs/ops/testing-strategy.md 或相关发布文档补充 R66 小团队试点门禁；3) 影响范围验证命令覆盖 server prisma:validate、server regression-all、client typecheck/build；4) 若无法执行某项自动化，必须记录原因与手工替代步骤。	命令：bash scripts/qa/run-release-gate.sh static && cd server && ./scripts/regression-all.sh && cd ../client && npm run typecheck && npm run build；业务：发布负责人可按 checklist 判断本轮是否允许部署到 trialrun，并知道失败时查看哪类产物。	manual	DONE	DONE	DONE	deploy/trialrun/checklist.md\|docs/ops/testing-strategy.md\|scripts/qa/run-release-gate.sh\|scripts/qa/run-web-gates.sh\|scripts/check-minimal.sh\|server/scripts/regression-im-notifier.sh	["A2","A3","A4"]	回滚路径：恢复发布门禁文档和脚本到 R65 口径；脚本改动仅限 R66 模式封装、Docker PostgreSQL client 支持与 IM 回归断言对齐，不降低既有门禁。验证：QA_DB_CLIENT=docker QA_DB_DOCKER_CONTAINER=hyb-oa-trialrun-db QA_DOCKER_USE_SG=1 bash scripts/qa/run-release-gate.sh r66-trialrun 通过；包含 static、server regression-all、smoke-local Playwright 8/8；server npm audit 仍有 27 个漏洞（11 high、4 critical），需依赖升级合同评审。
7	A6	R66 验证、状态回填与提交收口	在 A2-A5 完成后执行相关验证，回填 Issue CSV 状态，形成 R66 小团队试点上线建议和后续 4 周观测计划，并提交代码。	1) A2-A5 的 Test_Method 按影响范围通过或记录不可执行原因；2) issues/2026-04-26_r66-small-team-trialrun-readiness.csv 状态按实测结果回填；3) 输出试点上线建议，包含开放模块、隐藏模块、管理员每周动作、备份恢复演练结论；4) git commit 成功，提交信息引用 R66 A1-A6。	命令：git diff --check && cd server && npm run prisma:validate && ./scripts/regression-all.sh && cd ../client && npm run typecheck && npm run build；业务：使用 10 人以下团队口径复核 Portal、导航、试点观测、备份恢复 Runbook 与发布 checklist 是否能支持一周真实试用。	manual	DOING	TODO	TODO	issues/2026-04-26_r66-small-team-trialrun-readiness.csv\|docs/admin-handbook.md\|docs/employee-quickstart.md\|deploy/trialrun/checklist.md\|deploy/trialrun/runbook.md\|deploy/trialrun/observation-template.md\|deploy/trialrun/observations/README.md\|scripts/qa/run-web-gates.sh\|server/scripts/regression-im-notifier.sh	["A5"]	回滚路径：若验证失败，不回填 DONE，不提交实现；必要时回退 R66 文档、脚本与前端入口收敛改动。当前未提交：自动验证已完成 git diff --check、CSV 校验、server prisma:validate、server regression-all、client typecheck/build、IM 专项回归、Docker client smoke-local 与 r66-trialrun；仍待试点账号人工复核、备份恢复演练和 server audit 风险处理。commit message：R66 A1-A6：小团队试点收敛与上线验收。