# NetDimension.NanUI.Expansion 

**Repository Path**: edggg/NetDimension.NanUI.Expansion

## Basic Information

- **Project Name**: NetDimension.NanUI.Expansion 
- **Description**: 对CEF  NetDimension.NanUI开源项目的维护，扩展，定制
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2018-11-29
- **Last Updated**: 2020-12-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 阿里助手技术方案
## 背景
为了保证阿里用户能够便捷的通过云中台，开票软件实现发票开具和发票数据归集处理，需要通过云中台，助手实现阿里电票平台和开票软件协同。需要提供如下几个功能：

1. 云中台快捷注册。
2. 云中台异步任务和任务管理。
2. 开票软件协同开具。
3. 开票软件协同红冲。
4. 开票软件协同作废。

## 系统架构
![](https://i.imgur.com/FOjSHRZ.png)
如上图所示， 整个系统架构如上几部分组成：

1. 云中台服务器、开票助手服务器、自动升级服务器部署到阿里安全云。
2. 开票核心业务百望云和开票助手通过TCP通信。
3. 激活等非开票业务，通过客户端服务器与阿里电票平台直接通信。

## 数据链路
![](https://i.imgur.com/p0NAwQX.png)

如上图所示， 整个数据链路由如上几部分组成：

1. 阿里电票平台推送工单到助手服务器。
2. 助手启动后获取税盘信息，通过助手服务器到阿里电票平台验证激活。激活后，助手服务器注册云中台。注册成功，助手建立与云中台的长连接。
3. 阿里电票平台推送任务到助手服务器，助手服务器向云中台推送任务请求，云中台对请求任务进行归集，根据助手在线情况通过ds进行任务分发。
4. 助手获取云中台任务请求，存储待开任务，并显示在待开列表。
5. 人工点击待开任务，通过中间件将待开任务数据写入到开票软件。
6. 开票软件协同处理任务，通过Http回发结果到助手服务器。助手服务器同步状态到云中台和阿里电票平台。

## 数据同步
为了保证云端请求和开票软件处理结果一致，需要以下几个模块对数据进行数据存储，更新处理。
![](https://i.imgur.com/C1AVjP8.png)

如上图所示，为了保证任务的唯一性和状态的同步，做如下几点处理：

1. 阿里电票平台推送任务到助手服务器。
2. 助手服务器推送任务到云中台，云中台对业务请求进行归集，并根据助手在线情况分发任务，整条链路通过唯一流水号保证幂等。
3. 助手对待开任务进行存储，防止重启助手，盘换电脑等情况待开数据丢失。
4. 待开任务取消，同步状态到阿里电票平台。
5. 根据开票软件协同结果，助手同步状态到阿里电票平台。
6. 定时获取开票软件中通过阿里助手开具的发票状态，同步到阿里电票平台和云中台（数据补偿）。


## 通道加密
1. 云中台到客户端通过DS2.0进行数据通讯，根据DS2.0协议注册和校验，通过盘号监听队列。
2. 客户端和服务器之间的通道加密沿用现有的方案，通过税号+盘号+版本号初始化获取token，然后用3des建立加密通道。
3. 云中台服务器、助手服务器、助手升级服务器部署在阿里安全云。

## 项目风险
1. 发票验签，上传状态定时同步会影响盘用户正常操作。
2. 客户端服务器首次独立部署，配置和方法清理工期预估可能不准确。
3. 换开票机器、重装助手客户端数据丢失风险

## 预计产出物
1. 与百望，航信开票软件协同的中间件。
2. 支撑开票软件协同的助手。
3. 云中台实现异步任务管理。（异步开票等场景）
4. Alibaba-support提供满足阿里业务需求的客户端服务。

## 项目周期

|       事件       |   负责人   | 截止时间 | 
|------------------| ---------- | -------- |
| 阿里supports订阅     | 鲍永迎     | 2018-12-06    |
| 助手-框架搭建，UI     | 李绍卿     | 2018-12-06    |
| 助手-注册激活     | 李绍卿，鲍永迎    |2018-12-10 |
| 助手登录通知云中台任务分发 |  李绍卿  |2018-12-11|
| 客户端数据状态上传异常重试  |  李绍卿  |2018-12-11|
| 客户端数据同步  |  李绍卿|2018-12-13|	
| 助手服务器任务订阅中转、状态回写         | 鲍永迎     |2018-12-14| 
| 助手待开任务管理，开票软件协同，状态回写        | 李绍卿 |2018-12-19    | 
| 云中台-任务分发          | 郑向阳     | 2018-12-10|
| 云中台-作废、红冲重构          | 郑向阳     | 2018-12-12|
| 中间件-发票开具和开票软件协同          | 赵晓伟   |2018-12-11  | 
| 中间件-发票红冲、作废开票软件协同      | 赵晓伟     | 2018-12-18|
| 与阿里联调测试          | 李绍卿，鲍永迎     | 2018-12-19|
| 提测          | 李绍卿，鲍永迎     | 2018-12-20|
| 测试          | 申超     | 2018-12-30| 
| 测试          | 申超     | 2019-01-04| 


|       事件       |   负责人   | 截止时间 | 
|------------------| ---------- | -------- |
| 开始开发     | 李绍卿     | 2018-12-05    |
| 阿里百望接口开始联调    | 李绍卿,迹迁    | 2018-12-13    |
| 提测          | 李绍卿    |2018-12-20 |
|  测试 |  牛艳辉  |2018-12-21 -- 2018-12~30|
| 上线  |    |2019-01-04|