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

pages/mall/analytics/product-insights.uvue

@@ -1,5 +1,5 @@
 <template>
-  <view class="page" @click="closeMoreMenu">
+  <view class="page" @click.self="closeMoreMenu">
     <!-- 固定顶部导航栏 -->
     <AnalyticsTopBar 
       :title="'商品洞察'"
@@ -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">
@@ -173,6 +188,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 { fetchProductOverview, fetchTopProducts, fetchProductTrend, fetchCategorySales, fetchStockInsights, fetchPriceTrend, fetchReviewInsights } from '@/services/analytics/productInsightsService.uts'
 import { mapAnalyticsError } from '@/services/analytics/errorMapper.uts'
@@ -182,6 +198,11 @@ import type { ProductData, ProductRank } from '@/types/analytics/product.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/product-insights')
@@ -251,7 +272,11 @@ async function loadSelectedProductTrend() {
       return
     }
 
-    const trend = await fetchProductTrend(selectedPeriod.value, selectedProductId.value)
+    const range = selectedStartDate.value && selectedEndDate.value
+      ? { start: selectedStartDate.value, end: selectedEndDate.value }
+      : null
+
+    const trend = await fetchProductTrend(selectedPeriod.value, selectedProductId.value, range)
     const rows: Array<any> = trend as any
 
     const x: Array<string> = []
@@ -367,12 +392,16 @@ async function loadProductData() {
   try {
     updateTime()
 
+    const range = selectedStartDate.value && selectedEndDate.value
+      ? { start: selectedStartDate.value, end: selectedEndDate.value }
+      : null
+
     const [overview, topList, catRows, stockRows, _priceRows, reviewRows] = await Promise.all([
-      fetchProductOverview(selectedPeriod.value),
-      fetchTopProducts(selectedPeriod.value, 10),
-      fetchCategorySales(selectedPeriod.value),
+      fetchProductOverview(selectedPeriod.value, range),
+      fetchTopProducts(selectedPeriod.value, 10, range),
+      fetchCategorySales(selectedPeriod.value, range),
       fetchStockInsights(selectedPeriod.value),
-      fetchPriceTrend(selectedPeriod.value),
+      fetchPriceTrend(selectedPeriod.value, range),
       fetchReviewInsights()
     ])
 
@@ -415,6 +444,27 @@ async function loadProductData() {
 
 function selectPeriod(p: string) {
   selectedPeriod.value = p
+  customRangeEnabled.value = false
+  selectedStartDate.value = ''
+  selectedEndDate.value = ''
+  loadProductData()
+}
+
+function toggleCustomRange() {
+  customRangeEnabled.value = !customRangeEnabled.value
+}
+
+function onDateRangeApply(range: { start: string; end: string }) {
+  selectedStartDate.value = range.start
+  selectedEndDate.value = range.end
+  customRangeEnabled.value = true
+  loadProductData()
+}
+
+function onDateRangeClear() {
+  selectedStartDate.value = ''
+  selectedEndDate.value = ''
+  customRangeEnabled.value = false
   loadProductData()
 }