PartsInquiry/doc/admin_development.md

管理端开发文档

本文档用于同步当前管理端（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，避免完全信任请求头。

五、环境与运行

• 开发：

  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：

  cd admin; npm i; $env:VITE_USE_MOCK="true"; npm run dev
  

• 构建/预览：

  npm run build; npm run preview