# 管理端开发文档

本文档用于同步当前管理端（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
  ```