文件
hyb-oa/docs/文档事实源状态矩阵.md
T

61 KiB
原始文件 Blame 文件历史

文档事实源状态矩阵

文档状态:当前文档治理事实源。 分类:文档台账。 适用时间:DCL7 之后。 关联 Issue:GOV8。 最近审计:2026-05-18。 不得误读:本文登记文档权威性和状态,不替代具体 PRD、模块规约、测试规约或 Issue CSV。 治理口径:中文优先,物理精简,优先复用已有文档。历史资料不建 docs/archive/,已确认不用的文档从当前树移除,通过 git 历史恢复。

冲突优先级

最新 Issue CSV > 当前 PRD/模块规约 > 产品和设计规则 > 当前操作手册 > 技术参考 > 历史证据 > git 历史。

台账状态值

Status 含义 是否可直接指导开发
CURRENT 当前事实源或当前执行合同 可以
DRAFT 草案或准备材料,未完成启动确认 不可以
EVIDENCE 试运行、测试、审计或验收证据 不可以
HISTORICAL 历史快照或旧合同 不可以
SUPERSEDED 已被新文档或新合同替代 不可以
REMOVED 已从当前树物理移除,只能从 git 历史恢复 不可以

当前活跃治理流

Stream Contract Status 用途
GOV8 issues/2026-05-13_16-31-09-gov8-system-governance.csv EVIDENCE 连续型 Issue 治理、文档台账、流程模板和审计脚本,已收口
DG8 issues/2026-05-13_22-56-49-design-ui-governance.csv EVIDENCE 设计治理主参考系统收口;飞书工作台/飞书审批为唯一主 UI/布局参考,不代表页面已整改
DG9 issues/2026-05-13_23-30-00-dg9-ui-layout-rollout.csv EVIDENCE 全站 UI/布局样板迁移已收口;最新代码已作为 R7E 基线部署到公网,不替代 WF8/UX8/BIZ8
R7E issues/2026-05-13_17-11-44-r7e-human-trialrun.csv EVIDENCE 真实扩大试运行阶段验收、P2 排序和 R7E 收口已完成,P0/P1 阻断为 0
ORG8 issues/2026-05-13_18-23-51-org8-master-data-permission.csv EVIDENCE 组织账号和权限主数据治理已阶段收口;本地代表性角色验收通过,不替代 R7E 真实人工试运行
WF8 issues/2026-05-13_18-23-52-wf8-approval-notification.csv EVIDENCE 审批与通知增强已阶段收口;deeplink 过期修复已部署并经代表设备真机点击回 OA 验证
BIZ8 issues/2026-05-13_18-23-53-biz8-finance-ocr-project.csv EVIDENCE 报销/OCR/财务/项目轻量增强已阶段收口;财务移动入口真机通过,财务/项目权限回归完成,付款批次延期到 P2
QAOPS8 issues/2026-05-13_17-30-00-qaops8-test-release-ops.csv EVIDENCE Go/No-Go 与上线硬化阶段收口已完成;后续硬化另起 QAOPS9 或等价连续合同
FBA issues/2026-05-15_23-45-41-r7e-post-function-boundary-audit.csv EVIDENCE R7E 后全端功能边界审计和后续 Issue 草案;不启动 P2 功能开发
QAOPS9 issues/2026-05-16_00-19-20-qaops9-release-hardening.csv EVIDENCE R7E 后上线硬化连续合同已收口;核心业务流、live smoke、真实 OCR、移动矩阵和恢复演练 dry-run 均有证据,未部署新 commit
P2D issues/2026-05-16_00-19-21-p2-decision-followup.csv EVIDENCE P2 功能决策分流已完成:P2-ORG 只读巡检可进独立合同,其余 P2 候选保持 HOLD_FOR_PREREQ,冻结项继续冻结
P2-ORG issues/2026-05-16_02-04-27-p2-org-readonly-master-data-audit.csv EVIDENCE 组织账号主数据只读巡检已完成;当前连接数据源高/中风险为 0,仅有低风险观察项,不需要写修复合同
P2-FIN-DECISION issues/2026-05-16_09-02-42-p2-fin-payment-batch-decision.csv EVIDENCE 付款批次启用决策准备已完成,结论 GO_TO_IMPLEMENT;后续必须另建 P2-FIN-V1 实现合同,当前不启用 payment_batch_v1
P2-FIN-V1 issues/2026-05-16_09-42-43-p2-fin-payment-batch-v1.csv EVIDENCE 付款批次启用前本地/隔离硬化已完成;后端 focused 回归、前端构建、隔离闭环、权限审计和公网 readiness 通过,公网仍不启用 payment_batch_v1
P2-OCR-SAMPLE issues/2026-05-16_10-15-21-p2-ocr-image-sample-governance.csv EVIDENCE 图片 OCR 样票治理和实现前置确认已完成;P2AF 纠偏后当前默认 FREEZE_BY_DEFAULT,保持 PDF-only,不开放图片 OCR
P2Q issues/2026-05-16_10-35-22-p2-post-p2ocrs-followup-queue.csv EVIDENCE P2OCRS 后续任务队列已锁定;图片 OCR 默认冻结,后续实现均需另建独立合同,当前不部署、不改业务代码
P2AUTO issues/2026-05-16_20-09-49-p2-automated-regression-sweep.csv EVIDENCE 自动化优先回归已收口;后端/前端/隔离业务流/公网 readiness/PDF live OCR/移动与企业微信自动化均有证据,provider-only 默认决策为 FREEZE_BY_DEFAULT
P2AF issues/2026-05-16_22-11-10-p2-automatable-followup.csv EVIDENCE 可自动实施收口已完成;纠正图片 OCR 默认冻结口径,补 QA-only 安全回归、付款批次公网关闭态只读门禁和 UX8 自动矩阵扫尾;报告 artifacts/qa-flow/p2-safe-regression-20260516-222222/
P2-FIN-LIVE-DECISION issues/2026-05-16_22-49-05-p2-fin-payment-batch-live-decision.csv EVIDENCE 公网付款批次启用窗口决策已收口;readiness 和 flag-off 只读门禁通过,初始结论 HOLD_FOR_WINDOW,随后用户批准进入 P2-FIN-LIVE
P2-FIN-LIVE issues/2026-05-16_23-42-08-p2-fin-payment-batch-live-enable.csv EVIDENCE 公网付款批次短窗口受控测试已收口;测试报销、付款批次、AP 导出和审计核验通过,最终 payment_batch_v1=flag_force_off,未部署
PRELAUNCH issues/2026-05-17_00-46-49-prelaunch-production-readiness.csv EVIDENCE 正式启用前公网预回归已收口;公网 readiness、远端只读基线、隔离核心业务流、付款批次 PRELAUNCH 窗口、移动/企业微信矩阵和 Go/No-Go 摘要完成;最终 payment_batch_v1=flag_force_off,未部署
CASHIER-VOUCHER-V1 issues/2026-05-17_09-04-37-cashier-payment-voucher-v1.csv EVIDENCE 正式启用前财务闭环与银行回单附件已收口;新增付款批次银行回单附件、复核后补凭证和银行渠道执行前回单阻断;已由 LAUNCH-DEPLOY-FINANCE 部署到公网
LAUNCH-DEPLOY-FINANCE issues/2026-05-17_09-38-55-launch-deploy-finance.csv EVIDENCE CASHV 部署与公网复检已收口;本地全流程/页面门禁、受控部署、migration 应用、公网 readiness、PDF live OCR、移动/企微矩阵和 CASHV 短窗口均通过;最终 payment_batch_v1=flag_force_off
FIN-PROD-ENABLE issues/2026-05-17_11-40-47-fin-prod-enable-payment-batch.csv EVIDENCE 公网付款批次正式常开已收口;测试报销 BX-20260517-0026 完成付款闭环、AP 导出、审计和移动/企微矩阵,最终 payment_batch_v1=force_on、erp_sync=force_off
ACCOUNTING-HANDOFF-V1 issues/2026-05-17_11-40-48-accounting-handoff-v1.csv EVIDENCE 月度代账交接 SOP 已收口;OA 侧导出和回单附件清单可用,银行流水和回单原件由出纳从银行侧导出,不导入 OA
SYSTEM-COMPLETE-GATE issues/2026-05-17_12-55-49-system-complete-gate.csv EVIDENCE 系统开发完成门禁已收口;公网 readiness、live smoke、PDF live OCR、flag 状态、移动/企微矩阵和事实源核对通过,结论 GO_TO_USE
LAUNCH-OPS-V1 issues/2026-05-17_12-55-50-launch-ops-v1.csv EVIDENCE 首周正式使用运营保障已收口;支持人、问题登记、每日巡检、暂停条件、回滚联系人、代账交接节奏和冻结项口径已固定
REQ-COMPLETE-AUDIT issues/2026-05-17_13-32-26-requirements-completion-audit.csv EVIDENCE 需求完成度复核和考勤边界校正已收口;首批能力可交付不变,企业微信打卡作为原始采集和风控底座,OA 不重造定位/人脸/Wi-Fi/排班/防作弊;员工补卡/外出/加班审批和企微打卡 API 同步需后续合同
ATTV1 issues/2026-05-17_14-59-28-attendance-unified-wecom-sync-v1.csv EVIDENCE 考勤统一入口与企微打卡同步 V1 已收口:提交 916cc3b 和 b2b4447 已部署到公网;历史 OA 自建打卡关闭,补卡/外出/加班 OA 审批和月度解释可用;公网 readiness、PDF live OCR、移动/企业微信矩阵 14 passed,旧打卡 API 返回 409,企微打卡同步缺配置时记录 SKIP
LAUNCH-AUTO-OPS-V1 issues/2026-05-17_17-47-45-launch-auto-ops-v1.csv EVIDENCE 正式启用后自动化收口已阶段完成,结论 PAUSE_FOR_FIX:本地门禁、公网 readiness/PDF live OCR、考勤统一入口、移动矩阵和企业微信 UA/渲染矩阵通过;企微打卡同步显式检查为 SKIP wecom_checkin_sync_disabled;公网 payment_batch_v1=force_off 与正式常开口径不一致,付款批次写入已安全跳过
AUTO-REMAINING-CLOSEOUT issues/2026-05-17_19-30-44-auto-remaining-closeout.csv EVIDENCE 剩余无需人工操作事项已收口,结论 GO_TO_OPERATE:公网 payment_batch_v1 已恢复 force_on,erp_sync=force_off;正式自动巡检报告 artifacts/qa-flow/launch-auto-ops-20260517-193317/ 为 PASS,付款批次常开闭环、移动矩阵和企业微信渲染矩阵通过;企微打卡同步仍因外部配置 SKIP wecom_checkin_sync_disabled
HR-WECOM-DIRECTORY-V1 issues/2026-05-17_20-00-40-hr-wecom-directory-v1.csv EVIDENCE 人事生命周期与企业微信通讯录同步已部署并收口:ERP 未来不接入 OA;HR 大域拆分为人事生命周期和考勤两个模块;OA 驱动企微通讯录创建/更新/禁用,失败不回滚 OA 人事动作;公网端点检查显示缺通讯录配置时重试记录 SKIP wecom_contact_sync_disabled,不阻断 OA 人事闭环;seed-config 已改为不覆盖已有正式 feature flag,复部署后 payment_batch_v1=force_on、erp_sync=force_off
HRWD-CONTACT-LIVE-TEST issues/2026-05-17_21-41-43-hrwd-contact-live-test.csv EVIDENCE 公网企微通讯录真实写入闭环已收口:HRWDTEST-20260517214548 测试员工完成 create/update/disable,企微 errcode=0,OA 员工最终 archived/inactive,登录负例、普通员工权限负例和审计动作均通过;报告 artifacts/qa-flow/hrwd-contact-live-test-20260517T134548Z/summary.json
WCFB issues/2026-05-17_22-57-39-wecom-checkin-agent-secret-fallback.csv DEPLOYED 企微打卡同步 Secret 兼容修正:WECOM_CHECKIN_SECRET 显式优先,未配置时复用已授权工作台应用的 WECOM_AGENT_SECRET;已随 WRV1 部署,WRA1 纠正 QA-only 只读门禁误判;正式同步批次仍由 WECOM_CHECKIN_SYNC_ENABLED 控制
WFOC issues/2026-05-18_10-25-18-wecom-first-oa-continuity-requirements.csv EVIDENCE 企微优先 + OA 无痛接管需求重构已收口;其中“HR/考勤/行政审批企微优先”和“完整镜像”宽口径已由 DBWFOC 收窄为 HR/考勤员工日常审批优先和按域镜像
DBWFOC issues/2026-05-18_11-35-39-data-boundary-wfoc-revision.csv EVIDENCE 企微能力参考 + OA 主办数据边界修正已收口;HR/考勤员工日常审批企微优先,采购/合同/财务等 OA 主办高敏业务不进入企微原生审批或企微附件
WFDG issues/2026-05-18_12-21-01-wecom-first-design-gate.csv EVIDENCE 企微优先设计规约门禁已收口:固定主办方与数据边界矩阵、入口交互、隐私附件消息、同步审计失败处理、应急接管、恢复回写、RuleOps 和 WECOM-CAPABILITY-POC-V1 验收口径
WDRG issues/2026-05-18_12-44-10-wecom-development-roadmap-gate.csv EVIDENCE 企微优先开发路线图门禁已收口:固定路线图门禁、单功能 Issue CSV 节奏、阶段顺序、并行规则和下一轮 POC 合同口径
WCP1 issues/2026-05-18_13-30-07-wecom-capability-poc-v1.csv EVIDENCE 企业微信能力 POC 已完成,历史结论 PAUSE_FOR_CONFIG;初始配置缺口已由 WCPC 复跑收口
WCPC issues/2026-05-18_15-01-23-wecom-capability-poc-config-closeout-v1.csv EVIDENCE WCP1 配置收口已用既有在职测试号复跑通过,结论 GO_TO_HR_MASTER_SYNC,已由 WHMS 承接
WHMS issues/2026-05-18_18-43-19-wecom-hr-master-sync-v1.csv CURRENT 企微 HR 主数据镜像已实现:wecom_hr_master_sync_v1、同步批次/逐员工记录、dry-run/apply、管理员 API、People 管理入口和 QA-only runner;默认 force_off,不代表考勤/审批镜像已完成
WHMSLIVE issues/2026-05-18_19-28-25-whms-deploy-live-verify-v1.csv EVIDENCE WHMS 已部署并完成受控公网验证:migration 已应用,SMOKE002 dry-run/apply 管道通过但因缺手机号、邮箱和部门按 missing_required_field 跳过,普通员工权限负例 403,最终 wecom_hr_master_sync_v1=force_off,未执行生产真实员工批量 apply
WOUA issues/2026-05-18_20-45-58-wecom-oa-user-consistency-audit.csv EVIDENCE OA/企微用户一致性只读审计已由 WAPI 新口径复跑:结论 PASS_WITH_FINDINGS,OA active 12、企微 active 5、匹配 5、OA active 缺企微 7、已归档仍有绑定 1、缺必填字段 5;未修改 OA/企微用户,未执行真实员工批量 apply
WAPI issues/2026-05-18_21-46-41-wecom-api-capability-catalog-runtime-first.csv CURRENT 企微 API 能力目录与运行优先纠偏已收口:固定官方 API 目录、Secret 矩阵、WHMS/WOUA 读取策略,成员详情降级为可选富化,公网 WOUA 复跑 PASS_WITH_FINDINGS;不执行真实员工批量 apply
WRRA issues/2026-05-18_23-19-38-wecom-route-readiness-adjustment.csv EVIDENCE 企微路线门禁修正与下一阶段规划已收口:PASS_WITH_FINDINGS 不能直接放行深度镜像;其差异收口已由 WOUA-FIX 承接
WOUA-FIX issues/2026-05-18_23-45-45-wecom-oa-user-consistency-fix-runtime-ready.csv CURRENT OA/企微用户一致性差异已受控收口:7 个缺企微测试账号软归档,T0000 seed 复活已修正,SMOKE201 测试主管/待办副作用已转交;WOUA 复检 OA active 5、企微 active 5、匹配 5、OA active 缺企微 0;企微缺字段先接受不补
WRV1 issues/2026-05-19_01-10-32-wecom-runtime-ready-v1.csv EVIDENCE 企业微信运行优先门禁已部署并公网只读验证:新增 check:wecom-runtime-ready QA-only runner;报告 /app/artifacts/qa-flow/wecom-runtime-ready-20260518T173402Z/summary.json 为 SKIP/BLOCKED_BY_EXTERNAL_CONFIG,入口/OAuth、Secret 矩阵、OA active 绑定、通讯录、人事助手和消息 dry-run 通过,打卡读取因 WECOM_CHECKIN_SYNC_ENABLED=true 未启用阻断;审批模板、测试 sp_no、真实回调缺口仅记 NEEDS_CONFIG,不放行深度镜像
WRA1 issues/2026-05-19_01-55-43-wecom-runtime-acceptance-v1.csv EVIDENCE 企微运行验收门禁修正已部署并公网复跑:WECOM_CHECKIN_SYNC_ENABLED 保留为正式考勤同步开关,QA-only 打卡只读探测显式使用 requireSyncEnabled=false;报告 /app/artifacts/qa-flow/wecom-runtime-ready-20260518T180506Z/summary.json 为 PASS_WITH_CONFIG_GAPS,打卡只读可读,审批模板、测试 sp_no 和真实回调仍为 NEEDS_CONFIG
WMSG1 issues/2026-05-19_07-41-37-wecom-message-live-verify-v1.csv EVIDENCE 企微应用消息实发与 Deeplink 真机验证已完成:远端单次设置 WECOM_RUNTIME_TEST_SEND=1,报告 /app/artifacts/qa-flow/wecom-runtime-ready-20260518T234431Z/summary.json 显示消息 errcode=0、recipientCount=1;用户确认收到“OA 运行就绪检查”并可点击进入 OA 通知页面;审批模板、测试 sp_no 和真实回调仍为后续配置缺口
WAPC1 issues/2026-05-19_08-44-58-wecom-approval-config-prep-v1.csv EVIDENCE 企微审批配置准备清单已完成:WMSG1 后不直接进入深度镜像;首批模板为请假、补卡、外出、加班;模板 ID、低风险 sp_no、真实回调配置项、验签/解密/幂等/重试和补偿拉取准入已固化;本轮不改业务代码、不部署、不接真实回调、不调用企微写接口
WAPC2 issues/2026-05-19_09-34-16-wecom-approval-template-spno-poc-v1.csv CURRENT 企微审批模板与低风险 sp_no 只读 POC 已部署并公网复跑:新增 check:wecom-approval-poc QA-only runner 和只读集成服务,范围请假/补卡,固定 WECOM_AGENT_SECRET 调用 gettemplatedetail/getapprovaldetail;远端报告 /app/artifacts/qa-flow/wecom-approval-poc-20260519T020429Z/summary.json 为 PARTIAL_APPROVAL_POC_NEEDS_CONFIG,缺模板或 sp_no 不放行深度镜像
WPROC1 issues/2026-05-19_10-43-50-wecom-process-route-engineering-v1.csv CURRENT 企微路线与开发流程工程化修正:docs-only/contract-only 固化三层门禁、Definition of Ready、Definition of Done、自动化优先、非自审和高风险 POC 前置;修正 WAPC2F 默认链为 SMOKE002 -> SMOKE101,WAPC2 后不得直接进入深度镜像
WPROC2 issues/2026-05-19_11-15-10-process-gate-automation-v1.csv CURRENT 开发流程自动化门禁:新增 scripts/qa/check-process-contract.mjs process gate、WAPC2F profile 和最小门禁接入;WAPC2F 实施前必须先通过 baseline gate,不部署、不写 OA/企微数据
WAPC2F issues/2026-05-19_10-24-43-wecom-approval-fixture-auto-generate-v1.csv EVIDENCE 企微审批 POC 样件自动生成 dry-run 已实现并部署验证:新增 check:wecom-approval-fixtures QA-only runner,固定 WECOM_AGENT_SECRET 构建 OA-POC 请假/补卡最小通用模板和低风险审批申请 payload;远端报告 /app/artifacts/qa-flow/wecom-approval-fixtures-20260519T045001Z/summary.json 为 PASS_FIXTURE_DRY_RUN_READY
WAPC2FLIVE issues/2026-05-19_13-24-12-wecom-approval-fixture-live-create-v1.csv CURRENT 企微审批 OA-POC 样件 live 创建已完成:修正 create_template payload 为官方 template_name + property controls 结构后,远端报告 /app/artifacts/qa-flow/wecom-approval-fixtures-20260519T053400Z/summary.json 为 PASS_FIXTURE_CREATED,请假/补卡测试模板和低风险测试审批单已创建并保留审计,自动复跑 WAPC2 为 PASS_APPROVAL_POC;仍不代表真实回调、补偿拉取、镜像模型或深度镜像已完成
WCBK1 issues/2026-05-19_14-11-20-wecom-approval-callback-readonly-poc-v1.csv CURRENT 企微审批回调只读 POC 已完成公网真实事件验证:只读回调端点、验签/AES 解密/归一化服务和 runner 已部署;远端报告 /app/artifacts/qa-flow/wecom-approval-callback-poc-20260519T083422Z/summary.json 为 PASS_CALLBACK_URL_VERIFIED,SMOKE101 同意现有 OA-POC 补卡测试单后复跑 /app/artifacts/qa-flow/wecom-approval-callback-poc-20260519T092648Z/summary.json 为 PASS_CALLBACK_EVENT_CONFIRMED;仍不代表补偿拉取、镜像模型或深度镜像已完成
WEGOV1 issues/2026-05-19_18-17-44-wecom-governance-owned-oa-archive-route-v1.csv CURRENT 企微主办治理与 OA 自建留存路线修正:docs-only 固定企微主办域、OA 主办域、OA 留存域、OA 应急域、受控测试域、自动化/人工边界和后续顺序;WCBK1 后仍需 WACP3、WREAD1、WADM1、WARCH1,不能直接进入深度镜像
WACP3/WACP3R issues/2026-05-19_19-03-06-wecom-approval-compensation-pull-poc-v1.csv、issues/2026-05-19_19-42-22-wecom-approval-compensation-config-rerun-v1.csv CURRENT 企微审批补偿拉取 POC 已实现并公网只读复跑:新增 check:wecom-approval-compensation-poc 和 getapprovalinfo 只读封装,固定 WECOM_AGENT_SECRET;WACP3R 改为按 SMOKE002 creator 自动发现 OA-POC 请假/补卡模板并复跑,远端报告 /app/artifacts/qa-flow/wecom-approval-compensation-poc-20260519T115944Z/summary.json 为 PASS_WITH_FINDINGS,请假/补卡各拉到 1 条详情,finding 为回调证据文件未持久化;未写 OA/企微数据
WREAD1 issues/2026-05-19_20-39-40-wecom-approval-readability-gate-v1.csv CURRENT 企微审批可读性与误审批防护门禁已收口请假/补卡:用户真机确认消息卡片、列表、详情页均可看清;驳回有二次确认,同意单击即通过;远端人工结果报告 /app/artifacts/qa-flow/wecom-approval-readability-gate-20260519T133628Z/summary.json 为 PASS_READABLE。同意单击风险进入 WADM1/WARCH1 的提示、审计留存或操作规程设计,未写 OA/企微业务数据
WREAD1F issues/2026-05-19_21-15-47-wecom-readability-fresh-fixture-v1.csv CURRENT WREAD1 新真机样例补充已完成:首次 live 因企微模板名重复被阻断且未写入;修正 OA-POC 模板名为时间戳唯一后,公网 live 报告 /app/artifacts/qa-flow/wecom-approval-fixtures-20260519T131958Z/summary.json 为 PASS_FIXTURE_CREATED,新建请假/补卡低风险审批单并支撑 WREAD1 真机确认收口为 PASS_READABLE
WADM1 issues/2026-05-19_21-55-33-wecom-archive-mirror-data-model-design-v1.csv CURRENT 企微自建留存/镜像数据模型设计已完成:docs-only 固定审批留存、参与人/动作/字段摘要、附件摘要、回调事件、补偿拉取 run/item、对账 finding、打卡/人事快照复用边界、隐私权限和 WARCH1 最小实现切片;不改 Prisma schema、不部署、不写 OA/企微业务数据
WARCH1 issues/2026-05-19_22-32-06-wecom-approval-archive-minimum-v1.csv CURRENT 企微审批最小自建历史留存已实现并部署验证:新增 Prisma 留存表和 migration、回调事件默认入 OA DB、补偿拉取双开关入库、对账 finding 和 check:wecom-approval-archive 离线读取 runner;远端补偿持久化 /app/artifacts/qa-flow/wecom-approval-compensation-poc-20260519T160306Z/summary.json 为 PASS_WITH_FINDINGS,离线读取 /app/artifacts/qa-flow/wecom-approval-archive-20260519T160330Z/summary.json 为 PASS_WITH_FINDINGS,请假/补卡 2 条已通过历史可读;finding 为 WARCH1 前旧回调未入 DB 的历史 gap;范围仅请假/补卡,不写企微、不新增正式管理页、不进入完整镜像、应急接管、恢复回写或 RuleOps
WARCH2 issues/2026-05-20_00-26-04-wecom-approval-archive-query-v1.csv CURRENT 企微审批正式只读历史查询已实现并部署验证:新增列表/详情 API、PC/移动历史页、备用模块入口和移动考勤卡入口;只读 OA DB,不调用企微 API、不读取企微 Secret;分层权限为本人相关、直属下属、HR/admin/,申请人未映射和 callback-only 记录仅 HR/admin/ 可见;公网 /ready 正常,新 API 未登录返回 401,远端离线归档报告 /app/artifacts/qa-flow/wecom-approval-archive-20260520T013610Z/summary.json 为 PASS_WITH_FINDINGS 且可读 2 条请假/补卡历史
WROAD2+OPS issues/2026-05-20_11-30-22-wroad2-ops-controlled-launch-v1.csv CURRENT 受控上线与每日巡检合同已建立并完成 Day 0 公网基线:范围固定测试账号 SMOKE002 -> SMOKE101,管理员观察和告警员工号使用 HYD000006(wangshunli 的员工号),3 天每日脚本化触发;脚本复用公网 /ready、live smoke、feature flag、企微 runtime、审批补偿和 OA 归档离线读取;仅补偿归档可写 OA 留存库,不写企业微信;Day 0 报告 /app/artifacts/qa-flow/wroad2-ops-20260520-041941/summary.json 为 PASS_WITH_FINDINGS,企微 runtime、补偿归档、离线归档读取和隐私扫描通过,finding 为缺 live smoke 登录凭据/pending OCR 子检查异常以及历史 callback gap,不阻断测试账号受控试用
WARCH3 issues/2026-05-20_12-48-04-wecom-archive-stabilization-ops-v1.csv CURRENT 归档稳定化自动巡检合同已实现并公网验证:新增 scripts/qa/run-warch3-ops-daily.sh 聚合 WROAD2 子报告、解释 observation/finding,新增 deploy/trialrun/install-warch3-ops-timer.sh 安装每日 07:30 systemd timer,新增 send:wecom-ops-alert 脱敏企微告警;公网报告 /app/artifacts/qa-flow/warch3-ops-20260520-054841/summary.json 为 PASS_WITH_FINDINGS,告警 /app/artifacts/qa-flow/wecom-ops-alert-20260520T054851Z/summary.json 为 PASS_ALERT_SENT_WITH_CONFIG_GAPS
WCHECK1 issues/2026-05-20_12-48-04-wecom-checkin-summary-archive-v1.csv CURRENT 打卡摘要留存合同已实现并公网验证:新增打卡日/月摘要和规则快照 Prisma 表、wecomCheckinArchive 服务和 check:wecom-checkin-summary-archive runner;live 报告 /app/artifacts/qa-flow/wecom-checkin-summary-archive-20260520T054907Z/summary.json 为 PASS_CHECKIN_ARCHIVE_READY,offline 报告 /app/artifacts/qa-flow/wecom-checkin-summary-archive-20260520T054926Z/summary.json 为 PASS_CHECKIN_ARCHIVE_OFFLINE_READY;不保存位置、人脸、设备明文或原始 payload
WEXT1 issues/2026-05-20_12-48-04-wecom-outing-overtime-fixture-dryrun-v1.csv CURRENT 外出/加班低风险 POC dry-run 合同已实现并公网验证:扩展 check:wecom-approval-fixtures 支持 outing、overtime payload dry-run;公网报告 /app/artifacts/qa-flow/wecom-approval-fixtures-20260520T054940Z/summary.json 为 PASS_FIXTURE_DRY_RUN_READY;不 live 创建模板或审批单,live 前必须另起问答和合同
WOPS1 issues/2026-05-20_14-35-42-warch3-ops-alert-tuning-v1.csv CURRENT 巡检告警降噪与管理员收件人修正已公网验证:默认收件员工号为 HYD000006(wangshunli 的员工号),状态文件记录上次状态和 finding 摘要;远端 WARCH3 /app/artifacts/qa-flow/warch3-ops-20260520-070731/summary.json 为 PASS_WITH_FINDINGS,告警 /app/artifacts/qa-flow/wecom-ops-alert-20260520T070740Z/summary.json 为 PASS_ALERT_SKIPPED_NO_FINDINGS;已知 finding 不重复告警,仅阻断、脚本失败、新增 finding、状态恶化或人工 --force 发送脱敏消息
WROAD2-CLOSEOUT issues/2026-05-20_14-35-42-wroad2-controlled-ops-closeout-v1.csv CURRENT 三天受控巡检验收合同:Day 1/2/3 由 WARCH3 timer 采集后汇总,已知 live smoke 凭据、pending OCR 和历史 callback gap 作为 observation 不阻断;结束后需结合 WROAD2-BIZ1 和 WAPPR1 结论,再问答确认进入 WEXT1-LIVE、先处理 finding 或暂停,不直接启用真实员工
WROAD2-BIZ1 issues/2026-05-20_17-13-57-wroad2-business-smoke-v1.csv CURRENT 三天测试账号业务冒烟合同:不替代 WARCH3 自动巡检;SMOKE002 每天按企微规则尝试打卡并提交低风险请假/补卡,SMOKE101 先看详情再审批,HYD000006 查看 OA 企微审批归档和打卡摘要;无法打卡、无法审批或仍需手选审批人时记录 finding;不写企业微信、不启用真实员工
WAPPR1 issues/2026-05-20_17-13-57-wecom-approval-rule-governance-v1.csv CURRENT 企微审批规则规范化门禁合同:官方 API 不支持只读读取原生模板审批规则,WAPPR1 需后台人工确认 + 真机提交页确认 + API 实际审批链校验;2026-05-21 用户已设置测试员工直属上级为测试主管,并真机确认请假、补卡、外出、加班均自动带出测试主管且申请人不能编辑审批人,四类模板均为 A / PASS_APPROVER_RULES_READY;规则若回退为 B/C/D 仍不得进入真实试用
WRULE1 issues/2026-05-20_23-56-15-wecom-hr-approval-rule-validator-v1.csv CURRENT 企微 HR/考勤审批链校验器 POC:采用“单一组织规则,两个执行域”,OA 维护员工直属主管、业务审批角色和管理员兜底事实,企微执行 HR/考勤审批,OA 只读已归档企微审批详情并对比理论审批人和实际审批链;新增 check:wecom-approval-rule-validator,不读取企微后台规则、不写 OA/企微、不替代 WAPPR1 人工门禁;自审、实际审批人不符、申请人可手选审批人或缺人工门禁均阻断后续 live/真实试用
WAUTO1 issues/2026-05-20_18-04-16-wecom-controlled-trial-auto-evidence-v1.csv CURRENT 受控试用证据自动汇总合同已实现:新增 scripts/qa/collect-wecom-controlled-trial-evidence.sh,只读汇总 WROAD2/WARCH3/WCHECK1/WROAD2-BIZ1/WAPPR1/WEXT1 dry-run 证据,复跑 /ready、WARCH3 summary-only、审批补偿只读、审批归档离线、打卡摘要 offline、外出/加班 dry-run 和隐私扫描;默认不写 OA DB、不写企业微信、不创建模板或审批单
WEXT1LD issues/2026-05-20_18-04-16-wecom-outing-overtime-live-dryrun-gate-v1.csv CURRENT 外出/加班 live 前 dry-run gate 已实现:远端只执行 npm run check:wecom-approval-fixtures -- --format=json --target=outing --target=overtime,固定 SMOKE002 -> SMOKE101 与 WECOM_AGENT_SECRET;不设置写入环境变量、不带 live 写入参数,dry-run 通过后仍需人工问答批准或暂停
WFULLSMOKE1 issues/2026-05-20_19-01-12-three-day-full-goal-smoke-v1.csv CURRENT 三天全域最终目标测试总控合同已建立:新增 scripts/qa/run-three-day-full-goal-smoke.sh 聚合企微 HR/考勤、OA 报销、采购、合同/项目、付款批次、移动/企微入口和运维巡检;允许带 TEST/SMOKE/WFULL 标记的 OA 测试业务数据,不写企业微信、不创建外出/加班样件、不启用真实员工、不真实付款、不接真实支付、不写 ERP、不导入银行流水
WROUTE2 issues/2026-05-20_20-15-29-wecom-test-account-closeout-to-minimal-mirror-route-v1.csv CURRENT 测试号收口到最小完整镜像路线锁定合同已建立:当前先收口 WROAD2/WROAD2-BIZ1/WAPPR1/WRULE1/WAUTO1/WEXT1LD/WFULLSMOKE1/WTCLOSE2,不提前启用真实员工;WAPPR1 四类模板必须达到 A 才能进入 WEXT1-LIVE 或 WREAL1;WREAL1 首批固定为 1 名真实员工 + 1 名审批人/管理员观察;WREAL1 通过后优先规划 wecom_attendance_approval_mirror_v1 最小完整镜像,应急接管、恢复回写和 RuleOps 后置
WTCLOSE1 issues/2026-05-20_21-10-00-wecom-test-account-closeout-auto-dryrun-v1.csv CURRENT 小团队自动审批规则与测试号全域收口 dry-run 合同:公司不到 10 人,WAPPR1 四类模板目标均为 A;正式 HR/考勤审批采用一层直属主管或指定审批角色自动带出审批人,主管链缺失、审批人不可见/停用/未绑定或自审时管理员兜底或阻断;本轮自动执行 WAUTO1/WFULLSMOKE1 汇总和外出/加班 live 前 dry-run,不写企业微信、不启用真实员工
WTCLOSE2 issues/2026-05-22_10-21-12-wecom-test-account-final-closeout-v1.csv CURRENT 测试号最终收口与证据复核合同:WAPPR1 四类模板均为 A 后,自动复跑 /ready、WAUTO1、WFULLSMOKE1、外出/加班 dry-run 和 WRULE1;不写企业微信、不创建模板或审批单、不启用真实员工,只进入 WEXT1-LIVE 问答
WTCLOSE2F issues/2026-05-22_11-10-06-wecom-test-account-closeout-remote-only-v1.csv CURRENT WTCLOSE2 远端可信 IP 执行口径修正:企微 API 只能由部署服务器访问,WTCLOSE2 真实运行必须使用 --remote 在 server 容器内执行;本地直接执行默认阻断,只保留静态门禁用途
WREAL1-PREP issues/2026-05-20_14-35-42-wecom-real-trial-prep-v1.csv CURRENT 真实小范围试用准备合同:只固化候选员工、非自审审批人、回滚联系人、允许流程、暂停条件和验收标准;当前不启用真实员工,真实试用必须等请假/补卡/外出/加班四类测试号证据、WAPPR1 审批规则门禁和 WFULLSMOKE1 全域主路径可解释通过后再问

旧 Issue CSV 保留为历史审计证据:不删除、不批量回写、不移动到 docs/archive/ 或其他归档目录。新连续合同如替代旧合同,只在新合同 Notes 或文档索引中说明 supersedes。

文档台账

Doc_ID Path Category Authority Status Owner Related_Issues Evidence Supersedes Last_Audited Audit_Method Risk Notes
IDX docs/文档索引.md 入口索引 最高文档入口 CURRENT product/dev GOV8,QAOPS9,P2D,P2-ORG,P2-FIN-DECISION,P2-FIN-V1,P2-OCR-SAMPLE,P2Q,P2AUTO,P2AF,P2-FIN-LIVE-DECISION,P2-FIN-LIVE,PRELAUNCH,CASHIER-VOUCHER-V1,LAUNCH-DEPLOY-FINANCE,FIN-PROD-ENABLE,ACCOUNTING-HANDOFF-V1,SYSTEM-COMPLETE-GATE,LAUNCH-OPS-V1,REQ-COMPLETE-AUDIT,ATTV1,LAUNCH-AUTO-OPS-V1,AUTO-REMAINING-CLOSEOUT,HR-WECOM-DIRECTORY-V1,WFOC,DBWFOC,WFDG,WDRG,WCP1,WCPC,WHMS,WHMSLIVE,WOUA,WAPI,WRRA,WOUAFIX,WRV1,WRA1,WMSG1,WAPC1,WAPC2,WPROC1,WPROC2,WAPC2F,WAPC2FLIVE,WCBK1,WEGOV1,WARCH1,WARCH2,WROAD2,WARCH3,WCHECK1,WEXT1,WOPS1,WROAD2C,WROAD2B,WAPPR1,WRULE1,WAUTO1,WEXT1LD,WFULLSMOKE1,WTCLOSE2,WREAL1P rg none 2026-05-22 node scripts/qa/audit-docs.mjs --check-registry medium 判断当前该读什么;WAUTO1/WEXT1LD/WFULLSMOKE1/WTCLOSE2 后优先读取企微主办 + OA 自建留存路线、三天业务冒烟、审批规则规范化、审批链校验器、自动证据汇总、全域最终目标测试、测试号最终收口、受控上线巡检、告警降噪、打卡摘要、外出/加班 dry-run、WEXT1-LIVE 前置和真实试用准备
REG docs/文档事实源状态矩阵.md 文档台账 文档分类和状态事实源 CURRENT product/dev GOV8,QAOPS9,P2D,P2-ORG,P2-FIN-DECISION,P2-FIN-V1,P2-OCR-SAMPLE,P2Q,P2AUTO,P2AF,P2-FIN-LIVE-DECISION,P2-FIN-LIVE,PRELAUNCH,CASHIER-VOUCHER-V1,LAUNCH-DEPLOY-FINANCE,FIN-PROD-ENABLE,ACCOUNTING-HANDOFF-V1,SYSTEM-COMPLETE-GATE,LAUNCH-OPS-V1,REQ-COMPLETE-AUDIT,ATTV1,LAUNCH-AUTO-OPS-V1,AUTO-REMAINING-CLOSEOUT,HR-WECOM-DIRECTORY-V1,WFOC,DBWFOC,WFDG,WDRG,WCP1,WCPC,WHMS,WHMSLIVE,WOUA,WAPI,WRRA,WOUAFIX,WRV1,WRA1,WMSG1,WAPC1,WAPC2,WPROC1,WPROC2,WAPC2F,WAPC2FLIVE,WCBK1,WEGOV1,WARCH1,WARCH2,WROAD2,WARCH3,WCHECK1,WEXT1,WOPS1,WROAD2C,WROAD2B,WAPPR1,WRULE1,WAUTO1,WEXT1LD,WFULLSMOKE1,WTCLOSE2,WREAL1P audit-docs none 2026-05-22 audit-docs --check-registry medium 判断文档权威性;登记当前受控上线、三天业务冒烟、审批规则规范化、审批链校验、自动证据汇总、全域最终目标测试、测试号最终收口、自动巡检、告警降噪、打卡摘要留存、外出/加班 dry-run、WEXT1-LIVE 前置和真实试用准备事实
PRD-MVP docs/海音达OA-MVP需求规格说明书.md 需求事实源 PRD 主事实源 CURRENT product REQ8,P2T,GOV8,HR-WECOM-DIRECTORY-V1,WFOC,DBWFOC,WFDG,WDRG,WCP1,WCPC,WHMS,WHMSLIVE,WOUA,WAPI,WRRA,WAPC1,WAPC2,WAPC2FLIVE,WCBK1,WEGOV1,WACP3,WACP3R,WARCH1,WARCH2,WROAD2,WARCH3,WCHECK1,WEXT1 Issue CSV docs/requirements-specification.md 2026-05-20 rg high WARCH3/WCHECK1/WEXT1/WOPS1 后定义 HR/考勤企微主办、OA 自建留存、受控测试域、只读历史查询、自动巡检、打卡摘要、外出/加班 dry-run、WEXT1-LIVE、WREAL1 前置和深度镜像边界;ERP 未来不接入 OA
PRODUCT-SCOPE docs/产品口径.md 需求事实源 产品边界事实源 CURRENT product REQ8,P2T,WFDG,WDRG,WCP1,WCPC,WHMS,WHMSLIVE,WOUA,WAPI,WRRA,WAPC1,WAPC2FLIVE,WCBK1,WEGOV1 rg none 2026-05-19 rg high 记录已拍板产品边界、企微/OA 设计门禁、开发路线图、WCBK1 真实回调事件证据、WEGOV1 混合主办边界和 OA 自建留存策略
DESIGN-UI docs/产品设计规则.md 设计事实源 PC/移动/企业微信设计事实源 CURRENT design/frontend MIA7,MIF7,GOV8,DG8,DG9,WFDG Playwright/视觉审查/DG8/DG9/WFDG none 2026-05-18 rg high 页面改动必须读取;DG8 后飞书为主 UI/布局参考;DG9 后按页面分层和样板选型;WFDG 后区分 OA 主办、企微镜像和 OA 应急接管
ROADMAP-WECOM docs/企微优先开发路线图.md 开发治理 企微优先开发路线图事实源 CURRENT product/dev WDRG,WCP1,WCPC,WHMS,WHMSLIVE,WOUA,WAPI,WRRA,WOUAFIX,WRV1,WRA1,WMSG1,WAPC1,WAPC2,WPROC1,WPROC2,WAPC2F,WAPC2FLIVE,WCBK1,WEGOV1,WACP3,WACP3R,WREAD1,WREAD1F,WADM1,WARCH1,WARCH2,WROAD2,WARCH3,WCHECK1,WEXT1,WOPS1,WROAD2C,WROAD2B,WAPPR1,WRULE1,WAUTO1,WEXT1LD,WFULLSMOKE1,WROUTE2,WTCLOSE1,WTCLOSE2,WREAL1P Issue CSV none 2026-05-22 rg high WAUTO1/WEXT1LD/WFULLSMOKE1/WTCLOSE1/WTCLOSE2 后固定最小审批历史留存、正式只读历史查询、受控上线自动巡检、三天业务冒烟、审批规则规范化、审批链校验、自动证据汇总、全域最终目标测试、小团队一层审批 + 管理员兜底、测试号最终收口、告警降噪、打卡摘要、外出/加班 dry-run、live 前 dry-run gate、WEXT1-LIVE 前置和真实试用准备;仍禁止直接进入深度镜像
WECOM-API-CATALOG docs/企微API能力目录.md 集成事实源 企微 API 能力目录和 Secret 矩阵事实源 CURRENT product/backend/qa WAPI,WRRA,WAPC1,WAPC2,WPROC1,WPROC2,WAPC2F,WAPC2FLIVE,WCBK1,WEGOV1,WACP3,WACP3R,WREAD1,WADM1,WARCH1,WARCH2,WROAD2,WARCH3,WCHECK1,WEXT1,WAPPR1,WTCLOSE1,WRULE1,WTCLOSE2 官方企业微信开发者中心链接/Issue CSV none 2026-05-22 rg high 企微开发先读;只保存摘要、链接和项目决策,不保存 Secret、token、完整 userid、手机号、邮箱或原始 payload;记录审批补偿、打卡摘要、巡检只写 OA 留存、不写企业微信、企微原生审批规则不可只读 API 化、需人工门禁,以及 WRULE1/WTCLOSE2 只读审批链校验和最终收口边界
DELIVERY docs/开发交付与变更管理规约.md 开发治理 开发交付事实源 CURRENT dev/qa GOV8,WDRG,WRRA,WAPC1,WPROC1,WPROC2,WCBK1,WEGOV1,WOPS1,WROAD2C,WROAD2B,WAPPR1,WAUTO1,WEXT1LD,WFULLSMOKE1 rg none 2026-05-20 rg high Issue、review、commit、交付规则;WFULLSMOKE1 后固定 WAUTO1、WEXT1LD、全域最终目标测试和 WEXT1-LIVE/WREAL1 前置门禁
QA-GATE docs/测试规约与回归门禁.md 测试验收 测试和回归门禁事实源 CURRENT qa QAF8,GOV8,WPROC1,WPROC2,WAPC2FLIVE,WCBK1,WEGOV1 回归脚本/Playwright none 2026-05-19 rg high 测试计划、DONE 门禁、企微三层门禁、自动化优先、非自审、无完整 sandbox 假设、WREAD1 真机可读性和 WARCH1 留存验收门禁
AGENT-PRACTICE docs/Agent开发交付实践.md Agent 治理 Agent 协作事实源 CURRENT dev GOV8,DG8 Skill 校验 none 2026-05-13 rg medium Agent 协作开发实践和设计主参考层级
AGENTS AGENTS.md 执行硬约束 项目硬规则 CURRENT lead GOV8 人工核对 none 2026-05-13 rg high 不可违反约束
SKILL-HYB .agents/skills/hyb-oa-delivery/SKILL.md Skill 项目交付 Skill CURRENT dev GOV8,DG8,WFDG,WDRG,WCP1,WCPC,WHMS,WHMSLIVE,WOUA,WAPI,WRRA,WRV1,WRA1,WMSG1,WAPC1,WAPC2,WPROC1,WPROC2,WAPC2F,WAPC2FLIVE,WCBK1,WEGOV1,WACP3,WACP3R,WREAD1,WREAD1F,WADM1,WARCH1,WARCH2,WROAD2,WARCH3,WCHECK1,WEXT1,WOPS1,WROAD2C,WROAD2B,WAPPR1,WRULE1,WAUTO1,WEXT1LD,WFULLSMOKE1,WROUTE2,WTCLOSE1,WTCLOSE2,WREAL1P quick_validate none 2026-05-22 quick_validate.py medium 每轮交付操作入口;企微/OA 后续先读 API 能力目录、Secret 矩阵、路线图、WEGOV1/WADM1/WARCH1/WARCH2/WROAD2/WARCH3/WCHECK1/WEXT1/WOPS1/WROAD2B/WAPPR1/WRULE1/WAUTO1/WEXT1LD/WFULLSMOKE1/WTCLOSE1/WTCLOSE2 自建留存、受控巡检、业务冒烟、审批规则、审批链校验、自动证据汇总、全域收口 dry-run、最终测试号收口和告警降噪边界;不得绕过 WROAD2C/WROAD2B/WAPPR1/WRULE1/WAUTO1/WEXT1LD/WFULLSMOKE1/WTCLOSE2/WEXT1-LIVE/WREAL1 或后续独立合同直接做完整考勤审批镜像
REQ-WF docs/需求-统一审批中心规约.md 需求事实源 审批模块规约 CURRENT product/backend AP6,WF8,WFOC,DBWFOC,WFDG,WOUA,WAPI,WRRA,WRV1,WRA1,WMSG1,WAPC1,WAPC2,WPROC1,WPROC2,WAPC2F,WAPC2FLIVE,WCBK1,WEGOV1,WACP3,WACP3R,WREAD1,WREAD1F,WADM1,WARCH1,WAPPR1,WAUTO1,WEXT1LD,WFULLSMOKE1,WTCLOSE1,WRULE1,WTCLOSE2 workflow 回归 none 2026-05-22 rg high OA 主办审批、企微主办 HR/考勤审批、OA 自建留存、真实回调事件证据、WACP3R 补偿拉取 findings、WREAD1 请假/补卡真机可读性结论、WARCH1 最小历史留存、WAPPR1 审批规则规范化和 API 不支持读取规则边界、WTCLOSE1 小团队一层审批 + 管理员兜底目标 A、WRULE1 理论审批人与实际审批链校验、WTCLOSE2 测试号最终收口、WAUTO1/WEXT1LD/WFULLSMOKE1 前置和 OA 应急接管边界
REQ-OCR docs/需求-报销发票OCR规约.md 需求事实源 OCR 模块规约 CURRENT product/backend RI6,OCR8,BIZ8 OCR 回归 none 2026-05-13 rg high OCR 和发票边界
RULE-REIMB docs/报销发票附件规则.md 需求事实源 报销发票附件规则 CURRENT product/finance RI6,BIZ8 报销回归 none 2026-05-13 rg high 报销、发票、附件细则
REQ-WECOM docs/需求-企业微信基础设施规约.md 需求事实源 企业微信边界规约 CURRENT product/backend R7E,ORG8,WF8,ATTV1,HR-WECOM-DIRECTORY-V1,WFOC,DBWFOC,WFDG,WCP1,WCPC,WHMS,WHMSLIVE,WOUA,WAPI,WRRA,WRV1,WRA1,WMSG1,WAPC1,WAPC2,WPROC1,WPROC2,WAPC2F,WAPC2FLIVE,WCBK1,WEGOV1,WACP3,WACP3R,WREAD1,WADM1,WARCH1,WARCH2,WROAD2,WARCH3,WCHECK1,WEXT1,WROAD2B,WAPPR1,WAUTO1,WEXT1LD,WFULLSMOKE1,WTCLOSE1,WTCLOSE2 live smoke/真机反馈/Issue CSV none 2026-05-22 rg high 企微优先承担 HR/考勤员工日常审批和人事/打卡能力;WARCH2 已提供请假/补卡正式只读历史查询,WARCH3 固定受控上线自动巡检,WCHECK1 固定打卡摘要留存,WEXT1 固定外出/加班 dry-run,WROAD2B 固定三天人工业务冒烟,WAPPR1/WTCLOSE1 固定审批规则规范化和小团队目标 A,WFULLSMOKE1 固定全域主路径测试边界,WTCLOSE2 固定最终测试号自动收口,WEXT1-LIVE 需收口后另建合同;采购、合同、项目、报销和财务继续 OA 主办
RUNBOOK-TRIAL docs/试运行与自动化验证手册.md 操作手册 试运行验证手册 CURRENT qa/ops R7E,QAOPS8 live readiness none 2026-05-13 rg medium 本地、公网、企业微信和真实 OCR 验证
MANUAL-ADMIN docs/管理员手册.md 操作手册 管理员手册 CURRENT ops/admin ORG8,R7E,WFOC,DBWFOC,WFDG,WCPC,WHMS,WHMSLIVE,WOUA,WAPI,WRRA,WRV1,WRA1,WMSG1,WAPC1,WAPC2,WPROC1,WPROC2,WAPC2F,WAPC2FLIVE,WCBK1,WEGOV1,WACP3,WACP3R,WREAD1,WADM1,WARCH1,WARCH2,WROAD2,WARCH3,WCHECK1,WEXT1,WOPS1,WROAD2C,WROAD2B,WAPPR1,WAUTO1,WEXT1LD,WFULLSMOKE1,WTCLOSE1,WTCLOSE2,WREAL1P 人工验收 none 2026-05-22 rg medium 管理员上线、企微优先边界、Secret 矩阵、WARCH3 自动巡检与脱敏告警、WOPS1 告警降噪、WCHECK1 打卡摘要留存、WROAD2B 三天业务冒烟、WAPPR1/WTCLOSE1 审批规则规范化和 API 不支持读取规则后的人工后台/真机门禁、小团队目标 A、WAUTO1 自动证据汇总、WFULLSMOKE1 全域最终目标测试、WTCLOSE2 测试号最终收口、WEXT1 外出/加班 dry-run、WEXT1-LIVE 前置、WREAL1 准备和深度镜像前置关注点
MANUAL-EMPLOYEE docs/员工快速上手.md 操作手册 员工手册 CURRENT product R7E,WFOC,DBWFOC,WFDG 人工验收 none 2026-05-18 rg low 员工侧使用说明,HR/考勤优先企业微信,采购/合同/财务仍在 OA;区分企微镜像和 OA 应急接管
R7-DRAFT docs/trialrun/R7扩大试运行草案.md 草案 R7 准备材料 DRAFT product/qa R7E R7EP 报告 none 2026-05-13 rg medium 不代表当前 R7E 执行状态
OPS-RUNBOOK docs/trialrun/OPS7运维交接Runbook.md 运维草案 OPS 准备材料 DRAFT ops OPS8,QAOPS8 只读检查 none 2026-05-13 rg medium 不代表恢复演练已执行
TRIAL-REPORT docs/trialrun/人工试运行报告.md 证据材料 试运行证据入口 EVIDENCE qa R7EP,OPS8,QAF8,WOUA,WAPI,WOUAFIX,WRV1,WRA1,WMSG1,WAPC1,WAPC2,WAPC2F,WAPC2FLIVE,WCBK1,WEGOV1,WROAD2,WARCH3,WCHECK1,WEXT1,WOPS1,WROAD2C,WROAD2B,WAPPR1,WAUTO1,WEXT1LD,WFULLSMOKE1,WTCLOSE1,WRULE1,WTCLOSE2,WREAL1P artifacts/qa-flow none 2026-05-22 rg medium 只证明发生过;记录 WAPC2FLIVE live 样件、WCBK1 真实回调事件、WEGOV1 路线治理、WROAD2 Day 0、WARCH3 自动巡检、WOPS1 告警降噪、WCHECK1 打卡摘要、WEXT1 dry-run、WROAD2B 三天业务冒烟、WAPPR1 审批规则门禁、WAUTO1/WEXT1LD、WFULLSMOKE1 全域最终目标测试、WTCLOSE1 小团队收口 dry-run、WRULE1 审批链校验、WTCLOSE2 测试号最终收口和 WREAL1 准备,不直接放行深度镜像
FBA-AUDIT docs/trialrun/R7E后功能边界审计.md 证据材料 R7E 后功能边界审计 EVIDENCE product/dev/qa FBA,R7E,QAOPS8,P2T Issue CSV none 2026-05-15 rg medium 只作为功能边界、P2 候选和 Issue 草案证据,不直接派工
HISTORY-MATRIX docs/历史功能状态矩阵.md 历史材料 历史功能索引 HISTORICAL product DCL7 git 历史 none 2026-05-13 rg low 只追溯历史
OLD-IMPL-PLAN docs/implementation_plan.md 已移除历史 早期实施计划 REMOVED product DCL7 git history none 2026-05-13 manual low 从 git 历史恢复

当前事实源

路径 分类 当前用途
docs/文档索引.md 当前事实源 唯一文档入口
docs/文档事实源状态矩阵.md 当前事实源 文档分类和恢复规则
docs/海音达OA-MVP需求规格说明书.md 当前事实源 PRD 主事实源
docs/产品设计规则.md 当前事实源 PC、移动、企业微信设计规则;DG8 主 UI/布局参考层级
docs/企微优先开发路线图.md 当前事实源 WROAD2 后企微优先 HR/考勤改造阶段顺序、四域边界、API/Secret 口径、运行优先、审批只读 POC、自动样件、回调、补偿拉取、WREAD1 可读性、WARCH1/WARCH2 自建留存查询、受控上线巡检和禁止跳阶段
docs/企微API能力目录.md 当前事实源 WROAD2 后企微官方 API、Secret 矩阵、权限/可信 IP/回调模板、读写边界、无完整 sandbox 假设、运行优先、审批只读 POC、回调/补偿证据入库、只读查询和每日巡检写 OA 留存边界
docs/产品口径.md 当前事实源 产品边界和业务规则
docs/需求-统一审批中心规约.md 当前事实源 审批、催办、超时、效率摘要、企微审批自建留存模型
docs/报销发票附件规则.md 当前事实源 报销、发票、附件细则
docs/需求-报销发票OCR规约.md 当前事实源 OCR 和报销模块规约
docs/需求-企业微信基础设施规约.md 当前事实源 企业微信入口、身份、消息、deeplink、企微主办域、OA 自建留存、WARCH2 只读查询、WROAD2 巡检、回调/补偿证据和应急兜底
docs/需求-请假考勤修正规约.md 当前事实源 请假、补卡、考勤修正、WAPC2/WAPC2FLIVE/WCBK1/WACP3R/WREAD1 真机可读性证据、WEGOV1 自建留存路线、WARCH1/WARCH2 留存查询、WROAD2/WARCH3/WCHECK1/WEXT1 后续门禁
docs/需求-采购费用审批规约.md 当前事实源 采购和费用审批
docs/需求-合同附件归档规约.md 当前事实源 合同台账和附件归档
docs/需求-项目轻管理规约.md 当前事实源 项目轻管理
docs/测试规约与回归门禁.md 当前事实源 测试和回归门禁
docs/开发交付与变更管理规约.md 当前事实源 Issue CSV、review、提交和交付
docs/Agent开发交付实践.md 当前事实源 Agent 协作开发实践
AGENTS.md 当前事实源 项目硬约束
.agents/skills/hyb-oa-delivery/SKILL.md 当前事实源 项目交付 Skill

当前操作手册

路径 当前用途
docs/管理员手册.md 管理员上线、权限、试运行配置
docs/员工快速上手.md 员工使用说明
docs/试运行与自动化验证手册.md 本地、公网、企业微信和真实 OCR 验证
docs/trialrun/发布试运行准备清单.md 发布和试运行门禁
docs/trialrun/公网LiveSmoke准备清单.md 公网 live smoke 和真实 OCR readiness
docs/trialrun/真机公网测试清单.md 真实手机和企业微信人工验收

草案和证据

路径 分类 当前口径
docs/trialrun/R7扩大试运行草案.md 草案 当前执行状态以 R7E CSV 为准
docs/trialrun/OPS7运维交接Runbook.md 草案 不代表已执行生产配置或恢复演练
docs/trialrun/R7用户手册与FAQ.md 草案 不承诺未实现能力
docs/历史功能状态矩阵.md 历史证据 轻量索引,旧大表从 git 历史恢复
docs/trialrun/人工试运行报告.md 历史证据 R6 后状态摘要和关键证据索引
docs/trialrun/R7E后功能边界审计.md 当前证据 R7E 后全端功能边界、P2 候选和 Issue 草案
docs/trialrun/试运行覆盖矩阵.csv 历史证据 轻量覆盖摘要
docs/trialrun/项目级流程覆盖矩阵.csv QA 参考 check-flow-coverage 使用
docs/trialrun/权限直连审计记录.md 当前证据 权限直连审计
docs/trialrun/移动信息架构视觉流程审查.md 当前证据 MIA7 审查结论;MIF7/MIF7T 收口以最新 Issue CSV 和人工试运行报告为准

技术参考

路径 说明
docs/架构概览.md 架构和运行时边界
docs/集成边界.md 集成边界,不扩大 MVP 范围
docs/领域事件清单.md 领域事件
docs/mcp-tools.md 脚本和 AGENTS 强引用,保留英文文件名
docs/ops/*.md 非功能、SLO、测试、CI、DORA、追踪
docs/adr/*.md ADR 历史决策

已从当前树移除

这些文件已物理删除,不再维护当前副本;需要时通过 git 历史恢复。

旧路径 原用途
docs/implementation_plan.md 早期实施计划
docs/tech_stack_report.md 早期技术栈报告
docs/invoice-pool-refactor-plan.md invoicePool 一次性方案
docs/migration-mapping.md 旧迁移映射
docs/MVP主线代码差距盘点.md 旧 MVP 代码差距盘点
docs/todo-reconciliation.md 旧 TODO 清账
docs/mobile/pwa-regression-checklist.md 旧 PWA 回归清单
docs/trialrun/domestic-oa-best-practices.md 旧国内 OA 调研快照
docs/trialrun/async-ux-audit.csv 旧异步体验审计
docs/trialrun/deployment-preflight-2026-05-10.md 旧部署预检记录
docs/requirements-specification.md 旧 PRD 跳转入口

当前门禁

  • ME6-3 代表性企业微信真机门禁已关闭。
  • MIF7-1..7 与 MIF7T 已完成本地整改、公网部署、公网匿名复检和带凭据 live smoke/OCR 复检。
  • R7E 真实扩大试运行阶段验收、P2 排序、R7E 收口、QAOPS8 上线硬化阶段收口、QAOPS9 上线硬化连续合同、PRELAUNCH 正式启用前公网预回归、CASHIER-VOUCHER-V1 财务闭环与银行回单附件、LAUNCH-DEPLOY-FINANCE 部署复检、FIN-PROD-ENABLE 正式常开、ACCOUNTING-HANDOFF-V1 代账交接 SOP、SYSTEM-COMPLETE-GATE 系统完成门禁、LAUNCH-OPS-V1 首周运营保障、REQ-COMPLETE-AUDIT 需求完成度复核、ATTV1 考勤统一入口、AUTO-REMAINING-CLOSEOUT 剩余自动化收口、HRWD-CONTACT-LIVE-TEST 公网企微通讯录真实写入闭环、WFOC 需求重构、DBWFOC 数据边界修正、WFDG 设计门禁、WDRG 路线图门禁、WCPC 配置复跑、WHMSLIVE、WAPI、WRRA、WOUA-FIX、WRA1、WMSG1、WAPC1、WAPC2、WPROC1、WPROC2、WAPC2F dry-run、WAPC2FLIVE、WCBK1 代码部署、WEGOV1 路线治理、WACP3/WACP3R 补偿拉取 POC、WREAD1/WREAD1F 请假/补卡可读性门禁、WADM1 自建留存模型设计、WARCH1 最小历史留存实现、WARCH2 正式只读查询和 WROAD2 受控上线合同均已完成或建立,当前 P0/P1 阻断为 0;P2D 已完成决策分流,P2-ORG 只读巡检已完成且无需写修复合同。LAUNCH-AUTO-OPS-V1 发现的公网 payment_batch_v1=force_off 漂移已由 AUTOREM 恢复为 force_on,正式自动巡检结论为 GO_TO_OPERATE;erp_sync=force_off,ERP 未来不接入 OA,正式支付接口、图片 OCR 和银行流水导入继续不进入当前路线。WCP1 已完成企业微信能力 QA-only 只读 POC,历史结论为 PAUSE_FOR_CONFIG;WCPC 使用既有在职测试号 SMOKE002/测试员工(脱敏 oa_smoke***)完成远端只读复跑,报告 /tmp/wecom-capability-poc-wcpc-smoke002/summary.json,结论 GO_TO_HR_MASTER_SYNC,nextStageAllowed=true,blockingCapabilities=[]。WHMS 已实现并部署验证 wecom_hr_master_sync_v1、同步批次/逐员工记录、dry-run/apply、管理员 API、People 管理入口和 QA-only runner;默认和最终均为 force_off,公网 SMOKE002 因缺手机号、邮箱和部门按 missing_required_field 跳过,未执行生产真实员工批量 apply。WAPI 已将企微官方 API 能力目录、Secret 矩阵和运行优先路线落为当前事实源:通讯录读取使用 WECOM_CONTACT_SECRET 和 user/list_id,成员详情只作可选富化,人事助手/花名册、打卡、消息、OAuth 和审批读取默认使用 WECOM_AGENT_SECRET,WECOM_CHECKIN_SECRET 只作专用打卡 override,WECOM_HR_ASSISTANT_SECRET 不参与默认读取;后续企微能力不清楚时先查官方 API 和 企微 API 能力目录,不得靠运行时多个 Secret 试错。WOUA-FIX 已按用户确认执行受控写入并复检:7 个 OA active 缺企微测试账号软归档,T0000 seed 复活问题修正,SMOKE201 测试主管和待办副作用已转交,最终 WOUA 报告 /app/artifacts/qa-flow/wecom-oa-user-consistency-20260518T161716Z/summary.json 为 PASS_WITH_FINDINGS,但 OA active 5、企微 active 5、匹配 5、OA active 缺企微 0;剩余 5 个企微缺字段先接受不补,HRWDTEST-20260517214548 归档绑定保留审计。WRV1 原始报告 /app/artifacts/qa-flow/wecom-runtime-ready-20260518T173402Z/summary.json 曾因同步开关误阻断;WRA1 已修正并公网复跑,报告 /app/artifacts/qa-flow/wecom-runtime-ready-20260518T180506Z/summary.json 为 PASS_WITH_CONFIG_GAPS,入口/OAuth、Secret 矩阵、OA active 绑定、通讯录、人事助手、消息 dry-run 和打卡只读链路均通过,打卡记录 readable_sync_disabled。WMSG1 已证明企业微信应用消息和 Deeplink 可用;WAPC1 已固定首批审批模板(请假、补卡、外出、加班)、低风险 sp_no、真实回调配置项、验签/解密/幂等/重试和补偿拉取准入清单;WAPC2 已新增请假/补卡模板详情和审批详情只读 POC runner;WPROC1 已固定后续自动化优先、非自审和三层门禁,WPROC2 已将其升级为 check-process-contract process gate;WAPC2F 已新增审批样件 runner并公网 dry-run 通过;WAPC2FLIVE 已在用户批准后修正 create_template payload,创建 OA-POC 请假/补卡测试模板和低风险测试审批单,报告 /app/artifacts/qa-flow/wecom-approval-fixtures-20260519T053400Z/summary.json 为 PASS_FIXTURE_CREATED,自动复跑 WAPC2 为 PASS_APPROVAL_POC。WCBK1 已新增并部署只读 GET/POST /api/wecom/approval/callback、验签/AES 解密/归一化服务和 synthetic runner,远端报告 /app/artifacts/qa-flow/wecom-approval-callback-poc-20260519T083422Z/summary.json 为 PASS_CALLBACK_URL_VERIFIED;SMOKE101 同意现有 OA-POC 补卡测试单后复跑 /app/artifacts/qa-flow/wecom-approval-callback-poc-20260519T092648Z/summary.json 为 PASS_CALLBACK_EVENT_CONFIRMED。WEGOV1 固定混合架构:HR/考勤日常流程优先复用企业微信,OA 做自建数据留存、审计、入口、消息和应急兜底;采购、费用、合同、项目、报销、付款、AP、代账交接、审计和高敏附件继续 OA 主办。WACP3R 已按 SMOKE002 creator 自动发现请假/补卡 OA-POC 模板并公网复跑补偿拉取,报告 /app/artifacts/qa-flow/wecom-approval-compensation-poc-20260519T115944Z/summary.json 为 PASS_WITH_FINDINGS,请假/补卡各拉到 1 条详情,finding 为回调证据文件未持久化。WREAD1F 后用户确认请假/补卡消息卡片、列表和详情页可看清,远端报告 /app/artifacts/qa-flow/wecom-approval-readability-gate-20260519T133628Z/summary.json 为 PASS_READABLE,同意单击即通过作为后续提示和审计设计风险。WADM1 已固定回调事件、补偿拉取和审批历史入库模型;WARCH1/WARCH2 已实现请假/补卡最小历史留存和正式只读查询,WROAD2/WARCH3/WCHECK1/WEXT1/WOPS1 已完成受控巡检、自动巡检、打卡摘要、外出/加班 dry-run 和告警降噪;WROAD2-CLOSEOUT 三天验收、WROAD2-BIZ1 三天业务冒烟、WAPPR1 审批规则规范化和 WEXT1-LIVE 外出/加班测试号 live POC 仍在后续门禁内,完整考勤/审批镜像、OA 应急接管、恢复回写和 RuleOps 尚未实现;HR 写接口仍需后续独立合同处理;不得以 WARCH1/WARCH2/WROAD2 或未通过审批规则门禁的测试号证据直接进入 wecom_attendance_approval_mirror_v1、oa_hr_emergency_mode_v1、wecom_recovery_writeback_v1 或 wecom_ruleops_v1。HRWD 已完成 OA 驱动企业微信通讯录同步,并通过 HRWDTEST-20260517214548 真实公网 create/update/disable 验证;测试成员按审计要求保留离职/禁用状态。
  • WMSG1 已完成企微应用消息实发与 Deeplink 真机验证:远端报告 /app/artifacts/qa-flow/wecom-runtime-ready-20260518T234431Z/summary.json 显示 checks.message.status=OK、errcode=0、recipientCount=1,用户确认收到“OA 运行就绪检查”并可点击进入 OA 通知页面;本证据只证明消息和 Deeplink 可用,不放行审批模板、测试 sp_no、真实回调或深度镜像。
  • WAPC1 已完成企微审批配置准备清单:首批只准备请假、补卡、外出、加班模板;每个模板需准备模板 ID、适用范围、字段项、审批人规则、可见范围和自建应用权限;测试 sp_no 必须低风险且不得含采购、合同、报销、发票、银行回单或高敏附件;真实回调 Token/EncodingAESKey 不写入仓库或文档。本证据只代表配置准备口径已固化,不代表真实回调、审批镜像、应急接管、恢复回写或 RuleOps 已实现。
  • WAPC2 已完成企微审批模板与低风险 sp_no 只读 POC 本地实现、部署和公网只读复跑:范围只包括请假和补卡,固定 WECOM_AGENT_SECRET,远端报告为 PARTIAL_APPROVAL_POC_NEEDS_CONFIG;本证据只代表模板详情/审批详情只读 runner 已具备且远端 Secret 可用,不代表模板 ID、测试 sp_no、真实回调或深度镜像已配置完成。
  • WPROC1 已修正企微路线与开发流程工程化门禁:后续默认自动化优先,人工只处理批准、密钥/回调配置、企微后台不可 API 化配置、真机确认和风险拍板;WAPC2F 默认使用 SMOKE002 -> SMOKE101 非自审链,SMOKE101 不可用时停止问答确认;WEGOV1 后,wecom_attendance_approval_mirror_v1 前必须完成自动样件、回调、补偿拉取、可读性、模型设计、最小留存、受控巡检、三天业务冒烟、审批规则规范化、WEXT1-LIVE 和真实小范围试用等门禁。当前 WAPC2F、WAPC2 自动复跑和 WCBK1 已由 WAPC2FLIVE/WCBK1 完成。
  • WPROC2 已新增开发流程自动化门禁:node scripts/qa/check-process-contract.mjs --baseline 检查核心事实源和 WAPC2F 合同,wecom-approval-fixture profile 检查非自审、Secret 固定、live 双开关、缺配置分类和脱敏边界;该门禁已接入 scripts/check-minimal.sh。
  • WAPC2F 已实现企微审批 POC 样件自动生成 dry-run:npm run check:wecom-approval-fixtures 已部署公网并返回 PASS_FIXTURE_DRY_RUN_READY,报告 /app/artifacts/qa-flow/wecom-approval-fixtures-20260519T045001Z/summary.json。WAPC2FLIVE 已在用户批准后执行 live 创建,报告 /app/artifacts/qa-flow/wecom-approval-fixtures-20260519T053400Z/summary.json 为 PASS_FIXTURE_CREATED,自动复跑 WAPC2 为 PASS_APPROVAL_POC;后续不再重复创建样件。
  • WCBK1 已完成企微审批回调只读 POC 的真实事件确认:新增只读回调端点、wecomCallbackCrypto 验签/解密/归一化服务、check:wecom-approval-callback-poc runner 和 wecom-callback process gate;远端 URL 验证报告 /app/artifacts/qa-flow/wecom-approval-callback-poc-20260519T083422Z/summary.json 为 PASS_CALLBACK_URL_VERIFIED,SMOKE101 同意现有 OA-POC 补卡测试单后复跑 /app/artifacts/qa-flow/wecom-approval-callback-poc-20260519T092648Z/summary.json 为 PASS_CALLBACK_EVENT_CONFIRMED。WARCH1 已承接该缺口,新增 DB 回调事件持久化和补偿对账优先读 DB 证据。
  • WEGOV1 已完成企微主办治理与 OA 自建留存路线修正:企微主办域为打卡、请假、补卡、外出、加班、假期余额和人事助手;OA 主办域为报销、采购、合同、项目、付款、发票、银行回单、高敏附件和经营审计;OA 留存域保存企微关键历史、完整外部关联键和必要业务快照;OA 应急域只在企微不可用时人工开启。企业微信自建应用不按完整隔离 sandbox 处理,后续默认采用 SMOKE002 -> SMOKE101、OA-POC 模板、低风险审批单、synthetic 自动测试、公网 live runner 和少量真机确认。