trellis-governance-closeout 收口旧任务并统一 Trellis-only 治理
这个提交包含在：
+6
-6
@@ -18,7 +18,7 @@
|
||||
|
||||
## 1. 路线图原则
|
||||
|
||||
- 采用“路线图门禁 + 单功能 Issue CSV”的工程流程；路线图管顺序和边界，具体实现仍以每个功能的 Issue CSV 为准。
|
||||
- 采用“路线图门禁 + 单功能 Trellis task”的工程流程；路线图管顺序和边界，具体实现仍以每个功能的 Trellis task 为准。
|
||||
- 当前路线只覆盖企微优先 HR/考勤域改造：人事助手、通讯录、打卡、HR/考勤审批、OA 自建留存、OA 镜像、OA 应急接管、恢复回写和 RuleOps。
|
||||
- 采购、费用、合同、项目、报销、付款批次、AP、代账交接、审计和高敏附件继续 OA 主办；企业微信只做脱敏消息、deeplink、入口和成熟能力参考。
|
||||
- WEGOV1 后固定四域边界：企微主办域为打卡、请假、补卡、外出、加班、假期余额和人事助手；OA 主办域为报销、采购、合同、项目、付款、发票、银行回单、高敏附件和经营审计；OA 留存域保存企微关键历史和完整外部关联键；OA 应急域只在企微不可用时由管理员人工开启。
|
||||
@@ -33,7 +33,7 @@
|
||||
- WTCLOSE1/WTCLOSE2 后小团队审批规则按一层主管/指定审批角色 + 管理员兜底执行；2026-05-21 用户已真机确认请假、补卡、外出、加班四类模板均达到 A；若后续模板回退为 B/C/D，立即暂停 WEXT1-FORMAL 或 WREAL1。
|
||||
- WRULE1 后，WAPPR1 仍是人工规则门禁；WRULE1 只把已提交审批链和 OA 理论审批人自动对账。`PASS_RULE_MATCH` 或可解释 `PASS_WITH_ADMIN_FALLBACK` 才能继续测试号收口；`FAIL_APPLICANT_CAN_CHOOSE`、`FAIL_SELF_APPROVAL`、`FAIL_APPROVER_MISMATCH` 或 `SKIP/BLOCKED_BY_EXTERNAL_CONFIG` 均阻断 WEXT1-FORMAL、WREAL1 和最小完整镜像。
|
||||
- 企业微信自建应用不按完整隔离 sandbox 处理；后续默认使用真实企业内受控测试域、本地 synthetic 自动测试、公网 live runner 和少量真机确认。
|
||||
- 阶段未满足退出条件前不得跳阶段。线上缺陷、安全风险、正式使用阻断或真实反馈可以另开独立 Issue CSV，但不得混入企微 HR/考勤主路线。
|
||||
- 阶段未满足退出条件前不得跳阶段。线上缺陷、安全风险、正式使用阻断或真实反馈可以另开独立 Trellis task，但不得混入企微 HR/考勤主路线。
|
||||
- ERP 未来不接入 OA；真实支付、图片 OCR、银行流水导入、复杂 BPM、审批设计器、重预算和其他 P2 大功能继续冻结，试用期只处理阻断和真实反馈。
|
||||
- WAPI 后所有企微开发必须先读 [企微 API 能力目录](./企微API能力目录.md)，先确认官方 API、Secret、权限、可信 IP、回调/模板和读写边界；运行时代码不得靠多个 Secret 试错。
|
||||
|
||||
@@ -121,7 +121,7 @@
|
||||
|
||||
## 4. 每阶段固定门禁
|
||||
|
||||
每个正式阶段必须单独建立 Issue CSV，并至少包含：
|
||||
每个正式阶段必须单独建立 Trellis task，并至少包含：
|
||||
|
||||
- 需求边界：本阶段做什么、不做什么、涉及哪些角色和业务流程。
|
||||
- 接口边界：新增或复用的企微 API、OA API、schema、feature flag、配置和权限；企微接口必须引用 [企微 API 能力目录](./企微API能力目录.md) 的对应能力行。
|
||||
@@ -180,7 +180,7 @@ POC 默认只读或低风险探测。任何生产写操作、企微规则写入
|
||||
|
||||
当前已完成：
|
||||
|
||||
- 建立 WCPC Issue CSV。
|
||||
- 建立 WCPC 后续 Trellis task 或保留对应历史 Issue CSV 追溯。
|
||||
- 使用现有远端配置和历史 `HRWDTEST-20260517214548` 做基线复跑，报告目录为远端 `/tmp/wecom-capability-poc-wcpc-baseline`。
|
||||
- 基线结论仍为 `PAUSE_FOR_CONFIG`，`contact.member_read=wecom_errcode_48009`，`hr.staff_read=wecom_errcode_60021`。
|
||||
- 使用 `SMOKE002/测试员工` 复跑既有测试号只读 POC，报告为远端 `/tmp/wecom-capability-poc-wcpc-smoke002/summary.json`。
|
||||
@@ -334,7 +334,7 @@ WADM1 是 `WARCH1` 前的设计门禁，只定义数据模型、状态机、幂
|
||||
|
||||
隐私和保留策略：
|
||||
|
||||
- OA DB 可保存完整外部关联键和业务必要字段，用于补偿、历史查看、恢复和审计；日志、报告、Issue CSV 和文档只保存脱敏前缀。
|
||||
- OA DB 可保存完整外部关联键和业务必要字段，用于补偿、历史查看、恢复和审计；日志、报告、Trellis task 和文档只保存脱敏前缀。
|
||||
- 表单字段默认只保存规范化业务字段和摘要。请假/补卡至少保存申请类型、时间范围、时长或补卡时间、原因摘要、审批状态和审批历史；不保存无治理的整包 payload。
|
||||
- 附件 V1 只保存数量、类型和外部引用摘要；不下载采购、合同、报销、发票、银行回单或高敏附件。
|
||||
- 原始 XML、密文、Token、EncodingAESKey、access token、Secret 和完整回调密文永不入库。若后续确需原始 payload，必须另开加密存储、字段级访问审计和保留期限合同。
|
||||
@@ -347,7 +347,7 @@ WARCH1 最小实现切片：
|
||||
3. 增加 QA-only backfill/verify runner：断开企微 API 时仍能从 OA DB 读取已保存的请假/补卡历史摘要。
|
||||
4. 再做只读查询 API 或管理页入口；不在 WARCH1 内开启完整镜像增强、外出/加班正式样例、应急接管、恢复回写或 RuleOps。该正式查询切片已由 WARCH2 承接。
|
||||
|
||||
WARCH1 已按独立 Issue CSV 进入最小实现。当前实现边界：
|
||||
WARCH1 已按独立合同进入最小实现。当前实现边界：
|
||||
|
||||
- Prisma 新增 `WecomApprovalArchive`、`WecomApprovalParticipant`、`WecomApprovalAction`、`WecomApprovalFieldSummary`、`WecomApprovalAttachmentSummary`、`WecomApprovalCallbackEvent`、`WecomApprovalCompensationRun`、`WecomApprovalCompensationItem` 和 `WecomApprovalReconcileFinding`，migration 只新增表、索引和外键。
|
||||
- `GET /POST /api/wecom/approval/callback` 继续只读接收企微回调；POST 验签、解密、规范化后默认写入 OA DB，DB 写入失败返回非 200，让企业微信按官方机制重试；配置文件证据仅作为无 Prisma 时的 fallback。
|
||||
|
||||
在新工单中引用
屏蔽一个用户