修复文件

购物模块下单测试流程.md

@@ -0,0 +1,251 @@
+# 购物模块下单测试流程
+
+本文档描述完整的购物车下单、支付、发货、确认收货流程的API测试步骤。
+
+## 前置条件
+
+1. 启动应用：`mvn spring-boot:run`
+2. 应用访问地址：http://localhost:8080
+3. API文档地址：http://localhost:8080/doc.html
+4. 确保用户已登录并有有效session
+
+## 完整下单流程测试
+
+### 1. 添加商品到购物车
+
+```bash
+POST /api/cart/add
+Content-Type: application/json
+
+{
+  "productId": 1,
+  "quantity": 2
+}
+```
+
+**响应示例：**
+
+```json
+{
+  "success": true,
+  "message": "商品添加到购物车成功",
+  "data": {
+    "userId": 1,
+    "items": [
+      {
+        "productId": 1,
+        "productName": "iPhone 15",
+        "productPrice": 5999.00,
+        "quantity": 2,
+        "subtotal": 11998.00,
+        "stock": 100
+      }
+    ],
+    "totalPrice": 11998.00,
+    "totalQuantity": 2
+  }
+}
+```
+
+### 2. 查看购物车
+
+```bash
+GET /api/cart
+```
+
+### 3. 购物车下单
+
+```bash
+POST /api/cart/checkout
+Content-Type: application/json
+
+{
+  "productIds": [1]  // 可选，不传则下单所有商品
+}
+```
+
+**响应示例：**
+
+```json
+{
+  "success": true,
+  "message": "下单成功，请及时支付",
+  "data": {
+    "id": 10,
+    "userId": 1,
+    "productId": 1,
+    "productName": "iPhone 15",
+    "quantity": 2,
+    "totalPrice": 11998.00,
+    "status": 1,
+    "statusDescription": "待支付",
+    "orderType": 1,
+    "orderTypeDescription": "普通订单",
+    "createdAt": "2025-07-02 21:45:00"
+  }
+}
+```
+
+### 4. 模拟支付
+
+```bash
+POST /api/order/{orderId}/pay
+Content-Type: application/json
+
+{
+  "paymentMethod": "支付宝"  // 可选：支付宝、微信、银行卡等
+}
+```
+
+**响应示例：**
+
+```json
+{
+  "success": true,
+  "message": "支付成功",
+  "data": {
+    "id": 10,
+    "status": 2,
+    "statusDescription": "已支付",
+    "updatedAt": "2025-07-02 21:46:00"
+  },
+  "paymentMethod": "支付宝"
+}
+```
+
+### 5. 模拟发货（商家操作）
+
+```bash
+POST /api/order/{orderId}/ship
+```
+
+**响应示例：**
+
+```json
+{
+  "success": true,
+  "message": "订单发货成功",
+  "data": {
+    "id": 10,
+    "status": 3,
+    "statusDescription": "已发货",
+    "updatedAt": "2025-07-02 21:47:00"
+  }
+}
+```
+
+### 6. 确认收货（用户操作）
+
+```bash
+POST /api/order/{orderId}/confirm
+```
+
+**响应示例：**
+
+```json
+{
+  "success": true,
+  "message": "确认收货成功，订单已完成",
+  "data": {
+    "id": 10,
+    "status": 4,
+    "statusDescription": "已完成",
+    "updatedAt": "2025-07-02 21:48:00"
+  }
+}
+```
+
+### 7. 查看订单详情
+
+```bash
+GET /api/order/{orderId}
+```
+
+### 8. 查看我的订单列表
+
+```bash
+POST /api/order/my-orders
+Content-Type: application/json
+
+{
+  "page": 0,
+  "size": 10,
+  "status": null  // 可选：1-待支付, 2-已支付, 3-已发货, 4-已完成, 5-已取消
+}
+```
+
+## 订单状态流转
+
+```
+1. 待支付 (status=1) 
+   ↓ [用户支付]
+2. 已支付 (status=2)
+   ↓ [商家发货]
+3. 已发货 (status=3)
+   ↓ [用户确认收货]
+4. 已完成 (status=4)
+```
+
+## 异常情况测试
+
+### 1. 支付失败（1%概率）
+
+- 重新调用支付接口
+- 或取消订单
+
+### 2. 库存不足
+
+```bash
+POST /api/cart/add
+{
+  "productId": 1,
+  "quantity": 999999  // 超过库存
+}
+```
+
+### 3. 重复支付
+
+- 对已支付订单再次支付，应返回错误
+
+### 4. 状态不正确的操作
+
+- 对待支付订单直接发货
+- 对待发货订单直接确认收货
+
+## 额外功能
+
+### 取消订单
+
+```bash
+POST /api/order/{orderId}/cancel
+```
+
+### 批量购物车操作
+
+```bash
+POST /api/cart/batch-operation
+{
+  "operation": "remove",  // 或 "clear"
+  "productIds": [1, 2, 3]
+}
+```
+
+### 检查购物车库存
+
+```bash
+GET /api/cart/check-stock
+```
+
+## 测试建议
+
+1. **完整流程测试**：按照1-6步骤完整测试一次下单流程
+2. **并发测试**：多个用户同时下单同一商品测试库存控制
+3. **异常测试**：测试各种异常情况的处理
+4. **性能测试**：使用JMeter等工具进行压力测试
+
+## 注意事项
+
+1. 所有需要用户认证的接口都需要先登录获取session
+2. 支付接口有1秒的模拟延迟和1%的失败率
+3. 购物车数据存储在Redis中，有7天过期时间
+4. 订单状态变更会自动记录时间戳