财务 AI 助手（S2F）

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

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

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

项目边界

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

技术栈

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

目录结构

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 为准。

docker-compose up -d

开发顺序

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

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