47 lines
1.5 KiB
Markdown
47 lines
1.5 KiB
Markdown
# 配件管家 · 管理端（前端）
|
||
|
||
仅前端实现，基于 Vue3 + Vite + Element Plus。严禁硬编码：API 地址、ShopId 等来自环境变量。
|
||
|
||
## 开发
|
||
|
||
```powershell
|
||
cd admin; npm i; npm run dev
|
||
```
|
||
|
||
- 默认端口：5173
|
||
- 环境变量：在系统环境或命令行注入
|
||
- `VITE_APP_API_BASE_URL`（必填）
|
||
- `VITE_APP_SHOP_ID`（默认 1）
|
||
|
||
示例（Windows PowerShell 临时设置）：
|
||
```powershell
|
||
$env:VITE_APP_API_BASE_URL="http://127.0.0.1:8080"; $env:VITE_APP_SHOP_ID="1"; npm run dev
|
||
```
|
||
|
||
## 构建
|
||
```powershell
|
||
npm run build; npm run preview
|
||
```
|
||
|
||
## 路由
|
||
- /vip: VIP 管理
|
||
- /users: 用户管理
|
||
- /parts: 用户配件管理
|
||
- /consult: 咨询回复
|
||
|
||
## 接口依赖（需后端提供）
|
||
- VIP: GET /api/admin/vips, POST /api/admin/vips, PUT /api/admin/vips/{id}
|
||
- 用户: GET /api/admin/users, PUT /api/admin/users/{id}
|
||
- 配件: GET /api/admin/parts, PUT /api/admin/parts/{id}, PUT /api/admin/parts/{id}/approve, PUT /api/admin/parts/{id}/reject
|
||
- 咨询: GET /api/admin/consults, POST /api/admin/consults/{id}/reply, PUT /api/admin/consults/{id}/resolve
|
||
|
||
> 按项目规则，接口定义需添加到 /doc/openapi.yaml 并标注“❌ Partially Implemented”。
|
||
|
||
## 本地 Mock（仅前端调试）
|
||
- 启用：
|
||
```powershell
|
||
$env:VITE_USE_MOCK="true"; npm run dev
|
||
```
|
||
- 行为：直接请求 `public/mock/*.json` 静态文件（例如：`/mock/admin_vips_reviews.json`）。
|
||
- 关闭：不设置 `VITE_USE_MOCK` 或设为 `false` 即走真实后端。
|