A1-A5 治理docs历史文档索引归档

2026-05-09 20:11:47 +08:00
@@ -6,18 +6,19 @@
 - 目标是把内部高频管理动作收口到 `hyb-oa`；企业微信只作为入口、身份、通知和打卡底座。
 ## 2. 管理员每周固定动作
- 周一：查看 `Portal` 的团队状态、上周周报汇总、入离职待办、资产待归还。
+- 周一：查看 `审批待办`、报销/OCR 异常、请假/补卡/外出/加班审批、项目风险和本周关键付款/归档事项。
- 周中：处理公告、请假审批、员工档案更新、离职阻塞项。
+- 周中：处理报销退回、重复发票例外、企业微信绑定异常、人员权限和审批规则缺口。
- 周五：催交周报、查看高优先级待办、确认下周请假和资产交接。
+- 周五：复核未完成审批、未付款报销、待归档合同/附件、采购/费用申请和下周请假安排。
 ## 3. 首次上线最小配置
 1. 进入 `工作区设置`，确认产品模式为 `small_team_internal`。
-2. 仅保留主导航：`Portal`、`审批待办`、`团队`、`请假`、`报销`、`资产`、`周报`、`待办`、`公告`、`项目`。
+2. 首批主路径优先保留：`Portal`、`审批待办`、`报销`、`票据/OCR`、`请假`、`项目`、`采购/费用`、`合同/附件`。
-3. 将 `考勤`、`采购`、`差旅`、`预算`、`支付批次`、`AP 运营`、`ERP`、`AI` 等模块按真实启用情况保留为主路径或管理员备用；审批动作统一留在 OA。
+3. `团队状态`、`周报`、`待办`、`公告`、`人员`、`资产` 可按真实试运行需要开启；`预算`、`支付批次`、`AP 运营`、`ERP`、`AI`、完整差旅能力默认作为管理员备用或历史能力，不作为当前 MVP 首批主线。
 4. 在 `用户管理` 中按推荐预设配置：老板 / 管理员 / 主管 / 员工。
 5. 检查功能开关：
-   - 建议开启：`portal_home_v1`、`announcements_v1`、`presence_board_v1`、`weekly_report_v1`、`employee_lifecycle_v1`、`todo_board_v1`、`global_search_v1`
+   - 建议开启：`portal_home_v1`、企业微信入口相关开关、报销/OCR、审批待办、请假和项目基础能力。
-   - 建议保留备用：`payment_batch_v1`、`cutover_console_v1`
+   - 按需开启：`announcements_v1`、`presence_board_v1`、`weekly_report_v1`、`employee_lifecycle_v1`、`todo_board_v1`、`global_search_v1`。
   - 建议保留备用：`payment_batch_v1`、`cutover_console_v1`、预算/AP/ERP/AI 相关开关。
 ## 4. 人员生命周期管理
 ### 4.1 入职
@@ -60,30 +61,32 @@
  - 审批待办
 ## 8. 备用模块治理
- 考勤、采购、差旅、预算、支付批次、AP 运营、ERP、AI 保留代码和历史数据，但不作为全员主路径。
+- 采购/费用、合同/附件和项目轻管理属于 P1 轻量能力，可在 P0 审批、报销/OCR、请假和企业微信入口稳定后逐步开放。
 - 预算、支付批次、AP 运营、ERP、AI、完整差旅、资产深度管理等保留代码和历史数据，但不作为当前 MVP 首批主路径。
 - 若短期完全不用，保持管理员可见即可，不必删除。
 - 只有出现真实场景时，再恢复到主导航或单独扩展。
 ## 9. 推荐上线顺序
-1. 先开 `Portal + 公告 + 团队状态`
+1. 先完成账号、角色、部门、企业微信自建应用入口和账号密码回退路径。
-2. 再推 `周报 + 待办`
+2. 再启用 `OA 统一审批中心 + 报销/发票/OCR/附件`，跑通提交、审批、退回、查重、付款和导出闭环。
-3. 同步启用 `入职/离职/资产交接`
+3. 同步启用 `请假/补卡/外出/加班`，明确企业微信打卡只是原始采集，正式考勤解释回到 OA 审批结果。
-4. 最后根据实际需要保留轻量报销与请假
+4. 在 P0 稳定后开放 P1：`采购/费用审批`、`合同/附件归档`、`项目轻管理`。
 5. 最后按真实需要评估周报、团队状态、公告、人员生命周期、资产、预算、支付、ERP、AI 和完整差旅。
 ## 10. 试点验收口径
- 全员都能登录并进入 `Portal`
+- 全员都能账号密码登录；已绑定员工能从企业微信 `海音达工作台` 进入移动工作台。
- 至少 1 次真实入职或模拟入职跑通
+- 至少 1 笔报销完成：上传发票或附件 -> OCR/查重 -> 提交 -> OA 审批 -> 财务复核/付款标记 -> 导出。
- 至少 1 次真实离职或模拟离职跑通
+- 至少 1 条请假或补卡完成：员工提交 -> OA 审批 -> 团队状态或考勤解释口径不破坏。
- 全员连续 4 周提交周报
+- 至少 1 个审批待办从企业微信提醒 deeplink 回到 OA 页面处理。
- 管理员不再额外维护“今日在岗表”或“离职交接表”
+- P1 试点时，至少 1 条采购/费用申请、1 条合同台账、1 个项目关联事项可创建、审批或归档。
 - 上线前完成 1 次 DB + 文件存储备份和恢复演练，并记录恢复后的 `/ready` 结果
- 普通员工主导航不出现考勤、采购、差旅、预算、AP、ERP、AI 等备用模块
+- 普通员工主导航不出现预算、AP、ERP、AI、完整差旅等当前首批不开放的备用模块。
 ## 11. 4 周观测操作法
-1. 每周一进入 `Portal` 查看“试点观测摘要”，记录近 7 天登录覆盖率、周报提交率、团队状态覆盖率。
+1. 每周一进入 `Portal` 和 `审批待办` 查看近 7 天登录覆盖率、审批积压、报销/OCR 异常、请假/补卡审批和企业微信入口错误。
-2. 每周五在 `deploy/trialrun/observation-template.md` 填写本周结论、关键阻塞、是否需要调整提醒或导航。
+2. 每周五记录本周结论、关键阻塞、是否需要调整审批规则、报销规则、企业微信入口或导航。
-3. 若某周有员工未登录、未提周报、未更新状态，优先通过公告或站内通知补提醒，不引入额外表格。
+3. 若某周出现员工未登录、报销长期停留、发票重复处理不清、审批积压或企业微信绑定异常，优先修正规则和入口，不额外维护表格作为正式记录。
-4. 连续 4 周都达到预期后，再将 R66 试点验收关单并形成最终验收结论。
+4. 连续 4 周都达到预期后，再扩大到 P1 采购/费用、合同归档和项目轻管理试点。
 ## 12. 企业微信入口与登录策略
 - 企业微信定位为 `入口 + 免登 + 通知 + 打卡原始采集`，不承载公司正式审批流。
@@ -1,7 +1,9 @@
 # 领域事件清单（P19 / P19+IM-1 / P19+ERP-3 / P19+AI-1 / P20+TRAVEL-1 / P20+TRAVEL-2 / P20+TRAVEL-3）
 **文档状态**：技术参考和历史证据，不是当前 MVP 需求事实源。
 **快照日期**：2026-03-10
 **目标**：冻结 `hyb-oa` 当前采购、资产与差旅域的标准领域事件名，并补充 `P19+IM-1` 已实际消费的 IM 通知类型清单，以及 `P19+ERP-1 / ERP-3 / AI-1 / TRAVEL-1` 已实际落地的消费映射，作为后续 ERP / IM / AI / TRAVEL 适配的事实源。
 **不得误读**：本文用于追溯 Outbox、IM、ERP、AI、TRAVEL 等历史集成边界；当前 10 人以下公司 MVP 范围以 [海音达OA-MVP需求规格说明书](./海音达OA-MVP需求规格说明书.md)、模块规约和最新 `issues/*.csv` 为准。
 ## 1. 使用原则
 - 本文档同时维护两类事实：
@@ -5,6 +5,7 @@
 **当前基线**：`P19+IM-1`、`P19+ERP-1`、`P19+ERP-2`、`P19+ERP-3`、`P19+MCP-1`、`P19+AI-1`、`P20+TRAVEL-1`、`P20+TRAVEL-2`、`P20+TRAVEL-3`、`P21+PWA-1` 与 `P21+PWA-2` 已完成；当前运行时已落地企微群机器人 + 深链 + Outbox 异步派发的一期协同适配，以及 ERP 主数据 Pull、报销付款凭证切片、采购双阶段 journal / 归档摘要出站、资产台账摘要出站、Postgres MCP 只读工具基线、报销 / 采购 / 资产详情页 AI 只读建议挂件、差旅申请主单 / 行程段 / 审批预算锁定 / `travel_orders` 关联入站、混合双轨对公支付闭环与批次级对账摘要桥的三期差旅基线，以及浏览器 PWA 下的移动资产扫码、盘点快捷录入与离线队列重放、移动审批 deep link 直达、本地会话快照离线守卫与审批草稿重放。
 **目标**：在保持核心域稳定的前提下，冻结 ERP / IM / AI / MCP / TRAVEL / PWA 的长期边界，并记录 IM 一期、ERP 三期、AI 一期、差旅三期与 PWA 两期的已实现范围、禁入规则以及 R10 主线闭环后的固定收口结论。
 **当前路线说明**：2026-05-09 之后首批 MVP 固定为 `hyb-oa` 唯一审批中心 + 企业微信基础设施。飞书路线已废弃；钉钉、小程序、外部 IM 回调审批和付费第三方套件不进入首批。
 **不得误读**：本文是技术参考和历史证据，不作为当前 MVP 扩大 ERP、AI、TRAVEL、PWA 或外部 IM 适配范围的依据；任何重新启用都必须先更新 PRD 或模块规约并新建 Issue CSV。
 ## 1. 总体原则
@@ -1,5 +1,7 @@
 # 试运行与自动化验证 Runbook
 **文档状态**：当前操作手册，用于本地、公网、企业微信和真实 OCR 试运行验证。
 本文用于 hyb-oa 本地、企业微信和公网试运行。默认策略是：能自动化的先自动化，自动化无法覆盖的才请求人工配合。
 ## 入口顺序
@@ -1,6 +1,8 @@
 # 国内 OA 与费控系统最佳实践对照
 **文档状态**：外部最佳实践调研快照和历史归档参考，不是当前需求事实源。
 快照日期：2026-05-08；公开来源二次复核：2026-05-09
 **不得误读**：本文只用于解释当时对国内 OA、费控和企业微信入口的调研判断；当前实现范围以 [海音达OA-MVP需求规格说明书](../海音达OA-MVP需求规格说明书.md)、模块规约和最新 `issues/*.csv` 为准。
 ## 调研来源
@@ -1,5 +1,7 @@
 # 公网 live smoke 与真实 OCR 准备清单
 **文档状态**：当前操作手册，用于部署后公网、企业微信入口和真实 OCR 条件复核。
 ## 必需环境变量
 - `LIVE_SMOKE_BASE_URL`：默认 `https://oa.hyinda.com`。
@@ -1,5 +1,7 @@
 # 真机公网测试清单
 **文档状态**：当前操作手册，用于真实手机、企业微信和移动浏览器人工验收。
 适用范围：使用真实手机访问 `https://oa.hyinda.com`，重点验证企业微信工作台、手机浏览器、拍照/PDF 上传、真实 OCR 状态反馈和移动核心流程。
 ## 测试前信息
@@ -5,6 +5,20 @@
 本索引用来区分“当前事实源”和“历史证据”。查需求、排期、开发范围时，先读当前事实源；排查历史实现、回归证据或旧决策时，再读历史快照和证据文档。
 ## 归档判定规则
 本仓库采用“索引归档”策略治理历史文档：历史证据和过期口径保留原路径，不移动到 `docs/archive`，不批量删除，也不回写旧 Issue CSV。归档通过本文档分区和文档顶部状态说明完成。
 | 分类 | 判定标准 | 使用规则 |
 | --- | --- | --- |
 | 当前事实源 | PRD、模块规约、产品口径、设计规则、AGENTS 项目规则 | 可以直接指导需求确认、Issue CSV 拆分、开发和验收 |
 | 当前操作手册 | 管理员、员工、试运行、部署和真机复核手册 | 用于当前试运行、上线和人工验收；与 PRD 冲突时以 PRD 和最新 Issue CSV 为准 |
 | 历史证据 | 实现状态矩阵、trialrun 报告和 CSV、旧 TODO、旧实施计划 | 只用于追溯功能是否做过、当时怎么验过；不作为当前需求来源 |
 | 技术参考 | 架构、集成边界、领域事件、MCP、ops、ADR | 用于理解运行时边界和技术约束；不能单独扩大当前 MVP 范围 |
 | 历史归档参考 | 一次性方案、早期选型、迁移映射和外部调研快照 | 只作审计和追溯；若要重新启用，必须先更新 PRD 或模块规约并新建 Issue CSV |
 判断冲突时，优先级固定为：最新 Issue CSV > 当前 PRD 和模块规约 > 产品口径文档 > 当前操作手册 > 技术参考 > 历史证据和归档参考。
 ## 当前事实源
 | 文档 | 用途 | 注意 |
@@ -36,19 +50,19 @@
 | 文档 | 用途 | 注意 |
 | --- | --- | --- |
-| [实现状态矩阵](./feature-matrix.md) | 历史实现状态、完成证据、回归覆盖追踪 | 不是 PRD，不作为新增需求来源 |
+| [实现状态矩阵](./feature-matrix.md) | 历史实现状态、完成证据、回归覆盖追踪 | 历史证据，不是 PRD，不作为新增需求来源 |
-| [试运行覆盖矩阵](./trialrun/coverage-matrix.csv) | 试运行覆盖范围和缺口 | 读取时结合最新 Issue CSV |
+| [试运行覆盖矩阵](./trialrun/coverage-matrix.csv) | 试运行覆盖范围和缺口 | 历史证据；读取时结合最新 Issue CSV，不单独决定当前范围 |
-| [项目级流程矩阵](./trialrun/project-wide-flow-matrix.csv) | 核心业务流、入口、测试覆盖映射 | 用于 QA 和回归规划 |
+| [项目级流程矩阵](./trialrun/project-wide-flow-matrix.csv) | 核心业务流、入口、测试覆盖映射 | 历史证据和 QA 参考，不作为当前需求来源 |
-| [人工业务试运行报告](./trialrun/manual-trialrun-report.md) | R70 当时的人工试运行证据 | 是历史快照，不代表当前公网状态 |
+| [人工业务试运行报告](./trialrun/manual-trialrun-report.md) | R70 当时的人工试运行证据 | 历史快照，不代表当前公网状态 |
-| [历史 TODO 清账映射](./todo-reconciliation.md) | 旧 TODO 的 implemented / superseded / still-open 追溯 | 不用来生成新需求 |
+| [历史 TODO 清账映射](./todo-reconciliation.md) | 旧 TODO 的 implemented / superseded / still-open 追溯 | 历史证据，不用来生成新需求 |
 ## 架构、集成与运维参考
 | 文档 | 用途 | 注意 |
 | --- | --- | --- |
 | [系统架构概览](./architecture.md) | 当前架构、部署视图和运行时边界 | 与部署现状有关时需结合最新部署报告 |
-| [集成边界冻结](./integration-boundaries.md) | ERP、IM、AI、MCP、PWA 等集成边界 | 当前首批路线不接入飞书/钉钉 |
+| [集成边界冻结](./integration-boundaries.md) | ERP、IM、AI、MCP、PWA 等集成边界 | 技术参考和历史证据；当前首批路线不接入飞书/钉钉，不因本文档扩大 ERP/AI 范围 |
-| [领域事件清单](./domain-events.md) | 领域事件名和对外事件边界 | 面向集成和异步处理 |
+| [领域事件清单](./domain-events.md) | 领域事件名和对外事件边界 | 技术参考和历史证据；面向集成和异步处理，不作为当前 MVP 扩围依据 |
 | [MCP Tools](./mcp-tools.md) | MCP 工具启用边界 | 未启用的 MCP 不得假设可用 |
 | [非功能基线](./ops/non-functional-baseline.md) | 安全、性能、回滚、上线最低要求 | 上线和发布前参考 |
 | [测试策略](./ops/testing-strategy.md) | 自动化测试和门禁策略 | QA 规划参考 |
@@ -58,11 +72,11 @@
 | 文档 | 用途 | 注意 |
 | --- | --- | --- |
-| [实施计划](./implementation_plan.md) | 2026-02 Phase 1 引导计划和历史实施思路 | 不是当前执行计划 |
+| [实施计划](./implementation_plan.md) | 2026-02 Phase 1 引导计划和历史实施思路 | 历史归档参考，不是当前执行计划 |
-| [技术栈与复用报告](./tech_stack_report.md) | 早期技术选型定案和复用说明 | 技术栈仍有参考价值，范围说明已过时 |
+| [技术栈与复用报告](./tech_stack_report.md) | 早期技术选型定案和复用说明 | 历史归档参考；技术栈仍有参考价值，范围说明已过时 |
-| [invoicePool 路由拆分方案](./invoice-pool-refactor-plan.md) | 一次性拆分方案归档 | 完成后只作追溯 |
+| [invoicePool 路由拆分方案](./invoice-pool-refactor-plan.md) | 一次性拆分方案归档 | 历史归档参考，完成后只作追溯 |
-| [试点迁移映射清单](./migration-mapping.md) | 旧系统迁移和切换边界 | 仅在迁移/切换专项中使用 |
+| [试点迁移映射清单](./migration-mapping.md) | 旧系统迁移和切换边界 | 历史归档参考，仅在迁移/切换专项中使用 |
-| [国内 OA 与费控系统最佳实践对照](./trialrun/domestic-oa-best-practices.md) | 外部最佳实践调研快照 | 不替代当前 PRD |
+| [国内 OA 与费控系统最佳实践对照](./trialrun/domestic-oa-best-practices.md) | 外部最佳实践调研快照 | 历史归档参考，不替代当前 PRD |
 | [ADR: 移动端路线决策](./adr/adr-mobile-strategy.md) | PWA、RN、小程序路线决策记录 | 保留 ADR 历史结论 |
 | [ADR: 企业卡/虚拟卡管控能力预研](./adr/adr-enterprise-card-control.md) | 企业卡能力预研记录 | 不进入当前 MVP 首批范围 |
@@ -0,0 +1,6 @@
 ID,Title,Description,Acceptance,Test_Method,Tools,Dev_Status,Review1_Status,Regression_Status,Files,Dependencies,Notes
 A1,docs文档盘点与归档策略确认,"确认本轮采用索引归档策略治理 docs 历史证据和过期口径，不移动、不删除历史文档，不回写旧 Issue CSV。","1) 新 Issue CSV 校验通过；2) 范围限定为文档治理；3) 不创建 docs/archive；4) 不修改 server/client 业务代码；5) 归档策略明确为保留原路径并强化索引和状态提示。","命令：python3 /home/shunli/.codex/skills/plan/scripts/validate_issues_csv.py issues/2026-05-09_20-04-59-docs-archive-governance.csv；人工步骤：确认 git status 仅包含 docs 与本 Issue CSV。",python3,DONE,DONE,DONE,issues/2026-05-09_20-04-59-docs-archive-governance.csv,"[]","本轮只做索引归档文档治理，不移动历史文件。"
 A2,强化文档索引归档规则,"更新 docs/文档索引.md，增加当前事实源、当前手册、历史证据、技术参考、历史归档的判定规则和阅读顺序。","1) 文档索引包含归档判定规则；2) 新人只读索引可判断哪些文档能指导开发；3) 明确历史证据不作为当前需求来源；4) 保持现有文档链接不移动。","人工步骤：阅读 docs/文档索引.md，确认当前事实源、当前手册、历史证据、技术参考、历史归档的边界清晰。",manual,DONE,DONE,DONE,docs/文档索引.md,"[""A1""]","不创建新的归档目录。"
 A3,统一历史证据状态提示,"给历史证据类文档补充或统一非当前事实源提示，重点覆盖 domain-events、integration-boundaries、feature-matrix、implementation_plan、todo-reconciliation 和 trialrun 历史证据。","1) 关键历史文档顶部或索引明确历史证据/归档参考/非当前事实源；2) domain-events 不再被误读为当前 MVP 扩围依据；3) trialrun 历史报告和 CSV 证据通过索引归档；4) 不破坏旧链接。","命令：rg -n ""当前事实源|历史证据|归档参考|不是当前|不作为当前需求来源|不得误读"" docs/文档索引.md docs/domain-events.md docs/integration-boundaries.md docs/feature-matrix.md docs/implementation_plan.md docs/todo-reconciliation.md docs/trialrun docs/admin-handbook.md；人工判断命中内容是否覆盖关键文档。",ripgrep|manual,DONE,DONE,DONE,docs/文档索引.md|docs/domain-events.md|docs/integration-boundaries.md|docs/feature-matrix.md|docs/implementation_plan.md|docs/todo-reconciliation.md|docs/trialrun,"[""A2""]","CSV 证据文件不插入注释，避免破坏解析。"
 A4,刷新管理员手册当前路线,"更新 docs/admin-handbook.md，使当前 MVP 上线顺序和管理口径对齐 OA 唯一审批中心、报销/OCR、请假考勤、企业微信基础设施和 P1 轻量能力。","1) 管理员手册不再把旧 Portal/周报试点顺序误认为当前主线；2) 明确企业微信只做入口、身份、通知、打卡采集；3) 明确飞书、企业微信原生审批、钉钉、小程序、重型 ERP/AI/差旅不进入当前首批；4) 涉密边界不放松。","人工步骤：阅读 docs/admin-handbook.md，确认推荐上线顺序、验收口径和备用模块治理与当前 PRD 一致。",manual,DONE,DONE,DONE,docs/admin-handbook.md,"[""A2""]","只改文档口径，不改配置或部署。"
 A5,文档引用路线口径与校验,"执行 CSV、文档格式和路线口径校验，确认历史文档仍可追溯且未重新引入废弃路线。","1) CSV 校验通过；2) git diff --check 通过；3) 路线关键词只出现在废弃/不做/历史或边界说明中；4) A1-A5 状态回填 DONE；5) 提交中文 commit。","命令：git diff --check；命令：rg -n ""飞书|企业微信原生审批|钉钉|小程序|ERP|AI|TRAVEL|Phase"" docs/文档索引.md docs/admin-handbook.md docs/domain-events.md docs/integration-boundaries.md；人工判断命中内容与当前路线一致。",git|ripgrep|manual,DONE,DONE,DONE,docs/文档索引.md|docs/admin-handbook.md|docs/domain-events.md|docs/integration-boundaries.md|issues/2026-05-09_20-04-59-docs-archive-governance.csv,"[""A2"",""A3"",""A4""]","本轮不跑后端/前端构建，不部署。"