数据库文档编写，开发规范文档，数据库接入

2026-02-02 18:09:30 +08:00
parent 19970db288
commit 21149dd3fe
36 changed files with 3245 additions and 89 deletions
--- a/components/analytics/AnalyticsComboChart.uvue
+++ b/components/analytics/AnalyticsComboChart.uvue
@@ -154,10 +154,11 @@ export default {
          data: x,
          axisTick: { alignWithLabel: true },
          axisLine: { lineStyle: { color: 'rgba(0,0,0,0.12)' } },
-          axisLabel: { 
+          axisLabel: {
            color: 'rgba(0,0,0,0.55)',
            rotate: x.length > 12 ? 45 : 0,
-            interval: 0
+            // 数据量大时不要强制全部展示，否则会全部重叠
+            interval: x.length > 60 ? 'auto' : 0
          }
        },
        yAxis: [
--- a/components/analytics/AnalyticsSidebarMenu.uvue
+++ b/components/analytics/AnalyticsSidebarMenu.uvue
@@ -4,15 +4,32 @@
    <!-- 侧边栏菜单 -->
    <view class="sidebar-menu" :class="{ active: showMenu, 'always-visible': isWideScreen }" @click.stop>
      <view class="sidebar-content">
-        <view 
-          v-for="item in menuItems" 
+        <view
+          v-for="item in menuItems"
          :key="item.path"
-          class="menu-item" 
-          :class="{ active: currentPath === item.path }"
-          @click="navigateToPage(item.path)"
        >
-          <text class="menu-icon">{{ item.icon }}</text>
-          <text class="menu-text">{{ item.title }}</text>
+          <view
+            class="menu-item"
+            :class="{ active: isActive(item.path) }"
+            @click="onParentClick(item)"
+          >
+            <text class="menu-icon">{{ item.icon }}</text>
+            <text class="menu-text">{{ item.title }}</text>
+            <text v-if="item.children && item.children.length > 0" class="menu-caret">{{ isExpanded(item.path) ? '▾' : '▸' }}</text>
+          </view>
+
+          <view v-if="item.children && item.children.length > 0 && isExpanded(item.path)" class="submenu">
+            <view
+              v-for="child in item.children"
+              :key="child.path"
+              class="menu-item menu-item-child"
+              :class="{ active: isActive(child.path), disabled: isCustomReportChildDisabled(item, child) }"
+              @click="onChildClick(item, child)"
+            >
+              <text class="menu-icon">{{ child.icon }}</text>
+              <text class="menu-text">{{ child.title }}</text>
+            </view>
+          </view>
        </view>
      </view>
    </view>
@@ -22,11 +39,15 @@
 </template>

 <script lang="uts">
+import { getUserIdOrNull } from '@/services/analytics/auth.uts'
+import { listCustomReports } from '@/services/analytics/customReportService.uts'
+
 // 菜单项类型
 type MenuItem = {
  path: string
  title: string
  icon: string
+  children?: Array<MenuItem>
 }

 // 菜单配置
@@ -39,10 +60,16 @@ const MENU_ITEMS: Array<MenuItem> = [
  { path: '/pages/mall/analytics/delivery-analysis', title: '配送效率分析', icon: '🚚' },
  { path: '/pages/mall/analytics/coupon-analysis', title: '优惠券效果分析', icon: '🎫' },
  { path: '/pages/mall/analytics/market-trends', title: '市场趋势', icon: '📈' },
-  { path: '/pages/mall/analytics/custom-report', title: '自定义报表', icon: '📋' },
-  { path: '/pages/mall/analytics/report-detail', title: '报表详情', icon: '📄' },
-  { path: '/pages/mall/analytics/data-detail', title: '数据分析详情', icon: '🔍' },
-  { path: '/pages/mall/analytics/insight-detail', title: '数据洞察详情', icon: '💡' }
+  {
+    path: '/pages/mall/analytics/custom-report',
+    title: '自定义报表',
+    icon: '📋',
+    children: [
+      { path: '/pages/mall/analytics/report-detail', title: '报表详情', icon: '📄' },
+      { path: '/pages/mall/analytics/data-detail', title: '数据分析详情', icon: '🔍' },
+      { path: '/pages/mall/analytics/insight-detail', title: '数据洞察详情', icon: '💡' }
+    ]
+  }
 ]

 export default {
@@ -64,7 +91,9 @@ export default {
      showMenu: false,
      menuItems: MENU_ITEMS,
      isWideScreen: false,
-      screenWidth: 0
+      screenWidth: 0,
+      expanded: {} as any,
+      hasAnyCustomReport: false
    }
  },
  watch: {
@@ -81,16 +110,46 @@ export default {
      if (!this.isWideScreen) {
        this.$emit('visible-change', newVal)
      }
+    },
+    currentPath: {
+      handler() {
+        this.syncExpandedWithRoute()
+      },
+      immediate: true
    }
  },
  onLoad() {
    this.checkScreenSize()
+    this.checkCustomReports()
  },
  onShow() {
    // 每次显示时检查屏幕尺寸
    this.checkScreenSize()
+    this.checkCustomReports()
  },
  methods: {
+    isActive(path: string): boolean {
+      const cur = this.currentPath || ''
+      if (cur === path) return true
+      if (cur.startsWith(path + '?')) return true
+      if (cur.startsWith(path + '/')) return true
+      return false
+    },
+
+    async checkCustomReports() {
+      try {
+        const uid = getUserIdOrNull()
+        if (uid == null || uid.length === 0) {
+          this.hasAnyCustomReport = false
+          return
+        }
+        const list = await listCustomReports(uid)
+        this.hasAnyCustomReport = Array.isArray(list) && list.length > 0
+      } catch (e) {
+        this.hasAnyCustomReport = false
+      }
+    },
+
    checkScreenSize() {
      // 获取屏幕宽度
      const systemInfo = uni.getSystemInfoSync()
@@ -104,6 +163,78 @@ export default {
      }
    },
    
+    isExpanded(path: string): boolean {
+      const v: any = (this as any).expanded
+      return v != null && v[path] === true
+    },
+
+    toggleExpanded(path: string) {
+      const v: any = (this as any).expanded
+      if (v == null) return
+      v[path] = !(v[path] === true)
+      ;(this as any).expanded = { ...v }
+    },
+
+    syncExpandedWithRoute() {
+      for (let i = 0; i < this.menuItems.length; i++) {
+        const item: any = this.menuItems[i]
+        if (item.children && item.children.length > 0) {
+          let shouldExpand = false
+          for (let j = 0; j < item.children.length; j++) {
+            const child = item.children[j]
+            if (this.isActive(child.path)) {
+              shouldExpand = true
+              break
+            }
+          }
+          if (this.isActive(item.path)) {
+            shouldExpand = true
+          }
+          const v: any = (this as any).expanded
+          v[item.path] = shouldExpand
+        }
+      }
+
+      const v: any = (this as any).expanded
+      ;(this as any).expanded = { ...v }
+    },
+
+    isCustomReportChildDisabled(parent: any, child: any): boolean {
+      if (parent == null || child == null) return false
+      if (parent.path !== '/pages/mall/analytics/custom-report') return false
+      return this.hasAnyCustomReport !== true
+    },
+
+    onChildClick(parent: any, child: any) {
+      if (this.isCustomReportChildDisabled(parent, child)) {
+        uni.showToast({ title: '请先创建自定义报表', icon: 'none', duration: 2000 })
+        // 引导去自定义报表页
+        this.navigateToPage('/pages/mall/analytics/custom-report')
+        return
+      }
+      this.navigateToPage(child.path)
+    },
+
+    onParentClick(item: any) {
+      if (item.children && item.children.length > 0) {
+        // 有子菜单：
+        // - 如果当前就在该父级页面：切换展开/收起
+        // - 否则：先跳转到父级页面（自定义报表列表），并确保展开
+        if (this.isActive(item.path)) {
+          this.toggleExpanded(item.path)
+        } else {
+          const v: any = (this as any).expanded
+          if (v != null) {
+            v[item.path] = true
+            ;(this as any).expanded = { ...v }
+          }
+          this.navigateToPage(item.path)
+        }
+        return
+      }
+      this.navigateToPage(item.path)
+    },
+
    closeMenu() {
      // 宽屏时不允许关闭
      if (this.isWideScreen) {
@@ -121,10 +252,16 @@ export default {
        }
        return
      }
-      uni.navigateTo({
+      uni.redirectTo({
        url: path,
        fail: () => {
-          uni.showToast({ title: '页面跳转失败', icon: 'none' })
+          // navigateTo 失败时通常是页面栈满（最多10层），这里降级为 redirectTo
+          uni.navigateTo({
+            url: path,
+            fail: () => {
+              uni.showToast({ title: '页面跳转失败', icon: 'none' })
+            }
+          })
        }
      })
      // 窄屏时关闭菜单
@@ -223,6 +360,20 @@ export default {
  transition: background 0.2s;
 }

+.submenu {
+  padding-left: 28px;
+}
+
+.menu-item-child {
+  padding: 10px 16px;
+}
+
+.menu-caret {
+  font-size: 12px;
+  color: rgba(0, 0, 0, 0.45);
+  flex: 0 0 auto;
+}
+
 .menu-item:hover {
  background: rgba(0, 0, 0, 0.03);
 }
@@ -232,6 +383,15 @@ export default {
  border-left: 3px solid #3b82f6;
 }

+.menu-item.disabled {
+  opacity: 0.45;
+  cursor: not-allowed;
+}
+
+.menu-item.disabled:hover {
+  background: transparent;
+}
+
 .menu-item.active .menu-text {
  color: #3b82f6;
  font-weight: 600;