附录2--电商系统设计

1. 业务场景

我们以一个简化版的电商网站项目为例，其中涉及到6块功能，分别是登录、添加商品、商品列表、下订单、我的订单、订单详情，每个功能都有相应的权限限制，并且调用对应的接口来做相应的业务逻辑处理，完成后跳转到下一页面。具体页面/功能、权限、调用接口、动作及跳转的逻辑关系如下：

项目的设计遵循前后端完全分离的设计模式，前端可以是Web、iOS、Android、小程序各种类型的客户端，但后端接口都是一致的，因此我们用代码实现上述6个接口功能，然后开发Web网站调用接口的实现电商下单购买支付的流程，并列举两个其中比较典型的安全问题，项目示例代码参见GitHub：https://github.com/8784285/order_web.git 。

2. 接口文档

1） 登录

• 接口url：http://127.0.0.1:5000/login
• 接口方法：POST
• 请求参数：

• 请求示例：

{
    "username": "Mr.null",
    "password": "dc483e80a7a0bd9ef71d8cf973673924"
}

• 返回结果：

• 返回示例：

{
  "code": 4,
  "msg": "登录成功",
  "token": "eyJhbGciOiJIUzUxMiIsImlhdCI6MTU5MTgzNzQ0MSwiZXhwIjoxNTkxOTIzODQxfQ.eyJ1c2VybmFtZSI6Ik1yLm51bGwiLCJwYXNzd29yZCI6ImRjNDgzZTgwYTdhMGJkOWVmNzFkOGNmOTczNjczOTI0In0.fJVi3MZXmEz9lue0gZUO0m_lG2I-8endYsGOP4FNCGZ9wdGpKDb-yDNGj9XCrRXtoIz0AGIh-v-_oPWeOSYspQ"
}

2） 添加商品

• 接口url：http://127.0.0.1:5000/add_product
• 接口方法：POST
• 请求参数：

• 请求示例：

{
"name":"Book",
"price":16.50,
"count":100
}

• 请求头：

• 返回结果：

• 返回示例：

{
  "code": 2001,
  "msg": "商品添加成功"
}

3）商品列表

• 接口url：http://127.0.0.1:5000/get_product
• 接口方法：GET
• 请求参数：

• 请求示例：

http://127.0.0.1:5000/get_product?name=Book

• 请求头：

• 返回结果：

• 返回示例：

{
  "code": 5,
  "data": {
    "count": 100,
    "name": "Book",
    "price": 12.5
  },
  "msg": "查询成功"
}

4）提交订单

• 接口url：http://127.0.0.1:5000/add_order
• 接口方法：POST
• 请求参数：

• 请求示例

{
    "sid":11,
    "orderprice":39.50,
    "username":"admin",
    "receiver":"张三",
    "phone":"13800138000",
    "address":"北京市海淀区长安街888号"
}

• 请求头：

• 返回结果：

• 返回示例：

{
  "code": 2003,
  "msg": "创建订单成功"
}

5）获取用户订单

• 接口url：http://127.0.0.1:5000/user_orderid
• 接口方法：GET
• 请求参数：

• 请求示例

http://192.168.160.94:5000/user_orderid?username=Mr.null

• 请求头：

• 返回结果：

• 返回示例：

{
  "code": 5,
  "msg": "查询成功",
  "orderid": [
    1,
    2
  ]
}

6）订单详情

• 接口url：http://127.0.0.1:5000/get_order
• 接口方法：GET
• 请求参数：

• 请求示例

http://192.168.160.94:5000/get_order?productid=12

• 请求头：

• 返回结果：

• 返回示例：

{
  "code": 5,
  "data": {
    "count": 100,
    "name": "Book",
    "price": 12.5
  },
  "msg": "查询成功"
}

3. 数据库结构

电商项目数据库共包含4个表，分别是

• stock：商品信息表
• stock_order：订单信息表
• users：用户表
• userinfo：用户详情信息表

数据库表结构及初始化数据如下（sql详见GitHub：）

-- phpMyAdmin SQL Dump
-- ve