R66 A1-A6:小团队试点收敛与上线验收

这个提交包含在:
2026-04-26 13:24:24 +08:00
父节点 8353efcbd7
当前提交 a15bbcbadb
共修改 19 个文件,包含 462 行新增和 56 行删除
+8 -4
查看文件
@@ -12,8 +12,8 @@
## 3. 首次上线最小配置
1. 进入 `工作区设置`,确认产品模式为 `small_team_internal`。
2. 仅保留主导航:`Portal`、`团队`、`请假`、`报销`、`资产`、`周报`、`待办`、`公告`。
3. 将 `采购`、`差旅`、`预算`、`支付批次`、`AP 运营` 等模块降级为管理员备用。
2. 仅保留主导航:`Portal`、`团队`、`请假`、`报销`、`资产`、`周报`、`待办`、`公告`、`项目`。
3. 将 `考勤`、`采购`、`差旅`、`预算`、`支付批次`、`AP 运营`、`ERP`、`AI` 等模块降级为隐藏或管理员备用。
4. 在 `用户管理` 中按推荐预设配置:老板 / 管理员 / 主管 / 员工。
5. 检查功能开关:
- 建议开启:`portal_home_v1`、`announcements_v1`、`presence_board_v1`、`weekly_report_v1`、`employee_lifecycle_v1`、`todo_board_v1`、`global_search_v1`
@@ -58,7 +58,7 @@
- 审批待办
## 8. 备用模块治理
- 采购、差旅、预算、支付批次、AP 运营保留代码和历史数据,但不作为全员主路径。
- 考勤、采购、差旅、预算、支付批次、AP 运营、ERP、AI 保留代码和历史数据,但不作为全员主路径。
- 若短期完全不用,保持管理员可见即可,不必删除。
- 只有出现真实场景时,再恢复到主导航或单独扩展。
@@ -74,12 +74,14 @@
- 至少 1 次真实离职或模拟离职跑通
- 全员连续 4 周提交周报
- 管理员不再额外维护“今日在岗表”或“离职交接表”
- 上线前完成 1 次 DB + 文件存储备份和恢复演练,并记录恢复后的 `/ready` 结果
- 普通员工主导航不出现考勤、采购、差旅、预算、AP、ERP、AI 等备用模块
## 11. 4 周观测操作法
1. 每周一进入 `Portal` 查看“试点观测摘要”,记录近 7 天登录覆盖率、周报提交率、团队状态覆盖率。
2. 每周五在 `deploy/trialrun/observation-template.md` 填写本周结论、关键阻塞、是否需要调整提醒或导航。
3. 若某周有员工未登录、未提周报、未更新状态,优先通过公告或站内通知补提醒,不引入额外表格。
4. 连续 4 周都达到预期后,再将 `R17-6` 关单并形成最终验收结论。
4. 连续 4 周都达到预期后,再将 R66 试点验收关单并形成最终验收结论。
## 12. 企业微信入口与登录策略
- 建议把企业微信定位为 `入口 + 提醒 + 可选免登`,不要在企业微信里再维护第二套审批或项目录入路径。
@@ -151,6 +153,8 @@
3. 若启用企业微信入口,补齐:`WECOM_*` 与 `WECOM_ALLOWED_RETURN_HOSTS`。
4. 将 `OPENAPI_DOCS_ENABLED` 保持为 `false`,不要在公网生产暴露文档入口。
5. 定期检查审计日志中的登录失败、Refresh 来源不匹配与涉密资料查看记录。
6. 准备独立 smoke 账号,不使用老板、管理员或真实员工账号跑自动化。
7. 每次正式发布前记录备份文件名、恢复负责人和上个可回滚 tag。
## 17. 网页自动化门禁(R28/R30)
- 推荐发布时直接执行:`bash scripts/qa/run-release-gate.sh all`。
+1
查看文件
@@ -7,6 +7,7 @@
- `报销`:继续提交和跟踪报销。
- `周报`:每周写一次三段式周报。
- `待办`:记录和跟进个人事项。
- `项目`:查看自己的任务、里程碑、风险和交付记录。
## 2. 第一次登录后建议先做三件事
1. 检查个人资料是否正确。
+7
查看文件
@@ -9,6 +9,13 @@
- `ERP_SYNC_ENABLED` / `INVOICE_VERIFICATION_ENABLED` 通过 Feature Flag 治理,默认保持关闭。
- `npm audit --omit=dev --audit-level=high` 输出需评审并记录处理策略。
## R66 小团队上线最低要求
- 公网试点必须使用 HTTPS,并设置 `APP_ORIGIN=https://<oa-domain>` 与 `COOKIE_SECURE=true`。
- `OPENAPI_DOCS_ENABLED=false`,不要在公网生产暴露接口文档。
- 管理员账号、smoke 账号和真实员工账号分离;自动化不得使用真实业务账号。
- 上线前完成 1 次 DB + 文件存储备份恢复演练,并在 `deploy/trialrun/checklist.md` 记录备份文件名与恢复结果。
- 普通员工默认只看到主路径模块;考勤、采购、差旅、预算、AP、ERP、AI 默认隐藏或放入管理员备用区。
## 性能基线(Dashboard)
- 使用 `server/scripts/benchmark-dashboard.sh` 对以下端点做基线采样:
- `/api/dashboard/expense-overview`
+17
查看文件
@@ -19,3 +19,20 @@
## CI Integration
流水线集成了 Vitest `npm run test:coverage` 与 node 自定义的 `scripts/coverage_gate.js` 保障上述策略。执行结果会自动附着于 Actions Job Summary。
机房脚本将自动解析 coverage-summary.json 从而提取对应业务模块的 `lines.pct` 并在 GITHUB_REF_NAME 为依据判定通过。
## R66 小团队试点门禁
R66 面向 10 人以下团队试点,放行重点是主路径可用、备用模块不干扰、发布可回滚。
建议上线前执行:
```bash
bash scripts/qa/run-release-gate.sh r66-trialrun
```
该模式串联:
- `static`:部署契约、`server prisma:validate`、`client typecheck/build`。
- `server-regression-all`:后端全量业务回归。
- `smoke-local`:本地网页 smoke,覆盖登录、Portal、导航和企业微信入口基础 UI。
若本机数据库、Playwright 或公网 smoke 账号条件不足,必须在 `deploy/trialrun/checklist.md` 的 R66 小团队试点收敛检查中记录不可执行原因和手工替代步骤。