业务系统软件概要设计说明书.docx

1、业务系统软件概要设计说明书. 深圳市华域无线技术有限公司密级文档编号软件概要设计说明书页 数共 页版 本A .0生效日期HSWOKR业务系统软件概要设计说明书 制 定： Ben Zhong审 核： 批 准：深圳市华域无线技术有限公司Shenzhen Hojy Wireless Technology Co., Ltd.修订履历页 次123发行版A .0最新版本A .0A .0A .0生效日期修订日期修订页次修改前版次修订后版次修 订 内 容确认2012-03-26初稿钟斌2012-04-24修改接口：最新版本查询接口，验证码计算方法，去除content-md5，增加IMEI和SN做为MD5计算值

2、钟斌2012-05-07更新4.2章节，增加相关的界面钟斌2012-05-29更新4.1.1章节，增加长度说明钟斌2012-6-12更新3.2.2和3.2.3章节，增加用户名命名规范和update.zip升级包大小限制钟斌1引言22.1目的2.2本设计文档的输入文档为HSWORK解决方案。它主要的目标是细化系统软件功能模块，定义系统软件架构，定义通讯接口，设计数据库结构及相关运行环境的配置等。2.3范围2.42.4.1本文档适用于HSWORK项目2.4.22.4.3本文档适于开发人员，测试人员以及后续开发的设计人员2.4.42.5定义2.6UE：user equipment 用户设备HSWOR

3、K：华域升级业务系统OSS：Open Storage Service 阿里巴巴云计算公司提供的开放云存储服务2.7参考资料2.813-产品版本管理办法A_2.pdf3软件系统状态和交互描述44.1软件系统结构和层次结构4.2图中HSWORK业务系统部分为本文档设计部分。4.3软件系统原理描述4.41、发布版本: 1,1、制作升级包，将它放在阿里的云存储中。 1.2、新增版本信息，配置策略2、查询版本信息3、返回当前版本信息，如果有更新，则返回升级包下载地址4、下载升级包5、终端升级4.5软件系统交互描述4.64.74.8系统软件设计图说明：1、界面链接请求，view控制器处理请求；2、3、vi

4、ew控制器加载界面内容；4、5、view控制器将界面内容，返回给浏览器；6、7、如遇到界面为Grid，则发送ajax请求；json控制器负责处理ajax数据请求；8、9、Json控制器准备好格式化数据；10、11、Json控制器通过调用service封装好的业务服务方法生成所需的json数据；12、13、将JSON数据返回浏览器，浏览器将会通过jqgrid将数据呈现给用户；14、5软件系统设计66.1软件设计概念和原理6.26.36.4controller此包主要用于接受相关的来自客户端request请求，包括GET，POST，PUT，DELETE，以及ajax数据请求domain主要是和数据

5、库表结构相关，一个数据库实体表对应一个类json此包提供jqgrid请求所需要的数据，通过json格式persistence它是一个数据库持久层，往下和数据库通讯，往上和业务层通讯此层主要是处理SQL，它在XML中进行定义service此包主要一个业务接口层或是业务接口层，对外提供业务接口和业务接口封装实现6.5系统模块设计6.66.6.1基础数据管理模块6.6.21、客户代码维护2、规则：两位数字组成操作：C（增加）U（修改）R（查询）D（删除）3、产品名称维护4、规则：V + 产品类别 + 产品型号 + R + 0-9 + 0-9 + C + 0-9 + 0-9 + S + 客户代码 操作

6、：C（增加）U（修改）R（查询）D（删除）5、产品类别维护 (class)6、规则：1-代表TD类2-代表WCDMA 类3-代表EDGE 类操作：C（增加）U（修改）R（查询）D（删除）7、产品型号维护 (model)8、规则：产品类型 + 0-9 + 0-9操作：C（增加）U（修改）R（查询）D（删除）9、产品类型维护(type)10、规则：1 代表TD 智能手机2 代表WCDMA 智能手机3 代表USB产品类型数据卡5 代表USB及UART串口混合类型的Module6 代表mini-PCIE 接口类型的Module8 代表普通手机操作：C（增加）U（修改）R（查询）D（删除）6.6.3软件

7、版本维护模块6.6.41、新增版本2、上传完整版本文件：V + 产品类别 + 产品型号 + R + 0-9 + 0-9 + C + 0-9 + 0-9 + S + 客户代码.zip，此完整版本文件和工具中所用的版本文件不一样，它是需要可以支持终端自主写flash的。上传步长为1的升级包文件：update.zip，如当前最新的版本为R06,那么此升级包提供给R05版本；上传步长为2的升级包文件：update.zip，如当前最新的版本为R06,那么此升级包提供给R04版本；上传步长为3的升级包文件：update.zip，如当前最新的版本为R06,那么此升级包提供给R03版本；update.zip文

8、件大小不超过10M3、发布版本4、发布Bata版本：用于测试发布Release版本5、版本管理6、维护历史版本，针对Release版本不允许删除和修改，6.6.5系统设置模块6.6.6升级策略配置：控制升级终端的数量，指定哪些型号，哪个客户可以升级。用户维护用户名命名规则：1、只能以字母开头2、区分大小写，3、只能由字母和数字组成4、用户名长度为616角色维护6.6.7WebService接口模块(详见接口设计部分)6.6.81、最新版本查询2、HSWORK处理查询请求流程UE查询版本时序图3、终端信息上报4、5、升级包下载6、7接口设计88.1终端通讯接口8.28.2.1最新版本查询8.2.

9、2请求消息接口：GET /newversion HTTP/1.1 rnHost: rnDate: Wed, 12 Apr 2011 17:50:00 GMTrnX-HOJY-Version: V1312R01C01S99rnX-HOJY-Authorization: HOJY_c8fdb181845a4ca6b8fec737b3581d76rnX-HOJY-IMEI:12234567890000rnX-HOJY-SN:1234567898888rnrn注：X-HOJY-Authorization验证码计算方法如下：X-HOJY-Authorization: HOJY_ + MD5(MD5(X-

10、HOJY-IMEI + X-HOJY-SN) + “n” + DATE + “n” + RequestResource)其中：DATE表示此次操作的时间RequestResource表示http请求中的资源，如此样例中为：/newversionDATE和RequestResource不能为空响应消息接口：HTTP/1.1 200 OKDate: Wed, 01 Mar 2011 12:00:00 GMTContent-Type: application/xmlContent-Length: 302Connection: closeServer:HServer V1312R01C01S99 1

11、firmware name 简体中文描述 firmware release Description c61ce360a734c018685fbf5e1662c0fd 16787 0 0 0 http:/10.0.0.1/hswork/update.zip http:/10.0.0.2/hswork/update.zip 字段说明序号字段名意义长度备注1ver版本参考13-产品版本管理办法A_2.pdf中嵌入式软件版本长度2num文件数量暂不启用，默认值为：13name名称暂不启用4desc_cn中文说明暂不启用5desc_en英文说明暂不启用6md5MD5检验码327size大小8level层级：0-无差分，完整升级；1-部分差分；2-完全差分； 暂不启用，默认值为：09needbackup是否需要备份：0-不需要；1-需要；暂不启用，默认值为：010needrestart是否需要重启：0-不需要；1-需要；暂不启用，默认值为：011downloadurlupdate.zip下载URL255注：如无最新的版本则返回201消息。样例如下：HTTP/1.1 201 OKDate: Wed, 01 Mar 2011 12:00:00 GMTContent-Length: 0Connection: closeServer:HServer8