# Implementation Plan: Admin Frontend Migration

## Overview

本实现计划将后台管理系统的业务模块前端页面迁移到 Vue 3 + Element Plus 项目中。按照 API 服务层 → 页面组件 → 路由配置的顺序进行实现。

## Tasks

- [ ] 1. 创建业务模块 API 服务层
  - [ ] 1.1 创建仪表盘 API (`src/api/dashboard.ts`)
    - 实现 getDashboardOverview、getAdAccounts、createAdAccount、deleteAdAccount 函数
    - _Requirements: 1.1, 1.2, 1.3_
  - [ ] 1.2 创建用户管理 API (`src/api/user.ts`)
    - 实现用户列表、详情、资金变动、状态管理、赠送等接口
    - _Requirements: 2.1, 2.2, 2.3, 2.4, 2.5, 2.6, 2.7, 2.8, 2.9_
  - [ ] 1.3 创建 VIP 管理 API (`src/api/vip.ts`)
    - 实现 VIP 等级列表、编辑接口
    - _Requirements: 3.1, 3.2, 3.3_
  - [ ] 1.4 创建商品管理 API (`src/api/goods.ts`)
    - 实现商品列表、详情、增删改、状态管理、奖品管理接口
    - _Requirements: 4.1, 4.2, 4.3, 4.4, 4.5, 4.6, 4.7_
  - [ ] 1.5 创建商品类型 API (`src/api/goodsType.ts`)
    - 实现商品类型列表、增删改接口
    - _Requirements: 5.1, 5.2, 5.3_
  - [ ] 1.6 创建订单管理 API (`src/api/order.ts`)
    - 实现订单列表、详情、卡单、兑换、发货、导出接口
    - _Requirements: 6.1, 6.2, 6.3, 6.4, 6.5, 6.6, 6.7_
  - [ ] 1.7 创建财务管理 API (`src/api/finance.ts`)
    - 实现消费排行、余额/积分/钻石明细、充值记录接口
    - _Requirements: 7.1, 7.2, 7.3, 7.4, 7.5_
  - [ ] 1.8 创建系统配置 API (`src/api/config.ts`)
    - 实现配置分组列表、配置项获取、配置保存接口
    - _Requirements: 8.1, 8.2, 8.3_
  - [ ] 1.9 编写 API 服务层属性测试
    - **Property 3: 请求拦截器Token注入**
    - **Property 5: 错误响应处理**
    - **Validates: Requirements 10.3, 10.4, 1.4**

- [ ] 2. 升级仪表盘页面
  - [ ] 2.1 升级仪表盘页面 (`src/views/dashboard/index.vue`)
    - 显示业务数据概览（今日注册、消费、订单等）
    - 添加广告账户管理功能
    - _Requirements: 1.1, 1.2, 1.3, 1.4_

- [ ] 3. 实现用户管理模块
  - [ ] 3.1 创建用户列表页面 (`src/views/business/user/index.vue`)
    - 实现分页列表、搜索筛选、操作按钮
    - _Requirements: 2.1_
  - [ ] 3.2 创建用户详情页面 (`src/views/business/user/detail.vue`)
    - 显示用户基本信息、账户信息、统计数据
    - _Requirements: 2.2, 2.8, 2.9_
  - [ ] 3.3 实现用户操作功能
    - 资金变动对话框、封号/解封、测试账号、清空绑定、赠送功能
    - _Requirements: 2.3, 2.4, 2.5, 2.6, 2.7_
  - [ ] 3.4 编写用户管理页面属性测试
    - **Property 1: 列表分页数据一致性**
    - **Validates: Requirements 2.1**

- [ ] 4. 实现 VIP 管理模块
  - [ ] 4.1 创建 VIP 管理页面 (`src/views/business/vip/index.vue`)
    - 实现 VIP 等级列表、编辑对话框
    - _Requirements: 3.1, 3.2, 3.3_

- [ ] 5. 实现商品管理模块
  - [ ] 5.1 创建商品列表页面 (`src/views/business/goods/index.vue`)
    - 实现分页列表、搜索筛选、上架/下架操作
    - _Requirements: 4.1, 4.5_
  - [ ] 5.2 创建商品编辑页面 (`src/views/business/goods/edit.vue`)
    - 实现新增/编辑表单、图片上传
    - _Requirements: 4.2, 4.3, 4.4_
  - [ ] 5.3 创建奖品管理组件 (`src/views/business/goods/components/PrizeList.vue`)
    - 实现奖品列表、添加/编辑/删除奖品
    - _Requirements: 4.6, 4.7_
  - [ ] 5.4 编写商品管理页面属性测试
    - **Property 1: 列表分页数据一致性**
    - **Validates: Requirements 4.1**

- [ ] 6. 实现商品类型管理模块
  - [ ] 6.1 创建商品类型页面 (`src/views/business/goodsType/index.vue`)
    - 实现类型列表、新增/编辑对话框
    - _Requirements: 5.1, 5.2, 5.3_

- [ ] 7. 实现订单管理模块
  - [ ] 7.1 创建订单列表页面 (`src/views/business/order/index.vue`)
    - 实现分页列表、搜索筛选、Tab 切换（全部/卡单/兑换）
    - _Requirements: 6.1, 6.3, 6.4_
  - [ ] 7.2 创建订单详情页面 (`src/views/business/order/detail.vue`)
    - 显示订单信息、奖品明细
    - _Requirements: 6.2_
  - [ ] 7.3 创建发货管理页面 (`src/views/business/order/shipping.vue`)
    - 实现发货订单列表、发货对话框
    - _Requirements: 6.5, 6.6_
  - [ ] 7.4 实现订单导出功能
    - 导出按钮、下载 CSV 文件
    - _Requirements: 6.7_
  - [ ] 7.5 编写订单管理页面属性测试
    - **Property 1: 列表分页数据一致性**
    - **Validates: Requirements 6.1**

- [ ] 8. 实现财务管理模块
  - [ ] 8.1 创建消费排行页面 (`src/views/business/finance/ranking.vue`)
    - 实现消费排行榜列表
    - _Requirements: 7.1_
  - [ ] 8.2 创建余额明细页面 (`src/views/business/finance/money.vue`)
    - 实现余额变动记录列表
    - _Requirements: 7.2_
  - [ ] 8.3 创建积分明细页面 (`src/views/business/finance/integral.vue`)
    - 实现积分变动记录列表
    - _Requirements: 7.3_
  - [ ] 8.4 创建钻石明细页面 (`src/views/business/finance/diamond.vue`)
    - 实现钻石变动记录列表
    - _Requirements: 7.4_
  - [ ] 8.5 创建充值记录页面 (`src/views/business/finance/recharge.vue`)
    - 实现充值记录列表
    - _Requirements: 7.5_

- [ ] 9. 实现系统配置模块
  - [ ] 9.1 创建系统配置页面 (`src/views/business/config/index.vue`)
    - 实现配置分组 Tab、配置项表单、保存功能
    - _Requirements: 8.1, 8.2, 8.3_
  - [ ] 9.2 编写配置页面属性测试
    - **Property 4: 配置项类型渲染**
    - **Validates: Requirements 8.4**

- [ ] 10. 配置路由和导航
  - [ ] 10.1 添加业务模块路由配置
    - 在 router/index.ts 中添加业务模块路由
    - _Requirements: 9.1, 9.3_
  - [ ] 10.2 编写路由权限属性测试
    - **Property 2: 动态菜单权限过滤**
    - **Validates: Requirements 9.2, 9.4**

- [ ] 11. Checkpoint - 功能验证
  - 确保所有页面正常渲染
  - 确保 API 调用正常
  - 确保权限控制正常
  - 如有问题请询问用户

## Notes

- 所有任务都必须执行，包括测试任务
- 每个任务引用了具体的需求条款以便追溯
- 属性测试验证通用的正确性属性
- 建议按顺序执行，API 层先于页面组件