# AI+合规智能中枢后端

`backend` 是当前正式使用的 FastAPI 后端目录，入口为 `app.main:app`。

## 启动

```bash
pip install -r backend/requirements.txt
PYTHONPATH=backend uvicorn app.main:app --host 0.0.0.0 --port 8000 --reload
```

也可以直接使用根目录统一脚本：

```bash
./dev.sh start api --foreground
```

## 主要接口

- `GET /health`
- `GET /`
- `POST /api/v1/documents/upload`
- `GET /api/v1/documents/list`
- `GET /api/v1/documents/management-list`
- `GET /api/v1/documents/download/{doc_id}`
- `POST /api/v1/knowledge/search`
- `POST /api/v1/knowledge/retrieval`
- `POST /api/v1/agent/ask`
- `POST /api/v1/agent/chat`
- `GET /api/v1/agent/chat/stream`

## 目录说明

```text
backend/
├── app/
│   ├── api/          # FastAPI 路由与模型
│   ├── config/       # 配置与日志
│   ├── services/     # 文档处理、LLM、RAG、存储
│   └── workers/      # 任务相关代码
├── .env.example
├── requirements.txt
└── main.py
```

## 说明

- 路由前缀保持为 `/api/v1`，以兼容当前前端。
- 原 `backend/app/api/routes/docs.py`、`rag.py`、`compliance.py`、`status.py` 仍保留在仓库中，但不再作为主路由入口。