追溯服务概要设计.doc

文档编号：GYSJ201710_001页码:1of128公司:北京爱创科技股份有限公司版本:Rev1.0标题:光明乳业追溯服务平台概要设计光明乳业全程追溯管控及追溯服务平台、产线赋码系统项目追溯服务平台-概要设计说明书Preparedby拟制夏习林Date日期2017-09-21Reviewedby评审人王学栋Date日期2017-09-22Approvedby批准刘鸣Date日期2017-09-25文档编号：GYSJ201710_001页码:2of128公司:北京爱创科技股份有限公司版本:Rev1.0标题:光明乳业追溯服务平台概要设计RevisionRecord修订记录Date日期RevisionVersion修订版本ChangeDescription修改描述Author作者2017-09-20v1.0添加第一版夏习林2017-09-21V2.0初版郭武2017-10-22V3.0终版栗树亮第ii页文档编号：GYSJ201710_001页码:3of128公司:北京爱创科技股份有限公司版本:Rev1.0标题:光明乳业追溯服务平台概要设计目录1.概述.................................................................................................................................71.1.文档目的.........................................................................................................................71.2.项目背景.........................................................................................................................71.3.定义.................................................................................................................................81.3.1.专门术语................................................................................................................81.3.2.缩写........................................................................................................................91.3.3.参考资料................................................................................................................92.系统概述.......................................................................................................................102.1.目标...............................................................................................................................102.2.运行环境.......................................................................................................................103.需求概述.......................................................................................................................113.1.总体描述.......................................................................................................................113.2.功能需求.......................................................................................................................113.3.安全需求.......................................................................................................................134.总体设计.......................................................................................................................154.1.总体系统架构设计.......................................................................................................154.2.处理流程.......................................................................................................................154.2.1.批次信息处理......................................................................................................154.2.2.单据信息处理......................................................................................................164.2.3.码流向查询处理..................................................................................................174.2.4.微信稽查处理......................................................................................................184.3.总体结构和模块外部设计...........................................................................................204.4.功能分配.......................................................................................................................205.接口设计.......................................................................................................................225.1.外部接口.......................................................................................................................225.1.1.PDM.....................................................................................................................225.1.2.ESC.......................................................................................................................22文档编号：GYSJ201710_001页码:4of128公司:北京爱创科技股份有限公司版本:Rev1.0标题:光明乳业追溯服务平台概要设计5.1.3.WMS......................................................................................................................235.1.4.JPS........................................................................................................................235.2.内部接口.......................................................................................................................245.2.1.追溯码接口；......................................................................................................245.2.2.单据接口..............................................................................................................245.2.3.批次接口..............................................................................................................245.2.4.文件接口..............................................................................................................245.3.用户功能设计...............................................................................................................255.3.1.资料管理..............................................................................................................255.3.2.产品管理..............................................................................................................295.3.3.追溯码管理..........................................................................................................335.3.4.入出库管理..........................................................................................................375.3.5.流向查询..............................................................................................................425.3.6.预警管理..............................................................................................................465.3.7.报表统计..............................................................................................................555.3.8.系统用户账号集成..............................................................................................615.3.9.稽查......................................................................................................................625.3.10.业务员巡店..........................................................................................................645.3.11.数据上报..............................................................................................................655.3.12.系统后台处理服务..............................................................................................665.3.13.系统管理..............................................................................................................685.3.14.接口......................................................................................................................715.3.15.ESC系统..............................................................................................................725.4.硬件接口.......................................................................................................................725.5.软件接口.......................................................................................................................726.数据结构设计...............................................................................................................736.1.数据库需求分析...........................................................................................................736.2.总体数据库架构设计...................................................................................................73文档编号：GYSJ201710_001页码:5of128公司:北京爱创科技股份有限公司版本:Rev1.0标题:光明乳业追溯服务平台概要设计6.3.数据库概念结构设计...................................................................................................747.运行设计.......................................................................................................................757.1.运行模块的组合...........................................................................................................757.2.运行控制.......................................................................................................................757.3.运行时间.......................................................................................................................758.出错处理设计...............................................................................................................768.1.出错输出信息...............................................................................................................768.2.出错处理对策...............................................................................................................769.安全保密设计...............................................................................................................7810.维护设计.......................................................................................................................7911.欢乐扫设计...................................................................................................................80概述80功能设计81企业门户8211.1.1.注册......................................................................................................................8211.1.2.产品......................................................................................................................8611.1.3.奖品......................................................................................................................8811.1.4.乐码......................................................................................................................9511.1.5.活动......................................................................................................................9711.1.6.礼品....................................................................................................................10211.1.7.订单....................................................................................................................10311.1.8.管理....................................................................................................................10511.1.9.设置....................................................................................................................107手机端10711.1.10.扫码中奖............................................................................................................10811.1.11.积分商城............................................................................................................11211.1.12.我的奖励............................................................................................................113手机端-渠道用户............................................................................................................................121文档编号：GYSJ201710_001页码:6of128公司:北京爱创科技股份有限公司版本:Rev1.0标题:光明乳业追溯服务平台概要设计11.1.13.渠道注册............................................................................................................12111.1.14.店员注册............................................................................................................12211.1.15.店员管理............................................................................................................12211.1.16.扫描乐码............................................................................................................12211.1.17.兑奖....................................................................................................................12211.1.18.销量报表（店员）............................................................................................12211.1.19.销量报表（店长）............................................................................................12311.1.20.记账单................................................................................................................123运营端12311.1.21.生产企业............................................................................................................12411.1.22.渠道客户............................................................................................................12511.1.23.喷码机................................................................................................................12711.1.24.印刷厂................................................................................................................127与TTS接口12711.1.25.欢乐扫接口........................................................................................................12711.1.26.单点登录............................................................................................................12911.1.27.数据接口............................................................................................................129文档编号：GYSJ201710_001页码:7of128公司:北京爱创科技股份有限公司版本:Rev1.0标题:光明乳业追溯服务平台概要设计1.概述1.1.文档目的根据前期的详细需求分析文档，将用户对本系统的需求做了详细的阐述，这些用户需求已经在上一阶段中需求分析中进行了讨论和研究，此阶段将从业务逻辑和用户应用环境中抽象出系统对象的组成结构、流程和各个部分相互关系以及数据库的概念结构和界面的逻辑关系。《概要设计说明书》要达到如下一些目标：定义系统的各个组成部分描述各个部分的结构描述各个部分的相互关系以及他们如何协调与合作项目组成员对解决方案的共识产生详细设计的基础文档编号：GYSJ201710_001页码:8of128公司:北京爱创科技股份有限公司版本:Rev1.0标题:光明乳业追溯服务平台概要设计1.2.项目背景光明乳业股份有限公司是集牧场养殖、生产制造、物流运输、产品分销及终端零售为一体的综合性乳业集团。2015年实现销售收入194亿元，位列中国乳制品行业三甲。覆盖全产业链拥有400座牧场，18家国内工厂，26座现代化仓库、400多个经销商和100万个有效销售网点。产品种类丰富，包括新鲜酸奶、牛奶、乳酸菌饮品、牛乳饮品、奶酪以及常温酸奶、牛奶、乳酸菌饮品、奶粉和植物饮品等系列产品。光明乳业内部有不少业务应用系统，这些应用系统一般都是由不同供应商提供，他们之间有信息重叠和不一致等现象的出现。因此很容易产生：基础数据多头管理、系统间数据一致性差；接口没有实现统一的接口平台；数据和信息传递多采用传统的纸媒或者表格形式，及时性和准确性存在风险；企业内部信息和数据难以完成统一和共享。为满足全产业链追溯体系建设要求，需要打通乳产品企业供应链和营销数文档编号：GYSJ201710_001页码:9of128公司:北京爱创科技股份有限公司版本:Rev1.0标题:光明乳业追溯服务平台概要设计据的通道，通过一物一码“身份证号”将集中养殖牧场、乳品生产企业、渠道商销售终端、销售员、促销员、和消费者全部关联起来，对全供应链环节进行生态管控。防止假货、窜货，以及渠座励、终端激励、返点、积分等。促使乳品企业管理人员可以清晰洞察供应链环节状态、渠道销售量、库存、终端销售量、促销活动即时评估等，进而实现对销售费用的有效监控，同时进行大数据分析，提高企业管控能力，增强企业核心竞争力。1.3.定义1.3.1.专门术语出入库计划单：货物还未进行出库，只是描述理论上，计划上将要出库的数量，通常该单据由第三方系统通过接口产生。出入库单：实际的出入库业务产生的单据，通常由手持进行扫描出库。关联关系:将产品上的追溯码按包装比例关系形成树形关系结构的文件结构；1.3.2.缩写TTS：双向追溯系统；文档编号：GYSJ201710_001页码:10of128公司:北京爱创科技股份有限公司版本:Rev1.0标题:光明乳业追溯服务平台概要设计1.3.3.参考资料1、初步需求说明书；2、详细需求分析说明书；文档编号：GYSJ201710_001页码:11of128公司:北京爱创科技股份有限公司版本:Rev1.0标题:光明乳业追溯服务平台概要设计2.系统概述2.1.目标实现和PDM、WMS等系统的对接，从而有效整合企业的业务系统；实现仓库的快速出入库，并有效，严格的管理仓库；实现多组织机构委托加工业务下的出入库单单据管理，从而灵活简单的实现集团客户的需求；实现正向追踪与方向追溯业务要求；实现稽查窜货分析判断；2.2.运行环境硬件配置需求项目CPU逻辑核数量内存量硬盘描述主应用服务器3232G500G辅应用服务器1168G50G用于消费者高并发查询，可根据并发情况增加服务器个数数据库服务器3232G1T数据库备份服务器1616G2T通过镜像实现数据库备份F5负载均衡设备磁盘阵列双CPU架构24个盘位Raid0，1，5，10，软件配置需求项目配置文档编号：GYSJ201710_001页码:12of128公司:北京爱创科技股份有限公司版本:Rev1.0标题:光明乳业追溯服务平台概要设计操作系统WindowsServer2008R2数据库MSSqlserver2008R2文档编号：GYSJ201710_001页码:13of128公司:北京爱创科技股份有限公司版本:Rev1.0标题:光明乳业追溯服务平台概要设计3.需求概述3.1.总体描述TTS双向追溯系统用于实现产品从原材料、辅料、原奶的生产加工到全流通过程的全程追溯与追踪，实现正向召回与反向追溯的功能。3.2.功能需求本软件只要提供的功能（详细情况可参加产品数据管理平台V5.0软件需求规格说明书）:软件模块子模块功能说明系统管理系统参数设置设置系统全局设置，如消息预警推送、码解析器等企业参数设置可配置全局或按企业级别配置入出库操作的类型信息，如：允许重复出库等；单据类型设置可根据实际环境或业务需求，设置服务企业自身的入出库单据类型名称；角色信息维护实现系统按角色来划分不同企业、人员的系统操作功能权限；操作日志查看实现对系统的路径访问追踪记录，确保系统的操作安全；资料管理区域信息维护可根据企业实际业务需求来划分不同区域，实现对各企业入出库流向的管理或窜货管理；企业级别维护可自定义符合企业业务需求的企业级别，方便系统对个企业的维护检索；企业信息维护用于新增、修改、禁用企业（生产、经销）信息，维护企业的往来企业信息；用户信息维护用于添加系统的操作用户，支持与集团的域环境绑定，并设置相应角色信息与管辖文档编号：GYSJ201710_001页码:14of128公司:北京爱创科技股份有限公司版本:Rev1.0标题:光明乳业追溯服务平台概要设计区域（用于稽查）；批次信息维护用于维护赋码系统上传的生产批次信息，并统计生产数量，可下载生产数据（完整关联关系文件格式）；产品管理目录信息维护用于建立企业的产品类别，实现产品按类别划分，方便检索；产品信息维护用于维护系统所生产的产品信息，包括包装比例、有效期、产品宣传图等；企业产品维护实现将产品与具体的生产企业关联，使企业可以生产该产品并根据企业实际需要设置相应的包装比例等；包装比例维护用于维护产品的包装比例，与实际生产或出库比例对接；追溯码管理追溯码申请用于在TTS系统中申请追溯码或与追溯码对应的防伪码，用于给印刷企业印刷码追溯码查询实现对生产上传的生产码或系统申请后再TTS系统激活的追溯码码信息追溯码导出用于对生产批次数据按码级别拆分文件导出码模糊查询支持对印刷不清楚的追溯码进行模糊匹配查询码规则管理用于配置符合企业产品的追溯码格式，用于在生成码时按该格式生成相应的码；追溯码下载用于给印刷企业下载管理人员申请的追溯码，并记录下载信息入出库管理关联关系上传监控用于查询上传的关联关系文件解析的状态，是失败或成功并展示失败原因；入出库上传监控用于查询上传的单据文件的解析状态，是失败或成功并展示失败原因；入出库任务单用于建立出库的计划任务单，用于手持终端设备同步任务单后扫描出库；入出库单上传用于监控当前上传的关联关系文件及单据文件的处理进度，可在线修改失败的文件，用于再次自动解析；入出库单维护检索查询已完成的任务单，可对已完成的任务单做变更，也可不通过手持设备在此建立有码单与无码单，形成出库记录；上传文件成功列表用于按单据类型检索并下载完成解析的文件文档编号：GYSJ201710_001页码:15of128公司:北京爱创科技股份有限公司版本:Rev1.0标题:光明乳业追溯服务平台概要设计流向查询单码流向查询用于查询系统追溯码的出库流向信息产品批号流向用于按批号检索统计出库的流向信息入出库单查询　入出库单明细查询检索按单号、产品等条件查询单据的明细信息预警管理预警信息订阅用于设置系统预警订阅模块及人员，系统根据设置好的订阅信息，通过邮件推送的方式将预警信息第一时间发送到指定接收人员手中，此模块需要安装预警服务区域过期产品按指定区域检索该区域内的生产企业已过期的产品企业过期产品按条件统计指定范内内的企业过期产品防伪查询预警统计超过查询6次的防伪码，用于监控产品异常查询码重复出库预警统计码重复出库记录信息码不存在预警统计出库信息中码不存在的码关联关系重码预警统计关联关系中重复生产的码，重复生产的多区域查询预警统计同一个码在不同地区扫描的码，可解除预警未激活码查询预警统计TTS系统生成的码在未激活状态下扫描查询，可解除预警统计报表防伪统计报表防伪查询统计、异地查询日统计、扫描查询、非法码查询统计、假货码查询统计、多区域查询统计、防伪查询分布表数据同步调用接口凭证维护用于维护TTS系统与赋码、欢乐扫或其他第三方的接口凭证关联关系上报用于将赋码系统上传的批次信息上报到欢乐扫，用于欢乐扫做活动入出库单上报用于将单据信息上报到欢乐扫，用于欢乐扫做活动3.3.安全需求目的文档编号：GYSJ201710_001页码:16of128公司:北京爱创科技股份有限公司版本:Rev1.0标题:光明乳业追溯服务平台概要设计软件信息安全是衡量系统可靠性，一体化和可用性的必要条件，因此该系统应该满足账户信息的安全和可访问性要求；同时，由于系统与多个第三方系统对接，需要实现对接接口的凭证认证；账户安全系统应该能够通过设置来配置较安全的用户账户管理方式，具体安全要求如下：参数定义、描述最小密码长度合法密码最小字符长度锁定账户登陆失败指定次数后该账户将不允许在一定时间段再次登陆密码复杂度密码由多种字符或数字特殊字符组成密码的安全性密码不能明文保存，需要进行加密后保存接口安全系统之间的对接，需要先进行Token认证，通过认证的企业可进行接口直接的数据传输；文档编号：GYSJ201710_001页码:17of128公司:北京爱创科技股份有限公司版本:Rev1.0标题:光明乳业追溯服务平台概要设计4.总体设计4.1.总体系统架构设计具体各数据库关系见数据库设计。4.2.处理流程4.2.1.批次信息处理批次信息为产品的生产信息，为ESC在生产工厂将包装好的产品进行采文档编号：GYSJ201710_001页码:18of128公司:北京爱创科技股份有限公司版本:Rev1.0标题:光明乳业追溯服务平台概要设计集后按指定的包装比例按照一定规则组建的关联关系信息，实现了从托盘码找到箱码、箱码找瓶码的父子关系信息。文件处理流程为：4.2.2.单据信息处理单据信息为生产企业或流通企业的销售出库信息，为产品追溯的重要环节，是窜货分析的主要节点，具体流程为：文档编号：GYSJ201710_001页码:19of128公司:北京爱创科技股份有限公司版本:Rev1.0标题:光明乳业追溯服务平台概要设计4.2.3.码流向查询处理码流向查询为系统的双向追溯的重要功能，实现按追溯码正向追溯产品的流向信息，从奶源、原材料到生产工厂到流通的所有环节全程追溯。文档编号：GYSJ201710_001页码:20of128公司:北京爱创科技股份有限公司版本:Rev1.0标题:光明乳业追溯服务平台概要设计4.2.4.微信稽查处理微信稽查为通过微信服务号，使企业稽查人员方便市场稽查，提高防窜货管理能力。文档编号：GYSJ201710_001页码:21of128公司:北京爱创科技股份有限公司版本:Rev1.0标题:光明乳业追溯服务平台概要设计文档编号：GYSJ201710_001页码:22of128公司:北京爱创科技股份有限公司版本:Rev1.0标题:光明乳业追溯服务平台概要设计4.3.总体结构和模块外部设计4.4.功能分配系统功能分配可以参考4.3的设计，大概模块功能描述分为：资料管理：用于维护企业级批次信息；产品管理：用于维护产品及企业产品的基础信息及对应的包装比例；追溯码管理：用于实现追溯码申请、下载及查询；文档编号：GYSJ201710_001页码:23of128公司:北京爱创科技股份有限公司版本:Rev1.0标题:光明乳业追溯服务平台概要设计入出库管理：用于实现任务单的管理及单据的管理；流向查询：用于实现追溯码或批次的流向查询；预警管理：用于实现系统对追溯码的状态监控预警；报表统计：用于实现防伪查询分析；数据上报：用于实现产品的营销数据上报JPS系统；系统管理：用于维护系统的基本配置信息；文档编号：GYSJ201710_001页码:24of128公司:北京爱创科技股份有限公司版本:Rev1.0标题:光明乳业追溯服务平台概要设计5.接口设计5.1.外部接口外部接口用于定义TTS系统与第三方系统的数据交换的协议，实现数据之间的安全交互；5.1.1.PDM1、单据对应关联关系下载接口2、上传单据接口3、产品同步接口数据流程：文档编号：GYSJ201710_001页码:25of128公司:北京爱创科技股份有限公司版本:Rev1.0标题:光明乳业追溯服务平台概要设计5.1.2.ESC1、产品同步接口2、关联关系上传接口数据流程：5.1.3.WMS1、单据对应关联关系上传接口2、单据上传接口数据流程：文档编号：GYSJ201710_001页码:26of128公司:北京爱创科技股份有限公司版本:Rev1.0标题:光明乳业追溯服务平台概要设计5.1.4.JPS1、关联关系营销数据上报接口2、单据营销数据上报接口5.2.内部接口用于实现系统内部数据交换的接口协议，包括：5.2.1.追溯码接口；用于定义与追溯码查询的接口方法，实现系统接统一的接口调用；5.2.2.单据接口用于定义入出库单据的操作接口信息，实现单据的数据处理及检索；5.2.3.批次接口用于定义生产批次数据的接口操作，实现对生产数据的数据处理机检索；文档编号：GYSJ201710_001页码:27of128公司:北京爱创科技股份有限公司版本:Rev1.0标题:光明乳业追溯服务平台概要设计5.2.4.文件接口用于定义对TTS接收文件的处理操作，实现分类处理并统计；5.3.用户功能设计5.3.1.资料管理5.3.1.1.区域信息维护概述：用于设置系统中监管区域信息。可根据企业销售区域定义划分不同的区域类型及管理行政区域，用于控制企业的销售区域及用户的管理区域，TTS系统稽查及防伪窜货分析将根据企业设置的好管辖区域信息做防伪窜货判断分析，并提供相应报表数据。区域结构例如：业务流程：文档编号：GYSJ201710_001页码:28of128公司:北京爱创科技股份有限公司版本:Rev1.0标题:光明乳业追溯服务平台概要设计5.3.1.2.企业级别维护概述：用于维护企业级别信息，将不同企业按照对应的企业级别信息进行分类划分，便于管理。如生产企业、流通企业、终端门店等；业务流程：文档编号：GYSJ201710_001页码:29of128公司:北京爱创科技股份有限公司版本:Rev1.0标题:光明乳业追溯服务平台概要设计5.3.1.3.企业信息维护概述：用于维护系统中所有的企业的信息。包括生产企业、印刷企业、流通企业、终端门店及与TTS系统做接口交互的企业等。不存在的企业上传数据时将无法上传并完成数据的解析操作；业务流程：文档编号：GYSJ201710_001页码:30of128公司:北京爱创科技股份有限公司版本:Rev1.0标题:光明乳业追溯服务平台概要设计5.3.1.4.用户管理概述：用于维护使用TTS系统的用户信息，用户是系统的登录凭证，TTS系统支持集团的域用户管理，即所有TTS系统用户必须为集团的域用户，确保使用系统的安全控制及账号的统一效注管理。业务流程：文档编号：GYSJ201710_001页码:31of128公司:北京爱创科技股份有限公司版本:Rev1.0标题:光明乳业追溯服务平台概要设计5.3.1.5.批次信息维护概述：用于查看、维护生产批次信息。业务流程：文档编号：GYSJ201710_001页码:32of128公司:北京爱创科技股份有限公司版本:Rev1.0标题:光明乳业追溯服务平台概要设计5.3.2.产品管理5.3.2.1.产品目录管理概述：用于维护系统产品的大类，即用于将新增的产品划分到指定的大类中，便于检索；例如乳制品可以是液态奶、奶粉、乳制品饮料等等。业务流程：文档编号：GYSJ201710_001页码:33of128公司:北京爱创科技股份有限公司版本:Rev1.0标题:光明乳业追溯服务平台概要设计5.3.2.2.产品信息维护概述：用于维护集团所生产的产品信息，产品信息包括产品编码、名称、库存单位、有效期等，产品信息支持宣传图定期变更，支持不同生产时间不同的产品宣传图，用于系统在防伪稽查时匹配正确的宣传图。业务流程：文档编号：GYSJ201710_001页码:34of128公司:北京爱创科技股份有限公司版本:Rev1.0标题:光明乳业追溯服务平台概要设计5.3.2.3.企业产品维护概述：用于指定生产企业所生产的产品，建立生产企业与产品的关联关系；业务流程：文档编号：GYSJ201710_001页码:35of128公司:北京爱创科技股份有限公司版本:Rev1.0标题:光明乳业追溯服务平台概要设计5.3.2.4.包装比例维护概述：维护产品的内外包装信息。使产品可按照指定比例进行包装与出库；业务流程：文档编号：GYSJ201710_001页码:36of128公司:北京爱创科技股份有限公司版本:Rev1.0标题:光明乳业追溯服务平台概要设计5.3.3.追溯码管理5.3.3.1.追溯码申请概述：用于企业生成指定规则的追溯码，用于包材印刷、下载；业务流程：文档编号：GYSJ201710_001页码:37of128公司:北京爱创科技股份有限公司版本:Rev1.0标题:光明乳业追溯服务平台概要设计5.3.3.2.追溯码查询概述：用于查询追溯码对应的产品、批号、父子码的关系信息，可实现查看查询的码所在的批次信息。用于实现追溯单码流向信息，包括原料到销售的各个环节信息及批次信息流向。用于实现正向与方向追溯产品质量信息；业务流程：5.3.3.3.追溯码导出概述：用于将生产批次数据按包装级别分别生产相应不同级别的码文件，方便用户查看相应批次的码信息；业务流程：文档编号：GYSJ201710_001页码:38of128公司:北京爱创科技股份有限公司版本:Rev1.0标题:光明乳业追溯服务平台概要设计5.3.3.4.码模糊查询概述：用于处理追溯码码被部分损坏或记录不清楚时，可以通过通配符%或？来查询码。业务流程：文档编号：GYSJ201710_001页码:39of128公司:北京爱创科技股份有限公司版本:Rev1.0标题:光明乳业追溯服务平台概要设计5.3.3.5.码规则管理概述：用于配置符合企业生产要求的追溯码生成规则，供追溯码申请时选择使用，并生成相应规则的码文件。业务流程：5.3.3.6.追溯码下载概述：用于将在TTS系统申请的追溯码及对应的防伪码下载到本地，发给印刷企业或赋码系统进行赋码生产；重点是在TTS系统申请的码；业务流程：文档编号：GYSJ201710_001页码:40of128公司:北京爱创科技股份有限公司版本:Rev1.0标题:光明乳业追溯服务平台概要设计5.3.4.入出库管理5.3.4.1.入出库上传监控概述：用于检索监控系统处理手持上传的单据处理结果（成功、失败、等待），主要用于发现单据失败时失败单据的原因，可按失败原因进行单据检索，如：重复出库、缺少关联关系等，方便用于第一时间解决单据问题。业务流程：文档编号：GYSJ201710_001页码:41of128公司:北京爱创科技股份有限公司版本:Rev1.0标题:光明乳业追溯服务平台概要设计5.3.4.2.关联关系上传监控概述：用于监控关联关系文件解析状态及文件中追溯码存在的异常，可根据关联关系文件解析状态进行检索查询，如可检索关联关系文件有重复上传的码、无效的码（指的的当前关联关系文件的码在系统中存在，并且父码与系统中的父码不一致），可快速定位生产端的赋码问题信息；业务说明：文档编号：GYSJ201710_001页码:42of128公司:北京爱创科技股份有限公司版本:Rev1.0标题:光明乳业追溯服务平台概要设计5.3.4.3.入出库任务单概述：用于在TTS系统中创建入出库任务单，用于手持或其它终端设备进行扫描出库；业务流程：文档编号：GYSJ201710_001页码:43of128公司:北京爱创科技股份有限公司版本:Rev1.0标题:光明乳业追溯服务平台概要设计5.3.4.4.入出库上传概述：实现将TTS系统支持的关联关系文件、单据文件手动上传到平台并进行处理；业务流程：5.3.4.5.入出库单维护概述：系统解析手持上传的单据信息后，形成单据信息，支持按企业、产品、单号等不同条件进行检索。业务流程：文档编号：GYSJ201710_001页码:44of128公司:北京爱创科技股份有限公司版本:Rev1.0标题:光明乳业追溯服务平台概要设计5.3.4.6.上传文件成功列表概述：提供查看所有上传到TTS的文件，包括单据、关联关系文件；支持文件下载；业务流程：文档编号：GYSJ201710_001页码:45of128公司:北京爱创科技股份有限公司版本:Rev1.0标题:光明乳业追溯服务平台概要设计5.3.5.流向查询5.3.5.1.单码流向查询概述：用于查看追溯码的单据流向信息；信息包括追溯码的基本信息及追溯码的发货流向的单据信息，实现码的正向追踪；追溯码流向查询信息包括：产品的基础信息、奶源信息（奶仓号，原奶批次号，原奶供应商，承运车辆车牌，到厂时间，原奶检测结果，过磅数量，卸奶时间，收奶线，奶仓定容情况，奶仓检测结果，原奶仓储存时间）、巴杀信息（原奶批次，预巴氏号，巴氏运行参数，巴氏起止时间，调奶数量，巴氏存储时间温度，入库时间）、配料列表（调奶量，配料批次号，配料罐号，白糖，稳定剂，原料批次，原奶批次号，投料温度，混料线号，混料时间，定容添加量，定容数量，定容指标）、基料巴氏（菌种活化时间，运行时间，基料巴杀批次，基料巴杀参数，菌种添加数量，添加时间，发酵罐号/数量）信息；根据追溯码可以找到原料信息，包括：原料批次号，原料名称，数量，供应商信息；业务流程：文档编号：GYSJ201710_001页码:46of128公司:北京爱创科技股份有限公司版本:Rev1.0标题:光明乳业追溯服务平台概要设计5.3.5.2.产品批号流向概述：用于查看指定企业、产品在指定生产时间范内的生产的产品的流向信息。业务流程：文档编号：GYSJ201710_001页码:47of128公司:北京爱创科技股份有限公司版本:Rev1.0标题:光明乳业追溯服务平台概要设计5.3.5.3.入出库单查询概述：用户根据输入的条件查询相对应的单据，查看单据的信息，单据类型，往来企业，开单企业，点击明细查看单据的产品信息以及单据所对应的码信息。业务流程：文档编号：GYSJ201710_001页码:48of128公司:北京爱创科技股份有限公司版本:Rev1.0标题:光明乳业追溯服务平台概要设计5.3.5.4.入出库单明细查询概述：用于查询单据的明细并统计当前页的单据信息，并可导出单据的明细。单据出库人员可根据此功能检查出库是否与实际货物一致；业务流程：文档编号：GYSJ201710_001页码:49of128公司:北京爱创科技股份有限公司版本:Rev1.0标题:光明乳业追溯服务平台概要设计5.3.6.预警管理5.3.6.1.预警信息订阅概述：用于系统管理人员设置系统用户接收的预警信息，使相应人员第一时间接收到系统异常并及时处理。业务流程：文档编号：GYSJ201710_001页码:50of128公司:北京爱创科技股份有限公司版本:Rev1.0标题:光明乳业追溯服务平台概要设计5.3.6.2.区域过期产品概述：用于统计指定区域内生产企业所库存产品的过期产品信息，支持预警信息订阅，是企业及时掌握了解库存信息，调整生产；业务流程：文档编号：GYSJ201710_001页码:51of128公司:北京爱创科技股份有限公司版本:Rev1.0标题:光明乳业追溯服务平台概要设计5.3.6.3.企业过期产品概述：用于统计指定企业（经销商）库存的产品信息，使企业及时调整库存减少积压。业务流程：文档编号：GYSJ201710_001页码:52of128公司:北京爱创科技股份有限公司版本:Rev1.0标题:光明乳业追溯服务平台概要设计5.3.6.4.防伪查询预警概述：用于统计防伪码被查询超过指定次数的信息，第一时间通知订阅者及时处理异常信息；业务流程：文档编号：GYSJ201710_001页码:53of128公司:北京爱创科技股份有限公司版本:Rev1.0标题:光明乳业追溯服务平台概要设计5.3.6.5.码重复出库预警概述：用于统计并检索同一码重复扫描出库的信息，用于判断是否是扫描出库错误或是生产时出现异常；业务流程：文档编号：GYSJ201710_001页码:54of128公司:北京爱创科技股份有限公司版本:Rev1.0标题:光明乳业追溯服务平台概要设计5.3.6.6.码不存在预警概述：用于统计出库的产品没有生产信息即没有上传关联关系，提示相关生产企业及时上传生产批次信息。业务流程：5.3.6.7.出库数量预警概述：用于统计任务单中扫描数量与实际出库数量不符的单据信息，即扫描上传的数量小于任务单的计划数量数量时，人工需要手工审核实际出库数量；业务流程：文档编号：GYSJ201710_001页码:55of128公司:北京爱创科技股份有限公司版本:Rev1.0标题:光明乳业追溯服务平台概要设计5.3.6.8.关联关系重码预警概述：用于统计同一个码在不同生产批次中，提示订阅者赋码生产存在问题并及时处理；业务流程：文档编号：GYSJ201710_001页码:56of128公司:北京爱创科技股份有限公司版本:Rev1.0标题:光明乳业追溯服务平台概要设计5.3.6.9.多区域查询预警概述：用于统计同一防伪码在不同区域查询，预警提示假货存在，订阅者需及早关注处理；业务流程：5.3.7.报表统计5.3.7.1.防伪查询统计概述：用于以图表方式统计防伪码被消费者查询的记录信息。业务流程：文档编号：GYSJ201710_001页码:57of128公司:北京爱创科技股份有限公司版本:Rev1.0标题:光明乳业追溯服务平台概要设计5.3.7.2.异地查询日统计概述：用于统计防伪码在发货地与扫描地不同区域查询信息，达到监控防伪窜货的目的；业务流程：文档编号：GYSJ201710_001页码:58of128公司:北京爱创科技股份有限公司版本:Rev1.0标题:光明乳业追溯服务平台概要设计5.3.7.3.扫描查询概述：用于查询指定时间范围内的消费者防伪查询记录信息，显示具体的查询地点，支持信息导出；业务流程：5.3.7.4.非法码查询统计概述：用于统计消费者查询的码不存在于TTS系统中的信息，用图显示；业务流程：文档编号：GYSJ201710_001页码:59of128公司:北京爱创科技股份有限公司版本:Rev1.0标题:光明乳业追溯服务平台概要设计5.3.7.5.假货码查询统计概述：用于统计消费者查询的在TTS系统这设置为假货的码的查询记录信息；业务流程：文档编号：GYSJ201710_001页码:60of128公司:北京爱创科技股份有限公司版本:Rev1.0标题:光明乳业追溯服务平台概要设计5.3.7.6.多区域查询统计概述：用于统计消费者查询的防伪码在不同扫描地的查询信息，用于判断同一防伪码可能存在于不同的销售地区；业务流程：文档编号：GYSJ201710_001页码:61of128公司:北京爱创科技股份有限公司版本:Rev1.0标题:光明乳业追溯服务平台概要设计5.3.8.系统用户账号集成概述：TTS系统支持账号的不同认证方式，用以保证不同类型的用户所需的不同级别的安全认证，确保使用者的数据访问的权限控制；业务流程：5.3.9.稽查5.3.9.1.消费者查询概述：用于提供给消费者查询的防伪查询访问接口，实现消费者所查询产品的真伪判断，支持PC端与手机端防伪查询；业务说明：文档编号：GYSJ201710_001页码:62of128公司:北京爱创科技股份有限公司版本:Rev1.0标题:光明乳业追溯服务平台概要设计5.3.9.2.企业微信稽查概述：用于微信公众号，通过手机扫描产品追溯码，判断产品是否有窜货，实现企业对窜货的管控。微信稽查用于企业稽查人员在线判断产品是否窜货，及时掌握市场流通状态。微信稽查是TTS系统通过微信服务号实现微信扫描追溯码，获取追溯码信息的手机扫描稽查功能，方便稽查管理。业务流程：文档编号：GYSJ201710_001页码:63of128公司:北京爱创科技股份有限公司版本:Rev1.0标题:光明乳业追溯服务平台概要设计5.3.10.业务员巡店5.3.10.1.业务员登记业务员登记指的是将业务员的姓名和手机号录入系统，以此来识别业务员的身份，如果业务员信息在其他平台可以提供，则其他平台可提供相应的业务员获取接口以此免去录入步骤。5.3.10.2.业务员微信绑定业务员在通过微信扫码签到的过程中，首次扫码是需要绑定业务员信息的，只有正确的绑定了业务员身份的微信，才能进行扫码签到巡店。5.3.10.3.门店登记门店登记的过程即为录入门店信息的过程，登记完成之后并提供门店一个唯一的二维码，业务员通过扫描此二维码签到，同样，文档编号：GYSJ201710_001页码:64of128公司:北京爱创科技股份有限公司版本:Rev1.0标题:光明乳业追溯服务平台概要设计如果门店信息在其他平台可以提供，则其他平台可提供相应的门店获取接口以此免去录入步骤。5.3.10.4.门店二维码门店二维码是门店登记完成之后为门店提供的一个唯一的二维码，此二维码记录了门店的信息，业务员通过此二维码扫描签到。首先需要提供二维码申请功能，申请的二维码经过打印之后可绑定到具体的门店。5.3.10.5.签到流程业务员扫描门店二维码之后进入签到页面，点击签到按钮，微信先获取用户签到位置，如果在此门店范围内，即可完成签到，否则不能签到，同一门店一天内只能签到一次。5.3.10.6.统计内容统计内容包括时间段内业务员签到的门店个数、总签到次数、各门店的签到次数签到时间。5.3.11.数据上报数据上报主要实现TTS系统与第三方系统的接口凭证维护，使系统建交互建立安全可靠的机制，同时，系统提供将TTS的数据上报到JPS系统及CDS系统；文档编号：GYSJ201710_001页码:65of128公司:北京爱创科技股份有限公司版本:Rev1.0标题:光明乳业追溯服务平台概要设计5.3.11.1.调用接口凭证维护概述：用于实现TTS系统与第三系统的访问凭证的维护，第三方系统需要使用TTS系统的接口，需要维护接口访问凭证。当TTS系统需要访问第三方系统时，也可维护第三方系统的接口访问凭证信息。业务说明：5.3.11.2.关联关系上报概述：用于将TTS系统的关联关系文件发送到JPS系统，实现指定生产批次的产品做营销活动。业务说明：5.3.11.3.入出库单上报概述：用于将TTS系统的单据信息文件发送到JPS系统，实现指定出库单的产品做营销活动。业务说明：5.3.11.4.申请码上报概述：用于实现将从TTS申请的码数据上报到CDS系统，CDS系统再下发到印刷企业，实现数据无人工接触，确保数据流通安全；文档编号：GYSJ201710_001页码:66of128公司:北京爱创科技股份有限公司版本:Rev1.0标题:光明乳业追溯服务平台概要设计业务说明：5.3.12.系统后台处理服务5.3.12.1.关联关系处理服务关联关系文档定义了各级包装之间码的关系，以及生产批号，生产日期等产品信息。赋码生产线生成结束后就把关联关系文档传给此服务。此服务解析文档，并把生产的码数据更新到数据库中，形成追溯的数据源；关联关系文件支持关系重建，及生产过程中，出现包材损坏，重新更新包材。关联重建包括两种类型:1、支持对现有关系的父码替换(同一种产品赋码不存在新增指定的父码并与当前产品批次相同)；2、支持对不同产品不同批次的关系建立；支持批次禁用后重新生产上传，形成新的生产关系；支持混批，不同生产批次的数据混批重新组托。不支持托盘重复利用；5.3.12.2.出入库单据处理服务出入库单据文档定义了出入库单号、出入库日期、出入库类型、往来企业和出入库的码等信息。各级经营公司把手持扫描枪生成的出入库单文档上传到此服务。此服务解析文档，并生成对应的出入库单数据到数据库中。单据支持按生产批次出库，按自定义出库批号出库及不按批次出库；文档编号：GYSJ201710_001页码:67of128公司:北京爱创科技股份有限公司版本:Rev1.0标题:光明乳业追溯服务平台概要设计5.3.12.3.预警生成服务此服务根据预先定义的各类预警规则完成预警信息生成。可生产过期产品预警，防伪预警，稽查预警；5.3.12.4.窜货服务此服务根据预先定义的各类窜货规则，生成窜货信息。此服务会收集稽查人员和消费者的移动基站信息，手机号，固话号，IP地址等信息为窜货判断提供依据。并生成防伪查询统计报表。5.3.13.系统管理5.3.13.1.系统参数设置概述：用于对系统运行中所必须的配置项的设置，为系统运行的必要项，不可随意修改。业务说明：文档编号：GYSJ201710_001页码:68of128公司:北京爱创科技股份有限公司版本:Rev1.0标题:光明乳业追溯服务平台概要设计5.3.13.2.企业参数设置概述：用于通过全局设置或针对特定企业类型或特定企业进行生产数据或单据进行特殊处理的配置。业务说明:5.3.13.3.单据类型设置概述：用于设置系统识别的单据类型，可根据企业自定义名称设置，同时，可根据业务需要，定义单据的后置类型，用于系统自动实现入出库，如销售出库的后置类型为采购入库等；业务说明：文档编号：GYSJ201710_001页码:69of128公司:北京爱创科技股份有限公司版本:Rev1.0标题:光明乳业追溯服务平台概要设计5.3.13.4.角色信息维护概述：用于建立系统角色，用于给不同级别或类型的用户分配不同的角色。根据角色的划分，达到控制不同用户对系统操作的权限控制，保证数据的安全性。业务说明：文档编号：GYSJ201710_001页码:70of128公司:北京爱创科技股份有限公司版本:Rev1.0标题:光明乳业追溯服务平台概要设计5.3.13.5.操作日志查看概述：TTS系统对数据安全有严格控制，针对每个用户的每个操作，系统将自动记录，用于追踪系统访问用户的路径数据。业务说明5.3.14.接口5.3.14.1.WMS系统对接概述：WMS系统用于光明的仓库入出库，为实现生产数据可追溯，需要将所有的入出库数据上传到TTS中。业务说明5.3.14.2.PDM系统概述：文档编号：GYSJ201710_001页码:71of128公司:北京爱创科技股份有限公司版本:Rev1.0标题:光明乳业追溯服务平台概要设计用于实现一级经销商的产品出库，同时将出库数据上传到TTS系统中，形成可追溯数据。业务说明：5.3.15.ESC系统概述：用于实现生产企业将产品按照指定的包装比例组建关联关系并上传到TTS与WMS系统中。业务说明：5.4.硬件接口见运行环境。5.5.软件接口本系统采用B/S的架构来构建，产品数据管理平台使用三层架构来构建，用户展现层使用ASP.net+Jquery+Ajax+IOC等技术实现页面的展示和与业务层协接，业务层使用CacheDependency和WCF，webService等技术与第三方系统或底层交互；数据管理层使用DBEntry兼容不同数据库及多数据库。整个开发使用C#开发语言.netframework4.0平台；文档编号：GYSJ201710_001页码:72of128公司:北京爱创科技股份有限公司版本:Rev1.0标题:光明乳业追溯服务平台概要设计6.数据结构设计6.1.数据库需求分析为了存储大数据，系统将数据库分成4个数据库：基础数据库，监管码库，文件库以及防伪库。其中基础数据库也是主数据库，监管码库用于存放监管码，文件库用于存储上传的关联关系及单据文件，防伪库用于存储防伪查询信息；对于码数据库，由于数据量大，系统将使用分区（企业版），分库（集团版）技术存储数据6.2.总体数据库架构设计文档编号：GYSJ201710_001页码:73of128公司:北京爱创科技股份有限公司版本:Rev1.0标题:光明乳业追溯服务平台概要设计6.3.数据库概念结构设计文档编号：GYSJ201710_001页码:74of128公司:北京爱创科技股份有限公司版本:Rev1.0标题:光明乳业追溯服务平台概要设计7.运行设计7.1.运行模块的组合模块命名方式按照相应模块结合特性制定。命名方式为Ma和Ma.b，其中a相同的模块即为同类模块。7.2.运行控制本软件流程：先由用户启动登陆模块进入事件驱动模式，由相应的事件分别激活基础信息模块，托盘码管理，库存管理，统计报表模块和系统管理模块等模块，其中用户激活退出事件将退出系统7.3.运行时间一般用户的操作响应时间见上文描述，测试、文档备份、数据的导入和导出操作的时间会相对较长一些，但是操作也应该在可接受的时间内完成，要有界面友好提示。文档编号：GYSJ201710_001页码:75of128公司:北京爱创科技股份有限公司版本:Rev1.0标题:光明乳业追溯服务平台概要设计8.出错处理设计8.1.出错输出信息程序在运行时主要会出现两种错误：1.由于输入信息，或无法满足要求时产生的错误，称为软错误。2.由于其他问题，如网络传输超时等，产生的问题，称为硬错误。对于软错误，须在界面输入时验证输入的信息正确性（有效性，类型等），验证不通过时，及时提示用户进行更正；或者记录系统日志，便于维护人员定位跟踪（服务）。对于硬错误，系统能够提供日志，并将程序重置，返回输入阶段。其中日志尽可能的详细。8.2.出错处理对策努力提高系统健壮性，避免因用户的疏忽对系统造成的损坏；采用对话框的形式为用户提供警告信息；文档编号：GYSJ201710_001页码:76of128公司:北京爱创科技股份有限公司版本:Rev1.0标题:光明乳业追溯服务平台概要设计一些关键操作（eg:删除操作），都应提供确认机制，逻辑删除，记录操作日志；版本文档后对应用程序做好备份管理，以备应用系统由于掉电后部分数据丢失，导致应用程序无法使用。所有的服务器都必须安装不间断电源以防止停电或电压不稳造成的数据丢失的损失。若真断电，可采用SQLServer的日子文件，对其进行rollback处理在硬件方面要选择较可靠，稳定的服务器机种，保证系统运行时的可靠性。文档编号：GYSJ201710_001页码:77of128公司:北京爱创科技股份有限公司版本:Rev1.0标题:光明乳业追溯服务平台概要设计9.安全保密设计对于用户登录根据网络环境，灵活选择基本的登录验证方式还是复杂的验证方式对于用户信息等使用独特的加密算法对这些信息进行加密对于数据库访问，可以选择是否对数据库连接密码进行加密对于数据传输使用SFTP等技术传输数据的加密文档编号：GYSJ201710_001页码:78of128公司:北京爱创科技股份有限公司版本:Rev1.0标题:光明乳业追溯服务平台概要设计10.维护设计作为一个成熟的软件产品，《产品数据管理平台V5.0》软件必须按照面向对象的软件工程的步骤进行开发，并充分考虑软件可维护性，软件的模块划分应满足高内聚、低耦合的特点，同时程序的内部必须有详细的注释和统一的编码格式、按时认真地进行相应文档资料的撰写和备份工作，以利于未来版本升级及移植等二次开发。对于数据库的维护，可使用数据库维护功能机制，例如，定期对数据库进行备份；对于码库，出入库码库这些数据量比较大的数据使用单独数据库、多数据库进行管理，同时使用人工备份的方法及时将不常用的数据放到备份数据库，以保证数据库访问的流畅。文档编号：GYSJ201710_001页码:79of128公司:北京爱创科技股份有限公司版本:Rev1.0标题:光明乳业追溯服务平台概要设计11.欢乐扫设计概述随着移动互联网的兴起和二维码的广泛应用，使得消费者和生产企业的互动多了一条可能、可行而且便捷的沟通渠道。未来通过在每件商品上赋予唯一的二维码，而消费者通过扫描这个二维码，来获得商品信息、企业回馈，使得消费者可以更为方便的了解商品的真伪、产地、生产日期、相关产品以及企业推介等等，同时也可向消费者推荐相关商品，来缩短消费者的购买决策时间。对企业来讲，通过这种方式，可以培养客户忠诚度，增强黏性。目前很少有企业和商品能做到，特别对于快销品而言，根据消费者消费的数量给予相应的回馈，而这对企业和消费者，却是很有合理和有必要的。因此存在重大的创新空白，同时智能手机和二维码的普及，使得这个创新成为可能。欢乐扫便是针对这一空白领域而推出的应用。欢乐扫由两部分构成：面向消费者的智能手机客户端和面向企业的企业门户构成。智能手机客户端，可以让消费者完成扫描二维文档编号：GYSJ201710_001页码:80of128公司:北京爱创科技股份有限公司版本:Rev1.0标题:光明乳业追溯服务平台概要设计码、登录注册、获得积分、兑换奖品、圈内互动和获得商品推介等任务；企业门户为企业提供注册登录、信息维护、商品登录下架、促销策略维护、关联产品维护等等功能。企业通过门户获取到欢乐扫加密过的二维码信息，并通过自动或手动的方式（赋码系统？）将唯一的二维码粘贴、喷印到商品包装上，此二维码可与企业的商品、销售策略绑定。此后，消费者可通过扫描这个二维码获得积分、参与互动等。欢乐扫的主要特点是“扫扫有惊喜”，在用户扫描码后，可获得诸如：积分、抽奖、新闻、天气、笑话、好友等等礼包，增强扫码的趣味性和乐趣，以期增加产品黏性。欢乐扫的技术难点主要在于因为包装材质、赋码方式不同等影响，赋码上有一定技术难度。同时因为巨大的商品数量，后台数据库也要支持海量数据的快速检索、更新。智能手机客户端要具备较高易用性，具备很好客户体验，以便于使用、推广。由于目前微信具有庞大装机量且已具备扫码功能，因此以WebApp的方式可以避免推广自有App的难度和庞大推广成本。功能设计欢乐扫系统由手机WebApp、企业门户、运营门户组成。WebApp运行于支持html5的手机端，可由微信扫描打开，为手机用户提供扫描、登录、交互等功能；企业门户为企业用户提供入口，完成诸如商品信息维护、码下载等功能。运营门户提供企业资质审核及其他系统支持管理服务。文档编号：GYSJ201710_001页码:81of128公司:北京爱创科技股份有限公司版本:Rev1.0标题:光明乳业追溯服务平台概要设计企业门户企业门户供企业用户登录、维护企业信息、商品信息、奖品信息、码信息和营销策略等。11.1.1.注册11.1.1.1.数据结构信息项英文数据类型说明用户名userNameString(200)昵称nickNameString(200)密码passwordString(50)手机mobileNumNumber(20)创建时间createTimeDatetime文档编号：GYSJ201710_001页码:82of128公司:北京爱创科技股份有限公司版本:Rev1.0标题:光明乳业追溯服务平台概要设计最后登录时间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的接口地址TTSIdttsIdStringTTS的授权IdTTSSecretttsSecretStringTTS授权码营业执照号码licenseNoString(50)营业执照照片licenseImgUrlString(50)注册人身份证号idCardNumString(50)注册人手持身份证照片idCardImgUrlString(50)创建时间createTimeDatetime状态statusInt待审核；正常；冻结简介descString(500)企业信息信息项数据类型说明微信号wxNoString(50)文档编号：GYSJ201710_001页码:83of128公司:北京爱创科技股份有限公司版本:Rev1.0标题:光明乳业追溯服务平台概要设计名称nameString(50)原始idwxidString(50)AppIdappIdString(50)AppSecretappSecretString(50)企业用户IDcorpUserIdString(50)关联corpUser表的_id微信帐号11.1.1.2.界面设计文档编号：GYSJ201710_001页码:84of128公司:北京爱创科技股份有限公司版本:Rev1.0标题:光明乳业追溯服务平台概要设计企业审核通过后登陆，如无相关微信帐号信息，将跳转到微信信息维护界面。文档编号：GYSJ201710_001页码:85of128公司:北京爱创科技股份有限公司版本:Rev1.0标题:光明乳业追溯服务平台概要设计如尚无审核提交微信信息后，则提示用户等待审核。11.1.2.产品11.1.2.1.分类商品按照类别进行管理，类别是树状结构，支持多级分类。信息项数据类型说明名称String(50)编码String(20)WbS码String(20)层次结构码，形如001.002，以此形成树状结构所属企业IdString(50)创建时间Datetime文档编号：GYSJ201710_001页码:86of128公司:北京爱创科技股份有限公司版本:Rev1.0标题:光明乳业追溯服务平台概要设计11.1.2.2.产品列表产品品信息维护企业自有产品。信息项数据类型说明名称nameString(200)编码codeString(50)规格specString(50)图片地址imageUrlString(200)简介descString(500)所属类别categoryCodeString(20)使用类别的wbsCode创建时间createTimeDatetime状态statusInt上架、下架、冻结计量单位unitString(20)所属企业IdcorpIdString(50)文档编号：GYSJ201710_001页码:87of128公司:北京爱创科技股份有限公司版本:Rev1.0标题:光明乳业追溯服务平台概要设计产品列表产品信息11.1.3.奖品奖品模块维护企业为营销设置的奖品、收集卡及由其组成的礼包。礼包也可包含积分。收集卡是指，由一系列卡片组成的集合，如十二生肖卡，消费者可收集一套此卡，来兑换文档编号：GYSJ201710_001页码:88of128公司:北京爱创科技股份有限公司版本:Rev1.0标题:光明乳业追溯服务平台概要设计一个奖品。11.1.3.1.数据结构信息项数据类型说明名称nameString(200)编码codeString(50)数量numint单位unitString(20)是否关联产品isProductUsedbool关联产品IdproductIdString(50)图片地址imageUrlString(200)简介descString(500)物流类型deliverTypeint虚拟或实物（需配送）创建时间createTimeDatetime所属企业IdcorpIdString(50)奖品信息(prizes)信息项数据类型说明名称nameString(200)编码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}}文档编号：GYSJ201710_001页码:89of128公司:北京爱创科技股份有限公司版本:Rev1.0标题:光明乳业追溯服务平台概要设计礼包信息(package)礼包-奖品明细信息项数据类型说明名称nameString(200)编码codeString(50)单位unitString(20)图片地址imageUrlString(200)简介descString(500)卡片cardsArray此集合包含的所有卡片id数组创建时间createTimeDatetime所属企业IdcorpIdString(50)收集卡(cardSets)信息项数据类型说明名称nameString(200)图片地址imageUrlString(200)简介descString(500)所属卡片idsetIdString(50)卡片(card)文档编号：GYSJ201710_001页码:90of128公司:北京爱创科技股份有限公司版本:Rev1.0标题:光明乳业追溯服务平台概要设计11.1.3.2.界面设计奖品列表编辑奖品文档编号：GYSJ201710_001页码:91of128公司:北京爱创科技股份有限公司版本:Rev1.0标题:光明乳业追溯服务平台概要设计收集卡列表收集卡文档编号：GYSJ201710_001页码:92of128公司:北京爱创科技股份有限公司版本:Rev1.0标题:光明乳业追溯服务平台概要设计收集卡弹出页礼包列表文档编号：GYSJ201710_001页码:93of128公司:北京爱创科技股份有限公司版本:Rev1.0标题:光明乳业追溯服务平台概要设计编辑礼包文档编号：GYSJ201710_001页码:94of128公司:北京爱创科技股份有限公司版本:Rev1.0标题:光明乳业追溯服务平台概要设计礼包弹出页11.1.4.乐码条码（二维码）信息是系统核心，其它应用需要围绕码信息来完成。企业可以定制自己的码格式和外部链接。乐码使用的二维码是带网址格式，此网址可以欢乐扫的通用网址也可以是企业的自有网址。如果使用欢乐扫的通用网址，则乐码中需要含有3位的49进制企业编码。49进制码是指由如下数字和字母构成：{\'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\'}文档编号：GYSJ201710_001页码:95of128公司:北京爱创科技股份有限公司版本:Rev1.0标题:光明乳业追溯服务平台概要设计对雪花啤酒而言，需生成内外码相互匹配。内码印刷于瓶盖内，带链接二维码格式，外码为数字码。外码内码相补。生成的码可以生成txt格式用于下载、印刷。11.1.4.1.数据结构信息项数据类型说明批号batchNoString(200)由系统自动生成，各位为时间201410140122(年月日时分)地区areaCodeString(50)国内行政区域代码。类别categoryCodeString(20)产品分类wbs编码，如使用单一产品，则为空产品productIdString(50)产品Id。如使用产品分类，则为空起始startNumint截至endNumint印刷厂IdprintingPressIdString(50)有无必要？创建时间createTimeDatetime所属企业IdcorpIdString(50)乐码批次(batchs)11.1.4.2.界面设计文档编号：GYSJ201710_001页码:96of128公司:北京爱创科技股份有限公司版本:Rev1.0标题:光明乳业追溯服务平台概要设计乐码列表乐码信息11.1.5.活动企业可创建营销活动，设置奖品等优惠，促使消费者购买、扫码、参与互动和收集消费者信息。营销活动是欢乐扫的核心内容，你扫我扫都欢乐，企业与消费者皆大欢喜。活动的可变条件有：人、时、地、物、码，其含义是根据扫描用户、扫描时间、所在区域、所扫产品、所扫码的不同而不同。考虑实现的复杂性和对企业的实用性，目前活动根据时、地、物不同条件而触发，也即应用于某个时段、某个行政区域和某些产品。多个活动之间可能出现重叠，如在江苏和无锡区域同时创建活动，江苏省包含了无锡时。重叠活动将使用最小优先策略，也即时段最小、区域最小和产品品类最为明确的活动为消费者所参加活动。活动的中奖类型有：抽奖、累计、集卡、幸运数、先到先得和扫即得。1、抽奖：设置一个中奖概率，扫描时可随机抽奖，奖励有一等奖、二等奖等，奖完为止。2、累计：设置一个数量，当消费者扫描一定数量乐码后，则给予奖励。3、集卡文档编号：GYSJ201710_001页码:97of128公司:北京爱创科技股份有限公司版本:Rev1.0标题:光明乳业追溯服务平台概要设计收集一组卡片，集满有奖4、幸运数设置几个幸运数字，当消费者扫描的排位是这个数字时，给予奖励5、先到先得设置几个数字，如前100位给予奖励，前200位给予奖励6、扫即得只要扫描，即可获得奖励。中奖条件不同，但中奖类型不同的活动可互相重叠。如在无锡同时创建“抽奖”和“累计”两种类型的活动，则消费者扫描时，将会进行抽奖，同时这次扫描也将累计入扫描数量。11.1.5.1.数据结构信息项数据类型说明名称nameString(200)区域areaCodeString(50)国内行政区域代码。类别categoryCodeString(20)产品分类wbs编码，如使用单一产品，则为空产品productIdString(50)产品Id。如使用产品分类，则为空开始时间startTimeDateTime结束时间endTimeDateTime起始startNumint截至endNumint抽奖形式luckyTypeString(20)抽奖(draw)，累计(count)，集卡(collect)，幸运数（number），先到先得(first)，扫即得（come）抽奖设置settings子文档根据抽奖形式不同而不同。创建时间createTimeDatetime所属企业IdcorpIdString(50)文档编号：GYSJ201710_001页码:98of128公司:北京爱创科技股份有限公司版本:Rev1.0标题:光明乳业追溯服务平台概要设计活动(activities)信息项数据类型说明中奖概率probalititydouble小数，中奖概率优先级piorityString(20)从小到大(little)从大到小(big)随机(random)奖励rewardsArray奖励数组活动-抽奖信息项数据类型说明奖品类型typeString(20)奖品(prize),礼包(package)，积分(point)，卡片(card)奖励rewardObject这些字段与奖品类型对应奖品Id,数量，剩余数量礼包Id,数量，剩余数量积分数量卡片Id,数量，剩余数量活动-抽奖-奖励信息项数据类型说明数量amountint奖品类型typeString(20)同上奖励rewardObject同上活动-累积-奖励（数组，一个活动可有多个累积式奖品）信息项数据类型说明卡组idsetIdString(20)奖品类型typeString(20)同上奖励rewardString(50)同上活动-收集卡-奖励文档编号：GYSJ201710_001页码:99of128公司:北京爱创科技股份有限公司版本:Rev1.0标题:光明乳业追溯服务平台概要设计信息项数据类型说明幸运数numberint奖品类型typeString(20)同上奖励rewardObject同上活动-幸运数-奖励（可设置多个吉祥数）活动-先到先得-奖励（数组，可多个）信息项数据类型说明排位数numberint奖品类型typeString(20)同上奖励rewardObject同上活动-扫即得-奖励信息项数据类型说明奖励rewardObject同上11.1.5.2.界面设计活动列表文档编号：GYSJ201710_001页码:100of128公司:北京爱创科技股份有限公司版本:Rev1.0标题:光明乳业追溯服务平台概要设计基本信息条件设置文档编号：GYSJ201710_001页码:101of128公司:北京爱创科技股份有限公司版本:Rev1.0标题:光明乳业追溯服务平台概要设计中奖设置11.1.6.礼品企业的消费者可以将获得的企业积分用于兑换企业提供的礼品上。消费者可以从多个企业获得积分，所谓企业积分就是特指某企业的积分。A企业的积分只能用于兑换A企业提供的礼品。信息项数据类型说明名称nameString(200)物流类型deliverTypeint虚拟或实物（需配送）开始时间startTimeDateTime结束时间endTimeDateTime数量numint礼品的最大数量；如果没有上限，设置为-1剩余数量remainedNumint剩余数量所需积分pointsint兑换所需积分图片地址imageUrlString(200)文档编号：GYSJ201710_001页码:102of128公司:北京爱创科技股份有限公司版本:Rev1.0标题:光明乳业追溯服务平台概要设计描述descriptionString(500)创建时间createTimeDatetime所属企业IdcorpIdString(50)礼品(gifts)文档编号：GYSJ201710_001页码:103of128公司:北京爱创科技股份有限公司版本:Rev1.0标题:光明乳业追溯服务平台概要设计11.1.7.订单消费者参加活动中得的奖品和积分兑换的礼品，可以进行领取。对需要物流配送的奖品、礼品，如果消费者领取，则需要提供收获地址，确认后，企业门户生成一个配送订单。订单状态有：未确认、已确认、已发货、已签收、已取消四个状态。订单生成默认状态为“未确认”，企业发货人员点击“确认”按钮，表示确认订单，但尚未发货，订单置为“已确认”状态。“已确认”的订单，点击“发货”按钮，表示订单的货物已经发送，订单置为“已发货”状态。“已发货”的订单，点击“签收”按钮，表示消费者已收到货物，订单置为“已签收”状态。“已签收”的订单，点击“退货”按钮，表示消费者发现货物质量问题，要求退货并重新发货，订单置为“已退货”状态。“已退货”的订单，可点击“发货”按钮，重新进入发货流程。所有订单的操作，都记录订单日志，并可查看。信息项数据类型说明订单号orderNoString(50)订单流水号用户iduserIdString(50)创建时间createTimeDatetime物品类型goodTypeString(50)订单的物品类型，’prize’，奖品；’gift’，礼品物品IdgoodIdString(50)如果为奖品，则为prizeId；如果是礼品，则为giftId收获地址IdaddressIdString(200)消费者填写的收获地址，都会加入到消费者的地址列表中，其下次就不必再次填写。收获地址Id即为所选地址文档编号：GYSJ201710_001页码:104of128公司:北京爱创科技股份有限公司版本:Rev1.0标题:光明乳业追溯服务平台概要设计订单状态statusString(50)已提交，‘committed’已确认，’submitted’已发货，’shipped’已签收，’received’已退货，’returned’备注memoString(500)操作人员可以记录简短备注，已便于自己处理订单订单(orders)信息项数据类型说明订单号orderNoString(50)订单流水号操作人员IdoperatorIdString(50)企业操作人员Id时间operateTimeDatetime描述descriptionString(500)订单日志(orders)文档编号：GYSJ201710_001页码:105of128公司:北京爱创科技股份有限公司版本:Rev1.0标题:光明乳业追溯服务平台概要设计11.1.8.管理11.1.8.1.区域待讨论。建议以行政区域即可，没必要像TTS一样搞区域管理11.1.8.2.企业用户建议一个企业一个用户即可，没必要引入多用户管理11.1.8.3.权限多用户都不要了，权限更没用11.1.8.4.用户中奖列表查看用户中奖情况。11.1.8.5.用户列表查看用户信息。用户指使用智能手机端参加企业活动的用户。文档编号：GYSJ201710_001页码:106of128公司:北京爱创科技股份有限公司版本:Rev1.0标题:光明乳业追溯服务平台概要设计11.1.9.设置待定手机端手机端实现扫码、中奖、奖品查看、奖品打包、奖品转移、个人信息等功能。因为手机端面向消费者，因此要求其界面简洁美观，操作简单。信息项数据类型说明用户iduserIdString(50)用户名userNameString(50)密码passwordString(50)昵称nickNameString(50)性别sexString(1)手机号mobileString(50)QQ号qqString(50)注册时间regTimeString(50)注册IPregIpString(50)登录时间loginTimeString(50)登录IPloginIpString(50)文档编号：GYSJ201710_001页码:107of128公司:北京爱创科技股份有限公司版本:Rev1.0标题:光明乳业追溯服务平台概要设计微信openidopenidString用户状态statusString(1)0未完善信息1正常2锁定密码混淆saltString(50)消费者用户(users)11.1.10.扫码中奖1、消费者扫描二维码时，获得消费者扫描时间、区域和码内容。2、查询系统有无此码，查询是否扫描过。3、并根据这些条件查询相关活动。4、按照最小匹配原则，获得一个或多个消费者可以参与的活动，按照活动定义，确定消费者是否中奖。5、消费者可同时获得多个活动奖品。信息项数据类型说明用户iduserIdString(50)用户类型userTypeString消费者（consumer）,企业（corpUser）,门店（shopkeeper）扫描时间scanTimeString(50)IP地址ipString(50)区域代码areaInfoString(20)码全内容fullcodeString(200)包含网址的二维码呢绒码内容codeString(20)仅码本身是否第一次isFirstbool对应产品信息productstring参与活动activitiesArray活动Id数组（如果有）奖励rewardsArray每个活动所得奖励（如果有）[activityId:reward]参加活动奖品类型进行定义扫码日志(scanLog)文档编号：GYSJ201710_001页码:108of128公司:北京爱创科技股份有限公司版本:Rev1.0标题:光明乳业追溯服务平台概要设计部分活动需记录用户活动完成状态，如累计和集卡。信息项数据类型说明用户iduserIdString(50)活动IdactivityIdString(50)活动类型activityTypeString(50)累计(count)，集卡(collect)状态state子文档累计式活动记录已累积数量:{num:3}集卡式任务记录已收集卡片：{cardId1:0,cardId2:2}所有卡片数量都大于1时，可以兑奖我的活动状态(userActivityStates)文档编号：GYSJ201710_001页码:109of128公司:北京爱创科技股份有限公司版本:Rev1.0标题:光明乳业追溯服务平台概要设计如果消费者中奖，则打开“宝箱“界面，点击“宝箱”，则可查看各个活动所中奖品。礼包类奖品，在消费者获得时即打开，并进行业务逻辑判断，如十二生肖卡是否集满；如果礼包内还有礼包，则陆续打开。文档编号：GYSJ201710_001页码:110of128公司:北京爱创科技股份有限公司版本:Rev1.0标题:光明乳业追溯服务平台概要设计文档编号：GYSJ201710_001页码:111of128公司:北京爱创科技股份有限公司版本:Rev1.0标题:光明乳业追溯服务平台概要设计抽奖活动对应于刮刮乐，其它抽奖形式使用礼品卡。11.1.11.积分商城积分商城展示企业添加的礼品，这些礼品可以用此企业的积分兑换；兑换获得的礼品，可以进行领取文档编号：GYSJ201710_001页码:112of128公司:北京爱创科技股份有限公司版本:Rev1.0标题:光明乳业追溯服务平台概要设计11.1.12.我的奖励消费者中奖后，其中奖信息存储入数据库，包含如奖品、礼包等所有奖励。用户获得的奖励有实物、虚拟、积分3种，虚拟是指如QQ币、充值类等在线即可完成交易的物品；实物指需要进行物流配送的物理货物。奖励的领取方式有3种：在线交易、乐券转移与物流配送。1、在线领取。虚拟类的物品，调用第三方接口即可兑现消费者的奖励，如手机充值。2、乐券转移。乐券转移是指使用欢乐扫提供的二维码，前往门店、经销商等可以提供实物交易的场所，实现乐券与实物的交换。3、物流配送。物品由企业提供，且需要企业使用物流将货物发送到消费者手中。信息项数据类型说明所有人IdownerIdString(50)所有人类型ownerTypeString消费者（consumer）,企业（corpUser）,门店（shopkeeper）活动IdactivityIdString(50)获得时间getTimeDateTime文档编号：GYSJ201710_001页码:113of128公司:北京爱创科技股份有限公司版本:Rev1.0标题:光明乳业追溯服务平台概要设计奖品类型typeString(20)奖品(prize),积分(point)，卡片(card)奖励rewardObject这些字段与奖品类型对应奖品Id积分卡片Id日志IdscanningIdString扫描日志的id乐券IdcouponIdString状态statusString(20)正常(normal)，已打包(isBaged)我的奖励(userRewards)奖品、产品、礼包可打包为包裹，包裹本身也可再次打包。11.1.12.1.我的奖品我的奖品展示用户的所有奖品。文档编号：GYSJ201710_001页码:114of128公司:北京爱创科技股份有限公司版本:Rev1.0标题:光明乳业追溯服务平台概要设计11.1.12.2.我的卡片收集成为一个卡组的卡片自动从列表中消失，此外无不同。11.1.12.3.我的包裹已打包的物品，不在参与业务逻辑。如十二生肖一张卡片被放入包裹，则除非其解开，否则不认为十二生肖集满。已打包的物品可与普通奖品一样，进行乐券扫描转移。信息项数据类型说明名称nameString所有人ownerIdString所有人类型ownerTypeString消费者（consumer）,企业（corpUser）,门店（shopkeeper）创建时间createTimeDateTime包裹内容rewardsArray子文档，包裹中对应的文档编号：GYSJ201710_001页码:115of128公司:北京爱创科技股份有限公司版本:Rev1.0标题:光明乳业追溯服务平台概要设计[{type:reward,urId:0x},{type:bag,bagId:033}]乐券IdcouponIdString状态statusString(20)正常(normal)，打包(isBaged)我的包裹(userBags)11.1.12.4.我的礼品展示消费者通过积分兑换获得的礼品；礼品可以进行领取文档编号：GYSJ201710_001页码:116of128公司:北京爱创科技股份有限公司版本:Rev1.0标题:光明乳业追溯服务平台概要设计11.1.12.5.我的订单消费者可以查看已要求发货的订单，以及查看订单的状态。文档编号：GYSJ201710_001页码:117of128公司:北京爱创科技股份有限公司版本:Rev1.0标题:光明乳业追溯服务平台概要设计11.1.12.6.我的信息“我的信息”展示消费者的个人信息。文档编号：GYSJ201710_001页码:118of128公司:北京爱创科技股份有限公司版本:Rev1.0标题:光明乳业追溯服务平台概要设计11.1.12.7.乐券每个奖品、卡片、包裹都有一个乐券，此乐券可用于转移。乐券有3分钟有效期，过期后需重新打开。可打开奖品、包裹、卡片的乐券，其他人扫描后，此乐券即由现拥有人转移到扫描人。信息项数据类型说明奖品类型typeString(20)奖励(reward)包裹(bag)创建时间createTimeDateTime关联IdtargetObject如果为奖品、礼包和产品，则对应userRewards，userRewardId如果为包裹，则对应userBags中bagId{type:reward,urId:0xdd}乐券（coupons）文档编号：GYSJ201710_001页码:119of128公司:北京爱创科技股份有限公司版本:Rev1.0标题:光明乳业追溯服务平台概要设计信息项数据类型说明奖励idrewardIdString原用户fromUserIdString(50)新用户toUserIdString(50)转移时间transTimeDateTimeIP地址ipString(50)区域areaInfoString(20)转移日志(transLog)信息项数据类型说明乐券idcouponIdString用户IduserIdString用户类型ownerTypeString消费者（consumer）,企业（corpUser）,门店（shopkeeper）扫描时间scanTimeDateTimeIP地址ipString(50)区域areaInfoString(20)乐券扫描日志(couponLog)文档编号：GYSJ201710_001页码:120of128公司:北京爱创科技股份有限公司版本:Rev1.0标题:光明乳业追溯服务平台概要设计手机端-渠道用户渠道用户是指生产企业与消费者之间的经销商，在这里主要指终端门店（如餐馆、夜店等）。这些经销商负责给消费者兑换奖品，并向上游企业上报。11.1.13.渠道注册渠道用户需要注册，提交其信息后，由运营端审核后，进行正常业务操作。信息项数据类型说明店名nameString(50)地址addrString(50)营业执照号码licenseNoString(50)营业执照图片licenseImgUrlString(20)店长名keeperString(200)密码passwordString(20)身份证号idNoString手机号mobileNumString状态statusint0，待审核；1，正常门店（shop）文档编号：GYSJ201710_001页码:121of128公司:北京爱创科技股份有限公司版本:Rev1.0标题:光明乳业追溯服务平台概要设计11.1.14.店员注册渠道所属的店员可自行注册，注册的方式是由扫描店长提供的二维码，打开注册页面，进行注册。注册后的店员归属于此店，由店长进行管理。信息项数据类型说明名称nameString(50)密码passwordString(50)照片地址picUrlString(50)创建时间createTimeDateTime所属门店shopIdString(20)状态statusStringnormal,正常；deleted删除；locked，冻结11.1.15.店员管理店长可对所属店员进行新增、修改、删除、重置密码等操作。11.1.16.扫描乐码店员（及店长）可以扫描瓶盖，以对其销售产品进行统计，用于此后的销量凭证等。11.1.17.兑奖店员（店长）可扫描消费者中奖的乐券，并将奖品兑换给消费者，此后此乐券转移给此门店，消费者的乐券失效。店长也可将此乐券转移给其他渠道用户。11.1.18.销量报表（店员）店员销量统计店员的销售状况，此表数据在店员扫码时更新，虽然此数据可由扫描日志统计出来，但考虑性能，使用此表查询为宜。信息项数据类型说明店员idsalesmanIdString门店idshopIdString文档编号：GYSJ201710_001页码:122of128公司:北京爱创科技股份有限公司版本:Rev1.0标题:光明乳业追溯服务平台概要设计产品IdproductIdString数量amountint店员销量表（salesmanSales）11.1.19.销量报表（店长）统计门店的销量，数据从店员销量表中得到。11.1.20.记账单渠道用户需要向上下游兑换，提供记账单功能以便其进行统计。运营端运营端负责对生产企业、渠道客户的管理，并且管理通用的印刷厂及喷码设备等。生产企业和渠道客户均需在运营端审核后方可正常业务操作。文档编号：GYSJ201710_001页码:123of128公司:北京爱创科技股份有限公司版本:Rev1.0标题:光明乳业追溯服务平台概要设计11.1.21.生产企业待审核企业列表文档编号：GYSJ201710_001页码:124of128公司:北京爱创科技股份有限公司版本:Rev1.0标题:光明乳业追溯服务平台概要设计审核生产企业11.1.22.渠道客户渠道客户是指，在生产企业产品流通过程中的批发商、经销商等，其在系统中起到承上启下的作用。渠道客户也需经过审核才能进行正常业务操作。文档编号：GYSJ201710_001页码:125of128公司:北京爱创科技股份有限公司版本:Rev1.0标题:光明乳业追溯服务平台概要设计渠道客户列表渠道客户审核文档编号：GYSJ201710_001页码:126of128公司:北京爱创科技股份有限公司版本:Rev1.0标题:光明乳业追溯服务平台概要设计11.1.23.喷码机目前与喷码机通讯协作方式不明，待讨论后细化。11.1.24.印刷厂需与客户及喷码厂商讨论后细化与TTS接口欢乐扫可以单独部署，也可能与TTS联合部署。如果与TTS联合部署，则需要考虑基础数据的整合与单点登录。是否与TTS联合部署，可在系统设置中予以配置。11.1.25.欢乐扫接口调用欢乐扫接口前，TTS需要登录以获取令牌。令牌过期时间为3分钟，如3分钟内无持续访问，则过期；如有访问，其过期时间从访问时间期为3分钟。urlhttp://lsa0.cn/getToken.php方法get参数ttsId,ttsSecret返回值token，字符串，用于此后访问例子http://lsa0.cn/getToken.php?ttsId=232343&ttsSecret=sfsdfsdf令牌获取接口urlhttp://lsa0.cn/corpNew.php?token=23232说明在欢乐扫中新增一个企业方法post参数{name:’’,address:’’,contact:’’,mail:’’,phoneNum:’’}返回值成功：文档编号：GYSJ201710_001页码:127of128公司:北京爱创科技股份有限公司版本:Rev1.0标题:光明乳业追溯服务平台概要设计{corpId:’’}失败：{errorNo:int,errorMsg:’’}urlhttp://lsa0.cn/corpUpdate.php?token=23232方法post参数{corpId:’’,name:’’,address:’’,contact:’’,mail:’’,phoneNum:’’}返回值成功：{code:0}失败：{errorNo:int,errorMsg:’’}urlhttp://lsa0.cn/corpDelete.php?token=23232方法post参数{corpId:’’}返回值成功：{code:0}失败：{errorNo:int,errorMsg:’’}urlhttp://lsa0.cn/corpSetAdmin.php?token=23232文档编号：GYSJ201710_001页码:128of128公司:北京爱创科技股份有限公司版本:Rev1.0标题:光明乳业追溯服务平台概要设计方法post参数{corpId:’’,adminId:’’}返回值成功：{code:0}失败：{errorNo:int,errorMsg:’’}11.1.26.单点登录如果设置了与TTS的联合部署，则TTS创建企业时，则调用欢乐扫接口，同时创建欢乐扫中企业并指定用户为欢乐扫企业管理员。此管理员可同时登录欢乐扫与TTS。欢乐扫系统中引用一段TTS脚本，用以获取TTS的cookie信息，形如：<scriptsrc=http://tts/sso.js></script>TTS的脚本负责读取自身域名的cookie信息，并为欢乐扫的js变量：tts.corpId,tts.adminId赋值，欢乐扫使用这两个变量来验证用户的有效性。同样欢乐扫提供TTS脚本，用于读取TTS所给cookie信息，TTS需定义所需变量。11.1.27.数据接口欢乐扫需要TTS提供以下数据接口：1、用户登录验证用户登录时，欢乐扫将信息提交到TTS进行验证，如果是合法用户，则给予cookie验证信息。2、产品获取接口如果与TTS联合部署，欢乐扫将不维护产品信息，而从TTS系统实时获取包括类别在内的此类信息。