51光明全程追溯管控平台详细设计说明书0111.docx
《51光明全程追溯管控平台详细设计说明书0111.docx》由会员分享，可在线阅读，更多相关《51光明全程追溯管控平台详细设计说明书0111.docx（135页珍藏版）》请在冰豆网上搜索。
51光明全程追溯管控平台详细设计说明书0111
光明乳业全程追溯管控及追溯服务
平台、产线赋码系统项目
全程追溯管控平台-详细设计
版本记录
版本号
版本描述
责任人
修订日期
V1.0
初版
蒋旭峰
2017-10-20
V2.0
终版
蒋旭峰
2017-12-8
第一章系统总体设计
一.1总体逻辑图
全程追溯管控平台作为追溯应用和追溯数据的管理平台，用于收集、清洗和整理各子系统同步的追溯数据，提供产品的正向追踪和反向追溯功能。
有牧场系统、MES、物流、WMS、ERP系统等通过接口将数据上报到数据共享系统，形成整个追溯管控平台的数据中心。
通过BI工具将追溯数据整体分析，综合展示出来，给管理层提供决策数据。
一.2部署架构图
ESB服务器提供ESB总线接口服务，各个子系统接口和数据采集接口注册到ESB。
数据集成接口服务器提供各个子系统追溯数据的上报接口服务。
全程追踪追溯系统服务器提供管理人员对追溯数据的查询和管理、查看
数据集成共享数据库服务器提供数据集成共享系统手机的追溯数据的存储
BI服务器提供数据集成共享数据库的建模和数据分析
一.3说明
本文档中确认的字段接口仅用于模拟数据测试和接口联调，具体字段随着牧场、奶源、MES、WMS、和物流的实际建设情况进行调整。
本文档中的展示系统页面是初稿，后续页面会更加光明相关部门和领导的反馈意见进行调整。
第二章功能模块说明
二.1全程追溯管控平台接口
2.1.1牧场接口
2.1.1.1接口列表
【以列表方式简要说明表】：
序号
接口名称
说明
1
牧场基本信息
2
消毒记录
3
饲养员信息
4
饲料记录
5
奶牛信息
6
转栏记录
7
免疫记录
8
用药记录
9
牧场奶仓CIP
10
饮用水监测
11
饮用水检测报告扫描件
12
奶牛检测报告
13
奶牛检验报告扫描件
14
临床检查记录
15
牧场挤奶信息
16
奶仓重量曲线
二.1.1.1详细说明
（1）牧场基本信息
（1）新增
●接口地址：
/meadow/info
●ContentType：
application/json
●请求方法：
POST
●请求参数（json对象）：
参数名
描述
类型
必填
备注
Code
牧场编码
string
（2）
是
Name
名称
string（16）
是
Province
省
string（6）
是
City
市
string（6）
是
District
区
string（6）
是
Address
地址
string（50）
是
ShortName
简称
string（20）
是
Manager
负责人
string（20）
是
Area
面积（亩）
int
是
CattleQTY
牛数量
int
是
MilkWeight
产奶规模
int
是
Level
等级
int
是
Latitude
纬度
float
是
Longitude
经度
float
是
Status
状态
bool
是
true/false
（2）更新
●接口地址：
/meadow/info
●ContentType：
application/json
●请求方法：
PUT
●请求参数（json对象）：
参考新增方法
（2）消毒记录
（1）新增
●接口地址：
/meadow/disinfection
●ContentType：
application/json
●请求方法：
POST
●请求参数（json对象）：
参数名
描述
类型
必填
备注
MeadowCode
牧场编码
string
（2）
是
OperationTime
消毒时间
string（19）
是
2017-09-2617:
30:
01
Type
消毒类型
string（20）
是
Operator
操作人姓名
string（16）
是
（3）饲养员信息
（1）新增
●接口地址：
/meadow/breeder
●ContentType：
application/json
●请求方法：
POST
●请求参数（json对象）：
参数名
描述
类型
必填
备注
MeadowCode
牧场编码
string
（2）
是
Name
姓名
string（16）
是
IDCard
身份证号
string（18）
否
Health
健康情况
string（10）
是
OperationDate
入职年限
string（10）
是
2017-09-26
Postion
岗位
string（20）
是
（2）更新
●接口地址：
/meadow/breeder
●ContentType：
application/json
●请求方法：
PUT
●请求参数（json对象）：
参考新增方法
（4）饲料记录
（1）新增
●接口地址：
/meadow/fodder
●ContentType：
application/json
●请求方法：
POST
●请求参数（json对象）：
参数名
描述
类型
必填
备注
MeadowCode
牧场编码
string
（2）
是
CowshedCode
牛舍编码
string（6）
是
MaterielCode
物料编码
string（20）
是
MaterielName
物料名称
string（50）
是
Dosage
用量
float
是
OperationTime
投料时间
string（19）
是
2017-09-2617:
30:
01
Operator
操作人姓名
string（16）
是
Supplier
供应商
string（50）
是
FodderBatch
饲料批次号
string（20）
是
（5）奶牛信息
（1）新增
●接口地址：
/meadow/cow
●ContentType：
application/json
●请求方法：
POST
●请求参数（json对象）：
参数名
描述
类型
必填
备注
CowCode
牛号
string（8）
是
MeadowCode
牧场编码
string
（2）
是
CowshedCode
牛舍编码
string（6）
是
MotherCode
母号
string（15）
是
FatherCode
父号
string（15）
是
GrandfatherCode
外祖父
string（15）
是
Birthday
出生日期
string（10）
是
2012-09-09
DepartureDate
离场日期
string（10）
否
2017-09-26
DepartureReason
离场原因
string（150）
否
IsGroup
是否在群
bool
是
true/false
（2）更新
●接口地址：
/meadow/cow
●ContentType：
application/json
●请求方法：
PUT
●请求参数（json对象）：
参考新增方法
（6）转栏记录
（1）新增
●接口地址：
/meadow/turnbar
●ContentType：
application/json
●请求方法：
POST
●请求参数（json对象）：
参数名
描述
类型
必填
备注
CowCode
牛号
string（8）
是
OldCode
转出舍号
string（6）
是
NewCode
转入舍号
string（6）
是
Type
转舍类型
string（20）
是
（7）免疫记录
（1）新增
●接口地址：
/meadow/immune
●ContentType：
application/json
●请求方法：
POST
●请求参数（json对象）：
参数名
描述
类型
必填
备注
CowCode
牛号
string（8）
是
OperationTime
日期
string（19）
是
2017-09-2617:
30:
01
Type
免疫类型
string（20）
是
Operator
操作人姓名
string（16）
是
Supplier
生产企业或供应商
string（50）
是
没有生产企业填供应商
（8）用药记录
（1）新增
●接口地址：
/meadow/medication
●ContentType：
application/json
●请求方法：
POST
●请求参数（json对象）：
参数名
描述
类型
必填
备注
CowCode
牛号
string（8）
是
OperationTime
日期
string（19）
是
2017-09-2617:
30:
01
DrugName
药物名称
string（20）
是
DrugCode
药物编码
string（20）
是
BatchNumber
批次号
string（20）
是
Dosage
用量
int
是
Unit
计量单位
string（20）
是
Operator
操作人姓名
string（16）
是
Supplier
供应商或生产企业
string（50）
是
没有生产企业填供应商
（9）牧场奶仓CIP
（1）新增
●接口地址：
/meadow/meadowCIP
●ContentType：
application/json
●请求方法：
POST
●请求参数（json对象）：
参数名
描述
类型
必填
备注
MeadowCode
牧场编码
string
（2）
是
MilkSilosCode
奶仓号
string（20）
是
CIPItems
CIP数据
json数组
是
CIPDate
CIP日期
string（10）
是
2017-09-26
Operator
操作人姓名
string（16）
是
CIP数据（CIPItems）
参数名
描述
类型
必填
备注
Pressure
压力
float
是
Time
操作时间
string（19）
是
2017-09-2617:
30:
01
Position
位置
string（20）
是
Temp
温度
float
是
PH
PH
float
是
（10）饮用水监测
（1）新增
●接口地址：
/meadow/drinkingWaterTest
●ContentType：
application/json
●请求方法：
POST
●请求参数（json对象）：
参数名
描述
类型
必填
备注
MeadowCode
牧场编码
string
（2）
是
OperationTime
日期
string（19）
是
2017-09-2617:
30:
01
TestNo
检验报告编码
string（30）
是
TestItem
检验项目
text
否
将检验项目序列化成json格式
{“检验项”:
“检验值”}
（11）饮用水检测报告扫描件
（1）新增
●接口地址：
/meadow/drinkingWaterTestReport
●ContentType：
multipart/form-data
●请求方法：
POST
●请求参数（bodyParam）：
参数名
描述
类型
必填
备注
TestNo
检验报告编码
string（30）
是
TestImg
扫描件
byte
是
图片格式jpeg
（12）奶牛检验报告
（1）新增
●接口地址：
/meadow/cowTestReport
●ContentType：
application/json
●请求方法：
POST
●请求参数（json对象）：
参数名
描述
类型
必填
备注
CowCode
牛号
string（8）
是
TestNo
检验报告编码
string（30）
是
TestItem
检验项目
text
否
将检验项目序列化成json格式
{“检验项”:
“检验值”}
二病检疫报告
（13）奶牛检验报告扫描件
（1）新增
●接口地址：
/meadow/cowTestReportScanningCopy
●ContentType：
multipart/form-data
●请求方法：
POST
●请求参数（bodyParam）：
参数名
描述
类型
必填
备注
TestNo
检验报告编码
string（30）
是
TestImg
扫描件
byte
是
（14）临床检查记录
（1）新增
●接口地址：
/meadow/clinical
●ContentType：
application/json
●请求方法：
POST
●请求参数（json对象）：
参数名
描述
类型
必填
备注
CowCode
牛号
string（8）
是
OperationTime
日期
string（19）
是
2017-09-2617:
30:
01
TestResult
检查结果
string（50）
是
Operator
操作人姓名
string（16）
是
（15）牧场挤奶信息
（1）新增
●接口地址：
/meadow/milking
●ContentType：
application/json
●请求方法：
POST
●请求参数（json对象）：
参数名
描述
类型
必填
备注
MeadowCode
牧场编码
string
（2）
是
MilkSilosCode
奶仓号
string（20）
是
CowCode
牛号
string（8）
是
CowshedCode
牛舍
string（6）
是
OperationTime
挤奶时间
string（19）
是
2017-09-2617:
30:
01
QTY
奶量
int
是
Group
挤奶班组
string（10）
否
（16）奶仓重量曲线
（1）新增
●接口地址：
/meadow/silosWeight
●ContentType：
application/json
●请求方法：
POST
●请求参数（json对象）：
参数名
描述
类型
必填
备注
MeadowCode
牧场编码
string
（2）
是
MilkSilosCode
奶仓号
string（20）
是
Date
重量数据日期
string（10）
是
2017-01-01
Items
重量数据
json数组
是
5分钟采集一次
二级参数---重量数据（Items）
参数名
描述
类型
必填
备注
Weight
重量
float
是
Time
时间
string（8）
是
17:
30:
01
2.1.2奶源接口
2.1.2.1接口列表
【以列表方式简要说明表】：
序号
接口名称
说明
1
奶车保温实验报告
2
奶车信息
3
驾驶员信息
4
奶源运输
2.1.2.2详细说明
2.1.2.2.1奶车保温实验报告
（1）新增
●接口地址：
/milking/truckInsulationTestReport
●ContentType：
application/json
●请求方法：
POST
●请求参数（json对象）：
参数名
描述
类型
必填
备注
TrailerCode
挂车号
string（15）
是
OperationTime
报告日期
string（19）
是
2017-09-2617:
30:
01
Temp
环境温度
float
是
MilkTemp
初奶温度
floot
是
T24
24小时后温升
float
是
Operator
报告人姓名
string（16）
是
2.1.2.2.2奶车信息
新增
●接口地址：
/milking/truck
●ContentType：
application/json
●请求方法：
POST
●请求参数（json对象）：
参数名
描述
类型
必填
备注
LicenseNo
车牌号
string（15）
是
Ton
奶车吨位
int
是
Type
奶车型号
string（30）
是
LogisticsName
物流公司名字
string（50）
是
EXPDate
准运证有效期
string（10）
是
2017-01-01
CardCode
准运证编号
string（30）
是
准运证扫描件上传
●接口地址：
/meadow/quasiShipmentPermit
●ContentType：
multipart/form-data
●请求方法：
POST
●请求参数（bodyParam）：
参数名
描述
类型
必填
备注
LicenseNo
车牌号
string（15）
是
LicenseImg
准运证扫描件
byte
是
文件格式jpeg
2.1.2.2.3驾驶员信息
●新增
●接口地址：
/milking/driver
●ContentType：
application/json
●请求方法：
POST
●请求参数（json对象）：
参数名
描述
类型
必填
备注
IDCard
身份证
string（18）
是
Phone
手机号
string（11）
是
Name
驾驶员姓名
string（16）
是
HealthCode
驾驶员健康证编号
string（30）
是
EXPDate
驾驶员健康证有效期
string（10）
是
2017-09-26
驾驶员健康证扫描件上传
●接口地址：
/milking/health
●ContentType：
multipart/form-data
●请求方法：
POST
●请求参数（bodyParam）：
参数名
描述
类型
必填
备注
IDCard
身份证
string（18）
是
HealthImg
健康证扫描件
byte
是
文件格式jpeg
2.1.2.2.4奶源运输
●新增
●接口地址：
/milking/shipping
●ContentType：
application/json
●请求方法：
POST
●请求参数（json对象）：
参数名
描述
类型
必填
备注
TransferCode
生奶交接单号
string（20）
是
TrailerCode
挂车号
string（15）
是
TruckCode
车头号（车牌）
string（15）
是
Destination
去向工厂编码
string（20）
是
ArrivalTime
工厂到达时间
string（19）
是
2017-09-2617:
30:
01
UnloadTime
卸奶时间
string（19）
是
2017-09-2617:
30:
01
DriverIDCard
驾驶员身份证号
string（18）
是
MilkTestReport
生奶检验报告
json数组
是
MilkCarRelation
奶车奶槽和牧场奶仓关系
json数组
是
SamplingTest
取样检测
json数组
是
GPS
奶源运输GPS轨迹
json数组
是
按比例尺缩放1km，采集
TransportTemp
在途温度
json数组
是
1小时采集一次
二级参数---生奶检验报告（MilkTestReport）
参数名
描述
类型
必填
备注
MeadowCode
牧场编码
string
（2）
是
OperationTime
日期
string（19）
是
2017-09-2617:
30:
01
InspectCode
检测号
string（50）
是
Weight
重量（kg）
float
是
Microorganism
微生物（万）
float
是
Alcohol
酒精
float
是
Acidity
酸度
int
是
Protein
蛋白质
float
是
Fat
脂肪
float
是
Solids
总固形物
float
是
Proportion
比重
string（10）
是
Freezing
冰点
float
是
Soma
体细胞
float
是
二级参数---奶车奶槽和牧场奶仓关系（MilkCarRelation）
参数名
描述
类型
必填
备注
MeadowCode
来源牧场编码
string
（2）
是
MilkTankNumber
奶车奶槽号
string（20）
是
MilkSilosCode
牧场奶仓号
string（20）
是
ArrivalTime
到牧场收奶时间
string（19）
是
2017-09-2617:
30:
01
LeaveTime
出牧场时间
string（19）
是
2017-09-2
升级会员 