1.简介

本文档描述养殖项目-销售模块设计内容。主要包括接口文档设计、状态机图、业务流程图。

2.接口文档

详情见内部接口文档中心

• 查询用户可操作的猪舍列表（通用接口）
• 查询猪舍中符合条件的种猪或商品猪（通用接口）
• 销售类型列表查询-（1-种猪相关销售类型 2-商品猪相关销售类型）
• 查询客户信息（阳光竞拍会员信息查询）
• 耳缺号查询-查询的范围为原型图中规定的状态
• 销售单据生成接口（新增生成，修改生成）
• 销售单据提交接口 （已保存单据，但未提交）
• 销售单据详情查询接口
• 销售单据列表查询接口
• 销售单删除接口
• 销售单撤回提交接口-（是否回滚猪只状态）
• 销售单撤销审核接口- （是否回滚猪只状态）

3.状态机设计

销售单据状态包含如下5种状态：

• 1-待提交
• 2-待审核
• 3-已撤回
• 4-已审核
• 5-已撤销

其状态图如下：

4.关键业务流程图

销售模块的难点在生成销售单据。下面文章的内容也基本都是生成销售单据相关的。其他的操作简单记录一下。

4.1生成销售单据（提交、保存）

销售单据类型包含种猪和商品猪两种类型。下面分别是生成销售单据整体流程图和生成销售单后端逻辑的流程图。

• 生成销售单据整体流程图

• 生成销售单据后端业务逻辑流程图

4.2提交销售单据

提交销售单据是在保存或撤回提交后进行提交后调用的接口，这个接口只要传入已保存的销售单据编号。