# 数据分析模块 URL 访问文档

## 📋 文档说明

本文档提供数据分析模块所有页面的 URL 路径和访问方式，方便开发、测试和文档引用。

**文档位置**: `pages/mall/analytics/docs/URL_ACCESS.md`  
**最后更新**: 2026-01-23

---

## 🗺️ 页面路由地图

### 1. 主页面

| 页面名称         | URL 路径                      | 页面标题     | 配置位置                                         |
| ---------------- | ----------------------------- | ------------ | ------------------------------------------------ |
| 数据分析中心首页 | `/pages/mall/analytics/index` | 数据分析中心 | `subPackages` → `pages/mall/analytics` → `index` |

### 2. 分析页面（子包）

| 页面名称       | URL 路径                                  | 页面标题       | 配置位置                                                    |
| -------------- | ----------------------------------------- | -------------- | ----------------------------------------------------------- |
| 销售报表       | `/pages/mall/analytics/sales-report`      | 销售报表       | `subPackages` → `pages/mall/analytics` → `sales-report`     |
| 用户分析       | `/pages/mall/analytics/user-analysis`     | 用户分析       | `subPackages` → `pages/mall/analytics` → `user-analysis`    |
| 商品洞察       | `/pages/mall/analytics/product-insights`  | 商品洞察       | `subPackages` → `pages/mall/analytics` → `product-insights` |
| 市场趋势       | `/pages/mall/analytics/market-trends`     | 市场趋势       | `subPackages` → `pages/mall/analytics` → `market-trends`    |
| 自定义报表     | `/pages/mall/analytics/custom-report`     | 自定义报表     | `subPackages` → `pages/mall/analytics` → `custom-report`    |
| 优惠券效果分析 | `/pages/mall/analytics/coupon-analysis`   | 优惠券效果分析 | ⚠️ 未在配置中                                                |
| 配送效率分析   | `/pages/mall/analytics/delivery-analysis` | 配送效率分析   | ⚠️ 未在配置中                                                |

### 3. 详情页面（主包）

| 页面名称     | URL 路径                               | 页面标题     | 配置位置                                        |
| ------------ | -------------------------------------- | ------------ | ----------------------------------------------- |
| 报表详情     | `/pages/mall/analytics/report-detail`  | 报表详情     | `pages` → `pages/mall/analytics/report-detail`  |
| 数据分析详情 | `/pages/mall/analytics/data-detail`    | 数据分析详情 | `pages` → `pages/mall/analytics/data-detail`    |
| 数据洞察详情 | `/pages/mall/analytics/insight-detail` | 数据洞察详情 | `pages` → `pages/mall/analytics/insight-detail` |

### 4. 其他页面

| 页面名称         | URL 路径                        | 页面标题         | 配置位置     |
| ---------------- | ------------------------------- | ---------------- | ------------ |
| 数据分析个人中心 | `/pages/mall/analytics/profile` | 数据分析个人中心 | ⚠️ 未在配置中 |

---

## 💻 代码中如何访问

### 1. 基本跳转（推荐）

```typescript
// 方式一：使用 navigateTo（保留返回栈，可返回上一页）
uni.navigateTo({
  url: '/pages/mall/analytics/index',
  success: () => {
    console.log('跳转成功')
  },
  fail: (err) => {
    console.error('跳转失败:', err)
  }
})

// 方式二：使用 redirectTo（替换当前页面，不保留返回栈）
uni.redirectTo({
  url: '/pages/mall/analytics/index'
})

// 方式三：使用 reLaunch（关闭所有页面，打开新页面）
uni.reLaunch({
  url: '/pages/mall/analytics/index'
})
```

### 2. 带参数跳转

```typescript
// 跳转并传递查询参数
uni.navigateTo({
  url: '/pages/mall/analytics/index?period=30d&refresh=true'
})

// 在目标页面接收参数（index.uvue 的 onLoad）
onLoad(options: any) {
  const period = options.period || '7d'
  const refresh = options.refresh === 'true'
  // 使用参数...
}
```

### 3. 从其他模块跳转示例

```typescript
// 从管理后台跳转到数据分析中心
const goToAnalytics = () => {
  uni.navigateTo({
    url: '/pages/mall/analytics/index'
  })
}

// 从商城首页跳转到销售报表
const goToSalesReport = () => {
  uni.navigateTo({
    url: '/pages/mall/analytics/sales-report'
  })
}

// 从订单列表跳转到数据分析详情
const goToDataDetail = (orderId: string) => {
  uni.navigateTo({
    url: `/pages/mall/analytics/data-detail?id=${orderId}`
  })
}
```

### 4. 侧边栏菜单导航

所有数据分析页面都集成了 `AnalyticsSidebarMenu` 组件，可以通过侧边栏菜单快速导航：

```typescript
// 侧边栏菜单会自动处理导航
// 菜单项配置在 components/analytics/AnalyticsSidebarMenu.uvue 中
const MENU_ITEMS = [
  { path: '/pages/mall/analytics/index', title: '数据分析中心', icon: '📊' },
  { path: '/pages/mall/analytics/sales-report', title: '销售报表', icon: '💰' },
  // ...
]
```

---

## ⚠️ 注意事项

### 1. 路由配置

- **子包页面**（`sales-report`, `user-analysis` 等）必须在 `subPackages` 中配置
- **主包页面**（`report-detail`, `data-detail` 等）必须在主 `pages` 数组中配置
- 未在配置中的页面无法正常访问

### 2. tabBar 限制

数据分析模块**不在** `tabBar` 配置中，因此：
- ✅ 可以使用 `uni.navigateTo()`
- ✅ 可以使用 `uni.redirectTo()`
- ✅ 可以使用 `uni.reLaunch()`
- ❌ **不能**使用 `uni.switchTab()`（仅用于 tabBar 页面）

### 3. 导航栏样式

大部分数据分析页面使用**自定义导航栏**（`navigationStyle: "custom"`），需要：
- 使用 `AnalyticsTopBar` 组件作为顶部导航
- 处理状态栏高度适配
- 处理返回按钮逻辑

---

## 📱 平台兼容性

| 平台       | 支持状态   | 备注                     |
| ---------- | ---------- | ------------------------ |
| H5         | ✅ 完全支持 | 推荐使用，响应式布局优化 |
| 微信小程序 | ✅ 支持     | 需注意页面路径长度限制   |
| App        | ✅ 支持     | 需注意原生导航栏样式     |

---

## 🔗 相关文档

- [实现进度文档](./IMPLEMENTATION_STATUS.md) - 页面实现状态和 bug 修复情况
- [页面分析文档](../../../docs/ANALYTICS_PAGES_ANALYSIS.md) - 页面需求分析
- [UI 设计文档](../../../docs/ANALYTICS_UI_DESIGN.md) - UI 设计规范
- [数据库设计文档](../../../docs/ANALYTICS_DB_DESIGN.md) - 数据库表结构

---

## 🔄 更新日志

### 2026-01-23
- ✅ 创建 URL 访问文档
- ✅ 列出所有页面路径和配置状态
- ✅ 提供代码访问示例
- ✅ 记录注意事项和平台兼容性
