hyb-oa/issues/2026-05-18_12-21-01-wecom-first-design-gate.csv

1	ID	Title	Description	Acceptance	Test_Method	Tools	Dev_Status	Review1_Status	Regression_Status	Files	Dependencies	Notes
2	WFDG-0	合同建档	建立 WECOM-FIRST-DESIGN-GATE 合同，锁定本轮只做企微优先与 OA 主办数据边界的设计规约门禁，不改业务代码、不部署、不改公网配置、不调用生产写接口。	1) CSV 校验通过；2) 明确本轮只更新设计规约、需求事实源、手册、项目 skill 和后续 POC 验收口径；3) 不新增 API/schema/UI/feature flag；4) 不触碰公网配置、生产写接口或真实数据。	受影响流程：需求边界确认 -> 设计规约门禁 -> 后续 POC 合同；验证步骤：python3 /home/shunli/.codex/skills/plan/scripts/validate_issues_csv.py issues/2026-05-18_12-21-01-wecom-first-design-gate.csv。	python3|manual	DONE	DONE	DONE	issues/2026-05-18_12-21-01-wecom-first-design-gate.csv	[]	已验证：CSV 校验、文档审计、skill 校验、内容 rg 和 git diff --check 通过；audit-docs 仅保留既有 unregistered docs files warning。结论 DONE_DESIGN_READY；回滚路径：回退本 CSV 和文档/skill 口径回写；不涉及运行时。
3	WFDG-1	主办方与数据边界矩阵	在现有事实源中明确各业务域主事实源、操作端、镜像方向、附件归属和审计责任，固定 HR/考勤企微主办、OA 镜像和接管，报销/采购/合同/项目/付款/AP/代账继续 OA 主办。	1) PRD、产品口径和企业微信规约包含主办方矩阵；2) OA 主办域不反向全量镜像到企微；3) 高敏附件归属 OA 或线下受控归档，不进入企微原生审批或企微附件。	受影响流程：企微 HR/考勤 -> OA 镜像；OA 报销/采购/合同/财务 -> 企微脱敏提醒；验证步骤：rg -n '主办方|主事实源|操作端|镜像方向|附件归属|OA 主办|企微主办|按域镜像' docs。	rg|manual	DONE	DONE	DONE	docs/产品口径.md|docs/海音达OA-MVP需求规格说明书.md|docs/需求-企业微信基础设施规约.md	["WFDG-0"]	已验证：主办方与数据边界矩阵已回写 PRD、产品口径和企业微信规约；本轮只固化设计口径，不代表企微 HR/考勤镜像运行时已完成。
4	WFDG-2	入口与交互规约	更新产品设计规则和相关事实源，要求员工 HR/考勤日常流程优先在企微完成，OA 主办审批通过企业微信脱敏消息 deeplink 回 OA，PC/移动页面必须区分 OA 主办、企微镜像和 OA 应急接管。	1) 产品设计规则写明三类页面/入口状态；2) 员工日常 HR/考勤不在企微正常可用时引导到 OA 新建；3) OA 主办审批的移动/企微入口仍回 OA 处理。	受影响流程：员工进入企业微信工作台 -> HR/考勤企微处理或 OA 镜像查看；审批人收到 OA 主办消息 -> deeplink 回 OA；验证步骤：rg -n 'OA 主办|企微镜像|OA 应急接管|deeplink|HR/考勤日常流程' docs/产品设计规则.md docs。	rg	DONE	DONE	DONE	docs/产品设计规则.md|docs/需求-统一审批中心规约.md|docs/需求-请假考勤修正规约.md	["WFDG-1"]	已验证：产品设计规则和审批/考勤规约均写入 OA 主办、企微镜像和 OA 应急接管区分；后续页面实现必须另拆 Issue CSV 并跑 PC/移动/企业微信矩阵。
5	WFDG-3	隐私附件和消息规约	固定企业微信消息字段只允许标题、类型、编号、状态和入口；采购单附件、合同正文、报价、供应商资料、发票、银行回单和代账资料不进入企微原生审批或企微附件。	1) 企业微信基础设施规约、审批规约、管理员/员工手册均写明脱敏消息和高敏附件边界；2) 不写任何把高敏附件上传企微的默认流程；3) 不把企业微信消息作为附件查看权限。	受影响流程：OA 主办单据提交 -> 企业微信消息 -> OA deeplink -> OA 权限查看附件；验证步骤：rg -n '脱敏消息|不进入企微|不上传到企业微信|合同正文|报价|银行回单|代账资料' docs。	rg	DONE	DONE	DONE	docs/需求-企业微信基础设施规约.md|docs/需求-统一审批中心规约.md|docs/管理员手册.md|docs/员工快速上手.md	["WFDG-2"]	已验证：企业微信规约、审批规约和手册均写明脱敏消息及高敏附件边界；默认不接个人微信，文档中的微信按企业微信个人应用消息理解。
6	WFDG-4	同步审计失败处理规约	规定后续企微同步必须具备幂等、重试、脱敏日志、审计记录和 SKIP/BLOCKED_BY_EXTERNAL_CONFIG 状态；缺配置或缺权限不得伪造成成功。	1) 企业微信规约和 PRD 写明同步失败处理；2) 后续 POC 能区分 CAN_REUSE_NOW、NEEDS_CONFIG、NEEDS_API_POC、KEEP_OA_PRIMARY、NOT_SUPPORTED_BY_API；3) 日志不得输出 Secret、token、完整手机号、完整位置或原始 payload。	受影响流程：企微 API 探测/同步 -> OA 镜像或 SKIP -> 管理员重试/配置修复；验证步骤：rg -n '幂等|重试|脱敏日志|BLOCKED_BY_EXTERNAL_CONFIG|CAN_REUSE_NOW|NEEDS_CONFIG|NOT_SUPPORTED_BY_API' docs issues。	rg	DONE	DONE	DONE	docs/需求-企业微信基础设施规约.md|docs/海音达OA-MVP需求规格说明书.md	["WFDG-3"]	已验证：企业微信规约和 PRD 已写明同步失败处理和 POC 能力矩阵；只定义规约，不新增 QA-only 探测脚本，脚本留到 WECOM-CAPABILITY-POC-V1。
7	WFDG-5	应急接管与恢复回写规约	固定 OA HR/考勤应急模式只能由管理员人工开启；恢复后先 dry-run，再回写企微；冲突、权限不足或 API 不支持进入人工确认。	1) 管理员手册、请假考勤规约和企业微信规约写明人工开启、原因、范围、预计结束时间和责任人；2) 应急单据必须带 EMERGENCY；3) 恢复回写不能静默覆盖企微正式记录。	受影响流程：企微不可用 -> 管理员开启 OA 应急模式 -> 员工应急提交 -> 企微恢复 dry-run -> 回写或冲突人工确认；验证步骤：rg -n '应急接管|EMERGENCY|dry-run|恢复回写|人工确认|静默覆盖' docs。	rg	DONE	DONE	DONE	docs/管理员手册.md|docs/需求-请假考勤修正规约.md|docs/需求-企业微信基础设施规约.md	["WFDG-4"]	已验证：管理员手册、请假考勤规约和企业微信规约均写明应急接管与恢复回写；不自动触发接管，不在本轮实现运行时开关。
8	WFDG-6	RuleOps 与 AI 边界	固定 AI 只允许草拟规则、生成差异报告和 dry-run；正式写入企微审批模板、打卡规则、排班、假期余额或人事字段前必须人工确认，并保存前后快照和审计。	1) PRD、企业微信规约、审批规约和管理员手册写明 AI 不得直接写正式规则；2) RuleOps 正式写入必须保存前后快照、确认人、API errcode、失败原因和回滚建议；3) 不扩大 AI 自动审批或自动处理范围。	受影响流程：AI 草拟企微规则 -> 管理员确认 -> API 写入 -> 审计/回滚建议；验证步骤：rg -n 'RuleOps|AI.*草拟|dry-run|人工确认|前后快照|errcode|回滚建议' docs。	rg	DONE	DONE	DONE	docs/海音达OA-MVP需求规格说明书.md|docs/需求-企业微信基础设施规约.md|docs/需求-统一审批中心规约.md|docs/管理员手册.md	["WFDG-5"]	已验证：PRD、企业微信规约、审批规约和管理员手册均写明 RuleOps 与 AI 边界；AI 自动处理业务和自动审批继续不进入当前路线。
9	WFDG-7	文档与 skill 回写	更新现有事实源和项目 skill，不新建综合规划文档；回写产品口径、PRD、企微规约、审批规约、请假考勤规约、产品设计规则、管理员手册、员工手册、文档索引、事实源矩阵、人工试运行报告和 hyb-oa-delivery skill。	1) 相关事实源均记录 WFDG 设计门禁；2) skill 明确后续先做 WECOM-CAPABILITY-POC-V1，不直接大开发；3) 文档审计、skill 校验和 git diff --check 通过。	受影响流程：后续 agent/人工读取事实源 -> 拆 POC 合同 -> 实现合同；验证步骤：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|.agents/skills/hyb-oa-delivery/SKILL.md|issues/2026-05-18_12-21-01-wecom-first-design-gate.csv	["WFDG-6"]	已验证：文档审计 errors=0 warnings=1（既有 unregistered docs files: 24）、skill valid、git diff --check 通过；优先更新现有文档，不新建综合规划文档。
10	WFDG-8	下一轮 POC 合同定义	为 WECOM-CAPABILITY-POC-V1 固定验收口径：能力矩阵覆盖人事助手、通讯录、打卡、审批、假期余额、回调和权限配置，状态包括 CAN_REUSE_NOW、NEEDS_CONFIG、NEEDS_API_POC、KEEP_OA_PRIMARY、NOT_SUPPORTED_BY_API。	1) PRD、企业微信规约、文档索引和事实源矩阵写明下一轮 POC 是正式开发前置；2) POC 默认只读或低风险探测；3) 生产写操作必须单独批准；4) 后续开发顺序明确。	受影响流程：设计门禁 -> API POC -> HR 主数据镜像 -> HR/考勤审批镜像 -> OA 应急接管 -> 恢复回写 -> RuleOps；验证步骤：rg -n 'WECOM-CAPABILITY-POC-V1|CAN_REUSE_NOW|NEEDS_API_POC|KEEP_OA_PRIMARY|wecom_hr_master_sync_v1|wecom_attendance_approval_mirror_v1|oa_hr_emergency_mode_v1|wecom_recovery_writeback_v1|wecom_ruleops_v1' docs issues .agents/skills/hyb-oa-delivery/SKILL.md。	rg	DONE	DONE	DONE	docs|.agents/skills/hyb-oa-delivery/SKILL.md|issues/2026-05-18_12-21-01-wecom-first-design-gate.csv	["WFDG-7"]	已验证：PRD、企业微信规约、文档索引、事实源矩阵和 skill 均写明 WECOM-CAPABILITY-POC-V1 与后续开发顺序；WFDG 完成结论为 DONE_DESIGN_READY，不代表任何运行时迁移已完成。