数据分析页面骨架

2026-01-23 16:33:11 +08:00
parent fdbee0fa32
commit c14f67cfc8
24 changed files with 9986 additions and 986 deletions
--- a/pages/mall/analytics/docs/URL_ACCESS.md
+++ b/pages/mall/analytics/docs/URL_ACCESS.md
@@ -0,0 +1,182 @@
+# 数据分析模块 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 访问文档
+- ✅ 列出所有页面路径和配置状态
+- ✅ 提供代码访问示例
+- ✅ 记录注意事项和平台兼容性