readme.md · disguiser/daye

# 项目文档
项目基于nodejs技术实现,至少需对nodejs技术有初步的了解,在此js不单单是运行在浏览器端的语言,因此搞清项目中哪些是`服务端运行`的程序,哪些是`浏览器端运行`的代码是十分必要的.项目分为两大块,因此占用两个端口.

首先是`代理模块`,原理是在用户浏览器到python服务通讯的线路之间加了一层服务,实际操作变成浏览器输入代理服务的ip以及端口,发出请求,代理对用户请求不做处理直接发送给配置好的指定python服务,python服务返回响应,代理对响应进行判断是否属于要做二次处理的页面,如果属于则处理完再返回给用户浏览器,为了实现更加容易,这里的处理只是注入一些js脚本,删除一些有冲突的脚本之类的简单操作

而更加复杂的操作由注入的脚本在浏览器端完成,这时候会涉及到某些异步的二次请求,比如到数据库拿数据,那就需要新的web服务.考虑到python环境的各种复杂性,决定用0代码倾入量的方案,也就是相应的web服务也用nodejs实现,也就是这里的第二个模块,即`web服务模块`,这个模块就是常见的mvc模式

---

## 环境搭建
* 安装visual studio code
* 安装nodejs 6.9.1
* 打开cmd,输入以下命令,显示版本号则安装成功

> node -v

* 继续输入

> npm install nrm

* 成功后输入

> nrm ls

* 正常会显示各种源,我们选择淘宝的源

> nrm use taobao

* 安装git
* 指定一个项目目录,右键鼠标,选择Git Bash here,输入

> git clone http://git.oschina.net/disguiser/daye

* 进入项目目录

> cd daye

* 安装依赖库

> npm install

* 右键项目目录,选择open with code

---

## 项目目录解释
### controller
前端控制器,接收处理请求,以及某些业务逻辑
### dao
数据访问对象,操作数据库
### models
对象与数据表关系映射模型,字典
### node_modules
用到的外部库
### proxy
代理选择器,对代理的页面进行具体的操作在此编写
### public
前端文件
### templates
模版目录
### utils
工具目录
### .gitignore
配置git忽略指定文件以及文件夹
### app.js
服务模块的入口
### config.js
项目的配置文件,配置数据库以及文件上传目录
### package.json
项目依赖外部模块的配置文件
### proxy.js
代理模块的入口,对指定路径的代理在此配置
### start.js
启动文件

---
## 语法简介
项目使用最新的ES7语法,我们在浏览器里写的一般都是ES5的语法,因此这里的语法比浏览器端多了一些新概念新功能

在浏览器里,只要引入html里的js文件里的方法,都可以相互调用,node里则需要声明引入

引入别的文件内定义的函数:
```javascript
const filesize = require('目录/文件名');
```
定义的函数能被别的文件引入:
```javascript
module.exports = {
    函数名: 函数名
}
```

`const` 声明常量
`let` 声明变量用,一般情况下等同于 `var`,这里推荐用let,两者差异,自行搜索
`=>` 箭头函数,匿名函数 function(x,y){} 的改进语法
`async await`用于将异步程序改成同步程序,javascript是单线程语言,为了不阻塞唯一的线程,保证性能,耗时操作比如读取数据库,读取文件之类的操作都是异步的,所谓异步就是js不会停在这里等待数据库返回结果才继续执行下面的操作,而是继续执行下去,如果下面的逻辑依赖数据库返回的结果,我们就只能将逻辑封装在回调函数里,传给异步语句.
但是这样破坏了原本的代码结构,回调函数一多,代码可读性就会变得极差,该语法就是为了解决这个问题被引入的,通过该语法就可以像在java里写同步代码一样写js代码了

---
## 案例实现简介
### 中后期重大事项签报流程展示页面内正文插入表单
首先需要对指定的url进行过滤,毕竟我们只需要对某个特定页面进行脚本注入.分析python服务里流程页面的展示特性,发现`待处理事务`以及`未完结事务`这两个入口进去url并不相同,因此这两个url都需要在正文里加入项目编号,遂在proxy.js里添加如下代码

```javascript
proxy.use('/x/workflow/rtview', function (req, res, next) {
  let harmonBinary = harmon([], proxy_flow_show, true);
  harmonBinary(req, res);
  next();
});
proxy.use('/x/workflow/rtflow', function (req, res, next) {
  let harmonBinary = harmon([], proxy_flow_show, true);
  harmonBinary(req, res);
  next();
});
```

以此实现了拦截这两个路径并应用proxy_flow_show.js里的逻辑,即在页面追加标签
```html
<script type="text/javascript" src="/node/workflow_show.js"></script>
```

至此,脚本得以注入,代理服务的任务结束(以后有新的流程需要添加表单只需在注入的脚本workflow_show.js以及下面的web api里添加逻辑,不需改动代理服务的逻辑)

接下来,页面被浏览器加载后,workflow_show.js的脚本开始执行,在页面上取到流程名称,判断是否存在于需要添加的流程数组内(`用于控制表单的显示与否`),然后再判断url上存在taskid还是affaid(待处理事务进去url上为taskid,未完结事务进去则为affaid),并将该id传给对应web api

这时候来到了controllrts目录下的c_flow_show.js,其内部实现了两个api一个处理affaid一个处理taskid,逻辑都是通过id取到flow_id,再根据flow_id对应到相应的函数,因此这里(`flowRouter`)先增加if判断,再增添一个处理具体业务逻辑的方法,`importantMatter`

方法内编写该流程需要的具体业务逻辑,这里是返回展示表单,先将json串取出,转为json对象(`内部有多重嵌套,例如某个属性的值是json数组如合同审批流程里的信托文件,则需要取出再json.parse`)
json的内容即为以下sql的查询结果
```sql
select jsondata from WF_AFFAIR where affa_id='${affa_id}'
```

可以将结果复制到[`http://tool.chinaz.com/tools/unicode.aspx`](http://tool.chinaz.com/tools/unicode.aspx)将Unicode转为中文
可以通过以下sql查询uuid代表的涵义
```sql
select * from efPropertyApple where prp_id = 'f135b2f44c3711e788dd000c294af360'
```

找出项目id,为方便管理这里维护一个流程uuid对应其jsondata内属性的uuid的字典`flow_regitem`,因此在此添加
```javascript
rdf83711470311e68bb0184f32ca6bca: {
    regitem_id: 'wb14720059e311e6adbef0def1c335c3'
}
```

项目id
```javascript
let regitem_id = parsedJson[flow_regitem[affair.flow_id]['regitem_id']];
```
通过项目id到数据库查找项目其他相关信息
数据库取数逻辑都统一在dao目录下d_flow.js里实现,添加函数`find_project_info`,内部执行sql,返回结果
```sql
select CPSTART_DATE,REGITEM_CODE,REGITEM_NAME,REGITEM_DP_NAME,REGITEM_OP_NAME,APPLY_DATE from INTRUSTQLC..QLC_TITEMREGINFO 
        where REGITEM_ID = ${regitem_id}
```

得到的结果集可能需要格式化,如日期
```javascript
project_info.APPLY_DATE = moment(project_info.APPLY_DATE.toString()).format('YYYY年MM月DD日');
```
金额的千位加逗号
```javascript
pa_info.DKCD_MONEY = accounting.formatMoney(pa_info.DKCD_MONEY, {symbol: "￥"});
```
金额转换中文大写
```javascript
pa_info['C_DKCD_MONEY'] = nzhcn.encodeB(pa_info.DKCD_MONEY);
```

接着将加工后的结果集传入html模版,渲染页面
模版引擎的详细使用方法请搜索`nunjucks`
最后直接返回即可,浏览器端的ajax请求会在回调函数里直接将字符串写入`正文内容`.

## 附录
### 程序里用到的uuid对应涵义
#### json_data
* R29FFCA438734A42AE6409144A1D78A3-信托经理
* PBB558EE7E914339B01828AC11437874-业务部负责人
* D6887042FAD54274857C6A48018A820F-合规风控负责人

#### 流程
* qba4418052fc11e68f55184f32ca6bca-项目签报审批流程(正文中显示项目编号)
* b395b7615f9811e6b480b888e3e688de-产品发行(信托产品发行确认单)
* afad680f3ec711e6ae92184f32ca6bca-合同审批(附件上传)
* d70e099e240411e7a3af005056a687a8-合同审批(非实质性变更)(附件上传)
* v11a7d403e8611e6b07e184f32ca6bca-付款流程
* v7608f2e3e8811e688c2184f32ca6bca-收款流程
* fdf2ed804a6411e6905fd85de21f6642-放款审批流程
* o53659213e5c11e6a7bd184f32ca6bca-项目签报变更流程
* tc539970ff0911e694b4005056a60fd8-抵质押物录入流程
* rdf83711470311e68bb0184f32ca6bca-中后期重大事项签报流程
* eebf606e3e6411e68f15184f32ca6bca-账户开户流程
* p0cf06613e8e11e680a2184f32ca6bca-销户流程
* rfb70130910911e6a83c184f32ca6bca-收支计划审批流程
* wb2eee409a6211e687f3415645000030-工作计划审批流程
* v4b02a4f3e8a11e6ac80184f32ca6bca-资产解押审批流程
* p688af403e6e11e6a580184f32ca6bca-资金信托合同登记流程
* ta32efd13e8c11e6ae36184f32ca6bca-受益权转让审批流程
* p5b270cfdbdd11e691db1c3e84e5807c-财产信托合同登记流程
* od1bb94f470811e6ac64184f32ca6bca-外派人员行使表决权审批流程
* x0e79ca1470711e69bce184f32ca6bca-外派人员（含董监事）委派审批流程

#### 对象
* v747d92ec81311e68aa0005056a687a8-资产端个人客户
* c588f5c0c81311e68438005056a687a8-资产端机构客户

#### 对象属性

##### 账户信息表(产品发行确认单)
* be3910515f9711e68e53b888e3e688de-信托项目是否已上会
* dabb57b05f9711e69f08b888e3e688de-是否向银监局报备
* f7d376705f9711e6afb0b888e3e688de-承诺函是否办理完全
* o220f1c05f9811e68f9ab888e3e688de-交易文件签署是否齐备
* pc5997405f9811e6bf9eb888e3e688de-终审意见是否全部落实
* qc2f64ae5f9811e690e4b888e3e688de-是否取得东方总公司风险部业务额度批复意见
* r6cdbf1e5f9811e696b6b888e3e688de-交易合同及有关法律文件是否面签
* s57ebb9e5f9811e69ea9b888e3e688de-终审过会通知单是否签批
* f7d376705f9711e6afb0b888e3e688de-承诺函是否办理完全
* ofbb75305f9811e6b61cb888e3e688de-法律意见书

##### 账户信息表(账户开户流程)
* d07329215e0e11e6aa2b184f32ca6bca-项目名称
* aaf42ff0520611e688c2b888e335e00a-银行名称
* r4f74300520611e6a966b888e335e00a-账户类别
* s6305480520711e6acaab888e335e00a-开户要求及备注
* v78cb1a16f4311e6a83340f02f0658fc-项目ID
* wc32b24f592a11e6be1c40f02f0658fc-是否银行托管

##### 中后期签报变更(中后期签报变更流程)
* wb14720059e311e6adbef0def1c335c3-项目ID

##### 付款审批
* c7d2586153c611e6858ab888e335e00a-pay_uuid

##### 收款审批
* u948ea80f5b911e68893415645000030-in_uuid

#### 节点
* O91D097B848A4CFD934EB2A1848D5D04-信托经理发起
* UEBA868CD26E4027A05B3D6CB91B4201-开户经办

disguiser/daye

简介

发行版

贡献者

近期动态

disguiser/daye .gitee-modal { width: 500px !important; }

简介

发行版

贡献者

近期动态

搜索帮助

disguiser/daye