finai/backend/README.md

财务大模型智能问答客服系统后端

Python FastAPI 后端首版 MVP，生产目标数据库为 PostgreSQL，当前 ADP、SMS、文件存储均通过可替换集成层提供 mock 实现。

本地启动

cd code/backend
python -m uvicorn app.main:app --reload --port 8000

默认会使用 sqlite:///./finance_ai.db。生产环境请复制 .env.example 为 .env，并配置：

DATABASE_URL=postgresql+psycopg://finai:finai@127.0.0.1:5432/finai
JWT_SECRET_KEY=replace-with-secret

默认账号

启动时自动创建默认系统管理员：

• 手机号：13800000000
• Mock 验证码：123456

已实现接口

• GET /health
• POST /api/auth/sms-code
• POST /api/auth/login
• GET /api/auth/me
• POST /api/auth/logout
• GET/POST/PATCH /api/users
• GET/POST/PATCH/DELETE /api/documents
• POST /api/documents/{id}/retry-parse
• GET/POST /api/chat/sessions
• GET /api/chat/sessions/{id}/messages
• POST /api/chat/stream
• POST /api/chat/upload-image
• POST /api/chat/messages/{id}/feedback
• GET /api/audit-logs
• GET /api/stats/overview

测试

cd code/backend
python -m unittest discover -s tests -p "test_*.py"

测试使用临时 SQLite 数据库，不需要 PostgreSQL。