财务模块 · 项目说明
这是认识本项目的第一份文档——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 对账与灰度
六、关键约定(红线速记)
- 业务审批 ≠ 会计确认 ≠ 入账——三关独立;只有"已记账"凭证进账簿;
- 制单人不可自审;AI 生成凭证强制人工审核;
- 未匹配收款禁止默认认收入;票据待补证后方可确认;
- 结转损益由系统强制生成、禁止手工录入;
- 试算平衡 = 0 是结账硬门槛;已记账凭证只可冲销不可删改;
- 双模式(业财一体 / 纯记账)同一引擎、数据同构、可升降级。