电商与淘宝交互系统设计说明书.doc

1、 内部资料 秘密第 1 页 共 19 页 文件编号 天安对淘宝交互系统-设计说明书-V1.0.doc修订历史生效日期 版本号 版本说明 作者 审核 批准2014-10-14 1.0 朱毓堃天安对淘宝交互系统设计说明书天安财产保险股份有限公司信息技术部内部资料 秘密第 2 页 共 19 页 目录1 引言 .41.1 目标 .41.2 范围 .41.3 术语和缩略语 .41.4 参考资料 .42 整体说明 .42.1 简介 .42.2 系统目标和约束 .43 整体设计 .53.1 系统架构 .53.2 用例视图 .53.2.1 用例 .63.3 逻辑视图 .63.3.1 逻辑视图 .63.2.2

2、分层 .73.2.3 架构模式和设计机制 .93.3 部署视图 .93.4 数据视图 .93.5 公共平台使用 .94 详细设计 .94.1 用例实现 .94.1.1 用例实现列表 .94.1.2 用例实现描述 .94.2 子系统逻辑视图 .154.2.1 逻辑视图说明 .154.2.2 接口说明 .155 数据库设计 .165.1 数据库说明 .165.2 数据库概念模型设计 .165.2.1 数据实体描述 .165.2.2 数据实体-关系图 .175.3 数据库逻辑结构设计 .175.4 数据库物理结构设计 .175.5 数据备份机制 .186 数据转换 .186.1 数据转换方案 .18

3、7 与其他系统之间的依赖关系 .187.1 测试环境接口地址 .187.1.1 测试环境提供给淘宝的接口 .187.1.2 测试环境调用 ESB 的接口 .187.2 生产环境接口地址 .188 质量及其它方面 .18内部资料 秘密第 3 页 共 19 页 8.1 可维护性 .188.2 安全性 .188.3 健壮性 .188.4 可扩展性/灵活性 .188.5 稳定性/可靠性 .188.6 算法合理性与性能优化 .198.7 界面友好性 .199 附件 .19内部资料 秘密第 4 页 共 19 页 系统设计说明书1 引言1.1 目标为满足保险电子商务日益发展的业务需求，通过搭建基础的对外平台

4、，外接第三方，内接核心子系统，确保天安财险产品能够通过对外平台，实现在第三方电商平台上进行销售和服务。1.2 范围搭建基础交互平台，分别与淘宝和核心进行对接。1.3 术语和缩略语1.4 参考资料1.国华人寿老版电商项目。2.上网搜集的相关资料。2 整体说明2.1 简介为满足天安公司需要在淘宝店铺上销售的保险产品，在本地电商系统中添加淘宝分支，使得淘宝在支付前核保和支付后承保的时候能够调用电商系统，在承保的时候我们能够调用核心返回保单号给在淘宝上购买保险的用户。2.2 系统目标和约束本节说明对构架具有某种重要影响的软件需求和目标，例如：安全性、保密性、市售产品的使用、可移植性和重复使用。还应记录

5、可能适用的特殊约束：设计与实施策略、开发工具、团队结构、时间表、遗留代码等。说明设计系统需要考虑的问题、遵循的约束。比如要遵循软件架构设计的要求，要遵循需求中分配到此子系统的特殊要求，要遵循统一的界面约束（如果有的话），要使用架构统一设置的数据库源，要使用架构统一设置的JAVA MAIL 等序号 术语/缩略语 全称和说明1. 电商 电子商务2. 第三方 淘宝、微信、铜板街等连接电商系统的其他交易平台。3. 枚举 java 枚举类（enum），能标识我们在数据库的表中数字或字母所代表的含义，并能通过含义取出数字或字母。内部资料 秘密第 5 页 共 19 页 3 整体设计3.1 系统架构1、对外交

6、互平台分按照接入关系分为三个部分： 第三方系统接入（包括：微信等外部系统（本次需求仅包含微信渠道） 对外交互平台部分（负责接口的接入接出:对外与第三方系统对接；对内与天安内部系统进行对接，不包括天安已有的内部系统开发部分） 天安内部系统（包括：核心、电销、短信、邮件等系统，内部系统统一由 ESB 管理）2、对外交互平台功能简述 对外交互平台的主要任务为：满足天安电商部门与外围电商平台对接任务，确保天安保险产品能够在电商平台上通过对外交互平台进行销售和服务功能。3.2 用例视图内 网互 联 网天安微信服务器微信数据库服务器对外交互平台前置服务器 对外交互平台后置服务器E S B 服务器对外交互平

7、台数据库服务器微信 A p p移动终端设备安全网关对外数据交互平台支付回调腾讯微信服务器P c 端淘宝网易京东内部资料 秘密第 6 页 共 19 页 3.2.1 用例3.3 逻辑视图3.3.1 逻辑视图内部资料 秘密第 7 页 共 19 页 3.2.2 分层前置分层：内部资料 秘密第 8 页 共 19 页 各个包的注释:ebiz : 电商中涉及与第三方连接的代码都写在这个包里。comon : 里面有控制器基类 EbizBaseController.java 以及thirdIF : 第三方的所有代码所在类。base : 里面含有基本的控制器，有淘宝等其他分支控制器的父类，AbstTradeFor

8、HttpThird.java，能解决所有和报文读取和返回相关的操作。constant : 常量类所在包 ,里面包含有各种字段的枚举值。dto : 淘宝前置调后置所用实体以及电商与淘宝交互所用的实体所在包。util : 淘宝核保的实体转换成后置实体所在包。后置分层：各个包的注释:ebiz : 电商中涉及与第三方连接的代码都写在这个包里。base.dao : 后置 dao 的通用 dao 实现类 EbizBaseDAOImpl.java 所在包。check : 核保校验所在包。common : 里面含有一些电商的配置文件和电商平台的通用枚举。config : 含有电商需要用到的配置信息，和 pro

9、perties 关联。exception : 自定义异常类所在包。thridIF : 涉及到第三方的类所在包。bo : 业务对象层。对应着各个 daoconstant : 枚举类所在包。dao : 数据访问层，由 mybatis 工具自动生成。dto : 暂没用到。esb : 承保调用 esb 的 WebService 的工具自动生成类所在包。model : 实体所在包proxy : 判断是否快捷核保和承保的类所在包service : 业务逻辑层ws : 存放各个 WebService 方法的包内部资料 秘密第 9 页 共 19 页 3.2.3 架构模式和设计机制1.采用 SpringMVC+

10、Mybatis 的框架开发的电商平台。2.采用了工厂模式，抽象工厂模式，建造者模式以及单例模式等设计模式。3.3 部署视图需有一个不会死机，重启的服务器主机来充当生产的服务器3.4 数据视图关于品配置的数据需配置在数据库中 EBIZ_PRODUCT,EBIZ_PRODUCT_PROPERTY 以及EBIZ_PRODUCT_CHECKRULE 表中3.5 公共平台使用将项目部署在 tomcat 上启动服务器，然后进入 tomcat 文件夹下的 webapps 底下删除eservice 包里 lib 里的 servlet-api.jar 和 jsp-api.jar 这 2 个 jar 包。4 详细

11、设计4.1 用例实现4.1.1 用例实现列表1.电商核保接口2.电商承保接口3.电商订单状态查询接口4.1.2 用例实现描述4.1.2.1 核保流程1、对外交易平台收到淘宝平台发过来的核保请求（RequestType=01）后，对报文进行验签，验证通过后，进行数据处理。2、在第三方交易表中保存交易报文。THIRD_TYPE = 03 （淘宝），THIRD_TRADE_ID = 淘宝订单号，TRADE_TYPE = 10（核保）；3、在 EBIZ_THIRD_ORDER 中保存淘宝订单信息。THIRD_TYPE = 01 （淘宝），THIRD_ORDER_NO = 淘宝订单号，THIRD_USE

12、R_ID =淘宝订单映射承保交易中节点。ORDER_NO=非车险订单表主键（详见电商产生方法）4、保存订单数据（非车险相关表）5、判断是否使用快捷核保（由产品配置完成）。若为快捷核保，见快捷核保流程；若为非快捷核保，调用 esb 核心核保接口。6、返回核保结果，淘宝根据核保结果对应相应逻辑处理。7、非订单相关表 ebiz_main_order 非车险订单表主表 ebiz_third_order 第三方订单表 ebiz_appnt 投保人信息表，用来存放投保人信息 ebiz_insured 被保人信息表，用来存放被保人信息 ebiz_order_insurance 订单险种表,用来存放投保的险种

13、信息 ebiz_impart、ebiz_impart_item 用来存放投保告知内部资料 秘密第 10 页 共 19 页 核保流程淘宝 对外数据交互平台E S B发起核保交易请求在第三方交易信息表中保存淘宝交易信息投保试算处理核保接口返回淘宝核保结果 返回试算结果显示核保结果验签通过将淘宝订单信息保存在第三方订单扩展表E B I Z _ T H I R D _ O R D E R中保存订单数据 （ 非车险相关表 ）保存 e s b 请求报文是否快捷核保是否快捷核保8、关于访问和调用接口报文存储说明：本系统，所有对外调用接口，对内调用接口均需要保存交易报文外部系统调用对外交互平台，报文存储在表：EBIZ_THIRD_TRADE对内部 esb 调用，报文存储在表： ebiz_esb_Message 后面功能点不在说明，关于枚举值，详见 pdm9、所有订单相关的更新或插入均需要保存到表 EBIZ_OPER_HIS。