详细设计-追溯服务平台-2018.01.10.doc

光明乳业全程追溯管控及追溯服务
平台、产线赋码系统项目
追溯服务平台-详细设计说明书

Prepared by
拟制
夏习林、郭武、栗树亮
Date
日期
2017-09-28
Reviewed by
评审人
王学栋
Date
日期
2017-10-20
Approved by
批准
刘鸣
Date
日期
2017-10-31
Revision Record 修订记录
Date
日期
Revision Version
修订版本
Change Description
修改描述
Author
作者
2017-09-26
V0.1
初版
郭武
2017-09-28
V0.2
修订版
夏习林
2017-10-20
V1.0
修订版
栗树亮
2018-01-08
V2.0
终版
刘鸣
目录

一、TTS系统详细设计说明书 6
1 引言 6
1.1 编写目的 6
1.2 范围 6
1.3 参考资料 7
1.4 术语定义及说明 7
2 设计总体架构 7
3 功能模块实现设计 8
3.1. 基础类设计 8
3.1.1. BasePage 8
3.2. 公用模块实现设计 9
3.2.1 系统登录 9
3.2.2 资料管理 11
3.2.3 产品管理 17
3.2.4 追溯码管理 21
3.2.5 入出库管理 27
3.2.6 流向查询 36
3.2.7 预警管理 41
3.2.8 报表统计 50
3.2.9 稽查 56
3.2.10 数据上报 59
3.2.11 系统管理 63
二、TTS与WMS、PDM接口对接文档 69
1 业务流程 70
2 业务逻辑 70
3 业务描述 70
4 接口 71
4.1 Token管理 71
4.2 码替换接口 72
4.3 单据上传接口 72
4.4 重组关联关系上传接口 76
4.5 重组的关联关系文件列表接口 81
4.6 重组的关联关系文件下载接口 82
4.7 重组关联关系文件状态更新接口 82
4.8 库存校正接口 83
4.9 单码流向查询接口 84
三、 PDM5.1软件详细设计说明书 86
1 引言 86
1.1 编写目的 86
1.2 范围 86
1.3 参考资料 87
1.4 术语定义及说明 87
2 设计总体架构 89
3 功能模块实现设计 90
3.1 基础类设计 90
3.1.1 BasePage 90
3.2 公用模块实现设计 91
3.2.1 系统登录 91
3.2.2 产品管理 95
3.2.3 往来单位管理 100
3.2.4企业法人管理 105
3.2.5 托盘码管理 108
3.2.6 托盘关联关系管理 112
3.2.7 建立单据 116
3.2.8 出入库计划管理 122
3.2.9 货运统计报表 128
3.2.10 用户角色组织机构管理流程图 131
3.2.11 接口服务 132
3.3 数据表关系设计 133
3.3.1. 系统登陆相关表关系 133
3.3.2. 产品管理相关表关系 134
3.3.3. 关联关系队列相关表关系 135
3.3.4. 托盘管理相关表关系 136
3.3.5. 单据相关表关系 136
3.3.6. 计划单管理相关表关系 137
四、欢乐扫平台详细设计说明书 137
1.功能设计 138
1.1 企业门户 138
1.1.1 注册 139
1.1.2 产品 141
1.1.3 奖品 142
1.1.4 乐码 144
1.1.5 活动 145
1.1.6 礼品 149
1.1.7 订单 149
1.2 手机端 151
1.2.1 扫码中奖 152
1.2.2 积分商城 154
1.2.3 手机端-渠道用户 158
2 架构 160
2.1 消费者端 160
2.1.1 反向代理 160
2.1.2 Redis 161
2.1.3 数据库故障转移 161
2.1.4 队列 161
2.2 企业端 161
2.2.1 报表 162
2.2.2 NAS和Redis 162
2.2.3 负载均衡 162
3 安全设计 162
3.1 基础安全 162
3.1.1 网络层 162
3.1.2 应用层 164
3.1.3 主机层 165
3.1.4 数据层 165
3.2 应用安全 166
3.2.1 码加密 166
3.2.2 防破解 167
3.2.3 系统监控 167
3.2.4 微信及接口安全 168
一、TTS系统详细设计说明书
1 引言
1.1 编写目的
本文档的目的旨在推动软件工程的规范化，使设计人员遵循统一的详细设计书写规范，节省制作文档的时间，降低系统实现的风险，做到系统设计资料的规范性和全面性，以利于系统的实现，测试，维护和版本升级等
此阶段将在概要设计的基础上，进行系统的具体详细设计。在详细设计中，描述实现具体模块所涉及到的主要算法，数据结构，类的层次结构及调用关系，需要说明软件系统各个层次中的每个程序（每个模块或子程序）的设计考虑，以便进行编码和测试。因此《详细设计说明书》要达到如下一些目标：
l 设计应该足够的详细，达到可以编写程序的水平
l 重点模块的执行流程和数据库系统详细设计的描述
l 项目组成员对代码结构，命名规范性的共识
l 编码实现的基础
1.2 范围
本文档用于软件设计阶段的详细设计，他的依据是概要设计说明书，他为下一阶段源程序及测试服务，是其实现的指导依据。
本文将在如下几个方面加以论述：各子系统的公用模块的实现设计，专用模块的实现设计，数据库实现设计，外部接口的实现设计以及角色授权的设计等。按照三层结构的布局，详细设计应该从如下三个方面进行：
数据访问层设计：数据字典物理设计，基本表物理设计，中间表物理设计（报表设计）
业务逻辑设计：接口数据设计，中间件设计，数据通信传输设计，角色授权设计和功能设计；
UI设计：基础信息管理，托盘码管理，接口管理，单据管理，报表统计，系统管理。
1.3 参考资料
l 初步需求说明书；
l 详细需求分析说明书；
l 概要设计说明书；
1.4 术语定义及说明
l 出入库计划单：货物还未进行出库，只是描述理论上，计划上将要出库的数量，通常该单据由第三方系统通过接口产生。
l 出入库单：实际的出入库业务产生的单据，通常由手持进行扫描出库。
l 关联关系:将产品上的追溯码按包装比例关系形成树形关系结构的文件结构；
2 设计总体架构

3 功能模块实现设计
1.1. 基础类设计
1.1.1. BasePage
1.1.1.1. 类设计
类名称
BasePage
类功能
页面基类，用于管理各页面的共同属性和方法的类
属性
protected IUserService UsersLogic
属性功能
对用户进行管理的业务类
属性
protected IOrganizeService OrganizeLogic
属性功能
对用户所属组织机构进行管理的业务类
属性
public IWareHouseOrderLogic WareHouseOrderLogic
属性功能
对单据进行管理的业务类
属性
public IBetweenCompanyLogic BetweenCompanyLogic
属性功能
对往来单位进行管理的业务类
属性
public string LastUrl
属性功能
客户端上次请求的页面
属性
protected string LoginUserName
属性功能
当前的登陆名
方法1：
名称
public static void _ShowMessage(string msg)
功能
消息框提示
输入
消息内容
输出

1.2. 公用模块实现设计
3.2.1 系统登录
模块编号
8
模块名称
系统登录
所属业务
系统登录

编写人
TTS产品部
完成时间
2017年
3.2.1.1 功能流程图
3.2.1.2 功能描述
功能类型
登录验证
功能描述
提高系统的安全性
前提业务
无
后继业务
所有业务
功能约束
权限约束
约束描述

3.2.1.3 界面设计

1) 基础信息处理
动作编号
动作名称
动作描述
8.0.1
登录
点击登录按钮提交数据到登录处理页面“login.Aspx”，数据验证成功后将转至管理页面。
8.0.2
重置
将当前信息回复原先状态
3.2.2 资料管理
3.2.2.1 区域信息维护
3.2.2.1.1 功能描述：
用于设置系统中监管区域信息。可根据企业销售区域定义划分不同的区域类型及管理行政区域，用于控制企业的销售区域及用户的管理区域，TTS系统稽查及防伪窜货分析将根据企业设置的好管辖区域信息做防伪窜货判断分析，并提供相应报表数据。
3.2.2.1.2 功能流程图

3.2.2.1.3 界面设计

3.2.2.2 企业级别维护
3.2.2.2.1 功能描述：
用于维护企业级别信息，将不同企业按照对应的企业级别信息进行分类划分，便于管理。如生产企业、流通企业、终端门店等；
3.2.2.2.2 业务流程：
3.2.2.2.3 界面设计

3.2.2.3 企业信息维护
3.2.2.3.1 概述：
用于维护系统中所有的企业的信息。包括生产企业、印刷企业、流通企业、终端门店及与TTS系统做接口交互的企业等。不存在的企业上传数据时将无法上传并完成数据的解析操作；
3.2.2.3.2 业务流程：
3.2.2.3.3 界面设计

3.2.2.4 用户管理
3.2.2.4.1 概述：
用于维护使用TTS系统的用户信息，用户是系统的登录凭证，TTS系统支持集团的域用户管理，即所有TTS系统用户必须为集团的域用户，确保使用系统的安全控制及账号的统一效注管理。
3.2.2.4.2 业务流程：

3.2.2.5 批次信息维护
3.2.2.5.1 概述：
用于查看、维护生产批次信息。
3.2.2.5.2 业务流程：
3.2.2.5.3 界面设计

3.2.3 产品管理
3.2.3.1 产品目录管理
3.2.3.1.1 概述：
用于维护系统产品的大类，即用于将新增的产品划分到指定的大类中，便于检索；例如药品目录可以是特殊药品、普通药品、OTC药品。乳制品可以是液态奶、奶粉、乳制品饮料等等。
3.2.3.1.2 业务流程：

3.2.3.1.3 界面设计

3.2.3.2 产品信息维护
3.2.3.2.1 概述：
用于维护集团所生产的产品信息，产品信息包括产品编码、名称、库存单位、有效期等，产品信息支持宣传图定期变更，支持不同生产时间不同的产品宣传图，用于系统在防伪稽查时匹配正确的宣传图。
3.2.3.2.2 业务流程：

3.2.3.2.3 界面设计

3.2.3.3 企业产品维护
3.2.3.3.1 概述：
用于指定生产企业所生产的产品，建立生产企业与产品的关联关系；
3.2.3.3.2 业务流程：
3.2.3.3.3 界面设计

3.2.3.4 包装比例维护
3.2.3.4.1 概述：
维护产品的内外包装信息。使产品可按照指定比例进行包装与出库；
3.2.3.4.2 业务流程：
3.2.3.4.3 界面设计

3.2.4 追溯码管理
3.2.4.1 追溯码申请
3.2.4.1.1 概述：
用于企业生成指定规则的追溯码，用于包材印刷、下载；
3.2.4.1.2 业务流程：

3.2.4.1.3 界面设计

3.2.4.2 追溯码查询
3.2.4.2.1 概述：
用于查询追溯码对应的产品、批号、父子码的关系信息，可实现查看查询的码所在的批次信息。
用于实现追溯单码流向信息，包括原料到销售的各个环节信息及批次信息流向。用于实现正向与方向追溯产品质量信息；
3.2.4.2.2 业务流程：
3.2.4.2.3 页面设计

3.2.4.3 追溯码导出
3.2.4.3.1 概述：
用于将生产批次数据按包装级别分别生产相应不同级别的码文件，方便用户查看相应批次的码信息；
3.2.4.3.2 业务流程：

3.2.4.3.3 页面设计

3.2.4.4 码模糊查询
3.2.4.4.1 概述
用于处理追溯码码被部分损坏或记录不清楚时，可以通过通配符%或？来查询码。
3.2.4.4.2 业务流程

3.2.4.4.3 界面设计

3.2.4.5 码规则管理
3.2.4.5.1 概述
用于配置符合企业生产要求的追溯码生成规则，供追溯码申请时选择使用，并生成相应规则的码文件。
3.2.4.5.2 业务流程

3.2.4.5.3 页面设计

3.2.4.6 追溯码下载
3.2.4.6.1 概述
用于将在TTS系统申请的追溯码及对应的防伪码下载到本地，发给印刷企业或赋码系统进行赋码生产；
重点是在TTS系统申请的码；
3.2.4.6.2 业务流程

3.2.4.6.3 页面设计

3.2.5 入出库管理
3.2.5.1 入出库上传监控
3.2.5.1.1 概述
用于检索监控系统处理手持上传的单据处理结果（成功、失败、等待），主要用于发现单据失败时失败单据的原因，可按失败原因进行单据检索，如：重复出库、缺少关联关系等，方便用于第一时间解决单据问题。
3.2.5.1.2 业务流程
3.2.5.1.3 页面设计

3.2.5.2 关联关系上传监控
3.2.5.2.1 概述
用于监控关联关系文件解析状态及文件中追溯码存在的异常，可根据关联关系文件解析状态进行检索查询，如可检索关联关系文件有重复上传的码、无效的码（指的的当前关联关系文件的码在系统中存在，并且父码与系统中的父码不一致），可快速定位生产端的赋码问题信息；
3.2.5.2.2 业务说明

3.2.5.2.3 页面设计

3.2.5.3 入出库任务单
3.2.5.3.1 概述
用于在TTS系统中创建入出库任务单，用于手持或其它终端设备进行扫描出库；
3.2.5.3.2 业务流程

3.2.5.3.3 页面设计

3.2.5.4 入出库上传
3.2.5.4.1 概述
实现将TTS系统支持的关联关系文件、单据文件手动上传到平台并进行处理；
3.2.5.4.2 业务流程
3.2.5.4.3 页面设计

3.2.5.5 入出库单维护
3.2.5.5.1 概述
系统解析手持上传的单据信息后，形成单据信息，支持按企业 、产品、单号等不同条件进行检索。
3.2.5.5.2 业务流程

3.2.5.5.3 页面设计

3.2.5.6 上传文件成功列表
3.2.5.6.1 概述
提供查看所有上传到TTS的文件，包括单据、关联关系文件；支持文件下载；
3.2.5.6.2 业务流程

3.2.5.6.3 页面设计

3.2.6 流向查询
3.2.6.1 单码流向查询
3.2.6.1.1 概述
用于查看追溯码的单据流向信息；信息包括追溯码的基本信息及追溯码的发货流向的单据信息，实现码的正向追踪；
追溯码流向查询信息包括：产品的基础信息、奶源信息（奶仓号，原奶批次号，原奶供应商，承运车辆车牌，到厂时间，原奶检测结果，过磅数量，卸奶时间，收奶线，奶仓定容情况，奶仓检测结果，原奶仓储存时间）、巴杀信息（原奶批次，预巴氏号，巴氏运行参数，巴氏起止时间，调奶数量，巴氏存储时间温度，入库时间）、配料列表（调奶量，配料批次号，配料罐号，白糖，稳定剂，原料批次，原奶批次号，投料温度，混料线号，混料时间，定容添加量，定容数量，定容指标）、基料巴氏（菌种活化时间，运行时间，基料巴杀批次，基料巴杀参数，菌种添加数量，添加时间，发酵罐号/数量）信息；
根据追溯码可以找到原料信息，包括：原料批次号，原料名称，数量，供应商信息；
3.2.6.1.2 业务流程
3.2.6.1.3 页面设计

3.2.6.2 产品批号流向
3.2.6.2.1 概述
用于查看指定企业、产品在指定生产时间范内的生产的产品的流向信息。
3.2.6.2.2 业务流程
3.2.6.2.3 页面设计

3.2.6.3 入出库单查询
3.2.6.3.1 概述
用户根据输入的条件查询相对应的单据，查看单据的信息，单据类型，往来企业，开单企业，点击明细查看单据的产品信息以及单据所对应的码信息。
3.2.6.3.2 业务流程

3.2.6.3.3 页面设计

3.2.6.4 入出库单明细查询
3.2.6.4.1 概述
用于查询单据的明细并统计当前页的单据信息，并可导出单据的明细。单据出库人员可根据此功能检查出库是否与实际货物一致；
3.2.6.4.2 业务流程

3.2.6.4.3 页面设计

3.2.7 预警管理
3.2.7.1 预警信息订阅
3.2.7.1.1 概述
用于系统管理人员设置系统用户接收的预警信息，使相应人员第一时间接收到系统异常并及时处理。
3.2.7.1.2 业务流程

3.2.7.1.3 页面设计

3.2.7.2 区域过期产品
3.2.7.2.1 概述
用于统计指定区域内生产企业所库存产品的过期产品信息，支持预警信息订阅，是企业及时掌握了解库存信息，调整生产；
3.2.7.2.2 业务流程
3.2.7.2.3 页面设计

3.2.7.3 企业过期产品
3.2.7.3.1 概述
用于统计指定企业（经销商）库存的产品信息，使企业及时调整库存减少积压。
3.2.7.3.2 业务流程
3.2.7.3.3 页面设计

3.2.7.4 防伪查询预警
3.2.7.4.1 概述
用于统计防伪码被查询超过指定次数的信息，第一时间通知订阅者及时处理异常信息；
3.2.7.4.2 业务流程

3.2.7.4.3 页面设计

3.2.7.5 码重复出库预警
3.2.7.5.1 概述
用于统计并检索同一码重复扫描出库的信息，用于判断是否是扫描出库错误或是生产时出现异常；
3.2.7.5.2 业务流程

3.2.7.5.3 页面设计

3.2.7.6 码不存在预警
3.2.7.6.1 概述
用于统计出库的产品没有生产信息即没有上传关联关系，提示相关生产企业及时上传生产批次信息。
3.2.7.6.2 业务流程

3.2.7.6.3 页面设计

3.2.7.7 出库数量预警
3.2.7.7.1 概述
用于统计任务单中扫描数量与实际出库数量不符的单据信息，即扫描上传的数量小于任务单的计划数量数量时，人工需要手工审核实际出库数量；
3.2.7.7.2 业务流程
3.2.7.7.3 页面设计

3.2.7.8 关联关系重码预警
3.2.7.8.1 概述
用于统计同一个码在不同生产批次中，提示订阅者赋码生产存在问题并及时处理；
3.2.7.8.2 业务流程
3.2.7.8.3 页面设计

3.2.7.9 多区域查询预警
3.2.7.9.1 概述
用于统计同一防伪码在不同区域查询，预警提示假货存在，订阅者需及早关注处理；
3.2.7.9.2 业务流程
3.2.7.9.3 页面设计

3.2.8 报表统计
3.2.8.1 防伪查询统计
3.2.8.1.1 概述
用于以图表方式按月统计防伪码被消费者查询的记录信息。
3.2.8.1.2 业务流程
3.2.8.1.3 页面设计

3.2.8.2 异地查询日统计
3.2.8.2.1 概述
用于已图形统计防伪码在发货地与扫描地不同区域查询信息，达到监控防伪窜货的目的；
3.2.8.2.2 业务流程
3.2.8.2.3 页面设计

3.2.8.3 扫描查询
3.2.8.3.1 概述
用于查询指定时间范围内（不可跨月）的消费者防伪查询记录信息，显示具体的查询地点，支持信息导出；
3.2.8.3.2 业务流程

3.2.8.3.3 页面设计

3.2.8.4 非法码查询统计
3.2.8.4.1 概述
用于统计消费者查询的码不存在于TTS系统中的信息，用图显示；
3.2.8.4.2 业务流程
3.2.8.4.3 页面设计

3.2.8.5 假货码查询统计
3.2.8.5.1 概述
用于统计消费者查询的在TTS系统这设置为假货的码的查询记录信息；
3.2.8.5.2 业务流程
3.2.8.5.3 页面设计

3.2.8.6 多区域查询统计
3.2.8.6.1 概述
用于统计消费者查询的防伪码在不同扫描地的查询信息，用于判断同一防伪码可能存在于不同的销售地区；
3.2.8.6.2 业务流程
3.2.8.6.3 页面设计

3.2.9 稽查
3.2.9.1 企业微信稽查
3.2.9.1.1 概述
用于微信公众号，通过手机扫描产品追溯码，判断产品是否有窜货，实现企业对窜货的管控。
微信稽查用于企业稽查人员在线判断产品是否窜货，及时掌握市场流通状态。
微信稽查是TTS系统通过微信服务号实现微信扫描追溯码，获取追溯码信息的手机扫描稽查功能，方便稽查管理。
3.2.9.1.2 业务流程

3.2.9.1.3 页面设计
3.2.9.2 门店签到
3.2.9.2.1 业务员
数据结构
I. 字段
I. 名称
I. 类型
I. 说明
II. id
II. 编号
II. int(11)
II.
III. openid
III. 微信openid
III. varchar(32)
III.
IV. realname
IV. 业务员姓名
IV. varchar(16)
IV.
V. mobile
V. 手机号
V. varchar(11)
V.
VI. sex
VI. 性别
VI. tinyint(1)
VI.
VII. area
VII. 所属区域
VII. int(11)
VII.
VIII.
VIII.
VIII.
VIII.
业务员微信绑定流程
业务员打开微信公众号，从菜单进入业务员中心页面，提示绑定业务员账号。
业务员输入手机号，姓名和手机验证码后经系统校验通过便可成功绑定微信。
3.2.9.2.2 门店
数据结构
I. 字段
I. 名称
I. 类型
I. 说明
II. id
II. 编号
II. int(11)
II.
III. shop_name
III. 门店名称
III. varchar(32)
III.
IV. address
IV. 门店地址
IV. varchar(64)
IV.
V. qrcode
V. 门店二维码
V. varchar(6)
V. 门店分配的唯一二维码，供业务员扫描签到
VI. tel
VI. 门店联系方式
VI. varchar(11)
VI.
VII. area
VII. 所属区域
VII. int(11)
VII.
VIII. lat
VIII. 门店位置经度
VIII. float(9,6)
VIII.
IX. lng
IX. 门店位置纬度
IX. float(9,6)
IX.
门店二维码分配流程
门店注册需要先在系统录入门店信息，录入后可以为门店分配一个二维码，二维码由业务员在店铺现场激活，系统会记录下二维码的激活位置，作为以后业务员签到的位置依据。
3.2.9.2.3 签到
数据结构
I. 字段
I. 名称
I. 类型
I. 说明
II. id
II. 编号
II. int(11)
II.
III. shop_id
III. 门店编号
III. int(11)
III.
IV. shop_name
IV. 门店名称
IV. varchar(64)
IV. 冗余字段
V. salesman_id
V. 业务员编号
V. int(11)
V.
VI. salesman_name
VI. 业务员姓名
VI. varchar(16)
VI. 冗余字段
VII. check_in_time
VII. 签到时间
VII. datetime
VII.
VIII. lat
VIII. 签到经度
VIII. float(9,6)
VIII.
IX. lng
IX. 签到纬度
IX. float(9,6)
IX.
X.
X.
X.
X.
签到流程
业务员签到第一步是通过微信扫描二维码，进入签到页面。如果业务员所在位置在扫描的二维码所属门店范围内，则可以进行签到，否则不能签到。
3.2.9.2.4 统计分析
业务员签到次数统计
I. 字段
I. 名称
I. 类型
I. 说明
II. id
II. 编号
II. int(11)
II.
III. salesman_id
III. 业务员编号
III. int(11)
III.
IV. salesman_name
IV. 业务员姓名
IV. varchar(16)
IV. 冗余字段
V. check_in_count
V. 签到次数
V. int(11)
V.
VI.
VI.
VI.
VI.
业务员签到门店统计
I. 字段
I. 名称
I. 类型
I. 说明
II. id
II. 编号
II. int(11)
II.
III. salesman_id
III. 业务员编号
III. int(11)
III.
IV. salesman_name
IV. 业务员姓名
IV. varchar(16)
IV. 冗余字段
V. shop_id
V. 门店编号
V. int(11)
V.
VI. shop_name
VI. 门店名称
VI. varchar(64)
VI. 冗余字段
VII. check_in_count
VII. 签到次数
VII. int(11)
VII.
VIII.
VIII.
VIII.
VIII.
3.2.10 数据上报
数据上报主要实现TTS系统与第三方系统的接口凭证维护，使系统建交互建立安全可靠的机制，同时，系统提供将TTS的数据上报到JPS系统及CDS系统；
3.2.10.1 调用接口凭证维护
3.2.10.1.1 概述
用于实现TTS系统与第三系统的访问凭证的维护，第三方系统需要使用TTS系统的接口，需要维护接口访问凭证。当TTS系统需要访问第三方系统时，也可维护第三方系统的接口访问凭证信息。
3.2.10.1.2 业务说明
3.2.10.1.3 页面设计

3.2.10.2 关联关系上报
3.2.10.2.1 概述
用于将TTS系统的关联关系文件发送到JPS系统，实现指定生产批次的产品做营销活动。
3.2.10.2.2 业务说明
3.2.10.2.3 页面设计

3.2.10.3 入出库单上报
3.2.10.3.1 概述
用于将TTS系统的单据信息文件发送到JPS系统，实现指定出库单的产品做营销活动。
3.2.10.3.2 业务说明
3.2.10.3.3 页面设计

3.2.10.4 申请码上报
3.2.10.4.1 概述
用于实现将从TTS申请的码数据上报到CDS系统，CDS系统再下发到印刷企业，实现数据无人工接触，确保数据流通安全；
3.2.10.4.2 业务说明
3.2.10.4.3 页面设计

3.2.11 系统管理
3.2.11.1 系统参数设置
3.2.11.1.1 概述
用于对系统运行中所必须的配置项的设置，为系统运行的必要项，不可随意修改。
3.2.11.1.2 业务说明
3.2.11.1.3 页面设计

3.2.11.2 企业参数设置
3.2.11.2.1 概述
用于通过全局设置或针对特定企业类型或特定企业进行生产数据或单据进行特殊处理的配置。
3.2.11.2.2 业务说明
3.2.11.2.3 页面设计

3.2.11.3 单据类型设置
3.2.11.3.1 概述
用于设置系统识别的单据类型，可根据企业自定义名称设置，同时，可根据业务需要，定义单据的后置类型，用于系统自动实现入出库，如销售出库的后置类型为采购入库等；
3.2.11.3.2 业务说明

3.2.11.3.3 页面设计

3.2.11.4 角色信息维护
3.2.11.4.1 概述
用于建立系统角色，用于给不同级别或类型的用户分配不同的角色。根据角色的划分，达到控制不同用户对系统操作的权限控制，保证数据的安全性。
3.2.11.4.2 业务说明
3.2.11.4.3 页面设计

3.2.11.5 操作日志查看
3.2.11.5.1 概述
TTS系统对数据安全有严格控制，针对每个用户的每个操作，系统将自动记录，用于追踪系统访问用户的路径数据。
3.2.11.5.2 业务说明

3.2.11.5.3 页面设计

二、 TTS与WMS、PDM接口对接文档
版本更新
时间
修订人
修订内容
版本号
2017-9-29
夏习林

V1.0.0
2017-10-13
夏习林
加入校正接口
V1.0.1
2017-10--20
夏习林
合并文件格式为一个文件，加入字段表格说明
V1.0.2
2017-10-26
夏习林
加入企业级别说明，管控平台只需要企业级别为一级批发的单据上报到管控平台
V1.0.3
2017-11-10
夏习林
更新单据及关联关系的报文说明及字段说明
V1.04
2017-11-20
夏习林
更新单据与关联关系的行政区域信息，在企业信息中新增AreaCode及AreaName，存储国家指定的区域编码
V1.05
1 业务流程
2 业务逻辑
1、每个流向节点的单据信息都需要上传到TTS系统；
2、单据类型包括销售出库、采购入库、调拨入库等，类型在TTS系统手动维护；
3、流通企业是否需要扫描入库？如需要，需要上传对应的采购入库单；
4、单据信息以每个单据时间发货量为一个单据并作为上传到TTS系统的单据文件，如一个单据包括10托，需将10托作为一个单据文件；
3 业务描述
根据之前的需求调研及后续的需求文档分析，确认当前光明乳业的出库流程为：
1、工厂出库给领先物流（WMS出库），可理解为一级；
2、领先物流出库给批发商，可理解为二级；
3、批发商出库给商超，可理解为三级；
由于在领先物流这个阶段，可能出现包材损坏或产品损坏，需要在仓库实现包材替换及托、箱、提的关系重组，方便出库。需要TTS系统提供相应操作接口；
1、码替换:实现对损坏的包材做监管码替换，需要替换生产及流向信息；
2、关联关系上传接口：为每个单据对应的关联关系，即，不论是否经过产品包装的重组，每个上传到TTS系统的单据，WMS系统都需要提供对应该单据的完整的关联关系信息（重组后的包装需要提供为重组后的包装关系，文件格式有TTS系统提供），TTS系统接收到该关联关系后，提供接口给PDM，PDM根据当前所属企业，获取发送给给企业的关联关系；重组后的监管码TTS系统不支持流向查询；
3、单据上传接口：WMS完成单据的扫描出库后，需要上传该单据给TTS系统；
4 接口
接口调用，首先获取TTS的Token认证，再调用具体接口；
4.1 Token管理
access_token是TTS的全局唯一票据，调用TTS各接口时都需使用access_token。开发者需要进行妥善保存。access_token的存储至少要保留512个字符空间。access_token的有效期目前为2个小时，需定时刷新，重复获取将导致上次获取的access_token失效。
其他系统可以使用AppID和AppSecret调用本接口来获取access_token。AppID和AppSecret可在TTS提供的界面中维护。
接口调用请求说明
http请求方式: POST
http://站点地址/WebAPIs/BasicService.svc/GetToken
调用示例
{
"AppId":"",
"Secret":"",
"Session_Id":""
}
参数说明
参数
是否必须
类型
说明
AppId
是
字符串
第三方用户唯一凭证
Secret
是
字符串
第三方用户唯一凭证密钥，即appsecret
Session_Id
是
字符串
客户端唯一表示标识
返回说明
正常情况下，TTS会返回下述JSON数据包：
{"Result":"True","Access_Token":"ACCESS_TOKEN","ErrCode":"0","ErrMsg":"","Expires_In":7200,"CorpCode":"01"}
参数
类型
说明
Access_Token
字符串
获取到的凭证
Expires_In
数字
凭证有效时间，单位：秒
CorpCode
字符串
企业编码
错误时TTS会返回错误码等信息，JSON数据包示例如下
{"Result":"False"," Access_Token ":"","ErrCode":"1"," ErrMsg ":"错误消息","Expires_In":0,"CorpCode":""}
4.2 码替换接口
接口说明：用于实现追溯码的替换，替换时，同时替换生产批次码及对应的出库后的码；码替换不是重组的吗；
请求方式：Post
接口地址：http://系统地址/TTS/WebAPIs/CodeService.svc/ReplaceCode
调用示例
{
"Token":"",
"OldCodeId":"",
"NewCodeId":""
}
参数说明
参数
是否必须
说明
OldCodeId
是
被替换的码
NewCodeId
是
替换的码
返回说明
正常情况下，TTS会返回下述JSON数据包：
{
"ErrCode":"0",
"ErrMsg":null,
"Result":true
}
错误时TTS会返回错误码等信息，JSON数据包示例如下
{"Result":false,"ErrCode":"1","ErrMsg":"错误信息" }
4.3 单据上传接口
接口说明：TTS提供接收标准TTS关联关系及单据格式的接口，用于接收第三方上传的单据文件实现生产入库及销售出库；
由于涉及到关系重组，所有，在出库扫描时，如果当前扫描单位为重组的包装，需要将当前扫描单位的下级包装码当作扫描码，即如果扫描的是重组的托盘码，单据中需要记录的是托盘下的所有箱码；如果没有重组，那就记录扫描的托盘码即可，相应的箱、提操作与托盘操作相同；
注：由于系统需要维护各个经销商的行政区域信息，为管控平台做数据统计，也避免人为去一个个的给经销商企业做区域信息的维护，需要在单据的文件中维护上企业所在的行政区域信息；
所有出库单位扫描的码，可以向下查询，不可以向上查询，即如果是单据里包括的提码，不能以箱码做追溯条件。
请求方式：Post
接口地址：http://系统地