集团客户门户_详细设计规格说明书
AsiaInfo 项目管理文档
中国移动河南公司详细设计说明书
集团门户
编写李现辉编写时间2012.02.14 审批审批时间
版本V1.0.1
亚信科技（中国）有限公司版权所有
文档中的全部内容属亚信科技（中国）有限公司所有，
未经允许，不可全部或部分发表、复制、使用于任何目的。
亚信科技（中国）有限公司版权所有
文档中的全部内容属亚信科技（中国）有限公司所有， 未经允许，不可全部或部分发表、复制、使用于任何目的。
文档修订摘要
日期 修订号 描述
著者 审阅者
目录
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.2BOSS3.0接口 (12)
3.3登录接口 ............................................................................................................ 错误！未定义书签。
3.3.1 对外提供的接口......................................................................................... 错误！未定义书签。
4 数据模型（DATA MODEL）设计 (13)
4.1集团门户可配置数据模型 (13)
4.2用户角色表 (13)
4.3角色表 (14)
4.4角色功能表 (14)
4.5功能表 (15)
4.6预约表 (16)
4.7地市编码表 (16)
5 功能实现说明 (18)
5.1用户登录 (18)
5.2权限控制 (20)
5.2.1 角色菜单配置 (20)
5.2.2 权限过滤器 (23)
5.3集团成员管理 (24)
5.3.1 管理产品管理员 (24)
5.3.2 管理账单管理员 (27)
5.4集团产品管理 (30)
5.4.1 已开通的业务查询 (30)
5.4.2 集团账单查询 (31)
5.5集团账户管理 (33)
5.5.1 集团资料维护 (33)
5.6集团产品 (36)
5.6.1集团V网预约 (36)
5.6.2手机邮箱 (39)
5.6.3集团彩铃 (42)
5.6.4短信信箱 (45)
5.6.5成员管理 (49)
5.7集团门户首页 (51)
5.7.1集团门户首页 (51)
5.8自助办理 (52)
5.8.1集团门户账户开户预约 (52)
5.8.2 集团账户开户预约查询 (54)
5.8.3 集团账户开户预约查询 (55)
1 引言
1.1 文档用途
中国移动河南分公司集团客户门户为中国移动河南分公司电子渠道的一部分，涉及到集团账户预约，集团产品管理等众多可以在网上直接办理和查询的业务
本文档的设计对象为网站web系统，主要从需求出发，基于总体设计，描述了各具体功能点的业务流程、实现设计、交互设计、类设计等。
本文档主要面向系统实现/编程人员，对下一阶段的程序编码工作提供依据，同时也是用户确认设计的依据。
1.2 阅读对象
本文阅读对象包括：
●开发工程师：通过本文了解整个产品设计背景。
●业务咨询师：通过本文了解产品整个产品的设计背景，从而汲取咨询素材。
●测试工程师：通过本文了解整个产品设计背景。
●其它相关人员：如使用产品的电信运营商，或者从事基础技术研究的工程师
1.3 名词术语
BOSS：业务支撑系统。
1.4 参考资料
《中国移动集团客户门户业务规范（V1.0.0）》。
《中国移动集团客户门户业务开发角色赋权及业务预约模块》。
2 概述
2.1 集团客户门户系统概述
中国移动集团客户门户，是中国移动通信为打造一流企业的一流门户，提升集团客户业务受理便捷性，提高中国移动通信集团公司的集团客户服务水平，同时有效降低集团客户的服务营销成本，中国移动通信集团拟在统一门户下的集团客户门户为集团客户提供在线自助服务。
对动力100网站、集团业务网站等进行了有效整合、统一管理、统一认证的网站，以服务、营销和销售作为主要职能，兼顾企业宣传。
2.2 集团客户门户系统功能定义
集团产品管
理
已开通业务查询
产品订购状态查询
产品分配
集团账单查询
集团成员管
理
管理产品管理员
添加产品管理员
删除管理产品管理员
修改管理产品管理员
查询产品管理员
首页初始化
管理账单管理员
添加账单管理员
删除账单管理员
修改账单管理员
查询账单管理员
产品分类
集团V网
集团彩铃
集团短彩信
短信信箱
2.3 设计约束
网上营业厅的开发遵从以下几个规范：
●J2EE技术规范
●中国移动NG1-CRM3.5业务规范
●使用eclipse3.2版本进行开发
软件和硬件的约束请参考产品需求规格说明书。
设计工具：Microsoft Word2003、Microsoft Visio2007、eclipse3.2。
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 全局唯一
以毫秒为单位的当前时间（必填项）
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 集团Email 0<=长度<=50
OrderMsisdn 预约人手机号（必填项）限河南移动
CityName 所属城市名称详见《集团业务体验中心--地市区
县统计v1.0》（必填项）
AreaName 所属城市下的所属区县名称详见《集团业务体验中心--地市区
县统计v1.0》（必填项）
Key 加密key Key是一个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
传入参数列表
参数名字参数说明备注
TransactionID事务ID 全局唯一以毫秒为单位的当前时间
Platform 平台编码目前集团客户门户集团帐号
预约查询暂定为JTMHZHYYCX OrderMsisdn 预约人手机号
Key 加密key Key是一个MD5加密的字符串
key=TransactionID+Platfor
m+KEY
其中KEY暂定为
JTYWTYZHYYCX
响应参数列表
参数名字参数说明备注
TransactionID事务ID 全局唯一以毫秒为单位的当前时间
Platform 平台编码目前集团客户门户集团帐号
预约查询暂定为JTMHZHYYCX ResultCode 响应编码不同的指令会对应不同请求
返回具体值，对于信息如下ResultMsg 响应信息这个是对于ResultCode=0000
成功的时候返回的值具体描
述如下：
ResultCode响应编码描述：
标识说明
返回代码标识
(resultCode)
9001 错误
9002 Key值不存在
0000 成功
0001 Xml格式不正确
0002 预约人手机号不合法
0003 没有此人的预约单
ResultMsg响应编码描述：
参数名字参数说明备注
OrderID预约单号《集团帐号预约接口规范说
明书》中门户传人的预约单好
一致
GroupName 集团名称
OrderTime 预约时间格式为：yyyy-MM-dd HH:mm:ss OrderSta 状态(1派单中|2处理中|3工
返回数字1、2、3、4
单完结|4已删除)
CusManName 处理预约的客户经理状态为工单完结时返回
CusMsisdn 客户经理联系方式状态为工单完结时返回
功能需求
用户在集团客户门户查询预约单时，门户使用手机号码访问集客的预约单查询接口，集客返回该手机号的集团帐号预约单状态列表。
3.1.1.1.3根据手机号码查询是否为集团联系人
接口标准定义
入参：
序号数据名描述大小必选项备注
交易代码交易代码 6 99991
1 ServNum 手机号15 Y 集团联系人手机号
出参：
序号数据名描述大小必选项备注
交易代码交易代码 6 99991
1 CustName 集团名称 5 Y 返回参数
2 GroupCustId 集团编号20 Y 返回参数
3 IsSuccess 状态码20 Y Y 成功 N 失败
说明：传入手机号，如果手机号时集团联系人，则返回状态码“Y”及集团名称和集团编号, 如果该手机号不是集团联系人，则状态码为“N”、集团名称和集团编号返回空。
功能需求
根据用户手机号码查询是否为为集团联系人，如果是集团联系人，则返回有集团信息，如果不是，则返回集团信息为空
3.1.1.1.4根据集团编号查询集团信息
接口标准定义
入参：
序号数据名描述大小必选项备注
交易代码交易代码 6 99997
1 customerId 集团编号15 Y 传入参数，集团编号
出参：
序号数据名描述大小必选项备注
交易代码交易代码 6 99997
1 custName 集团名称 5 Y 返回参数
2 shortName 集团简称20 Y 返回参数
3 addr 公司地址20 Y 返回参数
4 cardType 证件类型20 Y 返回参数
5 cardNo 证件号码20 Y 返回参数
6 fax 传真20 Y 返回参数
7 phone 联系电话20 Y 返回参数
8 ownerName 法人代表20 Y 返回参数
9 web 企业网址20 Y 返回参数
10 groupEmail 集团Email 20 Y 返回参数
11 IsSuccess 操作标识20 Y 返回Y，操作成功，N操作失
败
12 Msg 操作信息20 Y 返回此次操作的结果信息
功能需求
根据集团编号查询集团信息，提供页面展示
3.1.1.1.5集团已订购业务查询
接口标准定义
入参：
序号数据名描述大小必选项备注
交易代码交易代码 6 99994
1 customerId 集团编号15 Y 传入参数，集团编号
出参：
序号数据名描述大小必选项备注
交易代码交易代码 6 99994
1 bill_id 集团计费号 5 Y 返回参数
2 productSpecId 产品ID 20 Y 返回参数
3 servicepkg_id 套餐ID 20 Y 返回参数
4 valid_Date 开通日期20 Y 返回参数
5 IsSuccess 操作标识20 Y 返回Y，操作成功，N操作失
败
6 Msg 操作信息20 Y 返回此次操作的结果信息
循环一次对应一个产品信息，若该产品没有订购资费，套餐ID返回：9999
功能需求
根据集团编号查询集团已订购产品信息，提供页面展示
3.1.1.1.6集团账单查询
接口标准定义
入参：
序号数据名描述大小必选项备注
交易代码交易代码 6 99995
1 bill_id 集团计费号15 Y 传入参数，集团编号
2 acct_date 帐期10 Y 例如：201201
出参：
序号数据名描述大小必选项备注
交易代码交易代码 6 99995
1 servicepkg_id 套餐ID 20 Y 返回参数
2 fee 实收金额20 Y 返回参数
3 IsSuccess 操作标识20 Y 返回Y，操作成功，N操作失
败
4 Msg 操作信息20 Y 返回此次操作的结果信息fee：应当月资费总和
若该产品没有订购资费，套餐ID返回：9999
功能需求
根据集团计费号及账期查询集团产品账单，提供页面展示
3.1.1.1.7集团信息修改预约
接口标准定义
入参：
序号数据名描述大小必选项备注
交易代码交易代码 6 99996
1 customerId 集团编号10 Y 传入参数，集团编号
2 busi_type 操作类型 4 Y 1
出参：
序号数据名描述大小必选项备注
交易代码交易代码 6 99996
1 busiOppoId 受理单号20 Y 返回参数
2 IsSuccess 操作标识20 Y 返回Y，操作成功，N操作失败
3 Msg 操作信息20 Y 返回此次操作的结果信息
功能需求
提供网厅集团信息修改调用接口
3.1.1.1.8集团产品订购预约
接口标准定义
入参：
序号数据名描述大小必选项备注
交易代码交易代码 6 99996
1 customerId 集团编号10 Y 传入参数，集团编号
2 product_spec_id 产品规格ID 12 Y 传入参数，产品规格ID
3 busi_type 操作类型
4 Y 2
出参：
序号数据名描述大小必选项备注
交易代码交易代码 6 99996
1 busiOppoId 受理单号20 Y 返回参数
2 IsSuccess 操作标识20 Y 返回Y，操作成功，N操作失败
3 Msg 操作信息20 Y 返回此次操作的结果信息
功能需求
提供网厅集团产品订购预约调用接口
3.1.1.1.9集团产品退订预约
接口标准定义
入参：
序号数据名描述大小必选项备注
交易代码交易代码 6 99996
1 bill_id 集团计费号15 Y 传入参数，集团计费号
2 busi_type 操作类型 4 Y 3
出参：
序号数据名描述大小必选项备注
交易代码交易代码 6 99996
1 busiOppoId 受理单号20 Y 返回参数
2 IsSuccess 操作标识20 Y 返回Y，操作成功，N操作失败
3 Msg 操作信息20 Y 返回此次操作的结果信息
功能需求
提供网厅集团产品退订预约调用接口
3.1.1.1.10集团产品成员添加预约
接口标准定义
入参：
序号数据名描述大小必选项备注
交易代码交易代码 6 99996
1 bill_id 集团计费号15 Y 传入参数，集团计费号
2 bill_member_id 成员手机号码12 Y 传入参数，成员手机号码
3 busi_type 操作类型
4 Y 4
出参：
序号数据名描述大小必选项备注
交易代码交易代码 6 99996
1 busiOppoId 受理单号20 Y 返回参数
2 IsSuccess 操作标识20 Y 返回Y，操作成功，N操作失败
3 Msg 操作信息20 Y 返回此次操作的结果信息
功能需求
提供网厅集团产品成员添加预约调用接口
3.1.1.1.11集团产品成员退订预约
接口标准定义
入参：
序号数据名描述大小必选项备注
交易代码交易代码 6 99996
1 bill_id 集团计费号15 Y 传入参数，集团计费号
2 bill_member_id 成员手机号码12 Y 传入参数，成员手机号码
3 busi_type 操作类型
4 Y 5
出参：
序号数据名描述大小必选项备注
交易代码交易代码 6 99996
1 busiOppoId 受理单号20 Y 返回参数
2 IsSuccess 操作标识20 Y 返回Y，操作成功，N操作失败
3 Msg 操作信息20 Y 返回此次操作的结果信息
功能需求
提供网厅集团产品成员退订预约调用接口
3.1.1.1.12集团产品成员查询
接口标准定义
入参：
序号数据名描述大小必选项备注
交易代码交易代码 6 99992
1 BillId 集团计费号15 Y 传入参数
ServNum 手机号15 Y 传入参数
出参：
序号数据名描述大小必选项备注
交易代码交易代码 6 99992
1 IsSuccess 状态码 5 Y Y 成功 N 失败
2 Msg 状态描述20 Y 当查询状态时Y时：
该号码是本集团的成员！
当查询状态时N时：
1.该号码不是本集团的成员！
2.查询过程发生异常！
说明：传入手机号、集团计费号，判断该手机号时否为该计费号对应集团的成员，如果是该集团成员，返回状态码“Y”及描述“该号码是本集团的成员！”，若不是该集团成员，返回状态码“N”及描述“该号码不是本集团的成员！”，若查询发生异常则返回状态码“N”及描述“查询过程发生异常！”
功能需求
根据手机号，固定计费号查询该号码是否为其改集团成员
3.1.1.1.13查询商机状态
接口标准定义
入参：
序号数据名描述大小必选项备注
交易代码交易代码 6 99998
1 CustID 集团编号15 Y 传入参数
BusiChanceID 商机编号15 Y 传入参数
出参：
序号数据名描述大小必选项备注
交易代码交易代码 6 99998
1 IsSuccess 状态码 5 Y Y 成功 N 失败
2 Msg 状态描述20 Y 当查询状态时Y时：
返回商机状态
当查询状态时N时：
未查询到相关信息！
State 商机状态20 状态：已处理、处理中
说明：传入集团编号，商机编号，查询商机状态，如果查询到商机信息，返回状态码“Y”及商机状态，若查询不到商机信息，返回状态码“N”及描述“未查询到相关信息！”。
功能需求
根据预约返回的busiOppoId及集团编号，查询预约受理状态
3.1.1.2 BOSS3.0接口
远程调用接口，实现业务查询、业务办理等功能。
调用方式：
1．组合调用参数
2．调用接口客户端方法
3．处理接口返回数据
4 数据模型（Data Model）设计4.1 集团门户可配置数据模型
4.2 用户角色表
USER_MOBILE + ROLE_ID为表唯一数据。
列
PK 字段名备注类型为空唯一长
度精
度
小数初
始
值
Fals
e
USER_MOBILE 登陆账号（手机号）VARCHAR2 True False 20
Fals
e
ROLE_ID 角色ID VARCHAR2 True False 10
Fals e USER_STATE 用户状态0：正常1：
注销
VARCHAR2 True False 1
Fals
e
GROUP_ID 集团ID (编码)VARCHAR2 True False20
Fals
e
USER_DESC 用户描述VARCHAR2 False False 50
Fals
e
CREATE_TIME 创建时间DATE False False
Fals
e
USER_NAME 用户名VARCHAR2 False False 20
Fals
e
USER_PHONE 用户电话VARCHAR2 False False 15
Fals
e
ROLE_TYPE 角色类型（暂保留）VARCHAR2 False False 5 4.3 角色表
列
PK 字段名备注类型为空唯一长度精
度小
数
初始值
True ROLE_ID 角色ID NUMBER True True 10 0 False ROLE_NAME 角色名字VARCHAR2 True False 20
False ROLE_STATE 角色状态0:不可
用1:可以
VARCHAR2 True False 1
False ROLE_DESC 角色描述VARCHAR2 True False 50
False CREATE_TIME 创建时间DATE False False
False ROLE_TYPE 角色类型（暂保
留）
VARCHAR2 False False 5
约束
名称类型列名初始备注
PK_WTJT_ROLE ?PK?角色ID
关联
列名关联备注(角色ID=角色ID) 0 角色表.PK_WTJT_ROLE
1 角色功能关联表.PK_ROLE_ID
4.4 角色功能表
列
PK 字段名备注类型为空唯一长
度精
度
小
数
初始
值
True ID 角色功能ID NUMBER True True 10 0 False ACTION_ID 功能ID VARCHAR2 True False 20
False ROLE_ID 角色ID VARCHAR2 True False 20
False STATE 功能状态0:不可用1:
可以
VARCHAR2 True False 1
False CREATE_TIME 创建时间DATE False False
约束
名称类型列名初始备注
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 字段名备注类型为空唯一长
度精
度
小
数
初始值
True MODULE_ID 菜单ID 一级菜单
时，父菜单ID默认
填写0
NUMBER True True 10 0
False PARENT_MODULE_I
D
父菜单ID NUMBER True False 10 0
False MODULE_NAME 菜单名字VARCHAR2 True False 20 False MODULE_STATE 菜单状态VARCHAR2 True False 1
False MODULE_URL 菜单URL VARCHAR2 True False 1
False MODULE_LEVEL 菜单级别1为一级
菜单，以次排列
VARCHAR2 True False 1
False CREATE_TIME 创建时间DATE False
False ACTIONE_DESC 菜单描述VARCHAR2 False 50
约束
名称类型列名初始备注
PK_WTJT_ACTION ?FK?菜单ID
关联
列名关联备注(菜单ID = 菜单ID) 0 功能表.MODULE_ID
1 角色功能关联表.ACTION_ID