文件
hyb-oa/issues/2026-05-13_18-23-53-biz8-finance-ocr-project.csv
T

12 KiB

1IDTitleDescriptionAcceptanceTest_MethodToolsDev_StatusReview1_StatusRegression_StatusFilesDependenciesNotes
2BIZ8-0BIZ8 连续合同建档建立报销、OCR、财务和项目轻量增强连续型合同,避免 OCR、票据、财务导出、费用提示和项目关联散落到多个小 CSV。1) 本 CSV 校验通过;2) 文档索引和状态矩阵指向本合同;3) 不进入 ERP 实时集成或重预算;4) 不改业务代码;5) 真实 OCR 和样票需授权。流程级验证:python3 /home/shunli/.codex/skills/plan/scripts/validate_issues_csv.py issues/2026-05-13_18-23-53-biz8-finance-ocr-project.csv;rg -n 'BIZ8|OCR|财务|项目' docs/文档索引.md docs/文档事实源状态矩阵.md issues/README.md。python3|rg|manualDONEDONEDONEissues/2026-05-13_18-23-53-biz8-finance-ocr-project.csv|docs/文档索引.md|docs/文档事实源状态矩阵.md|issues/README.md[]CSV validator 和索引 rg 均通过;本次仅合同建档和入口登记,未改业务代码,真实 OCR 和样票仍需授权。
3BIZ8-1业务增强需求规约更新复核报销、发票、OCR、财务、费用提示和项目轻管理规约,明确 BIZ8 当前做与不做。1) PDF-only 当前口径清楚;2) 图片 OCR 仅做可行性设计或明确不做;3) ERP 和重预算冻结;4) 财务和项目权限边界清楚。流程级验证:rg -n 'PDF|图片 OCR|发票|财务|费用|项目|ERP|预算' docs/报销发票附件规则.md docs/需求-报销发票OCR规约.md docs/需求-项目轻管理规约.md docs/海音达OA-MVP需求规格说明书.md。rg|manualDONEDONEDONEdocs/报销发票附件规则.md|docs/需求-报销发票OCR规约.md|docs/需求-项目轻管理规约.md|docs/海音达OA-MVP需求规格说明书.md["BIZ8-0"]rg 复核通过;PRD、报销 OCR 规约、报销附件规则和项目轻管理规约已覆盖 PDF-only、图片 OCR 后续设计、ERP/预算冻结、财务付款导出和项目轻量权限边界;未改业务代码。
4BIZ8-2PDF-only 当前口径复核复核当前 OCR 是否仍以 PDF-only 为验收口径,避免把未实现图片 OCR 误报为能力。1) 当前支持格式清楚;2) 页面提示和后端校验一致;3) 测试样例可复现;4) 不承诺未实现格式。流程级验证:上传 PDF 和非 PDF 样例 -> 检查校验、提示和 OCR 状态;rg 当前 OCR 文档口径。manual|node|playwrightDONEDONEDONEdocs/需求-报销发票OCR规约.md|server/src|client/src["BIZ8-1"]后端 npm test -- tests/unit/routes/invoicePool.upload.test.js 通过 6 tests,覆盖 PDF 上传和 image/png 发票拒绝 pdf_invoice_required;前端 npx playwright test tests/e2e/r111-invoice-reimbursement-guard.spec.ts --workers=1 --reporter=list 通过 2 tests,覆盖 PC 和企业微信移动端 PDF 发票上传、图片附件分离和无拍照发票入口;rg 已确认文档继续保持 PDF-only 和图片 OCR 后续能力口径;未改业务代码。
5BIZ8-3图片 OCR 可行性设计设计图片 OCR 是否进入当前阶段,评估 provider、成本、准确率、样票授权和回滚路径。1) provider 和 SDK 选择清楚;2) 样票授权和脱敏规则明确;3) 不影响 PDF OCR;4) 不做 AI 自动处理。流程级验证:人工审查可行性设计;必要时用脱敏样票在非生产环境验证。manualDONEDONEDONEdocs/需求-报销发票OCR规约.md|docs/报销发票附件规则.md["BIZ8-2"]已在 docs/需求-报销发票OCR规约.md 增加 BIZ8 图片 OCR 可行性设计;官方资料复核腾讯云、阿里云、百度均支持图片或 PDF 发票识别,当前结论为技术可行但不开放正式能力;优先复用现有腾讯云通道,真实样票授权、脱敏、feature flag、字段归一化、审计和回滚条件满足后再开发;未改业务代码。
6BIZ8-4样票脱敏和授权规则定义真实 OCR 和批量回归所需样票的授权、脱敏、存放和引用规则。1) 样票来源合法;2) 票据、公司、金额和个人信息按需脱敏;3) 仓库不提交敏感原件;4) 证据只记录路径和摘要。流程级验证:人工核对样票授权记录和脱敏规则;rg 确认仓库未新增真实票据原件。manual|rgDONEDONEDONEdocs/报销发票附件规则.md|artifacts|output["BIZ8-3"]已在 docs/报销发票附件规则.md 增加样票脱敏和授权规则;要求授权登记在仓库外、真实票据原件不入 git、证据只记录别名摘要和路径、无授权样票时真实 OCR 回归只能 SKIP;本次未新增样票文件或业务代码。
7BIZ8-5批量样票回归设计设计 OCR 批量样票回归,区分 mock、真实 provider、pending OCR 和失败重试。1) mock 与真实 provider 结论分离;2) pending OCR 不等于失败或通过;3) 阈值和样本数清楚;4) 失败有复核路径。流程级验证:node scripts/qa/check-pending-ocr.mjs --thresholds=2,5,10;真实样票缺失时记录 SKIP。node|manualDONEDONEDONEscripts/qa|docs/需求-报销发票OCR规约.md["BIZ8-4"]已在 docs/试运行与自动化验证手册.md 增加 BIZ8 批量样票 OCR 回归设计,区分 mock、pending 扫描、单张真实 OCR 和批量真实 OCR;node scripts/qa/check-pending-ocr.mjs 阈值 2/5/10 输出 [pending-ocr][SKIP] missing DATABASE_URL,按规则记录为非阻断 SKIP;当前无授权样票和凭据,未执行真实批量 OCR。
8BIZ8-6OCR 异步终态体验优化或验证 OCR 异步处理中、成功、失败、pending 和重试的页面体验。1) 异步状态可解释;2) 用户知道是否需要等待或重试;3) 失败不阻塞无关流程;4) 移动端不重叠。流程级验证:上传发票 -> 观察 OCR pending/success/failure -> PC 和移动查看报销详情状态。playwright|node|manualDONEDONEDONEserver/src|client/src|docs/产品设计规则.md["BIZ8-5"]npx playwright test tests/e2e/r111-invoice-reimbursement-guard.spec.ts --workers=1 --reporter=list 通过 2 tests;覆盖 PC 发票上传后 pending 轮询并自动添加、企业微信移动端 pending 提示、识别失败发票显示可删除后重新上传、图片附件分离和移动布局指标;未改业务代码或页面代码。
9BIZ8-7重复票据例外流程设计重复票据发现后的例外处理流程,避免误拦截合法场景或放过风险。1) 重复提示清楚;2) 人工例外有权限和记录;3) 不绕过财务复核;4) 审计可追溯。流程级验证:提交重复票据 -> 检查拦截或例外路径 -> 财务复核 -> 查看审计记录。node|playwright|manualDONEDONEDONEserver/src|client/src|docs/报销发票附件规则.md["BIZ8-2"]npm test -- tests/unit/invoiceGovernance.dedup.test.js tests/unit/routes/invoicePool.upload.test.js 通过 2 files 11 tests,覆盖重复可用票据复用、他人或已使用票据阻断和可理解提示;一次性 Fastify 注入验证 /api/invoice-pool/:id/override-duplicate 无 expense.finance.override_duplicate 权限返回 403,有权限时写 is_duplicate_override、原单号、原因和 INVOICE_DUPLICATE_OVERRIDDEN 审计;未改业务代码。
10BIZ8-8财务台账扫读性提升财务台账的扫读性,优先解决状态、金额、申请人、项目和票据提示的扫描效率。1) 财务能快速识别待处理项;2) 状态和金额不混乱;3) 权限不泄露;4) PC 和移动布局可用。流程级验证:财务查看台账 -> 筛选或扫读待付款报销 -> 检查状态、金额、申请人和票据提示。playwright|npm|manualTODOTODOTODOclient/src|server/src|docs/产品设计规则.md["BIZ8-1"]待批准方案:当前 AP 财务台账已有状态 金额 申请人 付款 发票 附件;缺项目字段 项目搜索 项目导出;批准后仅增强报销台账读取链路 server/src/services/financeLedger.js client/src/api/apOperations.ts client/src/pages/ApOperationsPage.tsx;加入 project select/map 类型 表格字段 搜索条件和导出字段;不改付款状态机 不引入 ERP 不改移动入口;验证 server 相关单测 client typecheck/build 和 AP Playwright。
11BIZ8-9付款和导出增强增强或验证财务付款标记和导出路径,保证权限、状态和审计一致。1) 只有财务可执行付款或导出;2) 状态转换合法;3) 导出不泄露无权限数据;4) 操作可追溯。流程级验证:财务付款或导出 -> 普通员工和管理员直连复核 -> 检查状态和权限。node|bash|manualTODOTODOTODOserver/src|client/src|server/scripts["BIZ8-8"]待批准方案:BIZ8-9 先作为 BIZ8-8 的导出和权限回归承接;导出补项目字段并复核现有 AP export 权限;付款标记只验证现有付款批次和报销付款状态一致性 不新增 ERP 实时集成 不新增付款状态机;如需直接付款按钮必须另给状态机和回滚方案。
12BIZ8-10费用提示轻量规则设计轻量费用提示规则,作为填报辅助而非重预算控制。1) 提示不阻断合法报销;2) 规则来源清楚;3) 不承诺预算控制;4) 用户可理解。流程级验证:填写不同金额或类型报销 -> 检查费用提示 -> 提交和审批不被误阻断。manual|playwrightDONEDONEDONEdocs/报销发票附件规则.md|client/src|server/src["BIZ8-1"]已在 docs/需求-报销发票OCR规约.md 增加 BIZ8 费用提示轻量规则,明确材料提示、金额提示、费用标准 warn、费用标准 block 和预算提示边界;npm test -- tests/unit/services/expenseStandards.check.test.js tests/unit/routes/reimbursements.expense-standards.test.js 通过 2 files 9 tests,覆盖 warn 不阻断、block 阻断和 manual_review 优先级;未改业务代码。
13BIZ8-11项目关联增强增强报销、采购或合同与项目轻管理的关联,保持轻量不扩展成重型项目管理。1) 项目选择和展示清楚;2) 无项目时可解释;3) 项目权限不泄露;4) 不扩展复杂 WBS。流程级验证:创建或选择项目 -> 提交报销/采购 -> 财务或负责人查看关联 -> 检查权限。node|playwright|manualTODOTODOTODOdocs/需求-项目轻管理规约.md|server/src|client/src["BIZ8-1"]待批准方案:报销和合同已有项目关联;采购模型缺 project_id 且项目详情页无采购摘要;批准后需 Prisma migration 给 purchase_requests 增 nullable project_id 和索引 relation;后端采购创建/更新/详情/列表补项目字段并校验项目可读和未归档;前端采购表单/详情/列表补项目选择与展示;项目详情补采购摘要;必须 reviewer 和权限回归;继续冻结复杂 WBS 预算控制和 ERP。
14BIZ8-12移动端业务入口评估评估报销、OCR、财务和项目轻量能力在移动端和企业微信入口的可用性。1) 移动入口不重复;2) 企业微信入口回 OA;3) 财务敏感能力不误暴露;4) 新增入口进入移动矩阵。流程级验证:员工和财务角色在移动端进入业务入口 -> 检查报销/OCR/项目状态和权限。playwright|manualTODOTODOTODOclient/src|docs/产品设计规则.md|docs/trialrun/真机公网测试清单.md["BIZ8-8","BIZ8-11"]真机验证不能被自动化替代。
15BIZ8-13财务和项目权限回归回归财务台账、付款导出、项目关联和报销详情的权限边界。1) 普通员工只能看自己的数据;2) 财务只看授权财务数据;3) 管理员不自动获得财务处理;4) 项目关联不越权。流程级验证:不同角色直连财务、项目、报销详情和导出 API -> 检查允许和拒绝结果。bash|node|manualTODOTODOTODOscripts/qa|server/src|client/src["BIZ8-9","BIZ8-11","BIZ8-12"]高风险权限变更必须 reviewer。
16BIZ8-14BIZ8 收口准备整理 BIZ8 验证摘要、OCR 边界、财务和项目权限结论、未完成项。1) DONE 行均有证据;2) OCR 真实与 mock 结论分离;3) 权限回归通过或有阻断;4) 未完成项不伪装完成。流程级验证:人工核对 BIZ8 CSV 状态、验证摘要、OCR 证据和权限回归结果。manual|gitTODOTODOTODOissues/2026-05-13_18-23-53-biz8-finance-ocr-project.csv|docs/文档索引.md["BIZ8-13"]对应原规划 BIZ8-14。
17BIZ8-CLOSEBIZ8 阶段 CLOSE阶段性关闭 BIZ8,完成状态回填、验证摘要和中文提交。1) CSV 校验通过;2) git diff --check 通过;3) 所有 DONE 有命令或人工证据;4) 中文提交引用 BIZ8;5) 后续风险有归属。流程级验证:validate_issues_csv.py 本 CSV;git diff --check;人工核对最终摘要。python3|git|manualTODOTODOTODOissues/2026-05-13_18-23-53-biz8-finance-ocr-project.csv["BIZ8-14"]每个连续 CSV 保留 CLOSE 行。