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

1、电商与淘宝交互系统设计说明书文件编号天安对淘宝交互系统-设计说明书-V1.0.doc天安财产保险股份有限公司信息技术部修订历史生效日期版本号版本说明作者审核批准2014-10-141.0朱毓堃天安对淘宝交互系统设计说明书系统设计说明书1引言目标为满足保险电子商务日益发展的业务需求，通过搭建基础的对外平台，外接第三方，内接核心子系统，确保天安财险产品能够通过对外平台，实现在第三方电商平台上进行销售和服务。范围搭建基础交互平台，分别与淘宝和核心进行对接。术语和缩略语序号术语/缩略语全称和说明1.电商电子商务2.第三方淘宝、微信、铜板街等连接电商系统的其他交易平台。3.枚举java枚举类（enum）

2、，能标识我们在数据库的表中数字或字母所代表的含义，并能通过含义取出数字或字母。参考资料1.国华人寿老版电商项目。2.上网搜集的相关资料。2整体说明简介为满足天安公司需要在淘宝店铺上销售的保险产品，在本地电商系统中添加淘宝分支，使得淘宝在支付前核保和支付后承保的时候能够调用电商系统，在承保的时候我们能够调用核心返回保单号给在淘宝上购买保险的用户。系统目标和约束本节说明对构架具有某种重要影响的软件需求和目标，例如：安全性、保密性、市售产品的使用、可移植性和重复使用。还应记录可能适用的特殊约束：设计与实施策略、开发工具、团队结构、时间表、遗留代码等。说明设计系统需要考虑的问题、遵循的约束。比如要遵循

3、软件架构设计的要求，要遵循需求中分配到此子系统的特殊要求，要遵循统一的界面约束（如果有的话），要使用架构统一设置的数据库源，要使用架构统一设置的JAVA MAIL等3整体设计3.1系统架构1、对外交互平台分按照接入关系分为三个部分：第三方系统接入（包括：微信等外部系统（本次需求仅包含微信渠道）对外交互平台部分（负责接口的接入接出:对外与第三方系统对接；对内与天安内部系统进行对接，不包括天安已有的内部系统开发部分）天安内部系统（包括：核心、电销、短信、邮件等系统，内部系统统一由ESB管理）2、对外交互平台功能简述对外交互平台的主要任务为：满足天安电商部门与外围电商平台对接任务，确保天安保险产品能

4、够在电商平台上通过对外交互平台进行销售和服务功能。3.2用例视图3.2.1用例3.3 逻辑视图3.3.1 逻辑视图3.2.2分层前置分层：各个包的注释:ebiz : 电商中涉及与第三方连接的代码都写在这个包里。comon : 里面有控制器基类EbizBaseController.java以及thirdIF : 第三方的所有代码所在类。base : 里面含有基本的控制器，有淘宝等其他分支控制器的父类，AbstTradeForHttpThird.java，能解决所有和报文读取和返回相关的操作。constant : 常量类所在包,里面包含有各种字段的枚举值。dto : 淘宝前置调后置所用实体以及电商

5、与淘宝交互所用的实体所在包。util : 淘宝核保的实体转换成后置实体所在包。后置分层：各个包的注释:ebiz : 电商中涉及与第三方连接的代码都写在这个包里。base.dao : 后置dao的通用dao实现类EbizBaseDAOImpl.java所在包。check : 核保校验所在包。common : 里面含有一些电商的配置文件和电商平台的通用枚举。config : 含有电商需要用到的配置信息，和properties关联。exception : 自定义异常类所在包。thridIF : 涉及到第三方的类所在包。bo : 业务对象层。对应着各个daoconstant : 枚举类所在包。dao

6、: 数据访问层，由mybatis工具自动生成。dto : 暂没用到。esb : 承保调用esb的WebService的工具自动生成类所在包。model : 实体所在包proxy : 判断是否快捷核保和承保的类所在包service : 业务逻辑层ws : 存放各个WebService方法的包3.2.3架构模式和设计机制1.采用SpringMVC+Mybatis的框架开发的电商平台。2.采用了工厂模式，抽象工厂模式，建造者模式以及单例模式等设计模式。3.3部署视图需有一个不会死机，重启的服务器主机来充当生产的服务器3.4数据视图关于品配置的数据需配置在数据库中EBIZ_PRODUCT,EBIZ_P

7、RODUCT_PROPERTY以及EBIZ_PRODUCT_CHECKRULE表中3.5公共平台使用将项目部署在tomcat上启动服务器，然后进入tomcat文件夹下的webapps底下删除eservice包里lib里的servlet-api.jar和jsp-api.jar这2个jar包。4详细设计4.1用例实现4.1.1用例实现列表1.电商核保接口2.电商承保接口3.电商订单状态查询接口4.1.2用例实现描述4.1.2.1 核保流程1、对外交易平台收到淘宝平台发过来的核保请求（RequestType=01）后，对报文进行验签，验证通过后，进行数据处理。2、在第三方交易表中保存交易报文。THI

8、RD_TYPE = 03 （淘宝），THIRD_TRADE_ID = 淘宝订单号，TRADE_TYPE = 10（核保）；3、在EBIZ_THIRD_ORDER中保存淘宝订单信息。THIRD_TYPE = 01 （淘宝），THIRD_ORDER_NO = 淘宝订单号，THIRD_USER_ID =淘宝订单映射承保交易中节点。ORDER_NO=非车险订单表主键（详见电商产生方法）4、保存订单数据（非车险相关表）5、判断是否使用快捷核保（由产品配置完成）。若为快捷核保，见快捷核保流程；若为非快捷核保，调用esb核心核保接口。6、返回核保结果，淘宝根据核保结果对应相应逻辑处理。7、非订单相关表ebi

9、z_main_order 非车险订单表主表 ebiz_third_order 第三方订单表ebiz_appnt 投保人信息表，用来存放投保人信息 ebiz_insured 被保人信息表，用来存放被保人信息ebiz_order_insurance 订单险种表,用来存放投保的险种信息ebiz_impart、ebiz_impart_item用来存放投保告知8、关于访问和调用接口报文存储说明：本系统，所有对外调用接口，对内调用接口均需要保存交易报文外部系统调用对外交互平台，报文存储在表：EBIZ_THIRD_TRADE对内部esb调用，报文存储在表：ebiz_esb_Message 后面功能点不在说明

10、，关于枚举值，详见pdm9、所有订单相关的更新或插入均需要保存到表EBIZ_OPER_HIS。4.1.2.2 承保流程1、淘宝发起承保交易请求2、对外交易平台收到承保交易请求后，在表EBIZ_THIRD_TRADE中保存淘宝承保交易信息，其中TRADE_TYPE =11(承保)3、对外交易平台收到交易请求后，对承保交易进行再次核保，核保失败，则返回承保失败；若返回成进入承保流程。4、保存更新第三方扩展表5、更新各种表操作6、创建用户流程，详细见创建用户流程5、保存esb请求报文，其中：trade_no = 05 （非车险承保接口）6、调用esb承保接口，更新订单信息说明：1、核心系统在进行承保

11、功能时，需要对承保时所传数据进行一次核保。我方在设计承保接口时，需要将所有数据都传给核心。 2、快捷承保暂时还未设计，后续补充。4.1.2.3 订单状态查询流程1、淘宝发起订单状态查询2、对外数据交互平台接收到请求报文之后，将请求报文保存在表EBIZ_THIRD_TRADE中。其中：THIRD_TYPE=03 （03=淘宝） TRADE_TYPE = 15 （ 15=订单详情查询） FROM_TYPE = 1 （1=接收交易） THIRD_TRADE_ID = 淘宝交易流水号3、对外交互平台通过查询订单相关表，将信息拼接成接口文档格式内容返回给淘宝。4.1.2.4 创建用户流程1、系统调用创建

12、用户方法，传入第三方类型及ID2、使用第三方类型和ID查询表EBIZ_USER_THIRD_INFO，若存在数据，说明该第三方用户已近创建过，无需创建；若不存在数据，创建新的用户3、在PF_CUSTOMER插入用户数据，其中NAME = ta_tb00001 ,PASSWORD = null ，REAL_NAME = 从订单中获取 ，TYPE = 1 （个人），STATUS = 1 （有效），CUSTOMER_SOURCE = 02 （淘宝）（该属性重要）4、在EBIZ_USER_THIRD_INFO插入数据，THIRD_USER_TYPE = TAOBAO （淘宝）THIRD_USER_ID

13、= 第三方用户ID ，CUSTOMER_ID = 用户表主键4.1.2.5 快捷核保功能1、程序模块调用快捷核保功能，根据产品类型与订单类型查询表EBIZ_PRODUCT_CHECKRULE核保约束条件。2、根据查询条件逐条校验，将核保结果返回给调用方法。4.2子系统逻辑视图4.2.1逻辑视图说明4.2.2接口说明接口名称规则描述提供者使用者备注核保接口为淘宝提供的接口，在用户在淘宝网上购买保险时提供核保的接口。电商淘宝承保接口为淘宝提供的接口，在用户在淘宝网上支付过后调用esb提供保单号。电商淘宝订单状态查询接口为淘宝提供的接口，在用户在淘宝网上输入淘宝订单号可以查询到订单的详细信息。电商淘

14、宝2次核保接口为淘宝提供的接口，在适宜的情况下淘宝会调我们这个接口进行2次核保电商淘宝5数据库设计5.1数据库说明由于目前需要对接的产品为非车险（意外保障类产品），需要增加一套意外保障类险的表。因为财险公司主要业务分两大类:车险与非车险。车险表的设计结合其它保险公司与天安车险业务特点设计而成，已经在微信订单微支付中设计完成。对于意外险表设计结合第三方非车险接口设计，以便后期系统的扩展。5.2数据库概念模型设计该部分是详细描述数据库设计内容，视情况可将其他设计工具中的内容直接引入5.2.1数据实体描述淘宝对接需要用到的表,这些表都各自对应着一个实体:1.EBIZ_MAIN_ORDER 非车订单主

15、表 对应实体EbizMainOrder2.EBIZ_THIRD_ORDER 第三方订单扩展表 对应实体EbizThirdTrade3.EBIZ_PRODUCT 产品表 需配置数据 对应实体EbizProduct4.EBIZ_PRODUCT_CHECKRULE 产品校验表 需配置数据 对应实体EbizProductCheckRule5.EBIZ_PRODUCT_PROPERTY 产品属性表 需配置数据 对应实体EbizProductProperty6.EBIZ_ORDER_INSURANCE 订单险种表 对应实体EbizOrderInsurance7.EBIZ_APPNT 投保人表 对应实体Eb

16、izAppnt8.EBIZ_INSURED 订单被保人表 对应实体EbizInsured9.EBIZ_INSURANCE_KIND 险种对应险别表 对应实体EbizInsuranceKind10.PF_CUSTOMER 用户表 需先删除再创建 对应实体PfCustomer11.EBIZ_USER_THIRD_INFO 用户第三方账户信息表 对应实体EbizUserThirdInfo12.EBIZ_IMPART 订单告知表 对应实体EbizImpart13.EBIZ_IMPART_ITEM 订单告知项表 对应实体EbizImpartItem14.EBIZ_OPER_HIS 操作履历表 需先删除再

17、新增 对应实体EbizOperHis15.EBIZ_BNF 订单受益人表 对应实体EbizBnf16.EBIZ_ESB_MESSAGE 保存ESB信息表 对应实体EbizEsbMessage17.EBIZ_THIRD_TRADE 第三方交易信息表 对应实体EbizThirdTrade5.2.2数据实体-关系图 5.3数据库逻辑结构设计5.4数据库物理结构设计5.5数据备份机制6数据转换6.1数据转换方案7与其他系统之间的依赖关系7.1 测试环境接口地址7.1.1 测试环境提供给淘宝的接口核保接口：http:/180.168.131.15/weixin/eservice/ebiz/taobao.

18、action?action=underWrite承保接口：http:/180.168.131.15/weixin/eservice/ebiz/taobao.action?action=acceptInsurance订单查询接口：http:/180.168.131.15/weixin/eservice/ebiz/taobao.action?action=orderStatus二次核保接口：http:/180.168.131.15/weixin/eservice/ebiz/taobao.action?action=underWrite27.1.2测试环境调用ESB的接口获取保单号接口：http:/

19、10.100.133.179:8002/netsalesService/doCarProposalSave?wsdl7.2 生产环境接口地址暂定8质量及其它方面可维护性代码设计良好，维护起来容易。安全性本产品采用的是前置调用后置的方法，前置提供个外网地址给淘宝，前置只是用来封装数据和进行一些简单的逻辑判断，通过内网来访问本地的webService后置，而后置则进行涉及数据库表等安全性的操作，有效的提高了代码的安全性。另外对于修饰词private，protected也有做相关的处理，合理的封装也提升了代码的安全性。健壮性可扩展性/灵活性利用重写重载的机智，调用后置接口，在前期设计时用了大部分时间，不过此代码利于扩展，如果在其他平台上想要发布一个商品，所用新增的代码基本就只有前置新增一个该平台的核保承保控制器，封装实体以及产品的配置，可扩展性好，灵活性好。稳定性/可靠性算法合理性与性能优化界面友好性本产品无界面9附件