1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40

1. 引言
   1.1 编写目的
   1.2 背景
   1.3 参考资料
   1.4 术语定义及说明

2. 设计概述
   2.1 任务和目标
   2.2 需求概述
   2.3 运行环境概述
   2.4 条件与限制
   2.5 详细设计方法和工具

3. 系统详细需求分析
   3.1 详细需求分析
   3.2 详细系统运行环境及限制条件分析
   3.3 接口需求分析

4. 总体方案确认
   4.1 系统总体结构确认
   4.2 系统详细界面划分

5. 系统详细设计
   5.1 系统结构设计及子系统划分
   5.2 系统功能模块详细设计
       （采用 HIPO 图进行功能分解与模块描述）
   5.3 用 IPO 或结构图描述各模块的组成结构、算法、模块间的接口关系，
       以及需求、功能和模块三者之间的交叉参照关系
   5.4 系统界面详细设计

6. 数据库系统设计
   6.1 数据库概念设计（E-R 图）
   6.2 数据库逻辑设计（表结构）
   6.3 数据库物理设计（索引 / 分区）
   6.4 数据字典

7. 接口设计
   7.1 内部接口（模块间）
   7.2 外部接口（系统间）
   7.3 用户接口（UI）

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

┌────────────────────────────────────┐
│           表现层（Web/App）         │
├────────────────────────────────────┤
│           API 网关（Gateway）       │
├────────────────────────────────────┤
│  业务服务层（订单 / 用户 / 报表）    │
├────────────────────────────────────┤
│  数据访问层（MyBatis / JPA）        │
├────────────────────────────────────┤
│  数据层（MySQL / Redis / MQ）      │
└────────────────────────────────────┘

1
2
3
4
5
6
7
8
9

                       订单中心
                          │
        ┌─────────────────┼─────────────────┐
        │                 │                 │
    订单创建          订单查询           订单修改
        │                 │                 │
   ┌────┴────┐        ┌───┴───┐        ┌────┴────┐
   │         │        │       │        │         │
 输入参数  业务规则  输入条件  返回结果 输入参数  业务规则

1
2
3
4
5
6
7
8
9

{
  "userId": "12345",
  "items": [
    {"productCode": "P001", "qty": 2, "price": 99.00},
    {"productCode": "P002", "qty": 1, "price": 199.00}
  ],
  "addressId": "A001",
  "remark": "请尽快发货"
}

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49

def create_order(user_id, items, address_id, remark):
    # 1. 校验登录
    user = check_login(user_id)
    if not user:
        return error(401, "未登录")

    # 2. 校验库存
    for item in items:
        stock = get_stock(item.product_code)
        if stock < item.qty:
            return error(400, f"商品 {item.product_code} 库存不足")

    # 3. 校验地址
    address = get_address(address_id)
    if not address or address.user_id != user_id:
        return error(400, "地址无效")

    # 4. 计算金额
    total = 0
    for item in items:
        total += item.qty * item.price
    shipping_fee = calc_shipping(address, total)
    discount = calc_discount(user, total)
    final_total = total + shipping_fee - discount

    # 5. 创建订单
    with transaction():
        order_no = generate_order_no()
        order = Order(
            order_no=order_no,
            user_id=user_id,
            status="待付款",
            total=final_total,
            remark=remark
        )
        order.save()

        for item in items:
            order_item = OrderItem(
                order_no=order_no,
                **item
            )
            order_item.save()

        # 6. 冻结库存
        for item in items:
            freeze_stock(item.product_code, item.qty, order_no)

    return success({"order_no": order_no, "total": final_total})

1
2
3
4
5
6
7
8

{
  "code": 200,
  "data": {
    "orderNo": "SO20250915001",
    "total": 397.00,
    "payUrl": "https://pay.example.com/..."
  }
}

1
2
3
4
5
6

{
  "userId": "12345",
  "page": 1,
  "size": 20,
  "status": "待发货"
}

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14

{
  "code": 200,
  "data": {
    "total": 50,
    "list": [
      {
        "orderNo": "SO20250915001",
        "status": "待发货",
        "total": 397.00,
        "items": [...]
      }
    ]
  }
}

1
2
3

用户 ──< 订单 >── 订单明细 >── 商品
                       │
                       └──< 支付

1
2
3
4
5
6
7

{
  "code": 200,
  "message": "success",
  "data": { ... },
  "timestamp": "2025-09-15T10:00:00Z",
  "traceId": "abc123"
}

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

POST /api/orders HTTP/1.1
Content-Type: application/json
Authorization: Bearer eyJhbGc...

{
  "items": [
    {"productCode": "P001", "qty": 2, "price": 99.00}
  ],
  "addressId": "A001",
  "remark": "请尽快发货"
}

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12

HTTP/1.1 200 OK
Content-Type: application/json

{
  "code": 200,
  "message": "success",
  "data": {
    "orderNo": "SO20250915001",
    "total": 198.00,
    "payUrl": "https://pay.example.com/..."
  }
}