# 飞书审批录入模型（自建系统作为唯一数据源）

用户确认方向：后续不再从飞书多维表格拉数据。飞书多维表不是事实源；事实源改为自建 Node/PostgreSQL 财务系统。飞书审批只负责“谁提交、谁审批、审批结果、附件和表单字段”，审批通过后通过回调写入自建系统。

## 总原则

1. **审批是入口，不是账本**：审批通过才生成本地财务入账指令。
2. **本地数据库是账本**：看板、导出、月结、余额全部从自建系统数据库计算。
3. **前端页面尽量少**：只做查询、看板、修正/补录的轻页面；高频录入走飞书审批。
4. **代码固定口径**：财务算法仍由 `packages/core/src/finance-engine.ts` 固定，不依赖飞书表格公式。

## 需要的 6 类审批模板

| 模板代码 | 模板名称 | 用途 | 通过后写入 |
|---|---|---|---|
| `FIN_PROJECT_CONTRACT` | 财务-项目/合同建档审批 | 新项目、合同、报价建档 | Project、ProfitAllocationRule |
| `FIN_INCOME_RECEIPT` | 财务-收入/收款确认审批 | 收入确认、收款入账 | Project、IncomeItem、CashFlow |
| `FIN_EXPENSE_PAYMENT` | 财务-支出/付款审批 | 供应商、税费、人工、办公、AI工具等付款 | Project、EquityAccount、ExpenseItem、CashFlow |
| `FIN_REIMBURSEMENT` | 财务-报销审批 | 员工/项目组/公共费用报销 | ReimbursementOrder、ExpenseItem、CashFlow |
| `FIN_INTERNAL_ADJUSTMENT` | 财务-内部调整审批 | 权益账户调整、历史余额修正、非现金内部结转 | EquityAccount、InternalAdjustment |
| `FIN_ALLOCATION_RULE` | 财务-利润分配规则审批 | 某项目的固定金额/百分比/手动调整规则 | Project、EquityAccount、ProfitAllocationRule |

## 字段清单来源

审批字段规格已固化在代码：

```text
packages/core/src/approval-templates.ts
```

审批通过后的映射逻辑已固化在代码：

```text
packages/core/src/approval-callback.ts
```

生成的飞书定义草稿在：

```text
integrations/feishu/approval-template-drafts/*.json
```

## 不建议放进审批的内容

- 月度看板计算结果：本地系统计算。
- 权益账户余额：本地系统计算。
- 资金账户系统余额：本地系统计算。
- Excel 导出公式：导出器生成。
- 大量明细批量导入：后续可以做 CSV/Excel 导入入口，但仍写入本地系统，不从飞书多维表反拉。