183 lines
6.7 KiB
Markdown
183 lines
6.7 KiB
Markdown
# 数据分析模块 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 访问文档
|
||
- ✅ 列出所有页面路径和配置状态
|
||
- ✅ 提供代码访问示例
|
||
- ✅ 记录注意事项和平台兼容性
|