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

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

## 本地启动

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

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

```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`

## 测试

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

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