diff --git a/.agents/skills/hyb-oa-delivery/SKILL.md b/.agents/skills/hyb-oa-delivery/SKILL.md index fca1cc88..c037819f 100644 --- a/.agents/skills/hyb-oa-delivery/SKILL.md +++ b/.agents/skills/hyb-oa-delivery/SKILL.md @@ -106,3 +106,5 @@ Final responses should include: - If real-device mobile validation is paused after automation passes, record the gate as `PAUSED`; do not close RS6/UI6/R6 mobile blockers until representative real-device confirmation is recorded. - Role-specific pages should use one shared OA/mobile framework and tailor summaries, entries, actions, and sensitive fields by role. Do not create unrelated UI systems for employee, approver, finance, admin, or CEO views. - After MUD6, `R6-ISSUE-001` is treated as resolved based on representative real-device confirmation; future mobile regressions should be recorded as new Issues rather than reopening the old WCM6/MME6 gate unless the same production behavior returns. +- After AP6, approval reminder, overdue reminder, and workflow productivity summary are current product facts, not open planning items. Reuse `POST /api/workflow/tasks/:taskId/remind`, `GET /api/workflow/tasks/summary`, `job:workflow-overdue-reminders`, existing workflow history, audit logs, notifications, and WeCom personal app delivery semantics. Do not add a parallel reminder channel, change approval status from reminders, or expand into complex BPM/SLA escalation without a new Issue. +- After AP6 and FL6, the default next implementation batch is RI6 reimbursement/invoice experience unless the user explicitly redirects. Keep existing RI6/LP6/ME6/QG6 CSV contracts instead of creating duplicate roadmap contracts. diff --git a/docs/agent-development-practices.md b/docs/agent-development-practices.md index feca779c..ba9f101e 100644 --- a/docs/agent-development-practices.md +++ b/docs/agent-development-practices.md @@ -77,7 +77,7 @@ AGENTS.md 只放硬约束和入口，不复制长规则。 - PC 端：工作台、表格、筛选、详情分区、批量处理和管理配置。 - 移动端：企业微信消息驱动、卡片列表、一级底部导航、深层 Push 页和吸底主操作。 -- 审批：待办聚合、明确状态、可追溯、可催办、超时提醒和效率统计。 +- 审批：待办聚合、明确状态、可追溯、可催办、超时提醒和效率统计。AP6 v1 已提供催办、待办摘要和超时提醒 job；后续审批/通知/催办开发必须先核对统一审批中心规约，复用既有接口、审计和通知语义，不另造平行链路。 - 企业微信：入口、身份、个人应用消息和 deeplink，不替代 OA 正式审批。 可自动化的体验检查先自动化，例如 Playwright PC、移动、企业微信 UA 和 DOM 指标；真实企业微信登录、手机应用消息到达、真实通知权限和财务制度决策必须保留人工确认记录。 diff --git a/docs/product-design-rules.md b/docs/product-design-rules.md index 4d9527b8..879e970e 100644 --- a/docs/product-design-rules.md +++ b/docs/product-design-rules.md @@ -31,7 +31,7 @@ R6 之后的 PC、移动和审批体验参考国内主流协同/OA 产品的共 - 移动端是消息驱动的轻入口，服务提交、补材料、查状态、处理待办和从企业微信消息回流。 - PC 高密度、移动轻任务是双端分工底线；不得把桌面表格和批量管理能力原样搬到手机端。 - 企业微信只做入口、绑定、免登录、个人应用消息和 deeplink，不替代 OA 正式审批页。 -- 审批体验以“待办聚合、清晰状态、明确下一步、可催办和可追溯”为目标；催办、超时提醒和效率统计属于 R6 后续优化，不混入 R6 首轮试运行门禁。 +- 审批体验以“待办聚合、清晰状态、明确下一步、可催办和可追溯”为目标；AP6 v1 已完成催办、超时提醒和审批效率摘要，后续只在独立 Issue 中增强配置治理、升级处理或更复杂的节点 SLA。 - 竞品资料只用于抽象原则；不得复制钉钉、飞书、企业微信、WeUI 或 Ant Design 的页面文案、视觉细节和专有交互。 参考资料： diff --git a/docs/trialrun/manual-trialrun-report.md b/docs/trialrun/manual-trialrun-report.md index eebf01e8..dfb29bd8 100644 --- a/docs/trialrun/manual-trialrun-report.md +++ b/docs/trialrun/manual-trialrun-report.md @@ -14,8 +14,8 @@ | 项目 | 记录 | | --- | --- | | 公网地址 | `https://oa.hyinda.com` | -| 当前门禁 | R5 已 `DONE/DONE/DONE`；R6 首轮小范围试运行已完成；R6-ISSUE-003 采购提交阻断已热修、部署并复跑通过；后续进入 PC/移动/审批效率/财务台账优化批次 | -| 当前代码基线 | `a8b7351`；公网 `https://oa.hyinda.com` 已部署 PS6 采购提交热修并完成 live smoke 复检 | +| 当前门禁 | R5 已 `DONE/DONE/DONE`；R6 首轮小范围试运行已完成；R6-ISSUE-003 采购提交阻断已热修、部署并复跑通过；PC6/PA6/FL6/AP6 后续优化已完成；下一批进入 RI6 报销票据体验完善 | +| 当前代码基线 | `2d87c36`；公网 `https://oa.hyinda.com` 已部署 AP6 审批催办、超时提醒和效率摘要，并完成 live smoke readiness 复检 | | 试运行窗口 | `2026-05-12 14:00-17:00 Asia/Shanghai`；若现场无法执行，顺延到 `2026-05-13 14:00-17:00 Asia/Shanghai` | | 回滚联系人 | `wangshunli` | | 问题登记负责人 | `wangshunli` | @@ -88,6 +88,8 @@ R6-3 试运行前自动检查（2026-05-12）：公网 `/ready` 正常；public R6 首轮小范围试运行通过。已验证报销、请假、采购、审批、企业微信个人应用消息、移动入口既有门禁和财务付款主链路；采购提交阻断已通过 PS6 热修关闭。R6 通过不等于全面正式上线，下一批按独立 Issue 推进 PC 信息架构、移动二轮体验、审批催办/超时、审批效率摘要和财务台账增强。 +AP6 收口（2026-05-12）：审批效率 v1 已完成并部署。代码提交 `72e38db` 增加审批催办、超时提醒 job 和待办效率摘要，状态回填提交 `2d87c36` 记录部署验收；公网 `/ready` 正常，public bundle `findings=0`，live smoke readiness 通过，报告 `artifacts/qa-flow/live-smoke-readiness-20260512-104535`。AP6 v1 固定为：申请人/提交人可通过 `POST /api/workflow/tasks/:taskId/remind` 催办本人 pending 审批，24 小时同一任务最多 1 次；`GET /api/workflow/tasks/summary` 返回待办和超时聚合；`job:workflow-overdue-reminders` 只提醒 pending 待办，不改变审批状态。下一批默认进入 RI6 报销票据体验完善；R7 尚未启动，需在 RI6/LP6 至少完成一轮后另建合同。 + ## 结论 R70 初次试运行暂停项已在 2026-04-28 的 R71 定向修复后关闭。基于本地环境复测，经理团队日历与员工报销缺票提示/发票上传绑定提交链路均已通过，可恢复下一轮本地人工试运行。 diff --git a/docs/需求-统一审批中心规约.md b/docs/需求-统一审批中心规约.md index 8b05bbab..53a0f428 100644 --- a/docs/需求-统一审批中心规约.md +++ b/docs/需求-统一审批中心规约.md @@ -322,11 +322,13 @@ - A8：审批规则配置矩阵落地，覆盖金额阈值、天数阈值、兜底审批人、转审和撤回。 - A9：权限与数据范围矩阵落地，覆盖附件下载、导出、例外处理和系统管理员最小授权。 -R6 首轮试运行只验证已有审批主链路稳定性，不新增复杂审批能力。R6 后续优化可单独拆分： +R6 首轮试运行只验证已有审批主链路稳定性，不新增复杂审批能力。R6 后续审批效率能力已通过 AP6 v1 落地，当前事实源如下： - 待办聚合：PC 和移动统一展示待办、已办、抄送和通知入口。 -- 催办与超时提醒：AP6 v1 允许申请人/提交人对本人审批中单据的 pending 任务催办，24 小时内同一任务最多 1 次；超时提醒只提醒 pending 待办，不改变审批状态，通知失败不回滚业务，但必须进入审计和通知投递记录。 -- 审批效率统计：AP6 v1 聚合待办总数、超时数、最早待处理时间、平均等待小时数，并按业务类型、节点和角色汇总；`scope=system` 仅 `system.audit.view` 可读，返回聚合数，不返回申请人明细。 -- 流程配置治理：把金额阈值、兜底审批人、转审规则和通知路由纳入管理员可理解的配置页。 +- 催办：`POST /api/workflow/tasks/:taskId/remind` 仅允许申请人、提交人或实际归属人催办本人审批中单据的 pending 任务；同一申请人对同一任务 24 小时内最多 1 次；审批人不能催办自己，`admin` 单角色不能代催办。 +- 超时提醒：`job:workflow-overdue-reminders` 只扫描 pending 待办；优先使用 `due_date`，没有 `due_date` 时按创建后 24 小时判定；同一任务 24 小时内只发一次超时提醒。 +- 审批效率统计：`GET /api/workflow/tasks/summary` 聚合待办总数、超时数、最早待处理时间、平均等待小时数，并按业务类型、节点和角色汇总；`scope=system` 仅 `system.audit.view` 可读，返回聚合数，不返回申请人明细。 +- 状态与审计：催办和超时提醒不改变审批状态，不替代正式审批动作；通知失败不回滚业务，但必须进入审批历史、审计日志、站内通知或通知投递记录。 +- 后续治理增强：流程配置治理、升级处理、节点 SLA 配置和复杂 BPM 仍需另拆 Issue，不在 AP6 v1 内顺手扩展。 涉及状态机、权限模型、数据库迁移或审批规则调整的 Issue，必须在技术方案中写明回滚策略和回归范围。 diff --git a/issues/2026-05-12_10-58-02-ap6-doc-skill-sync-and-roadmap.csv b/issues/2026-05-12_10-58-02-ap6-doc-skill-sync-and-roadmap.csv new file mode 100644 index 00000000..4ab4e39d --- /dev/null +++ b/issues/2026-05-12_10-58-02-ap6-doc-skill-sync-and-roadmap.csv @@ -0,0 +1,7 @@ +ID,Title,Description,Acceptance,Test_Method,Tools,Dev_Status,Review1_Status,Regression_Status,Files,Dependencies,Notes +DS7-1,AP6 后事实源核对,核对 AP6 已部署状态、现有后续合同和工作区状态，确认不重复新建 RI6/LP6/ME6/QG6 总合同。,"1) AP6 CSV 为 DONE/DONE/DONE；2) 工作区干净；3) RI6/LP6/ME6/QG6 既有合同可追溯；4) R7 尚无新合同。","流程级验证：git status --short；git log --oneline -6；读取 AP6/RI6/LP6/ME6/QG6 CSV。",git|manual,DONE,DONE,DONE,issues/*.csv,[],本行只记录规划事实，不改业务代码。 +DS7-2,统一审批中心规约同步,把 AP6 v1 从后续规划口径固化为当前事实源，明确催办接口、摘要接口、超时 job、通知和审计语义。,"1) 规约包含 POST /api/workflow/tasks/:taskId/remind；2) 包含 GET /api/workflow/tasks/summary；3) 包含 job:workflow-overdue-reminders；4) 明确不改变审批状态、不新增复杂 BPM。","流程级验证：rg -n 'workflow/tasks/.*/remind|workflow/tasks/summary|job:workflow-overdue-reminders|不改变审批状态|24 小时' docs/需求-统一审批中心规约.md。",rg|manual,DONE,DONE,DONE,docs/需求-统一审批中心规约.md,"[""DS7-1""]",已将 AP6 v1 接口、job、频控、状态和审计口径写入规约；不改接口。 +DS7-3,产品设计规则同步,更新产品设计规则中审批体验状态，区分 AP6 v1 已完成与后续 AP6 v2/治理增强。,"1) 文档不再把催办/超时/效率统计整体描述为未完成；2) 保留 PC 高密度、移动轻任务原则；3) 不复制竞品文案。","流程级验证：rg -n 'AP6 v1|催办|超时提醒|审批效率|移动轻任务' docs/product-design-rules.md。",rg|manual,DONE,DONE,DONE,docs/product-design-rules.md,"[""DS7-2""]",已把 AP6 v1 标为已完成，后续增强保留独立 Issue。 +DS7-4,交付 Skill 与实践同步,更新 hyb-oa-delivery Skill 和 agent 开发实践，要求审批后续开发复用 AP6 现有接口、审计和通知语义。,"1) Skill 提醒审批/通知/催办任务先读统一审批中心规约；2) 明确 AP6 后下一批默认 RI6；3) quick_validate 通过。","流程级验证：quick_validate.py .agents/skills/hyb-oa-delivery；rg -n 'AP6|RI6|催办|超时提醒|workflow/tasks/summary' .agents/skills/hyb-oa-delivery docs/agent-development-practices.md。",python3|rg,DONE,DONE,DONE,.agents/skills/hyb-oa-delivery/SKILL.md|docs/agent-development-practices.md,"[""DS7-3""]",Skill valid；已明确复用 AP6 语义和默认下一批 RI6。 +DS7-5,试运行报告补 AP6 完成记录,在试运行报告里追加 AP6 已部署、公网 readiness 通过和后续顺序。,"1) 记录提交 72e38db/2d87c36；2) 记录 live readiness 报告；3) 明确下一批 RI6；4) 不把 R7 误标为已启动。","流程级验证：rg -n 'AP6|72e38db|2d87c36|live-smoke-readiness-20260512-104535|RI6' docs/trialrun/manual-trialrun-report.md。",rg|manual,DONE,DONE,DONE,docs/trialrun/manual-trialrun-report.md,"[""DS7-4""]",已补 AP6 收口记录；R7 仍未启动。 +DS7-6,文档同步校验提交,完成文档和 Skill 同步后运行 CSV、Skill、术语和 diff 校验并提交。,"1) CSV 校验通过；2) Skill quick_validate 通过；3) rg 关键术语命中；4) git diff --check 通过；5) 中文提交。","流程级验证：validate_issues_csv.py <本CSV>；quick_validate.py .agents/skills/hyb-oa-delivery；rg -n 'AP6|RI6|催办|超时提醒|审批效率|job:workflow-overdue-reminders' docs .agents/skills/hyb-oa-delivery issues；git diff --check。",python3|rg|git,DONE,DONE,DONE,issues/2026-05-12_10-58-02-ap6-doc-skill-sync-and-roadmap.csv|docs|.agents/skills/hyb-oa-delivery,"[""DS7-5""]",CSV、Skill、rg 和 diff 校验通过；中文提交。