439 lines
13 KiB
Markdown
439 lines
13 KiB
Markdown
# HoneyBox 后台管理系统 - 迁移批次规划
|
||
|
||
## 概述
|
||
|
||
本文档基于 `后台管理系统-功能分析清单.md` 的详细分析，将后台管理系统的34个模块按照业务优先级、技术依赖关系和复杂度进行分批迁移规划。
|
||
|
||
## 迁移现状
|
||
|
||
### 已完成的后端迁移（HoneyBox.Admin.Business）
|
||
|
||
| 模块 | 状态 | 说明 |
|
||
|------|------|------|
|
||
| 系统配置 (Config) | ✅ 已完成 | ConfigController, ConfigService |
|
||
| 用户管理 (User) | ✅ 已完成 | UserController, UserBusinessService |
|
||
| VIP管理 | ✅ 已完成 | VipController |
|
||
| 商品管理 (Goods) | ✅ 已完成 | GoodsController, GoodsService |
|
||
| 奖品管理 (Prizes) | ✅ 已完成 | PrizesController |
|
||
| 订单管理 (Order) | ✅ 已完成 | OrderController, OrderService |
|
||
| 财务管理 (Finance) | ✅ 已完成 | FinanceController, FinanceService |
|
||
| 仪表盘 (Dashboard) | ✅ 已完成 | DashboardController, DashboardService |
|
||
|
||
### 待迁移的前端页面
|
||
|
||
前端迁移计划已在 `.kiro/specs/admin-frontend-migration/` 中定义，但尚未开始执行。
|
||
|
||
---
|
||
|
||
## 迁移批次规划
|
||
|
||
### 批次1：核心业务基础（优先级：P0）
|
||
|
||
**目标：** 完成系统运营的最基本功能，确保日常业务可以正常进行。
|
||
|
||
**预计工期：** 2-3周
|
||
|
||
| 序号 | 模块 | 功能 | 复杂度 | 后端状态 | 前端状态 |
|
||
|------|------|------|--------|----------|----------|
|
||
| 1 | Index/ | 首页仪表盘 | ⭐⭐⭐ | ✅ 已完成 | ⏳ 待迁移 |
|
||
| 2 | User/ | 用户管理（基础） | ⭐⭐⭐⭐⭐ | ✅ 已完成 | ✅ 已完成 |
|
||
| 3 | Goods/ | 商品管理（基础） | ⭐⭐⭐⭐⭐ | ✅ 已完成 | ✅ 已完成 |
|
||
| 4 | Order/ | 订单管理（基础） | ⭐⭐⭐⭐ | ✅ 已完成 | ⏳ 待迁移 |
|
||
|
||
**批次1详细功能清单：**
|
||
|
||
#### 1.1 仪表盘模块
|
||
- 数据概览卡片（今日注册、消费、订单）
|
||
- 快捷入口
|
||
|
||
|
||
#### 1.2 用户管理模块（基础功能）
|
||
- 用户列表（搜索、分页）
|
||
- 用户详情查看
|
||
- 用户资金变动（余额/积分/钻石）
|
||
- 用户状态管理（封号/解封）
|
||
- VIP等级管理
|
||
|
||
#### 1.3 商品管理模块（基础功能）
|
||
- 盒子列表（搜索、分页、状态切换）
|
||
- 盒子新增/编辑（9种盒子类型）
|
||
- 奖品列表管理
|
||
- 奖品新增/编辑
|
||
- 盒子类型管理
|
||
|
||
#### 1.4 订单管理模块（基础功能）
|
||
- 购买订单列表
|
||
- 发货订单列表
|
||
- 发货操作
|
||
- 订单详情查看
|
||
|
||
---
|
||
|
||
### 批次2：财务与统计（优先级：P0）
|
||
|
||
**目标：** 完成财务数据查看和统计分析功能，支持运营决策。
|
||
|
||
**预计工期：** 1-2周
|
||
|
||
| 序号 | 模块 | 功能 | 复杂度 | 后端状态 | 前端状态 |
|
||
|------|------|------|--------|----------|----------|
|
||
| 1 | Finance/ | 财务管理 | ⭐⭐⭐ | ✅ 已完成 | ⏳ 待迁移 |
|
||
| 2 | Statistics/ | 统计报表 | ⭐⭐⭐⭐⭐ | ⏳ 待开发 | ⏳ 待迁移 |
|
||
|
||
**批次2详细功能清单：**
|
||
|
||
#### 2.1 财务管理模块
|
||
- 余额流水列表
|
||
- 货币1(UU币)流水列表
|
||
- 积分流水列表
|
||
- 充值记录列表
|
||
- 消费记录列表
|
||
- 推荐奖励流水
|
||
- 无限池盈亏统计
|
||
|
||
#### 2.2 统计报表模块（需新增后端API）
|
||
- 数据看板（多卡片数据展示）
|
||
- 盒子利润统计
|
||
- 发货列表统计
|
||
- 订单列表统计
|
||
- 用户统计图表
|
||
|
||
---
|
||
|
||
### 批次3：系统配置（优先级：P1）
|
||
|
||
**目标：** 完成系统参数配置功能，支持灵活的业务调整。
|
||
|
||
**预计工期：** 1-2周
|
||
|
||
| 序号 | 模块 | 功能 | 复杂度 | 后端状态 | 前端状态 |
|
||
|------|------|------|--------|----------|----------|
|
||
| 1 | Config/ | 系统配置 | ⭐⭐⭐⭐⭐ | ✅ 已完成 | ⏳ 待迁移 |
|
||
|
||
**批次3详细功能清单：**
|
||
|
||
#### 3.1 系统配置模块
|
||
- 基础设置（网站名称、物流、分销比例等）
|
||
- 微信支付配置（多商户）
|
||
- 支付宝支付配置（多商户）
|
||
- 小程序配置（多小程序）
|
||
- H5配置（多H5应用）
|
||
- 上传配置（云存储）
|
||
- 签到配置
|
||
- 系统设置（综合配置）
|
||
|
||
---
|
||
|
||
### 批次4：营销活动（优先级：P1）
|
||
|
||
**目标：** 完成营销活动相关功能，支持运营推广。
|
||
|
||
**预计工期：** 2-3周
|
||
|
||
| 序号 | 模块 | 功能 | 复杂度 | 后端状态 | 前端状态 |
|
||
|------|------|------|--------|----------|----------|
|
||
| 1 | Coupon/ | 优惠券管理 | ⭐⭐⭐ | ⏳ 待开发 | ⏳ 待迁移 |
|
||
| 2 | CouponReceive/ | 优惠券领取 | ⭐⭐ | ⏳ 待开发 | ⏳ 待迁移 |
|
||
| 3 | Advert/ | 广告管理 | ⭐⭐⭐ | ⏳ 待开发 | ⏳ 待迁移 |
|
||
| 4 | AdvertType/ | 广告类型 | ⭐⭐ | ⏳ 待开发 | ⏳ 待迁移 |
|
||
| 5 | Rank/ | 排行榜奖品 | ⭐⭐⭐ | ⏳ 待开发 | ⏳ 待迁移 |
|
||
| 6 | user_rank/ | 用户排行榜 | ⭐⭐⭐ | ⏳ 待开发 | ⏳ 待迁移 |
|
||
|
||
**批次4详细功能清单：**
|
||
|
||
#### 4.1 优惠券管理
|
||
- 优惠券列表（新人券/权益券/满减券）
|
||
- 优惠券新增/编辑
|
||
- 优惠券领取记录
|
||
|
||
#### 4.2 广告管理
|
||
- 广告列表
|
||
- 广告新增/编辑（支持多种跳转类型）
|
||
- 广告类型管理
|
||
|
||
#### 4.3 排行榜管理
|
||
- 周榜奖品配置
|
||
- 月榜奖品配置
|
||
- 中奖记录查看
|
||
- 用户排行榜（邀请/亏损/货币）
|
||
|
||
---
|
||
|
||
### 批次5：抽奖扩展（优先级：P1）
|
||
|
||
**目标：** 完成抽奖相关的扩展功能。
|
||
|
||
**预计工期：** 2-3周
|
||
|
||
| 序号 | 模块 | 功能 | 复杂度 | 后端状态 | 前端状态 |
|
||
|------|------|------|--------|----------|----------|
|
||
| 1 | Draw/ | 抽奖配置 | ⭐⭐⭐ | ⏳ 待开发 | ⏳ 待迁移 |
|
||
| 2 | Cardextractor/ | 抽卡机 | ⭐⭐⭐⭐ | ⏳ 待开发 | ⏳ 待迁移 |
|
||
| 3 | CardGoods/ | 卡牌商品 | ⭐⭐⭐ | ⏳ 待开发 | ⏳ 待迁移 |
|
||
|
||
**批次5详细功能清单：**
|
||
|
||
#### 5.1 抽奖配置模块
|
||
- 抽奖盒子列表
|
||
- 抽奖盒子新增/编辑
|
||
- 抽奖奖品管理
|
||
|
||
#### 5.2 抽卡机模块
|
||
- 抽卡机盒子列表
|
||
- 抽卡机盒子新增/编辑
|
||
- 抽卡机奖品管理
|
||
- 卡牌等级管理
|
||
- 抽卡机分类管理
|
||
- 抽数设置
|
||
|
||
#### 5.3 卡牌商品模块
|
||
- 卡牌商品列表
|
||
- 卡牌商品新增/编辑
|
||
- 卡牌分类管理
|
||
|
||
---
|
||
|
||
### 批次6：福利与任务（优先级：P2）
|
||
|
||
**目标：** 完成用户福利和任务系统。
|
||
|
||
**预计工期：** 1-2周
|
||
|
||
| 序号 | 模块 | 功能 | 复杂度 | 后端状态 | 前端状态 |
|
||
|------|------|------|--------|----------|----------|
|
||
| 1 | Reward/ | 奖励管理 | ⭐⭐ | ⏳ 待开发 | ⏳ 待迁移 |
|
||
| 2 | SignConfig/ | 签到配置 | ⭐⭐⭐ | ⏳ 待开发 | ⏳ 待迁移 |
|
||
| 3 | TaskList/ | 任务管理 | ⭐⭐ | ⏳ 待开发 | ⏳ 待迁移 |
|
||
| 4 | QyLevel/ | 权益等级 | ⭐⭐⭐ | ⏳ 待开发 | ⏳ 待迁移 |
|
||
|
||
**批次6详细功能清单：**
|
||
|
||
#### 6.1 奖励管理
|
||
- 奖励列表（优惠券/钻石/货币）
|
||
- 奖励新增/编辑
|
||
|
||
#### 6.2 签到配置
|
||
- 每日签到配置
|
||
- 累计签到配置
|
||
- 签到奖励编辑
|
||
|
||
#### 6.3 任务管理
|
||
- 任务列表（每日/每周）
|
||
- 任务新增/编辑
|
||
|
||
#### 6.4 权益等级
|
||
- 权益等级列表
|
||
- 等级奖品管理
|
||
|
||
---
|
||
|
||
### 批次7：商城与秒杀（优先级：P2）
|
||
|
||
**目标：** 完成商城和秒杀功能。
|
||
|
||
**预计工期：** 2周
|
||
|
||
| 序号 | 模块 | 功能 | 复杂度 | 后端状态 | 前端状态 |
|
||
|------|------|------|--------|----------|----------|
|
||
| 1 | Diamond/ | 钻石商城 | ⭐⭐⭐⭐ | ⏳ 待开发 | ⏳ 待迁移 |
|
||
| 2 | Seckill/ | 秒杀管理 | ⭐⭐⭐⭐ | ⏳ 待开发 | ⏳ 待迁移 |
|
||
|
||
**批次7详细功能清单：**
|
||
|
||
#### 7.1 钻石商城
|
||
- 钻石商品列表
|
||
- 钻石商品新增/编辑（多图片、首充配置）
|
||
|
||
#### 7.2 秒杀管理
|
||
- 秒杀时间段管理
|
||
- 秒杀商品管理
|
||
- 秒杀发货订单
|
||
- 秒杀签到设置
|
||
|
||
---
|
||
|
||
### 批次8：内容与辅助（优先级：P3）
|
||
|
||
**目标：** 完成内容管理和辅助功能。
|
||
|
||
**预计工期：** 1-2周
|
||
|
||
| 序号 | 模块 | 功能 | 复杂度 | 后端状态 | 前端状态 |
|
||
|------|------|------|--------|----------|----------|
|
||
| 1 | Danye/ | 单页管理 | ⭐⭐ | ⏳ 待开发 | ⏳ 待迁移 |
|
||
| 2 | News/ | 资讯管理 | ⭐⭐⭐ | ⏳ 待开发 | ⏳ 待迁移 |
|
||
| 3 | float_ball/ | 悬浮球配置 | ⭐⭐⭐ | ⏳ 待开发 | ⏳ 待迁移 |
|
||
| 4 | welfare_house/ | 福利屋入口 | ⭐⭐ | ⏳ 待开发 | ⏳ 待迁移 |
|
||
|
||
**批次8详细功能清单：**
|
||
|
||
#### 8.1 单页管理
|
||
- 单页列表
|
||
- 单页编辑（富文本）
|
||
|
||
#### 8.2 资讯管理
|
||
- 资讯列表
|
||
- 资讯新增/编辑
|
||
- 热榜/精选设置
|
||
|
||
#### 8.3 悬浮球配置
|
||
- 悬浮球列表
|
||
- 悬浮球新增/编辑（位置、尺寸、特效）
|
||
|
||
#### 8.4 福利屋入口
|
||
- 入口列表
|
||
- 入口新增/编辑
|
||
|
||
---
|
||
|
||
### 批次9：其他辅助模块（优先级：P3）
|
||
|
||
**目标：** 完成剩余的辅助功能模块。
|
||
|
||
**预计工期：** 1周
|
||
|
||
| 序号 | 模块 | 功能 | 复杂度 | 后端状态 | 前端状态 |
|
||
|------|------|------|--------|----------|----------|
|
||
| 1 | Profit/ | 支出记录 | ⭐⭐ | ⏳ 待开发 | ⏳ 待迁移 |
|
||
| 2 | ItemCard/ | 物品卡 | ⭐⭐ | ⏳ 待开发 | ⏳ 待迁移 |
|
||
| 3 | FFCategories/ | FF分类 | ⭐⭐ | ⏳ 待开发 | ⏳ 待迁移 |
|
||
| 4 | FFProducts/ | FF商品 | ⭐⭐ | ⏳ 待开发 | ⏳ 待迁移 |
|
||
| 5 | ProductCate/ | 商品分类 | ⭐⭐ | ⏳ 待开发 | ⏳ 待迁移 |
|
||
| 6 | VerificationCode/ | 验证码记录 | ⭐ | ⏳ 待开发 | ⏳ 待迁移 |
|
||
|
||
---
|
||
|
||
## 迁移时间线
|
||
|
||
```
|
||
批次1 (P0): 核心业务基础 [第1-3周] ████████████
|
||
批次2 (P0): 财务与统计 [第4-5周] ████████
|
||
批次3 (P1): 系统配置 [第6-7周] ████████
|
||
批次4 (P1): 营销活动 [第8-10周] ████████████
|
||
批次5 (P1): 抽奖扩展 [第11-13周] ████████████
|
||
批次6 (P2): 福利与任务 [第14-15周] ████████
|
||
批次7 (P2): 商城与秒杀 [第16-17周] ████████
|
||
批次8 (P3): 内容与辅助 [第18-19周] ████████
|
||
批次9 (P3): 其他辅助模块 [第20周] ████
|
||
```
|
||
|
||
**总预计工期：** 约20周（5个月）
|
||
|
||
---
|
||
|
||
## 技术依赖关系
|
||
|
||
```mermaid
|
||
graph TD
|
||
A[批次1: 核心业务基础] --> B[批次2: 财务与统计]
|
||
A --> C[批次3: 系统配置]
|
||
A --> D[批次4: 营销活动]
|
||
A --> E[批次5: 抽奖扩展]
|
||
D --> F[批次6: 福利与任务]
|
||
E --> G[批次7: 商城与秒杀]
|
||
C --> H[批次8: 内容与辅助]
|
||
F --> I[批次9: 其他辅助模块]
|
||
G --> I
|
||
H --> I
|
||
```
|
||
|
||
---
|
||
|
||
## 每批次交付物
|
||
|
||
### 批次1交付物
|
||
- [ ] 仪表盘页面（Vue 3 + Element Plus）
|
||
- [x] 用户管理页面（列表、详情、操作）✅ 2026-01-17 完成
|
||
- [x] 商品管理页面（盒子、奖品）✅ 2026-01-17 完成
|
||
- [ ] 订单管理页面（列表、发货）
|
||
- [x] 用户管理单元测试和属性测试 ✅ 2026-01-17 完成
|
||
|
||
### 批次2交付物
|
||
- [ ] 财务管理页面（流水、充值）
|
||
- [ ] 统计报表页面（数据看板、利润统计）
|
||
- [ ] Statistics 后端 API
|
||
- [ ] 单元测试和属性测试
|
||
|
||
### 批次3交付物
|
||
- [ ] 系统配置页面（多Tab配置）
|
||
- [ ] 支付配置页面（多商户）
|
||
- [ ] 小程序/H5配置页面
|
||
- [ ] 单元测试和属性测试
|
||
|
||
### 批次4交付物
|
||
- [ ] 优惠券管理页面
|
||
- [ ] 广告管理页面
|
||
- [ ] 排行榜管理页面
|
||
- [ ] Coupon/Advert/Rank 后端 API
|
||
- [ ] 单元测试和属性测试
|
||
|
||
### 批次5交付物
|
||
- [ ] 抽奖配置页面
|
||
- [ ] 抽卡机管理页面
|
||
- [ ] 卡牌商品页面
|
||
- [ ] Draw/Cardextractor/CardGoods 后端 API
|
||
- [ ] 单元测试和属性测试
|
||
|
||
### 批次6交付物
|
||
- [ ] 奖励管理页面
|
||
- [ ] 签到配置页面
|
||
- [ ] 任务管理页面
|
||
- [ ] 权益等级页面
|
||
- [ ] Reward/SignConfig/TaskList/QyLevel 后端 API
|
||
- [ ] 单元测试和属性测试
|
||
|
||
### 批次7交付物
|
||
- [ ] 钻石商城页面
|
||
- [ ] 秒杀管理页面
|
||
- [ ] Diamond/Seckill 后端 API
|
||
- [ ] 单元测试和属性测试
|
||
|
||
### 批次8交付物
|
||
- [ ] 单页管理页面
|
||
- [ ] 资讯管理页面
|
||
- [ ] 悬浮球配置页面
|
||
- [ ] 福利屋入口页面
|
||
- [ ] Danye/News/float_ball/welfare_house 后端 API
|
||
- [ ] 单元测试和属性测试
|
||
|
||
### 批次9交付物
|
||
- [ ] 支出记录页面
|
||
- [ ] 物品卡页面
|
||
- [ ] FF分类/商品页面
|
||
- [ ] 商品分类页面
|
||
- [ ] 验证码记录页面
|
||
- [ ] 剩余模块后端 API
|
||
- [ ] 单元测试和属性测试
|
||
|
||
---
|
||
|
||
## 风险与注意事项
|
||
|
||
### 技术风险
|
||
1. **复杂表单处理**：商品管理模块有9种盒子类型，需要条件显示不同字段
|
||
2. **多图片上传**：多个模块需要支持多图片上传和预览
|
||
3. **异步数据加载**：统计报表模块需要处理大量异步数据
|
||
4. **富文本编辑**：单页和资讯模块需要富文本编辑器
|
||
|
||
### 业务风险
|
||
1. **数据迁移**：确保新旧系统数据一致性
|
||
2. **权限控制**：确保所有API都有正确的权限验证
|
||
3. **并发处理**：库存、订单等需要处理并发问题
|
||
|
||
### 建议
|
||
1. 每个批次完成后进行充分测试
|
||
2. 保持新旧系统并行运行一段时间
|
||
3. 建立回滚机制
|
||
4. 做好数据备份
|
||
|
||
---
|
||
|
||
## 更新记录
|
||
|
||
| 日期 | 版本 | 更新内容 |
|
||
|------|------|----------|
|
||
| 2026-01-17 | v1.0 | 初始版本，完成9个批次规划 |
|
||
| 2026-01-17 | v1.1 | 用户管理模块前端迁移完成 |
|
||
| 2026-01-17 | v1.2 | 商品管理（盒子）模块前端迁移完成 |
|
||
|