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
启动
# 确保已在根目录执行 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 数据查询接口（助教业绩、财务日报等）