# 财务模块 · 项目说明

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

---

## 一、这是什么

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

- **目标形态「业财一体」**：业务单据（合同履约 / 验收 / 报销 / 收付款 / 出库 / 薪资…）自动流转为**会计事项**→按**规则**生成**凭证**→复核入账→账簿报表，财务日常只做"复核"；
- **兼容形态「纯记账」**：不使用业务模块的客户，**导入票据与流水即可做账**（建账 → 导入 → 自动生成 → 复核 → 出表），等价于传统财务软件的用法。

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

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

## 二、系统全貌

```mermaid
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. 双模式（业财一体 / 纯记账）**同一引擎、数据同构、可升降级**。