機(jī)動(dòng)車檢測(cè)監(jiān)管系統(tǒng)Android外檢終端概要設(shè)計(jì)說(shuō)明書(shū)0.9

機(jī)動(dòng)車檢測(cè)監(jiān)管系統(tǒng)Android外檢終端概要設(shè)計(jì)說(shuō)明書(shū)Version：1.0PAGE愛(ài)信Copyright?，AllRightReserved，未經(jīng)允許請(qǐng)勿擴(kuò)散26-項(xiàng)目編號(hào)：版本號(hào)：V1.0密級(jí)：機(jī)動(dòng)車檢測(cè)監(jiān)管系統(tǒng)Android外檢終端概要設(shè)計(jì)說(shuō)明書(shū)吉林省愛(ài)信網(wǎng)絡(luò)信息科技有限公司2013年03月

文檔記錄文檔修訂記錄序號(hào)修訂時(shí)間修訂人主要修訂審核人批準(zhǔn)人存檔版本12013-3-穆東良初稿1.02345678910

TOC\o"1-3"\h\z1引言 -3-1.1編寫(xiě)目的 -3-1.2背景 -3-1.3參考資料 -3-2總體設(shè)計(jì) -4-2.1系統(tǒng)邏輯結(jié)構(gòu) -4-2.3系統(tǒng)流程 -6-2.4程序結(jié)構(gòu) -11-2.5功能需求與程序的關(guān)系 -12-2.6人工處理過(guò)程 -13-2.6尚未解決的問(wèn)題 -13-3接口設(shè)計(jì) -14-3.1用戶接口 -14-3.2外部接口 -14-3.3內(nèi)部接口 -16-4數(shù)據(jù)結(jié)構(gòu)設(shè)計(jì) -17-4.1邏輯結(jié)構(gòu)設(shè)計(jì) -17-4.2數(shù)據(jù)表關(guān)系 -17-4.3數(shù)據(jù)結(jié)構(gòu)與程序的關(guān)系 -17-5運(yùn)行設(shè)計(jì) -18-5.1運(yùn)行模塊組合 -18-6出錯(cuò)處理設(shè)計(jì) -21-6.1出錯(cuò)信息 -21-6.2補(bǔ)救措施 -21-1引言1.1編寫(xiě)目的從總體設(shè)計(jì)的角度明確系統(tǒng)業(yè)務(wù)的處理流程，完成接口設(shè)計(jì)，把系統(tǒng)的功能需求分配給軟件結(jié)構(gòu)，形成軟件的系統(tǒng)結(jié)構(gòu)，使系統(tǒng)開(kāi)發(fā)人員和產(chǎn)品管理人員明確產(chǎn)品功能，可以有針對(duì)性的進(jìn)行系統(tǒng)開(kāi)發(fā)、測(cè)試以及驗(yàn)收等各方面的工作，為以后的詳細(xì)設(shè)計(jì)打下基礎(chǔ)。本文檔預(yù)期讀者為項(xiàng)目經(jīng)理、設(shè)計(jì)人員、開(kāi)發(fā)人員、測(cè)試人員。1.2背景項(xiàng)目的委托單位：吉林省公安廳交通警察總隊(duì)開(kāi)發(fā)單位：吉林省愛(ài)信網(wǎng)絡(luò)信息科技有限公司系統(tǒng)最終用戶：檢車站外檢員外檢終端軟件是機(jī)動(dòng)車檢測(cè)監(jiān)管系統(tǒng)的組成部分，使用Java語(yǔ)言開(kāi)發(fā)。1.3參考資料《機(jī)動(dòng)車檢測(cè)監(jiān)管系統(tǒng)Android外檢終端需求規(guī)格說(shuō)明書(shū)1.0》。2總體設(shè)計(jì)2.1系統(tǒng)邏輯結(jié)構(gòu)1、數(shù)據(jù)操作屬性設(shè)置、上次登錄帳號(hào)保存到properties文件，待檢車輛列表和按號(hào)牌查詢出的待檢車輛列表在界面緩存。數(shù)據(jù)操作如下：（1）保存屬性設(shè)置（服務(wù)器連接設(shè)置、查詢?cè)O(shè)置）；（2）讀取查詢?cè)O(shè)置（待檢列表分頁(yè)記錄數(shù)）、服務(wù)器連接參數(shù)、版本號(hào)、客服電話；記錄新版本號(hào)；（3）讀取保存的上次成功登錄的帳戶信息；（4）刷新待檢列表時(shí)，讀取查詢?cè)O(shè)置（待檢列表分頁(yè)記錄數(shù)）；（5）緩存待檢列表（含每車檢測(cè)項(xiàng)和拍照完成狀態(tài)）；（6）讀取檢測(cè)項(xiàng)目信息（序號(hào)、名稱、拍照狀態(tài)）；（7）讀取檢測(cè)項(xiàng)目信息；更新檢測(cè)項(xiàng)拍照完成狀態(tài)，或在完成外檢時(shí)刪除待檢車輛記錄；（8）同（7）；（9、讀取檢測(cè)項(xiàng)目信息；更新檢測(cè)項(xiàng)拍照完成狀態(tài)，或在完成外檢時(shí)清空按號(hào)牌查詢出的待檢車輛列表；（10）同（9）；（11）緩存按號(hào)牌查詢出的待檢車倆列表（含每車檢測(cè)項(xiàng)和拍照完成狀態(tài)）；2、服務(wù)端系統(tǒng)接口調(diào)用見(jiàn)A-F。3、內(nèi)部模塊間關(guān)聯(lián)關(guān)系a、屬性設(shè)置及返回；b、版本更新；c、登錄成功后顯示待檢列表；d、版本更新后顯示待檢列表；e、通過(guò)Menu菜單選擇號(hào)牌查詢；f、選擇待檢車輛順序拍照；g、選擇待檢車輛順序拍照；g’、完成外檢后刪除待檢車輛記錄，返回待檢列表；h、選擇檢測(cè)項(xiàng)目拍照；h’、拍照后返回照片列表；i、拍照過(guò)程中通過(guò)Menu菜單選擇照片列表；j、通過(guò)Menu菜單返回；k、通過(guò)Menu菜單刷新；l、重拍；m、重拍。2.3系統(tǒng)流程1、系統(tǒng)登錄刷新待檢車輛列表可參照系統(tǒng)登錄流程。2、順序拍照3、補(bǔ)充拍照4、號(hào)牌查詢2.4程序結(jié)構(gòu) 1、類和接口定義終端系統(tǒng)分為展現(xiàn)層（activity）、業(yè)務(wù)層（business）和服務(wù)接口層（service），包路徑為com.cc.cx，各層類設(shè)置如下：類名包名描述LoginActivityactivity登錄驗(yàn)證界面AttributeConfigActivityactivity屬性設(shè)置界面VehicleListActivityactivity待檢車輛列表界面PhotoListActivityactivity照片列表界面TakeAllPhotoActivityactivity順序拍照界面TakeOnePhotoActivityactivity選擇拍照界面LicenseTagQueryActivityactivity按號(hào)牌查詢車輛界面UpgradeActivityactivity版本更新界面LoginBusinessbusiness登錄驗(yàn)證服務(wù)類UpgradeBusinessbusiness版本更新業(yè)務(wù)類VehicleListQueryBusinessbusiness待檢列表查詢業(yè)務(wù)類LicenseTagQueryBusinessbusiness按號(hào)牌查詢車輛業(yè)務(wù)類UploadPhotoBusinessbusiness上傳照片業(yè)務(wù)類VehicleI待檢車輛信息類CheckItemI檢測(cè)項(xiàng)目信息類AttributeConfigI系統(tǒng)設(shè)置信息類LoginI登錄信息類IVehicleCheckServiceservice外檢服務(wù)接口VehicleCheckServiceservice外檢服務(wù)類ReturnValueNameConstantconstant服務(wù)調(diào)用返回值名稱常量類其中，activity類進(jìn)行界面和彈出菜單創(chuàng)建、定義操作事件，存儲(chǔ)界面信息，并通過(guò)調(diào)用business類實(shí)現(xiàn)業(yè)務(wù)處理；business類進(jìn)行業(yè)務(wù)處理，封裝服務(wù)請(qǐng)求，調(diào)用服務(wù)，解析服務(wù)響應(yīng)；service類發(fā)送服務(wù)請(qǐng)求，接收服務(wù)響應(yīng)信息；constant類便于命名查找。2、類間依賴關(guān)系2.5功能需求與程序的關(guān)系類名對(duì)應(yīng)需求LoginActivity登錄驗(yàn)證AttributeConfigActivity屬性設(shè)置VehicleListActivity查詢待檢車輛列表PhotoListActivity查閱外檢項(xiàng)目照片拍攝狀態(tài)TakeAllPhotoActivity順序拍照TakeOnePhotoActivity補(bǔ)充拍照LicenseTagQueryActivity通過(guò)號(hào)牌查詢待檢車輛UpgradeActivity版本更新LoginBusiness登錄驗(yàn)證UpgradeBusiness版本更新VehicleListQueryBusiness查詢待檢車輛列表LicenseTagQueryBusiness通過(guò)號(hào)牌查詢待檢車輛UploadPhotoBusiness順序拍照、補(bǔ)充拍照VehicleInfo登錄驗(yàn)證、查詢待檢車輛列表、查閱外檢項(xiàng)目照片拍攝狀態(tài)、順序拍照、補(bǔ)充拍照、通過(guò)號(hào)牌查詢待檢車輛CheckItemInfo登錄驗(yàn)證、查詢待檢車輛列表、查閱外檢項(xiàng)目照片拍攝狀態(tài)、順序拍照、補(bǔ)充拍照、通過(guò)號(hào)牌查詢待檢車輛AttributeConfigInfo屬性設(shè)置、版本更新LoginInfo登錄驗(yàn)證IVihicleCheckService登錄驗(yàn)證、查詢待檢車輛列表、版本更新檢測(cè)、順序拍照、補(bǔ)充拍照通過(guò)號(hào)牌查詢待檢車輛VihicleCheckServiceReturnValueNameConstant登錄驗(yàn)證、版本更新、查詢待檢車輛列表、順序拍照、補(bǔ)充拍照、通過(guò)號(hào)牌查詢待檢車輛2.6人工處理過(guò)程1、新版本發(fā)布發(fā)布的新版本時(shí)需手工更新配置文件更新最新版本號(hào)，并將配置文件部署到Web服務(wù)相應(yīng)路徑。2.6尚未解決的問(wèn)題1、公安網(wǎng)接入安全保障方式Sim卡中身份驗(yàn)證文件格式、命名和存儲(chǔ)路徑未約定。3接口設(shè)計(jì)3.1用戶接口系統(tǒng)為外檢員提供終端操作界面，詳見(jiàn)《機(jī)動(dòng)車檢測(cè)監(jiān)管系統(tǒng)Android外檢終端需求規(guī)格說(shuō)明書(shū)1.0》。3.2外部接口系統(tǒng)使用Java開(kāi)源項(xiàng)目nuts在終端和服務(wù)端間通訊。1、登錄驗(yàn)證并自動(dòng)查詢待檢車輛列表函數(shù)體：Objectlogin（Object[]params）參數(shù)：Object[0]：String，登錄賬號(hào)；Object[1]：String，登錄密碼；Object[2]：int，待檢車輛列表記錄數(shù)；Object[3]：String，當(dāng)前終端程序版本號(hào)。返回：Map.get(“isSysUser”)：boolean，是否為有效用戶；Map.get(“hasNewVersion”)：boolean，是否存在更新版本；Map.get(“vehicleList”)：List<VehicleInfo>，待檢車輛列表。2、查詢待檢車輛列表函數(shù)體：ObjectgetVehicleList（Object[]params）參數(shù)：Object[0]：int，待檢車輛列表記錄數(shù)。返回：Map.get(“vehicleList”)：List<VehicleInfo>，待檢車輛列表。3、上傳照片函數(shù)體：ObjectuploadPhoto（Object[]params）參數(shù)：Object[0]：String，待檢車輛車牌號(hào)；Object[1]：int，檢測(cè)項(xiàng)序號(hào)；Object[2]：blob，照片數(shù)據(jù)。返回：Map.get(“State”)：int，是否成功將圖片保存到數(shù)據(jù)庫(kù)，或已完成該車外檢的標(biāo)志。4、號(hào)牌查詢函數(shù)體：ObjectqueryByLicenseTag（Object[]params）參數(shù)：Object[0]：String，待檢車輛號(hào)牌部分位。返回：Map.get(“vehicleList”)：List<VehicleInfo>，查詢出的待檢車輛列表。5、版本更新函數(shù)體：Objectupgrade（Object[]params）參數(shù)：Object[]：null。返回：Map.get(“apk”)：blob，最新版本的apk文件；Map.get(“VersionNumber”)：String，新的終端程序版本號(hào)。3.3內(nèi)部接口1、界面間數(shù)據(jù)傳遞通過(guò)Android應(yīng)用提供的SharedPreference傳遞數(shù)據(jù)。SharedPreference存儲(chǔ)數(shù)據(jù)結(jié)構(gòu)定義如下：數(shù)據(jù)項(xiàng)類型描述vehicleListList<VehicleInfo>待檢車輛列表queriedVehicleListList<VehicleInfo>按號(hào)牌查詢出的待檢車輛列表attributeConfigInfoAttributeConfigInfo屬性設(shè)置信息loginInfoLoginInfo默認(rèn)登錄帳號(hào)currentLicenseTagString當(dāng)前檢測(cè)車輛車牌currentVehicleOrderint當(dāng)前檢測(cè)車輛序號(hào)currentCheckItemString當(dāng)前檢測(cè)項(xiàng)目名稱currentCheckItemOrderint當(dāng)前檢測(cè)項(xiàng)目序號(hào)4數(shù)據(jù)結(jié)構(gòu)設(shè)計(jì)4.1邏輯結(jié)構(gòu)設(shè)計(jì)1、人員表（JCXC_PERSON）字段名數(shù)據(jù)類型可否為空說(shuō)明PERSON_IDVARCHAR2(20)NOTNULL人員ID，12位檢測(cè)線編碼（12位地區(qū)編碼）NAMEVARCHAR2(40)NOTNULL人員姓名SFZMHMVARCHAR2(18)NULL身份證號(hào)SGZBHVARCHAR2(12)NOTNULL上崗證編號(hào)SJHMVARCHAR2(20)NOTNULL手機(jī)號(hào)碼GSDWVARCHAR2(14)NOTNULL歸屬單位YWGWVARCHAR2(6)NOTNULL崗位A預(yù)審B外檢C內(nèi)檢D路試E打印報(bào)告單F資料復(fù)核G打印合格貼H動(dòng)態(tài)I底盤(pán)WYZWVARCHAR2(10)NOTNULL業(yè)務(wù)職位PDAIDVARCHAR2(20)NOTNULL手持機(jī)編號(hào)XTLBVARCHAR2(2)NULL系統(tǒng)類別0檢測(cè)線1中心ZTNUMBERNOTNULL狀態(tài)0初始1正常2停用AREACODEVARCHAR2(12)NOTNULL地區(qū)BZVARCHAR2(100)NOTNULL備注JYWVARCHAR2(40)NOTNULL校驗(yàn)位SCZTVARCHAR2(1)NOTNULL('0')2、用戶表（JAX_MUSER）字段名數(shù)據(jù)類型可否為空說(shuō)明USERIDVARCHAR2(12)NULL用戶ID登陸證號(hào)PERSON_IDVARCHAR2(20)NOTNULL人員IDPASSWORDVARCHAR2(40)NOTNULL用戶密碼UTYPECHAR(1) NOTNULL用戶類型0系統(tǒng)管理員1站內(nèi)用戶2第三方用戶CMPIPVARCHAR2(20)NOTNULL綁定計(jì)算機(jī)ZTCHAR(1) NOTNULL狀態(tài)0初始1正常2停用SFIPBDVARCHAR2(1)NOTNULL是否啟用IP綁定0不啟用1啟用SFDDDLVARCHAR2(1)NOTNULL是否允許多點(diǎn)登陸0不允許1允許OLKEYVARCHAR2(32)NOTNULL登陸KEYPARENTIDNVARCHAR2(20)NOTNULL父用戶ID3、外檢車輛信息表（JAX_VEHICLE_INFO）字段名數(shù)據(jù)類型可否為空說(shuō)明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崗位狀態(tài)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車輛檢測(cè)合格時(shí)間TBSJ VARCHAR2(20)NOTNULL同步完成時(shí)間TJSJ VARCHAR2(20)NOTNULL提交復(fù)核申請(qǐng)時(shí)間QQSJ VARCHAR2(20)NOTNULL總隊(duì)收到請(qǐng)求時(shí)間SLSJ VARCHAR2(20)NOTNULL總隊(duì)受理時(shí)間BJSJ VARCHAR2(20)NOTNULL總隊(duì)辦結(jié)時(shí)間XZSJ VARCHAR2(20)NOTNULL檢測(cè)線下載審核結(jié)果時(shí)間JZSJ VARCHAR2(20)NOTNULL總隊(duì)加載審核信息時(shí)間4、車輛外檢項(xiàng)目表（JAX_PHOTO_INFO）字段名數(shù)據(jù)類型可否為空說(shuō)明XMLBCHAR(1)NULL項(xiàng)目類別JYXMVARCHAR2(20)NULL檢測(cè)項(xiàng)目XMMCVARCHAR2(50)NOTNULL項(xiàng)目名稱IFPDXMCHAR(1)NOTNULLIFFJXCHAR(1)NOTNULLZTCHAR(1)NOTNULL狀態(tài)SXHNUMBERNOTNULL順序號(hào)SFTYXMVARCHAR2(100)NOTNULLUPDATETIMEVARCHAR2(14)NOTNULL20110226081852的形式,數(shù)據(jù)的修改時(shí)間,用來(lái)同步操作.SCZTVARCHAR2(1)NOTNULL5、檢測(cè)項(xiàng)目信息表（JAX_PHOTO_INFO）字段名數(shù)據(jù)類型可否為空說(shuō)明ZPBMVARCHAR2(6)NULL照片編碼PTYPECHAR(1)NOTNULLZPNAMEVARCHAR2(40)NOTNULL照片名稱SXHNUMBERNOTNULL順序號(hào)ZTCHAR(1)NOTNULL狀態(tài)SFTYXMCHAR(1)NOTNULLBZVARCHAR2(60)NOTNULL備注UPDATETIMEVARCHAR2(14)NOTNULL20110226081852的形式,數(shù)據(jù)的修改時(shí)間,用來(lái)同步操作.6、車輛外檢照片表（JAX_PHOTO_WJ）字段名