财务模块 · 技术文档

财务模块 · 项目说明

版本 V1.7 · 2026-10-09 · 支持在线查看与原文下载
下载 Markdown 原文

财务模块 · 项目说明

这是认识本项目的第一份文档——5 分钟了解"是什么、做到哪、怎么用"。 全部交付物逐项明细见《交付物总清单.md》;文档全索引见 README.md;开发上手见《财务模块开发指南.md》。 日期:2026-10-09


一、这是什么

为财务模块建设自动记账能力,两个目标形态并存:

同一引擎、同一数据模型,两模式可随时升降级、数据无损。

模式 A · 业财一体(默认) 模式 B · 纯记账(兼容)
输入源 业务模块事件 + 票据流水 仅票据与流水
财务日常 复核事项 + 复核凭证 导入 + 复核(事项层自动创建、透明化)
页面 41 页全量 隐藏业务台账组;对账裁剪为两组
引擎/规则/凭证/账簿/报表/结账 完全相同 完全相同

二、系统全貌

flowchart LR
  A["① 业务发生<br/>合同·验收·报销·收付款·出库·薪资"] --> B["② 票据与资金<br/>发票·流水·票据池(证据)"]
  B --> C["③ 会计确认<br/>事项·规则·异常"]
  A --> C
  C --> D["④ 凭证与账簿<br/>待审核→审核→入账"]
  D --> E["⑤ 对账与结账<br/>业财对账→期末结账→正式报表"]

一句话流程:业务发生 → 票据/事件进入 → 会计确认(防重+条件判断)→ 生成凭证 → 人工复核入账 → 账簿报表 → 对账结账锁期。侧边栏即此流水线(①~⑦)。

三、交付现状(截至 2026-10-09)

交付物 数量 状态
可交互原型 41 页 完整度 A 17 / B 16 / C 8(核算主线全部 A 级,即可开发验收基准);导航已按流水线重排
文档 18 份 现行 17 + 历史 1(见《交付物总清单.md》)
会计规则 41 条 已发布 33 / 测试 4 / 草稿 4;覆盖度看板已入原型
验收用例 154 条 十八组 + 12 条★回归集;规则覆盖矩阵 41/41 无死角
事件契约 19 类 含各事件 payload 字段表(事项目录)
基线数据 1 套 长沙宏达贸易 2026-06:期初 726,240.50、14 张凭证、净利 6,500,全站勾稽一致

完成度判断:原型层 ✅ 完成(41 页可点、数据全咬合);文档层大部 ✅(需求/技术/规则/事项/用例/排期/指南齐备,剩 3 份补充文档);开发待启动(起点为 D1~D9 决策会)。

四、怎么用这套资料

你是 从这里开始
管理者/新成员 本文 → 《交付物总清单.md》
开发 《财务模块开发指南.md》→《会计事项目录.md》→《自动记账技术方案.md》→ 按《页面原型完整度清单.md》找自己的页面
产品/财务 《业财一体化财务核算需求文档.md》→《会计规则目录.md》
测试 《验收测试用例库.md》(★ 详版为回归集)
项目管理 《自动记账任务清单.md》→《页面原型完整度清单.md》(补全优先级)
所有人 起本地服务打开原型(python3 -m http.server 8731)——交互即答案

建议动手体验路径(10 分钟走完一天的工作):

财务仪表盘 → 事项工作台(复核一条收入确认)→ 票据池(导入票/生成凭证)
→ 记账管理(审核→入账→冲销)→ 账簿查询(看余额)→ 业财对账(看差异)→ 期末结账(一键锁定)

五、起点与下一步

当前起点:D1~D9 决策会(每项已给建议默认值,照默认走最快)
   ↓
文档收尾 3 份:API 字段级契约(OpenAPI)/ 报表取数公式表 / 状态·权限·编号规范
   ↓
开发迭代:迭代1 基础设施(事件层+事项中心)→ 迭代2 三条闭环 → 迭代3 凭据与异常 → 迭代4 对账与灰度

六、关键约定(红线速记)

  1. 业务审批 ≠ 会计确认 ≠ 入账——三关独立;只有"已记账"凭证进账簿;
  2. 制单人不可自审;AI 生成凭证强制人工审核;
  3. 未匹配收款禁止默认认收入;票据待补证后方可确认;
  4. 结转损益由系统强制生成、禁止手工录入;
  5. 试算平衡 = 0 是结账硬门槛;已记账凭证只可冲销不可删改;
  6. 双模式(业财一体 / 纯记账)同一引擎、数据同构、可升降级。