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

pages/mall/analytics/delivery-analysis.uvue

@@ -27,19 +27,34 @@
       <view class="main-content">
         <view class="container">
 
-      <!-- 时间维度筛选 -->
+      <!-- 时间维度筛选（快捷 + 自定义） -->
       <view class="tabs">
         <view
           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>
 
+      <AnalyticsDateRangePicker
+        v-if="customRangeEnabled"
+        :initialStartDate="selectedStartDate"
+        :initialEndDate="selectedEndDate"
+        @apply="onDateRangeApply"
+        @clear="onDateRangeClear"
+      />
+
       <!-- KPI 指标卡片 -->
       <view class="kpi-grid">
         <view class="kpi-card">
@@ -120,6 +135,7 @@ import { onLoad } from '@dcloudio/uni-app'
 
 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 { fetchDeliveryAnalysis } from '@/services/analytics/deliveryAnalysisService.uts'
@@ -130,6 +146,11 @@ import type { DeliveryData, DriverRank } from '@/types/analytics/delivery.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/delivery-analysis')
@@ -171,7 +192,11 @@ onLoad(() => {
 
 async function loadDeliveryData() {
   try {
-    const data: any = await fetchDeliveryAnalysis(selectedPeriod.value)
+    const range = selectedStartDate.value && selectedEndDate.value
+      ? { start: selectedStartDate.value, end: selectedEndDate.value }
+      : null
+
+    const data: any = await fetchDeliveryAnalysis(selectedPeriod.value, range)
     const trendList = data.trendList
     const topList = data.topList
 
@@ -263,6 +288,27 @@ async function loadDeliveryData() {
 
 function selectPeriod(p: string) {
   selectedPeriod.value = p
+  customRangeEnabled.value = false
+  selectedStartDate.value = ''
+  selectedEndDate.value = ''
+  loadDeliveryData()
+}
+
+function toggleCustomRange() {
+  customRangeEnabled.value = !customRangeEnabled.value
+}
+
+function onDateRangeApply(range: { start: string; end: string }) {
+  selectedStartDate.value = range.start
+  selectedEndDate.value = range.end
+  customRangeEnabled.value = true
+  loadDeliveryData()
+}
+
+function onDateRangeClear() {
+  selectedStartDate.value = ''
+  selectedEndDate.value = ''
+  customRangeEnabled.value = false
   loadDeliveryData()
 }