chore: 初始化项目与后端基础工程

This commit is contained in:
freedakgmail
2026-07-06 22:03:22 +08:00
commit 6833106829
34 changed files with 8398 additions and 0 deletions
+79
View File
@@ -0,0 +1,79 @@
# 财务 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. 测试、部署与文档