chore: 初始化项目与后端基础工程
This commit is contained in:
@@ -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. 测试、部署与文档
|
||||
Reference in New Issue
Block a user