# 渠道数据分析功能开发计划

本计划旨在为渠道管理增加数据分析功能，包括用户增长和付费数据的可视化展示。

## 1. 需求分析与对齐 (Align)
*   **目标**: 在渠道列表页增加“分析”入口，点击后展示该渠道的运营数据。
*   **核心指标**:
    *   **用户增长**: 累计注册用户数、每日新增用户趋势。
    *   **付费数据**: 累计订单数、累计 GMV (销售额)、每日订单/GMV 趋势。
*   **交互**: 列表页操作栏新增“分析”按钮 -> 弹出模态框/抽屉展示仪表盘。

## 2. 架构设计 (Architect)

### 2.1 后端设计
*   **API 接口**: 新增 `GET /admin/v1/channels/{id}/stats`
*   **数据源**:
    *   用户数据: `users` 表 (字段: `created_at`, `channel_id`)
    *   订单数据: `orders` 表 (需关联 `users` 表，通过 `user_id` 关联，筛选 `channel_id`)
*   **Service 层**:
    *   扩展 `ChannelService`，增加 `GetStats(ctx, channelID, timeRange)` 方法。
    *   使用 GORM 进行聚合查询 (Group by date)。

### 2.2 前端设计
*   **组件复用**: 使用现有的 `ArtStatsCard` (指标卡片) 和 `ArtLineChart` (折线图)。
*   **页面改造**: `web/admin/src/views/operations/channels/index.vue`
    *   新增“分析”按钮。
    *   新增弹窗组件，包含数据加载逻辑。

## 3. 任务拆解 (Atomize)

### 3.1 后端开发
1.  **Service 实现**: 在 `internal/service/channel/channel.go` 中实现数据统计逻辑 (用户数、订单数、GMV)。
2.  **Controller 实现**: 在 `internal/api/admin/channels.go` 中添加处理函数。
3.  **路由注册**: 注册新的 API 路由。

### 3.2 前端开发
1.  **API 定义**: 在 `web/admin/src/api/channels.ts` 中添加 `getChannelStats` 方法。
2.  **UI 实现**: 在 `channels/index.vue` 中集成分析弹窗，展示指标卡片和趋势图表。

## 4. 执行步骤 (Automate)

1.  **Step 1**: 实现后端统计接口 (Service + API)。
2.  **Step 2**: 定义前端 API 接口。
3.  **Step 3**: 实现前端分析弹窗 UI 并对接数据。
4.  **Step 4**: 验证数据准确性和图表展示效果。
