Files
PartsInquiry/admin/README.md
2025-09-24 20:35:15 +08:00

1.5 KiB
Raw Blame History

配件管家 · 管理端(前端)

仅前端实现,基于 Vue3 + Vite + Element Plus。严禁硬编码API 地址、ShopId 等来自环境变量。

开发

cd admin; npm i; npm run dev
  • 默认端口5173
  • 环境变量:在系统环境或命令行注入
    • VITE_APP_API_BASE_URL(必填)
    • VITE_APP_SHOP_ID(默认 1

示例Windows PowerShell 临时设置):

$env:VITE_APP_API_BASE_URL="http://127.0.0.1:8080"; $env:VITE_APP_SHOP_ID="1"; npm run dev

构建

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仅前端调试

  • 启用:
    $env:VITE_USE_MOCK="true"; npm run dev
    
  • 行为:直接请求 public/mock/*.json 静态文件(例如:/mock/admin_vips_reviews.json)。
  • 关闭:不设置 VITE_USE_MOCK 或设为 false 即走真实后端。