YKY管理平台开发文档.docx

YKY管理平台开发文档.docx

《YKY管理平台开发文档.docx》由会员分享，可在线阅读，更多相关《YKY管理平台开发文档.docx（18页珍藏版）》请在冰豆网上搜索。

YKY管理平台开发文档

●YKY_管理后台开发文档

●机构管理

菜单目录结构：

机构管理

——机构资料录入

——机构资料查询

功能实现：

机构资料录入：

页面录入以下信息，机构编号、机构名称、法人姓名、法人手机号码、地区、经营地址、营业执照号、法人身份证号、常用邮箱、账户姓名、账户号、开户行、联行号、法人身份证正反面照、法人手持身份证半身照、银行卡正反面照、营业执照照片、税务登记证照片、组织机构代码证照片、开户证明、是否OEM机构、机构logo上传；

（红色为必填，以下不再表述）

代理商编号：

固定3位，先从表中获取最大机构号，加1显示，该字段可人为修改；

地区：

获取地区表省字段，下拉列表显示；

联行号：

联行号文本框后头跟一个link，选择联行号，点击弹出悬浮窗，根据清算银行，支行进行模糊查询，加载相应联行号，选中某个联行号，点击确定，关闭悬浮窗，对应联行号显示在文本框内，支行名称出现在开户行全程内；

所有照片，上传后，统一放在以机构编号新建的文件夹内，上传完毕，页面需显示缩略图；

状态：

默认0；

进件日期：

默认系统时间

进件用户Id：

当前登陆用户Id；

最后修改UID：

当前登录用户Id;

最后修改时间：

默认系统时间；

（所有表操作如果有以上两个字段，每次update操作，都需要更新着两个字段，以下不再表述）

●代理商管理

菜单目录结构：

代理商管理

——代理商资料录入

——代理商资料审核

——代理商资料查询

功能实现：

代理商资料录入：

页面录入以下信息，代理商编号、代理商名称、运营商编号、代理级别、上级代理编号、法人姓名、法人手机号码、地区、经营地址、营业执照号、法人身份证号、常用邮箱、账户姓名、账户号、开户行、联行号、法人身份证正反面照、法人手持身份证半身照、银行卡正反面照、营业执照照片、税务登记证照片、组织机构代码证照片、是否OTO代理、开户证明；

代理商编号：

固定3位，先从表中获取最大机构号，加1显示，该字段可人为修改；

地区：

获取地区表省字段，下拉列表显示；

联行号：

联行号文本框后头跟一个link，选择联行号，点击弹出悬浮窗，根据清算银行，支行进行模糊查询，加载相应联行号，选中某个联行号，点击确定，关闭悬浮窗，对应联行号显示在文本框内，支行名称出现在开户行全程内；

所有照片，上传后，统一放在以代理商编号新建的文件夹内，上传完毕，页面需显示缩略图；

OTO代理：

可分配一个卡bin，固定6位数字，以9开头；

状态：

默认0；

进件日期：

默认系统时间

进件用户Id：

当前登陆用户Id；

代理商资料审核：

点击默认显示agentStat=0的代理商列表信息，抬头如下；

序号、代理商ID、代理商名称、法人、手机号、所属区域、状态、录入时间、查看详情

点击查看详情，进入详情页面，将代理商信息全部显示出来；

最下端添加两个功能按钮，一个审核通过，一个审核驳回；

审核通过：

状态字段agentStat为2，

审核用户Id：

当前登陆用户Id；

审核通过日期：

当期系统日期；

跳入分配后台用户界面分配userId，分配费率；

审核驳回：

agentStat为1；

审核用户Id：

当前登陆用户Id；

审核通过日期：

当期系统日期；

当前页面关闭，显示待审核代理商列表；

审核通过，配置费率

代理商资料查询：

查询条件字段为，代理商ID、代理商名称、法人姓名、状态、录入时间、所属地区；

查询结果显示字段为：

序号、代理商ID、代理商名称、法人、手机号、所属区域、状态、录入时间、查看详情

点击查看详情，进入详情页面，将代理商信息全部显示出来；

具有相应修改/删除权限的用户，可选中某条记录，点击修改按钮，进入修改页面；点击删除，弹出确认删除对话框；

●商户管理

菜单目录结构：

商户管理

——商户进件申请

——商户进件审核

——商户清算变更

——商户查询

——终端查询

功能实现：

商户进件申请：

页面录入以下信息，商户号、代理商编号、地区ID、MCC码、法人姓名、法人手机号码、商户名称、经营地址、经营范围、营业执照号、法人身份证号、常用邮箱、账户姓名、账户号、开户行、联行号、清算标志、法人身份证正反面照、法人手持身份证半身照、银行卡正反面照、营业执照照片、税务登记证照片、组织机构代码证照片、门头照片、内景照片、是否OTO商户、开户证明；

以及终端信息包括：

终端号、终端名称（小票名）、联系人姓名、联系人手机号码、地址；

一个商户可申请多个终端，最少一个；

商户号生成规则：

固定15位，3位代理商编号+4位地区码+4位MCC码+4位顺序位

终端号生产规则：

3位代理商编号+5位顺序位

OTO商户，终端可增加最多两名收银员，输入会员卡号；（后期可修改来完善）

代理商编号：

获取当前登陆用户所属代理商编号，赋给商户号头三位；

地区码：

获取地区表字段，下拉列表显示，将所选地区4位地区码赋值给商户号第3-7位；

MCC码：

获取MCC码表字段，下拉列表显示，将所选行业MCC码赋值给商户号第8-12位；

选定MCC码的同时，将对应手续费扣率记入商户扣率当做默认推荐扣率保存；

联行号：

联行号文本框后头跟一个link，选择联行号，点击弹出悬浮窗，根据清算银行，支行进行模糊查询，加载相应联行号，选中某个联行号，点击确定，关闭悬浮窗，对应联行号显示在文本框内，支行名称出现在开户行全程内；

所有照片，上传后，统一放在以商户号新建的文件夹内，上传完毕，页面需显示缩略图；

OTO商户，需选择积分规则、设置冻结金额、业务员姓名等；

状态：

默认0；

进件日期：

默认系统时间

进件用户Id：

当前登陆用户Id；

商户进件审核：

点击默认显示merStat=0的代理商列表信息，抬头如下；

序号、代理商编号、商户号、商户名称、法人、手机号、所属区域、状态、录入时间、查看详情

点击查看详情，进入详情页面，将商户信息全部显示出来；

最下端添加两个功能按钮，一个审核通过，一个审核驳回；

配置费率：

默认显示MCC对应费率，根据签约实际费率进行配置；

选择风控规则：

获取风控规则表（risk_regular_info）信息，下拉列表显示；

配置交易类型：

复选框显示银行卡功能、会员卡功能、支付宝功能；

分配渠道：

默认点对点类型，点击选择弹出悬浮窗，加载同地区商户渠道信息，支持模糊查询，查找对应渠道商户终端，选定将主键ID赋值给商户表的chId字段；

分配用户：

默认商户号作为登陆账号，密码默认1234qwer，角色默认商户；

审核通过：

状态字段merStat为2，

审核用户Id：

当前登陆用户Id；

审核通过日期：

当期系统日期；

审核驳回：

merStat为1；

审核用户Id：

当前登陆用户Id；

审核通过日期：

当期系统日期；

当前页面关闭，显示待审核商户列表；

商户清算变更：

查询条件：

商户号、终端号；

显示信息：

该商户清算标志、签约费率、开户行名称、开户行行号、账户姓名、账户号；可对以上信息进行修改；

商户查询：

查询条件：

商户号、终端号、所属区域、录入时间、审核状态、商户名称

查询结果显示字段为：

序号、商户号、商户名称、法人、手机号、所属区域、商户状态、录入时间、查看详情

点击查看详情，进入详情页面，将商户信息全部显示出来；

具有相应修改权限的用户，可选中某条记录，点击修改按钮，进入修改页面；

修改界面，只能修改基本信息，不包含商户清算信息（签约费率、清算银行、清算账户等）；

终端查询：

查询条件：

终端号、联系人、终端状态

查询结果显示字段为：

序号、商户号、终端号、小票抬头、联系人、手机号、终端状态、录入时间、查看详情

点击查看详情，进入详情页面，将终端信息全部显示出来；

具有相应修改权限的用户，可选中某条记录，点击修改按钮，进入修改页面；

●渠道管理

菜单目录结构：

渠道管理

——渠道地址管理

——渠道商户管理

——渠道费率管理

功能实现：

渠道地址管理：

点击默认显示所有渠道地址信息，字段如下：

序号、渠道名称、IP地址、端口、TPDU、HEADER、机构号、渠道状态、渠道密钥、开通日期；

根据登陆用户权限，显示功能按钮（新增、修改），

点击新增，弹出新增窗口，录入信息如下：

渠道名称、IP地址、端口、TPDU、HEADER、机构号、渠道密钥；

点击修改，可对以上信息包括渠道状态进行修改；

渠道商户管理：

查询字段：

渠道商户号、渠道终端号、代理商、地区；

点击默认显示所有渠道商户信息，字段如下：

序号、渠道商户名称、渠道商户号、渠道终端号、渠道批次号、渠道流水号、渠道状态、渠道类型、开通日期、详细信息；

点击详细，显示以上信息外加所属地址、所属代理商、地区Id、资金池；

根据登陆用户权限，显示功能按钮（新增、修改、批量导入），

点击新增，弹出新增窗口，录入信息如下：

渠道商户名称、渠道商户号、渠道终端号、终端主密钥、渠道类型、选择渠道费率、选择代理商、选择地区；

点击修改，可对以上信息包括渠道状态进行修改；

渠道费率管理：

点击默认显示所有渠道费率信息，字段如下：

序号、费率名称、费率类型、费率点数、封顶金额、录入日期；

根据登陆用户权限，显示功能按钮（新增、修改、删除），

点击新增，弹出新增窗口，录入信息如下：

费率名称、费率类型、费率点数、封顶金额、录入日期；

点击修改，可对以上信息进行修改；

点击删除，删除相应费率；

●机具管理

菜单目录结构：

机具管理

——机具型号管理

——机具入库

——机具查询

功能实现：

机具型号管理：

点击默认显示所有机具型号信息，字段如下：

序号、品牌名称、型号、类型、备注、录入日期；

根据登陆用户权限，显示功能按钮（新增、修改、删除），

点击新增，弹出新增窗口，下拉选择品牌名称、型号、类型、备注；

点击修改，可对以上信息进行修改；

点击删除，删除相应机型；

机具入库：

录入进货批次信息：

进货批次号、下拉选择品牌、下拉选择型号、下拉选择入网类型、数量、进货单价、进货总价；

进货批次号生产规则，默认显示8位当前日期+2位顺序位；

整理机具SN号，制作txt或者excel文件，txt格式为批次号，机具SN号中间以逗号分割，将改文件导入，插入device_info，其余字段给默认值；

机具查询：

操作表名（device_info）；

查询条件：

品牌、型号、机具SN号、机具状态、终端号；

显示信息如下：

品牌、型号、类型、SN号、所属代理商、状态、录入时期、终端号、绑定日期

当状态为已绑定时，终端号跟绑定日期有值，且点击终端号，链接至终端详细信息；

●交易管理

菜单目录结构：

交易管理

——当前交易查询

——历史交易查询

——交易汇总查询

功能实现：

当前交易查询：

查询条件：

起始日期、结束日期、交易类型、手机号、会员姓名、交易金额、会员号、交易状态、商户号、终端号、流水号、卡号

显示信息：

交易日期、交易时间、商户、终端号、流水号、消费类型、卡号、会员姓名、手机号、交易金额、交易状态、应答码、详细

点击详细，进入交易详情界面；

点击手机号，进入会员详细信息界面；

点击商户，进入商户详细信息界面；

历史交易查询：

查询条件：

交易日期、交易类型、手机号、会员姓名、交易金额、会员号、交易状态、商户号、终端号、流水号、卡号

此处，先考虑一张历史表，根据实际数据量，来进行分表处理，如果有分表出现，时，查询条件，需先选择过往年份或月份；

显示信息：

交易日期、交易时间、商户、终端号、流水号、消费类型、卡号、会员姓名、手机号、交易金额、交易状态、消费类型、详细

点击详细，进入交易详情界面；

点击手机号，进入会员详细信息界面；

点击商户，进入商户详细信息界面；

交易汇总查询：

批处理：

每天凌晨1点，对前一天交易数据进行统计汇总，将汇总信息录入汇总表；

查询条件：

交易日期、交易类型、代理商、商户号、终端号（商户角色登入时）

显示信息：

序号、汇总日期、代理商、商户号、终端号（商户角色显示）、交易类别、交易笔数、交易金额、交易积分、手续费、结算金额、分润金额；

●差错管理

菜单目录结构：

差错管理

——差错交易查询

——调单申请

——调单审核

功能实现：

当前交易查询：

查询条件：

对账日期、代理商、商户号、终端号、状态

显示信息：

序号、对账日期、差错类别、交易日期、交易时间、代理商编号、商户号、终端号、流水号、批次号、卡号、交易金额、处理状态、操作（处理完成）；

清算人员根据实际处理情况，可对某条不平记录进行状态更改操作；

调单申请：

录入信息：

交易日期、代理商、商户号、终端号、流水号、检索参考号、交易金额、卡号、最晚期限、申请类型、发起方、上传凭证、备注；

录入时，自动去匹配交易流水表，更改patchStat；

调单审核：

查询条件：

代理商、商户号、终端号、发起方、发起类型、交易日期、卡号、检索参考号、批处理状态；

默认显示，调单申请状态的记录；

序号、机构号、商户号、终端号、卡号、交易金额、交易时间、检索参考号、最晚处理期限、发起方、发起类型、调单状态、批处理状态、操作

点击操作，进入详情操作页面，显示调单详细信息，可对该条记录进行审核驳回、审核通过待确认、确认通过等操作；

●会员卡管理

菜单目录结构：

会员卡管理

——卡Bin查询

——制卡申请

——制卡审核

——卡库存管理

——推广员领卡录入

——推广员退卡受理

——会员卡查询

——批量充值

功能实现：

卡BIN查询：

输入卡bin，查询对应卡bin运营商信息；

制卡申请：

输入元素：

选择卡名称、代理商、选择卡种类、制卡数量、制卡批次、起始卡号、结束卡号、卡有效期、服务码、制卡序号;

新增时根据卡机构需要取到卡bin号；

须先判断卡bin+卡种类+制卡批次在表中不存在；

需要校验结束卡号-起始卡号=制卡数量、卡有效期需要大于当前日期；

服务码固定填500；

制卡序号，前11固定为RY+yyMM+机构Id+批次（RY141100101）后5位为00001累加；

申请状态为0；

制卡审核：

更改审核状态，通过后，出现“生成制卡文件”按钮；

生成卡号、二磁道、密码等数据，插入card_info表的同时，生成制卡文件；

制卡文件生成好后，以zip格式提示下载；

卡号生成规则：

6位卡bin+4位卡种类+2位批次+6位起始卡号+1位校验位

9020010001010000013

校验位算法为Luhn模10“隔位2倍加”的计算公式；

二磁道生成规则：

；卡号=有效期+服务码+补0？

除去起始位总共37位

；9020010001000000013=150********000000？

制卡文件格式：

制卡序号|卡号|密码|有效期|二磁道信息|

RY14110010100001|9020010001000000013|123456|1505|;9020010001000000012=15055000000000000?

|

插入card_info时，密码跟二磁道信息采用MD5加密，二磁道加密数据去除首尾符号；状态初始值为1未启用；

卡库存管理：

每天凌晨对前一天卡数据进行统计，将统计数据记录在card_total_info中；

显示卡库存表信息：

序号、统计日期、卡总数、未启用总数、出库未激活数、激活卡总数、冻结卡总数、挂失卡总数；

推广员领卡受理：

录入信息：

代理商、会员Id（手机号）、数量、卡号前9位、起始卡号、结束卡号；

推广员前提是平台会员；

领用类别为推广员，状态置为0，领卡日期默认当前；

将推广员会员Id赋值给分配卡号段的extMemberId字段；

推广员退卡受理

输入起始卡号、结束卡号、数量；

将该批卡原本设置的推广员Id置为空；

会员卡查询：

查询条件：

选择卡机构、卡号；

显示卡号详细信息；

会员卡批量充值：

输入起始卡号、结束卡号、数量、充值金额；

可在未启用状态进行批量充值；

●会员管理

菜单目录结构：

会员管理（后台）

——会员查询

——会员等级设置

功能实现：

后台功能：

会员查询：

查询条件：

手机号码，会员卡号，会员等级、消费金额区间、积分余额区间、性别等；

显示信息：

序号、手机号、姓名、卡号、会员等级、会员类型、会员状态，详细信息

点击详细，显示会员详细资料；

会员等级设置：

对该表进行新增、修改、删除的操作；

●营销管理

菜单目录结构：

营销管理

——活动设置

——优惠券设置

功能实现：

活动设置：

默认显示登陆用户角色的活动列表：

显示信息：

门店名|活动标题|起始时间|结束时间|活动说明

工具栏有新增、修改、删除的操作

新增输入元素：

商户发起：

商户号、活动标题、活动说明、选择门店、活动起始时间、活动结束时间、输入优惠信息（操作favour_info）；

代理商发起：

代理商编号，活动标题、活动说明、活动起始时间、活动结束时间、输入优惠信息（操作favour_info）；

一个活动可能包含多条优惠信息；

优惠券设置：

默认显示该商户优惠券列表：

显示信息：

优惠券名称|券类型|有效期|面值|是否支持前台领取

工具栏有新增、修改、删除的操作

新增输入元素：

商户号、优惠券名称、券类型、数量、面值、有效期、券使用类型、适用门店、使用条件、是否支持前台领取；

当券使用类型为所有时，适用门店字段为空，当为部分门店时，需加载所属门店，参与活动的终端号以|符号进行间隔保存；

当插入coupon_info成功后，根据优惠券数量，插入相应数量记录至sub_coupon_info中个，couponNo的编码规则为，2位年份+2位媒质种类+商户号末4位+6位顺序位

纸质为01，电子券为02，如14540101000001总共14位

●清算管理

菜单目录结构：

交易管理

——银联渠道对账

——基础费率设置

——清算报表下载

——提现申请

功能实现：

银联渠道对账：

导入银联对账文件，解析对账文件，跟数据库流水进行比较，如果平，交易流水对账标志位checkStatus=2，不平checkStatus=1，

长款情况（渠道有本地无），将该条记录插入对账信息表中，标志为长款情况；

短款情况（渠道无本地有），将该条记录插入对账信息表中，标志为短款情况；

此处以银联渠道为例，实际根据上游渠道来解析对账文件，流程不变；

基础费率设置：

待定

清算报表下载：

输入元素：

清算日期，代理商编号，商户号

显示信息：

序号，代理商编号，商户号，交易笔数，交易金额，手续费，结算金额，账户名，账号，联行号，开户行，明细

对账操作后，统计对账平的记录；

可对查询信息进行excel导出；

点击明细，进入商户交易明细查询；

提现申请：

默认显示当前待提现申请信息；

查询条件：

提现日期，类型，角色，状态；

显示信息：

序号，提现日期，类型，提现角色，提现金额，状态，账户名，开户行，账号，联行号；

当财务处理完转账后，可对记录状态进行变更操作；

●风控管理

菜单目录结构：

风控管理

——风控规则设置

——黑名单查询

——异常交易查询

功能实现：

风控规则设置：

默认显示规则列表:

序号，规则名称，每日交易次数，单笔交易限额，每日交易总额，最后修改时间；

可进行新增、修改、删除操作；

黑名单查询：

输入元素：

卡号

默认显示黑名单列表：

序号，商户号，终端号，交易日期，交易时间，流水号，卡号，交易金额，应答码；

异常交易查询：

输入元素：

起始日期，结束日期

expFlag=1的交易为异常交易；

默认显示当天异常交易：

交易日期、交易时间、商户、终端号、流水号、消费类型、卡号、会员姓名、手机号、交易金额、交易状态、应答码、详细

●用户管理

菜单目录结构：

用户管理

——用户管理

——角色管理

——资源管理

——个人中心

功能实现：

用户管理：

默认显示后台用户信息列表：

序号，用户账号，用户姓名，描述，状态，开通日期，所属角色，所属代理商，详细；

可对该表进行新增，修改，删除操作；

可对用户进行角色分配；

角色管理：

默认显示角色列表：

序号，角色名称，角色标识，角色描述，角色状态；

可对新增、修改、删除操作；

可对角色进行资源权限分配；

资源管理：

输入元素：

资源名称

默认显示：

序号，资源名称，Url，资源描述，状态，标识，权值；

对该表进行新增，修改，删除操作；

个人中心：

显示当前登陆用户详细信息；

用户账号，用户姓名，描述，状态，开通日期，所属角色，所属代理商，最后登录时间；

可对密码进行修改操作；

●系统管理

菜单目录结构：

系统管理

——MCC管理

——卡BIN管理

——联行号管理

——地区码管理

功能实现：

MCC管理：

查询元素：

MCC码，关键字

显示信息：

MCC码，名称

卡BIN管理：

查询元素：

卡Bin号

显示信息：

序号，卡Bin号，所属银行，卡片类型，卡名称

可新增卡Bin；

联行号管理：

查询元素：

联行号，银行名称

显示信息：

序号，所属银行，联行号，银行全称

地区码管理：

查询元素：

地区码，地区名称

显示信息：

地区码，地区名称