cc_shop 需求文档

1.需求分析

index页面: 商品分类 广告设置

1.2 商品的列表页

1.3 商品详情页

1.4 商品的搜索

1.5 用户的注册

1.6用户的登录

1.7 用户信息

1.8用户地址

1.9用户密码

1.10订单管理

1.11商品的评论

缺页面

1.12 支付页面

1.13 总结

后端的模块:
商品模块
用户模块
订单模块
搜索模块

数据库:MySql

缓存:Redis

异步服务:celery

图片存储:第三方图片服务器/FDS

2, 接口的设计

2.1 图片验证码

访问路径: GET /image_code/(?P<image_code_id>[\w-]+)/

url(r'^image_code/(?P<image_code_id>'
    r'[0-9a-z]{8}-*[0-9a-z]{4}-*[0-9a-z]{4}-*[0-9a-z]{4}-*[0-9a-z]{12})/',ImageView.as_view()),

返回数据: 验证码图片
请求参数:
路径携带参数: image_code_id uuid类型 必填

| 参数名字 | 参数类型 |是否必填|说明|
|image_code_id|uuid类型|是|将来用来储存的每一个验证码(在redis中的健名即id)

后端:根据设计的接口写一个APIView视图类 Image_view()
参数有uuid,先调用第三方包的 Captcha() 对象的generate_captcha 方法,返回验证码和验证码图片

2.2 短信验证码

访问路径:POST /phone_code/
请求参数:

| 参数名字 | 参数类型 |是否必填|说明|
|image_code_id| uuid类型 | 是 |将来用来储存的每一个验证码(在redis中的健名即id)
| phone | str | 是 |用户的手机号码
| image_text | str | 是 |用户输入的图片验证码内容

返回数据:json数据

detail str 是 告诉前端是否发生短信成功

2.3 进行用户的注册

访问路径:POST /user/register/
请求参数:
username str
password str
cpassword str
phone str
email str
phone_code str

返回数据: json 数据

2.4 进行手机号码的验证

访问路径: POST /user/(?P\d{11})/
请求参数:
phone str 必填 手机号码的校验

返回类型:json

2.5 登录界面的设计

访问路径 POST /user/logon
请求参数:
username str 必填
password str 必填

返回数据
json数据
username
user_id
token

2.6 用户信息的展示和修改

访问路径 GET和PUT /user/userinfo/

请求参数
get 请求:参数为token
put 请求:参数为token,username,phone,email

返回数据
json
username
email
phone
is_active

2.7 展示省市区的信息

省(pid null)
访问路径 GET /user/province
请求参数
返回数据
json:
id int 必须
atitle str 必须

市区数据获取
访问路径 GET /user/city/(?P<Pk>\d+)/
请求参数
pk int 必须 父级id
返回数据
json
id int 是 父级id
atitle str 是 父级名称
subs 列表 是 所有查询到的数据

商品列表页

请求方式:GET: /goods/list?

请求参数:

cate_id int类型 必填 三级目录的id
page int类型 必填 页数
data_size int 否 每一页请求的数据量
sorted str 否 排序的方式,不传给默认值,综合,销量,价格

返回的数据:json

2.10 增加用户购物车的接口

请求方式:
GET: /shop/
sku_id int 是
nums int 否 不写默认为0
返回:
json

注意点:该接口在登录的基础上