37 lines
1.0 KiB
Markdown
37 lines
1.0 KiB
Markdown
# 后台 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"
|
|
```
|