光明乳业全程追溯管控及追溯服务概要设计

光明乳业全程追溯管控及追溯服务

平台、产线赋码系统项目

追溯服务平台-概要设计说明书

PreparedbyDate

拟制日期

ReviewedbyDate

评审人日期

ApprovedbyDate

批准日期

RevisionRecord修订记录

DateRevisionChangeDescriptionAuthor

日期Version修改描述作者

修订版本

2017-09-20vl.O添加第一版

2017-09-21V2.0初版

2017-10-22V3.0终版

目录

1.概述................................................................7

1.1.文档目的............................................................7

1.2.项目背景............................................................7

1.3.定义................................................................8

1.3.1.专门术语........................................................8

1.3.2.缩写............................................................8

1.3.3.参考资料........................................................9

2.系统概述...........................................................10

2.1.目标................................................................10

2.2.运行环境...........................................................10

3.需求概述...........................................................11

3.1.总体描述...........................................................11

3.2.功能需求...........................................................11

3.3.安全需求...........................................................13

4.总体设计...........................................................15

4.1.总体系统架构设计...................................................15

4.2.处理;耀...........................................................15

4.2.1.批次信息处理...................................................15

4.2.2.单据信息处理....................................................16

4.2.3.码流向查询处理.................................................17

4.2.4.微信稽查处理...................................................18

4.3.总体结构和模块外部设计.............................................20

4.4.功能分配..............................................................20

接口设计..............................................................22

5.1.外部接口..............................................................22

5.1.1.PDM............................................................................................................................22

5.1.2.ESC..............................................................................................................................22

5.1.3.WMS............................................................................................................................23

5.1.4.JPS................................................................................................................................23

5.2.内部接口...............................................................23

5.2.1.追溯码接口；......................................................23

5.2.2.单据接口..........................................................24

5.2.3.批次接口..........................................................24

5.2.4.文件接口..........................................................24

5.3.用户功能削..........................................................24

5.3.1.资料管理..........................................................24

5.3.2.产品管理..........................................................29

5.3.3.追溯码管理........................................................32

5.3.4.入出库管理........................................................36

5.3.5.流向查询..........................................................40

5.3.6.预警管理..........................................................43

5.3.7.报表统计..........................................................50

5.3.8.系统用户账号集成..................................................54

5.3.9.稽查..............................................................54

5.3.10.业务员巡店........................................................56

5.3.11.数据上报..........................................................57

5.3.12.系统后台处理服务..................................................59

5.3.13.系统管理..........................................................60

5.3.14.接口..............................................................63

5.3.15.ESC系统.........................................................64

5.4.硬件接口..............................................................64

5.5.软件接口..............................................................64

6.数据结构设计..........................................................65

6.1.数据库需求分析........................................................65

6.2.总体数据库架构设计...................................................65

6.3.数据库概念结构设计...................................................65

7.运行设计..............................................................66

7.1.运行模块的组合........................................................66

7.2.运行控制..............................................................66

7.3.运行时间..............................................................66

8.出错处理设计..........................................................67

8.1.出错输出信息..........................................................67

8.2.出错处理又探..........................................................67

9.安全保密设计..........................................................69

10.维护设计..............................................................70

11.欢乐扫设计............................................................71

概述71

功能设计72

企业门户73

11.1.1.注册..............................................................73

11.1.2.产品..............................................................77

11.1.3.奖品..............................................................79

11.1.4.乐码..............................................................85

11.1.5.活动..............................................................87

11.1.6.礼品..............................................................92

11.1.7.订单..............................................................93

11.1.8.管理..............................................................95

11.1.9.设置..............................................................96

手机端97

11.1.10.扫码中奖..........................................................97

11.1.11.积分商城.........................................................101

11.1.12.我的奖励.........................................................102

手机端-渠道用户.................................................................108

11.1.13.渠道注册.........................................................108

11.1.14.店员注册.........................................................109

11.1.15.店员管理.........................................................109

11.1.16.扫描乐码.........................................................109

11.1.17.兑奖.............................................................110

11.1.18.销量报表（店员）.................................................110

11.1.19.销量报表（店长）.................................................110

11.1.20.记账单...........................................................110

运营端111

11.1.21.生产企业.........................................................111

11.1.22.渠道客户.........................................................112

11.1.23.喷码机...........................................................113

11.1.24.E[1刷厂...........................................................113

与TTS接口......................................................................113

11.1.25.欢乐扫接口.......................................................113

11.1.26.单点登录.........................................................115

11.1.27.数据接口.........................................................115

1.概述

1.1.文档目的

根据前期的详细需求分析文档，将用户对本系统的需求做了详细的阐述，这

些用户需求已经在上一阶段中需求分析中进行了讨论和研究，此阶段将从业务逻

辑和用户应用环境中抽象出系统对象的组成结构、流程和各个部分相互关系，以

及数据库的概念结构和界面的逻辑关系。

《概要设计说明书》要达到如下一些目标：

•定义系统的各个组成部分

•描述各个部分的结构

•描述各个部分的相互关系以及他们如何协调与合作

•项目组成员对解决方案的共识

•产生详细设计的基础

1.2.项目背景

光明乳业股份有限公司是集牧场养殖、生产制造、物流运输、产品分销及终

端零售为一体的综合性乳业集团。2015年实现销售收入194亿元，位列中国乳

制品行业三甲。覆盖全产业链拥有400座牧场，18家国内工厂，26座现代化仓

库、400多个经销商和100万个有效销售网点。产品种类丰富，包括新鲜酸奶、

牛奶、乳酸菌饮品、牛乳饮品、奶酪以及常温酸奶、牛奶、乳酸菌饮品、奶粉和

植物饮品等系列产品。

光明乳业内部有不少业务应用系统，这些应用系统一般都是由不同供应商提

供，他们之间有信息重叠和不一致等现象的出现。因此很容易产生：基础数据多

头管理、系统间数据一致性差；接口没有实现统一的接口平台；数据和信息传递

多采用传统的纸媒或者表格形式，及时性和准确性存在风险；企业内部信息和数

据难以完成统一和共享。

为满足全产业链追溯体系建设要求，需要打通乳产品企业供应链和营销数据

的通道，通过一物一码“身份证号"将集中养殖牧场、乳品生产企业、渠道商、

销售终端、销售员、促销员、和消费者全部关联起来，对全供应链环节进行生态

管控。防止假货、窜货，以及渠道激励、终端激励、返点、积分等。促使乳品企

业管理人员可以清晰洞察供应链环节状态、渠道销售量、库存、终端销售量、促

销活动即时评估等，进而实现对销售费用的有效监控，同时进行大数据分析，提

高企业管控能力，增强企业核心竞争力。

1.3.定义

1.3.1.专门术语

•出入库计划单：货物还未进行出库，只是描述理论上，计划上将要出库的数

量，通常该单据由第三方系统通过接口产生。

•出入库单：实际的出入库业务产生的单据，通常由手持进行扫描出库。

•关联关系:将产品上的追溯码按包装比例关系形成树形关系结构的文件结构;

13.2.缩写

TTS:双向追溯系统;

1.3.3.参考资料

1、初步需求说明书；

2、详细需求分析说明书；

2.系统概述

2.1.目标

•实现和PDM、WMS等系统的对接，从而有效整合企业的业务系统；

•实现仓库的快速出入库，并有效，严格的管理仓库；

•实现多组织机构委托加工业务下的出入库单单据管理，从而灵活简单的实现

集团客户的需求；

•实现正向追踪与方向追溯业务要求；

•实现稽查窜货分析判断；

2.2.运行环境

硬件配置需求

项目CPU逻辑核数量内存量硬盘描述

主应用服务器3232G500G

辅应用服务器1168G50G用于消费者高并发

数据库服务器3232G1T

数据库备份服务器1616G2T通过镜像实现数提

F5负载均衡设备

24个盘

磁盘阵列双CPU架构RaidO,1,5,10

位

软件配置需求

项目配置

操作系统WindowsServer2008R2

数据库MSSqlserver2008R2

3.需求概述

3.1.总体描述

ITS双向追溯系统用于实现产品从原材料、辅料、原奶的生产加工到全流通

过程的全程追溯与追踪，实现正向召回与反向追溯的功能。

3.2.功能需求

本软件只要提供的功能（详细情况可参加产品数据管理平台V5.0软件需求

规格说明书）：

软件模块子模块功能说明

设置系统全局设置，如消息预警推送、码

系统管理系统参数设置

解析器等

可配置全局或按企业级别配置入出库操作

企业参数设置

的类型信息，如：允许重复出库等；

可根据实际环境或业务需求，设置服务企

单据类型设置

业自身的入出库单据类型名称；

实现系统按角色来划分不同企业、人员的

角色信息维护

系统操作功能权限；

实现对系统的路径访问追踪记录，确保系

操作日志查看

统的操作安全；

可根据企业实际业务需求来划分不同区

资料管理区域信息维护域，实现对各企业入出库流向的管理或窜

货管理；

可自定义符合企业业务需求的企业级别，

企业级别维护

方便系统对个企业的维护检索；

用于新增、修改、禁用企业（生产、经销）

企业信息维护

信息，维护企业的往来企业信息；

用于添加系统的操作用户，支持与集团的

用户信息维护域环境绑定，并设置相应角色信息与管辖

区域（用于稽查）；

用于维护赋码系统上传的生产批次信息，

批次信息维护并统计生产数量，可下载生产数据（完整

关联关系文件格式）；

用于建立企业的产品类别，实现产品按类

产品管理目录信息维护

别划分，方便检索；

用于维护系统所生产的产品信息，包括包

产品信息维护

装比例、有效期、产品宣传图等；

实现将产品与具体的生产企业关联，使企

企业产品维护业可以生产该产品并根据企业实际需要设

置相应的包装比例等；

用于维护产品的包装比例，与实际生产或

包装比例维护

出库比例对接；

用于在TTS系统中申请追溯码或与追溯码

追溯码管理追溯码申请

对应的防伪码，用于给印刷企业印刷码

实现对生产上传的生产码或系统申请后再

追溯码查询

TTS系统激活的追溯码码信息

用于对生产批次数据按码级别拆分文件导

追溯码导出

出

支持对印刷不清楚的追溯码进行模糊匹配

码模糊查询

查询

用于配置符合企业产品的追溯码格式，用

码规则管理

于在生成码时按该格式生成相应的码；

用于给印刷企业下载管理人员申请的追溯

追溯码下载

码，并记录下载信息

用于查询上传的关联关系文件解析的状

入出库管理关联关系上传监控

态，是失败或成功并展示失败原因；

用于查询上传的单据文件的解析状态，是

入出库上传监控

失败或成功并展示失败原因；

用于建立出库的计划任务单，用于手持终

入出库任务单

端设备同步任务单后扫描出库；

用于监控当前上传的关联关系文件及单据

入出库单上传文件的处理进度，可在线修改失败的文件，

用于再次自动解析；

检索查询已完成的任务单，可对已完成的

入出库单维护任务单做变更，也可不通过手持设备在此

建立有码单与无码单，形成出库记录；

用于按单据类型检索并下载完成解析的文

上传文件成功列表

件

流向查询单码流向查询用于查询系统追溯码的出库流向信息

产品批号流向用于按批号检索统计出库的流向信息

入出库单查询

检索按单号、产品等条件查询单据的明细

入出库单明细查询

信息

用于设置系统预警订阅模块及人员，系统

根据设置好的订阅信息，通过邮件推送的

预警管理预警信息订阅

方式将预警信息第一时间发送到指定接收

人员手中，此模块需要安装预警服务

按指定区域检索该区域内的生产企业已过

区域过期产品

期的产品

企业过期产品按条件统计指定范内内的企业过期产品

统计超过查询6次的防伪码，用于监控产

防伪查询预警

品异常查询

码重复出库预警统计码重复出库记录信息

码不存在预警统计出库信息中码不存在的码

统计关联关系中重复生产的码，重复生产

关联关系重码预警

的

统计同一个码在不同地区扫描的码，可解

多区域查询预警

除预警

统计TTS系统生成的码在未激活状态下扫

未激活码查询预警

描查询，可解除预警

防伪查询统计、异地查询日统计、扫描查

统计报表防伪统计报表询、非法码查询统计、假货码查询统计、

多区域查询统计、防伪查询分布表

用于维护TTS系统与赋码、欢乐扫或其他

数据同步调用接口凭证维护

第三方的接口凭证

用于将赋码系统上传的批次信息上报到欢

关联关系上报

乐扫，用于欢乐扫做活动

用于将单据信息上报到欢乐扫，用于欢乐

入出库单上报

扫做活动

3.3.安全需求

•目的

软件信息安全是衡量系统可靠性，一体化和可用性的必要条件，因此该系统

应该满足账户信息的安全和可访问性要求；同时，由于系统与多个第三方系统对

接，需要实现对接接口的凭证认证；

•账户安全

系统应该能够通过设置来配置较安全的用户账户管理方式具体安全要求如

下:

参数定义、描述

最小密码长度合法密码最小字符长度

锁定账户登陆失败指定次数后该账户将不允许在一定时间段再次

登陆

密码复杂度密码由多种字符或数字特殊字符组成

密码的安全性密码不能明文保存，需要进行加密后保存

•接口安全

系统之间的对接，需要先进行Token认证，通过认证的企业可进行接口直

接的数据传输；

4.总体设计

4.1.总体系统架构设计

4.2.处理流程

4.2.1.批次信息处理

批次信息为产品的生产信息为ESC在生产工厂将包装好的产品进行采集

后按指定的包装比例按照一定规则组建的关联关系信息，实现了从托盘码

找到箱码、箱码找瓶码的父子关系信息。

文件处理流程为：

追溯码申请CDS码管椅对象3对象1

—［〉追溯码申请

获取申请码信息

下载码

包材采集形成关联关系

上传关联关系

"〜二＞形成批次信息

4.2.2,单据信息处理

单据信息为生产企业或流通企业的销售出库信息，为产品追溯的重要环

节，是窜货分析的主要节点，具体流程为：

形成生产关联关系数据

建立任务单

扫描单据

4.2.3.码流向查询处理

码流向查询为系统的双向追溯的重要功能，实现按追溯码正向追溯产品的

流向信息，从奶源、原材料到生产工厂到流通的所有环节全程追溯。

4.2.4,微信稽查处理

微信稽查为通过微信服务号，使企业稽查人员方便市场稽查，提高防窜货

管理能力。

4.3.总体结构和模块外部设计

TTS系统

,V

资

料

管

理

非

入

异

假

多

关

入

防

入

文

法

出

地

货

区

入

一

伪

出

出

件

联

码

库

查

码

域

出

家

查

库

库

成

关

上

询

查

查

查

库

查

询

任

功

单

系

传

日

询

询

询

上

询

统

务

列

维

监

监

统

统

统

统

传

计

单

表

护

控

控

计

计

计

计

1

4.4.功能分配

系统功能分配可以参考4.3的设计，大概模块功能描述分为：

•资料管理：用于维护企业级批次信息；

•产品管理：用于维护产品及企业产品的基础信息及对应的包装比例;

•追溯码管理：用于实现追溯码申请、下载及查询；

•入出库管理：用于实现任务单的管理及单据的管理；

•流向查询：用于实现追溯码或批次的流向查询；

•预警管理：用于实现系统对追溯码的状态监控预警；

•报表统计：用于实现防伪查询分析；

•数据上报：用于实现产品的营销数据上报JPS系统;

•系统管理：用于维护系统的基本配置信息；

5.接口设计

5.1.外部接口

外部接口用于定义TTS系统与第三方系统的数据交换的协议实现数据之间

的安全交互；

5.1.1.PDM

1、单据对应关联关系下载接口

2、上传单据接口

3、产品同步接口

数据流程：

PDMTTSWMS

5.1.2.ESC

1、产品同步接口

2、关联关系上传接口

数据流程：

ESC

同步产品信息

返回产品信息

上传关联关系

形成批次信息

形成生产入库信息

5.1.3.WMS

1、单据对应关联关系上传接口

2、单据上传接口

数据流程：

形成单据对应关系文件

形成流向信息

5.1.4.JPS

1、关联关系营销数据上报接口

2、单据营销数据上报接口

5.2.内部接口

用于实现系统内部数据交换的接口协议，包括:

5.2.1,追溯码接口；

用于定义与追溯码查询的接口方法，实现系统接统一的接口调用;

«interface>>

追溯码接口

~^0

+验证真伪()

+验证流向0

+验证区

5.2.2,单据接口

用于定义入出库单据的操作接口信息，实现单据的数据处理及检索;

«intcrface>>

单据接口

+上传单据()

+下载任务单()

+验证单据()

5.2-3.批次接口

用于定义生产批次数据的接口操作，实现对生产数据的数据处理机检索;

«interface»

批次接口

+生成批次信息()

+下载批次0

+修改批次信息()

+查询批次信息()

5.2.4.文件接口

用于定义对TTS接收文件的处理操作，实现分类处理并统计;

+上传文件。

+查询上传文件。

+生成生产入库。

+生成销售出库()

+生成流向数据0

5.3.用户功能设计

5.3.1,资料管理

5.3,1.1,区域信息维护

概述：

用于设置系统中监管区域信息。可根据企业销售区域定义划分不

同的区域类型及管理行政区域，用于控制企业的销售区域及用户的管

理区域，TTS系统稽查及防伪窜货分析将根据企业设置的好管辖区域

信息做防伪窜货判断分析，并提供相应报表数据。区域结构例如:

业务流程:

.企业级别维护

概述:

用于维护企业级别信息，将不同企业按照对应的企业级别信息进

行分类划分，便于管理。如生产企业、流通企业、终端门店等;

业务流程:

用户对象12区域接口服务

访问用户登录

5.3,1.3,企业信息维护

概述：

用于维护系统中所有的企业的信息。包括生产企业、印刷企业、

流通企业、终端门店及与TTS系统做接口交互的企业等。不存在的企

业上传数据时将无法上传并完成数据的解析操作；

业务流程:

用户企业信息维护UI企业信息维护接口服务

,用户管理

概述：

用于维护使用TTS系统的用户信息，用户是系统的登录凭证，

TTS系统支持集团的域用户管理，即所有TTS系统用户必须为集团的

域用户，确保使用系统的安全控制及账号的统一效注管理。

业务流程:

用户用户信息维护UIIX域接口服务

i访问；用户登录：

II

返回|L验证成功

I

I消息7：新增用户

I।

---------------------------------------------------------------------

新增成功，刷新列表

编辑

消息8删除

消息9!设置角色

।

消131n*n设置管辖区域

.批次信息维护

概述：

用于查看、维护生产批次信息。

业务流程:

5.3.2.产品管理

,产品目录管理

概述:

用于维护系统产品的大类，即用于将新增的产品划分到指定的

大类中，便于检索；例如乳制品可以是液态奶、奶粉、乳制品饮料等

等。

业务流程:

用户产品目录管理ui产品目录管理接口服齐

访问：用户登录：

5.3.Z.2.产品信息维护

概述：

用于维护集团所生产的产品信息，产品信息包括产品编码、名称、

库存单位、有效期等，产品信息支持宣传图定期变更，支持不同生产

时间不同的产品宣传图，用于系统在防伪稽查时匹配正确的宣传图。

业务流程：

用户产品信息维护UI产品信息维护接口服务

访问：用户登录

I

----------------------------------------►

.返回,验证成功

717

111