1|# 公司财务管理平台（本地实现草案）
     2|
     3|目标：把现有 Excel/飞书多维表的财务口径固定到 Node/TypeScript 代码层，并保留按原 Excel 格式导出的能力。
     4|
     5|当前范围：本地项目，不部署、不改云端数据库、不写飞书业务数据。
     6|
     7|## 已纳入的核心口径
     8|
     9|1. 项目可分配利润 = 项目收入 - 项目支出 - 项目第三方成本。
    10|2. 利润分配明细按规则生成：固定金额、百分比、手动调整；支持公共账户标记。
    11|3. 权益账户余额 = 期初余额 + 分配收入 + 内部调整收入 - 工资成本 - 报销支出 - 其他支出。
    12|4. 资金账户系统余额 = 期初余额 + 收入合计 - 支出合计。
    13|5. 导出层保留原表的主要 sheet 名称、月份横向结构、行项目结构和 Excel 公式生成方式。
    14|
    15|## 项目结构
    16|
    17|```text
    18|packages/core      财务算法、领域模型、测试
    19|packages/exporter  Excel 导出器，生成与原表同口径格式的工作簿
    20|apps/api           后续 Node API 入口
    21|prisma             后续 PostgreSQL 数据模型
    22|source             用户原始 Excel 参考文件副本
    23|```
    24|
    25|## 本地命令
    26|
    27|```bash
    28|npm install
    29|npm test
    30|npm run typecheck
    31|```
    32|
    33|


## 飞书审批作为录入入口

本项目后续不再从飞书多维表格拉取数据。录入入口改为飞书审批，审批通过后由回调写入本地 PostgreSQL。

已定义 6 个审批模板：

1. 财务-项目/合同建档审批
2. 财务-收入/收款确认审批
3. 财务-支出/付款审批
4. 财务-报销审批
5. 财务-内部调整审批
6. 财务-利润分配规则审批

关键文件：

```text
packages/core/src/approval-templates.ts
packages/core/src/approval-callback.ts
integrations/feishu/approval-template-drafts/
docs/APPROVAL_INPUT_MODEL.md
docs/FEISHU_APPROVAL_CALLBACK_DESIGN.md
docs/FRONTEND_AND_DASHBOARD_STRATEGY.md
```