1

admin/README.md

@@ -0,0 +1,46 @@
+# 配件管家 · 管理端（前端）
+
+仅前端实现，基于 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` 即走真实后端。