hyb-oa/docs/文档索引.md

hyb-oa 文档索引

文档状态：当前唯一文档入口。 分类：入口索引。 适用时间：DCL7 之后。 关联 Issue：GOV8。 最近审计：2026-05-18。 不得误读：本文只指示当前事实源和读取顺序；历史 Issue CSV 只能用于追溯，不直接生成新开发任务。 治理口径：中文优先，物理精简，优先复用已有文档。已确认不用的历史文档不放 docs/archive/，直接从当前工作树移除；需要时从 git 历史恢复。

读取规则

• 判断当前需求、开发、验收：读最新 Issue CSV、当前 PRD、模块规约和本索引。
• 判断历史证据：读轻量历史索引，必要时用 git show <commit>:<old-path> 恢复旧文档。
• 判断冲突：最新 Issue CSV > 当前 PRD/模块规约 > 设计和产品规则 > 当前操作手册 > 技术参考 > 历史证据。
• 英文文件名只在技术生态或脚本强引用时保留，例如 docs/mcp-tools.md。
• 判断当前可执行任务：只读当前活跃治理流和对应连续型 Issue CSV；旧 Issue CSV 默认是历史审计证据。
• 新需求或试运行反馈：优先进入当前同类型连续治理流；只有跨业务域、跨风险等级或阶段收口后，才新建下一版 CSV。
• 新增说明、方案、审计或证据：优先补充现有事实源、模块规约、操作手册、证据文档或当前连续 Issue CSV；只有现有文档无法承载、需要独立审计证据或用户明确要求时，才新建文档并登记本索引和事实源矩阵。

最近事实源链

R6 -> PC6 -> PA6 -> FL6 -> AP6 -> RI6 -> LP6 -> ME6/QG6 -> DG7/MRF7 -> MIA7 -> MIF7/MIF7T(公网部署与带凭据公网复检已收口) -> DG8 -> DG9 -> R7E -> FBA -> 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 -> HRWD-CONTACT-LIVE-TEST -> WCFB -> WFOC -> DBWFOC -> WFDG -> WDRG -> WCP1 -> WCPC -> WHMS -> WHMSLIVE -> WOUA -> WAPI -> WRRA -> WOUA-FIX -> WRV1。

• R6、PC6、PA6、FL6、AP6、RI6、LP6 已完成并部署。
• ME6 自动化、公网视觉矩阵和 ME6-3 代表性企业微信真机门禁已完成。
• QG6 已完成 QA 治理升级。
• MIA7 已完成移动信息架构、视觉和流程审查；MIF7-1..7 与 MIF7T 已完成本地整改、公网部署、公网匿名复检和带凭据 live smoke/OCR 复检。
• DG8 已完成设计治理主参考系统收口：飞书工作台/飞书审批是唯一主 UI/布局参考；本结论只更新设计事实源，不代表已做页面整改。
• DG9 承接 DG8 后的页面整改：按 A/B/C 页面分层和 DG9 样板统一 PC、移动和企业微信入口布局；最新代码已作为 R7E 试运行基线部署到公网，不替代 WF8、UX8 或 BIZ8 业务验收。
• R7E 阶段验收、P2 排序和 QAOPS8 上线硬化阶段收口已完成，当前 P0/P1 阻断为 0；后续 P2 功能开发必须另建或延续对应连续合同。
• FBA 是 R7E 后全端功能边界审计，只提供证据和 Issue 草案，不启动 P2 功能开发。
• QAOPS9 是 R7E 后上线硬化连续合同，优先处理公网业务流测试数据、live smoke 账号链路、恢复演练 dry-run 和 SLO/Go-No-Go 自动化增强；隔离本地业务流可使用临时库和测试开关，公网证据必须保持 flag-off 或 SKIP 可解释；不部署、不执行生产恢复、不重置数据库、不打印远端 env。
• P2D 是 P2 功能决策合同，只决定组织主数据、付款批次、图片 OCR、UX8、审批通知和轻业务增强是否进入独立开发合同；统一使用 GO_TO_CONTRACT、HOLD_FOR_PREREQ、FREEZE 三类结论，不新增 API/schema、feature flag 或前端功能。
• P2-ORG 是 P2D 后第一个执行合同，已完成组织账号主数据只读巡检；当前连接数据源下高/中风险为 0，低风险观察项为 CEO/root 无直属主管 1 和 active 员工无企业微信绑定 8；本轮不需要写修复合同。
• P2-FIN-DECISION 已完成付款批次启用决策准备，结论为 GO_TO_IMPLEMENT：可进入单独 P2-FIN-V1 实现合同；当前仍不启用 payment_batch_v1、不写付款批次业务数据、不部署。
• P2-FIN-V1 已完成付款批次启用前本地/隔离硬化：后端 focused 回归、前端 typecheck/build、隔离付款批次闭环、权限直连审计和公网 readiness 均通过；本轮只硬化 E2E 断言，不新增 API/schema/feature flag/UI，不部署，公网 payment_batch_v1 继续关闭。
• P2-OCR-SAMPLE 已完成图片 OCR 样票治理和实现前置确认；P2AF 纠偏后当前口径为图片发票 OCR FREEZE_BY_DEFAULT，正式能力只维护 PDF-only OCR，图片仍按普通附件处理。
• P2Q 是 P2OCRS 后续任务队列合同：只锁定 UX8、P2-FIN-LIVE、审批通知、轻业务增强和持续上线门禁等启动条件；图片 OCR 不进入默认主线，只有用户明确重启评估才另建 provider 回归或实现合同。
• P2AUTO 是 P2Q 后自动化优先回归合同：后端 focused、前端构建、高风险确认、隔离核心业务流、隔离付款批次闭环、公网 readiness/PDF live OCR、公网移动矩阵和企业微信 UA/渲染自动化均已完成；PDF 样票和 live smoke 凭据可用，图片 OCR 默认冻结。
• P2AF 是 P2AUTO 后可自动实施收口合同：纠正图片 OCR 默认冻结口径，补 QA-only provider 决策语义、安全回归聚合、付款批次公网关闭态只读门禁和 UX8 自动矩阵扫尾；不部署、不启用公网付款批次、不开放图片 OCR。
• P2-FIN-LIVE-DECISION 是 P2AF 后付款批次公网启用窗口决策合同：公网 readiness 和 flag-off 只读门禁通过，初始结论为 HOLD_FOR_WINDOW；随后用户批准立即短窗口、现有 live smoke 测试账号和新建测试报销，已进入并完成 P2-FIN-LIVE。
• P2-FIN-LIVE 已按用户批准完成公网付款批次短窗口受控测试：使用 live smoke 测试账号新建专用测试报销，临时打开 payment_batch_v1，完成创建/复核/执行、AP 导出和审计核验后强制回到 flag_force_off；不部署、不接真实支付、不写 ERP 实时凭证，不开放图片 OCR。
• PRELAUNCH 是未正式使用前的正式启用准备合同：公网作为准生产预启用环境承载带 PRELAUNCH marker 的测试数据和自动化回归；公网 readiness、远端只读基线、隔离核心业务流、付款批次 PRELAUNCH 窗口、移动/企业微信自动化和 Go/No-Go 摘要已完成。最终 payment_batch_v1=flag_force_off，未部署、不接真实支付、不写 ERP 实时凭证、不开放图片 OCR；采购公网手工 live spec 长等待/退出码问题作为 QA 自动化稳定性维护项。
• CASHIER-VOUCHER-V1 是正式启用前财务闭环与代账交接第一轮实现合同：基于“无 ERP/独立财务系统、只有代账”的业务事实，将付款闭环固定为 OA 内审批/台账/付款批次 + 银行对公付款回单附件 + 月度代账交接；已新增批次级银行回单附件模型/API/PC 操作区、复核后补凭证和银行渠道执行前回单阻断，代码已由 LAUNCH-DEPLOY-FINANCE 部署到公网，不接真实支付、不写 ERP、不开放图片 OCR、不导入银行流水。
• LAUNCH-DEPLOY-FINANCE 是 CASHIER-VOUCHER-V1 后的部署与公网复检合同：先完成本地基础门禁、业务流、PC/移动/企业微信页面矩阵，再以 SYNC_ENV=0 部署到 https://oa.hyinda.com；新增银行回单附件 migration 已应用，公网 readiness、PDF live OCR、移动/企业微信矩阵和 CASHV 短窗口均通过，最终 payment_batch_v1=flag_force_off，正式常开仍需 FIN-PROD-ENABLE。
• FIN-PROD-ENABLE 是公网付款批次正式常开合同：未重新部署业务代码；新增 QA-only 正式启用 runner 后完成公网正式验收，测试报销 BX-20260517-0026 完成审批、付款批次创建/复核、无回单执行阻断、回单上传/下载、付款执行、AP 导出和审计核验；公网移动矩阵 6 passed、企业微信渲染矩阵 8 passed；最终 payment_batch_v1=force_on，erp_sync=force_off。
• ACCOUNTING-HANDOFF-V1 是月度代账交接 SOP 合同：公司无 ERP/独立财务系统，OA 侧交接资料固定为 AP 台账、报销导出、票据中心导出、付款批次/回单附件清单和审计日志；银行侧流水和回单原件由出纳从银行渠道导出交给代账人工核对，不导入 OA，不开发一键 zip 包。
• SYSTEM-COMPLETE-GATE 是系统开发完成收口合同：公网 readiness、live smoke、PDF live OCR、正式 flag 状态、FINPROD/ACCTH 证据、移动/企业微信矩阵和文档事实源均通过；结论 GO_TO_USE，系统按首批正式能力可交付使用。
• LAUNCH-OPS-V1 是正式使用首周运营保障合同：固定 wangshunli 为上线拍板、管理员复核和回滚决策人，wangzhiling 为出纳/付款执行和代账资料准备人；首周问题登记、每日巡检、暂停条件、代账交接节奏和可选功能冻结口径已回写现有手册。
• REQ-COMPLETE-AUDIT 是系统完成门禁后的需求完成度复核合同：确认首批正式能力仍为报销、PDF OCR、审批、请假、采购、通知、移动/企业微信入口、财务台账、付款批次、银行回单附件和代账交接；考勤边界纠偏为“企业微信打卡做原始采集和风控，OA 不重造定位/人脸/Wi-Fi/排班/防作弊”。
• ATTV1 是 REQ-COMPLETE-AUDIT 后的考勤统一入口实现合同：已部署到公网，关闭历史 OA 自建打卡 attendance_v1；新增 attendance_unified_v1、企微打卡摘要同步批次、补卡/外出/加班 OA 审批和月度考勤解释；公网复检 /ready、live smoke、PDF live OCR、移动/企业微信矩阵和考勤关键接口均通过，企微 live 同步缺 Secret 或 API 权限时记 SKIP，不使用企微原生审批，不保存完整位置、人脸、设备明文或原始 payload。
• LAUNCH-AUTO-OPS-V1 是 ATTV1 后的正式启用自动化收口合同：新增当前正式状态 QA-only runner、live feature flag 只读检查和统一考勤 live 检查；本地门禁、公网 readiness、PDF live OCR、统一考勤检查、移动矩阵和企业微信 UA/渲染矩阵均通过。显式企微打卡同步检查返回 SKIP wecom_checkin_sync_disabled。实际公网 payment_batch_v1=force_off，与 FIN-PROD-ENABLE 记录的正式常开口径不一致，因此结论为 PAUSE_FOR_FIX；runner 已跳过付款批次写入，未切换 flag、未部署、未接真实支付或 ERP。
• AUTO-REMAINING-CLOSEOUT 是 LAUNCH-AUTO-OPS-V1 后的剩余自动化收口合同：已受控恢复公网 payment_batch_v1=force_on 并保持 erp_sync=force_off，复跑正式启用后自动巡检通过；LAUNCHAUTO marker 测试报销 BX-20260517-0027 完成付款批次、回单、AP 导出和审计闭环；公网移动矩阵 6 passed，企业微信渲染矩阵 8 passed。企微打卡 live 同步仍因外部配置记录 SKIP wecom_checkin_sync_disabled，不影响 OA 统一考勤入口完成态。
• HR-WECOM-DIRECTORY-V1 是 HRWD 当前合同：ERP 从冻结待办改为未来不接入 OA；人事生命周期和考勤同属 HR 大域但分模块实现；OA 为员工、权限、审批和审计主事实源，企业微信作为通讯录、入口、通知和打卡采集基础设施。新增 hr_wecom_directory_sync_v1、企业微信通讯录同步记录、入职创建/调岗更新/离职禁用和管理员重试；缺通讯录 Secret 或 API 权限时 OA 人事闭环照常完成，同步记录为可解释 SKIP/失败。
• HRWD-CONTACT-LIVE-TEST 已完成公网企微通讯录真实写入闭环：使用 HRWDTEST-20260517214548 测试员工验证 OA 创建员工后由 onboarding 触发企微成员创建、资料更新触发企微 update、离职 checklist 完成后禁用 OA 账号并触发企微 disable；同步均返回 wecom_contact_synced、errcode=0，普通员工同步记录权限负例和审计动作核验通过。测试成员按约定保留离职/禁用状态，不删除。
• WCFB 是企微打卡同步 Secret 兼容修正合同：用户确认工作台应用已作为企微入口应用配置且已授权调用打卡 API；OA 后端调整为 WECOM_CHECKIN_SECRET 显式优先，未配置时复用已授权工作台应用的 WECOM_AGENT_SECRET，避免重复维护同一个 Secret。本地语法和考勤 focused 单测通过；已随 WRV1 部署到公网，但打卡 live 读取仍因 WECOM_CHECKIN_SYNC_ENABLED=true 未启用而阻断。
• WFOC 是企微优先 + OA 无痛接管需求重构合同：用户已确认优先复用企业微信成熟能力，OA 做镜像、人工接管、恢复回写、财务闭环和审计中台；其“HR/考勤/行政审批”和“完整镜像”宽口径已由 DBWFOC 修正为 HR/考勤员工日常审批和按域镜像。本轮只冻结需求和事实源，不改业务代码、不部署、不切换公网配置；后续实现需拆 wecom_hr_master_sync_v1、wecom_native_approval_mirror_v1、oa_hr_emergency_mode_v1、wecom_recovery_writeback_v1、wecom_ruleops_v1。
• DBWFOC 是 WFOC 后的数据边界修正合同：将“企微优先”收窄为 HR/考勤员工日常审批优先，采购、费用、合同、项目、报销、付款、AP、代账交接、审计和高敏附件继续 OA 主办；企业微信成熟功能可作为流程/字段/交互/规则参考，OA 主办审批只向企业微信发送脱敏提醒和 OA deeplink，不上传高敏附件到企微原生审批。
• WFDG 是 DBWFOC 后的设计规约门禁合同：固定后续开发前必须先判定主办方、主事实源、操作端、镜像方向、附件归属和审计责任；PC/移动页面需区分 OA 主办、企微镜像 和 OA 应急接管；下一轮进入 WECOM-CAPABILITY-POC-V1，输出 CAN_REUSE_NOW、NEEDS_CONFIG、NEEDS_API_POC、KEEP_OA_PRIMARY、NOT_SUPPORTED_BY_API 能力矩阵。本轮不改业务代码、不部署、不调用生产写接口。
• WDRG 是 WFDG 后的开发路线图门禁合同：新增 企微优先开发路线图，固定“路线图门禁 + 单功能 Issue CSV”的开发节奏和阶段顺序；其下一步 WECOM-CAPABILITY-POC-V1 已由 WCP1/WCPC 执行并收口，HR 主数据镜像已由 WHMS/WHMSLIVE 实现并部署验证，不得跳过阶段直接开发考勤/审批镜像、OA 应急接管、恢复回写或 RuleOps。
• WCP1 是 WDRG 后的企业微信能力 POC 合同：新增 QA-only 只读 runner scripts/qa/check-wecom-capability-poc.mjs，对人事助手、通讯录、打卡、审批、假期余额、回调和权限配置输出脱敏能力矩阵。远端 live 只读历史结论为 PAUSE_FOR_CONFIG，作为初始配置缺口证据保留；当前 HR 主数据镜像准入以 WCPC 复跑结论为准。
• WCPC 是 WCP1 后的配置收口合同：已使用既有在职低风险测试号 SMOKE002/测试员工（报告只记录 oa_smoke***）完成远端只读复跑，报告 /tmp/wecom-capability-poc-wcpc-smoke002/summary.json，结论 GO_TO_HR_MASTER_SYNC。WHMS 已承接该准入结论；审批模板 ID、审批单号 sp_no、真实回调配置和 HR 写接口仍需后续独立合同处理。
• WHMS/WHMSLIVE 是 WCPC 后的企微 HR 主数据镜像合同和部署验证合同：已实现并部署 wecom_hr_master_sync_v1、企微/人事助手读取服务、dry-run/apply、同步批次/逐员工记录、People 管理入口和 QA-only runner；公网对 SMOKE002（脱敏 oa_smoke***）完成 dry-run/apply 管道验证，缺手机号、邮箱和部门按 missing_required_field 跳过；权限负例 403；最终 force_off，未执行生产真实员工批量 apply。WAPI 后其读取口径被修正为通讯录 user/list_id + 人事助手 get_staff_info，不再用运行时 Secret fallback。
• WOUA 是 WHMSLIVE 后的 OA/企微用户一致性只读审计合同：已新增 QA-only runner server/src/scripts/audit-wecom-oa-user-consistency.js，本地静态/单测门禁通过并以 SYNC_ENV=0 部署执行；初始公网报告因旧读取路径为 SKIP / BLOCKED_BY_EXTERNAL_CONFIG。WAPI 后按新 API/Secret 口径复跑成功，远端脱敏报告 /app/artifacts/qa-flow/wecom-oa-user-consistency-20260518T142544Z/summary.json 为 PASS_WITH_FINDINGS，计数为 oaEmployees=13、oaActiveEmployees=12、oaActiveWithBinding=5、wecomProfiles=5、matchedActive=5、oaActiveMissingInWecom=7、inactiveWithBinding=1、missingRequiredFields=5。本轮未修改 OA/企微用户，未执行真实员工批量 apply，不代表 OA/企微用户已经一致。
• WAPI 是 WOUA 后的企微 API 能力目录与运行优先纠偏合同：新增 企微 API 能力目录，固定通讯录用 WECOM_CONTACT_SECRET、人事助手/打卡/消息/OAuth 用 WECOM_AGENT_SECRET、WECOM_CHECKIN_SECRET 仅作显式打卡 override、WECOM_HR_ASSISTANT_SECRET 仅历史兼容；后续企微能力不清楚时先查官方 API 和本地目录，不在运行时代码里轮询多个 Secret 试错。WAPI 已把通讯录成员详情降级为可选富化并完成 WOUA 公网复跑，后续由 WRRA/WOUA-FIX 承接路线与差异收口。
• WRRA 是 WAPI 后的企微路线门禁修正合同：只做 docs-only 路线修正，不改业务代码、不部署、不写 OA/企微数据；明确 PASS_WITH_FINDINGS 不能直接放行深度镜像，并已由 WOUA-FIX 承接测试账号差异收口；后续默认进入 WECOM-RUNTIME-READY-V1。
• WOUA-FIX 是 WRRA 后的 OA/企微用户一致性差异收口合同：按用户确认软归档 7 个缺企微测试/Smoke 账号，修正 T0000 seed 复活，转交 SMOKE201 归档后的测试主管和待办副作用；复检 OA active 5、企微 active 5、匹配 5、OA active 缺企微 0。企微缺字段先接受不补，归档绑定保留审计，不写企微资料、不执行真实员工 WHMS 批量 apply。
• WRV1 是 WOUA-FIX 后的企业微信运行优先门禁合同：新增 server/src/scripts/check-wecom-runtime-ready.js 和 npm run check:wecom-runtime-ready，检查工作台入口、OAuth/绑定、脱敏消息、OA deeplink、通讯录 user/list_id、人事助手 get_staff_info 和打卡短窗口读取；已部署并远端 live 只读验证，报告 /app/artifacts/qa-flow/wecom-runtime-ready-20260518T173402Z/summary.json 为 SKIP/BLOCKED_BY_EXTERNAL_CONFIG，阻断点是 WECOM_CHECKIN_SYNC_ENABLED=true 未启用；审批模板、测试 sp_no 和真实回调缺口记录为 NEEDS_CONFIG，不放行深度镜像。

当前活跃治理流

后续不再为每次聊天、小反馈或单点修正单独创建 Issue CSV。同类型、同目标、同风险域的任务优先进入同一个连续型 Issue CSV，直到该治理流完成明确阶段。

治理流	当前合同	当前状态	范围	不做
GOV8	issues/2026-05-13_16-31-09-gov8-system-governance.csv	已收口	文档分类、台账、流程模板、审计脚本、需求冻结、变更控制	不改业务代码、不部署
DG8	issues/2026-05-13_22-56-49-design-ui-governance.csv	已收口：设计事实源主参考系统更新	主 UI/布局参考层级、外部参考降级、Agent/Skill 设计入口、设计检查门禁	不改业务页面、不部署、不接入飞书
DG9	issues/2026-05-13_23-30-00-dg9-ui-layout-rollout.csv	已收口；最新代码已随 R7E 部署到试运行环境	A/B/C 页面分层、共享工作台骨架、移动槽位、审批/报销/首页/通知样板、设计门禁	不替代 WF8、UX8 或 BIZ8 业务验收
R7E	issues/2026-05-13_17-11-44-r7e-human-trialrun.csv	已收口：阶段验收通过，P2 排序与 R7E 收口完成	人工确认、真实试运行、每日问题收口、验收结论	不新增 P2 能力；付款批次延期到 P2
ORG8	issues/2026-05-13_18-23-51-org8-master-data-permission.csv	已收口：本地代表性角色验收通过	组织、账号、直属主管、停用、角色、企业微信绑定、权限边界	不做审批流程增强；不替代 R7E 真实人工试运行
WF8	issues/2026-05-13_18-23-52-wf8-approval-notification.csv	已收口：deeplink 修复已部署并经代表设备真机点击回 OA 验证	转审、通知、催办、邮件通道决策、三渠道验收	不做复杂 BPM 或审批设计器；通知模板和偏好设置延期到 P2
BIZ8	issues/2026-05-13_18-23-53-biz8-finance-ocr-project.csv	已收口：财务移动入口真机通过，财务/项目权限回归完成	OCR、票据、财务、费用提示、项目关联	不做 ERP 实时集成或重预算；付款批次延期到 P2
QAOPS8	issues/2026-05-13_17-30-00-qaops8-test-release-ops.csv	已收口：Go/No-Go 与上线硬化阶段分流完成	回归稳定、测试覆盖、上线门禁、备份恢复、SLO	不改业务需求；后续硬化另起 QAOPS9 或等价连续合同
FBA	issues/2026-05-15_23-45-41-r7e-post-function-boundary-audit.csv	已收口：R7E 后全端功能边界审计和后续 Issue 草案	PC、移动/企业微信、后端 API/作业、管理/运维边界审计	不改业务代码、不改 API/schema、不部署、不启动 P2
QAOPS9	issues/2026-05-16_00-19-20-qaops9-release-hardening.csv	已收口：上线硬化证据完成	公网业务流测试数据稳定化、live smoke 账号链路、恢复演练 dry-run、SLO/Go-No-Go 自动化增强；隔离业务流与公网 flag-off 证据分离	不改业务需求、不部署、不执行生产恢复、不重置数据库、不打印远端 env
P2D	issues/2026-05-16_00-19-21-p2-decision-followup.csv	已收口：P2 决策分流完成	P2-ORG 只读巡检进入独立合同；付款批次、图片 OCR、UX8、审批通知、轻业务增强均 HOLD_FOR_PREREQ；冻结 ERP/AI/完整差旅/复杂 BPM/审批设计器/重预算/企业微信原生审批	不新增 API/schema/feature flag/UI；不启用付款批次或图片 OCR
P2-ORG	issues/2026-05-16_02-04-27-p2-org-readonly-master-data-audit.csv	已收口：组织主数据只读巡检完成	主管链、停用审批人、角色持有人、admin-only、财务/admin 混授、企业微信绑定漂移的脱敏只读审计	不写生产账号数据、不执行 P2-ORG-FIX、不改 API/schema/UI、不部署
P2-FIN-DECISION	issues/2026-05-16_09-02-42-p2-fin-payment-batch-decision.csv	已收口：付款批次决策准备完成，结论 GO_TO_IMPLEMENT	付款批次代码/flag/空态、角色账号矩阵、导出字段、审计事件、公网验收窗口和 flag off 回滚口径	不启用 payment_batch_v1、不写付款批次、不接真实支付、不写 ERP 实时凭证、不部署
P2-FIN-V1	issues/2026-05-16_09-42-43-p2-fin-payment-batch-v1.csv	已收口：付款批次启用前本地/隔离硬化完成	后端付款批次/AP/导出 focused 回归、前端构建、隔离闭环、权限审计、公网 readiness、flag off 回滚口径	不公网启用 payment_batch_v1、不部署、不接真实支付、不写 ERP 实时凭证
P2-OCR-SAMPLE	issues/2026-05-16_10-15-21-p2-ocr-image-sample-governance.csv	已收口：图片 OCR 样票治理前置完成；P2AF 后当前默认 FREEZE_BY_DEFAULT	PDF-only 当前边界、SAMPLE-IMG-* 授权登记口径、脱敏证据规则、mock/PDF/真实图片 provider 分层、feature flag 和回滚设计	默认不支持图片发票 OCR；不新增入口或 feature flag、不调用真实图片 provider、不保存真实票据、不部署
P2Q	issues/2026-05-16_10-35-22-p2-post-p2ocrs-followup-queue.csv	已收口：P2OCRS 后续队列和启动门槛完成；图片 OCR 默认冻结	UX8、付款批次公网启用、审批通知、轻业务增强和持续上线门禁的后续合同顺序；图片 OCR 仅在用户明确重启评估时另建合同	不直接启动 HOLD 项、不新建综合规划文档、不改业务代码、不部署
P2AUTO	issues/2026-05-16_20-09-49-p2-automated-regression-sweep.csv	已收口：自动化优先回归和样票 provider 门禁完成；P2AF 后 provider 默认结论为 FREEZE_BY_DEFAULT	凭据/样票掩码核对、后端 focused、前端构建、高风险确认、隔离业务流、隔离付款批次、公网 readiness/PDF live OCR、移动/企业微信自动化、OCR provider-only 脚本	不部署、不开放图片 OCR、不打开公网 payment_batch_v1、不自动选择未登记图片样票
P2AF	issues/2026-05-16_22-11-10-p2-automatable-followup.csv	已收口：可自动实施收口完成	图片 OCR 默认冻结纠偏、QA 脚本语义、安全回归聚合、付款批次公网关闭态只读门禁、UX8 自动矩阵扫尾；报告 artifacts/qa-flow/p2-safe-regression-20260516-222222/	不部署、不开放图片 OCR、不启用公网 payment_batch_v1、不做业务实现
P2-FIN-LIVE-DECISION	issues/2026-05-16_22-49-05-p2-fin-payment-batch-live-decision.csv	已收口：公网启用窗口决策完成，初始结论 HOLD_FOR_WINDOW，后续用户批准并进入 P2-FIN-LIVE	公网 readiness、付款批次 flag-off 只读门禁、窗口/参与人/回滚联系人/测试数据前置、后续 P2-FIN-LIVE 启动条件	不在决策合同中打开公网 payment_batch_v1、不写付款批次、不部署、不接真实支付、不写 ERP 实时凭证
P2-FIN-LIVE	issues/2026-05-16_23-42-08-p2-fin-payment-batch-live-enable.csv	已收口：公网短窗口付款批次受控测试通过，最终 payment_batch_v1=flag_force_off	公网测试报销、PDF 样票绑定、审批到 approved、付款批次创建/复核/执行、AP 导出审计、权限边界、移动/企业微信自动化	不保持公网开启、不部署、不接真实支付、不写 ERP 实时凭证、不开放图片 OCR
PRELAUNCH	issues/2026-05-17_00-46-49-prelaunch-production-readiness.csv	已收口：正式启用前公网预回归完成，最终 payment_batch_v1=flag_force_off	公网环境基线、远端只读状态、PRELAUNCH 测试数据、核心业务自动化、付款批次公网窗口、移动/企业微信矩阵、启用范围和 Go/No-Go 摘要	不部署、不执行生产恢复、不重置数据库、不打印远端 env、不接真实支付、不写 ERP 实时凭证、不开放图片 OCR
CASHIER-VOUCHER-V1	issues/2026-05-17_09-04-37-cashier-payment-voucher-v1.csv	已收口：正式启用前财务闭环与银行回单附件完成，已由 LDF 部署	付款批次银行回单附件、复核后补凭证、银行渠道执行前回单阻断、管理员复核审计、出纳执行、代账交接前置	不接真实支付、不接 ERP、不开放图片 OCR、不导入银行流水
LAUNCH-DEPLOY-FINANCE	issues/2026-05-17_09-38-55-launch-deploy-finance.csv	已收口：CASHV 部署与公网复检完成，最终 payment_batch_v1=flag_force_off	本地全流程/页面门禁、受控部署、migration 应用、公网 readiness、PDF live OCR、移动/企微矩阵、CASHV 公网短窗口	不正式常开付款批次、不接真实支付、不接 ERP、不开放图片 OCR、不重置数据库
FIN-PROD-ENABLE	issues/2026-05-17_11-40-47-fin-prod-enable-payment-batch.csv	已收口：公网付款批次正式启用完成，最终 payment_batch_v1=force_on	公网正式启用 runner、测试报销 BX-20260517-0026、银行回单附件、AP 导出、审计、移动/企微矩阵、最终 flag-on 证据	不重新部署、不接真实支付、不接 ERP、不开放图片 OCR、不导入银行流水
ACCOUNTING-HANDOFF-V1	issues/2026-05-17_11-40-48-accounting-handoff-v1.csv	已收口：月度代账交接 SOP 固化	OA 侧 AP/报销/票据/付款批次/回单附件/审计资料清单，银行侧流水和回单原件由出纳线下导出，代账人工核对	不开发银行流水导入、不开发一键 zip 包、不保存真实银行资料到仓库
SYSTEM-COMPLETE-GATE	issues/2026-05-17_12-55-49-system-complete-gate.csv	已收口：系统开发完成门禁通过，结论 GO_TO_USE	公网 /ready、public bundle、live smoke、PDF live OCR、正式 flag 状态、FINPROD/ACCTH 证据、移动/企微矩阵和文档事实源	不新增业务功能、不部署、不接真实支付、不接 ERP、不开放图片 OCR、不导入银行流水
LAUNCH-OPS-V1	issues/2026-05-17_12-55-50-launch-ops-v1.csv	已收口：首周运营保障口径固定	首周支持人、问题登记、每日巡检、暂停条件、回滚联系人、代账月度交接节奏、UX8 真实反馈池和冻结项	不做真实恢复演练、不重置数据库、不主动开发可选功能
REQ-COMPLETE-AUDIT	issues/2026-05-17_13-32-26-requirements-completion-audit.csv	已收口：需求完成度复核和考勤边界校正完成	首批能力完成度、企微打卡边界、请假/补卡/外出/加班缺口、attendance_v1 处理建议	不改业务代码、不部署、不切换公网开关；后续考勤同步或修正审批必须另建合同
ATTV1	issues/2026-05-17_14-59-28-attendance-unified-wecom-sync-v1.csv	已收口：考勤统一入口与企微打卡同步 V1 已部署并复检通过	关闭历史 OA 自建打卡；新增企微打卡摘要同步、补卡/外出/加班 OA 修正审批、月度解释页和移动入口；公网移动/企微矩阵 14 passed	不用企业微信原生审批；不重造定位/人脸/Wi-Fi/设备风控；不保存完整位置、原始 payload 或人脸信息
LAUNCH-AUTO-OPS-V1	issues/2026-05-17_17-47-45-launch-auto-ops-v1.csv	阶段收口：自动化完成，结论 PAUSE_FOR_FIX	正式启用后自动 runner、live flag 只读校验、考勤统一入口 live 检查、移动/企微矩阵和证据回填；报告 artifacts/qa-flow/launch-auto-ops-20260517-175548/	不切换正式 flag、不部署、不接真实支付、不接 ERP；payment_batch_v1 当前 force_off 漂移需单独决策恢复
AUTO-REMAINING-CLOSEOUT	issues/2026-05-17_19-30-44-auto-remaining-closeout.csv	已收口：剩余自动化运营门禁通过，结论 GO_TO_OPERATE	恢复正式 payment_batch_v1=force_on、复跑 run-launch-auto-ops.sh、付款批次常开闭环、移动/企微矩阵、企微同步 SKIP 证据；报告 artifacts/qa-flow/launch-auto-ops-20260517-193317/	不部署、不改业务代码、不接真实支付、不接 ERP、不开放图片 OCR、不导入银行流水；企微打卡同步外部配置仍需后台配置
HR-WECOM-DIRECTORY-V1	issues/2026-05-17_20-00-40-hr-wecom-directory-v1.csv	已收口：人事生命周期与企业微信通讯录同步闭环已部署公网	ERP 永不接入 OA；入职/调岗/资料变更/离职驱动企微通讯录创建、更新、禁用；员工管理和详情展示同步状态与重试；部署后 live smoke、HRWD 端点 SKIP 检查、公网移动/企微矩阵通过；seed 已改为不覆盖正式 flag	该合同不涉及企业微信原生审批迁移、不接真实支付、不开放图片 OCR、不导入银行流水；企微通讯录真实写入依赖后台 Secret、默认部门和 API 权限
HRWD-CONTACT-LIVE-TEST	issues/2026-05-17_21-41-43-hrwd-contact-live-test.csv	已收口：公网企微通讯录真实写入闭环通过	HRWDTEST-20260517214548 测试员工完成 OA 创建、onboarding 企微 create、资料 update、offboarding 企微 disable、OA 禁用、登录负例、权限负例和审计核验；报告 artifacts/qa-flow/hrwd-contact-live-test-20260517T134548Z/summary.json	不删除企业微信测试成员、不重置数据库、不改业务 API/schema/UI、不部署；测试成员最终保留离职/禁用状态
WCFB	issues/2026-05-17_22-57-39-wecom-checkin-agent-secret-fallback.csv	已部署，打卡读取配置阻断	WECOM_CHECKIN_SECRET 显式优先；未配置时复用已授权工作台应用的 WECOM_AGENT_SECRET，避免重复维护同一个 Secret；本地语法、focused 单测和文档/skill 校验通过，已随 WRV1 部署	不新增业务 API/schema/UI；不改变企微权限边界；需启用 WECOM_CHECKIN_SYNC_ENABLED=true 后复跑打卡 live 读取
WFOC	issues/2026-05-18_10-25-18-wecom-first-oa-continuity-requirements.csv	已收口：企微优先 + OA 无痛接管需求重构	原宽口径已由 DBWFOC 修正：HR/考勤员工日常审批企微优先，OA 按域镜像、人工接管、恢复回写、RuleOps 和财务主办边界；PRD、模块规约、手册、索引和事实源矩阵已回写	不改业务代码、不新增 API/schema/UI、不部署、不改公网配置；不代表镜像、接管或回写运行时已完成
DBWFOC	issues/2026-05-18_11-35-39-data-boundary-wfoc-revision.csv	已收口：企微能力参考 + OA 主办数据边界修正	HR/考勤员工日常审批企微优先；采购、费用、合同、项目、报销、付款、AP、代账交接和高敏附件继续 OA 主办；企业微信只做成熟能力参考、脱敏消息和 OA deeplink	不改业务代码、不新增 API/schema/UI、不部署、不改公网配置；不把 OA 主办域全量镜像到企微
WFDG	issues/2026-05-18_12-21-01-wecom-first-design-gate.csv	已收口：企微优先设计规约门禁完成，结论 DONE_DESIGN_READY	固定主办方/数据边界矩阵、入口与交互规约、隐私附件消息规约、同步审计失败处理、应急接管、恢复回写、RuleOps 和下一轮 POC 验收口径	不改业务代码、不新增 API/schema/UI、不部署、不改公网配置、不调用生产写接口；不代表运行时迁移已完成
WDRG	issues/2026-05-18_12-44-10-wecom-development-roadmap-gate.csv	已收口：企微优先开发路线图门禁	固定路线图门禁、阶段顺序、单功能 Issue CSV 节奏、并行规则和下一轮 POC 合同口径	不改业务代码、不新增 API/schema/UI、不部署、不改公网配置、不调用公网写接口；不代表任何运行时迁移已完成
WCP1	issues/2026-05-18_13-30-07-wecom-capability-poc-v1.csv	已收口：企业微信能力 POC 已完成，历史结论 PAUSE_FOR_CONFIG	QA-only 只读探测人事助手、通讯录、打卡、审批、假期余额、回调和权限配置；输出能力矩阵和配置阻断清单	不改业务代码、不新增 API/schema/UI、不部署、不调用生产写接口；初始阻断已由 WCPC 复跑收口
WCPC	issues/2026-05-18_15-01-23-wecom-capability-poc-config-closeout-v1.csv	已收口：既有测试号 POC 复跑通过	使用 SMOKE002/测试员工（脱敏 oa_smoke***）完成远端只读复跑，结论 GO_TO_HR_MASTER_SYNC，已由 WHMS 承接	不开发业务功能、不部署、不持久改服务器 env；考勤/审批镜像仍需后续补审批模板、审批单和回调配置
WHMS	issues/2026-05-18_18-43-19-wecom-hr-master-sync-v1.csv	已实现：企微 HR 主数据镜像	新增 wecom_hr_master_sync_v1、Prisma 同步批次/逐员工记录、企微通讯录/人事助手读取、dry-run/apply、管理员 API、People 管理卡片和 QA-only runner	默认 force_off；不做考勤/审批镜像、审批回调、应急接管、恢复回写或 RuleOps
WHMSLIVE	issues/2026-05-18_19-28-25-whms-deploy-live-verify-v1.csv	已部署验证：企微 HR 主数据镜像公网受控验证	部署 WHMS、应用 migration、公网 dry-run/apply 管道验证、普通员工权限负例、最终 wecom_hr_master_sync_v1=force_off	SMOKE002 缺手机号、邮箱和部门按 missing_required_field 跳过，未写 OA 主数据；未执行生产真实员工批量 apply
WOUA	issues/2026-05-18_20-45-58-wecom-oa-user-consistency-audit.csv	已收口：OA/企微用户一致性只读对账已由 WAPI 新口径复跑	OA active 员工 vs 企业微信通讯录 + 人事助手只读审计、脱敏差异报告、本地单测、受控部署和公网执行	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	已收口：企微 API 能力目录与运行优先纠偏	本地 API 能力目录、Secret 矩阵、WHMS/WOUA 读取策略纠偏、文档/skill 回写和公网 WOUA 只读复跑	不执行真实员工批量 apply；不打开 wecom_hr_master_sync_v1；不修改 OA/企微用户数据；公网只读复跑 PASS_WITH_FINDINGS
WRRA	issues/2026-05-18_23-19-38-wecom-route-readiness-adjustment.csv	已收口：企微路线门禁修正与下一阶段规划	收紧运行优先退出门禁、修正 PRD/规约/手册旧顺序、补充 WOUA-FIX / WECOM-RUNTIME-READY-V1 下一阶段草案	docs-only；不改业务代码、不部署、不写 OA/企微数据；PASS_WITH_FINDINGS 不放行深度镜像
WOUA-FIX	issues/2026-05-18_23-45-45-wecom-oa-user-consistency-fix-runtime-ready.csv	已部署并受控写入：OA/企微用户一致性差异收口	7 个 OA active 缺企微测试账号已软归档，T0000 seed 不再复活，SMOKE201 测试主管/待办副作用已转交；WOUA 复检 active 5/5 匹配	不写企微资料；不补企微缺字段；不执行真实员工 WHMS 批量 apply；不放行深度考勤/审批镜像
WRV1	issues/2026-05-19_01-10-32-wecom-runtime-ready-v1.csv	已部署验证：企业微信运行优先门禁	新增 QA-only runner 和 focused 单测；公网 live 只读报告为 SKIP/BLOCKED_BY_EXTERNAL_CONFIG，入口/OAuth、Secret 矩阵、OA active 绑定、通讯录、人事助手和消息 dry-run 通过，打卡读取因 WECOM_CHECKIN_SYNC_ENABLED=true 未启用阻断	不新增公开 API、schema、前端页面；不补企微资料；不配置审批模板/sp_no/真实回调；不进入深度镜像

旧 Issue CSV 不删除、不批量回写、不移动到归档目录。若新治理流替代旧合同，只在新 CSV 的 Notes 或本索引说明 supersedes，旧文件保留历史审计语义。

按开发阶段阅读

阶段	必读入口	目的
需求阶段	最新同类型连续 Issue CSV、海音达OA-MVP需求规格说明书、对应 需求-*.md、产品口径	判断做什么、不做什么、验收什么
设计阶段	最新设计治理合同、产品设计规则、架构概览、集成边界、docs/ops/*.md、必要 ADR	判断页面、权限、状态流、集成和非功能边界
开发阶段	当前连续 Issue CSV、开发交付与变更管理规约、AGENTS.md	判断文件范围、依赖、方案批准和交接物
测试阶段	测试规约与回归门禁、试运行与自动化验证手册、当前 Issue 的 Test_Method	判断怎么测、何时可回填 DONE
发布阶段	发布试运行准备清单、公网 Live Smoke 准备清单、OPS7 运维交接 Runbook	判断公网、企业微信、真实 OCR 和回滚条件
审计阶段	文档事实源状态矩阵、人工试运行报告、当前连续 Issue CSV、git 历史	判断当前事实、历史证据和冲突处理
历史追溯	历史功能状态矩阵、旧 Issue CSV、git 历史	只追溯，不直接派工

当前事实源

文档	用途
海音达OA-MVP需求规格说明书	PRD 主事实源
文档事实源状态矩阵	文档分类、删除恢复和冲突规则
产品设计规则	PC、移动、企业微信 WebView 设计事实源；DG8 后飞书工作台/飞书审批为唯一主 UI/布局参考；DG9 后按页面分层和样板选型
企微优先开发路线图	WDRG/WCP1/WCPC/WHMS/WHMSLIVE/WOUA/WAPI/WRRA/WOUA-FIX/WRV1 后企微优先 HR/考勤改造的阶段顺序、准入/退出门禁、并行规则、禁止跳阶段、API/Secret 口径、运行优先和 WOUA 差异收口事实源
企微 API 能力目录	WAPI/WRRA 后企微官方 API、Secret 矩阵、权限/可信 IP/回调模板、读写边界和运行优先决策事实源
产品口径	已拍板产品边界和业务规则
需求 - 统一审批中心规约	OA 主办审批、企微主办 HR/考勤员工日常审批镜像、催办、超时提醒、审批效率
报销发票附件规则	报销、发票、OCR、附件细则
需求 - 报销发票 OCR 规约	报销发票 OCR 模块规约
需求 - 企业微信基础设施规约	企业微信入口、身份、消息、deeplink、HR/考勤员工日常审批、打卡、人事助手、按域镜像、OA 接管和恢复回写
需求 - 请假考勤修正规约	企微请假/补卡/外出/加班、考勤镜像、OA 应急接管和恢复回写
需求 - 采购费用审批规约	采购、费用、附件、审批规则
需求 - 合同附件归档规约	合同台账和附件归档边界
需求 - 项目轻管理规约	项目轻管理边界
测试规约与回归门禁	自动化、视觉、真机、状态回填
开发交付与变更管理规约	Issue CSV、review、提交和交付
Agent开发交付实践	Agent 协作和交付实践
AGENTS 项目规则	执行硬约束

当前操作手册

文档	用途
管理员手册	管理员上线、权限、试运行配置
员工快速上手	员工侧使用说明
试运行与自动化验证手册	本地、公网、企业微信和真实 OCR 验证
发布试运行准备清单	发布候选、权限审计、部署预检和试运行门禁
公网 Live Smoke 准备清单	公网、真实 OCR、企业微信入口复核条件
真机公网测试清单	真实手机、企业微信、移动浏览器人工验收

草案和准备材料

文档	边界
R7 扩大试运行草案	只做 R7 准备草案；真实执行看 R7E 连续合同
OPS7 运维交接 Runbook	不代表已执行生产配置变更、恢复演练或回滚
R7 用户手册与 FAQ	只描述已实现能力，不承诺预算、ERP、AI、完整差旅或复杂 BPM

历史证据入口

文档	用途
历史功能状态矩阵	轻量历史功能索引；旧大表从 git 历史恢复
人工试运行报告	R6 后当前状态和关键证据索引
R7E 后功能边界审计	R7E 后全端功能边界、P2 候选和后续 Issue 草案
试运行覆盖矩阵	轻量覆盖摘要
项目级流程覆盖矩阵	check-flow-coverage 使用的最小流程矩阵
权限直连审计记录	权限直连审计证据
移动信息架构视觉流程审查	MIA7 审查结论，整改收口以 MIF7/MIF7T 和最新 Issue CSV 为准

技术参考

文档	说明
架构概览	当前架构和运行时边界
集成边界	历史 ERP/IM/AI/MCP/PWA 集成边界；HRWD 后 ERP 未来不接入 OA，不扩大当前 MVP 范围
领域事件清单	领域事件名和对外事件边界
MCP Tools	脚本和 AGENTS 强引用，保留英文文件名
非功能基线	安全、性能、回滚、上线最低要求
SLO 错误预算	SLO 和错误预算
测试策略	自动化测试和门禁策略
CI 回归报告归档	CI 回归报告归档
DORA 指标	CFR 等 DORA 指标
链路追踪策略	OpenTelemetry 追踪策略
ADR: 移动端路线决策	PWA、RN、小程序路线历史决策
ADR: 企业卡/虚拟卡管控预研	企业卡能力预研

已从当前树移除

这些文档不再作为当前资料维护；需要时从 git 历史恢复，例如 git show 5da05eb:<旧路径>。

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

阅读顺序

1. 新需求：PRD + 对应模块规约 + 最新 Issue CSV。
2. 页面体验：产品设计规则；DG8 后先按主 UI/布局参考层级判断。
3. 报销/发票：报销发票附件规则 + 报销 OCR 规约。
4. 试运行/部署/真机：试运行手册 + 发布清单 + 真机清单。
5. 历史追溯：历史功能状态矩阵 + git 历史 + 相关 Issue CSV。