《集团客户门户_详细设计规格说明书.docx》由会员分享，可在线阅读，更多相关《集团客户门户_详细设计规格说明书.docx（62页珍藏版）》请在三一办公上搜索。
1、AsiaInfo 项目管理文档中国移动河南公司详细设计说明书集团门户编 写李现辉编写 时间2012.02.14审 批审批 时间版本V1.0.1亚信科技（中国）有限公司版权所有文档中的全部内容属亚信科技（中国）有限公司所有，未经允许，不可全部或部分发表、复制、使用于任何目的。 中国移动河南公司网上营业厅详细设计说明书文档修订摘要日期修订号描述著者审阅者亚信科技（中国）有限公司版权所有文档中的全部内容属亚信科技（中国）有限公司所有，未经允许，不可全部或部分发表、复制、使用于任何目的。目录1 引言31.1 文档用途31.2 阅读对象31.3 名词术语31.4 参考资料12 概述22.1 集团客户门户
2、系统概述22.2 集团客户门户系统功能定义22.3 设计约束33 总体结构说明43.1 子系统结构43.1.1 依赖的外部接口43.2 BOSS3.0接口43.3 登录接口43.3.1 对外提供的接口44 数据模型（DATA MODEL）设计54.1 集团门户可配置数据模型54.2 用户角色表54.3 角色表64.4 角色功能表64.5 功能表74.6 预约表84.7 地市编码表85 功能实现说明105.1 用户登录105.2 权限控制125.2.1 角色菜单配置125.2.2 权限过滤器135.3 集团成员管理145.3.1 管理产品管理员145.3.2 管理账单管理员185.4 集团产品管
3、理215.4.1 已开通的业务查询215.4.2 集团账单查询225.5 集团账户管理245.5.1 集团资料维护245.6 集团产品275.6.1集团V网预约275.6.2手机邮箱305.6.3集团彩铃335.6.4短信信箱365.6.5成员管理405.7 集团门户首页425.7.1集团门户首页425.8 自助办理435.8.1集团门户账户开户预约435.8.2 集团账户开户预约查询455.8.3 集团账户开户预约查询461 引言1.1 文档用途中国移动河南分公司集团客户门户为中国移动河南分公司电子渠道的一部分，涉及到集团账户预约，集团产品管理等众多可以在网上直接办理和查询的业务本文档的设计
4、对象为网站web系统，主要从需求出发，基于总体设计，描述了各具体功能点的业务流程、实现设计、交互设计、类设计等。本文档主要面向系统实现/编程人员，对下一阶段的程序编码工作提供依据，同时也是用户确认设计的依据。1.2 阅读对象本文阅读对象包括：l 开发工程师：通过本文了解整个产品设计背景。l 业务咨询师：通过本文了解产品整个产品的设计背景，从而汲取咨询素材。l 测试工程师：通过本文了解整个产品设计背景。l 其它相关人员：如使用产品的电信运营商，或者从事基础技术研究的工程师1.3 名词术语BOSS：业务支撑系统。2中国移动河南公司网上营业厅详细设计说明书1.4 参考资料中国移动集团客户门户业务规范
5、（V1.0.0）。中国移动集团客户门户业务开发角色赋权及业务预约模块。2 概述2.1 集团客户门户系统概述中国移动集团客户门户，是中国移动通信为打造一流企业的一流门户，提升集团客户业务受理便捷性，提高中国移动通信集团公司的集团客户服务水平，同时有效降低集团客户的服务营销成本，中国移动通信集团拟在统一门户下的集团客户门户为集团客户提供在线自助服务。对动力100网站、集团业务网站等进行了有效整合、统一管理、统一认证的网站，以服务、营销和销售作为主要职能，兼顾企业宣传。2.2 集团客户门户系统功能定义集团产品管理已开通业务查询产品订购状态查询产品分配集团账单查询集团成员管理管理产品管理员添加产品管理
6、员删除管理产品管理员修改管理产品管理员查询产品管理员首页初始化管理账单管理员添加账单管理员删除账单管理员修改账单管理员查询账单管理员产品分类集团V网集团彩铃集团短彩信短信信箱2.3 设计约束网上营业厅的开发遵从以下几个规范：l J2EE技术规范l 中国移动NG1-CRM3.5业务规范l 使用eclipse3.2版本进行开发软件和硬件的约束请参考产品需求规格说明书。设计工具：Microsoft Word2003、Microsoft Visio2007、eclipse3.2。3 总体结构说明3.1 子系统结构3.1.1 依赖的外部接口3.1.1.1 集团预约接口（HTTP+PSOT+XML）3.1
7、.1.1.1 集团账户开户预约接口标准定义接口发送地址是：http:/218.206.204.18:8082/jttiyan/order/zhorder.action此接口采用HTTP+POST+XML传入参数列表参数名字参数说明备注TransactionID事务ID 全局唯一以毫秒为单位的当前时间（必填项）Platform平台编码目前集团客户门户帐号预约暂定为JTMHZHYY（必填项）MhOrderId预约单号（必填项）0长度=20GroupName集团名称（必填项）0长度=50GroupStName集团简称（必填项）0长度=20ComAddress公司地址（必填项）0长度=200CerTy
8、pe证件类型（必填项）0长度=10CerContent证件号码（必填项）0长度=50ComPhone联系电话（必填项）0长度=50ComFax传真0=长度=50ComLegalRep法人代表0=长度=50ComSiteUrl企业网址0=长度=50ComEmail集团Email0=长度=50OrderMsisdn预约人手机号（必填项）限河南移动CityName所属城市名称详见集团业务体验中心-地市区县统计v1.0（必填项）AreaName所属城市下的所属区县名称详见集团业务体验中心-地市区县统计v1.0（必填项）Key加密keyKey是一个MD5加密的字符串key=TransactionID+P
9、latform+KEY其中KEY暂定为JTYWTYZXZHYY（必填项）响应参数列表参数名字参数说明备注TransactionID事务ID 全局唯一以毫秒为单位的当前时间Platform平台编码目前集团客户门户帐号预约暂定为JTMHZHYYResultCode响应编码不同的指令会对应不同请求返回具体值，对于信息如下功能需求集团账号预约可为中国移动潜在集团客户提供在线预约申请成为集团单位的功能，针对未建档，且有开户、业务办理意向的集团客户进行开户预约。当用户在集团客户门户预约集团账号时，门户将预约单提交到集团业务体验中心预约管理系统，系统按照集客自有平台原产品预约流程派发预约单。3.1.1.1.
10、2集团账户预约开通状态查询接口标准定义接口发送地址是：http:/218.206.204.18:8082/jttiyan/order/cxzhyyorder.action（地址可能有变，到联调的时候确认）此接口采用HTTP+POST+XML传入参数列表参数名字参数说明备注TransactionID事务ID 全局唯一以毫秒为单位的当前时间Platform平台编码目前集团客户门户集团帐号预约查询暂定为JTMHZHYYCXOrderMsisdn预约人手机号Key加密keyKey是一个MD5加密的字符串key=TransactionID+Platform+KEY其中KEY暂定为JTYWTYZHYYCX
11、响应参数列表参数名字参数说明备注TransactionID事务ID 全局唯一以毫秒为单位的当前时间Platform平台编码目前集团客户门户集团帐号预约查询暂定为JTMHZHYYCXResultCode响应编码不同的指令会对应不同请求返回具体值，对于信息如下ResultMsg响应信息这个是对于ResultCode=0000成功的时候返回的值具体描述如下：ResultCode响应编码描述：返回代码标识(resultCode)标识说明9001错误9002Key值不存在0000成功0001Xml格式不正确0002预约人手机号不合法0003没有此人的预约单ResultMsg响应编码描述：参数名字参数说明
12、备注OrderID预约单号集团帐号预约接口规范说明书中门户传人的预约单好一致GroupName集团名称OrderTime预约时间格式为：yyyy-MM-dd HH:mm:ssOrderSta状态(1派单中|2处理中|3工单完结|4已删除)返回数字1、2、3、4CusManName处理预约的客户经理状态为工单完结时返回CusMsisdn客户经理联系方式状态为工单完结时返回功能需求用户在集团客户门户查询预约单时，门户使用手机号码访问集客的预约单查询接口，集客返回该手机号的集团帐号预约单状态列表。3.1.1.1.3根据手机号码查询是否为集团联系人接口标准定义入参：序号数据名 描述大小 必选项备注 交
13、易代码交易代码6999911ServNum手机号15Y集团联系人手机号出参：序号数据名 描述大小 必选项备注 交易代码交易代码6999911CustName集团名称5Y返回参数2GroupCustId集团编号20Y返回参数3IsSuccess状态码20YY 成功 N 失败说明：传入手机号，如果手机号时集团联系人，则返回状态码“Y”及集团名称和集团编号, 如果该手机号不是集团联系人，则状态码为“N”、集团名称和集团编号返回空。功能需求根据用户手机号码查询是否为为集团联系人，如果是集团联系人，则返回有集团信息，如果不是，则返回集团信息为空3.1.1.1.4根据集团编号查询集团信息接口标准定义入参：
14、序号数据名 描述大小 必选项备注 交易代码交易代码6999971customerId集团编号15Y传入参数，集团编号出参：序号数据名 描述大小 必选项备注 交易代码交易代码6999971custName集团名称5Y返回参数2shortName集团简称20Y返回参数3addr公司地址20Y返回参数4cardType证件类型20Y返回参数5cardNo证件号码20Y返回参数6fax传真20Y返回参数7phone联系电话20Y返回参数8ownerName法人代表20Y返回参数9web企业网址20Y返回参数10groupEmail集团Email20Y返回参数11IsSuccess操作标识20Y返回Y，
15、操作成功，N操作失败12Msg操作信息20Y返回此次操作的结果信息功能需求根据集团编号查询集团信息，提供页面展示3.1.1.1.5集团已订购业务查询接口标准定义入参：序号数据名 描述大小 必选项备注 交易代码交易代码6999941customerId集团编号15Y传入参数，集团编号出参：序号数据名 描述大小 必选项备注 交易代码交易代码6999941bill_id集团计费号5Y返回参数2productSpecId产品ID20Y返回参数3servicepkg_id套餐ID20Y返回参数4valid_Date开通日期20Y返回参数5IsSuccess操作标识20Y返回Y，操作成功，N操作失败6Ms
16、g操作信息20Y返回此次操作的结果信息循环一次对应一个产品信息，若该产品没有订购资费，套餐ID返回：9999功能需求根据集团编号查询集团已订购产品信息，提供页面展示3.1.1.1.6集团账单查询接口标准定义入参：序号数据名 描述大小 必选项备注 交易代码交易代码6999951bill_id集团计费号15Y传入参数，集团编号2acct_date帐期10Y例如：201201出参：序号数据名 描述大小 必选项备注 交易代码交易代码6999951servicepkg_id套餐ID20Y返回参数2fee实收金额20Y返回参数3IsSuccess操作标识20Y返回Y，操作成功，N操作失败4Msg操作信息2
17、0Y返回此次操作的结果信息fee：应当月资费总和若该产品没有订购资费，套餐ID返回：9999功能需求根据集团计费号及账期查询集团产品账单，提供页面展示3.1.1.1.7集团信息修改预约接口标准定义入参：序号数据名 描述大小 必选项备注 交易代码交易代码6999961customerId 集团编号10Y传入参数，集团编号2busi_type操作类型4Y1出参：序号数据名 描述大小 必选项备注 交易代码交易代码6999961busiOppoId受理单号20Y返回参数2IsSuccess操作标识20Y返回Y，操作成功，N操作失败3Msg操作信息20Y返回此次操作的结果信息功能需求提供网厅集团信息修改
18、调用接口3.1.1.1.8集团产品订购预约接口标准定义入参：序号数据名 描述大小 必选项备注 交易代码交易代码6999961customerId 集团编号10Y传入参数，集团编号2product_spec_id产品规格ID12Y传入参数，产品规格ID3busi_type操作类型4Y2出参：序号数据名 描述大小 必选项备注 交易代码交易代码6999961busiOppoId受理单号20Y返回参数2IsSuccess操作标识20Y返回Y，操作成功，N操作失败3Msg操作信息20Y返回此次操作的结果信息功能需求提供网厅集团产品订购预约调用接口3.1.1.1.9集团产品退订预约接口标准定义入参：序号数
19、据名 描述大小 必选项备注 交易代码交易代码6999961bill_id集团计费号15Y传入参数，集团计费号2busi_type操作类型4Y3出参：序号数据名 描述大小 必选项备注 交易代码交易代码6999961busiOppoId受理单号20Y返回参数2IsSuccess操作标识20Y返回Y，操作成功，N操作失败3Msg操作信息20Y返回此次操作的结果信息功能需求提供网厅集团产品退订预约调用接口3.1.1.1.10集团产品成员添加预约接口标准定义入参：序号数据名 描述大小 必选项备注 交易代码交易代码6999961bill_id集团计费号15Y传入参数，集团计费号2bill_member_i
20、d成员手机号码12Y传入参数，成员手机号码3busi_type操作类型4Y4出参：序号数据名 描述大小 必选项备注 交易代码交易代码6999961busiOppoId受理单号20Y返回参数2IsSuccess操作标识20Y返回Y，操作成功，N操作失败3Msg操作信息20Y返回此次操作的结果信息功能需求提供网厅集团产品成员添加预约调用接口3.1.1.1.11集团产品成员退订预约接口标准定义入参：序号数据名 描述大小 必选项备注 交易代码交易代码6999961bill_id集团计费号15Y传入参数，集团计费号2bill_member_id成员手机号码12Y传入参数，成员手机号码3busi_type
21、操作类型4Y5出参：序号数据名 描述大小 必选项备注 交易代码交易代码6999961busiOppoId受理单号20Y返回参数2IsSuccess操作标识20Y返回Y，操作成功，N操作失败3Msg操作信息20Y返回此次操作的结果信息功能需求提供网厅集团产品成员退订预约调用接口3.1.1.1.12集团产品成员查询接口标准定义入参：序号数据名 描述大小 必选项备注 交易代码交易代码6999921BillId集团计费号15Y传入参数ServNum手机号15Y传入参数出参：序号数据名 描述大小 必选项备注 交易代码交易代码6999921IsSuccess状态码5YY 成功 N 失败2Msg状态描述20
22、Y当查询状态时Y时：该号码是本集团的成员！当查询状态时N时：1. 该号码不是本集团的成员！2. 查询过程发生异常！说明：传入手机号、集团计费号，判断该手机号时否为该计费号对应集团的成员，如果是该集团成员，返回状态码“Y”及描述“该号码是本集团的成员！”，若不是该集团成员，返回状态码“N”及描述“该号码不是本集团的成员！”，若查询发生异常则返回状态码“N”及描述“查询过程发生异常！”功能需求根据手机号，固定计费号查询该号码是否为其改集团成员3.1.1.1.13查询商机状态接口标准定义入参：序号数据名 描述大小 必选项备注 交易代码交易代码6999981CustID集团编号15Y传入参数BusiC
23、hanceID商机编号15Y传入参数出参：序号数据名 描述大小 必选项备注 交易代码交易代码6999981IsSuccess状态码5YY 成功 N 失败2Msg状态描述20Y当查询状态时Y时：返回商机状态当查询状态时N时：未查询到相关信息！State商机状态20状态：已处理、处理中说明：传入集团编号，商机编号，查询商机状态，如果查询到商机信息，返回状态码“Y”及商机状态，若查询不到商机信息，返回状态码“N”及描述“未查询到相关信息！”。功能需求根据预约返回的busiOppoId及集团编号，查询预约受理状态3.1.1.2 BOSS3.0接口远程调用接口，实现业务查询、业务办理等功能。调用方式：1
24、 组合调用参数2 调用接口客户端方法3 处理接口返回数据4 数据模型（Data Model）设计4.1 集团门户可配置数据模型4.2 用户角色表USER_MOBILE + ROLE_ID为表唯一数据。列PK字段名备注类型为空唯一长度精度小数初始值FalseUSER_MOBILE登陆账号（手机号）VARCHAR2TrueFalse20FalseROLE_ID角色IDVARCHAR2TrueFalse10FalseUSER_STATE用户状态 0：正常1：注销VARCHAR2TrueFalse1FalseGROUP_ID集团ID (编码)VARCHAR2TrueFalse20FalseUSER_D
25、ESC用户描述VARCHAR2FalseFalse50FalseCREATE_TIME创建时间DATEFalseFalseFalseUSER_NAME用户名VARCHAR2FalseFalse20FalseUSER_PHONE用户电话VARCHAR2FalseFalse15FalseROLE_TYPE角色类型（暂保留）VARCHAR2FalseFalse54.3 角色表列PK字段名备注类型为空唯一长度精度小数初始值TrueROLE_ID角色IDNUMBERTrueTrue100FalseROLE_NAME角色名字VARCHAR2TrueFalse20FalseROLE_STATE角色状态 0:
26、不可用 1:可以VARCHAR2TrueFalse1FalseROLE_DESC角色描述VARCHAR2TrueFalse50FalseCREATE_TIME 创建时间DATEFalseFalseFalseROLE_TYPE角色类型（暂保留）VARCHAR2FalseFalse5约束名称类型列名初始备注PK_WTJT_ROLEPK角色ID 关联列名关联备注(角色ID=角色ID) 0角色表.PK_WTJT_ROLE 1角色功能关联表.PK_ROLE_ID 4.4 角色功能表列PK字段名备注类型为空唯一长度精度小数初始值TrueID角色功能 IDNUMBERTrueTrue100FalseACTI
27、ON_ID 功能IDVARCHAR2TrueFalse20FalseROLE_ID角色ID VARCHAR2TrueFalse20FalseSTATE功能状态0:不可用 1:可以VARCHAR2TrueFalse1FalseCREATE_TIME创建时间DATEFalseFalse约束名称类型列名初始备注PK_WTJT_ROLE_ACTION PK 角色功能 ID 关联列名关联备注(角色ID=角色ID)0功能角色表.PK_ROLE_ID 1角色表.PK_WTJT_ROLE(功能ID=功能ID) 0功能角色表.PK_ROLE_ID 1功能表.pk_ACTION_ID 4.5 功能表列PK字段名备
28、注类型为空唯一长度精度小数初始值TrueMODULE_ID菜单ID 一级菜单时，父菜单ID默认填写0NUMBERTrueTrue100FalsePARENT_MODULE_ID父菜单IDNUMBERTrueFalse100FalseMODULE_NAME菜单名字VARCHAR2TrueFalse20FalseMODULE_STATE菜单状态VARCHAR2TrueFalse1FalseMODULE_URL菜单URLVARCHAR2TrueFalse1FalseMODULE_LEVEL菜单级别 1为一级菜单，以次排列VARCHAR2TrueFalse1FalseCREATE_TIME创建时间DA
29、TEFalseFalseACTIONE_DESC菜单描述VARCHAR2False50约束名称类型列名初始备注PK_WTJT_ACTIONFK菜单ID 关联列名关联备注(菜单ID = 菜单ID) 0功能表.MODULE_ID 1角色功能关联表.ACTION_ID4.6 预约表预约表是分中心、分地市的。表名为PK_WTJT_ORDER_LOG_+地市编码列PK字段名备注类型为空唯一长度精度小数初始值TrueBUSIOPPOID受理单号VARCHAR2TrueFalse20FalseBUSIMOBILENO受理手机号码VARCHAR2FalseFalse11FalseCREATETIME 受理时间
30、DATEFalseFalseFalseUPDATETIME更新时间DATEFalseFalseFalseBUSISTATE1：开户预约。2：集团V网预约。3：集团彩铃预约。4：集团手机邮箱预约。5：集团短信信箱预约。6：集团信息修改VARCHAR2FalseFalse5FalseOPERTYPEadd：开通。del：删除。memberadd：成员添加。memberdel：成员删除。VARCHAR2FalseFalse5FalseMSG受理结果VARCHAR2FalseFalse100FalseRETINFO处理中；已处理。VARCHAR2FalseFalse10FalseREGIONID地市编
31、码VARCHAR2FalseFalse2约束名称类型列名初始备注PK_WTJT_ORDER_LOG_+地市编码PK受理单号4.7 地市编码表列PK字段名备注类型为空唯一长度精度小数初始值FalseCITYID 城市编码VARCHAR2TrueFalse5FalseCITYNAME城市名称VARCHAR2FalseFalse10FalseAREAID区县编码VARCHAR2TrueFalse5FalseAREANAME区县名称VARCHAR2FalseFalse205 功能实现说明5.1 用户登录采用用户手机号码+服务密码+验证码和用户手机号码+短信密码两种登陆方式，登录检查用户是否是集团用户。
32、5.1.1.1 功能定义用户输入手机号码、服务密码（短信密码）和验证码，点击登录按钮后登录到集团门户。用户可以点击退出登录按钮退出集团门户。5.1.1.2 Action定义com.asiainfo.web.action.power.LogonActionl execute()如果已登录，显示用户信息，未登录则显示登录页面l getpass()获取短信密码l logon()用户登录处理，登录成功时保存用户信息到会话中，失败时提示错误原因。l logout()获取当前会话中的用户信息，并将其从会话中清除5.1.1.3 处理流程l 用户登录用户退出5.1.1.4 业务规则单点登录5.1.1.5 其它
33、说明调用登录以实现集团门户的单点登录功能。1. 提交登录请求到sso servlet2.SSO系统设置客户端浏览器cookie3.门户应用获取客户端cookie并进行登录4.退出时门户应用清除客户端cookie和应用的登录状态完成退出5.2 权限控制5.2.1 角色菜单配置5.2.1.1 Xml文件配置角色l 角色文件配置加载（WEB-INF/conf/roles.xml）1. com.asiainfo.util.role.RolesXML 此类是加载角色菜单配置文件（roles.xml），在系统启动时自动加载roles.xml文件里面配置的菜单。2. RolesXML.start()方法系统
34、启动时会自动加载角色配置文件，把加载的信息保存在servletContext.setAttribute(cache_roles, rolesList)中。l roles.xml配置说明1. 一级菜单为两位数字（从10开始） 二级菜单为四位数字（从一级菜单编码+01开始） 三级六位数字（二级菜单编码+01开始）。2. 为一级菜单标签 为二级菜单标签及更深层菜单都可以。3. 需要权限控制的地址，url 的名称空间设置为/power/checkRole。4. Action层需要权限控制的名称空间要设置为：Namespace(value=/power/checkRole)例如：10 菜单id集团产品管理 菜单名称 请求url，没有时为空。1 菜单级别,0, 用户类型0：可用、1：注销,1,2,3, 角色 1:集团联系人 等等0 菜单父id，如顶级菜单默认01001 此菜单为上面的子菜单已开通业务查询2 级别2,0,1,2,105.2.1.2 功能定义角色菜单配置5.2.1.3 业务规则一级菜单为两位数字（从10开始） 二级菜单为四位数字（从一级菜单编码+01开始） 三级六位数字（二级菜单编码+01开始）。为一级菜单标签 为二级菜单标签及更深层菜单都可以
