# WonderQ 开发状态矩阵

本文档记录三端当前对接范围，不替代实际构建、测试和联调结果。

| 能力 | 后端 | 管理前端 | MiniAPP | 入口 |
| --- | --- | --- | --- | --- |
| 健康检查 | 已覆盖 | 需实测 | 需实测 | `GET /health` |
| Public 站点配置 | 已覆盖 | 不直接使用 | 当前使用 | `GET /api/public/site-config` |
| Public 线索提交 | 已覆盖 | 不直接使用 | 当前使用 | `POST /api/public/leads` |
| Public 客户登录 | 已覆盖 | 不使用 | 当前使用 | `/api/public/auth/*` |
| Admin 登录 | 已覆盖 | 当前使用 | 不使用 | `POST /api/admin/auth/login` |
| Admin 站点配置 | 已覆盖 | 当前使用 | 不使用 | `GET /api/admin/site-config` |
| 页面模块 CRUD | 已覆盖 | 当前使用 | 不使用 | `module-config-api.md` |
| Admin 线索跟进 | 已覆盖 | 当前使用 | 不使用 | `/api/admin/leads` |
| 媒体上传 | 已覆盖 | 当前使用 | 不使用 | `/api/admin/media-assets/upload` |
| 发布站点配置 | 已覆盖 | 当前使用 | 不使用 | `POST /api/admin/publish` |
| 贵州内容重置 | 已覆盖 | 当前使用 | 不使用 | `POST /api/admin/reset-guizhou-content` |

## 当前页面联调路径

1. 后端启动后检查 `/health` 和 `/api/public/site-config`。
2. Admin UI 登录并读取站点配置。
3. 在首页、玩法页和需求页模块中新增、编辑、删除、排序或启停配置。
4. MiniAPP 启动并验证首页、玩法、需求和我的页面。
5. MiniAPP 提交线索，Admin UI 在“需求线索”中查询并更新状态。
6. Admin UI 发布站点配置，MiniAPP 刷新后验证启用内容。

## 验证命令

```powershell
Set-Location D:\www\znkj\WonderQ-Project\WonderQ-Admin
.\.venv\Scripts\python.exe -m pytest
```

```powershell
Set-Location D:\www\znkj\WonderQ-Project\WonderQ-Admin-UI
yarn build
```

```powershell
Set-Location D:\www\znkj\WonderQ-Project\WonderQ-MiniAPP
yarn test
yarn build:h5
yarn build:mp-weixin
```

## 本次领域清理

- MiniAPP 只保留站点内容、需求提交和客户登录相关逻辑。
- Public API 只保留 `site-config`、登录、客户和线索接口。
- Admin UI 只保留站点结构、素材、发布和线索管理入口。
- 后端通过 `0009_remove_product_domain` 迁移移除已退役表、关联表以及线索和订单中的旧外键列。
- 后端通过 `0010_remove_destination_module` 迁移移除省内目的地及别名表。
- 后端通过 `0012_remove_offer_modules` 迁移移除特价优惠、特色酒店及相关表。
- 后端通过 `0013_remove_map_theme_modules` 迁移移除贵州地图和主题甄选相关表。
- 未执行现有数据库的破坏性迁移；部署时应先备份，再按迁移流程执行。