WonderQ-Project/docs/backend-api-service.md

后台 API 服务

WonderQ-Admin 当前是独立的 Python + FastAPI API 服务，使用 PostgreSQL 保存业务数据，通过 Docker Compose 启动 api、postgres 和 redis。

本地 API 启动

从 WonderQ-Project 根目录启动时，先确认 Docker Desktop 已运行，再进入后端目录：

Set-Location .\WonderQ-Admin
.\.venv\Scripts\Activate.ps1
docker-compose up -d postgres redis
python -m alembic upgrade head
python -m uvicorn app.main:app --host 0.0.0.0 --port 4000 --reload

首次缺少虚拟环境或依赖时再执行：

Set-Location .\WonderQ-Admin
python -m venv .venv
.\.venv\Scripts\Activate.ps1
python -m pip install -r requirements.txt
python -m alembic upgrade head
python -m app.seed --no-reset

健康检查：http://localhost:4000/health

前端联调

后台管理前端位于 D:\www\znkj\WonderQ-Project\WonderQ-Admin-UI。如需连接本服务，在前端 .env 或环境变量中配置：

VITE_API_BASE_URL="http://localhost:4000"