青岛地铁APP概要设计说明书.doc

建投数据科技（山东）有限公司青岛地铁APP概要设计说明书修订记录编号章节号内容简述修订日期版本号修订人1初版2018/2/27V1.0吴芳2新增二阶段功能模块设计2018/3/28V2.0吴芳1建投数据科技（山东）有限公司3修改志愿者功能模块设计2018/5/10V2.1吴芳456789101112132建投数据科技（山东）有限公司目录1目的..............................................................................................................................................................................12项目背景.........................................................................................................................................................13术语定义.........................................................................................................................................................14设计概述.........................................................................................................................................................24.1目标..................................................................................................................................................................24.2设计原则..........................................................................................................................................................35系统概述.........................................................................................................................................................46系统总体结构..................................................................................................................................................46.1平台架构..........................................................................................................................................................46.2功能架构..........................................................................................................................................................56.2.1功能逻辑.....................................................................................................................................................57功能模块.........................................................................................................................................................67.1应用管理..........................................................................................................................................................67.1.1应用列表.....................................................................................................................................................67.1.2应用编辑.....................................................................................................................................................67.2地铁资讯..........................................................................................................................................................77.2.1列表展示.....................................................................................................................................................77.2.2资讯详情.....................................................................................................................................................77.2.3点赞.............................................................................................................................................................77.2.4分享.............................................................................................................................................................77.2.5收藏.............................................................................................................................................................87.3投票..................................................................................................................................................................87.3.1客户端功能描述.........................................................................................................................................87.3.2投票新增与修改.........................................................................................................................................87.4义务监督员......................................................................................................................................................97.4.1客户端功能描述.........................................................................................................................................97.4.2义务监督员申请.........................................................................................................................................97.4.3义务监督员管理.......................................................................................................................................107.5志愿者............................................................................................................................................................127.5.1问题上报...................................................................................................................................................127.5.2任务集市...................................................................................................................................................127.6乘客服务........................................................................................................................................................137.6.1车站设施...................................................................................................................................................137.6.2乘车安全...................................................................................................................................................137.6.3票务信息...................................................................................................................................................137.6.4出行指南...................................................................................................................................................137.6.5常见问题...................................................................................................................................................147.6.6意见反馈...................................................................................................................................................147.6.7地铁热线...................................................................................................................................................147.7在线购票........................................................................................................................................................147.7.1订单创建...................................................................................................................................................147.7.2支付...........................................................................................................................................................167.7.3退票...........................................................................................................................................................177.7.4取票...........................................................................................................................................................187.7.5我的车票...................................................................................................................................................207.8乘车码............................................................................................................................................................207.8.1认证...........................................................................................................................................................203建投数据科技（山东）有限公司7.8.2进站/出站.................................................................................................................................................217.8.3乘车记录...................................................................................................................................................257.8.4自助补站...................................................................................................................................................267.9个人中心........................................................................................................................................................277.9.1个人中心信息查看...................................................................................................................................277.9.2我的收藏...................................................................................................................................................287.9.3地铁热线...................................................................................................................................................287.9.4我的积分...................................................................................................................................................287.9.5消息免打扰...............................................................................................................................................287.9.6登录...........................................................................................................................................................287.10管理后台........................................................................................................................................................288外部接口.......................................................................................................................................................298.1乘车码数据结构............................................................................................................................................298.2数据加密签名规则........................................................................................................................................298.3数据处理过程................................................................................................................................................309运行环境.......................................................................................................................................................319.1.1系统运行环境...........................................................................................................................................319.1.2硬件平台...................................................................................................................................................314建投数据科技（山东）有限公司1目的本文档是《青岛地铁APP项目》的总体设计和实现说明，包括程序系统的基本处理流程、程序系统的组织结构、模块划分、功能分配、运行设计和出错处理设计等,记录了系统整体实现上技术层面上的考虑，为程序的详细设计工作提供基础。同时该文档将作为产品实现、特性要求和控制的依据。2项目背景随着生活水平的提高，人们对出行的便利性的要求也越来越高。越来越多的人使用各类APP来获取交通出行信息，如导航信息、交通状况信息、交通路线规划、服务预定以及与亲朋好友在线互动，地铁出行更不例外。青岛地铁的管理者和乘客们都渴望着有一款快捷方便、智能高效、简单易用的APP来帮助大家提高出行体验，打造更加舒适便捷的地铁生活。为满足移动互联网时代下的乘客需求，积极顺应“互联网+”的大环境，整合资源优势，搭建一套完善地移动端服务体系，预开发青岛地铁APP，以实现包含8号线在内的地铁线网高效快捷的资讯管理和运营，为用户提供及时可靠的出行信息服务，通过地铁商城为地铁用户提供精准的商城服务，并打造用户与青岛地铁之间的即时、高效、科学地互动，打造“互联网+地铁”的服务新业态。通过建立和完善青岛地铁手机APP，为乘客创建方便快捷的乘车体验，提供丰富的资讯资讯和乘车信息，连接地铁周边商铺，打造地铁周边生活圈。为地铁运营方提供便捷的信息发布渠道，建立与用户沟通的桥梁。通过资讯等信息的发布，宣传青岛地铁和青岛文化。3术语定义英文缩写中英文全称ACC清分中心(AFCClearingCenter)AFC自动售检票(AutomaticFareCollection)AGM自动检票机(AutomaticGateMachine)半自动(票房)售票机(BookingOfficeMachine)1建投数据科技（山东）有限公司BOMCAD计算机辅助设计(ComputerAidedDesign)CS时钟系统(ClockSystem)ECU电子控制单元/主控单元(ElectronicControlUnit)EnG进站检票机(EntryGate)ExG出站检票机(ExitGate)IP国际防护标准(InternationProtection)ITP互联网票务平台(InternetTicketingPlatform)LCC线路中央计算机系统(LineCentralComputer)4设计概述4.1目标在青岛地铁APP功能上，主要规划了乘车服务、地铁资讯、地铁生活、地铁安全、志愿服务、个人中心、管理后台七大部分功能类别，以将“地铁乘客”转换为“地铁用户”，提升地铁品牌价值和服务形象。4.2设计原则可扩展性在整个系统的设计和研发过程中，必须要支持在扩展能力上的要求。扩展性主要体现在两个方面：一个是水平扩展能力，系统的运行和推广过程中必然是逐步扩大化的过程，将来扩展到青岛地铁的合作客户和合作伙伴的时，用户量2建投数据科技（山东）有限公司必将大范围扩张，因此从系统的架构设计上必须要能够支持这种用户量的扩张要求。垂直扩展性上，非常重视青岛地铁未来业务的移动化发展，保留对青岛地铁业务的移动化整合的空间。因此在架构设计上考虑到如何动态的扩展青岛地铁业务的集成能力，能够在统一通信平台基础上整合更多的企业业务，实现业务的信息沟通和移动办理需求。稳定性在整个系统的设计和工程实施中严格遵循轨道交通行业相关的国际和国家标准，同时也遵循国家相关软件项目实施方案中的要求和标准。系统采用的信息分类编码、网络通信协议和数据接口标准严格执行国家有关标准和行业标准。系统的设计、开发、建设完全遵循国家和国际相关的技术标准规范，且对信息系统建设和信息安全管理的有关要求。安全性在充分利用已有安全条件的基础上，从应用系统本身在设计和实现中确保系统安全性，保护系统数据的安全性。同时整个系统具有良好的安全管理功能能够实现从数据库存储、检索、提取、入库、发布、管理等各个层面和角度都具有相应的安全机制。在系统架构设计、系统软硬件平台选择以及应用系统开发上应充分考虑安全需求，保证系统运行安全可靠，既考虑信息资源的充分共享，更要注意信息的保护，因此系统应分别针对不同的应用和不同的网络通信环境，采取不同的措施，包括系统安全机制、数据存取的权限控制等。可维护性系统采用模块化设计，组成系统的功能模块具有一定的独立性，实现各个模块的解耦，可以根据用户的需要进行替换而不影响或很少影响其他功能模块并能够与其他功能模块协作共同完成用户的功能。满足系统可扩展、容易升级、操作简单、维护方便的要求。3建投数据科技（山东）有限公司5系统概述在青岛地铁APP功能上，主要规划了乘车服务、地铁资讯、地铁生活、地铁安全、志愿服务、个人中心、在线购票、乘车码过闸、管理后台九大部分功能类别。6系统总体结构6.1平台架构青岛地铁APP的整体平台架构如下图：6.2功能架构4建投数据科技（山东）有限公司6.2.1功能逻辑地铁app从功能上划分为：乘车服务、地铁资讯、地铁生活、义务监督员、志愿服务、个人中心、管理后台七大部分。7功能模块7.1应用管理目前，应用管理包括5个应用：在线购票、站点信息、乘客服务、投票、问卷调查等，首页默认显示前三个应用，点击更多查看全部应用，右上角编辑功能用户可以自己调整显示顺序。7.1.1应用列表本功能从管理后台上传添加应用名称、应用图标、应用类别后，启用后经过APP端配置就可以显示管理后台配置的所有可用应用列表。具体操作：管理后台登录后，点击左侧菜单栏，选择用户管理->应用管理，右侧主页面显示应用列表。5建投数据科技（山东）有限公司7.1.2应用编辑本功能从青岛地铁APP端完成，用户可根据自己日常使用频率调整应用顺讯，为用户提供便捷的服务。具体操作：打开青岛地铁app后首页轮播图下默认显示4个应用图标，点击最后的更多，进入应用列表页，点击右上方的编辑，所有应用图标的左上方显示红色操作点用户根据自己喜好进行选择操作。7.2地铁资讯7.2.1列表展示客户端支持地铁资讯的信息查看，地铁资讯列表主要以图文形式展示地铁资讯，列表要素包含标题、资讯图片、资讯发布时间、阅读量、点赞数。其中，阅读量为用户每点击一次，该文章，阅读量加一。列表页不支持用户点赞，点赞数超过100个显示100+，不做具体点赞数显示，不足100个赞，显示具体数字。7.2.2资讯详情点击列表页进入到资讯详情页面，资讯详情支持图片，文字，短视频，长视频、动图混合展示。如下图所示，显示内容包括资讯标题、作者、发表时间、资讯内容，查看数、点赞数。7.2.3点赞资讯详情页面支持点赞功能，点击点赞按钮，点赞数量加1，点赞图标高亮显示，已经点赞的用户，再次点击点赞按钮，点赞取消，点赞数减1。7.2.4分享资讯详情支持该文章的分享，支持分享到微信好友、微信朋友圈、qq空间、6建投数据科技（山东）有限公司新浪微博。7.2.5收藏资讯详情页面，支持文章收藏，再次点击收藏按钮，收藏取消。7.3投票7.3.1客户端功能描述客户端以列表方式展示当前所有正在进行的已发布投票，未开始和已结束的投票不再显示，如下图所示显示投票信息的标题和创建时间，点击对应标题后进入到投票信息详情页面。进入到投票详情页面。点击“我要投票“按钮时，系统判断用户是否登录，如果没有登录，给出toast提示：当前题目必须登录后作答，请先登录。已经参与投票的用户，无法再次参与。再次进入后提示用户已经参与过，无法再次投票，并给出上次参与投票选择。管理后台列表展示所有创建的投票信息，包括投票标题、创建时间、投票开始时间、投票结束时间。支持根据投票标题和创建时间区间进行匹配查询。7.3.2投票新增与修改管理后台支持投票的新增与修改，新增修改页面如下图所示，包括标题、开始时间、结束时间、是否单选。勾选单选后，表示该投票为单选，客户端只能选择一个选项进行投票。投票标题字段长度不超过500汉字。开始时间、结束时间为时间控件，控件精确到天，如开始时间为：2018-01-01，结束时间为：2018-01-04，则表示开始时间为：2018-01-0100：00：00，结束时间为：2018-01-0423：59：59.7建投数据科技（山东）有限公司删除：点击“删除”，给出提示：确实要执行该操作吗？点击确定，对应记录被删除，列表页刷新。已经有用户参与的投票，不允许删除。发布/取消发布：投票信息新增完成后，执行发布操作，客户端在发布且在投票时间范围内，客户端显示。已经发布的投票，可以执行“取消发布”操作。7.4义务监督员7.4.1客户端功能描述客户端用户使用义务监督员功能时先确认当前用户是否为义务监督员，如果已经登录且注册成为义务监督员，则直接进入义务监督他信息上报管理页面否则进入到义务监督员申请页面。7.4.2义务监督员申请客户端提供义务监督员申请入口，进入到义务监督员功能介绍页面。如下图所示，为义务监督员介绍页面，主要以文字形式介绍义务监督员的优惠政策、面向群体。以及申请流程。登录未登录情况下，点击“我要申请”按钮提示用户：未登录，请先登录。并跳转到登录页面。填写资料资料填写页面用户信息与志愿者资料填写页面信息同步，如果当前用户在进行志愿服务申请时填写过相关资料，则将对应信息回填到义务监督员资料认证表单中，不支持用户修改。其中真实姓名做非空验证，格式要求3个以上英文单词或一个以上汉字长度不超过20个汉字。性别为必填，默认男，身份证号码做基础规则验证，并与填写的性别做匹配，学历，手机号码，电子邮箱，工作单位，是否为青岛地铁员工家属，乘车方式为必填内容。其中学历包括：博士及以上，硕士，本科，专科，高中，初中及以下。默认选择为本科。手机号码、电子邮箱做合法性规则验证。是否为青岛地铁员工家属，默认为“否”。工作单位长度不超过120个汉8建投数据科技（山东）有限公司字，阅读并同意《青岛地铁义务监督员协议》默认为不选中状态。点击确定时，需要做相关字段的验证，并要求选中阅读并同意《青岛地铁义务监督员协议》。点击《青岛地铁义务监督员协议》，打开协议内容页面，协议内容为后台维护。相关资料填写完成后，系统目前默认自动审核通过，并在客户端给出消息推送提醒：您提交的资料已经审核完成。客户端支持信息上报功能，上报信息如下图所示，上报人为用户真实姓名，不可修改，联系电话默认为注册手机号，可修改。图片上传最多三张，每张大小不能超过10M。图片格式按照app上传图片同时格式要求，支持gif,jpeg,png,bmp点击“确定”按钮进行信息上报，联系电话，存在问题以及整改建议不能为空，图片数量不能超过三张。7.4.3义务监督员管理所有申请成为义务监督员的用户默认都自动审核通过，管理后台提供对审核通过的义务监督的管理功能。支持义务监督的查看、修改、禁用/启用。列表列表内容按照时间先后顺序展示申请的义务监督员，列表项包括姓名、身份证号码、得分、性别、学历、联系电话、登录账号、是否青岛地铁员工家属、职务、状态（正常、禁用）、创建时间。详情查看双击列表字段进入到详情页面，详情页面显示内容包括姓名、性别、身份证号、学历、民族、政治面貌、职务、电话号码、邮箱、工作单位、住址、是否地铁员工家属、乘车方式、乘坐轨道交通频率、日常乘坐轨道交通区段、简述自身工作经历和担任服务监督员的优势。9建投数据科技（山东）有限公司修改管理后台支持提交的义务监督员信息维护，点击修改，可以进行义务监督员信息修改。修改字段除姓名外其他字段均可修改。其中真实姓名做非空验证，格式要求3个以上英文单词或一个以上汉字，字段长度不超过100汉字。性别为必填，默认男，身份证号码做基础规则验证，并与填写的性别做匹配，学历，手机号码，电子邮箱，工作单位，是否为青岛地铁员工家属，乘车方式为必填内容。其中学历包括：博士及以上，硕士，本科，专科，高中，初中及以下。默认选择为本科。手机号码、电子邮箱做合法性规则验证。民族、职务字段长度不超过100汉字，工作单位、家庭地、日常乘坐轨道交通区段字段长度不超过200汉字。轨道交通频率只能输入数字。禁用/启用管理后台支持义务监督员的禁用/启用操作，点击启用/禁用链接，给出提示：确实要执行该操作吗？被禁用的义务监督员，无法执行信息上报、无法查看自己提交的信息。上报问题查看管理后台能够进行问题上报的查看，支持列表形式查看，列表内容包括问题、提出人、状态、提出时间。7.5志愿者客户端通过首页志愿服务引导，进入到志愿者服务功能页面。首先判断用户是否为志愿者，如果不是则引导用户注册成为志愿者，如果已经是志愿者则进入志愿者管理页面。志愿者中心已经申请成为志愿者的用户，再次登录后进入到志愿者功能，显示志愿者中心页面，如下图所示，志愿者中心，包括：问题上报、任务集市、我的任务、服务公示四大模块。7.5.1问题上报通过列表页可以查看当前用户提交的上报信息及回复。上报问题列表如下如10建投数据科技（山东）有限公司所示，客户端只能看到当前登录的志愿者提交的信息。提交信息列表展现内容包括：问题描述、建议、回复，上报时间，加分。其中回复是运营人员通过管理后台进行回复后显示。加分为运营人员通过管理后台进行打分，将获得分数进行显示。7.5.2任务集市申请成为志愿者的登录用户具有领取任务功能，如下图所示，用户进入到任务集市，任务集市展示当前所有可报名参加的任务。可参与包括的任务条件是：任务未结束，人员报名未满额的任务。任务列表按照任务时间先后顺序排列展示。展示内容包括：任务编号、任务名称、任务简介、需求数、报名数。点击报名或者当前记录的任意位置进入到任务详情页面。我的任务主要显示，当前登录的志愿者报名成功的任务。显示任务编号、任务标题、任务简介。7.6乘客服务7.6.1车站设施车站设施主要分为：服务设施和生活便利服务两个模块，对地铁车站的设备的简单图文介绍。服务设施主要是地铁中所有车站设施的图文介绍：无障碍卫生间、安心专座、扶手盲文、盲道等等；生活便利服务主要是地铁站中的服务性的设备：例如商铺、自助取款机、自助售货机、琴岛通自助售卡充值机。在管理后台中可以对车站设施下的数据进行维护，新增、取消发布。7.6.2乘车安全乘车安全主要包括两个模块：应急指引和安全须知，对地铁中的乘车安全常识进行介绍推广。内容包含：乘客应急常识、政法宣传、禁止携带的物品等等。点击文章标题，进入详情介绍。在管理后台中可以对乘车安全的数据进行维护，新增、取消发布。11建投数据科技（山东）有限公司7.6.3票务信息票务信息主要包括：车票介绍、票务优惠、票务规则、乘车码使用说明。该模块主要介绍对地铁票卡以及乘车码的使用介绍说明，以及所有票务文字信息。点击模块名称查看内容详情。7.6.4出行指南出行指南，主要是介绍乘客出行中需要注意的条目以及地铁车站为乘客准备的爱心服务、雨具等。点击文字标题查看内容详情。管理后台可以对该模块数据进行维护，新增、取消发布。7.6.5常见问题常见问题主要包括APP常见问题、乘车常见问题，该模块收录了乘客在乘车过程中遇到的问题以及帮助手册。点击文字标题查看内容详情。管理后台可以对该模块数据进行维护，新增、取消发布。7.6.6意见反馈登录用户每天可以最多提交三条意见反馈，内容包括：建议内容、联系手机号。提交后，管理后台可以看到用户的所有建议，方便及时运营人员及时跟进用户体验，升级使用服务。7.6.7地铁热线7.7在线购票7.7.1订单创建点击购票按钮，进入到订单创建页面，如下图所示，获取上一页面设置的起始/终点站点信息。默认显示在起始站/终点站输入框中。用户点击起始站点输入框可重新选择起始站点，点击起始站点输入框，跳转到站点选择页面，重新获取票价。12建投数据科技（山东）有限公司购买张数最大可选择数字为9，最小可选择购买张数为1，购买张数默认为1。支付渠道为读取后台配置的渠道信息。目前支持微信、支付宝和银联。单价金额为根据接口获得，实际支付额为单价*数量。一次性购买最多票数为与互联网票务平台对接获取，一次可购买的最大票数。点击购买做如下判断判断选择票数是否合法，不合法，给出toast提示：购买车票数量不能超过N张。判断必填内容是否为空，起始/终点站点不能为空，为空则给出toast提示：请选择起始/终点站点。选择购买票数为空，给出toast提示：购买票数不能为空。支付渠道不能为空，为空则给出toast提示：请选择相应支付渠道。13建投数据科技（山东）有限公司选择的起始站点和终点站无法换乘，给出提示：（n）站到（m）站，无有效乘车线路，请重新选择起始站和终点站。判断实际支付金额，是否为0，如果为0，提示不允许支付。在进行实际支付时，实际支付金额以订单为准，订单相关参数进行加密处理，保证数据安全。判断购买次数是否超过50次，超过给出提示：超过当日可购买的最大次数。判断是否登录，未登录跳转到登录页面。合法，则调用ITP平台接口，生成签名订单数据，解析互联网票务平台接口返回数据，组装，调起支付渠道SDK，调转到对应渠道的支付页面。实际支付金额，初始状态为0，选择完成起始终点站，调用接口获取单价金额，实际支付额为单价*数量。7.7.2支付支付时按照互联网票务平台对接接口支付流程，调用互联网票务平台支付接口，返回数据后，对数据进行解析组装，调用对应支付渠道的sdk，生成本地支付流水日志，跳转到相关支付渠道的支付页面。支付渠道包括支付宝、微信和银联，下图以支付宝为例进行说明。支付结果支付完成后，app服务器订单的支付最终结果以ITP返回为准。支付失败：支付失败，回退到订单生成页面，支持再次发起支付。再次发起支付时，客户端根据本次的订单数据重新调起支付渠道sdk。支付成功支付成功后，返回到车票详情页面。根据订单号，调用ITP平台接口获取车票信息，显示订单号、起始/终点站点信息、单程票单价、数量、总价、取票点、支付时间、温馨提示。其中取票点即为起始站点。7.7.3退票（一）发起退票14建投数据科技（山东）有限公司退票操作都是在登录状态下进行的操作，每次发起退票生成本地退票流水日志。通过订单详情页面，可以进行订单退票，退票页面如下图所示。点击“行程有变更，我要退票”，给出提示：确定要执行退票操作吗？点击确定，在登录情况下判断用户退票次数是否超过当日退票数，每日限制退票不超过5次，超过给出提示：今日退票超过5次，无法退票，次日凌晨系统将自动退款。（二）执行退票退票前页面给出提示：确定要执行退票操作吗？确定退票，生成本地退票流水日志，调用互联网票务平台退款相关接口，客户端请求app服务器，app服务器调用ITP接口，同步返回退票结果，app服务器端同步更新订单状态，返回退票成功，客户端给出提示：退票成功，退款以实际到账时间为准。返回退票失败，客户端给出提示：退票失败。（三）退票结果退票状态实时返回，退票成功：更新订单状态。返回到车票详情页面。退票失败：更新订单状态，返回到车票详情页面，退票失败不支持重新发起退票，统一为第二天凌晨ITP平台统一自动退票。15建投数据科技（山东）有限公司7.7.4取票（一）发起取票通过如下图所示的车票购买按钮，点击“扫码取票”，获取订单信息，打开app扫码功能，进行扫码。16建投数据科技（山东）有限公司（二）执行取票扫码识别TVM设备乘车码后，调用ITP平台，进行扫码出票，app页面进入等待出票结果返回。（三）取票完成出票完成后，异步接收ITP返回的出票结果，同步本地订单状态。点击“是”按钮，遮罩层消失，订单状态为取票中。返回后刷新页面订单状态更新。取票结束后，ITP会异步推送相关取票结果给app服务器，app服务更新本地订单状态。取票成功：更新本地订单状态。取票失败：客户端页面显示ITP返回的取票失败原因，支持重新取票，重新取票次数不超过5次。超过五次，点击重新取票给出提示“该订单下当日取票次数超过最大值，无法再次取票，产生的相关费用会在3个工作日内返回到支付账户”。17建投数据科技（山东）有限公司7.7.5我的车票车票订单状态分三类进行展示，分别是“未领取”、“未支付”、“其他”。7.8乘车码7.8.1认证支持手机乘车码虚拟电子票过闸功能，用户通过闸机扫描手机APP乘车码过闸。虚拟电子票的票价、乘车时间以及初始化信息等内容，由互联网票务平台根据互联网订单，发送至APP，APP模拟生成乘车码，虚拟电子票编号具有唯一性。采用出站时支付的后端支付方式，用户使用此功能需要先通过青岛地铁官18建投数据科技（山东）有限公司方APP渠道开通相关代扣业务，绑定相关支付渠道（支付宝、微信、银联），通过扫描手机乘车码随时入站和出站，业务流程如下图所示：支付渠道：对接互联网票务平台，开通代扣代付业务，进行自动扣费。7.8.2进站/出站在进站时，乘客开启手机APP，进行用户信息完整性等验证，确认无误后，根据乘车码生成规则生成进站乘车码，检票机根据一定的规则扫描进站乘车码，读取虚拟电子票信息，在经过合法性认证、有效性认证（非复制、非录像）等检查无误后控制检票机开门，允许乘客进站；检票机应记录虚拟电子票在本站的交易数据，并通过SC\\LCC等设备传送至ACC系统。出站时，乘客开启手机APP，检票机以一定的规则扫描出站乘车码，经过合法性认证、有效性检查等无误后，与互联网票务平台对接，计算相关费用，扣费成功后，检票机开门，允许乘客出站；乘车码读票器应记录虚拟电子票在本站的交易数据，并通过SC\\LCC等设备传送至ACC系统。19建投数据科技（山东）有限公司虚拟电子票的详细交易记录应至少包括：车票记录序号、交易时间、交易设备、交易类型、交易金额、设备状态等。乘车码开通流程包括如下四步：（一）登录点击开通乘车码，先判断用户是否登录，未登录，自动跳转到登录页面。（二）约束判断判断用户是否黑名单用户，黑名单为ITP定时往app服务器推送，根据第三方用户id判断当前用户是否在黑名单中。判断用户是否已经签约，如果已经签约给出提示：已经签约判断用户是否为解约中，如果是，给出提示：当前用户支付渠道解约中，无法进行该操作。青岛地铁内部协议签约，签约页面如下图所示，显示文字如下：你同意青岛地铁集团获取一下权限：使用你在青岛地铁app实名认证的身份信息开通支付服务。在你开通绑定第三方支付服务时，将你实名身份信息传递给第三方支付平台。在进行认证签约前需要同意《青岛地铁先乘后付协议》，先乘车后付协议为后台维护。管理后台，提供先乘车后付协议维护功能。协议类型为数据字典设置，一个协议类型下只能包含一篇协议。管理后台新增时需要判断当前类型下是否已经包含协议内容，如果已经包含则不允许新增。协议修改/新增为富文本编辑，新增页面包括协议内容字段。认证与签约同意青岛地铁先乘后付协议后，选择认证渠道。如下图所示，认证渠道包括微信、支付宝和银联。20建投数据科技（山东）有限公司选择某一渠道，调用ITP获取认证信息，app调起认证渠道sdk，进行认证，认证完成后，支付渠道推送认证信息给ITP。银联支付渠道需要用户手动输入银行四要素数据：姓名、身份证、银行卡号、预留手机号，显示页面如下图所示。微信、支付宝渠道进入后直接进入对应的第三方app中，输入支付密码，开通免密支付。21建投数据科技（山东）有限公司认证失败：支付渠道sdk页面退出，返回到认证渠道选择页面，给出提醒：认证失败，请重新认证或尝试选择其他支付渠道。认证成功：认证成功后，自动跳转到签约页面进行签约，签约渠道与认证渠道一致。在哪个支付渠道进行的认证，就必须在对应渠道签约。22建投数据科技（山东）有限公司7.8.3乘车记录列表列出乘客所有的使用二维码过闸的乘车记录，以及相关信息。23建投数据科技（山东）有限公司7.8.4自助补站乘客在过闸过程中，出现未成功进出站时可以自己手动补进出站。24建投数据科技（山东）有限公司7.9个人中心7.9.1个人中心信息查看客户端提供个人中心页面，个人中心包括我的基本信息，包括个人信息维护。车票、积分、卡券、消息。其中，车票和卡券内容二阶段实现，一阶段上线用户点击无反应。在未登录情况下，点击个人中心，同样跳转到个人中心页面。头像添加支持拍照和从相册选取两种方式。选中后，图片自动加载到头像位置。昵称直接可编辑，手机号无法修改，中间数字做隐藏处理，显示前三位和后两位。不可修改。昵称最大字段输入长度不超过200字，头像尺寸不超过5M。25建投数据科技（山东）有限公司7.9.2我的收藏未登录情况下，点击我的收藏，先执行登录操作。登录成功后，展示我收藏的文章、活动信息。7.9.3地铁热线点击跳转到地铁热线页面，点击图片弹出拨打地铁热线的提示。7.9.4我的积分未登录情况下，先执行登录操作，登录成功后，点击“积分”进入到积分详情页面。7.9.5消息免打扰点击消息，判断用户是否登录，未登录，跳转到登录页面进行登录，登录成功后，进入到系统内消息页面。7.9.6登录客户端登录方式包括手机号+短信验证码方式登录和用户名+密码方式登录。如下图所示，手机号码加短信验证码方式进行登录时，需要做非空验证，手机号码做合法性验证，登录失败统一提示：登录失败，您输入的帐号不存在或用户名密码错误，连续登录不能超过五次，超过5次后需要用户一小时后再试。手机号加短信验证码方式，进行获取短信验证时，需要做手机合法性校验。点击登录时如果验证码错误提示：验证码错误，如果手机号码不存在，提示：输入的手机号码不存在。短信验证码发送完成后，60s内不能重复发送，超过60s，可以继续发送。7.10管理后台管理后台相关功能已在上面各个功能中讲述，此处不在赘述。8外部接口8.1乘车码数据结构26建投数据科技（山东）有限公司为了保证AG能够有效识别各发码机构的二维码车票数据，需要统一规范各发码平台的二维码车票数据总体结构。具体结构定义如下:1.“地铁行业数据段”总长度确定，并放在二维码车票的最前面，用于AG解析确认车票业务数据;2.“发码渠道自定义数据段”由APP端发码渠道自行约定，其内容用于实现APP平台自身平台发码所需的安全认证机制8.2数据加密签名规则一、地铁行业数据段的加密、签名1.行业数据采用签名保护方式，签名秘钥使用ACC发行的对称秘钥进行签发。ACC签发使用的对称秘钥为保存在PSAM卡中的加密秘钥。具体的“签名秘钥类型(SIGNATURE_TYPE)”由ACC反馈签名数据时，同步指定2.ITP将需要签名的数据实时发送给ACC，ACC使用本地对称秘钥对行业数据进行签名，并反馈签名类型和签名值。3.签名数据段的计算方式=ACC对称密钥加密(MD5(对称密钥加密行业数据))前8个字节4.AG截取行业数据后，需要使用本地的PSAM卡内的对应类型的对称秘钥对车票数据进行延签、解密，方可进行后续交易处理。二、用户公钥私钥数据签名验签1.APP使用本地KEK解密用户公私钥。2.使用用户私钥对【地铁行业数据段】+【蓝牙回写数据段】+【客户端随机数】进行整体签名，得到用户私钥签名数据E。3.在原有数据基础上，拼接用户私钥签名、用户公钥数据信息，形成完整二维码数据。三、蓝牙数据保护AG交易完成后的交易回写数据在通过蓝牙协议传输过程中，使用二维码数27建投数据科技（山东）有限公司据中的“客户端随机数”进行传输保护。手机APP端接收到广播数据后，需使用“客户端随机数”对交易回写数据进行解码。8.3数据处理过程一、服务器端封装二维码数据过程1.封装行业数据。2.封装票卡数据用数据转换密钥加密。3.封装用户证书信息。二、客户端封装二维码数据过程1.客户端保存数据转换的子KEK，子KEK保护的用户私钥。2.数据转换算法还原KEK,用KEK解密SM2私钥和APP数据。3.客户端随机生成16字节对称密钥。4.生成时间戳，封装蓝牙回填数据，用随机对称密钥加密。5.封装签名数据(服务器下发数据||16字节蓝牙回写数据||16数据转换密钥)。6.用户私钥签名数据。7.显示二维码。三、闸机判断过程1.用公钥验签地铁行业数据。2.用数据转换密钥解密票卡信息。3.判断行业数据有效期。4.判断用户证书有效期。5.用户私钥验签用户签名数据。6.行业数据和外层数据不一致，以最新处理时间的数据为准。28建投数据科技（山东）有限公司9运行环境9.1.1系统运行环境1)采用基于windows/linux操作系统+应用中间件+数据库的实现方式；2)应支持MYSQL数据库；3)客户浏览器：支持IE、Chrome、firefox、Safari等；4)应用服务:Apache、Tomcat；5)中间件应支持但不限于Websphere、activeMQ等中间件。9.1.2硬件平台客户端建议最低配置：iphone4S及以上，系统ios9.0以上。安卓支持系统4.4以上。29