邹方成
45815bfb7d
refactor(utils): 修复密码哈希比较逻辑错误 feat(user): 新增按状态筛选优惠券接口 docs: 添加虚拟发货与任务中心相关文档 fix(wechat): 修正Code2Session上下文传递问题 test: 补充订单折扣与积分转换测试用例 build: 更新配置文件与构建脚本 style: 清理多余的空行与注释
108 lines
3.7 KiB
Markdown
108 lines
3.7 KiB
Markdown
# 订单记录与渠道分析优化计划
|
||
|
||
本计划旨在解决用户提出的两个问题：
|
||
|
||
1. **订单记录优化**：补充缺失的“开奖状态”和“活动信息”。
|
||
2. **渠道分析优化**：将渠道分析的统计维度调整为按“月份”划分。
|
||
|
||
## 1. 需求分析与对齐 (Align)
|
||
|
||
* **需求 1 (订单记录)**:
|
||
|
||
* **问题**: 订单列表（Admin/App 端）缺乏上下文信息，无法知道订单属于哪个活动，以及是否中奖。
|
||
|
||
* **解决方案**:
|
||
|
||
* 在订单列表中关联 `ActivityDrawLogs` 表，通过 `OrderID` 关联。
|
||
|
||
* 如果在 `ActivityDrawLogs` 中找到记录，说明已开奖，可以获取 `IsWinner` (是否中奖) 和 `RewardID` (奖品信息)。
|
||
|
||
* 通过 `ActivityDrawLogs` 的 `IssueID` -> `ActivityIssues` -> `Activities` 链条，或者直接通过商品信息反查活动，来获取活动名称。
|
||
|
||
* 注意：`ActivityDrawLogs` 是通过 `OrderID` 关联的 (`comment:抽奖票据订单ID`)。
|
||
|
||
* **实现细节**: 修改 `internal/service/user/orders_list.go` 中的 `ListOrdersWithItems`，在返回结构中增加 `ActivityInfo` 和 `DrawInfo`。
|
||
|
||
* **需求 2 (渠道分析)**:
|
||
|
||
* **问题**: 渠道分析目前按天统计，用户希望按月统计。
|
||
|
||
* **解决方案**: 修改 `GetStats` 方法，将 SQL 中的 `DATE_FORMAT` 格式从 `%Y-%m-%d` 改为 `%Y-%m`，并调整日期范围计算逻辑（按月计算）。
|
||
|
||
* **交互调整**: 前端默认请求的时间范围应适应按月展示（如最近 6-12 个月）。也可以 手动选择时间类型 区间等
|
||
|
||
## 2. 架构设计 (Architect)
|
||
|
||
### 2.1 订单列表数据增强
|
||
|
||
* **数据模型扩展**:
|
||
|
||
* 在 `internal/service/user/orders_list.go` 中，扩展 `OrderWithItems` 结构体（或新建 `OrderWithDetail`），增加：
|
||
|
||
* `ActivityName`: 活动名称
|
||
|
||
* `IssueNumber`: 期号
|
||
|
||
* `IsDraw`: 是否已开奖
|
||
|
||
* `IsWinner`: 是否中奖
|
||
|
||
* `RewardLevel`: 中奖等级
|
||
|
||
* **查询逻辑**:
|
||
|
||
* 查询 `orders` 后，收集 `order_ids`。
|
||
|
||
* 批量查询 `activity_draw_logs` WHERE `order_id IN (?)`。
|
||
|
||
* 批量查询 `activity_issues` (通过 logs 中的 `issue_id`)。
|
||
|
||
* 批量查询 `activities` (通过 issues 中的 `activity_id`)。
|
||
|
||
* 将这些信息组装回订单列表。
|
||
|
||
### 2.2 渠道分析按月统计
|
||
|
||
* **后端调整**:
|
||
|
||
* 修改 `GetStats` 签名或内部逻辑。考虑到用户明确说“只需要按月份”，我们可以直接修改默认行为。
|
||
|
||
* SQL: `DATE_FORMAT(created_at, '%Y-%m')`
|
||
|
||
* Range: 最近 12 个月。
|
||
|
||
## 3. 任务拆解 (Atomize)
|
||
|
||
### 3.1 渠道分析优化 (优先执行，改动小)
|
||
|
||
1. **Modify Backend**: 修改 `internal/service/channel/channel.go` 中的 `GetStats` 方法。
|
||
|
||
* 调整日期格式为 `%Y-%m`。
|
||
|
||
* 调整循环逻辑，生成月份列表。
|
||
|
||
* 调整默认天数/月数为 12。
|
||
2. **Modify Frontend**: 修改 `web/admin/src/views/operations/channels/index.vue`。
|
||
|
||
* 调整图表 X 轴显示。
|
||
|
||
* 调整 API 调用参数（如果需要）。
|
||
|
||
### 3.2 订单列表增强
|
||
|
||
1. **Modify Service**: 修改 `internal/service/user/orders_list.go`。
|
||
|
||
* 定义新的结构体字段。
|
||
|
||
* 在 `ListOrders` / `ListOrdersWithItems` 中增加查询 `ActivityDrawLogs` 和相关表的逻辑。
|
||
2. **Verify**: 确保管理端和 APP 端调用该 Service 的地方都能正常展示新字段（可能需要同步修改 Controller 或 API 定义）。
|
||
|
||
* 检查 `internal/api/admin/users_admin.go` 和 `internal/api/user/orders_app.go`。
|
||
|
||
## 4. 执行步骤 (Automate)
|
||
|
||
1. **Step 1**: 修改 `channel.go` 实现按月统计。
|
||
2. **Step 2**: 修改 `orders_list.go` 实现订单详情增强。
|
||
3. **Step 3**: 验证并修复可能受影响的 API 响应结构。
|
||
|