# 后台 API 服务

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

## 本地 API 启动

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

```powershell
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
```

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

```powershell
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` 或环境变量中配置：

```text
VITE_API_BASE_URL="http://localhost:4000"
```