# 财务 AI 助手（S2F）

面向金蝶中小企业客户的财务 AI 助手。

当前第一模块为 **薪财通 AI / 薪酬财务对账 MVP**，先通过 Excel 上传与导出完成闭环：

```text
上传工资/社保/个税表
  ↓
AI 字段识别与用户确认
  ↓
薪酬、社保、个税、公积金对账
  ↓
异常清单与人工成本分析
  ↓
导出金蝶凭证模板
```

## 项目边界

- 不替代金蝶账套。
- 不做完整财务软件。
- 不做完整 HR SaaS。
- 第一阶段只实现薪酬财务对账 MVP。
- 发票报销、预算执行、现金流异常、往来对账、经营分析属于后续财务 AI 助手模块。

## 技术栈

| 层级 | 技术 |
|---|---|
| 前端 | Next.js + TypeScript + Tailwind CSS + Shadcn/ui |
| 后端 | Python FastAPI + Pydantic |
| 数据库 | PostgreSQL |
| 部署 | Docker + Docker Compose |

## 目录结构

```text
s2f/
├── frontend/          # Next.js 前端
├── backend/           # FastAPI 后端
├── pmdocs/            # 需求、PRD、任务文档
├── docs/              # 产品方向与痛点材料
├── cursor-rules/      # Cursor 规则材料
├── docker-compose.yml # 本地与私有化部署编排
├── run.md             # 运行手册
└── README.md
```

## 文档入口

- 需求文档：`pmdocs/0-req-S2F.md`
- PRD 文档：`pmdocs/1-prd-S2F.md`
- 任务文档：`pmdocs/2-task-S2F.md`
- 运行手册：`run.md`

## 本地启动

当前处于项目初始化阶段。完整启动方式以后续 `run.md` 和 `docker-compose.yml` 为准。

```bash
docker-compose up -d
```

## 开发顺序

按 `pmdocs/2-task-S2F.md` 执行：

1. 项目初始化
2. 后端基础设施
3. 前端基础设施
4. 认证与权限
5. 文件上传与解析
6. AI 字段识别
7. 对账与异常检测
8. 人工成本分析
9. 凭证生成
10. UI 与页面开发
11. 测试、部署与文档