43 lines
1.2 KiB
Markdown
43 lines
1.2 KiB
Markdown
# apps/backend - FastAPI 后端
|
||
|
||
为微信小程序提供 RESTful API，连接 zqyy_app 业务数据库，通过 FDW 只读访问 ETL 数据。
|
||
|
||
## 内部结构
|
||
|
||
```
|
||
apps/backend/
|
||
├── app/
|
||
│ ├── main.py # FastAPI 入口，启用 OpenAPI 文档
|
||
│ ├── config.py # 配置加载
|
||
│ ├── database.py # zqyy_app 数据库连接
|
||
│ ├── routers/ # 路由模块
|
||
│ ├── middleware/ # 中间件（鉴权、日志等）
|
||
│ └── schemas/ # Pydantic 请求/响应模型
|
||
├── tests/ # 后端测试
|
||
├── pyproject.toml # 依赖声明
|
||
└── README.md
|
||
```
|
||
|
||
## 启动
|
||
|
||
```bash
|
||
# 确保已在根目录执行 uv sync --all-packages
|
||
cd apps/backend
|
||
uv run uvicorn app.main:app --host 127.0.0.1 --port 8000 --reload
|
||
```
|
||
|
||
API 文档自动生成于 http://localhost:8000/docs
|
||
|
||
## 依赖
|
||
|
||
- fastapi>=0.115, uvicorn[standard]>=0.34
|
||
- psycopg2-binary>=2.9, python-dotenv>=1.0
|
||
- neozqyy-shared（workspace 引用）
|
||
|
||
## Roadmap
|
||
|
||
- [ ] 用户管理与微信登录
|
||
- [ ] RBAC 权限中间件
|
||
- [ ] 任务审批流 API
|
||
- [ ] FDW 数据查询接口（助教业绩、财务日报等）
|