某通信集团客户门户详细设计规格说明书(doc 63页).doc

AsiaInfo 项目管理文档项目管理文档 中国移动河南公司详细设计说明书中国移动河南公司详细设计说明书 集团门户集团门户 编 写李现辉编写 时间 2012 02 14 审 批审批 时间 版本 V1 0 1 亚信科技 中国 有限公司版权所有亚信科技 中国 有限公司版权所有 文档中的全部内容属亚信科技 中国 有限公司所有 未经允许 不可全部或部分发表 复制 使用于任何目的 中国移动河南公司网上营业厅详细设计说明书 亚信科技 中国 有限公司版权所有亚信科技 中国 有限公司版权所有 文档中的全部内容属亚信科技 中国 有限公司所有 未经允许 不可全部或部分发表 复制 使用于任何目的 文档修订摘要文档修订摘要 日期日期 修订修订 号号 描述描述著者著者审阅者审阅者 中国移动河南公司网上营业厅详细设计说明书 0 目录目录 1 引言引言 3 1 1 文档用途 3 1 2 阅读对象 3 1 3 名词术语 3 1 4 参考资料 1 2 概述概述 2 2 1 集团客户门户系统概述 2 2 2 集团客户门户系统功能定义 2 2 3 设计约束 3 3 总体结构说明总体结构说明 4 3 1 子系统结构 4 3 1 1 依赖的外部接口 4 3 2 BOSS3 0 接口 4 3 3 登录接口 4 3 3 1 对外提供的接口 4 4 数据模型 数据模型 DATA MODEL 设计 设计 5 4 1 集团门户可配置数据模型 5 4 2 用户角色表 5 4 3 角色表 6 4 4 角色功能表 6 4 5 功能表 7 4 6 预约表 8 4 7 地市编码表 8 5 功能实现说明功能实现说明 10 5 1 用户登录 10 5 2 权限控制 12 5 2 1 角色菜单配置 12 5 2 2 权限过滤器 13 5 3 集团成员管理 14 5 3 1 管理产品管理员 14 5 3 2 管理账单管理员 18 5 4 集团产品管理 21 5 4 1 已开通的业务查询 21 5 4 2 集团账单查询 22 5 5 集团账户管理 24 5 5 1 集团资料维护 24 5 6 集团产品 27 中国移动河南公司网上营业厅详细设计说明书 1 5 6 1集团V网预约 27 5 6 2手机邮箱 30 5 6 3集团彩铃 33 5 6 4短信信箱 36 5 6 5成员管理 40 5 7 集团门户首页 42 5 7 1集团门户首页 42 5 8 自助办理 43 5 8 1集团门户账户开户预约 43 5 8 2 集团账户开户预约查询 45 5 8 3 集团账户开户预约查询 46 中国移动河南公司网上营业厅详细设计说明书 2 1引言引言 1 1 文档用途文档用途 中国移动河南分公司集团客户门户为中国移动河南分公司电子渠道的一部分 涉及到集团账户 预约 集团产品管理等众多可以在网上直接办理和查询的业务 本文档的设计对象为网站 web 系统 主要从需求出发 基于总体设计 描述了各具体功能点的 业务流程 实现设计 交互设计 类设计等 本文档主要面向系统实现 编程人员 对下一阶段的程序编码工作提供依据 同时也是用户确 认设计的依据 1 2 阅读对象阅读对象 本文阅读对象包括 开发工程师 通过本文了解整个产品设计背景 业务咨询师 通过本文了解产品整个产品的设计背景 从而汲取咨询素材 测试工程师 通过本文了解整个产品设计背景 其它相关人员 如使用产品的电信运营商 或者从事基础技术研究的工程师 1 3 名词术语名词术语 BOSS 业务支撑系统 中国移动河南公司网上营业厅详细设计说明书 亚信科技 中国 有限公司 0 1 4 参考资料参考资料 中国移动集团客户门户业务规范 V1 0 0 中国移动集团客户门户业务开发角色赋权及业务预约模块 中国移动河南公司网上营业厅详细设计说明书 亚信科技 中国 有限公司 1 2概述概述 2 1 集团客户门户系统概述集团客户门户系统概述 中国移动集团客户门户 是中国移动通信为打造一流企业的一流门户 提升集团客户业务受理 便捷性 提高中国移动通信集团公司的集团客户服务水平 同时有效降低集团客户的服务营销成本 中国移动通信集团拟在统一门户下的集团客户门户为集团客户提供在线自助服务 对动力 100 网站 集团业务网站等进行了有效整合 统一管理 统一认证的网站 以服务 营 销和销售作为主要职能 兼顾企业宣传 2 2 集团客户门户系统功能定义集团客户门户系统功能定义 集团产品管 理 已开通业务查询 产品订购状态查询 产品分配 集团账单查询 集团成员管 理 管理产品管理员 添加产品管理员 删除管理产品管理员 修改管理产品管理员 查询产品管理员 首页初始化 管理账单管理员 添加账单管理员 删除账单管理员 修改账单管理员 查询账单管理员 产品分类 集团 V 网 集团彩铃 集团短彩信 短信信箱 中国移动河南公司网上营业厅详细设计说明书 亚信科技 中国 有限公司 2 2 3 设计约束设计约束 网上营业厅的开发遵从以下几个规范 J2EE 技术规范 中国移动 NG1 CRM3 5 业务规范 使用 eclipse3 2 版本进行开发 软件和硬件的约束请参考产品需求规格说明书 设计工具 Microsoft Word2003 Microsoft Visio2007 eclipse3 2 中国移动河南公司网上营业厅详细设计说明书 亚信科技 中国 有限公司 3 3总总体体结结构构说说明明 3 1 子系统子系统结构结构 数据库服务器 数据库层 数据库实体 表1表2 Hibernate ORM 层 防 火 墙 Domain 实体类 类1类2 ORM层 Spring 控制层 控制层 菜单服务 MenuService 日志服务 LogService 充值服务 ChargeService 接口服务 InterfaceService 其它服务 Struts2 Freemarker 视图层 活动服务 ActivityService 电子渠道接口 NGCS客服接口 业务推广接口 缓存服务 CacheService ActionSupport 单点登录 模板适配 菜单适配 业务介绍 业务办理 Actions 权限模块 静态页面宣 传 Actions 登陆模块 视图层 数据库 缓存 3 1 1依依赖赖的外部接口的外部接口 3 1 1 1 集团预约接口 集团预约接口 HTTP PSOT XML 3 1 1 1 1 集团账户开户预约集团账户开户预约 接口标准定义接口标准定义 接口发送地址是 http 218 206 204 18 8082 jttiyan order zhorder action 此接口采用 HTTP POST XML 传入参数列表传入参数列表 参数名字参数说明备注 TransactionID 事务 ID 全局唯一以毫秒为单位的当前时间 必填 项 中国移动河南公司网上营业厅详细设计说明书 亚信科技 中国 有限公司 4 Platform 平台编码目前集团客户门户帐号预约暂定 为 JTMHZHYY 必填项 MhOrderId 预约单号 必填项 0 长度 20 GroupName 集团名称 必填项 0 长度 50 GroupStName 集团简称 必填项 0 长度 20 ComAddress 公司地址 必填项 0 长度 200 CerType 证件类型 必填项 0 长度 10 CerContent 证件号码 必填项 0 长度 50 ComPhone 联系电话 必填项 0 长度 50 ComFax 传真0 长度 50 ComLegalRep 法人代表0 长度 50 ComSiteUrl 企业网址0 长度 50 ComEmail 集团 Email0 长度 50 OrderMsisdn 预约人手机号 必填项 限河南移动 CityName 所属城市名称详见 集团业务体验中心 地市 区县统计 v1 0 必填项 AreaName 所属城市下的所属区县名称详见 集团业务体验中心 地市 区县统计 v1 0 必填项 Key 加密 keyKey 是一个 MD5 加密的字符串 key TransactionID Platform KE Y 其中 KEY 暂定为 JTYWTYZXZHYY 必填项 响应参数列表响应参数列表 参数名字参数说明备注 TransactionID 事务 ID 全局唯一以毫秒为单位的当前时间 Platform 平台编码目前集团客户门户帐号预约暂定 为 JTMHZHYY ResultCode 响应编码不同的指令会对应不同请求 返回具体值 对于信息如下 功能需求功能需求 集团账号预约可为中国移动潜在集团客户提供在线预约申请成为集团单位的功能 针对未建档 且 有开户 业务办理意向的集团客户进行开户预约 当用户在集团客户门户预约集团账号时 门户将 预约单提交到集团业务体验中心预约管理系统 系统按照集客自有平台原产品预约流程派发预约单 3 1 1 1 2 集集团账户预约团账户预约开通状开通状态查询态查询 接口标准定义接口标准定义 接口发送地址是 http 218 206 204 18 8082 jttiyan order cxzhyyorder action 地址可 能有变 到联调的时候确认 此接口采用 HTTP POST XML 中国移动河南公司网上营业厅详细设计说明书 亚信科技 中国 有限公司 5 传入参数列表传入参数列表 参数名字参数说明备注 TransactionID 事务 ID 全局唯一以毫秒为单位的当前时间 Platform 平台编码目前集团客户门户集团帐号 预约查询暂定为 JTMHZHYYCX OrderMsisdn 预约人手机号 Key 加密 keyKey 是一个 MD5 加密的字符串 key TransactionID Platfor m KEY 其中 KEY 暂定为 JTYWTYZHYYCX 响应参数列表响应参数列表 参数名字参数说明备注 TransactionID 事务 ID 全局唯一以毫秒为单位的当前时间 Platform 平台编码目前集团客户门户集团帐号 预约查询暂定为 JTMHZHYYCX ResultCode 响应编码不同的指令会对应不同请求 返回具体值 对于信息如下 ResultMsg 响应信息这个是对于 ResultCode 0000 成功的时候返回的值具体描 述如下 ResultCodeResultCode响应编码描述 响应编码描述 返回代码标识 resultCode 标识说明 9001 错误 9002 Key 值不存在 0000 成功 0001 Xml 格式不正确 0002 预约人手机号不合法 0003 没有此人的预约单 ResultMsg响应编码描述 响应编码描述 参数名字参数说明备注 OrderID 预约单号 集团帐号预约接口规范说 明书 中门户传人的预约单 好一致 GroupName 集团名称 OrderTime 预约时间格式为 yyyy MM dd HH mm ss OrderSta 状态 1 派单中 2 处理中 3 工 单完结 4 已删除 返回数字 1 2 3 4 CusManName 处理预约的客户经理状态为工单完结时返回 CusMsisdn 客户经理联系方式状态为工单完结时返回 功能需求 中国移动河南公司网上营业厅详细设计说明书 亚信科技 中国 有限公司 6 用户在集团客户门户查询预约单时 门户使用手机号码访问集客的预约单查询接口 集客返回 该手机号的集团帐号预约单状态列表 3 1 1 1 3 根据手机号根据手机号码查询码查询是否是否为为集集团联团联系人系人 接口标准定义接口标准定义 入参 入参 序号数据名 描述大小 必选项备注 交易代码交易代码 699991 1ServNum 手机号 15Y 集团联系人手机号 出参 出参 序号数据名 描述大小 必选项备注 交易代码交易代码 699991 1CustName 集团名称 5Y 返回参数 2GroupCustId 集团编号 20Y 返回参数 3IsSuccess 状态码 20Y Y 成功 N 失败 说明 传入手机号 如果手机号时集团联系人 则返回状态码 Y 及集团名称和集团编号 如果该手机号不是集团联系人 则状态码为 N 集团名称和集团编号返回空 功能需求功能需求 根据用户手机号码查询是否为为集团联系人 如果是集团联系人 则返回有集团信息 如果不是 则返回集团信息为空 3 1 1 1 4 根据集团编号查询集团信息根据集团编号查询集团信息 接口标准定义接口标准定义 入参 入参 序号数据名 描述大小 必选项备注 交易代码交易代码 699997 1customerId 集团编号 15Y 传入参数 集团编号 出参 出参 序号数据名 描述大小 必选项备注 交易代码交易代码 699997 1custName 集团名称 5Y 返回参数 2shortName 集团简称 20Y 返回参数 3addr 公司地址 20Y 返回参数 4cardType 证件类型 20Y 返回参数 5cardNo 证件号码 20Y 返回参数 6fax 传真 20Y 返回参数 7phone 联系电话 20Y 返回参数 中国移动河南公司网上营业厅详细设计说明书 亚信科技 中国 有限公司 7 8ownerName 法人代表 20Y 返回参数 9web 企业网址 20Y 返回参数 10groupEmail 集团 Email 20Y 返回参数 11IsSuccess 操作标识 20Y 返回 Y 操作成功 N 操作失 败 12Msg 操作信息 20Y 返回此次操作的结果信息 功能需求功能需求 根据集团编号查询集团信息 提供页面展示 3 1 1 1 5 集团已订购业务查询集团已订购业务查询 接口标准定义接口标准定义 入参 入参 序号数据名 描述大小 必选项备注 交易代码交易代码 699994 1customerId 集团编号 15Y 传入参数 集团编号 出参 出参 序号数据名 描述大小 必选项备注 交易代码交易代码 699994 1bill id 集团计费号 5Y 返回参数 2productSpecId 产品 ID 20Y 返回参数 3servicepkg id 套餐 ID 20Y 返回参数 4valid Date 开通日期 20Y 返回参数 5IsSuccess 操作标识 20Y 返回 Y 操作成功 N 操作失 败 6Msg 操作信息 20Y 返回此次操作的结果信息 循环一次对应一个产品信息 若该产品没有订购资费 套餐ID返回 9999 功能需求功能需求 根据集团编号查询集团已订购产品信息 提供页面展示 3 1 1 1 6 集团账单查询集团账单查询 接口标准定义接口标准定义 入参 入参 序号数据名 描述大小 必选项备注 交易代码交易代码 699995 1bill id 集团计费号 15Y 传入参数 集团编号 2acct date 帐期 10Y 例如 201201 出参 出参 序号数据名 描述大小 必选项备注 交易代码交易代码 699995 1servicepkg id 套餐 ID 20Y 返回参数 2fee 实收金额 20Y 返回参数 中国移动河南公司网上营业厅详细设计说明书 亚信科技 中国 有限公司 8 3IsSuccess 操作标识 20Y 返回 Y 操作成功 N 操作失 败 4Msg 操作信息 20Y 返回此次操作的结果信息 fee 应当月资费总和 若该产品没有订购资费 套餐ID返回 9999 功能需求功能需求 根据集团计费号及账期查询集团产品账单 提供页面展示 3 1 1 1 7 集团信息修改预约集团信息修改预约 接口标准定义接口标准定义 入参 序号数据名 描述大小 必选项备注 交易代码交易代码 699996 1customerId 集团编号 10Y 传入参数 集团编号 2busi type 操作类型 4Y1 出参 序号数据名 描述大小 必选项备注 交易代码交易代码 699996 1busiOppoId 受理单号 20Y 返回参数 2IsSuccess 操作标识 20Y 返回 Y 操作成功 N 操作失败 3Msg 操作信息 20Y 返回此次操作的结果信息 功能需求功能需求 提供网厅集团信息修改调用接口 3 1 1 1 8 集团产品订购预约集团产品订购预约 接口标准定义接口标准定义 入参 序号数据名 描述大小 必选项备注 交易代码交易代码 699996 1customerId 集团编号 10Y 传入参数 集团编号 2product spec id 产品规格 ID 12Y 传入参数 产品规格 ID 3busi type 操作类型 4Y2 出参 序号数据名 描述大小 必选项备注 交易代码交易代码 699996 1busiOppoId 受理单号 20Y 返回参数 2IsSuccess 操作标识 20Y 返回 Y 操作成功 N 操作失败 3Msg 操作信息 20Y 返回此次操作的结果信息 功能需求功能需求 提供网厅集团产品订购预约调用接口 中国移动河南公司网上营业厅详细设计说明书 亚信科技 中国 有限公司 9 3 1 1 1 9 集团产品退订预约集团产品退订预约 接口标准定义接口标准定义 入参 序号数据名 描述大小 必选项备注 交易代码交易代码 699996 1bill id 集团计费号 15Y 传入参数 集团计费号 2busi type 操作类型 4Y3 出参 序号数据名 描述大小 必选项备注 交易代码交易代码 699996 1busiOppoId 受理单号 20Y 返回参数 2IsSuccess 操作标识 20Y 返回 Y 操作成功 N 操作失败 3Msg 操作信息 20Y 返回此次操作的结果信息 功能需求功能需求 提供网厅集团产品退订预约调用接口 3 1 1 1 10 集团产品成员添加预约集团产品成员添加预约 接口标准定义接口标准定义 入参 序号数据名 描述大小 必选项备注 交易代码交易代码 699996 1bill id 集团计费号 15Y 传入参数 集团计费号 2bill member id 成员手机号码 12Y 传入参数 成员手机号码 3busi type 操作类型 4Y4 出参 序号数据名 描述大小 必选项备注 交易代码交易代码 699996 1busiOppoId 受理单号 20Y 返回参数 2IsSuccess 操作标识 20Y 返回 Y 操作成功 N 操作失败 3Msg 操作信息 20Y 返回此次操作的结果信息 功能需求功能需求 提供网厅集团产品成员添加预约调用接口 3 1 1 1 11 集团产品成员退订预约集团产品成员退订预约 接口标准定义接口标准定义 入参 序号数据名 描述大小 必选项备注 中国移动河南公司网上营业厅详细设计说明书 亚信科技 中国 有限公司 10 交易代码交易代码 699996 1bill id 集团计费号 15Y 传入参数 集团计费号 2bill member id 成员手机号码 12Y 传入参数 成员手机号码 3busi type 操作类型 4Y5 出参 序号数据名 描述大小 必选项备注 交易代码交易代码 699996 1busiOppoId 受理单号 20Y 返回参数 2IsSuccess 操作标识 20Y 返回 Y 操作成功 N 操作失败 3Msg 操作信息 20Y 返回此次操作的结果信息 功能需求功能需求 提供网厅集团产品成员退订预约调用接口 3 1 1 1 12 集团产品成员查询集团产品成员查询 接口标准定义接口标准定义 入参 序号数据名 描述大小 必选项备注 交易代码交易代码 699992 1BillId 集团计费号 15Y 传入参数 ServNum 手机号 15Y 传入参数 出参 序号数据名 描述大小 必选项备注 交易代码交易代码 699992 1IsSuccess 状态码 5Y Y 成功 N 失败 2Msg 状态描述 20Y 当查询状态时 Y 时 该号码是本集团的成员 当查询状态时 N 时 1 该号码不是本集团的成员 2 查询过程发生异常 说明 传入手机号 集团计费号 判断该手机号时否为该计费号对应集团的成员 如果是该集团成 员 返回状态码 Y 及描述 该号码是本集团的成员 若不是该集团成员 返回状态码 N 及 描述 该号码不是本集团的成员 若查询发生异常则返回状态码 N 及描述 查询过程发生异 常 功能需求功能需求 根据手机号 固定计费号查询该号码是否为其改集团成员 3 1 1 1 13 查询商机状态查询商机状态 接口标准定义接口标准定义 入参 序号数据名 描述大小 必选项备注 交易代码交易代码 699998 中国移动河南公司网上营业厅详细设计说明书 亚信科技 中国 有限公司 11 1CustID 集团编号 15Y 传入参数 BusiChanceID 商机编号 15Y 传入参数 出参 序号数据名 描述大小 必选项备注 交易代码交易代码 699998 1IsSuccess 状态码 5Y Y 成功 N 失败 2Msg 状态描述 20Y 当查询状态时 Y 时 返回商机状态 当查询状态时 N 时 未查询到相关信息 State 商机状态 20 状态 已处理 处理中 说明 传入集团编号 商机编号 查询商机状态 如果查询到商机信息 返回状态码 Y 及商机状 态 若查询不到商机信息 返回状态码 N 及描述 未查询到相关信息 功能需求功能需求 根据预约返回的 busiOppoId 及集团编号 查询预约受理状态 3 1 1 23 1 1 2 BOSS3 0BOSS3 0 接口接口 远程调用接口 实现业务查询 业务办理等功能 调用方式 1 组合调用参数 2 调用接口客户端方法 3 处理接口返回数据 中国移动河南公司网上营业厅详细设计说明书 亚信科技 中国 有限公司 12 4数据模型 数据模型 Data Model 设计设计 4 1 集团门户可配置数据模型集团门户可配置数据模型 4 2 用户角色表用户角色表 USER MOBILE ROLE ID 为表唯一数据 列列 PK字段名字段名备注备注类型类型为空为空唯一唯一长长 度度 精精 度度 小数小数初初 始始 值值 Fals e USER MOBILE 登陆账号 手机号 VARCHAR2 TrueFalse 20 Fals e ROLE ID 角色 ID VARCHAR2 TrueFalse 10 Fals e USER STATE 用户状态 0 正常 1 注销 VARCHAR2 TrueFalse 1 Fals e GROUP ID 集团 ID 编码 VARCHAR2 TrueFalse 20 Fals e USER DESC 用户描述 VARCHAR2 FalseFalse 50 Fals e CREATE TIME 创建时间 DATEFalseFalse 中国移动河南公司网上营业厅详细设计说明书 亚信科技 中国 有限公司 13 Fals e USER NAME 用户名 VARCHAR2 FalseFalse 20 Fals e USER PHONE 用户电话 VARCHAR2 FalseFalse 15 Fals e ROLE TYPE 角色类型 暂保留 VARCHAR2 FalseFalse 5 4 3 角色表角色表 列列 PK字段名字段名备注备注类型类型为空为空唯一唯一长度长度 精度精度 小数小数 初始值初始值 TrueROLE ID 角色 ID NUMBERTrueTrue100 FalseROLE NAME 角色名字 VARCHAR2TrueFalse20 FalseROLE STATE 角色状态 0 不可 用 1 可以 VARCHAR2TrueFalse1 FalseROLE DESC 角色描述 VARCHAR2TrueFalse50 FalseCREATE TIME 创建时间 DATEFalse False FalseROLE TYPE 角色类型 暂保 留 VARCHAR2False False5 约束约束 名称名称类型类型列名列名初始初始备注备注 PK WTJT ROLE PK 角色 ID 关联关联 列名列名关联关联备注备注 角色 ID 角色 ID 0角色表 PK WTJT ROLE 1角色功能关联表 PK ROLE ID 4 4 角色功能表角色功能表 列列 PK字段名字段名备注备注类型类型为空为空唯一唯一长长 度度 精精 度度 小小 数数 初始初始 值值 TrueID 角色功能 ID NUMBERTrueTrue 100 False ACTION ID 功能 ID VARCHAR2 TrueFalse 20 False ROLE ID 角色 ID VARCHAR2 TrueFalse 20 False STATE 功能状态 0 不可用 1 可以 VARCHAR2 TrueFalse 1 False CREATE TIME 创建时间 DATEFalse False 中国移动河南公司网上营业厅详细设计说明书 亚信科技 中国 有限公司 14 约束约束 名称名称类型类型列名列名初始初始备注备注 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字段名字段名备注备注类型类型为空为空唯一唯一长长 度度 精度精度 小数小数 初始值初始值 TrueMODULE ID 菜单 ID 一级菜单时 父菜单 ID 默认填写 0 NUMBERTrueTrue100 FalsePARENT MODULE I D 父菜单 ID NUMBERTrueFalse100 FalseMODULE NAME 菜单名字 VARCHAR2TrueFalse20 FalseMODULE STATE 菜单状态 VARCHAR2TrueFalse1 FalseMODULE URL 菜单 URL VARCHAR2TrueFalse1 FalseMODULE LEVEL 菜单级别 1 为一级 菜单 以次排列 VARCHAR2TrueFalse1 FalseCREATE TIME 创建时间 DATEFalse FalseACTIONE DESC 菜单描述 VARCHAR2False50 约束约束 名称名称类型类型列名列名初始初始备注备注 PK WTJT ACTION FK 菜单 ID 关联关联 列名列名关联关联备注备注 菜单 ID 菜单 ID 0功能表 MODULE ID 1角色功能关联表 ACTION ID 4 6 预约表预约表 预约表是分中心 分地市的 表名为PK WTJT ORDER LOG 地市编码 中国移动河南公司网上营业厅详细设计说明书 亚信科技 中国 有限公司 15 列列 PK字段名字段名备注备注类型类型为空为空 唯一唯一 长度长度精度精度 小数小数 初始值初始值 TrueBUSIOPPOID 受理单号 VARCHAR2 True Fals e 20 Fals e BUSIMOBILENO 受理手机号码 VARCHAR2 Fals e Fals e 11 Fals e CREATETIME 受理时间 DATEFals e Fals e Fals e UPDATETIME 更新时间 DATEFals e Fals e Fals e BUSISTATE 1 开户预约 2 集 团 V 网预约 3 集 团彩铃预约 4 集团 手机邮箱预约 5 集 团短信信箱预约 6 集团信息修改 VARCHAR2 Fals e Fals e 5 Fals e OPERTYPE add 开通 del 删除 memberadd 成员添 加 memberdel 成员 删除 VARCHAR2 Fals e Fals e 5 Fals e MSG 受理结果 VARCHAR2 Fals e Fals e 100 Fals e RETINFO 处理中 已处理 VARCHAR2 Fals e Fals e 10 Fals e REGIONID 地市编码 VARCHAR2 Fals e Fals e 2 约束约束 名称名称类型类型列名列名初始初始备注备注 PK WTJT ORDER LOG 地 市编码 PK 受理单号 4 7 地市编码表地市编码表 列列 PK字段名字段名备注备注类型类型为空为空唯一唯一长度长度 精度精度小小 数数 初始初始 值值 FalseCITYID 城市编码 VARCHAR2 TrueFalse 5 FalseCITYNAME 城市名称 VARCHAR2 FalseFalse 10 FalseAREAID 区县编码 VARCHAR2 TrueFalse 5 FalseAREANAME 区县名称 VARCHAR2 FalseFalse 20 中国移动河南公司网上营业厅详细设计说明书 亚信科技 中国 有限公司 16 5功能功能实现说实现说明明 5 1 用户登录用户登录 采用用户手机号码 服务密码 验证码和用户手机号码 短信密码两种登陆方式 登录检查 用户是否是集团用户 5 1 1 1功能定功能定义义 用户输入手机号码 服务密码 短信密码 和验证码 点击登录按钮后登录到集团门户 用户可以点击退出登录按钮退出集团门户 5 1 1 2Action 定定义义 com asiainfo web action power LogonAction execute 如果已登录 显示用户信息 未登录则显示登录页面 getpass 获取短信密码 logon 用户登录处理 登录成功时保存用户信息到会话中 失败时提示错误原因 logout 获取当前会话中的用户信息 并将其从会话中清除 5 1 1 3处处理流程理流程 用户登录 中国移动河南公司网上营业厅详细设计说明书 亚信科技 中国 有限公司 17 sd login login actionBoss InterFacemobile user doGet LoginForm doPost mobile passwd validatedCode validateUser mobile passwd validatedCode boolean login redirect index jsp 用户退出 sd logout login actionBoss InterFacemobile user doGet logout boolean logout loginForm 中国移动河南公司网上营业厅详细设计说明书 亚信科技 中国 有限公司 18 5 1 1 4业务规则业务规则 单点登录 5 1 1 5其它其它说说明明 调用登录以实现集团门户的单点登录功能 1 提交登录请求到 sso servlet 2 SSO 系统设置客户端浏览器 cookie 3 门户应用获取客户端 cookie 并进行登录 4 退出时门户应用清除客户端 cookie 和应用的登录状态完成退出 5 2 权限控制权限控制 5 2 1角色菜单配置角色菜单配置 5 2 1 15 2 1 1Xml 文件配置角色文件配置角色 角色文件配置加载 角色文件配置加载 WEB INF conf roles xmlWEB INF conf roles xml 1 com asiainfo util role RolesXML 此类是加载角色菜单配置文件此类是加载角色菜单配置文件 roles xml 在系统启动时自动加载 在系统启动时自动加载 roles xml 文件里面配置的菜单 文件里面配置的菜单 2 RolesXML start 方法系统启动时会自动加载角色配置文件 把加载方法系统启动时会自动加载角色配置文件 把加载 的信息保存在的信息保存在 servletContext setAttribute cache roles rolesList 中 中 roles xmlroles xml 配置说明配置说明 1 一级菜单一级菜单为两位数字 从为两位数字 从 10 开始 开始 二级菜单二级菜单为四位数字为四位数字 从一级菜单编码 从一级菜单编码 01 开始 开始 三级六位数字 二级菜单编码三级六位数字 二级菜单编码 01 开开 始 始 中国移动河南公司网上营业厅详细设计说明书 亚信科技 中国 有限公司 19 2 为一级菜单标签为一级菜单标签 为二级菜单标签及更深层菜单都为二级菜单标签及更深层菜单都 可以 可以 3 需要权限控制的地址 需要权限控制的地址 url 的名称空间设置为的名称空间设置为 power checkRole 4 Action 层需要权限控制的名称空间要设置为 层需要权限控制的名称空间要设置为 Namespace value power checkRole 例如 例如 10 菜单菜单 id 集团产品管理集团产品管理 菜单菜单 名称名称 请求请求 url 没有时为空 没有时为空 1 菜单级菜单级 别别 0 用户类用户类 型型0 可用 可用 1 注销 注销 1 2 3 角色角色 1 集集 团联系人团联系人 等等等等 0 菜单父菜单父 id 如顶级菜单默认 如顶级菜单默认0 中国移动河南公司网上营业厅详细设计说明书 亚信科技 中国 有限公司 20 1001 此菜单为上面的子菜单此菜单为上面的子菜单 已开通业务查询已开通业务查询 2 级级 别别2 0 1 2 10 5 2 1 2功能定功能定义义 角色菜单配置 5 2 1 3业务规则业务规则 一级菜单为两位数字 从 10 开始 二级菜单为四位数字 从一级菜单编码 01 开始 三级六位数字 二级菜单编码 01 开始 为一级菜单标签 为二级菜单标签及更深层菜单都可以 中国移动河南公司网上营业厅详细设计说明书 亚信科技 中国 有限公司 21 5 2 2权限过滤器权限过滤器 5 2 2 15 2 2 1Filter 定义定义 com asiainfo util AuthenticationFilter doFilter 判断用户是否登录及请求的 url 是否有权限访问 如果没有登录 返回登录页面 如果没有权限返回没有权限页面 5 2 2 2功能定功能定义义 只要请求的 url 中含有 power checkRole 的名称空间 都会被权限过滤器拦截 判断用 户是否登录及是否有权限访问 如果没有权限返回没有权限页面 5 2 2 3业务规则业务规则 中国移动河南公司网上营业厅详细设计说明书 亚信科技 中国 有限公司 22 请求的 url 中含有 power checkRole 的名称空间 都会被权限过滤器过滤 根据 roles xml 权限配置进行处理 如果请求的 url 含有 power checkRole 名称空间 roles xml 中没有配置 权限过滤器自动会拦截返回没有权限的页面 5 2 2 45 2 2 4处处理流程理流程 1 客户请求的 url 中含有 power checkRole 的名称空间 都会被权限过滤器过滤 2 权限过滤器拦截后判断该用户请求的连接是否登录和是否有权限 3 如果没有登录返回登录页面 如果没有权限返回截止访问页面 5 2 2 5其它其它说说明明 权限过滤器在 WebContent WEB INF web xml 文件里配置 authenticationFilter com asiainfo util AuthenticationFilter authenticationFilter power checkRole 5 3 集团成员管理集团成员管理 5 3 1管理管理产产品管理品管理员员 5 3 1 1功能定功能定义义 只有集团联系人有权限添加 修改 删除管理产品管理员 且产品管理员只能添加一个 5 3 1 2Action 定定义义 com asiainfo web action power ProductEmployeeAdminAction execute 根据集团编码查询集团的所有产品管理员 中国移动河南公司网上营业厅详细设计说明书 亚信科技 中国 有限公司 23 seachProductEmployee 根据操作类型返回添加和修改页面 modifyProductEmployee 修改产品管理员信息 productEmployeeAdd 添加产品管理员 delProductEmployee 删除产品管理员 5 3 1 3处处理流程理流程 此类继承至 GroupSupportAction 类 GroupSupportAction 处理一些公用的一些业务 查询集团的所有产品管理员 根据集团编码 角色 ID 用户状态查询出集团的所有产品管理员 修改产品管理员信息 只能修改产品管理员的用户名 电话等信息 添加产品管理员 产品管理员只能添加一个 删除产品管理员 删除产品管理员只是把用户状态更新为不可用 5 3 1 4业务规则业务规则 登录后操作 只有集团联系人有权限添加 修改 删除管理产品管理员 且产品管理员只能添加一 个 5 3 1 5接口接口说说明明 中国移动河南公司网上营业厅详细设计说明书 亚信科技 中国 有限公司 24 接口名 接口名 WTJT 0001 查询用户信息查询用户信息 多记录返回 功能描述功能描述 根据传参条件返回符合条件用户信息结果集 多记录返回 实现逻辑 实现逻辑 发送数据报文结构 发送数据报文结构 序号数据名 描述大小 必选项备注 交易代码 9 WTJT 0001 1userMobile 用户手机号 码 20 2userState 用户状态 1 0 正常 1 注销 3groupId 集团 id 20 4roleId 角色 id 10 1 集团联系人 2 产品管理员 3 账单管理员 5roleType 角色类型 5 接收数据报文结构接收数据报文结构 出参 返回一个 List userRoleList 具体键值内容如下 如果没有查询到数据 ReturnCode 1001 ReturnMessage 无数据 异常时 ReturnCode 1111 ReturnMessage 查询失败 接口名 接口名 WTJT 0007 更新用户信息更新用户信息 功能描述功能描述 根据传参数据更新 实现逻辑 实现逻辑 发送数据报文结构 发送数据报文结构 序号数据名 描述大小 必选项备注 序号字段名数据名 类型大 小 必选项备注 1group id 集团 id String20Y 2user state 用户状态 String1Y 0 正常 1 注销 3user mobile 登陆账号 手机号 String20Y 4user desc 用户描述 String25Y 5create time 用户创建时间 String 6role id 角色 id String10 1 集团联系人 2 产品 管理员 3 账单管理员 7role name 角色名字 String10 8role desc 角色描述 String25 9usercreate tim e 角色创建时间 String 10user name 用户名字 String10 11role type 角色类型 String5 12user phone 名字电话 String15 中国移动河南公司网上营业厅详细设计说明书 亚信科技 中国 有限公司 25 交易代码 9 WTJT 0007 1ROLE ID 角色 id 10Y 1 集团联系人 2 产品管理员 3 账单管理员 不可修改 2USER PHONE 用户电话 15 3GROUP ID 集团 id 20Y 不可修改 4USER STATE 用户状态 10 0 正常 1 注销 5ROLE TYPE 角色类型 5 6USER MOBILE 登陆账号 手机号 15Y 不可修改 7USER DESC 用户描述 25 8USER NAME 用户姓名 10 接收数据报文结构接收数据报文结构 5 3 2管理管理账单账单管理管理员员 5 3 2 1功能定功能定义义 只有集团联系人有权限添加 修改 删除管理账单管理员 账单管理员可以添加多个 5 3 2 2 Action 定定义义 com asiainfo web action power AccountEmployeeAdminAction execute 根据集团编码查询集团的所有账单管理员 seachAccountEmployee 根据操作类型返回添加和修改页面 modifyAccountEmployee 修改账单管理员信息 accountEmployeeAdd 添加账单管理员 可以添加多个 序号字段名数据名 类型大 小 必选项备注 1ReturnCode 0000 保存成功 1111 保存失败 9999 异常 StringY 2ReturnMessage 用户状态 String1Y 0 正常 1 注销 中国移动河南公司网上营业厅详细设计说明书 亚信科技 中国 有限公司 26 delAccountEmployee 删除账单管理员 5 3 2 3处处理流程理流程 此类继承至 GroupSupportAction 类 GroupSupportAction 处理一些公用的一 些业务 查询集团的所有账单管理员 根据集团编码 角色 ID 用户状态查询出集团的所有账单管理员 修改账单管理员信息 只能修改账单管理员的用户名 电话等信息 添加账单管理员 账单管理员只能添加一个 删除账单管理员 删除账单管理员只是把用户状态更新为不可用 5 3 2 4业务规则业务规则 登录后操作 只有集团联系人有权限添加 修改 删除管理账单管理员 账单管理员可以添加多个 账单管理员只能查询账单信息 中国移动河南公司网上营业厅详细设计说明书 亚信科技 中国 有限公司 27 5 3 2 5接口接口说说明明 接口名 接口名 WTJT 0001 查询用户信息查询用户信息 多记录返回 功能描述功能描述 根据传参条件返回符合条件用户信息结果集 多记录返回 实现逻辑 实现逻辑 发送数据报文结构 发送数据报文结构 序号数据名 描述大小 必选项备注 交易代码 9 WTJT 0001 1userMobile 用户手机号 码 20 2userState 用户状态 1 0 正常 1 注销 3groupId 集团 id 20 4roleId 角色 id 10 1 集团联系人 2 产品管理员 3 账单管理员 5roleType 角色类型 5 接收数据报文结构接收数据报文结构 出参 返回一个 List userRoleList 具体键值内容如下 如果没有查询到数据 ReturnCode 1001 ReturnMessage 无数据 异常时 ReturnCode 1111 ReturnMessage 查询失败 接口名 接口名 WTJT 0007 更新用户信息更新用户信息 功能描述功能描述 根据传参数据更新 序号字段名数据名 类型大 小 必选项备注 1group id 集团 id String20Y 2user state 用户状态 String1Y 0 正常 1 注销 3user mobile 登陆账号 手机号 String20Y 4user desc 用户描述 String25Y 5create time 用户创建时间 String 6role id 角色 id String10 1 集团联系人 2 产品 管理员 3 账单管理员 7role name 角色名字