wangsli/hyb-oa
1
0
派生 0
代码 工单 合并请求 工作流 8 软件包 项目 发布 百科 活动

WCPC 建立企微能力POC配置收口

浏览代码
这个提交包含在：
wangsli
2026-05-18 15:13:34 +08:00
父节点 5369e7d258
当前提交 bb6a8241ea
共修改 10 个文件，包含 93 行新增和 15 行删除
下载 Patch 文件 下载 Diff 文件 展开所有文件 折叠所有文件
issues/2026-05-18_15-01-23-wecom-capability-poc-config-closeout-v1.csv
+9
查看文件
@@ -0,0 +1,9 @@
ID,Title,Description,Acceptance,Test_Method,Tools,Dev_Status,Review1_Status,Regression_Status,Files,Dependencies,Notes
"WCPC-0","合同建档","建立 WCP1-CONFIG-CLOSEOUT-V1 合同，锁定本轮为企业微信能力 POC 配置收口与只读复跑；不改 OA API/schema/UI，不部署，不持久修改服务器 .env，不调用生产写接口。","1) CSV 校验通过；2) 范围限定为 Issue CSV、QA-only 脚本必要小修、事实源回写和只读 POC 复跑；3) 不打印 secret、access token、cookie、完整手机号、完整位置、原始 payload 或附件内容；4) 结论只允许 GO_TO_HR_MASTER_SYNC、PAUSE_FOR_CONFIG、PAUSE_FOR_API_POC、NO_GO_REVISE_ROADMAP。","受影响流程：WCP1 配置阻断 -> 企微后台补配置 -> 服务器容器只读复跑 -> HR 主数据镜像准入判断；验证步骤：python3 /home/shunli/.codex/skills/plan/scripts/validate_issues_csv.py issues/2026-05-18_15-01-23-wecom-capability-poc-config-closeout-v1.csv。","python3|manual","DONE","DONE","DONE","issues/2026-05-18_15-01-23-wecom-capability-poc-config-closeout-v1.csv","[]","回滚路径：回退本 CSV、QA-only 脚本小修和文档/skill 回写；不涉及数据库、业务运行时、部署或公网持久配置。"
"WCPC-1","新在职测试成员准备","等待用户在企业微信后台创建或指定新的在职测试成员 WCP1TEST-<YYYYMMDDHHmmss>，并加入工作台应用、通讯录、人事助手、打卡、审批可见/权限范围。","1) 获取新测试成员 userid；2) 该成员为 active/in-service，不使用已离职/禁用的 HRWDTEST-20260517214548；3) 成员不承载真实敏感业务资料；4) POC 输出只显示脱敏 userid 前缀。","受影响流程：企微通讯录/人事助手 -> OA HR 主数据镜像准入；验证步骤：在复跑报告中检查 contact.member_read 和 hr.staff_read 对该测试成员有状态和脱敏证据。","manual|node","TODO","TODO","TODO","external|scripts/qa/check-wecom-capability-poc.mjs","[""WCPC-0""]","BLOCKED_BY_USER_CONFIG：需要用户完成企微后台测试成员和权限范围配置，并提供非敏感 userid。"
"WCPC-2","新建测试审批单","等待用户用新在职测试成员在企业微信提交一条请假或补卡测试审批，记录审批模板 ID 和审批单号 sp_no；测试单不上传敏感附件。","1) 获取 WECOM_APPROVAL_TEMPLATE_ID；2) 获取 WECOM_APPROVAL_SP_NO 或 WECOM_APPROVAL_INSTANCE_ID；3) 测试审批单属于测试成员和测试模板；4) 不使用采购、合同、报销、发票、银行回单或代账资料。","受影响流程：企微审批模板/审批详情/假期余额 -> OA HR/考勤审批镜像准入；验证步骤：复跑报告中 approval.template_detail、approval.instance_detail、approval.vacation_quota 均有唯一状态和原因。","manual|node","TODO","TODO","TODO","external|scripts/qa/check-wecom-capability-poc.mjs","[""WCPC-1""]","BLOCKED_BY_USER_CONFIG：需要用户提供模板 ID 和测试审批单号；缺权限时记录 PAUSE_FOR_CONFIG。"
"WCPC-3","配置清单核对","核对通讯录读取、人事助手花名册读取、打卡 API、审批模板/详情、假期余额和回调配置所需权限；本轮不持久修改服务器 env。","1) 配置核对清单回写到事实源；2) 缺配置项均以 NEEDS_CONFIG 或 SKIP/BLOCKED_BY_EXTERNAL_CONFIG 记录；3) 不把缺配置伪造成 PASS；4) 回调本轮只验证配置存在性，不验证真实事件投递。","受影响流程：企微后台配置 -> POC runner 能力矩阵；验证步骤：rg -n 'WCPC|PAUSE_FOR_CONFIG|contact.member_read|hr.staff_read|WECOM_CHECKIN_SYNC_ENABLED|WECOM_APPROVAL_TEMPLATE_ID|WECOM_CALLBACK' docs issues .agents/skills/hyb-oa-delivery/SKILL.md。","rg|manual","DONE","DONE","DONE","docs|issues|.agents/skills/hyb-oa-delivery/SKILL.md","[""WCPC-0""]","如果发现 OA 尚无审批回调接收端，不在本轮补业务接口，留到 wecom_attendance_approval_mirror_v1。"
"WCPC-4","服务器临时注入复跑","在部署服务器容器内临时传入新测试 userid、审批模板 ID、审批单号、打卡开关和回调配置，执行 check-wecom-capability-poc.mjs；不写 .env、不重启服务。","1) 报告输出到 /tmp/wecom-capability-poc-wcpc/summary.json；2) 只读 POC status=PASS；3) 敏感值不出现在命令输出、报告、Issue 或文档；4) 若缺外部配置，结论为 PAUSE_FOR_CONFIG。","受影响流程：服务器 env 临时注入 -> 企微 API 只读探测 -> 脱敏能力矩阵；验证步骤：ssh [email protected] 'cd /opt/hyb-oa-trialrun && docker-compose -f deploy/trialrun/docker-compose.yml exec -T server sh -lc ""WECOM_CAPABILITY_POC_LIVE_READ=1 WECOM_CAPABILITY_POC_JSON=1 WECOM_CAPABILITY_POC_TEST_USERID=<test-userid> WECOM_CAPABILITY_POC_DAYS=1 node - --json --report-dir=/tmp/wecom-capability-poc-wcpc""' < scripts/qa/check-wecom-capability-poc.mjs。","ssh|docker-compose|node","TODO","TODO","TODO","scripts/qa/check-wecom-capability-poc.mjs|external","[""WCPC-3""]","敏感配置通过既有容器 env 或交互式方式注入；不得持久写入 deploy/trialrun/.env。"
"WCPC-5","能力矩阵判定","判定复跑结果：contact.member_read 与 hr.staff_read 必须通过；打卡、审批、假期、回调按唯一状态记录；hr.staff_update_classification 可保留 NEEDS_API_POC。","1) contact.member_read=CAN_REUSE_NOW；2) hr.staff_read=CAN_REUSE_NOW；3) checkin.records_read/checkin.rules_read 返回 API 可读或明确配置阻断；4) approval.template_detail/instance_detail/vacation_quota/callback.config 均有状态；5) approval.oa_primary_sensitive_domains=KEEP_OA_PRIMARY。","受影响流程：能力矩阵 -> GO_TO_HR_MASTER_SYNC 或暂停配置；验证步骤：rg -n 'GO_TO_HR_MASTER_SYNC|PAUSE_FOR_CONFIG|PAUSE_FOR_API_POC|NO_GO_REVISE_ROADMAP|contact.member_read|hr.staff_read|approval.vacation_quota|callback.config' docs issues artifacts scripts。","rg|node","TODO","TODO","TODO","docs|issues|scripts|artifacts/qa-flow/wecom-capability-poc-*","[""WCPC-4""]","只有 GO_TO_HR_MASTER_SYNC 才允许下一步规划 wecom_hr_master_sync_v1；即使通过也不直接开发镜像、应急、回写或 RuleOps。"
"WCPC-6","事实源回写","更新路线图、企业微信规约、PRD、文档索引、事实源矩阵、人工试运行报告和项目 skill，记录 WCPC 基线复跑结论和剩余配置项；完整复跑后继续回填最终结论。","1) 路线图当前阶段更新为 WCPC 基线复跑结果；2) 规约和 PRD 记录能力矩阵准入/阻断；3) 文档索引和事实源矩阵登记 WCPC；4) skill 明确后续依据 WCPC 结论推进；5) 文档审计、skill 校验和 git diff --check 通过。","受影响流程：后续 agent/人工读取事实源 -> 是否进入 wecom_hr_master_sync_v1；验证步骤：node scripts/qa/audit-docs.mjs --check-registry；python3 /home/shunli/.codex/skills/.system/skill-creator/scripts/quick_validate.py .agents/skills/hyb-oa-delivery；git diff --check。","node|python3|git|rg","DONE","DONE","DONE","docs/企微优先开发路线图.md|docs/需求-企业微信基础设施规约.md|docs/海音达OA-MVP需求规格说明书.md|docs/文档索引.md|docs/文档事实源状态矩阵.md|docs/trialrun/人工试运行报告.md|.agents/skills/hyb-oa-delivery/SKILL.md","[""WCPC-3""]","本轮只回写基线和等待配置状态，不部署；完整 POC 需在 WCPC-1/2/4/5 完成后再回填最终结论。"
"WCPC-7","阶段中文提交","基线复跑和事实源回写通过后提交中文 commit；完整 POC 仍等待外部配置后继续执行。","1) Issue CSV 状态按实际结果回填；2) 所有已执行 Test_Method 通过或记录可解释阻断；3) git status 干净；4) commit message 为中文并引用 WCPC。","受影响流程：配置收口证据 -> git 历史 -> 后续开发准入；验证步骤：git status --short；git log -1 --oneline。","git","DONE","DONE","DONE","N/A","[""WCPC-6""]","外部配置未完成，本提交为 PAUSE_FOR_CONFIG 阶段提交，不得标记 GO_TO_HR_MASTER_SYNC。"
1 ID Title Description Acceptance Test_Method Tools Dev_Status Review1_Status Regression_Status Files Dependencies Notes
2 WCPC-0 合同建档 建立 WCP1-CONFIG-CLOSEOUT-V1 合同，锁定本轮为企业微信能力 POC 配置收口与只读复跑；不改 OA API/schema/UI，不部署，不持久修改服务器 .env，不调用生产写接口。 1) CSV 校验通过；2) 范围限定为 Issue CSV、QA-only 脚本必要小修、事实源回写和只读 POC 复跑；3) 不打印 secret、access token、cookie、完整手机号、完整位置、原始 payload 或附件内容；4) 结论只允许 GO_TO_HR_MASTER_SYNC、PAUSE_FOR_CONFIG、PAUSE_FOR_API_POC、NO_GO_REVISE_ROADMAP。 受影响流程：WCP1 配置阻断 -> 企微后台补配置 -> 服务器容器只读复跑 -> HR 主数据镜像准入判断；验证步骤：python3 /home/shunli/.codex/skills/plan/scripts/validate_issues_csv.py issues/2026-05-18_15-01-23-wecom-capability-poc-config-closeout-v1.csv。 python3|manual DONE DONE DONE issues/2026-05-18_15-01-23-wecom-capability-poc-config-closeout-v1.csv [] 回滚路径：回退本 CSV、QA-only 脚本小修和文档/skill 回写；不涉及数据库、业务运行时、部署或公网持久配置。
3 WCPC-1 新在职测试成员准备 等待用户在企业微信后台创建或指定新的在职测试成员 WCP1TEST-<YYYYMMDDHHmmss>，并加入工作台应用、通讯录、人事助手、打卡、审批可见/权限范围。 1) 获取新测试成员 userid；2) 该成员为 active/in-service，不使用已离职/禁用的 HRWDTEST-20260517214548；3) 成员不承载真实敏感业务资料；4) POC 输出只显示脱敏 userid 前缀。 受影响流程：企微通讯录/人事助手 -> OA HR 主数据镜像准入；验证步骤：在复跑报告中检查 contact.member_read 和 hr.staff_read 对该测试成员有状态和脱敏证据。 manual|node TODO TODO TODO external|scripts/qa/check-wecom-capability-poc.mjs ["WCPC-0"] BLOCKED_BY_USER_CONFIG：需要用户完成企微后台测试成员和权限范围配置，并提供非敏感 userid。
4 WCPC-2 新建测试审批单 等待用户用新在职测试成员在企业微信提交一条请假或补卡测试审批，记录审批模板 ID 和审批单号 sp_no；测试单不上传敏感附件。 1) 获取 WECOM_APPROVAL_TEMPLATE_ID；2) 获取 WECOM_APPROVAL_SP_NO 或 WECOM_APPROVAL_INSTANCE_ID；3) 测试审批单属于测试成员和测试模板；4) 不使用采购、合同、报销、发票、银行回单或代账资料。 受影响流程：企微审批模板/审批详情/假期余额 -> OA HR/考勤审批镜像准入；验证步骤：复跑报告中 approval.template_detail、approval.instance_detail、approval.vacation_quota 均有唯一状态和原因。 manual|node TODO TODO TODO external|scripts/qa/check-wecom-capability-poc.mjs ["WCPC-1"] BLOCKED_BY_USER_CONFIG：需要用户提供模板 ID 和测试审批单号；缺权限时记录 PAUSE_FOR_CONFIG。
5 WCPC-3 配置清单核对 核对通讯录读取、人事助手花名册读取、打卡 API、审批模板/详情、假期余额和回调配置所需权限；本轮不持久修改服务器 env。 1) 配置核对清单回写到事实源；2) 缺配置项均以 NEEDS_CONFIG 或 SKIP/BLOCKED_BY_EXTERNAL_CONFIG 记录；3) 不把缺配置伪造成 PASS；4) 回调本轮只验证配置存在性，不验证真实事件投递。 受影响流程：企微后台配置 -> POC runner 能力矩阵；验证步骤：rg -n 'WCPC|PAUSE_FOR_CONFIG|contact.member_read|hr.staff_read|WECOM_CHECKIN_SYNC_ENABLED|WECOM_APPROVAL_TEMPLATE_ID|WECOM_CALLBACK' docs issues .agents/skills/hyb-oa-delivery/SKILL.md。 rg|manual DONE DONE DONE docs|issues|.agents/skills/hyb-oa-delivery/SKILL.md ["WCPC-0"] 如果发现 OA 尚无审批回调接收端，不在本轮补业务接口，留到 wecom_attendance_approval_mirror_v1。
6 WCPC-4 服务器临时注入复跑 在部署服务器容器内临时传入新测试 userid、审批模板 ID、审批单号、打卡开关和回调配置，执行 check-wecom-capability-poc.mjs；不写 .env、不重启服务。 1) 报告输出到 /tmp/wecom-capability-poc-wcpc/summary.json；2) 只读 POC status=PASS；3) 敏感值不出现在命令输出、报告、Issue 或文档；4) 若缺外部配置，结论为 PAUSE_FOR_CONFIG。 受影响流程：服务器 env 临时注入 -> 企微 API 只读探测 -> 脱敏能力矩阵；验证步骤：ssh [email protected] 'cd /opt/hyb-oa-trialrun && docker-compose -f deploy/trialrun/docker-compose.yml exec -T server sh -lc "WECOM_CAPABILITY_POC_LIVE_READ=1 WECOM_CAPABILITY_POC_JSON=1 WECOM_CAPABILITY_POC_TEST_USERID=<test-userid> WECOM_CAPABILITY_POC_DAYS=1 node - --json --report-dir=/tmp/wecom-capability-poc-wcpc"' < scripts/qa/check-wecom-capability-poc.mjs。 ssh|docker-compose|node TODO TODO TODO scripts/qa/check-wecom-capability-poc.mjs|external ["WCPC-3"] 敏感配置通过既有容器 env 或交互式方式注入；不得持久写入 deploy/trialrun/.env。
7 WCPC-5 能力矩阵判定 判定复跑结果：contact.member_read 与 hr.staff_read 必须通过；打卡、审批、假期、回调按唯一状态记录；hr.staff_update_classification 可保留 NEEDS_API_POC。 1) contact.member_read=CAN_REUSE_NOW；2) hr.staff_read=CAN_REUSE_NOW；3) checkin.records_read/checkin.rules_read 返回 API 可读或明确配置阻断；4) approval.template_detail/instance_detail/vacation_quota/callback.config 均有状态；5) approval.oa_primary_sensitive_domains=KEEP_OA_PRIMARY。 受影响流程：能力矩阵 -> GO_TO_HR_MASTER_SYNC 或暂停配置；验证步骤：rg -n 'GO_TO_HR_MASTER_SYNC|PAUSE_FOR_CONFIG|PAUSE_FOR_API_POC|NO_GO_REVISE_ROADMAP|contact.member_read|hr.staff_read|approval.vacation_quota|callback.config' docs issues artifacts scripts。 rg|node TODO TODO TODO docs|issues|scripts|artifacts/qa-flow/wecom-capability-poc-* ["WCPC-4"] 只有 GO_TO_HR_MASTER_SYNC 才允许下一步规划 wecom_hr_master_sync_v1；即使通过也不直接开发镜像、应急、回写或 RuleOps。
8 WCPC-6 事实源回写 更新路线图、企业微信规约、PRD、文档索引、事实源矩阵、人工试运行报告和项目 skill，记录 WCPC 基线复跑结论和剩余配置项；完整复跑后继续回填最终结论。 1) 路线图当前阶段更新为 WCPC 基线复跑结果；2) 规约和 PRD 记录能力矩阵准入/阻断；3) 文档索引和事实源矩阵登记 WCPC；4) skill 明确后续依据 WCPC 结论推进；5) 文档审计、skill 校验和 git diff --check 通过。 受影响流程：后续 agent/人工读取事实源 -> 是否进入 wecom_hr_master_sync_v1；验证步骤：node scripts/qa/audit-docs.mjs --check-registry；python3 /home/shunli/.codex/skills/.system/skill-creator/scripts/quick_validate.py .agents/skills/hyb-oa-delivery；git diff --check。 node|python3|git|rg DONE DONE DONE docs/企微优先开发路线图.md|docs/需求-企业微信基础设施规约.md|docs/海音达OA-MVP需求规格说明书.md|docs/文档索引.md|docs/文档事实源状态矩阵.md|docs/trialrun/人工试运行报告.md|.agents/skills/hyb-oa-delivery/SKILL.md ["WCPC-3"] 本轮只回写基线和等待配置状态，不部署；完整 POC 需在 WCPC-1/2/4/5 完成后再回填最终结论。
9 WCPC-7 阶段中文提交 基线复跑和事实源回写通过后提交中文 commit；完整 POC 仍等待外部配置后继续执行。 1) Issue CSV 状态按实际结果回填；2) 所有已执行 Test_Method 通过或记录可解释阻断；3) git status 干净；4) commit message 为中文并引用 WCPC。 受影响流程：配置收口证据 -> git 历史 -> 后续开发准入；验证步骤：git status --short；git log -1 --oneline。 git DONE DONE DONE N/A ["WCPC-6"] 外部配置未完成，本提交为 PAUSE_FOR_CONFIG 阶段提交，不得标记 GO_TO_HR_MASTER_SYNC。