青岛地铁APP详细设计方案详细设计.doc

建投数据科技（山东）有限公司青岛地铁APP详细设计方案建投数据科技（山东）有限公司目录1目的..............................................................................................................................................................................12背景..............................................................................................................................................................................13术语定义......................................................................................................................................................................14系统概述......................................................................................................................................................................25功能架构......................................................................................................................................................................36功能模块......................................................................................................................................................................46.1个人中心.............................................................................................................................................................46.1.1个人中心首页查询接口.............................................................................................................................56.1.2查询用户签到记录.....................................................................................................................................66.1.3查询模块下的资讯列表.............................................................................................................................76.1.4查询资讯.....................................................................................................................................................96.1.5收藏文章...................................................................................................................................................106.1.6查询当前路线信息...................................................................................................................................116.2乘车服务...........................................................................................................................................................126.2.1签约状态查询...........................................................................................................................................136.2.2请求行业数据...........................................................................................................................................146.2.3请求补站信息...........................................................................................................................................156.2.4请求服务器时间.......................................................................................................................................176.2.5蓝牙回写通知...........................................................................................................................................186.2.6请求签约信息...........................................................................................................................................196.2.7查询行程信息...........................................................................................................................................206.3二维码乘车.......................................................................................................................................................236.3.2解约结果通知...........................................................................................................................................246.3.3黑名单结果通知.......................................................................................................................................266.3.4退款结果通知...........................................................................................................................................286.3.5支付结果通知...........................................................................................................................................296.3.6出票成功结果通知...................................................................................................................................316.3.7签约结果通知...........................................................................................................................................326.3.8出票故障结果通知...................................................................................................................................346.3.9闸机CA公钥变更通知............................................................................................................................356.4在线购票...........................................................................................................................................................376.4.1下单...........................................................................................................................................................376.4.2我的订单...................................................................................................................................................396.4.3退款...........................................................................................................................................................416.4.4支付...........................................................................................................................................................446.5站点信息...........................................................................................................................................................466.5.1站点查询...................................................................................................................................................476.5.2站点详情...................................................................................................................................................486.6地铁资讯...........................................................................................................................................................506.6.1资讯列表...................................................................................................................................................516.6.2资讯详情...................................................................................................................................................526.7生活圈...............................................................................................................................................................536.7.1生活圈推荐...............................................................................................................................................536.7.2生活圈列表...............................................................................................................................................546.7.3生活圈文章详情.......................................................................................................................................556.8义务监督员.......................................................................................................................................................566.8.1申请...........................................................................................................................................................566.8.2审核...........................................................................................................................................................576.9志愿者...............................................................................................................................................................586.9.1申请...........................................................................................................................................................59建投数据科技（山东）有限公司6.9.2报名...........................................................................................................................................................606.10问卷调查...........................................................................................................................................................616.10.1管理...........................................................................................................................................................616.10.2问卷作答...................................................................................................................................................626.11投票...................................................................................................................................................................636.11.1管理...........................................................................................................................................................636.11.2投票...........................................................................................................................................................65建投数据科技（山东）有限公司1目的随着经济的快速发展，作为铁路运输的一种，地铁越来越受人们的欢迎，由于它的快捷、便利，如今已成为大多数人上班出行的必乘交通工具。互联网时代为人们提供了更方便、快捷的软件环境，青岛地铁APP无疑将为青岛地铁带来更便利快捷的乘车购票功能、地铁资讯发布等功能，同时，为乘客出行提供更便捷、更丰富、更个性化的服务，为地铁工作人员提供更简单优质的资讯发布服务，打造智能的互联网地铁系统。2背景1随着青岛地铁3号线、2号线、11号线的顺利开通，为方便乘客出行，使得地铁信息发布以及乘客购票更便利化，青岛地铁需要一套实现地铁资讯发布和用户购票的互联网APP；2国内其他地铁城市基本都拥有自己的地铁APP,方便实现地铁资讯发布和乘客网上购票等主要功能；3术语定义术语和缩写解释备注ITP互联网票务平台ACC清分中心(AFCClearingCenter)AFC自动售检票AutomaticFareCollection）AGM自动检票机（AutomaticGateMachine）BOM半自动（票房）售票机（BookingOfficeMachine）CAD计算机辅助设计（ComputerAidedDesign）CLK时钟系统（ClockSystem）ECU电子控制单元/主控单元（ElectronicControlUnit）EMC电磁兼容性（ElectroMagneticCompatibility）EnG进站检票机（EntryGate）ExG出站检票机（ExitGate）IP国际防护标准（Internation第1页/共68页建投数据科技（山东）有限公司Protection）LCC线路中央计算机系统（LineCentralComputer）MPServer信用管理服务器（MasterPurseServer）MTBF平均故障间隔时间（MeanTimeBetweenFailure）MCBF平均故障间隔次数（MeanCyclesBetweenFailure）MTTR平均修复时间（MeanTimeToRepair）OCC控制中心（OperatingControlCenter）RAM随机存储器（RandomAccessMemory）RAMS可靠性、可用性、可维修性、安全性（Reliability、Availability、Maintainability、Safety）RG双向检票机（ReversibleGate）SAM安全存取模块（SecureAccessModule）SC车站计算机系统（StationComputer）SLE车站售检票设备（StationLevelEquipment）TPMC每分钟交易次数（TransationperMinuteCount）TRS通信传输系统（TransmissionSystem）TVM自动售票机（TicketVendingMachine）TCM自动查询机（TicketCheckingMachine）R/W读写器（Reader/Writer）4系统概述青岛地铁项目分为Android系统和iOS系统移动端App、后台管理系统三大模块。Android和iOS系统的移动端App主要为乘客提供在线购票、二维码过闸、站点信息查询、乘客服务、投票、问卷调查、义务监督员和地铁志愿者等主要功能，后台管理系统主要实现后台信息的维护第2页/共68页建投数据科技（山东）有限公司5功能架构1.青岛地铁项目移动端主要包括以下功能模块：（1）在线购票，主要为用户提供线上购票服务；（2）乘客服务，包含“便民服务”、“出行指南”、“票务信息”、“乘车安全”、“便民雨伞”、“意见反馈”等模块，主要提供用户便捷乘车服务；（3）站点信息，提供所有站点的信息查询和每个站点的详细信息（包括基础设施、出入站、生活服务、公交等）；（4）地铁志愿者，主要提供志愿者的申请服务；（5）义务监督员，主要提供义务监督员的申请服务；（6）问卷调查，提供问卷服务；（7）投票，提供投票服务；（8）二维码过闸，用户可直接使用二维码乘车，无需购票和取票；（9）支付渠道签约，用户可绑定银联、微信、支付宝三个支付渠道，实现线上自助支付；（10）生活圈，包含“地铁约”、“地铁购”、“地铁族”、“全媒体”等模块，让乘客充分融入地铁生活。2.青岛地铁项目后台管理系统主要包括“首页推荐管理”、“乘车服务管理”、“运行资讯管理”、“生活圈管理”、“投票问卷管理”、“义务监督员管理”、“志愿者管理”、“轮播图管理”、“用户管理”、“系统管理”等模块，主要实现后台功能的模块管理等功能；第3页/共68页建投数据科技（山东）有限公司6功能模块6.1个人中心第4页/共68页建投数据科技（山东）有限公司6.1.1个人中心首页查询接口6.1.1.1类名/文件名(及路径)列表6.1.1.2引用的资源<引用的类/包>com.sdjictec.ticket.service.ItpService;com.sdjictec.ticket.utils.AppResponse;com.sdjictec.ticket.utils.BaseController;org.slf4j.Logger;org.slf4j.LoggerFactory;org.springframework.beans.factory.annotation.Autowired;org.springframework.web.bind.annotation.PostMapping;org.springframework.web.bind.annotation.RequestBody;org.springframework.web.bind.annotation.RequestMapping;org.springframework.web.bind.annotation.RestController;java.io.IOException;<继承/扩展的类/接口>继承如下类：com.sdjictec.ticket.utils.BaseController6.1.1.3输入项字段类型说明platformstring平台类型tokenstring用户登录token第5页/共68页建投数据科技（山东）有限公司6.1.1.4输出项字段类型说明imagestring头像vouchstring卡券数量ticketstring车票数量nickNamestring昵称terminusstring常用线路的终点站creditstring当前积分情况messagestring未读消息条数startingstring常用线路的始发站6.1.2查询用户签到记录6.1.2.1类名/文件名(及路径)列表6.1.2.2引用的资源<引用的类/包>com.sdjictec.ticket.service.ItpService;com.sdjictec.ticket.utils.AppResponse;com.sdjictec.ticket.utils.BaseController;org.slf4j.Logger;org.slf4j.LoggerFactory;org.springframework.beans.factory.annotation.Autowired;org.springframework.web.bind.annotation.PostMapping;org.springframework.web.bind.annotation.RequestBody;第6页/共68页建投数据科技（山东）有限公司org.springframework.web.bind.annotation.RequestMapping;org.springframework.web.bind.annotation.RestController;java.io.IOException;<继承/扩展的类/接口>继承如下类：com.sdjictec.ticket.utils.BaseController6.1.2.3输入项字段类型说明platformstring平台类型tokenstring用户登录token6.1.2.4输出项字段类型说明successstring成功/失败resultstring结果messagestring信息createDatestring签到时间6.1.3查询模块下的资讯列表6.1.3.1类名/文件名(及路径)列表6.1.3.2引用的资源<引用的类/包>com.sdjictec.ticket.service.ItpService;com.sdjictec.ticket.utils.AppResponse;com.sdjictec.ticket.utils.BaseController;org.slf4j.Logger;org.slf4j.LoggerFactory;第7页/共68页建投数据科技（山东）有限公司org.springframework.beans.factory.annotation.Autowired;org.springframework.web.bind.annotation.PostMapping;org.springframework.web.bind.annotation.RequestBody;org.springframework.web.bind.annotation.RequestMapping;org.springframework.web.bind.annotation.RestController;java.io.IOException;<继承/扩展的类/接口>继承如下类：com.sdjictec.ticket.utils.BaseController6.1.3.3输入项字段类型说明platformstring平台类型tokenstring用户登录tokenMidstring所属模块的id第8页/共68页建投数据科技（山东）有限公司6.1.3.4输出项字段类型说明successstring成功/失败resultstring结果messagestring信息titlestring模块名称idstring资讯idcontentstring内容authorstring作者replaystring回复数量allowReplaystring是否允许回复favoritestring收藏数量outlinestring大纲titleImagestring显示图片6.1.4查询资讯6.1.4.1类名/文件名(及路径)列表6.1.4.2引用的资源<引用的类/包>com.sdjictec.ticket.service.ItpService;com.sdjictec.ticket.utils.AppResponse;com.sdjictec.ticket.utils.BaseController;org.slf4j.Logger;第9页/共68页建投数据科技（山东）有限公司org.slf4j.LoggerFactory;org.springframework.beans.factory.annotation.Autowired;org.springframework.web.bind.annotation.PostMapping;org.springframework.web.bind.annotation.RequestBody;org.springframework.web.bind.annotation.RequestMapping;org.springframework.web.bind.annotation.RestController;java.io.IOException;<继承/扩展的类/接口>继承如下类：com.sdjictec.ticket.utils.BaseController6.1.4.3输入项字段类型说明platformstring平台类型tokenstring用户登录tokenidstring资讯id第10页/共68页建投数据科技（山东）有限公司6.1.4.4输出项字段类型说明successstring成功/失败resultstring结果messagestring信息titlestring模块名称idstring资讯idcontentstring内容authorstring作者replaystring回复数量allowReplaystring是否允许回复favoritestring收藏数量outlinestring大纲titleImagestring显示图片6.1.5收藏文章6.1.5.1类名/文件名(及路径)列表6.1.5.2引用的资源<引用的类/包>com.sdjictec.ticket.service.ItpService;com.sdjictec.ticket.utils.AppResponse;com.sdjictec.ticket.utils.BaseController;org.slf4j.Logger;org.slf4j.LoggerFactory;第11页/共68页建投数据科技（山东）有限公司org.springframework.beans.factory.annotation.Autowired;org.springframework.web.bind.annotation.PostMapping;org.springframework.web.bind.annotation.RequestBody;org.springframework.web.bind.annotation.RequestMapping;org.springframework.web.bind.annotation.RestController;java.io.IOException;<继承/扩展的类/接口>继承如下类：com.sdjictec.ticket.utils.BaseController6.1.5.3输入项字段类型说明platformstring平台类型tokenstring用户登录tokenidstring资讯id6.1.5.4输出项字段类型说明successstring成功/失败resultstring结果messagestring信息6.1.6查询当前路线信息6.1.6.1类名/文件名(及路径)列表6.1.6.2引用的资源<引用的类/包>com.sdjictec.ticket.service.ItpService;com.sdjictec.ticket.utils.AppResponse;com.sdjictec.ticket.utils.BaseController;第12页/共68页建投数据科技（山东）有限公司org.slf4j.Logger;org.slf4j.LoggerFactory;org.springframework.beans.factory.annotation.Autowired;org.springframework.web.bind.annotation.PostMapping;org.springframework.web.bind.annotation.RequestBody;org.springframework.web.bind.annotation.RequestMapping;org.springframework.web.bind.annotation.RestController;java.io.IOException;<继承/扩展的类/接口>继承如下类：com.sdjictec.ticket.utils.BaseController6.1.6.3输入项字段类型说明platformstring平台类型tokenstring用户登录token6.1.6.4输出项字段类型说明successstring成功/失败resultstring结果messagestring信息createDatestring时间6.2乘车服务购票业务流程第13页/共68页建投数据科技（山东）有限公司6.2.1签约状态查询查询用户的签约状态6.2.1.1类名/文件名(及路径)列表6.2.1.2引用的资源<引用的类/包>com.sdjictec.ticket.service.ItpService;com.sdjictec.ticket.utils.AppResponse;com.sdjictec.ticket.utils.BaseController;第14页/共68页建投数据科技（山东）有限公司org.slf4j.Logger;org.slf4j.LoggerFactory;org.springframework.beans.factory.annotation.Autowired;org.springframework.web.bind.annotation.PostMapping;org.springframework.web.bind.annotation.RequestBody;org.springframework.web.bind.annotation.RequestMapping;org.springframework.web.bind.annotation.RestController;java.io.IOException;<继承/扩展的类/接口>继承如下类：com.sdjictec.ticket.utils.BaseController6.2.1.3输入项字段类型说明platformstring平台类型tokenstring用户登录token6.2.1.4输出项字段类型说明channelCodestring签约渠道编码descstring描述statusstring状态6.2.2请求行业数据请求行业数据信息6.2.2.1类名/文件名(及路径)列表6.2.2.2引用的资源<引用的类/包>com.sdjictec.ticket.service.ItpService;第15页/共68页建投数据科技（山东）有限公司com.sdjictec.ticket.utils.AppResponse;com.sdjictec.ticket.utils.BaseController;org.slf4j.Logger;org.slf4j.LoggerFactory;org.springframework.beans.factory.annotation.Autowired;org.springframework.web.bind.annotation.PostMapping;org.springframework.web.bind.annotation.RequestBody;org.springframework.web.bind.annotation.RequestMapping;org.springframework.web.bind.annotation.RestController;java.io.IOException;<继承/扩展的类/接口>继承如下类：com.sdjictec.ticket.utils.BaseController6.2.2.3输入项字段类型说明platformstring平台类型tokenstring用户登录token6.2.2.4输出项字段类型说明qrCodestring二维码数据typestring进出站类型randomCodestring随机数据6.2.3请求补站信息请求补站信息第16页/共68页建投数据科技（山东）有限公司6.2.3.1类名/文件名(及路径)列表6.2.3.2引用的资源<引用的类/包>com.sdjictec.ticket.service.ItpService;com.sdjictec.ticket.utils.AppResponse;com.sdjictec.ticket.utils.BaseController;org.slf4j.Logger;org.slf4j.LoggerFactory;org.springframework.beans.factory.annotation.Autowired;org.springframework.web.bind.annotation.PostMapping;org.springframework.web.bind.annotation.RequestBody;org.springframework.web.bind.annotation.RequestMapping;org.springframework.web.bind.annotation.RestController;java.io.IOException;<继承/扩展的类/接口>继承如下类：com.sdjictec.ticket.utils.BaseController第17页/共68页建投数据科技（山东）有限公司6.2.3.3输入项字段类型说明platformstring平台类型tokenstring用户登录tokenupgradeAreaTypestring补站类型（进站；出站）upgradeStationCodestring站点编码upgradeReasonstring补站原因6.2.3.4输出项字段类型说明successstring成功/失败resultstring结果messagestring信息6.2.4请求服务器时间6.2.4.1类名/文件名(及路径)列表6.2.4.2引用的资源<引用的类/包>com.sdjictec.ticket.service.ItpService;com.sdjictec.ticket.utils.AppResponse;com.sdjictec.ticket.utils.BaseController;org.slf4j.Logger;org.slf4j.LoggerFactory;org.springframework.beans.factory.annotation.Autowired;org.springframework.web.bind.annotation.PostMapping;org.springframework.web.bind.annotation.RequestBody;第18页/共68页建投数据科技（山东）有限公司org.springframework.web.bind.annotation.RequestMapping;org.springframework.web.bind.annotation.RestController;java.io.IOException;<继承/扩展的类/接口>继承如下类：com.sdjictec.ticket.utils.BaseController6.2.4.3输入项字段类型说明platformstring平台类型tokenstring用户登录token6.2.4.4输出项字段类型说明successstring成功/失败resultstring结果messagestring信息6.2.5蓝牙回写通知6.2.5.1类名/文件名(及路径)列表6.2.5.2引用的资源<引用的类/包>com.sdjictec.ticket.service.ItpService;com.sdjictec.ticket.utils.AppResponse;com.sdjictec.ticket.utils.BaseController;org.slf4j.Logger;org.slf4j.LoggerFactory;org.springframework.beans.factory.annotation.Autowired;org.springframework.web.bind.annotation.PostMapping;第19页/共68页建投数据科技（山东）有限公司org.springframework.web.bind.annotation.RequestBody;org.springframework.web.bind.annotation.RequestMapping;org.springframework.web.bind.annotation.RestController;java.io.IOException;<继承/扩展的类/接口>继承如下类：com.sdjictec.ticket.utils.BaseController6.2.5.3输入项字段类型说明ticketDatastring车票数据agmDatastring回填数据6.2.5.4输出项字段类型说明qrCodestring二维码数据typestring类型6.2.6请求签约信息请求行业数据信息信息6.2.6.1类名/文件名(及路径)列表6.2.6.2引用的资源<引用的类/包>com.sdjictec.ticket.service.ItpService;com.sdjictec.ticket.utils.AppResponse;com.sdjictec.ticket.utils.BaseController;org.slf4j.Logger;org.slf4j.LoggerFactory;org.springframework.beans.factory.annotation.Autowired;org.springframework.web.bind.annotation.PostMapping;第20页/共68页建投数据科技（山东）有限公司org.springframework.web.bind.annotation.RequestBody;org.springframework.web.bind.annotation.RequestMapping;org.springframework.web.bind.annotation.RestController;java.io.IOException;<继承/扩展的类/接口>继承如下类：com.sdjictec.ticket.utils.BaseController6.2.6.3输入项字段类型说明platformstring平台类型tokenstring用户登录token6.2.6.4输出项字段类型说明qrCodestring二维码数据typestring进出站类型randomCodestring随机数据6.2.7查询行程信息6.2.7.1类名/文件名(及路径)列表6.2.7.2引用的资源<引用的类/包>com.sdjictec.ticket.service.ItpService;com.sdjictec.ticket.utils.AppResponse;com.sdjictec.ticket.utils.BaseController;org.slf4j.Logger;org.slf4j.LoggerFactory;第21页/共68页建投数据科技（山东）有限公司org.springframework.beans.factory.annotation.Autowired;org.springframework.web.bind.annotation.PostMapping;org.springframework.web.bind.annotation.RequestBody;org.springframework.web.bind.annotation.RequestMapping;org.springframework.web.bind.annotation.RestController;java.io.IOException;<继承/扩展的类/接口>继承如下类：com.sdjictec.ticket.utils.BaseController6.2.7.1输入项字段类型说明platformstring平台类型tokenstring用户登录token第22页/共68页建投数据科技（山东）有限公司6.2.7.2输出项字段类型说明frIdstring起始站点IdfrNamestring站点名称esIdstring结束站点idesNamestring结束站点名称orderDatestring下单时间paymentDatestring支付时间takeCountstring车票数量statusstring状态statusDescriptionstring状态描述orderCodestring订单号checkoutCountstring取票数量pricestring单价refundAmountstring退款金额6.3二维码乘车推送行业数据第23页/共68页建投数据科技（山东）有限公司6.3.1行业数据推送通知6.3.1.1类名/文件名(及路径)列表6.3.1.2引用的资源<引用的类/包>com.sdjictec.ticket.model.metro.ItpMessage;com.sdjictec.ticket.service.ItpService;com.sdjictec.ticket.utils.BaseController;com.sdjictec.ticket.utils.ItpRequest;com.sdjictec.ticket.utils.ItpResponse;org.slf4j.Logger;org.slf4j.LoggerFactory;org.springframework.beans.factory.annotation.Autowired;org.springframework.web.bind.annotation.RequestMapping;org.springframework.web.bind.annotation.RestController;javax.servlet.http.HttpServletRequest;<继承/扩展的类/接口>继承如下类：com.sdjictec.ticket.utils.BaseController第24页/共68页建投数据科技（山东）有限公司6.3.1.3输入项字段类型说明thirdUserIdstring第三方用户idcardIdstring地铁会员卡号cardTypestring卡类型cardDatastring卡数据HexString6.3.1.4输出项字段类型说明retCodestring返回码retMsgstring返回消息6.3.2解约结果通知6.3.2.1类名/文件名(及路径)列表6.3.2.2引用的资源<引用的类/包>第25页/共68页建投数据科技（山东）有限公司com.sdjictec.ticket.model.metro.ItpMessage;com.sdjictec.ticket.service.ItpService;com.sdjictec.ticket.utils.BaseController;com.sdjictec.ticket.utils.ItpRequest;com.sdjictec.ticket.utils.ItpResponse;org.slf4j.Logger;org.slf4j.LoggerFactory;org.springframework.beans.factory.annotation.Autowired;org.springframework.web.bind.annotation.RequestMapping;org.springframework.web.bind.annotation.RestController;javax.servlet.http.HttpServletRequest;<继承/扩展的类/接口>继承如下类：com.sdjictec.ticket.utils.BaseController6.3.2.3输入项字段类型说明thirdUserIdstring第三方用户idcardIdstring地铁会员卡号cardTypestring卡类型requestSignSeqstring签约流水号terminationResultstring解约结果SUCCESS成功FAIL失败terminationResultMsgstring结果描述terminationTimestring解约时间,格式如：YYYYMMDDHH24mmss第26页/共68页建投数据科技（山东）有限公司6.3.2.4输出项字段类型说明retCodestring返回码retMsgstring返回消息6.3.3黑名单结果通知6.3.3.1类名/文件名(及路径)列表6.3.3.2引用的资源<引用的类/包>com.sdjictec.ticket.model.metro.ItpMessage;com.sdjictec.ticket.service.ItpService;com.sdjictec.ticket.utils.BaseController;com.sdjictec.ticket.utils.ItpRequest;com.sdjictec.ticket.utils.ItpResponse;org.slf4j.Logger;org.slf4j.LoggerFactory;org.springframework.beans.factory.annotation.Autowired;org.springframework.web.bind.annotation.RequestMapping;org.springframework.web.bind.annotation.RestController;javax.servlet.http.HttpServletRequest;<继承/扩展的类/接口>继承如下类：com.sdjictec.ticket.utils.BaseController6.3.3.3输入项字段类型说明blackListJson数组黑名单列表,最多25笔单条记录第27页/共68页建投数据科技（山东）有限公司字段类型说明thirdUserIdstring第三方用户idcardIdString地铁会员卡号cardTypeString卡类型blackListTypeString解约结果1：加入黑名单2：移除黑名单optionDateString操作时间时间,格式如：YYYYMMDDHH24mmssexpireTimeString黑名单有效期,格式如：YYYYMMDDHH24mmss。当解约结果为1时有效6.3.3.4输出项字段类型说明retCodestring返回码retMsgstring返回消息6.3.4退款结果通知定时退款通知6.3.4.1类名/文件名(及路径)列表6.3.4.2引用的资源<引用的类/包>com.sdjictec.ticket.model.metro.ItpMessage;com.sdjictec.ticket.service.ItpService;第28页/共68页建投数据科技（山东）有限公司com.sdjictec.ticket.utils.BaseController;com.sdjictec.ticket.utils.ItpRequest;com.sdjictec.ticket.utils.ItpResponse;org.springframework.beans.factory.annotation.Autowired;<继承/扩展的类/接口>继承如下类：com.sdjictec.ticket.utils.BaseController6.3.4.3输入项字段类型说明orderNostring订单号refundTypestring00:用户提交退款01：超时未使用自动退款refundResultstringSUCCESS/FAIL/PROCESSINGSUCCESS—退款成功FAIL—退款失败PROCESSING-退款进行中refundResultDescstring退款描述refundDatestring退款日期refundAmountString退款金额单位分6.3.4.4输出项字段类型说明retCodestring返回码retMsgstring返回消息6.3.5支付结果通知支付结果回调第29页/共68页建投数据科技（山东）有限公司6.3.5.1类名/文件名(及路径)列表6.3.5.2引用的资源<引用的类/包>com.sdjictec.ticket.model.metro.ItpMessage;com.sdjictec.ticket.service.ItpService;<继承/扩展的类/接口>继承如下类：com.sdjictec.ticket.utils.BaseController第30页/共68页建投数据科技（山东）有限公司6.3.5.3输入项字段类型说明refundDatestring退款日期refundAmountString退款金额单位分refundDatestring退款日期refundAmountString退款金额单位分refundDatestring退款日期refundAmountString退款金额单位分refundDatestring退款日期6.3.5.4输出项字段类型说明retCodestring返回码retMsgstring返回消息6.3.6出票成功结果通知6.3.6.1类名/文件名(及路径)列表6.3.6.2引用的资源<引用的类/包>com.sdjictec.ticket.model.metro.ItpMessage;com.sdjictec.ticket.service.ItpService;com.sdjictec.ticket.utils.BaseController;com.sdjictec.ticket.utils.ItpRequest;com.sdjictec.ticket.utils.ItpResponse;org.springframework.web.bind.annotation.RestController;第31页/共68页建投数据科技（山东）有限公司javax.servlet.http.HttpServletRequest;<继承/扩展的类/接口>继承如下类：com.sdjictec.ticket.utils.BaseController6.3.6.3输入项字段类型说明orderNostring订单号orderTicketNumstring订单数量actualTakeTicketNumstring实际出票数量takeTickeDatestring出票时间6.3.6.4输出项字段类型说明retCodestring返回码retMsgstring返回消息6.3.7签约结果通知返回签约结果通知6.3.7.1类名/文件名(及路径)列表6.3.7.2引用的资源<引用的类/包>com.sdjictec.ticket.model.metro.ItpMessage;com.sdjictec.ticket.service.ItpService;com.sdjictec.ticket.utils.BaseController;com.sdjictec.ticket.utils.ItpRequest;com.sdjictec.ticket.utils.ItpResponse;org.slf4j.Logger;第32页/共68页建投数据科技（山东）有限公司org.slf4j.LoggerFactory;org.springframework.beans.factory.annotation.Autowired;org.springframework.web.bind.annotation.RequestMapping;org.springframework.web.bind.annotation.RestController;javax.servlet.http.HttpServletRequest;<继承/扩展的类/接口>继承如下类：com.sdjictec.ticket.utils.BaseController6.3.7.3输入项字段类型说明thirdUserIdstring第三方用户编码requestSignSeqstring签约请求流水号paymentVendorstring2.7支付通道编码payAccountIdstring第三方签约账号编码payAgreementNostring第三方签约流水号signResultstringSUCCESS签约成功FAIL签约失败realNameAuthResultstringSUCCESS实名成功FAIL实名失败6.3.7.4输出项字段类型说明retCodestring返回码retMsgstring返回消息第33页/共68页建投数据科技（山东）有限公司6.3.8出票故障结果通知6.3.8.1类名/文件名(及路径)列表6.3.8.2引用的资源<引用的类/包>com.sdjictec.ticket.model.metro.ItpMessage;com.sdjictec.ticket.service.ItpService;com.sdjictec.ticket.utils.BaseController;com.sdjictec.ticket.utils.ItpRequest;com.sdjictec.ticket.utils.ItpResponse;org.springframework.beans.factory.annotation.Autowired;org.springframework.web.bind.annotation.RequestMapping;org.springframework.web.bind.annotation.RestController;javax.servlet.http.HttpServletRequest;<继承/扩展的类/接口>继承如下类：com.sdjictec.ticket.utils.BaseController6.3.8.3输入项字段类型说明orderNostring订单号orderTicketNumstring订单数量actualTakeTicketNumstring实际出票数量takeTickeDatestring出票时间takeTiketFaultReasonstring出票故障原因refundAmountString退款金额第34页/共68页建投数据科技（山东）有限公司6.3.8.4输出项字段类型说明retCodestring返回码retMsgstring返回消息6.3.9闸机CA公钥变更通知闸机更换CA公钥后通知APP_SERVER,APP_SERVER收到CA公钥变更通知后通知客户端更换用户密钥。6.3.9.1类名/文件名(及路径)列表6.3.9.2引用的资源<引用的类/包>com.sdjictec.ticket.model.metro.ItpMessage;com.sdjictec.ticket.service.ItpService;com.sdjictec.ticket.utils.BaseController;com.sdjictec.ticket.utils.ItpRequest;com.sdjictec.ticket.utils.ItpResponse;org.springframework.beans.factory.annotation.Autowired;第35页/共68页建投数据科技（山东）有限公司org.springframework.web.bind.annotation.RequestMapping;org.springframework.web.bind.annotation.RestController;javax.servlet.http.HttpServletRequest;<继承/扩展的类/接口>继承如下类：com.sdjictec.ticket.utils.BaseController6.3.9.3输入项字段类型说明tokenstring用户秘钥Datestring变更日期6.3.9.4输出项字段类型说明retCodestring返回码retMsgstring返回消息6.4在线购票6.4.1下单第36页/共68页建投数据科技（山东）有限公司6.4.1.1类名/文件名(及路径)列表6.4.1.2引用的资源<引用的类/包>com.sdjictec.ticket.model.metro.ItpMessage;com.sdjictec.ticket.service.ItpService;com.sdjictec.ticket.utils.BaseController;com.sdjictec.ticket.utils.ItpRequest;com.sdjictec.ticket.utils.ItpResponse;org.springframework.beans.factory.annotation.Autowired;org.springframework.web.bind.annotation.RequestMapping;org.springframework.web.bind.annotation.RestController;javax.servlet.http.HttpServletRequest;<继承/扩展的类/接口>继承如下类：com.sdjictec.ticket.utils.BaseController6.4.1.3输入项字段类型说明tokenstring用户秘钥startStationstring起始站点endStationstring截至站点totalstring购买张数6.4.1.4输出项字段类型说明retCodestring返回码retMsgstring返回消息第37页/共68页建投数据科技（山东）有限公司6.4.2我的订单6.4.2.1类名/文件名(及路径)列表6.4.2.2引用的资源<引用的类/包>com.sdjictec.ticket.model.metro.ItpMessage;com.sdjictec.ticket.service.ItpService;com.sdjictec.ticket.utils.BaseController;com.sdjictec.ticket.utils.ItpRequest;com.sdjictec.ticket.utils.ItpResponse;第38页/共68页建投数据科技（山东）有限公司org.springframework.beans.factory.annotation.Autowired;org.springframework.web.bind.annotation.RequestMapping;org.springframework.web.bind.annotation.RestController;javax.servlet.http.HttpServletRequest;<继承/扩展的类/接口>继承如下类：com.sdjictec.ticket.utils.BaseController6.4.2.3输入项字段类型说明tokenstring用户秘钥orderIdstring站点id6.4.2.4输出项字段类型说明retCodestring返回码retMsgstring返回消息第39页/共68页建投数据科技（山东）有限公司6.4.3退款6.4.3.1类名/文件名(及路径)列表6.4.3.2引用的资源<引用的类/包>com.sdjictec.ticket.model.metro.ItpMessage;com.sdjictec.ticket.service.ItpService;com.sdjictec.ticket.utils.BaseController;com.sdjictec.ticket.utils.ItpRequest;com.sdjictec.ticket.utils.ItpResponse;org.springframework.beans.factory.annotation.Autowired;org.springframework.web.bind.annotation.RequestMapping;org.springframework.web.bind.annotation.RestController;第40页/共68页建投数据科技（山东）有限公司javax.servlet.http.HttpServletRequest;<继承/扩展的类/接口>继承如下类：com.sdjictec.ticket.utils.BaseController6.4.3.3输入项字段类型说明userIdstring用户编码orderNostring订单号6.4.3.4输出项字段类型说明retCodestring返回码retMsgstring返回消息orderNostring订单号refundTypestring00:用户提交退款01：超时未使用自动退款refundResultstringSUCCESS/FAIL/PROCESSINGSUCCESS—退款成功FAIL—退款失败PROCESSING-退款进行中refundResultDescstring退款描述refundDatestring退款日期refundAmountString退款金额单位分第41页/共68页建投数据科技（山东）有限公司6.4.4支付第42页/共68页建投数据科技（山东）有限公司6.4.4.1类名/文件名(及路径)列表6.4.4.2引用的资源<引用的类/包>com.sdjictec.ticket.model.metro.ItpMessage;com.sdjictec.ticket.service.ItpService;com.sdjictec.ticket.utils.BaseController;com.sdjictec.ticket.utils.ItpRequest;com.sdjictec.ticket.utils.ItpResponse;org.springframework.beans.factory.annotation.Autowired;org.springframework.web.bind.annotation.RequestMapping;org.springframework.web.bind.annotation.RestController;javax.servlet.http.HttpServletRequest;<继承/扩展的类/接口>继承如下类：com.sdjictec.ticket.utils.BaseController6.4.4.3输入项字段类型说明orderNostring订单号payChannelCodestring支付渠道编码第43页/共68页建投数据科技（山东）有限公司6.4.4.4输出项字段类型说明retCodestring返回码retMsgstring返回消息paymentInfostring支付信息，根据payChannelCode返回内容signTypestring00：不签名01：sha1withrsa02：MD5signstring私钥签名sha1withrsa6.5站点信息6.5.1站点查询6.5.1.1类名/文件名(及路径)列表第44页/共68页建投数据科技（山东）有限公司6.5.1.2引用的资源<引用的类/包>com.sdjictec.ticket.model.metro.ItpMessage;com.sdjictec.ticket.service.ItpService;com.sdjictec.ticket.utils.BaseController;com.sdjictec.ticket.utils.ItpRequest;com.sdjictec.ticket.utils.ItpResponse;org.springframework.beans.factory.annotation.Autowired;org.springframework.web.bind.annotation.RequestMapping;org.springframework.web.bind.annotation.RestController;javax.servlet.http.HttpServletRequest;<继承/扩展的类/接口>继承如下类：com.sdjictec.ticket.utils.BaseController6.5.1.3输入项字段类型说明tokenstring用户秘钥stationIdstring站点id6.5.1.4输出项字段类型说明retCodestring返回码retMsgstring返回消息staionIdstring站点idstationNamestring站点名称linestring所属线路第45页/共68页建投数据科技（山东）有限公司6.5.2站点详情6.5.2.1类名/文件名(及路径)列表6.5.2.2引用的资源<引用的类/包>com.sdjictec.ticket.model.metro.ItpMessage;com.sdjictec.ticket.service.ItpService;com.sdjictec.ticket.utils.BaseController;com.sdjictec.ticket.utils.ItpRequest;com.sdjictec.ticket.utils.ItpResponse;org.springframework.beans.factory.annotation.Autowired;org.springframework.web.bind.annotation.RequestMapping;org.springframework.web.bind.annotation.RestController;javax.servlet.http.HttpServletRequest;<继承/扩展的类/接口>继承如下类：com.sdjictec.ticket.utils.BaseController第46页/共68页建投数据科技（山东）有限公司6.5.2.3输入项字段类型说明tokenIDstring用户秘钥stationIdstring站点ID6.5.2.4输出项字段类型说明retCodestring返回码retMsgstring返回消息stationIdstring站点idstationNamestring站点名称linestring所属线路infrastructureJson基础设施busInformationJson公交信息6.6地铁资讯第47页/共68页建投数据科技（山东）有限公司6.6.1资讯列表6.6.1.1类名/文件名(及路径)列表6.6.1.2引用的资源<引用的类/包>com.sdjictec.ticket.model.metro.ItpMessage;com.sdjictec.ticket.service.ItpService;com.sdjictec.ticket.utils.BaseController;com.sdjictec.ticket.utils.ItpRequest;com.sdjictec.ticket.utils.ItpResponse;org.springframework.beans.factory.annotation.Autowired;org.springframework.web.bind.annotation.RequestMapping;org.springframework.web.bind.annotation.RestController;javax.servlet.http.HttpServletRequest;<继承/扩展的类/接口>继承如下类：com.sdjictec.ticket.utils.BaseController第48页/共68页建投数据科技（山东）有限公司6.6.1.3输入项字段类型说明tokenstring用户秘钥6.6.1.4输出项字段类型说明retCodestring返回码retMsgstring返回消息titlestring资讯标题contentstring资讯内容createDatestring创建时间6.6.2资讯详情6.6.2.1类名/文件名(及路径)列表6.6.2.2引用的资源<引用的类/包>com.sdjictec.ticket.model.metro.ItpMessage;com.sdjictec.ticket.service.ItpService;com.sdjictec.ticket.utils.BaseController;com.sdjictec.ticket.utils.ItpRequest;com.sdjictec.ticket.utils.ItpResponse;org.springframework.beans.factory.annotation.Autowired;org.springframework.web.bind.annotation.RequestMapping;org.springframework.web.bind.annotation.RestController;javax.servlet.http.HttpServletRequest;<继承/扩展的类/接口>继承如下类：com.sdjictec.ticket.utils.BaseController第49页/共68页建投数据科技（山东）有限公司6.6.2.3输入项字段类型说明tokenstring用户秘钥6.6.2.4输出项字段类型说明retCodestring返回码retMsgstring返回消息contentstring资讯内容6.7生活圈6.7.1生活圈推荐6.7.1.1类名/文件名(及路径)列表6.7.1.2引用的资源<引用的类/包>com.sdjictec.ticket.model.metro.ItpMessage;com.sdjictec.ticket.service.ItpService;com.sdjictec.ticket.utils.BaseController;com.sdjictec.ticket.utils.ItpRequest;com.sdjictec.ticket.utils.ItpResponse;org.springframework.beans.factory.annotation.Autowired;org.springframework.web.bind.annotation.RequestMapping;org.springframework.web.bind.annotation.RestController;javax.servlet.http.HttpServletRequest;<继承/扩展的类/接口>继承如下类：com.sdjictec.ticket.utils.BaseController第50页/共68页建投数据科技（山东）有限公司6.7.1.3输入项字段类型说明tokenstring用户秘钥idstring推荐文章id6.7.1.4输出项字段类型说明retCodestring返回码retMsgstring返回消息6.7.2生活圈列表6.7.2.1类名/文件名(及路径)列表6.7.2.2引用的资源<引用的类/包>com.sdjictec.ticket.model.metro.ItpMessage;com.sdjictec.ticket.service.ItpService;com.sdjictec.ticket.utils.BaseController;com.sdjictec.ticket.utils.ItpRequest;com.sdjictec.ticket.utils.ItpResponse;org.springframework.beans.factory.annotation.Autowired;org.springframework.web.bind.annotation.RequestMapping;org.springframework.web.bind.annotation.RestController;javax.servlet.http.HttpServletRequest;<继承/扩展的类/接口>继承如下类：com.sdjictec.ticket.utils.BaseController第51页/共68页建投数据科技（山东）有限公司6.7.2.3输入项字段类型说明Tokenstring用户秘钥idstring生活圈编码id6.7.2.4输出项字段类型说明retCodestring返回码retMsgstring返回消息listJson生活圈列表6.7.3生活圈文章详情6.7.3.1类名/文件名(及路径)列表6.7.3.2引用的资源<引用的类/包>com.sdjictec.ticket.model.metro.ItpMessage;com.sdjictec.ticket.service.ItpService;com.sdjictec.ticket.utils.BaseController;com.sdjictec.ticket.utils.ItpRequest;com.sdjictec.ticket.utils.ItpResponse;org.springframework.beans.factory.annotation.Autowired;org.springframework.web.bind.annotation.RequestMapping;org.springframework.web.bind.annotation.RestController;javax.servlet.http.HttpServletRequest;<继承/扩展的类/接口>继承如下类：com.sdjictec.ticket.utils.BaseController第52页/共68页建投数据科技（山东）有限公司6.7.3.3输入项字段类型说明tokenstring用户秘钥idstring生活圈文章id6.7.3.4输出项字段类型说明retCodestring返回码retMsgstring返回消息codestring编码titlestring文章标题contentstring文字内容6.8义务监督员6.8.1申请6.8.1.1类名/文件名(及路径)列表6.8.1.2引用的资源<引用的类/包>com.sdjictec.ticket.model.metro.ItpMessage;com.sdjictec.ticket.service.ItpService;com.sdjictec.ticket.utils.BaseController;com.sdjictec.ticket.utils.ItpRequest;com.sdjictec.ticket.utils.ItpResponse;org.springframework.beans.factory.annotation.Autowired;org.springframework.web.bind.annotation.RequestMapping;第53页/共68页建投数据科技（山东）有限公司org.springframework.web.bind.annotation.RestController;javax.servlet.http.HttpServletRequest;<继承/扩展的类/接口>继承如下类：com.sdjictec.ticket.utils.BaseController6.8.1.3输入项字段类型说明tokenstring用户秘钥idCardstring身份证号agestring年龄sexstring性别adressstring家庭住址isPartyMemberstring是否党员userLinestring常用路线familyMemberstring家庭成员createdatestring创建时间6.8.1.4输出项字段类型说明retCodestring返回码retMsgstring返回消息6.8.2审核第54页/共68页建投数据科技（山东）有限公司6.8.2.1类名/文件名(及路径)列表6.8.2.2引用的资源<引用的类/包>com.sdjictec.ticket.model.metro.ItpMessage;com.sdjictec.ticket.service.ItpService;com.sdjictec.ticket.utils.BaseController;com.sdjictec.ticket.utils.ItpRequest;com.sdjictec.ticket.utils.ItpResponse;org.springframework.beans.factory.annotation.Autowired;org.springframework.web.bind.annotation.RequestMapping;org.springframework.web.bind.annotation.RestController;javax.servlet.http.HttpServletRequest;<继承/扩展的类/接口>继承如下类：com.sdjictec.ticket.utils.BaseController6.8.2.3输入项字段类型说明tokenstring用户秘钥idstring义务监督员id6.8.2.4输出项字段类型说明retCodestring返回码retMsgstring返回消息6.9志愿者第55页/共68页建投数据科技（山东）有限公司6.9.1申请6.9.1.1类名/文件名(及路径)列表6.9.1.2引用的资源<引用的类/包>com.sdjictec.ticket.model.metro.ItpMessage;com.sdjictec.ticket.service.ItpService;com.sdjictec.ticket.utils.BaseController;com.sdjictec.ticket.utils.ItpRequest;com.sdjictec.ticket.utils.ItpResponse;org.springframework.beans.factory.annotation.Autowired;org.springframework.web.bind.annotation.RequestMapping;org.springframework.web.bind.annotation.RestController;javax.servlet.http.HttpServletRequest;<继承/扩展的类/接口>继承如下类：com.sdjictec.ticket.utils.BaseController第56页/共68页建投数据科技（山东）有限公司6.9.1.3输入项字段类型说明tokenstring用户秘钥idCardstring身份证号agestring年龄sexstring性别adressstring家庭住址isPartyMemberstring是否党员userLinestring常用路线familyMemberstring家庭成员createdatestring创建时间6.9.1.4输出项字段类型说明retCodestring返回码retMsgstring返回消息6.9.2报名6.9.2.1类名/文件名(及路径)列表6.9.2.2引用的资源<引用的类/包>com.sdjictec.ticket.model.metro.ItpMessage;com.sdjictec.ticket.service.ItpService;第57页/共68页建投数据科技（山东）有限公司com.sdjictec.ticket.utils.BaseController;com.sdjictec.ticket.utils.ItpRequest;com.sdjictec.ticket.utils.ItpResponse;org.springframework.beans.factory.annotation.Autowired;org.springframework.web.bind.annotation.RequestMapping;org.springframework.web.bind.annotation.RestController;javax.servlet.http.HttpServletRequest;<继承/扩展的类/接口>继承如下类：com.sdjictec.ticket.utils.BaseController6.9.2.3输入项字段类型说明tokenstring用户秘钥idstring志愿者id6.9.2.4输出项字段类型说明retCodestring返回码retMsgstring返回消息6.10问卷调查6.10.1管理6.10.1.1类名/文件名(及路径)列表6.10.1.2引用的资源<引用的类/包>com.sdjictec.ticket.model.metro.ItpMessage;com.sdjictec.ticket.service.ItpService;第58页/共68页建投数据科技（山东）有限公司com.sdjictec.ticket.utils.BaseController;com.sdjictec.ticket.utils.ItpRequest;com.sdjictec.ticket.utils.ItpResponse;org.springframework.beans.factory.annotation.Autowired;org.springframework.web.bind.annotation.RequestMapping;org.springframework.web.bind.annotation.RestController;javax.servlet.http.HttpServletRequest;<继承/扩展的类/接口>继承如下类：com.sdjictec.ticket.utils.BaseController6.10.1.3输入项字段类型说明tokenstring用户秘钥ticketnamestring问卷名称ticketdescstring问卷描述createtimestring创建时间6.10.1.4输出项字段类型说明retCodestring返回码retMsgstring返回消息6.10.2问卷作答6.10.2.1类名/文件名(及路径)列表6.10.2.2引用的资源<引用的类/包>com.sdjictec.ticket.model.metro.ItpMessage;第59页/共68页建投数据科技（山东）有限公司com.sdjictec.ticket.service.ItpService;com.sdjictec.ticket.utils.BaseController;com.sdjictec.ticket.utils.ItpRequest;com.sdjictec.ticket.utils.ItpResponse;org.springframework.beans.factory.annotation.Autowired;org.springframework.web.bind.annotation.RequestMapping;org.springframework.web.bind.annotation.RestController;javax.servlet.http.HttpServletRequest;<继承/扩展的类/接口>继承如下类：com.sdjictec.ticket.utils.BaseController6.10.2.3输入项字段类型说明keyBathNumberstring密钥批次号ticketNumberstring问卷idticketdetailidstring问题ticketsnswerstring答案6.10.2.4输出项字段类型说明retCodestring返回码retMsgstring返回消息6.11投票6.11.1管理6.11.1.1类名/文件名(及路径)列表第60页/共68页建投数据科技（山东）有限公司6.11.1.2引用的资源<引用的类/包>com.sdjictec.ticket.model.metro.ItpMessage;com.sdjictec.ticket.service.ItpService;com.sdjictec.ticket.utils.BaseController;com.sdjictec.ticket.utils.ItpRequest;com.sdjictec.ticket.utils.ItpResponse;org.springframework.beans.factory.annotation.Autowired;org.springframework.web.bind.annotation.RequestMapping;org.springframework.web.bind.annotation.RestController;javax.servlet.http.HttpServletRequest;<继承/扩展的类/接口>继承如下类：com.sdjictec.ticket.utils.BaseController6.11.1.3输入项字段类型说明tokenstring用户秘钥Ticketidstring投票信息6.11.1.4输出项字段类型说明retCodestring返回码retMsgstring返回消息TicketidstringIdTicketcodestring编码Ticketcreatetimestring创建时间Ticktnamestring题目名称第61页/共68页建投数据科技（山东）有限公司6.11.2投票6.11.2.1类名/文件名(及路径)列表6.11.2.2引用的资源<引用的类/包>com.sdjictec.ticket.model.metro.ItpMessage;com.sdjictec.ticket.service.ItpService;com.sdjictec.ticket.utils.BaseController;com.sdjictec.ticket.utils.ItpRequest;com.sdjictec.ticket.utils.ItpResponse;org.springframework.beans.factory.annotation.Autowired;org.springframework.web.bind.annotation.RequestMapping;org.springframework.web.bind.annotation.RestController;javax.servlet.http.HttpServletRequest;<继承/扩展的类/接口>继承如下类：com.sdjictec.ticket.utils.BaseController6.11.2.3输入项字段类型说明idstring投票IDresultJson投票结果6.11.2.4输出项字段类型说明retCodestring返回码retMsgstring返回消息第62页/共68页