Neo-ZQYY/apps/backend/README.md

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

启动

ash cd apps/backend uvicorn app.main:app --reload

API 文档自动生成于 http://localhost:8000/docs

依赖

• fastapi>=0.100, uvicorn>=0.23
• psycopg2-binary>=2.9.0
• neozqyy-shared（workspace 引用）

Roadmap

• 用户管理与微信登录
• RBAC 权限中间件
• 任务审批流 API
• FDW 数据查询接口（助教业绩、财务日报等）