机动车检测监管系统Android外检终端概要设计说明书0.9

机动车检测监管系统Android外检终端概要设计说明书Version：1.0PAGE爱信Copyright©，AllRightReserved，未经允许请勿扩散26-项目编号：版本号：V1.0密级：机动车检测监管系统Android外检终端概要设计说明书吉林省爱信网络信息科技有限公司2013年03月

文档记录文档修订记录序号修订时间修订人主要修订审核人批准人存档版本12013-3-穆东良初稿1.02345678910

TOC\o"1-3"\h\z1引言 -3-1.1编写目的 -3-1.2背景 -3-1.3参考资料 -3-2总体设计 -4-2.1系统逻辑结构 -4-2.3系统流程 -6-2.4程序结构 -11-2.5功能需求与程序的关系 -12-2.6人工处理过程 -13-2.6尚未解决的问题 -13-3接口设计 -14-3.1用户接口 -14-3.2外部接口 -14-3.3内部接口 -16-4数据结构设计 -17-4.1逻辑结构设计 -17-4.2数据表关系 -17-4.3数据结构与程序的关系 -17-5运行设计 -18-5.1运行模块组合 -18-6出错处理设计 -21-6.1出错信息 -21-6.2补救措施 -21-1引言1.1编写目的从总体设计的角度明确系统业务的处理流程，完成接口设计，把系统的功能需求分配给软件结构，形成软件的系统结构，使系统开发人员和产品管理人员明确产品功能，可以有针对性的进行系统开发、测试以及验收等各方面的工作，为以后的详细设计打下基础。本文档预期读者为项目经理、设计人员、开发人员、测试人员。1.2背景项目的委托单位：吉林省公安厅交通警察总队开发单位：吉林省爱信网络信息科技有限公司系统最终用户：检车站外检员外检终端软件是机动车检测监管系统的组成部分，使用Java语言开发。1.3参考资料《机动车检测监管系统Android外检终端需求规格说明书1.0》。2总体设计2.1系统逻辑结构1、数据操作属性设置、上次登录帐号保存到properties文件，待检车辆列表和按号牌查询出的待检车辆列表在界面缓存。数据操作如下：（1）保存属性设置（服务器连接设置、查询设置）；（2）读取查询设置（待检列表分页记录数）、服务器连接参数、版本号、客服电话；记录新版本号；（3）读取保存的上次成功登录的帐户信息；（4）刷新待检列表时，读取查询设置（待检列表分页记录数）；（5）缓存待检列表（含每车检测项和拍照完成状态）；（6）读取检测项目信息（序号、名称、拍照状态）；（7）读取检测项目信息；更新检测项拍照完成状态，或在完成外检时删除待检车辆记录；（8）同（7）；（9、读取检测项目信息；更新检测项拍照完成状态，或在完成外检时清空按号牌查询出的待检车辆列表；（10）同（9）；（11）缓存按号牌查询出的待检车俩列表（含每车检测项和拍照完成状态）；2、服务端系统接口调用见A-F。3、内部模块间关联关系a、属性设置及返回；b、版本更新；c、登录成功后显示待检列表；d、版本更新后显示待检列表；e、通过Menu菜单选择号牌查询；f、选择待检车辆顺序拍照；g、选择待检车辆顺序拍照；g’、完成外检后删除待检车辆记录，返回待检列表；h、选择检测项目拍照；h’、拍照后返回照片列表；i、拍照过程中通过Menu菜单选择照片列表；j、通过Menu菜单返回；k、通过Menu菜单刷新；l、重拍；m、重拍。2.3系统流程1、系统登录刷新待检车辆列表可参照系统登录流程。2、顺序拍照3、补充拍照4、号牌查询2.4程序结构 1、类和接口定义终端系统分为展现层（activity）、业务层（business）和服务接口层（service），包路径为com.cc.cx，各层类设置如下：类名包名描述LoginActivityactivity登录验证界面AttributeConfigActivityactivity属性设置界面VehicleListActivityactivity待检车辆列表界面PhotoListActivityactivity照片列表界面TakeAllPhotoActivityactivity顺序拍照界面TakeOnePhotoActivityactivity选择拍照界面LicenseTagQueryActivityactivity按号牌查询车辆界面UpgradeActivityactivity版本更新界面LoginBusinessbusiness登录验证服务类UpgradeBusinessbusiness版本更新业务类VehicleListQueryBusinessbusiness待检列表查询业务类LicenseTagQueryBusinessbusiness按号牌查询车辆业务类UploadPhotoBusinessbusiness上传照片业务类VehicleI待检车辆信息类CheckItemI检测项目信息类AttributeConfigI系统设置信息类LoginI登录信息类IVehicleCheckServiceservice外检服务接口VehicleCheckServiceservice外检服务类ReturnValueNameConstantconstant服务调用返回值名称常量类其中，activity类进行界面和弹出菜单创建、定义操作事件，存储界面信息，并通过调用business类实现业务处理；business类进行业务处理，封装服务请求，调用服务，解析服务响应；service类发送服务请求，接收服务响应信息；constant类便于命名查找。2、类间依赖关系2.5功能需求与程序的关系类名对应需求LoginActivity登录验证AttributeConfigActivity属性设置VehicleListActivity查询待检车辆列表PhotoListActivity查阅外检项目照片拍摄状态TakeAllPhotoActivity顺序拍照TakeOnePhotoActivity补充拍照LicenseTagQueryActivity通过号牌查询待检车辆UpgradeActivity版本更新LoginBusiness登录验证UpgradeBusiness版本更新VehicleListQueryBusiness查询待检车辆列表LicenseTagQueryBusiness通过号牌查询待检车辆UploadPhotoBusiness顺序拍照、补充拍照VehicleInfo登录验证、查询待检车辆列表、查阅外检项目照片拍摄状态、顺序拍照、补充拍照、通过号牌查询待检车辆CheckItemInfo登录验证、查询待检车辆列表、查阅外检项目照片拍摄状态、顺序拍照、补充拍照、通过号牌查询待检车辆AttributeConfigInfo属性设置、版本更新LoginInfo登录验证IVihicleCheckService登录验证、查询待检车辆列表、版本更新检测、顺序拍照、补充拍照通过号牌查询待检车辆VihicleCheckServiceReturnValueNameConstant登录验证、版本更新、查询待检车辆列表、顺序拍照、补充拍照、通过号牌查询待检车辆2.6人工处理过程1、新版本发布发布的新版本时需手工更新配置文件更新最新版本号，并将配置文件部署到Web服务相应路径。2.6尚未解决的问题1、公安网接入安全保障方式Sim卡中身份验证文件格式、命名和存储路径未约定。3接口设计3.1用户接口系统为外检员提供终端操作界面，详见《机动车检测监管系统Android外检终端需求规格说明书1.0》。3.2外部接口系统使用Java开源项目nuts在终端和服务端间通讯。1、登录验证并自动查询待检车辆列表函数体：Objectlogin（Object[]params）参数：Object[0]：String，登录账号；Object[1]：String，登录密码；Object[2]：int，待检车辆列表记录数；Object[3]：String，当前终端程序版本号。返回：Map.get(“isSysUser”)：boolean，是否为有效用户；Map.get(“hasNewVersion”)：boolean，是否存在更新版本；Map.get(“vehicleList”)：List<VehicleInfo>，待检车辆列表。2、查询待检车辆列表函数体：ObjectgetVehicleList（Object[]params）参数：Object[0]：int，待检车辆列表记录数。返回：Map.get(“vehicleList”)：List<VehicleInfo>，待检车辆列表。3、上传照片函数体：ObjectuploadPhoto（Object[]params）参数：Object[0]：String，待检车辆车牌号；Object[1]：int，检测项序号；Object[2]：blob，照片数据。返回：Map.get(“State”)：int，是否成功将图片保存到数据库，或已完成该车外检的标志。4、号牌查询函数体：ObjectqueryByLicenseTag（Object[]params）参数：Object[0]：String，待检车辆号牌部分位。返回：Map.get(“vehicleList”)：List<VehicleInfo>，查询出的待检车辆列表。5、版本更新函数体：Objectupgrade（Object[]params）参数：Object[]：null。返回：Map.get(“apk”)：blob，最新版本的apk文件；Map.get(“VersionNumber”)：String，新的终端程序版本号。3.3内部接口1、界面间数据传递通过Android应用提供的SharedPreference传递数据。SharedPreference存储数据结构定义如下：数据项类型描述vehicleListList<VehicleInfo>待检车辆列表queriedVehicleListList<VehicleInfo>按号牌查询出的待检车辆列表attributeConfigInfoAttributeConfigInfo属性设置信息loginInfoLoginInfo默认登录帐号currentLicenseTagString当前检测车辆车牌currentVehicleOrderint当前检测车辆序号currentCheckItemString当前检测项目名称currentCheckItemOrderint当前检测项目序号4数据结构设计4.1逻辑结构设计1、人员表（JCXC_PERSON）字段名数据类型可否为空说明PERSON_IDVARCHAR2(20)NOTNULL人员ID，12位检测线编码（12位地区编码）NAMEVARCHAR2(40)NOTNULL人员姓名SFZMHMVARCHAR2(18)NULL身份证号SGZBHVARCHAR2(12)NOTNULL上岗证编号SJHMVARCHAR2(20)NOTNULL手机号码GSDWVARCHAR2(14)NOTNULL归属单位YWGWVARCHAR2(6)NOTNULL岗位A预审B外检C内检D路试E打印报告单F资料复核G打印合格贴H动态I底盘WYZWVARCHAR2(10)NOTNULL业务职位PDAIDVARCHAR2(20)NOTNULL手持机编号XTLBVARCHAR2(2)NULL系统类别0检测线1中心ZTNUMBERNOTNULL状态0初始1正常2停用AREACODEVARCHAR2(12)NOTNULL地区BZVARCHAR2(100)NOTNULL备注JYWVARCHAR2(40)NOTNULL校验位SCZTVARCHAR2(1)NOTNULL('0')2、用户表（JAX_MUSER）字段名数据类型可否为空说明USERIDVARCHAR2(12)NULL用户ID登陆证号PERSON_IDVARCHAR2(20)NOTNULL人员IDPASSWORDVARCHAR2(40)NOTNULL用户密码UTYPECHAR(1) NOTNULL用户类型0系统管理员1站内用户2第三方用户CMPIPVARCHAR2(20)NOTNULL绑定计算机ZTCHAR(1) NOTNULL状态0初始1正常2停用SFIPBDVARCHAR2(1)NOTNULL是否启用IP绑定0不启用1启用SFDDDLVARCHAR2(1)NOTNULL是否允许多点登陆0不允许1允许OLKEYVARCHAR2(32)NOTNULL登陆KEYPARENTIDNVARCHAR2(20)NOTNULL父用户ID3、外检车辆信息表（JAX_VEHICLE_INFO）字段名数据类型可否为空说明CJXLH VARCHAR2(26)NULLJYLB VARCHAR2(1)NOTNULLHPHM VARCHAR2(15)NOTNULLSYR VARCHAR2(80)NOTNULLHPZL VARCHAR2(2)NOTNULLCLLB1 VARCHAR2(10)NOTNULLCLLB2 VARCHAR2(10)NOTNULLCLLB3 VARCHAR2(10)NOTNULLPPXH VARCHAR2(50)NOTNULLCLSBM VARCHAR2(25)NOTNULLFDJH VARCHAR2(50)NOTNULLRLZL VARCHAR2(3)NOTNULLQDXS VARCHAR2(10)NOTNULLZCZ VARCHAR2(10)NOTNULLSFDLXG VARCHAR2(1)NOTNULLDZ VARCHAR2(1)NOTNULLQZDNFTZ VARCHAR2(1)NOTNULLDJRQ VARCHAR2(20)NOTNULLCCRQ VARCHAR2(20)NOTNULLLCBDS NUMBER NOTNULLSFXC VARCHAR2(1)NOTNULLJYXM VARCHAR2(50)NOTNULLDLY VARCHAR2(20)NOTNULLYCY VARCHAR2(20)NOTNULLJYLX VARCHAR2(1)NOTNULLZS NUMBER NOTNULLSFLS VARCHAR2(1)NOTNULLSFWLZY VARCHAR2(1)NOTNULLCLZZL NUMBER NULLCLZBZL NUMBER NULLHDZZL NUMBER NULLYWLX VARCHAR2(2)NOTNULLSBHPHM VARCHAR2(20)NOTNULLZPSFWZ1 VARCHAR2(20)NOTNULLZPSFWZ2 VARCHAR2(20)NOTNULLZPSFWZ3 VARCHAR2(20)NOTNULLZPSFWZ4 VARCHAR2(20)NOTNULLJYSJ VARCHAR2(20)NOTNULLGXSJ VARCHAR2(20)NOTNULLYWGW VARCHAR2(10)NOTNULLDQGW VARCHAR2(1) NOTNULLXYGW VARCHAR2(1)NOTNULLJCCS NUMBER NOTNULLSFCS NUMBER NOTNULLSFDQ VARCHAR2(1)NOTNULLSFWZ VARCHAR2(1)NOTNULLSFQB VARCHAR2(1)NOTNULLJYW VARCHAR2(1024)NOTNULLZT VARCHAR2(1)NOTNULLGWZT VARCHAR2(1)NOTNULL岗位状态SCZT VARCHAR2(1)NOTNULLSFYPZDY VARCHAR2(1)NOTNULLYPDSFZQ VARCHAR2(10)NOTNULLSHRY VARCHAR2(40)NOTNULLMODIFYTIMEVARCHAR2(20)NOTNULLJCJG VARCHAR2(1)NOTNULLBZ VARCHAR2(60)NOTNULLWJRY VARCHAR2(40)NOTNULLWJRYBH VARCHAR2(20)NOTNULLHDZK VARCHAR2(10)NOTNULLWJXM VARCHAR2(100)NOTNULLDHJQXS VARCHAR2(10)NOTNULLZDXS VARCHAR2(10)NOTNULLCSYS VARCHAR2(10)NOTNULLDTRY VARCHAR2(20)NOTNULLDTXM VARCHAR2(100)NOTNULLJCXNUM VARCHAR2(2)NOTNULLTBZT VARCHAR2(1)NOTNULLHGSJ VARCHAR2(20)NOTNULL车辆检测合格时间TBSJ VARCHAR2(20)NOTNULL同步完成时间TJSJ VARCHAR2(20)NOTNULL提交复核申请时间QQSJ VARCHAR2(20)NOTNULL总队收到请求时间SLSJ VARCHAR2(20)NOTNULL总队受理时间BJSJ VARCHAR2(20)NOTNULL总队办结时间XZSJ VARCHAR2(20)NOTNULL检测线下载审核结果时间JZSJ VARCHAR2(20)NOTNULL总队加载审核信息时间4、车辆外检项目表（JAX_PHOTO_INFO）字段名数据类型可否为空说明XMLBCHAR(1)NULL项目类别JYXMVARCHAR2(20)NULL检测项目XMMCVARCHAR2(50)NOTNULL项目名称IFPDXMCHAR(1)NOTNULLIFFJXCHAR(1)NOTNULLZTCHAR(1)NOTNULL状态SXHNUMBERNOTNULL顺序号SFTYXMVARCHAR2(100)NOTNULLUPDATETIMEVARCHAR2(14)NOTNULL20110226081852的形式,数据的修改时间,用来同步操作.SCZTVARCHAR2(1)NOTNULL5、检测项目信息表（JAX_PHOTO_INFO）字段名数据类型可否为空说明ZPBMVARCHAR2(6)NULL照片编码PTYPECHAR(1)NOTNULLZPNAMEVARCHAR2(40)NOTNULL照片名称SXHNUMBERNOTNULL顺序号ZTCHAR(1)NOTNULL状态SFTYXMCHAR(1)NOTNULLBZVARCHAR2(60)NOTNULL备注UPDATETIMEVARCHAR2(14)NOTNULL20110226081852的形式,数据的修改时间,用来同步操作.6、车辆外检照片表（JAX_PHOTO_WJ）字段名