outsource/HaniBlindBox

Fork 0

gpu c0d139651c 修改主题

2026-01-04 10:14:24 +08:00

13 KiB

Raw Blame History

HoneyBox 后台管理系统 - 业务模块迁移清单

迁移概述

本文档列出了从 PHP (ThinkPHP 6.0) 后台迁移到 ASP.NET Core 的所有业务模块。基础权限框架（登录、菜单、角色、权限、部门）已完成，现进入业务模块迁移阶段。

一、模块优先级分类

P0 - 核心业务模块（必须优先迁移）

序号	模块名称	PHP 控制器	功能说明	预计工时
1	首页仪表盘	Index.php	数据统计概览、今日数据、趋势图表	1天
2	用户管理	User.php	用户列表、封禁/解封、资金变动、VIP管理、下级用户	3天
3	商品管理	Goods.php, GoodsType.php	盒子管理、奖品配置、库存管理、9种盒子类型	4天
4	订单管理	Order.php	订单列表、卡单处理、发货管理、退款、导出	3天

P1 - 重要业务模块

序号	模块名称	PHP 控制器	功能说明	预计工时
5	财务管理	Finance.php	消费排行、余额明细、积分明细、充值记录	2天
6	提现管理	Withdraw.php	提现申请列表、审核、打款	1天
7	抽奖配置	Draw.php, Cardextractor.php	抽奖活动配置、抽卡机配置	2天
8	系统配置	Config.php	支付配置、上传配置、系统参数	1天

P2 - 营销与内容模块

序号	模块名称	PHP 控制器	功能说明	预计工时
9	优惠券管理	Coupon.php, CouponReceive.php	优惠券创建、发放、领取记录	2天
10	奖励管理	Reward.php	奖励配置、发放规则	1天
11	排行榜管理	Rank.php, UserRank.php	排行榜配置、用户排名	1天
12	广告管理	Advert.php, AdvertType.php	广告位管理、广告投放	1天
13	单页管理	Danye.php	静态页面管理（关于我们、协议等）	0.5天
14	公告管理	NewsController.php	系统公告、消息推送	0.5天

P3 - 辅助功能模块

序号	模块名称	PHP 控制器	功能说明	预计工时
15	统计报表	Statistics.php	数据分析、报表导出	2天
16	签到配置	SignConfig.php	签到奖励配置	0.5天
17	任务管理	TaskList.php	任务配置、完成奖励	1天
18	福利屋	WelfareHouse.php	福利活动管理	1天
19	秒杀管理	Seckill.php	秒杀活动配置	1天
20	钻石管理	Diamond.php	钻石充值配置	0.5天
21	悬浮球	FloatBall.php	悬浮球配置	0.5天
22	文件上传	Upload.php, Upload2.php	文件上传服务	0.5天

二、详细模块说明

2.1 首页仪表盘 (Index)

功能清单：

今日注册用户数
今日消费金额
今日订单数
总用户数/总订单数/总收入
近7天/30天趋势图
广告数据统计

API 设计：

GET /api/admin/dashboard/overview     # 概览数据
GET /api/admin/dashboard/trend        # 趋势数据
GET /api/admin/dashboard/ads          # 广告统计

2.2 用户管理 (User)

功能清单：

用户列表（分页、搜索、筛选）
用户详情（基本信息、消费统计、盒柜价值）
资金变动（余额、积分、钻石）
封号/解封
清空手机号/微信绑定
设置测试账号
赠送优惠券/卡牌
VIP 等级管理
用户盈亏统计
下级用户列表
流水明细

API 设计：

GET    /api/admin/business/users              # 用户列表
GET    /api/admin/business/users/{id}         # 用户详情
PUT    /api/admin/business/users/{id}/status  # 封号/解封
PUT    /api/admin/business/users/{id}/money   # 资金变动
PUT    /api/admin/business/users/{id}/test    # 设置测试账号
DELETE /api/admin/business/users/{id}/mobile  # 清空手机号
DELETE /api/admin/business/users/{id}/wechat  # 清空微信绑定
POST   /api/admin/business/users/{id}/coupon  # 赠送优惠券
POST   /api/admin/business/users/{id}/card    # 赠送卡牌
GET    /api/admin/business/users/{id}/team    # 下级用户
GET    /api/admin/business/users/{id}/profit  # 盈亏统计
GET    /api/admin/business/vip                # VIP等级列表
PUT    /api/admin/business/vip/{id}           # 编辑VIP等级

2.3 商品管理 (Goods)

功能清单：

盒子列表（9种类型：一番赏、无限赏、擂台赏、抽卡机、福袋、幸运赏、盲盒、扭蛋、福利屋）
盒子新增/编辑/删除
盒子上架/下架
奖品管理（添加、编辑、删除、库存调整）
奖品等级配置
盒子类型管理
盒子扩展信息
商品分类管理

API 设计：

GET    /api/admin/business/goods              # 盒子列表
GET    /api/admin/business/goods/{id}         # 盒子详情
POST   /api/admin/business/goods              # 新增盒子
PUT    /api/admin/business/goods/{id}         # 编辑盒子
DELETE /api/admin/business/goods/{id}         # 删除盒子
PUT    /api/admin/business/goods/{id}/status  # 上架/下架
GET    /api/admin/business/goods/{id}/prizes  # 奖品列表
POST   /api/admin/business/goods/{id}/prizes  # 添加奖品
PUT    /api/admin/business/goods/prizes/{id}  # 编辑奖品
DELETE /api/admin/business/goods/prizes/{id}  # 删除奖品
GET    /api/admin/business/goods-types        # 盒子类型列表
GET    /api/admin/business/prize-levels       # 奖品等级列表

2.4 订单管理 (Order)

功能清单：

购买订单列表
卡单列表（支付成功但未发奖）
订单详情（奖品明细）
兑换订单列表（回收）
发货订单列表
发货处理（单个/批量）
订单导出（Excel）
物流信息查询

API 设计：

GET    /api/admin/business/orders             # 订单列表
GET    /api/admin/business/orders/{id}        # 订单详情
GET    /api/admin/business/orders/stuck       # 卡单列表
POST   /api/admin/business/orders/{id}/retry  # 重试发奖
GET    /api/admin/business/orders/recovery    # 兑换订单
GET    /api/admin/business/orders/shipping    # 发货订单
PUT    /api/admin/business/orders/{id}/ship   # 发货处理
POST   /api/admin/business/orders/batch-ship  # 批量发货
GET    /api/admin/business/orders/export      # 导出订单

2.5 财务管理 (Finance)

功能清单：

消费排行榜
余额明细（充值、消费、提现）
积分明细
钻石明细
充值记录
微信支付日志

API 设计：

GET /api/admin/business/finance/ranking       # 消费排行
GET /api/admin/business/finance/money         # 余额明细
GET /api/admin/business/finance/integral      # 积分明细
GET /api/admin/business/finance/diamond       # 钻石明细
GET /api/admin/business/finance/recharge      # 充值记录
GET /api/admin/business/finance/wxpay-logs    # 微信支付日志

2.6 提现管理 (Withdraw)

功能清单：

提现申请列表
提现审核（通过/拒绝）
提现打款（微信企业付款）
提现记录查询

API 设计：

GET  /api/admin/business/withdraws            # 提现列表
PUT  /api/admin/business/withdraws/{id}/audit # 审核
POST /api/admin/business/withdraws/{id}/pay   # 打款

2.7 抽奖配置 (Draw, Cardextractor)

功能清单：

抽奖活动列表
抽奖活动配置
抽卡机配置
卡牌商品管理

API 设计：

GET    /api/admin/business/draws              # 抽奖活动列表
POST   /api/admin/business/draws              # 新增活动
PUT    /api/admin/business/draws/{id}         # 编辑活动
DELETE /api/admin/business/draws/{id}         # 删除活动
GET    /api/admin/business/card-extractors    # 抽卡机列表
POST   /api/admin/business/card-extractors    # 新增抽卡机
PUT    /api/admin/business/card-extractors/{id}
DELETE /api/admin/business/card-extractors/{id}

2.8 系统配置 (Config)

功能清单：

支付配置（微信支付参数）
上传配置（腾讯云COS）
系统参数（站点名称、客服等）
短信配置
分享配置

API 设计：

GET  /api/admin/business/config/{group}       # 获取配置组
PUT  /api/admin/business/config/{group}       # 更新配置组

三、数据库表映射

业务模块需要访问 honey_box 业务数据库，主要涉及以下表：

业务表	说明	对应模块
users	用户表	用户管理
user_account	用户账户扩展	用户管理
user_vip	VIP等级配置	用户管理
goods	盒子表	商品管理
goods_list	奖品表	商品管理
goods_type	盒子类型	商品管理
goods_extend	盒子扩展信息	商品管理
shang	奖品等级	商品管理
order	订单表	订单管理
order_list	订单奖品明细	订单管理
order_list_send	发货记录	订单管理
profit_money	余额流水	财务管理
profit_integral	积分流水	财务管理
profit_money2	钻石流水	财务管理
user_recharge	充值记录	财务管理
withdraw	提现记录	提现管理
coupon	优惠券	优惠券管理
coupon_receive	优惠券领取	优惠券管理
advert	广告	广告管理
advert_type	广告类型	广告管理
config	系统配置	系统配置

四、技术实现要点

4.1 跨库查询

HoneyBox.Admin 需要同时访问两个数据库：

honey_box_admin - 后台管理数据（管理员、角色、菜单等）
honey_box - 业务数据（用户、商品、订单等）

实现方案：

// 在 HoneyBox.Admin 中引用 HoneyBox.Model
// 注入两个 DbContext
services.AddDbContext<AdminDbContext>(options => 
    options.UseSqlServer(adminConnectionString));
services.AddDbContext<HoneyBoxDbContext>(options => 
    options.UseSqlServer(businessConnectionString));

4.2 业务服务层

在 HoneyBox.Admin/Services/Business/ 下创建业务服务：

UserBusinessService - 用户业务服务
GoodsBusinessService - 商品业务服务
OrderBusinessService - 订单业务服务
FinanceBusinessService - 财务业务服务

4.3 控制器组织

在 HoneyBox.Admin/Controllers/Business/ 下创建业务控制器：

Controllers/
├── AuthController.cs           # 认证（已完成）
├── MenuController.cs           # 菜单（已完成）
├── RoleController.cs           # 角色（已完成）
├── AdminUserController.cs      # 管理员（已完成）
├── DepartmentController.cs     # 部门（已完成）
├── PermissionController.cs     # 权限（已完成）
├── OperationLogController.cs   # 操作日志（已完成）
└── Business/                   # 业务模块（待迁移）
    ├── DashboardController.cs  # 仪表盘
    ├── UserController.cs       # 用户管理
    ├── GoodsController.cs      # 商品管理
    ├── OrderController.cs      # 订单管理
    ├── FinanceController.cs    # 财务管理
    ├── WithdrawController.cs   # 提现管理
    ├── CouponController.cs     # 优惠券管理
    └── ConfigController.cs     # 系统配置

五、前端页面清单

5.1 需要新增的前端页面

页面路径	页面名称	对应后端模块
/dashboard	仪表盘	Dashboard
/business/user	用户管理	User
/business/user/vip	VIP管理	User
/business/goods	商品管理	Goods
/business/goods/type	盒子类型	Goods
/business/goods/prize	奖品管理	Goods
/business/order	订单管理	Order
/business/order/shipping	发货管理	Order
/business/finance	财务管理	Finance
/business/withdraw	提现管理	Withdraw
/business/coupon	优惠券管理	Coupon
/business/advert	广告管理	Advert
/business/config	系统配置	Config

六、迁移计划时间表

阶段	模块	预计工时	建议顺序
第1周	首页仪表盘 + 用户管理	4天	1
第2周	商品管理	4天	2
第3周	订单管理 + 财务管理	5天	3
第4周	提现管理 + 系统配置 + 抽奖配置	4天	4
第5周	优惠券 + 广告 + 其他营销模块	5天	5
第6周	统计报表 + 剩余辅助模块	5天	6

总预计工时：约 27 天（6周）

七、下一步行动

确认本清单 - 确认模块优先级和迁移顺序
创建业务控制器目录 - Controllers/Business/
配置跨库访问 - 引用 HoneyBox.Model，注入 HoneyBoxDbContext
开始 P0 模块迁移 - 从仪表盘和用户管理开始

确认后可以开始创建详细的实现任务清单。

13 KiB Raw Blame History Unescape Escape

HoneyBox 后台管理系统 - 业务模块迁移清单

迁移概述

一、模块优先级分类

P0 - 核心业务模块（必须优先迁移）

P1 - 重要业务模块

P2 - 营销与内容模块

P3 - 辅助功能模块

二、详细模块说明

2.1 首页仪表盘 (Index)

2.2 用户管理 (User)

2.3 商品管理 (Goods)

2.4 订单管理 (Order)

2.5 财务管理 (Finance)

2.6 提现管理 (Withdraw)

2.7 抽奖配置 (Draw, Cardextractor)

2.8 系统配置 (Config)

三、数据库表映射

四、技术实现要点

4.1 跨库查询

4.2 业务服务层

4.3 控制器组织

五、前端页面清单

5.1 需要新增的前端页面

六、迁移计划时间表

七、下一步行动

13 KiB

Raw Blame History