outsource/HaniBlindBox
3
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
66135678d3
HaniBlindBox/docs/后台管理系统迁移批次规划.md
gpu f343faec8f 333
2026-01-18 13:30:39 +08:00

13 KiB
Raw Blame History

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个月）

技术依赖关系

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）
  • 用户管理页面（列表、详情、操作）✅ 2026-01-17 完成
  • 商品管理页面（盒子、奖品）✅ 2026-01-17 完成
  • 订单管理页面（列表、发货）
  • 用户管理单元测试和属性测试 ✅ 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 商品管理（盒子）模块前端迁移完成