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

pages/mall/analytics/user-analysis.uvue

@@ -1,5 +1,5 @@
 <template>
-  <view class="page" @click="closeMoreMenu">
+  <view class="page" @click.self="closeMoreMenu">
     <!-- 固定顶部导航栏 -->
     <AnalyticsTopBar 
       :title="'用户分析'"
@@ -36,14 +36,29 @@
               v-for="p in timePeriods"
               :key="p.value"
               class="tab"
-              :class="{ active: selectedPeriod === p.value }"
+              :class="{ active: selectedPeriod === p.value && !customRangeEnabled }"
               @click="selectPeriod(p.value)"
             >
               {{ p.label }}
             </view>
+            <view
+              class="tab"
+              :class="{ active: customRangeEnabled }"
+              @click="toggleCustomRange"
+            >
+              自定义
+            </view>
           </view>
         </view>
 
+        <AnalyticsDateRangePicker
+          v-if="customRangeEnabled"
+          :initialStartDate="selectedStartDate"
+          :initialEndDate="selectedEndDate"
+          @apply="onDateRangeApply"
+          @clear="onDateRangeClear"
+        />
+
         <view class="filter-hint">
           <text class="filter-hint-text">渠道/终端/会员/新老：待接入数据后开放</text>
         </view>
@@ -210,6 +225,7 @@
 <script setup lang="uts">
 import AnalyticsSidebarMenu from '@/components/analytics/AnalyticsSidebarMenu.uvue'
 import AnalyticsTopBar from '@/components/analytics/AnalyticsTopBar.uvue'
+import AnalyticsDateRangePicker from '@/components/analytics/AnalyticsDateRangePicker.uvue'
 import EChartsView from '@/uni_modules/charts/EChartsView.vue'
 import supa, { ensureSupabaseReady } from '@/components/supadb/aksupainstance.uts'
 import { getUserIdOrNull } from '@/services/analytics/auth.uts'
@@ -222,6 +238,11 @@ import type { UserData, FunnelStep } from '@/types/analytics/user.uts'
 
 const lastUpdateTime = ref('')
 const selectedPeriod = ref('7d')
+
+const customRangeEnabled = ref(false)
+const selectedStartDate = ref('')
+const selectedEndDate = ref('')
+
 const showMoreMenu = ref(false)
 const showSidebarMenu = ref(false)
 const currentPath = ref('/pages/mall/analytics/user-analysis')
@@ -297,6 +318,10 @@ onLoad(() => {
 })
 
 function calcDateRange() {
+  if (selectedStartDate.value && selectedEndDate.value) {
+    return { startDate: new Date(selectedStartDate.value), endDate: new Date(selectedEndDate.value) }
+  }
+
   const now = new Date()
   const endDate = new Date(now.getFullYear(), now.getMonth(), now.getDate())
   const days = selectedPeriod.value === '7d' ? 7 : selectedPeriod.value === '30d' ? 30 : selectedPeriod.value === '90d' ? 90 : 365
@@ -440,6 +465,27 @@ async function loadUserData() {
 
 function selectPeriod(p: string) {
   selectedPeriod.value = p
+  customRangeEnabled.value = false
+  selectedStartDate.value = ''
+  selectedEndDate.value = ''
+  loadUserData()
+}
+
+function toggleCustomRange() {
+  customRangeEnabled.value = !customRangeEnabled.value
+}
+
+function onDateRangeApply(range: { start: string; end: string }) {
+  selectedStartDate.value = range.start
+  selectedEndDate.value = range.end
+  customRangeEnabled.value = true
+  loadUserData()
+}
+
+function onDateRangeClear() {
+  selectedStartDate.value = ''
+  selectedEndDate.value = ''
+  customRangeEnabled.value = false
   loadUserData()
 }