妆品运营审核调整赠品数量后端设计文档

妆品运营审核调整赠品数量后端设计文档

1 引言

1.1 背景

项目名称：化妆品运营审核调整赠品数量

项目设计小组：

项目实施小组：

1.2 编写目的和范围

本文档的目的是说明化妆品运营审核调整赠品数量的程序模块设计考虑，包括描述程序的流程逻辑和数据库设计，为软件编程提供基础。

本文档的预期读者为软件设计人员、软件开发人员和软件测试人员。

2 概要设计

2.1 需求分析

本项目是为化妆品运营审核赠品调整提供的后端接口，用户可以给指定订单添加赠品，也可以删除指定订单的赠品。

在营审核页面中，状态为‘待运营审核’的订单，可以对订单进行添加和删除赠品操作
增加赠品。

增加赠品

点击‘+’按钮后，可以增加新的一行赠品，增加的赠品为商品中心取得的全部上架商品（包括终端品，商品）且有价格，可以添加多行。

删除赠品

点击‘-’可以删除已有赠品行项目。本品不可以删除

点击‘同意’后，保存调整后增减的赠品。添加后的赠品数据同订单搭赠带出的行项目内容格式一致。将修改后的订单明细传入scm，sap系统。

2.2 环境

Java开发环境：JDK11

数据库：MySQL

后端：Spring cloud

开发工具：IDEA

3 详细设计

3.1 详细功能设计

1.运营审核页面增加‘增减赠品’按钮。状态为‘待运营审核’的订单显示此按钮。其他状态订单不可以修改。 也就是说，这个按钮不用改动，只是查询的时候需要有id传进来，状态为待运营审核的订单会显示出此按钮，需要判断。

2.点击‘+’按钮后，可以增加新的一行赠品，增加的赠品为商品中心取得的全部上架商品（包括终端品，商品）且有价格，可以添加多行。点击‘-’可以删除已有赠品行项目。

3.点击‘同意’后，保存调整后增减的赠品。添加后的赠品数据同订单搭赠带出的行项目内容格式一致。将修改后的订单明细传入scm，sap系统。

4.有过增减的行项目记录下来修改人。 做过操作的需要有字段来记录(放update里

5.赠品承担比例为公司100%，公司承担比例为1，经销商承担比例为0，经销商毛利承担比例为0。

3.2 接口设计

接口名称	接口说明	传入参数格式	返回参数格式	请求类型
searchPage	该接口是用于返回经销商订单查询结果列表	JSON	JSON	POST
admin-pass	营运审核通过订单接口	JSON	JSON	POST
delete	删除赠品	JSON	JSON	POST
addGift	添加赠品	JSON	JSON	POST

3.2.1 查询经销商订单(分页)修改（searchPage）

传入参数

{
  "dealerSapCode": "demoData",
  "refDealer": 1,
  "sapOrderNo": "demoData",
  "orderType": "demoData",
  "reason": "demoData",
  "status": "demoData",
  "startDt": "2021/6/8, 3:35 下午",
  "endDt": "2021/6/8, 3:35 下午",
  "page": 1,
  "pageSize": 1,
  "mode": "demoData",
  "orderId": 1
}

返回结果

公共返回结果（外层结构）data中包含的参数（当success为true时包含）：

参数名	必传	类型	示例值	说明
success	是	Boolean	true	调用是否成功
msg	是	String	系统错误	调用结果消息
errorList	否	List	[{“errorMsg”: “系统错误”}]	错误列表
data	否	String		当success为true时包含

{
  "prodSkuCode": "demoData",
  "itemName": "demoData",
  "orderQty": 1,
  "unitPrice": 1,
  "costPrice": 1,
  "orderAmt": 1,
  "isGift": 1,
  "promotionId": 1,
  "promotionNo": "demoData"
}

3.2.2营运审核通过订单接口（admin-pass）

传入参数

{
  "serialVersionUID": 1,
  "orderId": 1,
  "serialNo": "demoData",
  "sapOrderNo": "demoData",
  "operator": "demoData",
  "statues": "demoData",
  "comment": "demoData",
  "scmResult": "demoData",
  "orderType": "demoData",
  "reason": "demoData"
}

返回结果

公共返回结果（外层结构）data中包含的参数（当success为true时包含）：

参数名	必传	类型	示例值	说明
success	是	Boolean	true	调用是否成功
msg	是	String	系统错误	调用结果消息
errorList	否	List	[{“errorMsg”: “系统错误”}]	错误列表
data	否	String		当success为true时包含

{
  "TRUE": true,
  "FALSE": true,
  "value": true,
  "serialVersionUID": 1
}

3.2.3 删除赠品（delete）

传入参数

{
  "serialVersionUID": 1,
  "orderId": 1
}

返回结果

公共返回结果（外层结构）data中包含的参数（当success为true时包含）：

参数名	必传	类型	示例值	说明
success	是	Boolean	true	调用是否成功
msg	是	String	系统错误	调用结果消息
errorList	否	List	[{“errorMsg”: “系统错误”}]	错误列表
data	否	String		当success为true时包含

{
  "TRUE": true,
  "FALSE": true,
  "value": true,
  "serialVersionUID": 1
}

3.2.4 增加赠品（addGift）

传入参数

{
	"Id" :
	"ref_order" : 
	"ref_order_type": ,
	"ref_item"" :
	"item_name""
	"red_sku"  :
	"fwe_nmame":
  	"unit_price":
  	"order_qty":；
  	"ref_sku":
  	"unit_price":
  	"cost_price":
  	"order_qty":

  	 

}

3.3 数据库设计

3.3.1 赠品订单详情表 (order_bought_gift_dtl)

字段名称	类型	长度	说明
id	int	11	订单赠品详细id
promotion_id	int	11	促销活动id
promotion_no	varchar	32	促销活动号
ref_order	int	11	销售订单or分销订单
ref_order_type	int	11	1销售订单 2分销订单
ref_item	int	11	商品
item_name	int	11	商品名
ref_sku	int	11	SKU
ref_promotion_sku	int	11	促销活动SKU
unit_price	decimal	（9,2）	单价
cost_price	decimal	（9,2）	成本价
order_qty	int	11	订单数量
company_commitment_ratio	decimal	（9,2）	公司承担比例
dealer_commitment_ratio	decimal	（9,2）	经销商承担比例
dealer_grossMargin_ratio	decimal	（9,2）	经销商毛利承担比例
status	varchar	2	明细状态
state	char	1	Y正常,N作废
create_by	varchar	32	创建人
create_dt	datetime		创建时间
update_by	varchar	32	修改人
update_dt	datetime		修改时间

3.3.2 调整赠品订单详情表（order_modify_bought_gift_dtl）

字段名称	类型	长度	说明
id	int	11	订单赠品详细id
ref_order	int	11	销售订单or分销订单
ref_order_type	int	11	1销售订单 2分销订单
ref_item	int	11	商品
item_name	int	11	商品名
ref_sku	int	11	SKU
unit_price	decimal	（9,2）	单价
cost_price	decimal	（9,2）	成本价
order_qty	int	11	订单数量
company_commitment_ratio	decimal	（9,2）	公司承担比例
dealer_commitment_ratio	decimal	（9,2）	经销商承担比例
dealer_grossMargin_ratio	decimal	（9,2）	经销商毛利承担比例
status	varchar	2	明细状态
state	char	1	Y正常,N作废
status	varchar	2	明细状态
create_by	varchar	32	创建人
create_dt	datetime		创建时间
update_by	varchar	32	修改人
update_dt	datetime		修改时间