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

启动

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