huangzhenbao/medical-mall

Fork 0

Files

comlibmb c14f67cfc8 数据分析页面骨架

2026-01-23 16:33:11 +08:00

6.7 KiB

Raw Blame History

数据分析模块 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. 基本跳转（推荐）

// 方式一：使用 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. 带参数跳转

// 跳转并传递查询参数
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. 从其他模块跳转示例

// 从管理后台跳转到数据分析中心
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 组件，可以通过侧边栏菜单快速导航：

// 侧边栏菜单会自动处理导航
// 菜单项配置在 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	✅ 支持	需注意原生导航栏样式

🔗 相关文档

实现进度文档 - 页面实现状态和 bug 修复情况
页面分析文档 - 页面需求分析
UI 设计文档 - UI 设计规范
数据库设计文档 - 数据库表结构

🔄 更新日志

2026-01-23

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

6.7 KiB Raw Blame History Unescape Escape