freedakgmail
33b4c734aa
后端: - 新增认证(auth)、任务(tasks)、映射(mappings)、对账(reconciliation)、异常(exceptions)、导出(exports) API - 新增核心模块: database, security, permissions, tenant, exceptions, error_handlers - 新增数据模型: user, company, reconciliation_task, field_mapping, uploaded_file 等 - 新增服务层: ai_recognizer, file_parser, file_storage, mapping, reconciliation 等 - 添加数据库迁移脚本 前端: - 新增登录页面和仪表盘页面 - 新增任务列表、任务详情、字段映射页面 - 新增异常处理页面和规则设置页面 - 新增 API 代理路由 /api/[...path] - 新增 UI 组件库 (button, card, dialog, input, table 等) - 新增 auth 组件 (ProtectedRoute, PermissionGate) - 新增 layout 组件 (Header, Sidebar) - 新增 mapping 组件 (FieldMappingTable, AISuggestionPanel) - 新增 API 客户端和 hooks (useAsync, useToast, usePermission 等) - 新增状态管理 (auth-store, company-store, ui-store) - 集成 Tailwind CSS 和 shadcn/ui 组件库 其他: - 添加 Alembic 数据库迁移配置 - 添加初始化示例数据脚本 - 更新项目文档
财务 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 执行：
- 项目初始化
- 后端基础设施
- 前端基础设施
- 认证与权限
- 文件上传与解析
- AI 字段识别
- 对账与异常检测
- 人工成本分析
- 凭证生成
- UI 与页面开发
- 测试、部署与文档