- 文档大小:9.49 MB
- 文档格式:doc
- 约 130页
- 2022-08-22 发布
- 举报
试读已结束,还剩120页未读,您可下载完整版后进行离线阅读
- 1、本文档共130页,内容下载后可编辑。
- 2、本文档内容版权归属内容提供方,所产生的收益全部归内容提供方所有。如果您对本文有版权争议,可选择认领。
- 3、本文档由用户上传,本站不保证质量和数量令人满意,可能有诸多瑕疵,付费之前,请仔细先通过免费阅读内容等途径辨别内容交易风险。如存在严重挂羊头卖狗肉之情形,可联系本站下载客服投诉处理。
)文档编号:XQDY201710_002页码:1of130公司:北京爱创科技股份有限公司版本:Rev2.0标题:光明乳业追溯服务平台详细设计光明乳业全程追溯管控及追溯服务平台、产线赋码系统项目追溯服务平台-详细设计说明书Preparedby拟制夏习林、郭武、栗树亮Date日期2017-09-28Reviewedby评审人王学栋Date日期2017-10-20Approvedby批准刘鸣Date日期2017-10-31)文档编号:XQDY201710_002页码:2of130公司:北京爱创科技股份有限公司版本:Rev2.0标题:光明乳业追溯服务平台详细设计RevisionRecord修订记录Date日期RevisionVersion修订版本ChangeDescription修改描述Author作者2017-09-26V0.1初版郭武2017-09-28V0.2修订版夏习林2017-10-20V1.0修订版栗树亮2018-01-08V2.0终版刘鸣)文档编号:XQDY201710_002页码:3of130公司:北京爱创科技股份有限公司版本:Rev2.0标题:光明乳业追溯服务平台详细设计目录一、TTS系统详细设计说明书............................................................................................................................61引言.............................................................................................................................................................61.1编写目的.........................................................................................................................................61.2范围.................................................................................................................................................61.3参考资料.........................................................................................................................................71.4术语定义及说明............................................................................................................................72设计总体架构............................................................................................................................................73功能模块实现设计....................................................................................................................................83.1.基础类设计...................................................................................................................................83.1.1.BasePage.........................................................................................................................83.2.公用模块实现设计.......................................................................................................................93.2.1系统登录.............................................................................................................................93.2.2资料管理..........................................................................................................................113.2.3产品管理..........................................................................................................................173.2.4追溯码管理......................................................................................................................213.2.5入出库管理......................................................................................................................273.2.6流向查询..........................................................................................................................363.2.7预警管理..........................................................................................................................413.2.8报表统计..........................................................................................................................503.2.9稽查...................................................................................................................................563.2.10数据上报........................................................................................................................593.2.11系统管理........................................................................................................................63二、TTS与WMS、PDM接口对接文档.........................................................................................................691业务流程..................................................................................................................................................702业务逻辑..................................................................................................................................................703业务描述..................................................................................................................................................704接口..........................................................................................................................................................714.1Token管理..................................................................................................................................714.2码替换接口..................................................................................................................................724.3单据上传接口..............................................................................................................................724.4重组关联关系上传接口.............................................................................................................764.5重组的关联关系文件列表接口................................................................................................814.6重组的关联关系文件下载接口................................................................................................824.7重组关联关系文件状态更新接口............................................................................................824.8库存校正接口..............................................................................................................................834.9单码流向查询接口.....................................................................................................................84三、PDM5.1软件详细设计说明书................................................................................................................861引言........................................................................................................................................................861.1编写目的....................................................................................................................................861.2范围.............................................................................................................................................861.3参考资料.....................................................................................................................................871.4术语定义及说明........................................................................................................................872设计总体架构........................................................................................................................................89)文档编号:XQDY201710_002页码:4of130公司:北京爱创科技股份有限公司版本:Rev2.0标题:光明乳业追溯服务平台详细设计3功能模块实现设计..............................................................................................................................903.1基础类设计..................................................................................................................................903.1.1BasePage.......................................................................................................................903.2公用模块实现设计.....................................................................................................................913.2.1系统登录..........................................................................................................................913.2.2产品管理..........................................................................................................................953.2.3往来单位管理..............................................................................................................1003.2.4企业法人管理................................................................................................................1053.2.5托盘码管理....................................................................................................................1083.2.6托盘关联关系管理.......................................................................................................1123.2.7建立单据........................................................................................................................1163.2.8出入库计划管理...........................................................................................................1223.2.9货运统计报表...............................................................................................................1283.2.10用户角色组织机构管理流程图................................................................................1313.2.11接口服务.....................................................................................................................1323.3数据表关系设计.......................................................................................................................1333.3.1.系统登陆相关表关系..................................................................................................1333.3.2.产品管理相关表关系..................................................................................................1343.3.3.关联关系队列相关表关系.........................................................................................1353.3.4.托盘管理相关表关系..................................................................................................1363.3.5.单据相关表关系..........................................................................................................1363.3.6.计划单管理相关表关系..............................................................................................137四、欢乐扫平台详细设计说明书..................................................................................................................1371.功能设计................................................................................................................................................1381.1企业门户....................................................................................................................................1381.1.1注册................................................................................................................................1391.1.2产品................................................................................................................................1411.1.3奖品................................................................................................................................1421.1.4乐码................................................................................................................................1441.1.5活动................................................................................................................................1451.1.6礼品................................................................................................................................1491.1.7订单................................................................................................................................1491.2手机端........................................................................................................................................1511.2.1扫码中奖........................................................................................................................1521.2.2积分商城........................................................................................................................1541.2.3手机端-渠道用户.........................................................................................................1582架构........................................................................................................................................................1602.1消费者端....................................................................................................................................1602.1.1反向代理........................................................................................................................1602.1.2Redis..............................................................................................................................1612.1.3数据库故障转移...........................................................................................................1612.1.4队列................................................................................................................................1612.2企业端........................................................................................................................................1612.2.1报表................................................................................................................................1622.2.2NAS和Redis...............................................................................................................162)文档编号:XQDY201710_002页码:5of130公司:北京爱创科技股份有限公司版本:Rev2.0标题:光明乳业追溯服务平台详细设计2.2.3负载均衡........................................................................................................................1623安全设计..............................................................................................................................................1623.1基础安全....................................................................................................................................1623.1.1网络层............................................................................................................................1623.1.2应用层............................................................................................................................1643.1.3主机层............................................................................................................................1653.1.4数据层............................................................................................................................1653.2应用安全....................................................................................................................................1663.2.1码加密............................................................................................................................1663.2.2防破解............................................................................................................................1673.2.3系统监控........................................................................................................................1673.2.4微信及接口安全...........................................................................................................168)文档编号:XQDY201710_002页码:6of130公司:北京爱创科技股份有限公司版本:Rev2.0标题:光明乳业追溯服务平台详细设计一、TTS系统详细设计说明书1引言1.1编写目的本文档的目的旨在推动软件工程的规范化,使设计人员遵循统一的详细设计书写规范,节省制作文档的时间,降低系统实现的风险,做到系统设计资料的规范性和全面性,以利于系统的实现,测试,维护和版本升级等此阶段将在概要设计的基础上,进行系统的具体详细设计。在详细设计中,描述实现具体模块所涉及到的主要算法,数据结构,类的层次结构及调用关系,需要说明软件系统各个层次中的每个程序(每个模块或子程序)的设计考虑,以便进行编码和测试。因此《详细设计说明书》要达到如下一些目标:设计应该足够的详细,达到可以编写程序的水平重点模块的执行流程和数据库系统详细设计的描述项目组成员对代码结构,命名规范性的共识编码实现的基础1.2范围本文档用于软件设计阶段的详细设计,他的依据是概要设计说明书,他为下一阶段源程序及测试服务,是其实现的指导依据。本文将在如下几个方面加以论述:各子系统的公用模块的实现设计,专用模块的实现设计,数据库实现设计,外部接口的实现设计以及角色授权的设计等。按照三层结构的布局,详细设计应该从如下三个方面进行:数据访问层设计:数据字典物理设计,基本表物理设计,中间表物理设计(报表设计)业务逻辑设计:接口数据设计,中间件设计,数据通信传输设计,角色授权设计和功能设计;UI设计:基础信息管理,托盘码管理,接口管理,单据管理,报表统计,系统管理。)文档编号:XQDY201710_002页码:7of130公司:北京爱创科技股份有限公司版本:Rev2.0标题:光明乳业追溯服务平台详细设计1.3参考资料初步需求说明书;详细需求分析说明书;概要设计说明书;1.4术语定义及说明出入库计划单:货物还未进行出库,只是描述理论上,计划上将要出库的数量,通常该单据由第三方系统通过接口产生。出入库单:实际的出入库业务产生的单据,通常由手持进行扫描出库。关联关系:将产品上的追溯码按包装比例关系形成树形关系结构的文件结构;2设计总体架构3功能模块实现设计3.1.基础类设计3.1.1.BasePage3.1.1.1.类设计)文档编号:XQDY201710_002页码:8of130公司:北京爱创科技股份有限公司版本:Rev2.0标题:光明乳业追溯服务平台详细设计类名称BasePage类功能页面基类,用于管理各页面的共同属性和方法的类属性protectedIUserServiceUsersLogic属性功能对用户进行管理的业务类属性protectedIOrganizeServiceOrganizeLogic属性功能对用户所属组织机构进行管理的业务类属性publicIWareHouseOrderLogicWareHouseOrderLogic属性功能对单据进行管理的业务类属性publicIBetweenCompanyLogicBetweenCompanyLogic属性功能对往来单位进行管理的业务类属性publicstringLastUrl属性功能客户端上次请求的页面属性protectedstringLoginUserName属性功能当前的登陆名方法1:名称publicstaticvoid_ShowMessage(stringmsg)功能消息框提示输入消息内容输出3.2.公用模块实现设计3.2.1系统登录模块编号8模块名称系统登录所属业务系统登录编写人TTS产品部完成时间2017年3.2.1.1功能流程图3.2.1.2功能描述功能类型登录验证功能描述提高系统的安全性)文档编号:XQDY201710_002页码:9of130公司:北京爱创科技股份有限公司版本:Rev2.0标题:光明乳业追溯服务平台详细设计前提业务无后继业务所有业务功能约束权限约束约束描述3.2.1.3界面设计1)基础信息处理动作编号动作名称动作描述8.0.1登录点击登录按钮提交数据到登录处理页面“login.Aspx”,数据验证成功后将转至管理页面。8.0.2重置将当前信息回复原先状态3.2.2资料管理3.2.2.1区域信息维护)文档编号:XQDY201710_002页码:10of130公司:北京爱创科技股份有限公司版本:Rev2.0标题:光明乳业追溯服务平台详细设计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界面设计)文档编号:XQDY201710_002页码:11of130公司:北京爱创科技股份有限公司版本:Rev2.0标题:光明乳业追溯服务平台详细设计3.2.2.3企业信息维护3.2.2.3.1概述:用于维护系统中所有的企业的信息。包括生产企业、印刷企业、流通企业、终端门店及与TTS系统做接口交互的企业等。不存在的企业上传数据时将无法上传并完成数据的解析操作;3.2.2.3.2业务流程:3.2.2.3.3界面设计)文档编号:XQDY201710_002页码:12of130公司:北京爱创科技股份有限公司版本:Rev2.0标题:光明乳业追溯服务平台详细设计3.2.2.4用户管理3.2.2.4.1概述:用于维护使用TTS系统的用户信息,用户是系统的登录凭证,TTS系统支持集团的域用户管理,即所有TTS系统用户必须为集团的域用户,确保使用系统的安全控制及账号的统一效注管理。3.2.2.4.2业务流程:)文档编号:XQDY201710_002页码:13of130公司:北京爱创科技股份有限公司版本:Rev2.0标题:光明乳业追溯服务平台详细设计3.2.2.5批次信息维护3.2.2.5.1概述:用于查看、维护生产批次信息。3.2.2.5.2业务流程:3.2.2.5.3界面设计)文档编号:XQDY201710_002页码:14of130公司:北京爱创科技股份有限公司版本:Rev2.0标题:光明乳业追溯服务平台详细设计3.2.3产品管理3.2.3.1产品目录管理3.2.3.1.1概述:用于维护系统产品的大类,即用于将新增的产品划分到指定的大类中,便于检索;例如药品目录可以是特殊药品、普通药品、OTC药品。乳制品可以是液态奶、奶粉、乳制品饮料等等。3.2.3.1.2业务流程:3.2.3.1.3界面设计)文档编号:XQDY201710_002页码:15of130公司:北京爱创科技股份有限公司版本:Rev2.0标题:光明乳业追溯服务平台详细设计3.2.3.2产品信息维护3.2.3.2.1概述:用于维护集团所生产的产品信息,产品信息包括产品编码、名称、库存单位、有效期等,产品信息支持宣传图定期变更,支持不同生产时间不同的产品宣传图,用于系统在防伪稽查时匹配正确的宣传图。3.2.3.2.2业务流程:3.2.3.2.3界面设计)文档编号:XQDY201710_002页码:16of130公司:北京爱创科技股份有限公司版本:Rev2.0标题:光明乳业追溯服务平台详细设计3.2.3.3企业产品维护3.2.3.3.1概述:用于指定生产企业所生产的产品,建立生产企业与产品的关联关系;3.2.3.3.2业务流程:3.2.3.3.3界面设计)文档编号:XQDY201710_002页码:17of130公司:北京爱创科技股份有限公司版本:Rev2.0标题:光明乳业追溯服务平台详细设计3.2.3.4包装比例维护3.2.3.4.1概述:维护产品的内外包装信息。使产品可按照指定比例进行包装与出库;3.2.3.4.2业务流程:3.2.3.4.3界面设计)文档编号:XQDY201710_002页码:18of130公司:北京爱创科技股份有限公司版本:Rev2.0标题:光明乳业追溯服务平台详细设计3.2.4追溯码管理3.2.4.1追溯码申请3.2.4.1.1概述:用于企业生成指定规则的追溯码,用于包材印刷、下载;3.2.4.1.2业务流程:3.2.4.1.3界面设计)文档编号:XQDY201710_002页码:19of130公司:北京爱创科技股份有限公司版本:Rev2.0标题:光明乳业追溯服务平台详细设计3.2.4.2追溯码查询3.2.4.2.1概述:用于查询追溯码对应的产品、批号、父子码的关系信息,可实现查看查询的码所在的批次信息。用于实现追溯单码流向信息,包括原料到销售的各个环节信息及批次信息流向。用于实现正向与方向追溯产品质量信息;3.2.4.2.2业务流程:3.2.4.2.3页面设计)文档编号:XQDY201710_002页码:20of130公司:北京爱创科技股份有限公司版本:Rev2.0标题:光明乳业追溯服务平台详细设计3.2.4.3追溯码导出3.2.4.3.1概述:用于将生产批次数据按包装级别分别生产相应不同级别的码文件,方便用户查看相应批次的码信息;3.2.4.3.2业务流程:3.2.4.3.3页面设计)文档编号:XQDY201710_002页码:21of130公司:北京爱创科技股份有限公司版本:Rev2.0标题:光明乳业追溯服务平台详细设计3.2.4.4码模糊查询3.2.4.4.1概述用于处理追溯码码被部分损坏或记录不清楚时,可以通过通配符%或?来查询码。3.2.4.4.2业务流程3.2.4.4.3界面设计)文档编号:XQDY201710_002页码:22of130公司:北京爱创科技股份有限公司版本:Rev2.0标题:光明乳业追溯服务平台详细设计3.2.4.5码规则管理3.2.4.5.1概述用于配置符合企业生产要求的追溯码生成规则,供追溯码申请时选择使用,并生成相应规则的码文件。3.2.4.5.2业务流程3.2.4.5.3页面设计)文档编号:XQDY201710_002页码:23of130公司:北京爱创科技股份有限公司版本:Rev2.0标题:光明乳业追溯服务平台详细设计3.2.4.6追溯码下载3.2.4.6.1概述用于将在TTS系统申请的追溯码及对应的防伪码下载到本地,发给印刷企业或赋码系统进行赋码生产;重点是在TTS系统申请的码;3.2.4.6.2业务流程3.2.4.6.3页面设计)文档编号:XQDY201710_002页码:24of130公司:北京爱创科技股份有限公司版本:Rev2.0标题:光明乳业追溯服务平台详细设计3.2.5入出库管理3.2.5.1入出库上传监控3.2.5.1.1概述用于检索监控系统处理手持上传的单据处理结果(成功、失败、等待),主要用于发现单据失败时失败单据的原因,可按失败原因进行单据检索,如:重复出库、缺少关联关系等,方便用于第一时间解决单据问题。3.2.5.1.2业务流程)文档编号:XQDY201710_002页码:25of130公司:北京爱创科技股份有限公司版本:Rev2.0标题:光明乳业追溯服务平台详细设计3.2.5.1.3页面设计3.2.5.2关联关系上传监控3.2.5.2.1概述用于监控关联关系文件解析状态及文件中追溯码存在的异常,可根据关联关系文件解析状态进行检索查询,如可检索关联关系文件有重复上传的码、无效的码(指的的当前关联关系文件的码在系统中存在,并且父码与系统中的父码不一致),可快速定位生产端的赋码问题信息;3.2.5.2.2业务说明3.2.5.2.3页面设计)文档编号:XQDY201710_002页码:26of130公司:北京爱创科技股份有限公司版本:Rev2.0标题:光明乳业追溯服务平台详细设计3.2.5.3入出库任务单3.2.5.3.1概述用于在TTS系统中创建入出库任务单,用于手持或其它终端设备进行扫描出库;3.2.5.3.2业务流程3.2.5.3.3页面设计)文档编号:XQDY201710_002页码:27of130公司:北京爱创科技股份有限公司版本:Rev2.0标题:光明乳业追溯服务平台详细设计3.2.5.4入出库上传3.2.5.4.1概述实现将TTS系统支持的关联关系文件、单据文件手动上传到平台并进行处理;3.2.5.4.2业务流程3.2.5.4.3页面设计)文档编号:XQDY201710_002页码:28of130公司:北京爱创科技股份有限公司版本:Rev2.0标题:光明乳业追溯服务平台详细设计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页面设计)文档编号:XQDY201710_002页码:29of130公司:北京爱创科技股份有限公司版本:Rev2.0标题:光明乳业追溯服务平台详细设计3.2.6流向查询3.2.6.1单码流向查询3.2.6.1.1概述用于查看追溯码的单据流向信息;信息包括追溯码的基本信息及追溯码的发货流向的单据信息,实现码的正向追踪;追溯码流向查询信息包括:产品的基础信息、奶源信息(奶仓号,原奶批次号,原奶供应商,承运车辆车牌,到厂时间,原奶检测结果,过磅数量,卸奶时间,收奶线,奶仓定容情况,奶仓检测结果,原奶仓储存时间)、巴杀信息(原奶批次,预巴氏号,巴氏运行参数,巴氏起止时间,调奶数量,巴氏存储时间温度,入库时间)、配料列表(调奶量,配料批次号,配料罐号,白糖,稳定剂,原料批次,原奶批次号,投料温度,混料线号,混料时间,定容添加量,定容数量,定容指标)、基料巴氏(菌种活化时间,运行时间,基料巴杀批次,基料巴杀参数,菌种添加数量,添加时间,发酵罐号/数量)信息;根据追溯码可以找到原料信息,包括:原料批次号,原料名称,数量,供应商信息;)文档编号:XQDY201710_002页码:30of130公司:北京爱创科技股份有限公司版本:Rev2.0标题:光明乳业追溯服务平台详细设计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页面设计)文档编号:XQDY201710_002页码:31of130公司:北京爱创科技股份有限公司版本:Rev2.0标题:光明乳业追溯服务平台详细设计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业务流程)文档编号:XQDY201710_002页码:32of130公司:北京爱创科技股份有限公司版本:Rev2.0标题:光明乳业追溯服务平台详细设计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区域过期产品)文档编号:XQDY201710_002页码:33of130公司:北京爱创科技股份有限公司版本:Rev2.0标题:光明乳业追溯服务平台详细设计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概述用于统计防伪码)文档编号:XQDY201710_002页码:34of130公司:北京爱创科技股份有限公司版本:Rev2.0标题:光明乳业追溯服务平台详细设计被查询超过指定次数的信息,第一时间通知订阅者及时处理异常信息;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概述用于统计出库的产品没有生产信息即没有上传关联关系,提示相关生产企业及)文档编号:XQDY201710_002页码:35of130公司:北京爱创科技股份有限公司版本:Rev2.0标题:光明乳业追溯服务平台详细设计时上传生产批次信息。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概述用于统计同一个码在不同生产批次中,提示订)文档编号:XQDY201710_002页码:36of130公司:北京爱创科技股份有限公司版本:Rev2.0标题:光明乳业追溯服务平台详细设计阅者赋码生产存在问题并及时处理;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业务流程)文档编号:XQDY201710_002页码:37of130公司:北京爱创科技股份有限公司版本:Rev2.0标题:光明乳业追溯服务平台详细设计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业务流程)文档编号:XQDY201710_002页码:38of130公司:北京爱创科技股份有限公司版本:Rev2.0标题:光明乳业追溯服务平台详细设计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页面设计)文档编号:XQDY201710_002页码:39of130公司:北京爱创科技股份有限公司版本:Rev2.0标题:光明乳业追溯服务平台详细设计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概述用于微信公众号,通过手机扫描产品追溯码,判断产品是否有窜货,实现企业对窜货的管控。微信稽查用于企业稽查人员在线判断产品是否窜货,及时掌握市场流)文档编号:XQDY201710_002页码:40of130公司:北京爱创科技股份有限公司版本:Rev2.0标题:光明乳业追溯服务平台详细设计通状态。微信稽查是TTS系统通过微信服务号实现微信扫描追溯码,获取追溯码信息的手机扫描稽查功能,方便稽查管理。3.2.9.1.2业务流程3.2.9.1.3页面设计3.2管.2门店签到3.2.9.2.1业务员数据结构I.字段I.名称I.类型I.说明II.idII.编号II.int(11)II.III.openidIII.微信openidIII.varchar(32)III.IV.realnameIV.业务员姓名IV.varchar(16)IV.V.mobileV.手机号V.varchar(11)V.VI.sexVI.性别VI.tinyint(1)VI.VII.areaVII.所属区域VII.int(11)VII.VIII.VIII.VIII.VIII.业务员微信绑定流程业务员打开微信公众号,从菜单进入业务员中心页面,提示绑定业务员账号。业务员输入手机号,姓名和手机验证码后经系统校验通过便可成功绑定微信。3.2.9.2.2门店数据结构I.字段I.名称I.类型I.说明II.idII.编号II.int(11)II.III.shop_nameIII.门店名称III.varchar(32)III.IV.addressIV.门店地址IV.varchar(64)IV.V.qrcodeV.门店二维码V.varchar(6)V.门店分配的唯一二维码,供业务员扫描签到VI.telVI.门店联系方式VI.varchar(11)VI.VII.areaVII.所属区域VII.int(11)VII.VIII.latVIII.门店位置经度VIII.float(9,6)VIII.IX.lngIX.门店位置纬度IX.float(9,6)IX.门店二维码分配流程门店注册需要先在系统录入门店信息,录入后可以为门店分配一个二维码,二维)文档编号:XQDY201710_002页码:41of130公司:北京爱创科技股份有限公司版本:Rev2.0标题:光明乳业追溯服务平台详细设计码由业务员在店铺现场激活,系统会记录下二维码的激活位置,作为以后业务员签到的位置依据。3.2.9.2.3签到数据结构I.字段I.名称I.类型I.说明II.idII.编号II.int(11)II.III.shop_idIII.门店编号III.int(11)III.IV.shop_nameIV.门店名称IV.varchar(64)IV.冗余字段V.salesman_idV.业务员编号V.int(11)V.VI.salesman_nameVI.业务员姓名VI.varchar(16)VI.冗余字段VII.check_in_timeVII.签到时间VII.datetimeVII.VIII.latVIII.签到经度VIII.float(9,6)VIII.IX.lngIX.签到纬度IX.float(9,6)IX.X.X.X.X.签到流程业务员签到第一步是通过微信扫描二维码,进入签到页面。如果业务员所在位置在扫描的二维码所属门店范围内,则可以进行签到,否则不能签到。3.2.9.2.4统计分析业务员签到次数统计I.字段I.名称I.类型I.说明II.idII.编号II.int(11)II.III.salesman_idIII.业务员编号III.int(11)III.IV.salesman_nameIV.业务员姓名IV.varchar(16)IV.冗余字段V.check_in_countV.签到次数V.int(11)V.VI.VI.VI.VI.业务员签到门店统计I.字段I.名称I.类型I.说明II.idII.编号II.int(11)II.III.salesman_idIII.业务员编号III.int(11)III.IV.salesman_nameIV.业务员姓名IV.varchar(16)IV.冗余字段V.shop_idV.门店编号V.int(11)V.VI.shop_nameVI.门店名称VI.varchar(64)VI.冗余字段VII.check_in_countVII.签到次数VII.int(11)VII.VIII.VIII.VIII.VIII.)文档编号:XQDY201710_002页码:42of130公司:北京爱创科技股份有限公司版本:Rev2.0标题:光明乳业追溯服务平台详细设计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系统,实现指定生产批次的产品做营销活动。)文档编号:XQDY201710_002页码:43of130公司:北京爱创科技股份有限公司版本:Rev2.0标题:光明乳业追溯服务平台详细设计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系统再下发到印刷企业,实现数据无人工接)文档编号:XQDY201710_002页码:44of130公司:北京爱创科技股份有限公司版本:Rev2.0标题:光明乳业追溯服务平台详细设计触,确保数据流通安全;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业务说明)文档编号:XQDY201710_002页码:45of130公司:北京爱创科技股份有限公司版本:Rev2.0标题:光明乳业追溯服务平台详细设计3.2.11.2.3页面设计3.2.11.3单据类型设置3.2.11.3.1概述用于设置系统识别的单据类型,可根据企业自定义名称设置,同时,可根据业务需要,定义单据的后置类型,用于系统自动实现入出库,如销售出库的后置类型为采购入库等;3.2.11.3.2业务说明3.2.11.3.3页面设计)文档编号:XQDY201710_002页码:46of130公司:北京爱创科技股份有限公司版本:Rev2.0标题:光明乳业追溯服务平台详细设计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页面设计)文档编号:XQDY201710_002页码:47of130公司:北京爱创科技股份有限公司版本:Rev2.0标题:光明乳业追溯服务平台详细设计二、TTS与WMS、PDM接口对接文档版本更新时间修订人修订内容版本号2017-9-29夏习林V1.0.02017-10-13夏习林加入校正接口V1.0.12017-10--20夏习林合并文件格式为一个文件,加入字段表格说明V1.0.22017-10-26夏习林加入企业级别说明,管控平台只需要企业级别为一级批发的单据上报到管控平台V1.0.32017-11-10夏习林更新单据及关联关系的报文说明及字段说明V1.042017-11-20夏习林更新单据与关联关系的行政区域信息,在V1.05)文档编号:XQDY201710_002页码:48of130公司:北京爱创科技股份有限公司版本:Rev2.0标题:光明乳业追溯服务平台详细设计企业信息中新增AreaCode及AreaName,存储国家指定的区域编码1业务流程2业务逻辑1、每个流向节点的单据信息都需要上传到TTS系统;2、单据类型包括销售出库、采购入库、调拨入库等,类型在TTS系统手动维护;3、流通企业是否需要扫描入库?如需要,需要上传对应的采购入库单;4、单据信息以每个单据时间发货量为一个单据并作为上传到TTS系统的单据文件,如一个单据包括10托,需将10托作为一个单据文件;3业务描述根据之前的需求调研及后续的需求文档分析,确认当前光明乳业的出库流程为:1、工厂出库给领先物流(WMS出库),可理解为一级;2、领先物流出库给批发商,可理解为二级;)文档编号:XQDY201710_002页码:49of130公司:北京爱创科技股份有限公司版本:Rev2.0标题:光明乳业追溯服务平台详细设计3、批发商出库给商超,可理解为三级;由于在领先物流这个阶段,可能出现包材损坏或产品损坏,需要在仓库实现包材替换及托、箱、提的关系重组,方便出库。需要TTS系统提供相应操作接口;1、码替换:实现对损坏的包材做监管码替换,需要替换生产及流向信息;2、关联关系上传接口:为每个单据对应的关联关系,即,不论是否经过产品包装的重组,每个上传到TTS系统的单据,WMS系统都需要提供对应该单据的完整的关联关系信息(重组后的包装需要提供为重组后的包装关系,文件格式有TTS系统提供),TTS系统接收到该关联关系后,提供接口给PDM,PDM根据当前所属企业,获取发送给给企业的关联关系;重组后的监管码TTS系统不支持流向查询;3、单据上传接口:WMS完成单据的扫描出库后,需要上传该单据给TTS系统;4接口接口调用,首先获取TTS的Token认证,再调用具体接口;4.1Token管理access_token是TTS的全局唯一票据,调用TTS各接口时都需使用access_token。开发者需要进行妥善保存。access_token的存储至少要保留512个字符空间。access_token的有效期目前为2个小时,需定时刷新,重复获取将导致上次获取的access_token失效。其他系统可以使用AppID和AppSecret调用本接口来获取access_token。AppID和AppSecret可在TTS提供的界面中维护。接口调用请求说明http请求方式:POSThttp://站点地址/WebAPIs/BasicService.svc/GetToken调用示例{\"AppId\":\"\",\"Secret\":\"\",\"Session_Id\":\"\"}参数说明参数是否必须类型说明AppId是字符串第三方用户唯一凭证Secret是字符串第三方用户唯一凭证密钥,即appsecretSession_Id是字符串客户端唯一表示标识返回说明正常情况下,TTS会返回下述JSON数据包:{\"Result\":\"True\",\"Access_Token\":\"ACCESS_TOKEN\",\"ErrCode\":\"0\",\"ErrMsg\":\"\",\"Expires_In\":7200,\"CorpCode\":\"01\"}参数类型说明Access_Token字符串获取到的凭证Expires_In数字凭证有效时间,单位:秒)文档编号:XQDY201710_002页码:50of130公司:北京爱创科技股份有限公司版本:Rev2.0标题:光明乳业追溯服务平台详细设计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关联关系及单据格式的接口,用于接收第三方上传的单据文件实现生产入库及销售出库;由于涉及到关系重组,所有,在出库扫描时,如果当前扫描单位为重组的包装,需要将当前扫描单位的下级包装码当作扫描码,即如果扫描的是重组的托盘码,单据中需要记录的是托盘下的所有箱码;如果没有重)文档编号:XQDY201710_002页码:51of130公司:北京爱创科技股份有限公司版本:Rev2.0标题:光明乳业追溯服务平台详细设计组,那就记录扫描的托盘码即可,相应的箱、提操作与托盘操作相同;注:由于系统需要维护各个经销商的行政区域信息,为管控平台做数据统计,也避免人为去一个个的给经销商企业做区域信息的维护,需要在单据的文件中维护上企业所在的行政区域信息;所有出库单位扫描的码,可以向下查询,不可以向上查询,即如果是单据里包括的提码,不能以箱码做追溯条件。请求方式:Post接口地址:http://系统地址/TTS/WebAPIs/CodeService.svc/UploadRelationFile调用示例{\"Token\":\"\",\"FileName\":\"\",\"FileContent\":\"\"}参数说明参数是否必须说明FileName是文件名FileContent是文件内容(base64编码的zip文件)小于20MFileContent文件内容描述XML字段是否必须说明文件描述docId是文档编号GUID类型,每个文件的文档编号不同docType是固定值:StoredocOwner是为当前上传企业的编码docVersion是文档版本,此标准的值等于“4.0”docVerified是默认true,TTS系统直接解析文件,无需人工审核单据信息StoresmId是单据ID,GUID类型StoreNo是单据号,字符串类型StoreType是PurchaseIn采购入库)文档编号:XQDY201710_002页码:52of130公司:北京爱创科技股份有限公司版本:Rev2.0标题:光明乳业追溯服务平台详细设计ReturnOut退货出库SaleOut销售出库ReturnIn退货入库SaleOutX零售出库ReturnInX零售退货AllocateIn调拨入库AllocateOut调拨出库CheckIn盘点盈余CheckOut盘点亏损DestroyOut销毁出库TestingOut抽检出库MissingOut报失出库OtherOut其它出库CorpCode是指开单企业信息编码,字符串类型BizCorpCode是是开单企业的往来企业,字符串类型CreatedTime否单据创建日期,日期类型(2017-08-04T10:09:09)OperateDate是开单日期(单据信息的StoreDate),日期类型(同上)Operator否开单人(单据信息的StoreMan),字符串类型Autoin否1、对于销售单,是否自动生成对应往来企业的入库单。2、如果Autoin无值,则取TTS系统企业参数配置中的上游出库下游自动入库的配置;3、若为true,则自动生成对应的入库单。可选项码信息CodesId是进行入出库的码ActTime是操作码的时间,时间类型Actor否操作码的人企业信息CorpsAreaCode否区域编码,用于划分企业销售区域信息(86为保留编码,表示中国,其它企业自定义))文档编号:XQDY201710_002页码:53of130公司:北京爱创科技股份有限公司版本:Rev2.0标题:光明乳业追溯服务平台详细设计130202:河北省唐山市路南区AreaName否区域名称(130202:河北省唐山市路南区)RegionCode是企业所属区域编码(企业自定义)RegionName是企业所属区域名称(企业自定义)CorpCode是企业编码(企业自定义)CorpName是企业名称(企业自定义)CorpType是企业类型(流通企业:SalesCorp)CorpRankName是企业级别(管控平台需要区分一级批发商,所以,WMS发送给一级批发企业的单据,在客户信息中需要指定企业级别,TTS根据指定的企业信息自动维护企业级别)企业对应的区域信息RegionsCode是Name是区域名称,如华东、华北ParentCode是上级区域编码文件范例:以下示例是企业编码为DGJCQYZZZ,往来企业编码为C0000003的出入库单据文件 )文档编号:XQDY201710_002页码:54of130公司:北京爱创科技股份有限公司版本:Rev2.0标题:光明乳业追溯服务平台详细设计 返回说明正常情况下,TTS会返回下述JSON数据包:{\"ErrCode\":\"0\",\"ErrMsg\":null,\"Result\":true}错误时TTS会返回错误码等信息,JSON数据包示例如下{\"Result\":false,\"ErrCode\":\"1\",\"ErrMsg\":\"错误信息\"}4.4重组关联关系上传接口TTS提供接收标准TTS关联关系及单据格式的接口,由于此处在WMS出经过重组,TTS系统不记录重组数据的信息,主要用于将重组的关联关系数据下发到下级的经销商,方便下级经销商的出库;由于TTS系统需要针对下级经销的PDM系统做重组关系的一一对应的下方,及WMS系统出库到指定的经销商,指定的经销商才允许下载该重组的关联关系,所有,WMS系统需要上传往来单位。重组的关联关系文件保护完整的包装信息,即:托、[箱]、[提]、包/瓶/袋;注:在关联关系文件中,批次号必须填写,且必须是赋码上传的该产品对应的生产批号;码替换不是重组的码,不需要标识;请求方式:Post接口地址:http://系统地址/TTS/WebAPIs/CodeService.svc/UploadRebuildRelationFile接口说明:调用示例{\"Token\":\"\",\"FileName\":\"\",\"BizCorpCode\":\"\"\"StoreNo\":\"\"\"FileContent\":\"\")文档编号:XQDY201710_002页码:55of130公司:北京爱创科技股份有限公司版本:Rev2.0标题:光明乳业追溯服务平台详细设计}参数说明参数是否必须说明FileName是文件名BizCorpCode是往来企业编码,即改关联关系应发送的经销商编码StoreNo是重组的关联关系文件对应的单据号FileContent是文件内容(base64编码的zip文件)小于20MFileContent格式说明XML字段是否必须说明文件描述docId是文档编号GUID类型,每个文件的文档编号不同docType是固定值:RelationdocOwner是为当前上传企业的编码docVersion是文档版本,此标准的值等于“4.0”docIndustry是固定值MedicinedocVerified是上传关联关系无需审核,true批次信息RelationsId是RelationId,GUID类型,即存储到批次表中的BatchIdProductCode是产品编码,字符串类型ProduceCorpCode是生产企业编码,字符串类型ProduceBatchNo是生产批次ProduceLicense是生产准字号,没有就填“无”OuterPackage是产品包装比例,如:6瓶:1箱ProduceDate是批次生产日期,日期类型(2017-09-12))文档编号:XQDY201710_002页码:56of130公司:北京爱创科技股份有限公司版本:Rev2.0标题:光明乳业追溯服务平台详细设计ExpireDate是批次过期日期,日期类型(2019-09-12)Description是可空OperateDate是生成的生产入库单的操作日期(StoreDate),时间类型(2017-09-12T16:44:26)重组是如果填写当前时间即可Operator否生成的生产入库单的操作人(StoreMan),字符串类型。可以写一个能个标识自己的名称,如“WMS”ProduceWorkshop否生产车间,字符串类型,可选项ProduceWorkline否生产线,字符串类型,可选项生产信息Produces,此节点可去除产品信息Product,此节点可空CategoryCode否产品类别CategoryName否产品类别名称BrandCode否品牌编码BrandName否品牌名称ProductCode是产品编码ProductName是产品名称ProductUnit是库存单位:瓶、箱、提ProductAlias否产品简称InnerPacking是包装规格250ml/瓶生产企业信息Corp,节点可空AreaCode否区域编码,用于划分企业销售区域信息(86为保留编码,表示中国,其它企业自定义)130202:河北省唐山市路南区AreaName否区域名称:130202:河北省唐山市路南区RegionCode是自定义区域编码)文档编号:XQDY201710_002页码:57of130公司:北京爱创科技股份有限公司版本:Rev2.0标题:光明乳业追溯服务平台详细设计RegionName否自定义区域名称CorpCode是企业编码CorpName是企业名称CorpType是企业类型:ProduceCorp企业区域信息Regions,节点可空Code是区域编码,用于划分企业销售区域信息(86为保留编码,表示中国,其它企业自定义)Name是区域名称,如华东、华北ParentCode是上级区域编码码信息Id是当前码Level是当前码级别,Int类型,1级表示最里层包装,依次向外从1到9。最大支持9级包装Amount否只能在非1级码上存在;如果某级码上指定了此属性,那么本级所有的级码上都要指定此属性;Amount属性描述的是此码下的所有1级码的数量(不是指此码的直接子码数量)。如果2级码中指定了amount值,那么他的子码可以没有,否则必顺有子码。可选项ParentId否当前码的父码ProduceTime否码的生产时间,时间类型(2017-09-12T16:44:26)Flag是Int类型,可选项,在此处用于标记是否该包装经过重组,1:重组,0或无属性为没有重组。报文范例 返回说明正常情况下,TTS会返回下述JSON数据包:{\"ErrCode\":\"0\",\"ErrMsg\":null,)文档编号:XQDY201710_002页码:59of130公司:北京爱创科技股份有限公司版本:Rev2.0标题:光明乳业追溯服务平台详细设计\"Result\":true}错误时TTS会返回错误码等信息,JSON数据包示例如下{\"Result\":false,\"ErrCode\":\"1\",\"ErrMsg\":\"错误信息\"}4.5重组的关联关系文件列表接口接口说明:提供WMS上传到TTS系统的关联关系文件列表,PDM系统根据列表信息,可选择指定要下载的文件;请求方式:Get接口地址:http://系统地址/TTS/WebAPIs/CodeService.svc/GetRebuildRelationFile接口说明:调用示例{\"Token\":\"\"\"CorpCode\":\"\",\"State\":1\"Ext1\":\"\"}参数说明参数是否必须说明CorpCode是企业编码,经销商的企业编码Status是0:所有;1:已下载;2:未下载Ext1是扩展属性,暂不用返回说明正常情况下,TTS会返回下述JSON数据包:{\"ErrCode\":\"0\",\"ErrMsg\":null,\"Result\":true,[{ID:id,fileName:\"\"}]}错误时TTS会返回错误码等信息,JSON数据包示例如下{\"Result\":false,\"ErrCode\":\"1\",\"ErrMsg\":\"错误信息\"})文档编号:XQDY201710_002页码:60of130公司:北京爱创科技股份有限公司版本:Rev2.0标题:光明乳业追溯服务平台详细设计文件格式点击下面链接:4.6重组的关联关系文件下载接口接口说明:根据指定的重组关联关系文件的id,下载对应的关联关系请求方式:Get接口地址:http://系统地址/TTS/WebAPIs/CodeService.svc/DownRebuildRelationFile接口说明:调用示例{\"Token\":\"\"\"ID\":\"\"}参数说明参数是否必须说明ID是指定要下载的重组关联关系ID返回说明正常情况下,TTS会返回下述JSON数据包:{\"ErrCode\":\"0\",\"ErrMsg\":null,\"Result\":true,\"RelationFileContent\":\"\",\"StoreFileContent\":\"\"}错误时TTS会返回错误码等信息,JSON数据包示例如下{\"Result\":false,\"ErrCode\":\"1\",\"ErrMsg\":\"错误信息\"}FileContent文件内容(base64编码的zip文件)小于20M4.7重组关联关系文件状态更新接口接口说明:根据指定的重组关联关系文件的id,更新对应的关联关系下载状态请求方式:Get接口地址:http://系统地址/TTS/WebAPIs/CodeService.svc/UpdateRebuildRelationFileStatus接口说明:调用示例{)文档编号:XQDY201710_002页码:61of130公司:北京爱创科技股份有限公司版本:Rev2.0标题:光明乳业追溯服务平台详细设计\"Token\":\"\"\"ID\":\"\",\"Status\":1}参数说明参数是否必须说明ID是指定要下载的重组关联关系IDStatus是0:所有;1:已下载;2:未下载返回说明正常情况下,TTS会返回下述JSON数据包:{\"ErrCode\":\"0\",\"ErrMsg\":null,\"Result\":true,}错误时TTS会返回错误码等信息,JSON数据包示例如下{\"Result\":false,\"ErrCode\":\"1\",\"ErrMsg\":\"错误信息\"}4.8库存校正接口接口说明:用于实现库存校验,经销商调用此接口,实现TTS库存与PDM的库存数量统一;请求方式:Post接口地址:http://系统地址/TTS/WebAPIs/CodeService.svc/ValidatedStock调用示例{\"Token\":\"\",\"CorpCode\":\"\"\"BatchNo\",\"\"\"ProductCode\":\"\",\"StockAmount:}参数说明参数是否必须说明CorpCode是当前企业编码BatchNo是生产批次号ProductCode是盘点产品编码)文档编号:XQDY201710_002页码:62of130公司:北京爱创科技股份有限公司版本:Rev2.0标题:光明乳业追溯服务平台详细设计StockAmount是盘点库存实际数量返回说明正常情况下,TTS会返回下述JSON数据包:{\"ErrCode\":\"0\",\"ErrMsg\":null,\"Result\":true}错误时TTS会返回错误码等信息,JSON数据包示例如下{\"Result\":false,\"ErrCode\":\"1\",\"ErrMsg\":\"错误信息\"}4.9单码流向查询接口接口说明:用于返回单码流向信息,包括产品的基础信息及产品的发货流向信息;请求方式:Get接口地址:http://系统地址/TTS/WebAPIs/CodeService.svc/CodeTrace接口说明:调用示例{\"Token\":\"\"\"CodeId\":\"\"}参数说明参数是否必须说明CodeId是查询的码返回说明正常情况下,TTS会返回下述JSON数据包:{\"ErrCode\":\"0\",\"ErrMsg\":null,\"Result\":true,\"CodeTrace\":{ProduceBatchNo:\"\",//批次号ProductCode:\"\",//产品编码ProductName:\"\",//产品名称ProductUnit:\"\",//产品单位ProductSpec:\"\",//制剂规格BatchProduceDate:\"\"//批次生产日期ProduceDate:\"\"//码采集生产时间ProductExpireDate:\"\"//过期日期)文档编号:XQDY201710_002页码:63of130公司:北京爱创科技股份有限公司版本:Rev2.0标题:光明乳业追溯服务平台详细设计ProduceCorpCode:\"\"//生产企业编码ProduceCorpName:\"\"//生产企业名称ProduceLicense:\"\"//批准文号CodeLevel:\"\"//码级别TraceInfo:[{StoreTypeKey:\"\",//入出库类型标识,见下面的对照信息StoreTypeText:\"\"//入出库类型描述,见下面的对照信息RegionName:\"\"//开单区域名称,CorpCode:\"开单企业编码\",CorpName:\"开单企业名称\",BizCorpCode:\"往来企业编码\",BizCorpName:\"往来企业名称\",StoreNo:\"单据号\",StoreDate:\"开单日期\"//}]}}StoreTypeKeyStoreTypeTextProduceIn生产入库PurchaseIn采购入库ReturnOut退货出库SaleOut销售出库ReturnIn退货入库SaleOutX零售出库ReturnInX零售退货AllocateIn调拨入库AllocateOut调拨出库CheckIn盘点盈余CheckOut盘点亏损DestroyOut销毁出库TestingOut抽检出库MissingOut报失出库OtherOut其它出库错误时TTS会返回错误码等信息,JSON数据包示例如下{\"Result\":false,\"ErrCode\":\"1\",\"ErrMsg\":\"错误信息\"}三、PDM5.1软件详细设计说明书1引言1.1编写目的)文档编号:XQDY201710_002页码:64of130公司:北京爱创科技股份有限公司版本:Rev2.0标题:光明乳业追溯服务平台详细设计本文档的目的旨在推动软件工程的规范化,使设计人员遵循统一的详细设计书写规范,节省制作文档的时间,降低系统实现的风险,做到系统设计资料的规范性和全面性,以利于系统的实现,测试,维护和版本升级等此阶段将在概要设计的基础上,进行系统的具体详细设计。在详细设计中,描述实现具体模块所涉及到的主要算法,数据结构,类的层次结构及调用关系,需要说明软件系统各个层次中的每个程序(每个模块或子程序)的设计考虑,以便进行编码和测试。因此《详细设计说明书》要达到如下一些目标:设计应该足够的详细,达到可以编写程序的水平重点模块的执行流程和数据库系统详细设计的描述项目组成员对代码结构,命名规范性的共识编码实现的基础1.2范围本文档用于软件设计阶段的详细设计,他的依据是概要设计说明书,他为下一阶段源程序及测试服务,是其实现的指导依据。本文将在如下几个方面加以论述:各子系统的公用模块的实现设计,专用模块的实现设计,数据库实现设计,外部接口的实现设计以及角色授权的设计等。按照三层结构的布局,详细设计应该从如下三个方面进行:数据访问层设计:数据字典物理设计,基本表物理设计,中间表物理设计(报表设计)业务逻辑设计:接口数据设计,中间件设计,数据通信传输设计,角色授权设计和功能设计;UI设计:基础信息管理,托盘码管理,接口管理,单据管理,队列管理,系统管理。1.3参考资料产品数据管理平台V5.0数据采集器接口标准V3.0)文档编号:XQDY201710_002页码:65of130公司:北京爱创科技股份有限公司版本:Rev2.0标题:光明乳业追溯服务平台详细设计爱创PDM概要设计_v1.0命名规范1.4术语定义及说明序号术语名称术语定义1出入库计划单货物还未进行出库,只是描述理论上,计划上将要出库的数量,通常该单据由第三方系统通过接口产生。2出入库单实际的出入库业务产生的单据,通常由手持进行扫描出库。3基础库(主数据库)存储基础信息,任务信息,单据信息,用户信息的数据库,一般数据量相对较少4出入库码库存放单据中被扫描的码5码库(生产码库)存储电子监管码及之间关系的数据库6电子监管码印在包装上的一维或二维码,7托盘、周转箱用于存放大箱的容器,一般设置该值是便于运输和快捷出库,通常托盘上有一个码叫托盘码。)文档编号:XQDY201710_002页码:66of130公司:北京爱创科技股份有限公司版本:Rev2.0标题:光明乳业追溯服务平台详细设计2设计总体架构3功能模块实现设计3.1基础类设计)文档编号:XQDY201710_002页码:67of130公司:北京爱创科技股份有限公司版本:Rev2.0标题:光明乳业追溯服务平台详细设计3.1.1BasePage3.1.1.1类设计类名称BasePage类功能页面基类,用于管理各页面的共同属性和方法的类属性protectedIUserServiceUsersLogic属性功能对用户进行管理的业务类属性protectedIOrganizeServiceOrganizeLogic属性功能对用户所属组织机构进行管理的业务类属性publicIWareHouseOrderLogicWareHouseOrderLogic属性功能对单据进行管理的业务类属性publicIBetweenCompanyLogicBetweenCompanyLogic属性功能对往来单位进行管理的业务类属性publicstringLastUrl属性功能客户端上次请求的页面属性protectedstringLoginUserName属性功能当前的登陆名方法1:名称publicstaticvoid_ShowMessage(stringmsg)功能消息框提示输入消息内容输出3.2公用模块实现设计3.2.1系统登录模块编号8模块名称系统登录所属业务系统登录编写人PDM产品部完成时间2013年3.2.1.1功能流程图)文档编号:XQDY201710_002页码:68of130公司:北京爱创科技股份有限公司版本:Rev2.0标题:光明乳业追溯服务平台详细设计3.2.1.2功能描述功能类型查询验证功能描述提高系统的安全性前提业务无后继业务所有业务功能约束权限约束约束描述3.2.1.3界面设计界面设计这里不再具体阐述,具体参见《爱创PDM5.1概要设计》“用户界面设计”章节。2)基础信息处理动作编号动作名称动作描述8.0.1登录点击登录按钮提交数据到登录处理页面“login.Aspx”,数据验证成功后将转至管理页面。8.0.2重置将当前信息回复原先状态3)数据要求字段名称长度录入方式是否非空项数据检验默认显示用户名60文本框YN空密码20PassowordYN空3.2.1.4类设计)文档编号:XQDY201710_002页码:69of130公司:北京爱创科技股份有限公司版本:Rev2.0标题:光明乳业追溯服务平台详细设计类名称LoginUser类功能用户登录处理,验证逻辑管理类方法1:名称CheckUserResultCheckUser(stringloginName,stringpassword,outstringresult);功能验证用户名密码的正确性输入用户名和密码输出验证结果方法2:名称ReturnMessageCheckPwdComplexity(stringpassword,intuserId);功能高级密码验证(复杂度,密码长度,有效期等)输入明文密码和用户Id输出验证结果方法3:名称boolGetConfigForPwdAdvanced();功能是否使用高级密码验证登录输入输出是否使用高级密码验证类名称IUserService类功能完成对数据库的增删改查操作方法1:名称UserGetUserByLoginName(stringloginName);功能通过登录名获得登录人信息输入用户名输出用户信息类名称IPasswordHisLogic类功能管理用户历史密码信息的类方法2:名称IListGetPasswordHis(Useruser);功能获得历史密码输入用户实例输出历史密码)文档编号:XQDY201710_002页码:70of130公司:北京爱创科技股份有限公司版本:Rev2.0标题:光明乳业追溯服务平台详细设计3.2.1.5关键逻辑与算法说明3.2.1.6数据库设计具体参见数据库设计“系统登录相关表关系”,具体各表定义参见数据库设计“数据库逻辑设计”:用户表(user),系统配置表(SysConfig),密码错误表(PasswordError),用户历史密码表(PasswordHis)3.2.2产品管理模块编号1.1模块名称产品管理所属业务基础信息维护编写人PDM产品部完成时间2013年3.2.2.1功能流程图3.2.2.2功能描述功能类型管理模块功能描述将药监平台下载的药品信息导入到系统进行维护,同时也支持手工增加药品信息前提业务8(系统登录),1.4(产品档案管理),1.5(生产工厂管理)后继业务3(出入库管理),9(队列管理),7.1(产品对照)功能约束权限约束,版本约束约束描述前提业务:1.4,1.5集团版功能后继业务:6.7,6.9集团版功能;7.1需要接口服务业务模块3.2.2.3界面设计界面设计这里不再具体阐述,具体参见《爱创PDM5.1概要设计》“用户界面设计”章节。1)基础信息处理)文档编号:XQDY201710_002页码:71of130公司:北京爱创科技股份有限公司版本:Rev2.0标题:光明乳业追溯服务平台详细设计动作编号动作名称动作描述1.1.1查询可以根据产品编码,产品名称,子类编码,批文号和产品档案查询产品1.1.2导入产品将药监平台下载的药品信息导入到系统进行维护1.1.3增加产品增加产品按钮,填写产品信息,点击保存1.1.4修改点击列表中的某条产品记录可以修改该产品的产品数据1.1.5删除点击列表中的某条产品记录可以删除该产品的产品数据2)数据要求字段名称长度录入方式是否非空项数据检验默认显示产品编码60输入否产品名称60输入否子类编码60输入否批文号60输入否包装单位60输入否产品档案60选择是00000001,默认产品档案制剂60输入是制剂规格60输入是有效期int输入是是有效期单位Int选择否日产品类别Int下列框否未定义产品明细类型Int下列框是未定义编码长度int输入是取码方式int下列框否空)文档编号:XQDY201710_002页码:72of130公司:北京爱创科技股份有限公司版本:Rev2.0标题:光明乳业追溯服务平台详细设计创建人Int只读否登录人创建日期datetime只读否当前年月日3.2.2.4类设计类名称ProductManagement类功能管理产品UI的后台类属性IProductService属性功能管理产品的类,完成对数据库的增删改查操作方法1:名称ListQueryProducts(ProductConditioncondition);功能通过条件实例得到产品集输入产品编码,产品名称,产品子类编码,产品登记证号,产品档案,页号,页大小输出产品集合方法2名称voidDeleteProduct(Productt);功能删除产品输入产品实例输出无属性IProductDocService属性功能管理产品档案的类,完成对数据库的增删改查操作方法1名称ListGetAllProductDocs(boolorderByDescending=false);功能获得所有产品档案数据输入数据排序方式输出产品档案集属性IPackageSpecificService属性功能管理产品档案的类,完成对数据库的增删改查操作方法1名称IListGetAllPackageSpecifics();功能获得所有产品包装规格数据)文档编号:XQDY201710_002页码:73of130公司:北京爱创科技股份有限公司版本:Rev2.0标题:光明乳业追溯服务平台详细设计输入输出产品包装规格集3.2.2.5关键逻辑与算法说明3.2.2.6数据库设计具体参见数据库设计“产品管理相关表关系”,具体各表定义参见数据库设计“数据库逻辑设计”:产品表(Product),产品档案表(ProductDoc),包装规格表(PackageSpecific),资源码表(ResourceCode))文档编号:XQDY201710_002页码:74of130公司:北京爱创科技股份有限公司版本:Rev2.0标题:光明乳业追溯服务平台详细设计3.2.3往来单位管理模块编号1.2模块名称往来单位管理所属业务基础信息维护编写人PDM产品部完成时间2013年3.2.3.1功能流程图3.2.3.2功能描述功能类型管理模块功能描述将药监平台下载的往来单位信息导入到系统进行维护,同时也支持手工增加往来单位信息。前提业务8(系统登录)后继业务3(出入库管理),9.2(上传单据管理),7.2(往来单位对照)功能约束权限约束,版本约束约束描述前提业务:后继业务:7.2需要接口服务业务模块3.2.3.3界面设计界面设计这里不再具体阐述,具体参见《爱创PDM5.1概要设计》“用户界面设计”章节。1)基础信息处理动作编号动作名称动作描述1.2.1查询可以通过往来单位名称,往来单位编码进行模糊查询1.2.2新建点击新建往来单位按钮,填写单位名称、编号等信息,点击保存1.2.3导入点击导入往来单位按钮,选择从国家药监平台下载的往来单位,点击保存)文档编号:XQDY201710_002页码:75of130公司:北京爱创科技股份有限公司版本:Rev2.0标题:光明乳业追溯服务平台详细设计1.2.4查看只能浏览该往来单位的详细信息,不能修改1.2.5修改可以编辑往来单位的信息,除编号外其他地方都是可以编辑的1.2.6删除可以删除该数据2)数据要求字段名称长度录入方式是否非空项数据检验默认显示往来单位名称60输入否字母数据汉字往来单位编码30输入否字母数据单位类型Int选择否生产企业邮编10输入是移动电话20输入是联系人10输入是电话号码20输入是传真号码20输入是省份20选择否地市20选择否区县20选择否地址60输入是备注100输入是3.2.3.4类设计类名称CompanyList类功能管理往来单位UI的后台类属性IBetweenCompanyLogic属性功能管理往来单位的类,完成对数据库的增删改查操作方法1:名称IListQuaryBetweenCompany(BetweenCompanyCondition)文档编号:XQDY201710_002页码:76of130公司:北京爱创科技股份有限公司版本:Rev2.0标题:光明乳业追溯服务平台详细设计condition)功能获取往来单位列表输入单位名称,企业自定义编号输出往来单位列表方法2:名称boolImportCompany(Streamstream,refstringmsg)功能导入往来单位输入文件流输出导入是否成功,导入错误消息方法3:名称BetweenCompanyResultAddCompany(BetweenCompanycompany)功能添加往来单位输入单位名称,企业类型,邮编,移动电话,联系人,电话号码,传真号码,省份,地市,区县,地址,自定义编号,备注,药监企业输出添加是否成功,添加错误消息方法4:名称BetweenCompanyResultDeleteCompany(BetweenCompanycompany)功能删除往来单位输入往来单位ID输出删除是否成功,删除错误消息方法5:名称BetweenCompanyResultUpdateCompany(BetweenCompanycompany)功能更新往来单位输入单位名称,企业类型,邮编,移动电话,联系人,电话号码,传真号码,省份,地市,区县,地址,自定义编号,备注,药监企业输出更新是否成功,更新错误消息3.2.3.5关键逻辑与算法说明3.2.3.6数据库设计)文档编号:XQDY201710_002页码:77of130公司:北京爱创科技股份有限公司版本:Rev2.0标题:光明乳业追溯服务平台详细设计具体参见数据库设计,具体各表定义参见数据库设计“数据库逻辑设计”:往来单位表(DMSBTCompany)3.2.4企业法人管理模块编号1.6模块名称企业法人管理所属业务基础信息维护编写人PDM产品部完成时间2014年3.2.4.1功能流程图3.2.4.2功能描述功能类型管理模块功能描述维护企业法人基础信息,以更好地实现集团企业内部多企业法人的业务管理。前提业务8(系统登录)后继业务3.3(出入库管理)(XML生成规则管理)功能约束权限约束,版本约束约束描述前提业务:系统登录后才能维护企业法人后继业务:企业法人添加好后才能使用该法人做出入库管理和XML生成规则管理3.2.4.3界面设计界面设计这里不再具体阐述,具体参见《爱创PDM5.1概要设计》“用户界面设计”章节。1)基础信息处理动作编号动作名称动作描述1.6.1查询可通过企业法人编码,企业法人名称进行模糊查询1.6.2新增点击新增按钮,填写企业法人编码、企业法人名称等信息,点击保存1.6.3修改可编辑企业法人信息1.6.4删除可删除企业法人)文档编号:XQDY201710_002页码:78of130公司:北京爱创科技股份有限公司版本:Rev2.0标题:光明乳业追溯服务平台详细设计2)数据要求字段名称长度录入方式是否非空项数据检验默认显示企业法人编码100输入是字母数字汉字企业法人名称100输入是字母数字汉字备注200输入否3.2.4.4类设计类名称LegalEntityManagement类功能管理企业法人的后台类属性IDMSLegalEntityLogic属性功能管理企业法人的类,完成对数据库的增删改查操作方法1:名称IListQueryDMSLegalEntity(DMSLegalEntityConditioncondition)功能获取企业法人列表输入企业法人编码,企业法人名称输出企业法人列表方法2:名称boolIsExist(stringlegalEntityCode)功能判断企业法人编码是否已存在输入企业法人编码输出企业法人实体方法3:名称voidDelete(DMSLegalEntitylegalEntity);功能删除企业法人输入企业法人实体输出无方法4:名称voidInsert(DMSLegalEntitylegalEntity);功能添加企业法人输入企业法人实体:企业法人编码,企业法人名称,备注输出无方法5:名称voidUpdate(DMSLegalEntitylegalEntity);)文档编号:XQDY201710_002页码:79of130公司:北京爱创科技股份有限公司版本:Rev2.0标题:光明乳业追溯服务平台详细设计功能编辑企业法人输入企业法人实体:企业法人编码,企业法人名称,备注输出无3.2.4.5关键逻辑与算法说明3.2.4.6数据库设计具体参见数据库设计“企业法人管理相关表关系”,具体各表定义参见数据库设计“数据库逻辑设计”:产品档案表(DMSLegalEntity)3.2.5托盘码管理模块编号2.1模块名称托盘码管理所属业务托盘管理维护编写人PDM产品部完成时间2013年3.2.5.1功能流程图3.2.5.2功能描述功能类型管理模块功能描述维护托盘码信息,对装载大箱的托盘实施码管理,以便使用手持整托快捷出入库。前提业务8(系统登录)1.3(码规则管理)后继业务2.2(托盘关联关系)功能约束权限约束约束描述前提业务:系统登录后才能维护托盘码后继业务:托盘码维护好后才能维护托盘和大箱关联关系,之后才能使用托盘码扫描出入库。3.2.5.3界面设计界面设计这里不再具体阐述,具体参见《爱创PDM5.1概要设计》“用户界面设计”章节。1)基础信息处理动作编号动作名称动作描述2.1.1查询可通过托盘码,码状态进行模糊查询)文档编号:XQDY201710_002页码:80of130公司:北京爱创科技股份有限公司版本:Rev2.0标题:光明乳业追溯服务平台详细设计2.1.2增加托盘码点击新增按钮,选择码规则,填写生成数量,点击保存2.1.3废弃托盘码勾选托盘码,点击废弃2.1.4导出选中托盘码勾选托盘码,点击导出选中2.1.5导出全部托盘码点击导出全部,可导出全部托盘码2.1.6二维码点击二维码链接,可生成托盘码的二维码,还可下载或保存二维码图片2.1.7修改点击修改链接,可维护托盘码相关信息2)数据要求字段名称长度录入方式是否非空项数据检验默认显示企业法人编码100输入是字母数字汉字企业法人名称100输入是字母数字汉字备注200输入否3.2.5.4类设计类名称PalletList类功能托盘码管理的后台类方法1:名称protectedvoidbtnSearch_Click(objectsender,EventArgse)功能按照条件查询托盘数据输入托盘号,状态,页数,页大小输出托盘列表属性IStockPackCodeLogicEx属性功能管理托盘码的类,完成对数据库的删改查操作方法1:名称IListQuaryStockJoinEx(condition);功能执行具体的查询输入查询条件实例输出StockPackCodeEx列表)文档编号:XQDY201710_002页码:81of130公司:北京爱创科技股份有限公司版本:Rev2.0标题:光明乳业追溯服务平台详细设计方法2名称protectedvoidbtnDelete_Click(objectsender,EventArgse)功能逻辑删除托盘码输入输出删除成功与否的消息框方法3名称TGetObjectById(objectkey);功能获得托盘码数据输入托盘码输出托盘码整个记录方法3名称voidUpdate(Tt);功能更新托盘码数据输入托盘码记录输出3.2.5.5数据库设计具体参见数据库设计“托盘管理相关表关系”,具体各表定义参见数据库设计“数据库逻辑设计”:托盘表(StockPackCode),托盘关系关系(StockPackRelation)监管码表(PackCodeInfo),任务表(Task)3.2.6托盘关联关系管理模块编号2.2模块名称托盘码管理所属业务托盘管理维护编写人PDM产品部完成时间2013年3.2.6.1功能流程图下图描述了包装关系导入数据库的过程,从获取到包装关系文件,到包装关系导入数据库,其中托盘码,周转箱码被保存到托盘关系表中,大箱码,瓶码,中包,小盒码保存到码库中。)文档编号:XQDY201710_002页码:82of130公司:北京爱创科技股份有限公司版本:Rev2.0标题:光明乳业追溯服务平台详细设计3.2.6.2功能描述功能类型管理模块)文档编号:XQDY201710_002页码:83of130公司:北京爱创科技股份有限公司版本:Rev2.0标题:光明乳业追溯服务平台详细设计功能描述维护托盘码与大箱码的关系。前提业务8(系统登录)2.2(托盘码管理)后继业务3.3出入库单建立功能约束权限约束约束描述前提业务:系统登录后才能维护托盘码与大箱码关系后继业务:托盘码维护好后才能维护托盘和大箱关联关系,之后才能使用托盘码扫描出入库。3.2.6.3界面设计界面设计这里不再具体阐述,具体参见《爱创PDM5.1概要设计》“用户界面设计”章节。3)基础信息处理动作编号动作名称动作描述2.1.1查询可通过托盘码,码状态进行模糊查询2.1.2导入托盘关系勾选托盘码,点击导出选中2.1.3导出托盘关系点击导出全部,可导出全部托盘码2.1.4关联关系可以查看托盘下有哪些大箱或周转箱2.1.5手动添加吗可以在页面给该托盘添加大箱码2.1.6移除关联关系将托盘或周转箱上某个码移除掉4)数据要求字段名称长度录入方式是否非空项数据检验默认显示托盘码、周转箱码60输入否字母数字汉字大箱码、瓶码60输入否字母数字汉字)文档编号:XQDY201710_002页码:84of130公司:北京爱创科技股份有限公司版本:Rev2.0标题:光明乳业追溯服务平台详细设计任务Int选择否备注100输入是3.2.6.4类设计类名称PalletList类功能托盘码管理的后台类方法1:名称protectedvoidbtnSearch_Click(objectsender,EventArgse)功能按照条件查询托盘关联数据输入托盘号,监管码,备注,页数,页大小输出托盘关系列表方法2:名称protectedvoidbtnexport_Click(objectsender,EventArgse)功能导出托盘关联关系输入选中的记录输出文件属性IStockPackCodeLogicEx属性功能管理托盘码与大箱码的类,完成对数据库的删改查操作方法1:名称DataTableGetPackCodeInfo(stringstockCode);功能获取托盘上的大箱码输入托盘码输出含有大箱码的DataTable方法2名称IListQuaryStockJoinEx(StockPackCodeConditioncondition,boolincludeVirtual,stringRemark);功能根据查询条件查询托盘关联数据输入托盘号,监管码,备注,页数,页大小,是否包含虚拟码输出托盘关系列表3.2.6.5数据库设计)文档编号:XQDY201710_002页码:85of130公司:北京爱创科技股份有限公司版本:Rev2.0标题:光明乳业追溯服务平台详细设计具体参见数据库设计“托盘管理相关表关系”,具体各表定义参见数据库设计“数据库逻辑设计”:托盘表(StockPackCode),托盘关系关系(StockPackRelation)监管码表(PackCodeInfo),任务表(Task)3.2.7建立单据模块编号3.3模块名称出入库管理所属业务库存管理编写人PDM产品部完成时间2013年3.2.7.1功能流程图单据建立时序图)文档编号:XQDY201710_002页码:86of130公司:北京爱创科技股份有限公司版本:Rev2.0标题:光明乳业追溯服务平台详细设计)文档编号:XQDY201710_002页码:87of130公司:北京爱创科技股份有限公司版本:Rev2.0标题:光明乳业追溯服务平台详细设计注意:从上面的描述不难看出:当验证监管码时需要访问生产码库,此时会使用分库,分区的技术获取监管码,其他情况都是在对基础库,出入库码库进行操作。生产码库查询码处理流程图3.2.7.2功能描述功能类型管理模块)文档编号:XQDY201710_002页码:88of130公司:北京爱创科技股份有限公司版本:Rev2.0标题:光明乳业追溯服务平台详细设计功能描述维护托盘码信息,对装载大箱的托盘实施码管理,以便使用手持整托快捷出入库。前提业务8(系统登录)1(基础信息管理)2.2(托盘关联关系)9.1(关联关系队列)后继业务9.2(单据上传队列管理)功能约束权限约束约束描述前提业务:系统登录后并维护基础信息,以及导入关联关系后才可以进行出入库后继业务:出入库完成后将单据上传TTS。3.2.7.3界面设计界面设计这里不再具体阐述,具体参见《爱创PDM5.1概要设计》“用户界面设计”章节。5)基础信息处理动作编号动作名称动作描述2.1.1查询可通过单据号,批次号,产品,监管码,日期,状态等查询单据信息2.1.2新建入库单点击新建按钮完成单据的建立,点击保存2.1.3新建出库单点击新建按钮完成单据的建立,点击保存2.1.4上传单据勾选要上传的单据,上传TTS6)数据要求字段名称长度录入方式是否非空项数据检验默认显示企业法人编码100输入是字母数字汉字出入库单号100输入否字母数字汉字单据类型Int选择否状态Int选择否往来单位50输入是)文档编号:XQDY201710_002页码:89of130公司:北京爱创科技股份有限公司版本:Rev2.0标题:光明乳业追溯服务平台详细设计出入库日期Datetime选中否操作员10输入否产品名称30输入否批次号50输入是3.2.7.4类设计类名称CtrlWOrderList类功能单据管理的后台类方法1:名称protectedvoidlbtnUpload_Command(objectsender,CommandEventArgse)功能上传单个单据到TTS输入单据号,批次号,产品,监管码,日期,状态等查询单据信息,页数,页大小输出成功与否方法2:名称protectedvoidbtnBatchExport_Click(objectsender,EventArgse)功能按照条件查询单据后批量上传单据到TTS输入单据号,批次号,产品,监管码,日期,状态等查询单据信息,页数,页大小输出成功与否方法3名称protectedvoidbtnDelete_Click(objectsender,EventArgse)功能逻辑删除单据输入输出删除成功与否的消息框方法4名称publicvoidBindGridView()功能绑定单据信息到页面输入输出单据列表属性IWHOrderUploadLogic属性功能将选中上传的单据插入到上传单据队列,由队列执)文档编号:XQDY201710_002页码:90of130公司:北京爱创科技股份有限公司版本:Rev2.0标题:光明乳业追溯服务平台详细设计行上传方法1名称voidUploadWareHouse(intoperatorID,stringoperatorName,ListwarehouseID);功能将选中上传的单据插入到上传单据队列输入上传单据的ID,操作人输出属性IWareHouseOrderLogic属性功能对单据进行增删改查的操作方法1名称intDeleteWareHouseOrder(intorderID,refstringmsg);功能删除该单据输入上传单据的ID输出成功与否方法2名称DataTableQueryOrderWareHouseOrderTable(WareHouseOrderConditioncondition);功能根据条件查询单据输入WareHouseOrderCondition实例输出单据DataTable方法3名称WareHouseOrderResultCreateWareHouseOrder(WareHouseOrderorder);功能建立单据输入单据实例输出成功与否3.2.7.5数据库设计具体参见数据库设计“单据相关表关系”,具体各表定义参见数据库设计“数据库逻辑设计”:单据表(DMSWOrder),单据明细表(DMSWOrderItem)监管码表(PackCodeInfo),出入库码表(DMSWOrderCode),产品表(product),往来单位表(DMSBetweenCompany),)文档编号:XQDY201710_002页码:91of130公司:北京爱创科技股份有限公司版本:Rev2.0标题:光明乳业追溯服务平台详细设计3.2.8出入库计划管理模块编号3.4模块名称出入计划管理所属业务库存管理编写人PDM产品部完成时间2013年3.2.8.1出入库计划业务流程图)文档编号:XQDY201710_002页码:92of130公司:北京爱创科技股份有限公司版本:Rev2.0标题:光明乳业追溯服务平台详细设计3.2.8.2出入库计划状态机该状态机详细描述了计划单的各状态之间的变化及界面各按钮的可操作性,其中对号表示可以进行该操作。)文档编号:XQDY201710_002页码:93of130公司:北京爱创科技股份有限公司版本:Rev2.0标题:光明乳业追溯服务平台详细设计)文档编号:XQDY201710_002页码:94of130公司:北京爱创科技股份有限公司版本:Rev2.0标题:光明乳业追溯服务平台详细设计3.2.8.3功能描述功能类型管理模块功能描述对所有的出入库计划进行管理,包括创建、查看、下载等功能。一般是与第三方系统作接口(如Erp),自动将第三方系统单据同步过来。前提业务8(系统登录)1(基础信息管理),9接口管理后继业务3.3(单据管理)功能约束权限约束约束描述前提业务:系统登录后维护基础信息后才能建立计划单后继业务:执行实际出库时会和计划单校验,是否为计划要出库的产品。3.2.8.4界面设计界面设计这里不再具体阐述,具体参见《爱创PDM5.1概要设计》“用户界面设计”章节。7)基础信息处理动作编号动作名称动作描述2.1.1查询可通过单据号,批次号,产品,监管码,日期,状态等查询计划单据信息2.1.2新建入库计划单点击新建按钮完成单据的建立,点击保存2.1.3新建出库计划单点击新建按钮完成单据的建立,点击保存2.1.4修改修改单据信息2.1.1删除删除计划单2.1.6明细查看计划单明细2.1.7状态回滚使单据状态回到上一个状态8)数据要求)文档编号:XQDY201710_002页码:95of130公司:北京爱创科技股份有限公司版本:Rev2.0标题:光明乳业追溯服务平台详细设计字段名称长度录入方式是否非空项数据检验默认显示企业法人编码100输入是字母数字汉字出入库计划单号100输入否字母数字汉字单据类型Int选择否状态Int选择否创建日期Datetime选中否Erp产品编码30输入否产品名称30输入否企业法人编码100输入是字母数字汉字3.2.8.5类设计类名称WareHouseOrderList类功能计划单管理的后台类方法1:名称protectedvoidbtnSearch_Click(objectsender,EventArgse)功能按照条件查询计划单数据输入计划单号,产品,批次,状态,页数,页大小输出计划单列表属性IWareHouseActionLogic属性功能计划单管理的类,完成对数据库的删改查操作方法1:名称IListQueryWareHouseAction(WareHouseActionConditioncondition);功能执行具体的查询输入查询条件实例输出WareHouseAction列表方法2名称protectedvoidbtnDelete_Click(objectsender,EventArgse)功能删除计划单输入输出删除成功与否的消息框)文档编号:XQDY201710_002页码:96of130公司:北京爱创科技股份有限公司版本:Rev2.0标题:光明乳业追溯服务平台详细设计方法3名称TGetObjectById(objectkey);功能获得计划单数据输入计划单ID输出计划单整个记录方法4名称voidUpdate(Tt);功能更新计划单数据输入计划单记录输出3.2.8.6数据库设计具体参见数据库设计“计划单管理相关表关系”,具体各表定义参见数据库设计“数据库逻辑设计”:单据表(DMSWOrder),单据明细表(DMSWOrderItem)监管码表(PackCodeInfo),出入库码表(DMSWOrderCode),产品表(product),往来单位表(DMSBetweenCompany),计划单(DMSWOrderPlan),计划单明细(DMSWOrderPlanItem)3.2.9货运统计报表3.2.9.1功能描述功能类型管理模块功能描述该功能可以生成发货单,用于物流,物流人员可以通过此功能生成纸质单据。前提业务8(系统登录)3.3(单据管理)后继业务功能约束权限约束约束描述前提业务:系统登录后并维护基础信息,已经进行过出入库3.2.9.2界面设计界面设计这里不再具体阐述,具体参见《爱创PDM5.1概要设计》“用户界面设计”章节。)文档编号:XQDY201710_002页码:97of130公司:北京爱创科技股份有限公司版本:Rev2.0标题:光明乳业追溯服务平台详细设计9)基础信息处理动作编号动作名称动作描述2.1.1查询可通过单据号,批次号,产品名称,包装规格,往来单位查询统计单据信息2.1.2清除清除查询条件2.1.3导出导出Excel格式的信息10)数据要求字段名称长度录入方式是否非空项数据检验默认显示出入库单号100输入否字母数字汉字往来单位100输入否产品名称30输入否批次号50输入是包装规格20输入是3.2.9.3类设计类名称WareHouseFreightView类功能货运统计管理的后台类方法1:名称protectedvoidbtnSearch_Click(objectsender,EventArgse)功能通过条件查询货运统计结果输入单据号,批次号,产品,包装规格,往来单位输出统计结果,包括往来单位,产品,数据等输出单据列表3.2.9.4数据库设计具体参见数据库设计“单据相关表关系”)文档编号:XQDY201710_002页码:98of130公司:北京爱创科技股份有限公司版本:Rev2.0标题:光明乳业追溯服务平台详细设计3.2.10用户角色组织机构管理流程图3.2.10.1流程图)文档编号:XQDY201710_002页码:99of130公司:北京爱创科技股份有限公司版本:Rev2.0标题:光明乳业追溯服务平台详细设计3.2.11接口服务模块编号11.4模块名称接口服务所属业务接口编写人PDM产品部完成时间2015年3.2.11.1功能流程图见概要设计3.2.11.2功能描述功能类型接口模块功能描述该模块用于实现与ERP的业务往来处理。包括出入库计划单建立前提业务8(系统登录),基础信息维护,系统设置后继业务计划单管理功能约束权限约束,定制功能约束描述前提业务:需要配置接口需要的基础数据(包括产品,任务,包装关系,法人后继业务:计划单管理3.2.11.3界面设计界面设计这里不在具体阐述,具体参见《爱创PDM5.1概要设计》“用户界面设计”章节。3.3数据表关系设计3.3.1.系统登陆相关表关系)文档编号:XQDY201710_002页码:100of130公司:北京爱创科技股份有限公司版本:Rev2.0标题:光明乳业追溯服务平台详细设计)文档编号:XQDY201710_002页码:101of130公司:北京爱创科技股份有限公司版本:Rev2.0标题:光明乳业追溯服务平台详细设计3.3.2.产品管理相关表关系)文档编号:XQDY201710_002页码:102of130公司:北京爱创科技股份有限公司版本:Rev2.0标题:光明乳业追溯服务平台详细设计3.3.3.关联关系队列相关表关系3.3.4.托盘管理相关表关系)文档编号:XQDY201710_002页码:103of130公司:北京爱创科技股份有限公司版本:Rev2.0标题:光明乳业追溯服务平台详细设计3.3.5.单据相关表关系)文档编号:XQDY201710_002页码:104of130公司:北京爱创科技股份有限公司版本:Rev2.0标题:光明乳业追溯服务平台详细设计3.3.6.计划单管理相关表关系)文档编号:XQDY201710_002页码:105of130公司:北京爱创科技股份有限公司版本:Rev2.0标题:光明乳业追溯服务平台详细设计)文档编号:XQDY201710_002页码:106of130公司:北京爱创科技股份有限公司版本:Rev2.0标题:光明乳业追溯服务平台详细设计四、1.功能设计欢乐扫系统由手机WebApp、企业门户、运营门户组成。WebApp运行于支持html5的手机端,可由微信扫描打开,为手机用户提供扫描、登录、交互等功能;企业门户为企业用户提供入口,完成诸如商品信息维护、码下载等功能。运营门户提供企业资质审核及其他系统支持管理服务。)文档编号:XQDY201710_002页码:107of130公司:北京爱创科技股份有限公司版本:Rev2.0标题:光明乳业追溯服务平台详细设计1.1企业门户企业门户供企业用户登录、维护企业信息、商品信息、奖品信息、码信息和营销策略等。1.1.1注册数据结构信息项英文数据类型说明用户名userNameString(200)昵称nickNameString(200)密码passwordString(50)手机mobileNumNumber(20)创建时间createTimeDatetime最后登录时间lastLoginTimeDatetime状态statusInt待审核;正常;冻结企业用户信息(corpUsers)信息项数据类型说明企业名称nameString(200)地址addressString(200)联系人contactString(50)联系人邮件mailString(50)联系电话phoneNumNumber(20)是否使用独立域名ownSiteUsedBool企业用户IDcorpUserIdString(50)关联corpUser表的_id企业编码codeString(20)49进制编码。使用独立域名可省略。如果无独立域名,则此编码需包含在乐码中,由系统自动生成图片imageUrlstring(50)独立域名siteUrlString(50)企业自有域名。如果使用域名,乐码网址将形如http://domain/xxx?dfdfdf。即不使用欢乐扫域名作为入口是否与TTS部署withTTSboolTTS接口地址ttsUrlStringTTS的接口地址)文档编号:XQDY201710_002页码:108of130公司:北京爱创科技股份有限公司版本:Rev2.0标题:光明乳业追溯服务平台详细设计TTSIdttsIdStringTTS的授权IdTTSSecretttsSecretStringTTS授权码营业执照号码licenseNoString(50)营业执照片licenseImgUrlString(50)注册人身份证号idCardNumString(50)注册人手持身份证照片idCardImgUrlString(50)创建时间createTimeDatetime状态statusInt待审核;正常;冻结简介descString(500)企业信息信息项数据类型说明微信号wxNoString(50)名称nameString(50)原始idwxidString(50)AppIdappIdString(50)AppSecretappSecretString(50)企业用户IDcorpUserIdString(50)关联corpUser表的_id微信帐号1.1.2产品分类商品按照类别进行管理,类别是树状结构,支持多级分类。信息项数据类型说明名称String(50)编码String(20)WbS码String(20)层次结构码,形如001.002,以此形成树状结构所属企业IdString(50)创建时间Datetime产品列表产品品信息维护企业自有产品。)文档编号:XQDY201710_002页码:109of130公司:北京爱创科技股份有限公司版本:Rev2.0标题:光明乳业追溯服务平台详细设计信息项数据类型说明名称nameString(200)编码codeString(50)规格specString(50)图片地址imageUrlString(200)简介descString(500)所属类别categoryCodeString(20)使用类别的wbsCode创建时间createTimeDatetime状态statusInt上架、下架、冻结计量单位unitString(20)所属企业IdcorpIdString(50)1.1.3奖品奖品模块维护企业为营销设置的奖品、收集卡及由其组成的礼包。礼包也可包含积分。收集卡是指,由一系列卡片组成的集合,如十二生肖卡,消费者可收集一套此卡来兑换一个奖品。数据结构信息项数据类型说明名称nameString(200)编码codeString(50)数量numint单位unitString(20)是否关联产品isProductUsedbool关联产品IdproductIdString(50)图片地址imageUrlString(200)简介descString(500)物流类型deliverTypeint虚拟或实物(需配送)创建时间createTimeDatetime所属企业IdcorpIdString(50)奖品信息(prizes)信息项数据类型说明名称nameString(200))文档编号:XQDY201710_002页码:110of130公司:北京爱创科技股份有限公司版本:Rev2.0标题:光明乳业追溯服务平台详细设计编码codeString(50)图片地址imageUrlString(200)简介descString(500)物流类型deliverTypeint虚拟或实物(需配送)创建时间createTimeDatetime所属企业IdcorpIdString(50)明细prizes子文档礼包可包含奖品(prize),积分(point),卡片(card)和其它礼包[{type:prize,prizeId:xdf,num:30}{type:point,num:100}{type:card,cardId:id,num:3}{type:package,pkgId:id,num:3}}礼包信息(package)礼包-奖品明细信息项数据类型说明名称nameString(200)编码codeString(50)单位unitString(20)图片地址imageUrlString(200)简介descString(500)卡片cardsArray此集合包含的所有卡片id数组创建时间createTimeDatetime所属企业IdcorpIdString(50)收集卡(cardSets)信息项数据类型说明名称nameString(200)图片地址imageUrlString(200)简介descString(500))文档编号:XQDY201710_002页码:111of130公司:北京爱创科技股份有限公司版本:Rev2.0标题:光明乳业追溯服务平台详细设计所属卡片idsetIdString(50)卡片(card)1.1.4乐码条码(二维码)信息是系统核心,其它应用需要围绕码信息来完成。企业可以定制自己的码格式和外部链接。乐码使用的二维码是带网址格式,此网址可以欢乐扫的通用网址也可以是企业的自有网址。如果使用欢乐扫的通用网址,则乐码中需要含有3位的49进制企业编码。49进制码是指由如下数字和字母构成:对光明乳业而言,需生成内外码相互匹配。内码印刷于瓶盖内,带链接二维码格式,外码为数字码。外码内码相补。生成的码可以生成txt格式用于下载、印刷。数据结构信息项数据类型说明批号batchNoString(200)由系统自动生成,各位为时间201410140122(年月日时分)地区areaCodeString(50)国内行政区域代码。类别categoryCodeString(20)产品分类wbs编码,如使用单一产品,则为空产品productIdString(50)产品Id。如使用产品分类,则为空起始startNumint截至endNumint印刷厂IdprintingPressIdString(50)有无必要?创建时间createTimeDatetime所属企业IdcorpIdString(50)乐码批次(batchs)1.1.5活动企业可创建营销活动,设置奖品等优惠,促使消费者购买、扫码、参与互动和收集消费者信息。营销活动是欢乐扫的核心内容,你扫我扫都欢乐,企业与消费者皆大欢{\'0\',\'1\',\'2\',\'3\',\'4\',\'5\',\'6\',\'7\',\'8\',\'9\',\'a\',\'b\',\'c\',\'d\',\'e\',\'f\',\'g\',\'h\',\'j\',\'k\',\'m\',\'n\',\'p\',\'q\',\'r\',\'s\',\'t\',\'u\',\'v\',\'w\',\'x\',\'y\',\'z\',\'A\',\'B\',\'D\',\'E\',\'F\',\'G\',\'H\',\'K\',\'L\',\'M\',\'N\',\'Q\',\'R\',\'T\',\'U\',\'Y\'})文档编号:XQDY201710_002页码:112of130公司:北京爱创科技股份有限公司版本:Rev2.0标题:光明乳业追溯服务平台详细设计喜。活动的可变条件有:人、时、地、物、码,其含义是根据扫描用户、扫描时间、所在区域、所扫产品、所扫码的不同而不同。考虑实现的复杂性和对企业的实用性,目前活动根据时、地、物不同条件而触发,也即应用于某个时段、某个行政区域和某些产品。多个活动之间可能出现重叠,如在江苏和无锡区域同时创建活动,江苏省包含了无锡时。重叠活动将使用最小优先策略,也即时段最小、区域最小和产品品类最为明确的活动为消费者所参加活动。活动的中奖类型有:抽奖、累计、集卡、幸运数、先到先得和扫即得。抽奖:设置一个中奖概率,扫描时可随机抽奖,奖励有一等奖、二等奖等,奖完为止。累计:设置一个数量,当消费者扫描一定数量乐码后,则给予奖励。集卡收集一组卡片,集满有奖幸运数设置几个幸运数字,当消费者扫描的排位是这个数字时,给予奖励先到先得设置几个数字,如前100位给予奖励,前200位给予奖励扫即得只要扫描,即可获得奖励。中奖条件不同,但中奖类型不同的活动可互相重叠。如在无锡同时创建“抽奖”和“累计”两种类型的活动,则消费者扫描时,将会进行抽奖,同时这次扫描也将累计入扫描数量。数据结构信息项数据类型说明名称nameString(200)区域areaCodeString(50)国内行政区域代码。类别categoryCodeString(20)产品分类wbs编码,如使用单一产品,则为空产品productIdString(50)产品Id。如使用产品分类,则为空开始时间startTimeDateTime结束时间endTimeDateTime起始startNumint截至endNumint抽奖形式luckyTypeString(20)抽奖(draw),)文档编号:XQDY201710_002页码:113of130公司:北京爱创科技股份有限公司版本:Rev2.0标题:光明乳业追溯服务平台详细设计累计(count),集卡(collect),幸运数(number),先到先得(first),扫即得(come)抽奖设置settings子文档根据抽奖形式不同而不同。创建时间createTimeDatetime所属企业IdcorpIdString(50)活动(activities)信息项数据类型说明中奖概率probalititydouble小数,中奖概率优先级piorityString(20)从小到大(little)从大到小(big)随机(random)奖励rewardsArray奖励数组活动-抽奖信息项数据类型说明奖品类型typeString(20)奖品(prize),礼包(package),积分(point),卡片(card)奖励rewardObject这些字段与奖品类型对应奖品Id,数量,剩余数量礼包Id,数量,剩余数量积分数量卡片Id,数量,剩余数量活动-抽奖-奖励)文档编号:XQDY201710_002页码:114of130公司:北京爱创科技股份有限公司版本:Rev2.0标题:光明乳业追溯服务平台详细设计信息项数据类型说明数量amountint奖品类型typeString(20)同上奖励rewardObject同上活动-累积-奖励(数组,一个活动可有多个累积式奖品)信息项数据类型说明卡组idsetIdString(20)奖品类型typeString(20)同上奖励rewardString(50)同上活动-收集卡-奖励信息项数据类型说明幸运数numberint奖品类型typeString(20)同上奖励rewardObject同上活动-幸运数-奖励(可设置多个吉祥数)活动-先到先得-奖励(数组,可多个)活动-扫即得-奖励1.1.6礼品企业的消费者可以将获得的企业积分用于兑换企业提供的礼品上。消费者可以从多个企业获得积分,所谓企业积分就是特指某企业的积分。A企业的积分只能用于兑换A企业提供的礼品。信息项数据类型说明名称nameString(200)物流类型deliverTypeint虚拟或实物(需配送)信息项数据类型说明排位数numberint奖品类型typeString(20)同上奖励rewardObject同上信息项数据类型说明奖励rewardObject同上)文档编号:XQDY201710_002页码:115of130公司:北京爱创科技股份有限公司版本:Rev2.0标题:光明乳业追溯服务平台详细设计开始时间startTimeDateTime结束时间endTimeDateTime数量numint礼品的最大数量;如果没有上限,设置为-1剩余数量remainedNumint剩余数量所需积分pointsint兑换所需积分图片地址imageUrlString(200)描述descriptionString(500)创建时间createTimeDatetime所属企业IdcorpIdString(50)礼品(gifts)1.1.7订单消费者参加活动中得的奖品和积分兑换的礼品,可以进行领取。对需要物流配送的奖品、礼品,如果消费者领取,则需要提供收获地址,确认后,企业门户生成一个配送订单。订单状态有:未确认、已确认、已发货、已签收、已取消四个状态。订单生成默认状态为“未确认”,企业发货人员点击“确认”按钮,表示确认订单,但尚未发货,订单置为“已确认”状态。“已确认”的订单,点击“发货”按钮,表示订单的货物已经发送,订单置为“已发货”状态。“已发货”的订单,点击“签收”按钮,表示消费者已收到货物,订单置为“已签收”状态。“已签收”的订单,点击“退货”按钮,表示消费者发现货物质量问题,要求退货并重新发货,订单置为“已退货”状态。“已退货”的订单,可点击“发货”按钮,重新进入发货流程。所有订单的操作,都记录订单日志,并可查看。信息项数据类型说明订单号orderNoString(50)订单流水号用户iduserIdString(50)创建时间createTimeDatetime物品类型goodTypeString(50)订单的物品类型,’prize’,奖品;’gift’,礼品物品IdgoodIdString(50)如果为奖品,则为prizeId;如果是)文档编号:XQDY201710_002页码:116of130公司:北京爱创科技股份有限公司版本:Rev2.0标题:光明乳业追溯服务平台详细设计礼品,则为giftId收获地址IdaddressIdString(200)消费者填写的收获地址,都会加入到消费者的地址列表中,其下次就不必再次填写。收获地址Id即为所选地址订单状态statusString(50)已提交,‘committed’已确认,’submitted’已发货,’shipped’已签收,’received’已退货,’returned’备注memoString(500)操作人员可以记录简短备注,已便于自己处理订单订单(orders)信息项数据类型说明订单号orderNoString(50)订单流水号操作人员IdoperatorIdString(50)企业操作人员Id时间operateTimeDatetime描述descriptionString(500)订单日志(orders)用户中奖列表查看用户中奖情况。用户中奖列表查看用户中奖情况。用户列表查看用户信息。用户指使用智能手机端参加企业活动的用户。1.2手机端)文档编号:XQDY201710_002页码:117of130公司:北京爱创科技股份有限公司版本:Rev2.0标题:光明乳业追溯服务平台详细设计手机端实现扫码、中奖、奖品查看、奖品打包、奖品转移、个人信息等功能。因为手机端面向消费者,因此要求其界面简洁美观,操作简单。信息项数据类型说明用户iduserIdString(50)用户名userNameString(50)密码passwordString(50)昵称nickNameString(50)性别sexString(1)手机号mobileString(50)QQ号qqString(50)注册时间regTimeString(50)注册IPregIpString(50)登录时间loginTimeString(50)登录IPloginIpString(50)微信openidopenidString用户状态statusString(1)0未完善信息1正常2锁定密码混淆saltString(50)消费者用户(users)1.2.1扫码中奖消费者扫描二维码时,获得消费者扫描时间、区域和码内容。查询系统有无此码,查询是否扫描过。并根据这些条件查询相关活动。按照最小匹配原则,获得一个或多个消费者可以参与的活动,按照活动定义,确定消费者是否中奖。消费者可同时获得多个活动奖品。信息项数据类型说明用户iduserIdString(50)用户类型userTypeString消费者(consumer),企业(corpUser),门店(shopkeeper)扫描时间scanTimeString(50)IP地址ipString(50))文档编号:XQDY201710_002页码:118of130公司:北京爱创科技股份有限公司版本:Rev2.0标题:光明乳业追溯服务平台详细设计区域代码areaInfoString(20)码全内容fullcodeString(200)包含网址的二维码呢绒码内容codeString(20)仅码本身是否第一次isFirstbool对应产品信息productstring参与活动activitiesArray活动Id数组(如果有)奖励rewardsArray每个活动所得奖励(如果有)[activityId:reward]参加活动奖品类型进行定义扫码日志(scanLog)部分活动需记录用户活动完成状态,如累计和集卡。信息项数据类型说明用户iduserIdString(50)活动IdactivityIdString(50)活动类型activityTypeString(50)累计(count),集卡(collect)状态state子文档累计式活动记录已累积数量:{num:3}集卡式任务记录已收集卡片:{cardId1:0,cardId2:2}所有卡片数量都大于1时,可以兑奖我的活动状态(userActivityStates)1.2.2积分商城积分商城展示企业添加的礼品,这些礼品可以用此企业的积分兑换;兑换获得的礼品,可以进行领取我的奖励消费者中奖后,其中奖信息存储入数据库,包含如奖品、礼包等所有奖励。用户获得的奖励有实物、虚拟、积分3种,虚拟是指如QQ币、充值类等在线即可完成交易的物品;)文档编号:XQDY201710_002页码:119of130公司:北京爱创科技股份有限公司版本:Rev2.0标题:光明乳业追溯服务平台详细设计实物指需要进行物流配送的物理货物。奖励的领取方式有3种:在线交易、乐券转移与物流配送。在线领取。虚拟类的物品,调用第三方接口即可兑现消费者的奖励,如手机充值。乐券转移。乐券转移是指使用欢乐扫提供的二维码,前往门店、经销商等可以提供实物交易的场所,实现乐券与实物的交换。物流配送。物品由企业提供,且需要企业使用物流将货物发送到消费者手中。信息项数据类型说明所有人IdownerIdString(50)所有人类型ownerTypeString消费者(consumer),企业(corpUser),门店(shopkeeper)活动IdactivityIdString(50)获得时间getTimeDateTime奖品类型typeString(20)奖品(prize),积分(point),卡片(card)奖励rewardObject这些字段与奖品类型对应奖品Id积分卡片Id日志IdscanningIdString扫描日志的id乐券IdcouponIdString状态statusString(20)正常(normal),已打包(isBaged)我的奖励(userRewards)奖品、产品、礼包可打包为包裹,包裹本身也可再次打包。我的卡片收集成为一个卡组的卡片自动从列表中消失,此外无不同。我的包裹已打包的物品,不在参与业务逻辑。如十二生肖一张卡片被放入包裹,则除非其解开,否则不认为十二生肖集满。)文档编号:XQDY201710_002页码:120of130公司:北京爱创科技股份有限公司版本:Rev2.0标题:光明乳业追溯服务平台详细设计已打包的物品可与普通奖品一样,进行乐券扫描转移。信息项数据类型说明名称nameString所有人ownerIdString所有人类型ownerTypeString消费者(consumer),企业(corpUser),门店(shopkeeper)创建时间createTimeDateTime包裹内容rewardsArray子文档,包裹中对应的[{type:reward,urId:0x},{type:bag,bagId:033}]乐券IdcouponIdString状态statusString(20)正常(normal),打包(isBaged)我的包裹(userBags)我的礼品展示消费者通过积分兑换获得的礼品;礼品可以进行领取我的订单消费者可以查看已要求发货的订单,以及查看订单的状态。我的信息“我的信息”展示消费者的个人信息。乐券每个奖品、卡片、包裹都有一个乐券,此乐券可用于转移。乐券有3分钟有效期,过期后需重新打开。可打开奖品、包裹、卡片的乐券,其他人扫描后,此乐券即由现拥有人转移到扫描人。)文档编号:XQDY201710_002页码:121of130公司:北京爱创科技股份有限公司版本:Rev2.0标题:光明乳业追溯服务平台详细设计信息项数据类型说明奖品类型typeString(20)奖励(reward)包裹(bag)创建时间createTimeDateTime关联IdtargetObject如果为奖品、礼包和产品,则对应userRewards,userRewardId如果为包裹,则对应userBags中bagId{type:reward,urId:0xdd}乐券(coupons)信息项数据类型说明奖励idrewardIdString原用户fromUserIdString(50)新用户toUserIdString(50)转移时间transTimeDateTimeIP地址ipString(50)区域areaInfoString(20)转移日志(transLog)信息项数据类型说明乐券idcouponIdString用户IduserIdString用户类型ownerTypeString消费者(consumer),企业(corpUser),门店(shopkeeper)扫描时间scanTimeDateTimeIP地址ipString(50)区域areaInfoString(20)乐券扫描日志(couponLog))文档编号:XQDY201710_002页码:122of130公司:北京爱创科技股份有限公司版本:Rev2.0标题:光明乳业追溯服务平台详细设计1.2.3手机端-渠道用户渠道用户是指生产企业与消费者之间的经销商,在这里主要指终端门店(如餐馆、夜店等)。这些经销商负责给消费者兑换奖品,并向上游企业上报。渠道注册渠道用户需要注册,提交其信息后,由运营端审核后,进行正常业务操作。信息项数据类型说明店名nameString(50)地址addrString(50)营业执照号码licenseNoString(50)营业执照图片licenseImgUrlString(20)店长名keeperString(200)密码passwordString(20)身份证号idNoString手机号mobileNumString状态statusint0,待审核;1,正常门店(shop)店员注册渠道所属的店员可自行注册,注册的方式是由扫描店长提供的二维码,打开注册页面,进行注册。注册后的店员归属于此店,由店长进行管理。信息项数据类型说明名称nameString(50)密码passwordString(50)照片地址picUrlString(50)创建时间createTimeDateTime所属门店shopIdString(20)状态statusStringnormal,正常;deleted删除;locked,冻结店员管理店长可对所属店员进行新增、修改、删除、重置密码等操作。扫描乐码店员(及店长)可以扫描瓶盖,以对其销售产品进行统计,用于此后的销量凭证等。)文档编号:XQDY201710_002页码:123of130公司:北京爱创科技股份有限公司版本:Rev2.0标题:光明乳业追溯服务平台详细设计兑奖店员(店长)可扫描消费者中奖的乐券,并将奖品兑换给消费者,此后此乐券转移给此门店,消费者的乐券失效。店长也可将此乐券转移给其他渠道用户。销量报表(店员)店员销量统计店员的销售状况,此表数据在店员扫码时更新,虽然此数据可由扫描日志统计出来,但考虑性能,使用此表查询为宜。信息项数据类型说明店员idsalesmanIdString门店idshopIdString产品IdproductIdString数量amountint店员销量表(salesmanSales)销量报表(店长)统计门店的销量,数据从店员销量表中得到。记账单渠道用户需要向上下游兑换,提供记账单功能以便其进行统计。渠道客户渠道客户是指,在生产企业产品流通过程中的批发商、经销商等,其在系统中起到承上启下的作用。渠道客户也需经过审核才能进行正常业务操作。2架构2.1消费者端请求由阿里云负载均衡服务器(tcp传输层)平均分配到后端nginx。Nginx的作用是使用反向代理技术来做负载均衡(http应用层)。)文档编号:XQDY201710_002页码:124of130公司:北京爱创科技股份有限公司版本:Rev2.0标题:光明乳业追溯服务平台详细设计2.1.1反向代理应用层的负载均衡有重大作用,是应对高并发访问的关键:接收外部访问,拦劫过多的并发请求。高并发情况下,外部的高峰请求甚至达到几十万/秒,而如果直接将php服务器暴露在外,将会使服务器因内存不足而很快崩溃。假设并发连接为R,则耗费的内存为R*4m/256,同时每个php进程将耗费大概10-20m内存,因此,必须把php服务器置于后端,以防止其崩溃。实现请求排队目前的实现是nginx+lua+redis来实现对请求的排队。当一个请求进入时,会查redis中所存ngx_current_in是否超出lua中所配置的ngx_current_limit,如果超出,则直接返回排队界面,同时将码存入ngx_codes_set,并返回其排队号。每次请求时,会检查ngx_current_expire值,如果超过60秒,则清空当前处理队列,具体做法是setngx_current_in=0,并清空ngx_codes_set中的0到ngx_current_limit。冗余节点,提高可用性防止某台反向代理出现故障,提高可用性2.1.2RedisRedis是保证高并发和性能的另一个关键节点,作用有:将频繁访问、写入的数据存入,并不断同步到数据库,减轻数据库压力。将写入量极大的部分先存入redis队列,并逐步写入到数据库,减轻数据库写压力。将主要信息存入redis,供整个集群调用,如排队、session等。2.1.3数据库故障转移两台数据库服务器做主主同步,并在CI中配置故障转移,当一台数据库出现故障时,自动转移到另一台(见config中failover)。2.1.4队列队列服务器主要监控两部分数据:redis中的写入队列和对外部接口的异步请求。前者是sql_master(码信息、表更新)、sql_rpt(报表数据)、limit_zone(奖品限制)等。后者主要是微信红包、模板消息等。两者机制不同,前者是从redis队列中不断获取,并写入到数据库;后者是检查数据库中待处理项,并使用事务做更新。2.2企业端企业)文档编号:XQDY201710_002页码:125of130公司:北京爱创科技股份有限公司版本:Rev2.0标题:光明乳业追溯服务平台详细设计端相对简单,将nginx、php、rpt配置在一台低端服务器上,使用两台以做故障转移。2.2.1报表实时报表是队列服务器将数据异步写入到数据库。查询数据同redis做缓存服务器,来提高访问速度。Node中使用了厨师模式。2.2.2NAS和Redis目前Redis是购买的阿里云服务,NAS服务器是购买的ECS搭建的。这两个节点都可能存在单点故障,需要谨慎防范。2.2.3负载均衡负载均衡与故障转移的内在机理一致,都是通过多个节点对外提供服务,因此配置的地方基本一致。web的负载均衡仍如上文所说通过阿里云SLB来实现;数据的负载均衡是通过配置mysqlnd_ms,建立一组多从,默认是组1的主服务器和组1读服务器和组2的读服务器,当读取压力过大时,采取增加读服务器的办法来分担压力。3安全设计3.1基础安全基础安全指包含基础软硬件支撑体系的安全,包括:DNS服务器、应用服务器、数据库服务器、硬件防火墙、网络、操作系统、软件防火墙、Web防火墙等,按照层次,包括:网络层、应用层、主机层、数据层。3.1.1网络层网络层的安全通过软硬件防火墙来实现保护。我们采用的高安全、难攻破的双层异构防火墙来保证安全性。硬件防火墙使用阿里云的云盾。云盾高防IP基于阿里云自主研发的攻击防护服务产品,为客户提供DDoS、CC、WAF防护服务,可以防护SYNFlood、UDPFlood、ACKFlood、ICMPFlood、DNSQueryFlood、NTPreplyFlood、CC攻击、WEB应用攻击等3到7层DDoS攻击。用户购买高防IP,把域名解析到高防IP上(Web业务只要把域名指向高防IP即可。非Web业务,把业务IP换成高防IP即可)同时在高防上设置转发规则;所有公网流量都会走高防机房,通过端口协议转发的方式将用户的访问通过高防IP转发到源站IP,同时将恶意攻击流量在高防IP上进行清洗过滤后将正常流量返回给源站IP,从而确保源站IP稳定访问的防护服务。)文档编号:XQDY201710_002页码:126of130公司:北京爱创科技股份有限公司版本:Rev2.0标题:光明乳业追溯服务平台详细设计软件防火墙采用在Linux使用广泛的iptables。iptables是与最新的3.5版本Linux内核集成的IP信息包过滤系统。如果Linux系统连接到因特网或LAN、服务器或连接LAN和因特网的代理服务器,则该系统有利于在Linux系统上更好地控制IP信息包过滤和防火墙配置。防火墙在做信息包过滤决定时,有一套遵循和组成的规则,这些规则存储在专用的信息包过滤表中,而这些表集成在Linux内核中。在信息包过滤表中,规则被分组放在我们所谓的链(chain)中。而netfilter/iptablesIP信息包过滤系统是一款功能强大的工具,可用于添加、编辑和移除规则。)文档编号:XQDY201710_002页码:127of130公司:北京爱创科技股份有限公司版本:Rev2.0标题:光明乳业追溯服务平台详细设计3.1.2应用层应用层安全指的是HTTP协议层安全,面临的安全威胁主要有:SQL注入、XSS跨站脚本、Web服务器插件漏洞、木马上传、非授权核心资源访问等OWASP常见攻击海量恶意访问。在Web服务器中,内置安全脚本,根据对单一源验证、人机识别等;针对)文档编号:XQDY201710_002页码:128of130公司:北京爱创科技股份有限公司版本:Rev2.0标题:光明乳业追溯服务平台详细设计海量慢速请求攻击、根据统计响应码及URL请求分布、异常Referer及User-Agent特征识别,结合网站精准访问控制进行综合防护;充分利用阿里云大数据安全优势、建立威胁情报与可信访问分析模型、快速识别恶意流量,并在HTTP层进行封堵和控制。3.1.3主机层登录安全:识别异常和非法登录并上报拦截登录流水审计:记录所有登录记录,对于非常用登录的行为进行实时提醒,可自由配置常用登录地暴力破解联动:对非法破解密码的行为进行识别,避免被黑客多次猜解密码而入侵木马查杀:一键清除网站后门维护服务器环境纯净安全巡检:全面快速对服务器进行体检账户安全检测:深度检测服务器上是否存在黑客入侵后,留下的账户,对影子账户、隐藏账户、克隆账户进行提醒配置风险检测:对常见登录配置、进程配置进行检查,以达到企业级服务器安全准入标准3.1.4数据层数据库审计服务,可针对数据库SQL注入、风险操作等数据库风险操作行为进行记录与告警。为数据库提供安全诊断、维护、管理能力。用户行为发现审计:关联应用层和数据库层的访问操作、可溯源到应用者的身份和行为风险和危害线索:高中低的风险等级、SQL注入、黑名单语句、违反授权策略的SQL行为会话线索:根据时间、用户、IP、应用程序、和客户端多角度分析详细语句线索:提供用户、IP、客户端工具、访问时间、操作对象、SQL操作类型、成功与否、访问时长、影响行数等多种检索条件异常操作风险:通过IP、用户、数据库客户端工具、时间、敏感对象、返回行数、系统对象、高危操作等多种元素细粒度定义要求监控的风险访问行为SQL注入:系统提供了系统性的SQL注入库,以及基于正则表达式或语法抽象的SQL注入描述,发现异常立即告警黑白名单:提供准确而抽象的方式,对系统中的特定访问SQL语句进行描述,使这些SQL语句出现时能够迅速报警、3.2应用安全应用安全是指欢乐扫平台本身的业务安全以及技术安全。因为欢乐扫与微信平台紧密关联,因此其安全包括欢乐扫与微信平台各自的安全性,以及双方接口的安全性。因为欢乐扫是基于一物一码的系统,其安全性集中体现在码的安全性上,而码的安全又体现在码本身的加密、防盗防刷、防暴力破解等之上。3.2.1码加密二维码其本质是字符串,其安全性度量标准是任意构造一个等长字符串,恰好)文档编号:XQDY201710_002页码:129of130公司:北京爱创科技股份有限公司版本:Rev2.0标题:光明乳业追溯服务平台详细设计是系统合法码的概率。举例说明,比如合法的码是a,b,c三个,假定字符集为小写字母,那么这个字符集的总容量为26,那么其安全性为3/26=0.115,也就是说,按照所定长度1构造一个字符串,那么其命中的概率为11%。欢乐扫的编码规则为版本号(1位)+企业编码+流水号+校验码,然后进行加密混淆。其中可以按照所要求的安全等级选择版本,理论上讲,越长的码越安全。欢乐扫采用62字符集,即大小写字母+数字的组合,其长度根据码版本来确定。以5版本为例,其除了版本号的长度为11位,那么任意构造一个等长字符串恰好等于系统合法码的概率为n/62^11,其中n是企业已经申请码的数量,假定n=1亿,那么其安全等级为:1.92e-12,也就是命中的概率基本可以忽略不计。除了有足够的码空间,以保证破解的难度,另外黑客会试图猜测码的编码规则来尝试去构造合法的码,这就要求码加密算法有足够好的分布性。所谓分布性,就是指合法码在整个码空间内的分布特征,以下图为例:左图码分布不均,因此在部分情况下,会出现非常大的规律性,黑客可以据此构造新码;右图分布比较均匀,无明显规律性,黑客很难猜测中合法的码。欢乐扫系统从3版本后的码,均升级为分布性非常优秀的算法。3.2.2防破解由于巨大的码空间和码规则的无规律性,黑客如果要获取非法收益,则需要进行大量的暴力破解。防止暴力破解的主要方法是:1、降低其预期收益2、提高其破解成本。降低破解收益的方式通过限制扫码次数来实现,企业根据自己需要及数据分析的规律,)文档编号:XQDY201710_002页码:130of130公司:北京爱创科技股份有限公司版本:Rev2.0标题:光明乳业追溯服务平台详细设计找到正常用户每月、每日、每时的正常扫码量,并对其进行限制,这样可以大大降低黑客的尝试次数。同时,在微信商户平台中设置每日红包领取金额、个数也是降低预期收益方案的一种。提高破解成本的做法通过限制IP、限制帐号的方式来实现。但黑客一旦尝试非法构造的未激活的、已停用的,或者其扫码行为不符合大多数用户行为特征,则对其微信帐号进行封禁。因为微信的活跃帐号成本较高,且绑定银行卡等设置了较高的使用门槛,因此大大提高了黑客的破解成本。欢乐扫提供了日常的封禁和解封服务。因为对用户帐号的封禁是基于大数据的分析算法因此不能保证100%的准确性,所以运营部门会每日根据用户提交的解封请求,根据其过往记录,进行拉黑或者解封。这整套机制保证了码的防破解。3.2.3系统监控欢乐扫告警系统对所有企业、所有用户行为进行监控,利用大数据的沉淀及分析对企业的运行状况和用户的行为进行监控,举例来说,如企业的扫码量、红包金额等突然增加且不符合正常的增长速度,如单个用户的扫码量突然增长等,都会进入系统告警,此时工程师会马上介入,对此异常进行跟踪处理,以防止企业或用户的进一步损失,或者解除告警。3.2.4微信及接口安全微信商户平台有自身的安全保障机制,如限制每日红包领取个数或金额,登录数字证书等。欢乐扫系统假设微信商户平台是安全的,且企业要与微信商户平台自行约定安全保证。微信商户平台与欢乐扫的接口通过以下方式保证安全:HTTPS安全协议来进行通信。安全协议可以保证整个通信过程的防窃取、防篡改、防假冒。256位的安全证书,在调用微信接口时,需要调用证书来保证调用者身份和数据安全。IP白名单。微信商户平台可以将欢乐扫的服务器设置为白名单,以防止其它平台冒用身份调用接口。调用日志记录及监控。所有调用记录都留存并进行分析,如果出现异常调用,则及时告警,及时处理。
您可能关注的文档
- 安徽省中职院校智慧校园整体规划方案.docx
- 03全国各地市地铁设计及功能分析.pdf
- 负载均衡设备招标采购项目投标方案——商务.docx
- 附件1 青岛地铁APP项目工作任务分解表v2.0.docx
- 附件2 青岛地铁APP项目工作任务说明书.docx
- 附件3 青岛地铁APP乙方人员配置与工作职责.docx
- 赋码系统应急预案.docx
- 光明管控平台试题.docx
- 负载均衡设备招标采购项目投标方案——技术.docx
- 光明乳业-赋码系统培训测试题.docx
- 光明乳业产线赋码系统施工组织设计(2017.10.12).docx
- 光明乳业产线赋码系统需求规格说明书(2018.01.15).docx
- 光明乳业赋码系统培训记录表.docx
- 光明全程追溯管控平台详细设计说明书.doc
- 光明乳业管控平台施工组织设计.docx
- 光明乳业管控平台需求规格说明书-2018.01.11.docx
- 光明乳业全产业链可追溯体系BI展示及分析系统培训方案.doc
- 光明乳业全产业链可追溯体系BI展示及分析系统培训计划.doc
- 光明乳业全程追溯管控平台培训记录表 .docx
- 光明乳业追溯服务平台培训记录表.docx
- 大叔大爷
- 该用户很懒,什么也没介绍