# daye **Repository Path**: disguiser/daye ## Basic Information - **Project Name**: daye - **Description**: 大业 I3 代理层 - **Primary Language**: NodeJS - **License**: Not specified - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 1 - **Forks**: 0 - **Created**: 2017-01-16 - **Last Updated**: 2023-03-03 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # 项目文档 项目基于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 ``` 至此,脚本得以注入,代理服务的任务结束(以后有新的流程需要添加表单只需在注入的脚本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-开户经办