From e1647902e29a5200875d02e4aa760e0e797e6f28 Mon Sep 17 00:00:00 2001
From: ylweng <mapleaf@aitoagro.com>
Date: Mon, 1 Sep 2025 01:23:49 +0800
Subject: [PATCH] =?UTF-8?q?docs:=20=E6=9B=B4=E6=96=B0=E9=A1=B9=E7=9B=AE?=
 =?UTF-8?q?=E6=96=87=E6=A1=A3=EF=BC=8C=E5=AE=8C=E5=96=84=E9=9C=80=E6=B1=82?=
 =?UTF-8?q?=E5=92=8C=E6=8A=80=E6=9C=AF=E7=BB=86=E8=8A=82?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 admin_website/src/views/Orders.vue     | 164 ++++++++++---------------
 admin_website/src/views/Statistics.vue |  65 +++++-----
 backend/API接口文档.md                 |  46 +++----
 backend/后台管理系统API文档.md         |   7 +-
 4 files changed, 119 insertions(+), 163 deletions(-)

diff --git a/admin_website/src/views/Orders.vue b/admin_website/src/views/Orders.vue
index 831d61f..337e065 100644
--- a/admin_website/src/views/Orders.vue
+++ b/admin_website/src/views/Orders.vue
@@ -37,33 +37,33 @@
       <!-- 订单列表 -->
       <el-table :data="orderList" border style="width: 100%" v-loading="loading">
         <el-table-column prop="id" label="ID" width="80" />
-        <el-table-column prop="orderNo" label="订单号" width="180" />
+        <el-table-column prop="order_number" label="订单号" width="180" />
         <el-table-column prop="username" label="用户" />
         <el-table-column prop="phone" label="手机号" width="120" />
-        <el-table-column prop="amount" label="订单金额" width="100">
+        <el-table-column prop="total_amount" label="订单金额" width="100">
           <template #default="scope">
-            ¥{{ scope.row.amount }}
+            ¥{{ scope.row.total_amount }}
           </template>
         </el-table-column>
         <el-table-column label="支付状态" width="100">
           <template #default="scope">
-            <el-tag v-if="scope.row.paymentStatus === 'pending'">待支付</el-tag>
-            <el-tag v-else-if="scope.row.paymentStatus === 'paid'" type="success">已支付</el-tag>
-            <el-tag v-else-if="scope.row.paymentStatus === 'cancelled'" type="danger">已取消</el-tag>
-            <el-tag v-else>{{ scope.row.paymentStatus }}</el-tag>
+            <el-tag v-if="scope.row.payment_status === 'pending'">待支付</el-tag>
+            <el-tag v-else-if="scope.row.payment_status === 'paid'" type="success">已支付</el-tag>
+            <el-tag v-else-if="scope.row.payment_status === 'cancelled'" type="danger">已取消</el-tag>
+            <el-tag v-else>{{ scope.row.payment_status }}</el-tag>
           </template>
         </el-table-column>
         <el-table-column label="发货状态" width="100">
           <template #default="scope">
-            <el-tag v-if="scope.row.shippingStatus === 'pending'">待发货</el-tag>
-            <el-tag v-else-if="scope.row.shippingStatus === 'shipped'" type="success">已发货</el-tag>
-            <el-tag v-else-if="scope.row.shippingStatus === 'completed'" type="primary">已完成</el-tag>
-            <el-tag v-else>{{ scope.row.shippingStatus }}</el-tag>
+            <el-tag v-if="scope.row.shipping_status === 'pending'">待发货</el-tag>
+            <el-tag v-else-if="scope.row.shipping_status === 'shipped'" type="success">已发货</el-tag>
+            <el-tag v-else-if="scope.row.shipping_status === 'completed'" type="primary">已完成</el-tag>
+            <el-tag v-else>{{ scope.row.shipping_status }}</el-tag>
           </template>
         </el-table-column>
-        <el-table-column prop="createTime" label="下单时间" width="180">
+        <el-table-column prop="created_at" label="下单时间" width="180">
           <template #default="scope">
-            {{ formatDate(scope.row.createTime) }}
+            {{ formatDate(scope.row.created_at) }}
           </template>
         </el-table-column>
         <el-table-column label="操作" width="150">
@@ -73,7 +73,7 @@
               size="small" 
               type="primary" 
               @click="handleUpdateStatus(scope.row)"
-              :disabled="scope.row.paymentStatus === 'cancelled'"
+              :disabled="scope.row.payment_status === 'cancelled'"
             >
               状态
             </el-button>
@@ -96,37 +96,37 @@
       <!-- 订单详情对话框 -->
       <el-dialog v-model="detailDialogVisible" title="订单详情" width="700px">
         <el-descriptions :column="1" border>
-          <el-descriptions-item label="订单号">{{ currentOrder.orderNo }}</el-descriptions-item>
+          <el-descriptions-item label="订单号">{{ currentOrder.order_number }}</el-descriptions-item>
           <el-descriptions-item label="用户">{{ currentOrder.username }}</el-descriptions-item>
           <el-descriptions-item label="手机号">{{ currentOrder.phone }}</el-descriptions-item>
-          <el-descriptions-item label="订单金额">¥{{ currentOrder.amount }}</el-descriptions-item>
+          <el-descriptions-item label="订单金额">¥{{ currentOrder.total_amount }}</el-descriptions-item>
           <el-descriptions-item label="支付状态">
-            <el-tag v-if="currentOrder.paymentStatus === 'pending'">待支付</el-tag>
-            <el-tag v-else-if="currentOrder.paymentStatus === 'paid'" type="success">已支付</el-tag>
-            <el-tag v-else-if="currentOrder.paymentStatus === 'cancelled'" type="danger">已取消</el-tag>
-            <el-tag v-else>{{ currentOrder.paymentStatus }}</el-tag>
+            <el-tag v-if="currentOrder.payment_status === 'pending'">待支付</el-tag>
+            <el-tag v-else-if="currentOrder.payment_status === 'paid'" type="success">已支付</el-tag>
+            <el-tag v-else-if="currentOrder.payment_status === 'cancelled'" type="danger">已取消</el-tag>
+            <el-tag v-else>{{ currentOrder.payment_status }}</el-tag>
           </el-descriptions-item>
           <el-descriptions-item label="发货状态">
-            <el-tag v-if="currentOrder.shippingStatus === 'pending'">待发货</el-tag>
-            <el-tag v-else-if="currentOrder.shippingStatus === 'shipped'" type="success">已发货</el-tag>
-            <el-tag v-else-if="currentOrder.shippingStatus === 'completed'" type="primary">已完成</el-tag>
-            <el-tag v-else>{{ currentOrder.shippingStatus }}</el-tag>
+            <el-tag v-if="currentOrder.shipping_status === 'pending'">待发货</el-tag>
+            <el-tag v-else-if="currentOrder.shipping_status === 'shipped'" type="success">已发货</el-tag>
+            <el-tag v-else-if="currentOrder.shipping_status === 'completed'" type="primary">已完成</el-tag>
+            <el-tag v-else>{{ currentOrder.shipping_status }}</el-tag>
           </el-descriptions-item>
-          <el-descriptions-item label="收货地址">{{ currentOrder.shippingAddress }}</el-descriptions-item>
-          <el-descriptions-item label="下单时间">{{ formatDate(currentOrder.createTime) }}</el-descriptions-item>
+          <el-descriptions-item label="收货地址">{{ currentOrder.shipping_address }}</el-descriptions-item>
+          <el-descriptions-item label="下单时间">{{ formatDate(currentOrder.created_at) }}</el-descriptions-item>
         </el-descriptions>
 
         <el-table :data="currentOrder.items" style="margin-top: 20px;" border>
-          <el-table-column prop="productName" label="商品名称" />
+          <el-table-column prop="product_name" label="商品名称" />
           <el-table-column prop="quantity" label="数量" width="80" />
-          <el-table-column prop="unitPrice" label="单价" width="100">
+          <el-table-column prop="unit_price" label="单价" width="100">
             <template #default="scope">
-              ¥{{ scope.row.unitPrice }}
+              ¥{{ scope.row.unit_price }}
             </template>
           </el-table-column>
           <el-table-column label="小计" width="100">
             <template #default="scope">
-              ¥{{ (scope.row.unitPrice * scope.row.quantity).toFixed(2) }}
+              ¥{{ (scope.row.unit_price * scope.row.quantity).toFixed(2) }}
             </template>
           </el-table-column>
         </el-table>
@@ -142,14 +142,14 @@
       <el-dialog v-model="statusDialogVisible" title="更新订单状态" width="500px">
         <el-form :model="statusForm" label-width="100px">
           <el-form-item label="支付状态">
-            <el-select v-model="statusForm.paymentStatus" placeholder="请选择">
+            <el-select v-model="statusForm.payment_status" placeholder="请选择">
               <el-option label="待支付" value="pending" />
               <el-option label="已支付" value="paid" />
               <el-option label="已取消" value="cancelled" />
             </el-select>
           </el-form-item>
           <el-form-item label="发货状态">
-            <el-select v-model="statusForm.shippingStatus" placeholder="请选择">
+            <el-select v-model="statusForm.shipping_status" placeholder="请选择">
               <el-option label="待发货" value="pending" />
               <el-option label="已发货" value="shipped" />
               <el-option label="已完成" value="completed" />
@@ -169,7 +169,8 @@
 
 <script>
 import { ref, reactive, onMounted } from 'vue'
-import { ElMessage, ElMessageBox } from 'element-plus'
+import { ElMessage } from 'element-plus'
+import { orderAPI } from '../utils/api'
 
 export default {
   name: 'Orders',
@@ -186,8 +187,8 @@ export default {
     
     const statusForm = reactive({
       id: null,
-      paymentStatus: '',
-      shippingStatus: ''
+      payment_status: '',
+      shipping_status: ''
     })
     
     const orderList = ref([])
@@ -209,58 +210,23 @@ export default {
     const fetchOrders = async () => {
       loading.value = true
       try {
-        // 模拟API调用
-        await new Promise(resolve => setTimeout(resolve, 500))
+        const params = {
+          page: pagination.page,
+          limit: pagination.limit,
+          status: searchForm.status,
+          start_date: dateRange.value && dateRange.value[0] ? dateRange.value[0] : undefined,
+          end_date: dateRange.value && dateRange.value[1] ? dateRange.value[1] : undefined
+        }
         
-        // 模拟数据
-        orderList.value = [
-          {
-            id: 1,
-            orderNo: 'ORD202401150001',
-            username: 'user001',
-            phone: '13800001111',
-            amount: 199,
-            paymentStatus: 'paid',
-            shippingStatus: 'shipped',
-            createTime: '2024-01-15 10:30:00',
-            shippingAddress: '浙江省杭州市西湖区文三路159号',
-            items: [
-              { productName: 'AI鉴花小程序', quantity: 1, unitPrice: 199 }
-            ]
-          },
-          {
-            id: 2,
-            orderNo: 'ORD202401160002',
-            username: 'admin',
-            phone: '13900002222',
-            amount: 598,
-            paymentStatus: 'paid',
-            shippingStatus: 'pending',
-            createTime: '2024-01-16 14:20:00',
-            shippingAddress: '浙江省杭州市滨江区网商路699号',
-            items: [
-              { productName: '花卉识别API', quantity: 2, unitPrice: 299 }
-            ]
-          },
-          {
-            id: 3,
-            orderNo: 'ORD202401170003',
-            username: 'editor001',
-            phone: '13700003333',
-            amount: 999,
-            paymentStatus: 'pending',
-            shippingStatus: 'pending',
-            createTime: '2024-01-17 09:15:00',
-            shippingAddress: '浙江省杭州市余杭区五常大道1001号',
-            items: [
-              { productName: '企业版解决方案', quantity: 1, unitPrice: 999 }
-            ]
-          }
-        ]
-        
-        pagination.total = orderList.value.length
+        const response = await orderAPI.getOrders(params)
+        if (response.code === 200) {
+          orderList.value = response.data.orders
+          pagination.total = response.data.pagination.total
+        } else {
+          ElMessage.error(response.message || '获取订单列表失败')
+        }
       } catch (error) {
-        ElMessage.error('获取订单列表失败')
+        ElMessage.error('获取订单列表失败: ' + error.message)
       } finally {
         loading.value = false
       }
@@ -282,35 +248,35 @@ export default {
     
     // 查看订单详情
     const handleView = (row) => {
-      currentOrder.value = { ...row }
+      currentOrder.value = row
       detailDialogVisible.value = true
     }
     
     // 更新订单状态
     const handleUpdateStatus = (row) => {
       statusForm.id = row.id
-      statusForm.paymentStatus = row.paymentStatus
-      statusForm.shippingStatus = row.shippingStatus
+      statusForm.payment_status = row.payment_status
+      statusForm.shipping_status = row.shipping_status
       statusDialogVisible.value = true
     }
     
     // 提交状态更新
     const submitStatusUpdate = async () => {
       try {
-        // 模拟API调用
-        await new Promise(resolve => setTimeout(resolve, 300))
+        const response = await orderAPI.updateOrderStatus(statusForm.id, {
+          payment_status: statusForm.payment_status,
+          shipping_status: statusForm.shipping_status
+        })
         
-        // 更新订单状态
-        const index = orderList.value.findIndex(item => item.id === statusForm.id)
-        if (index !== -1) {
-          orderList.value[index].paymentStatus = statusForm.paymentStatus
-          orderList.value[index].shippingStatus = statusForm.shippingStatus
+        if (response.code === 200) {
+          ElMessage.success('状态更新成功')
+          statusDialogVisible.value = false
+          fetchOrders()
+        } else {
+          ElMessage.error(response.message || '状态更新失败')
         }
-        
-        ElMessage.success('状态更新成功')
-        statusDialogVisible.value = false
       } catch (error) {
-        ElMessage.error('状态更新失败')
+        ElMessage.error('状态更新失败: ' + error.message)
       }
     }
     
diff --git a/admin_website/src/views/Statistics.vue b/admin_website/src/views/Statistics.vue
index a779420..2caa494 100644
--- a/admin_website/src/views/Statistics.vue
+++ b/admin_website/src/views/Statistics.vue
@@ -107,6 +107,7 @@
 import { ref, reactive, onMounted } from 'vue'
 import * as echarts from 'echarts'
 import { statisticsAPI } from '../utils/api'
+import { ElMessage } from 'element-plus'
 
 export default {
   name: 'Statistics',
@@ -137,60 +138,62 @@ export default {
     // 获取统计数据
     const fetchStatsData = async () => {
       try {
-        // 模拟数据
-        statsData.userCount = 1234
-        statsData.productCount = 567
-        statsData.orderCount = 890
-        statsData.totalRevenue = 123456.78
+        const response = await statisticsAPI.getUserStats()
+        if (response.code === 200) {
+          statsData.userCount = response.data.user_count
+          statsData.productCount = response.data.product_count
+          statsData.orderCount = response.data.order_count
+          statsData.totalRevenue = response.data.total_revenue
+        } else {
+          ElMessage.error(response.message || '获取统计数据失败')
+        }
       } catch (error) {
-        console.error('获取统计数据失败:', error)
+        ElMessage.error('获取统计数据失败: ' + error.message)
       }
     }
     
     // 获取用户图表数据
     const fetchUserChartData = async () => {
       try {
-        // 模拟数据
-        chartData.userGrowth = {
-          dates: ['1月1日', '1月2日', '1月3日', '1月4日', '1月5日', '1月6日', '1月7日'],
-          counts: [10, 25, 15, 30, 20, 35, 40]
+        const response = await statisticsAPI.getUserStats()
+        if (response.code === 200) {
+          chartData.userGrowth = response.data.user_growth
+          renderUserChart()
+        } else {
+          ElMessage.error(response.message || '获取用户图表数据失败')
         }
-        renderUserChart()
       } catch (error) {
-        console.error('获取用户图表数据失败:', error)
+        ElMessage.error('获取用户图表数据失败: ' + error.message)
       }
     }
     
     // 获取分类图表数据
     const fetchCategoryChartData = async () => {
       try {
-        // 模拟数据
-        chartData.categoryDistribution = [
-          { name: '鲜花', value: 45 },
-          { name: '盆栽', value: 30 },
-          { name: '种子', value: 15 },
-          { name: '工具', value: 10 }
-        ]
-        renderCategoryChart()
+        const response = await statisticsAPI.getProductStats()
+        if (response.code === 200) {
+          chartData.categoryDistribution = response.data.category_distribution
+          renderCategoryChart()
+        } else {
+          ElMessage.error(response.message || '获取分类图表数据失败')
+        }
       } catch (error) {
-        console.error('获取分类图表数据失败:', error)
+        ElMessage.error('获取分类图表数据失败: ' + error.message)
       }
     }
     
     // 获取订单状态图表数据
     const fetchOrderStatusChartData = async () => {
       try {
-        // 模拟数据
-        chartData.orderStatusDistribution = [
-          { name: '待支付', value: 20 },
-          { name: '已支付', value: 50 },
-          { name: '已发货', value: 15 },
-          { name: '已完成', value: 10 },
-          { name: '已取消', value: 5 }
-        ]
-        renderOrderStatusChart()
+        const response = await statisticsAPI.getOrderStats()
+        if (response.code === 200) {
+          chartData.orderStatusDistribution = response.data.status_distribution
+          renderOrderStatusChart()
+        } else {
+          ElMessage.error(response.message || '获取订单状态图表数据失败')
+        }
       } catch (error) {
-        console.error('获取订单状态图表数据失败:', error)
+        ElMessage.error('获取订单状态图表数据失败: ' + error.message)
       }
     }
     
diff --git a/backend/API接口文档.md b/backend/API接口文档.md
index 570112a..3cd9835 100644
--- a/backend/API接口文档.md
+++ b/backend/API接口文档.md
@@ -6,18 +6,15 @@
 
 ## 基础信息
 
-- **基础URL**: `http://localhost:3200/api/v1`
+- **Base URL**: `http://localhost:3200/api/v1`
 - **认证方式**: Bearer Token (JWT)
-- **数据格式**: JSON
-- **字符编码**: UTF-8
+- **响应格式**: JSON
 
 ## 认证接口
 
 ### 用户注册
 
-```http
-POST /auth/register
-```
+**POST** `/auth/register`
 
 **请求参数**:
 
@@ -30,6 +27,7 @@ POST /auth/register
 | user_type | string | 否 | 用户类型（farmer/buyer/admin） |
 
 **响应示例**:
+
 ```json
 {
   "code": 201,
@@ -47,9 +45,7 @@ POST /auth/register
 
 ### 用户登录
 
-```http
-POST /auth/login
-```
+**POST** `/auth/login`
 
 **请求参数**:
 
@@ -59,6 +55,7 @@ POST /auth/login
 | password | string | 是 | 密码 |
 
 **响应示例**:
+
 ```json
 {
   "code": 200,
@@ -79,9 +76,7 @@ POST /auth/login
 
 ### 获取用户信息
 
-```http
-GET /users/me
-```
+**GET** `/users/me`
 
 **请求头**:
 ```
@@ -89,6 +84,7 @@ Authorization: Bearer <token>
 ```
 
 **响应示例**:
+
 ```json
 {
   "code": 200,
@@ -108,9 +104,7 @@ Authorization: Bearer <token>
 
 ### 更新用户信息
 
-```http
-PUT /users/{id}
-```
+**PUT** `/users/{id}`
 
 **请求参数**:
 
@@ -124,9 +118,7 @@ PUT /users/{id}
 
 ### 获取商品列表
 
-```http
-GET /products
-```
+**GET** `/products`
 
 **查询参数**:
 
@@ -142,6 +134,7 @@ GET /products
 | sort_order | string | 排序方向（asc/desc） |
 
 **响应示例**:
+
 ```json
 {
   "code": 200,
@@ -171,17 +164,13 @@ GET /products
 
 ### 获取商品详情
 
-```http
-GET /products/{id}
-```
+**GET** `/products/{id}`
 
 ## 订单接口
 
 ### 创建订单
 
-```http
-POST /orders
-```
+**POST** `/orders`
 
 **请求参数**:
 
@@ -204,9 +193,7 @@ POST /orders
 
 ### 花卉识别
 
-```http
-POST /identifications/identify
-```
+**POST** `/identifications/identify`
 
 **请求格式**: `multipart/form-data`
 
@@ -217,6 +204,7 @@ POST /identifications/identify
 | image | file | 是 | 花卉图片文件 |
 
 **响应示例**:
+
 ```json
 {
   "code": 200,
@@ -244,9 +232,7 @@ POST /identifications/identify
 
 ### 获取识别历史
 
-```http
-GET /identifications
-```
+**GET** `/identifications`
 
 ## 错误码说明
 
diff --git a/backend/后台管理系统API文档.md b/backend/后台管理系统API文档.md
index 46938a9..0b8b28e 100644
--- a/backend/后台管理系统API文档.md
+++ b/backend/后台管理系统API文档.md
@@ -4,7 +4,7 @@
 
 ## 基础信息
 
-- **Base URL**: `http://localhost:3200/api`
+- **Base URL**: `http://localhost:3200/api/v1`
 - **认证方式**: Bearer Token (JWT)
 - **响应格式**: JSON
 
@@ -258,9 +258,10 @@
 | 错误码 | 说明 |
 |--------|------|
 | 200 | 成功 |
-| 400 | 请求参数错误 |
+| 201 | 创建成功 |
+| 400 | 参数错误 |
 | 401 | 未授权 |
-| 403 | 权限不足 |
+| 403 | 禁止访问 |
 | 404 | 资源不存在 |
 | 409 | 资源冲突 |
 | 500 | 服务器内部错误 |