1

doc/admin_development.md

@@ -0,0 +1,59 @@
+# 管理端开发文档
+
+本文档用于同步当前管理端（admin/）前端与数据库的开发状态与下一步计划。
+
+## 一、前端（admin/）
+- 技术栈：Vue3 + Vite + Element Plus
+- 主题：深色尊贵风格，数据展示面板/卡片/表格采用深蓝背景；Tag 颜色整体降亮。
+- 路由与页面：
+  - `/vip-review`：VIP审核（默认页，卡片式，一卡一申请）
+  - `/vip`：VIP管理（是否VIP、到期时间、启用/停用）
+  - `/users`：用户管理（拉黑/恢复，状态文案“正常/黑名单”）
+  - `/parts`：用户配件管理（拉黑/恢复）
+  - `/consult`：咨询回复（回复/标记解决，标记后行内即时显示“已解决”）
+- Mock 数据：
+  - 开启：`VITE_USE_MOCK=true`；使用 `public/mock/*.json`
+  - 覆盖：`admin_vips.json`、`admin_vips_reviews.json`、`admin_users.json`、`admin_parts.json`、`admin_consults.json`
+- 状态：
+  - 页面与交互：已完成
+  - 主题色与降亮：已完成
+  - Mock：已完成
+
+## 二、数据库（DB）
+- 已有与复用
+  - `users.status`：1=正常、0=黑名单（供用户管理拉黑/恢复）
+  - `global_skus`：公共SKU库（供未来配件审核通过后发布使用）
+- 新增表
+  - `vip_users`：管理VIP（is_vip/status/expire_at/reviewer_id/reviewed_at/remark）
+  - `consults`、`consult_replies`：咨询与回复
+- 字段与索引改动
+  - `products.is_blacklisted TINYINT(1) NOT NULL DEFAULT 0`（黑名单标记）
+  - 索引：`idx_products_shop_blacklist (shop_id, is_blacklisted)`
+- 文档：`doc/database_documentation.md` 已同步
+
+## 三、API 规范（OpenAPI）
+- 已补充
+  - 管理端VIP：`/api/admin/vips` 列表/创建/更新/审核通过/驳回（标注“❌ Partially Implemented”）
+- 待补充
+  - 管理端用户：列表（kw）、更新（status 拉黑/恢复）
+  - 管理端用户配件：列表（kw/status）、黑名单/恢复（更新 `products.is_blacklisted`）
+  - 管理端咨询：列表（status/kw）、回复、标记解决
+
+## 四、落地与联调建议
+- 后端接口：按上述待补充接口实现，完成后将 OpenAPI 的相应条目更新为“✅ Fully Implemented”。
+- 前台/小程序：默认过滤 `products.is_blacklisted=0`，防止黑名单配件外显。
+- 安全收口：后端增加 JWT 校验，从 Token 注入 `shopId/userId`，避免完全信任请求头。
+
+## 五、环境与运行
+- 开发：
+  ```powershell
+  cd admin; npm i; $env:VITE_APP_API_BASE_URL="http://127.0.0.1:8080"; $env:VITE_APP_SHOP_ID="1"; npm run dev
+  ```
+- Mock：
+  ```powershell
+  cd admin; npm i; $env:VITE_USE_MOCK="true"; npm run dev
+  ```
+- 构建/预览：
+  ```powershell
+  npm run build; npm run preview
+  ```