# 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` - 业务数据（用户、商品、订单等）

**实现方案：**
```csharp
// 在 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周）**

---

## 七、下一步行动

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

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