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，分配费率；审核驳回：age ntStat 为1 ；审核用户Id :当前登陆用户Id ;审核通过日期：当期系统日期；当前页面关闭，显示待审核代理商列表；审核通过，配置费率代理商资料查询：查询条件字段为，代理商ID、代理商名称、法人姓名、状 态、录入时间、所属地区；查询结果显示字段为：序号、代理商ID、代理商名称、法人、手机号、所属区域、 状态、录入时间、查看详情点击查看详情，进入详情页面，将代理商信息全部显示出 来；具有相应修改/删除权限的用户，可选中某条记录，点击 修改按钮，进入修改页面；点击删除，弹出确认删除对话框；商户管理菜单目录结构：商户管理 商户进件申请 商户进件审核 商户清算变更 商户查询 终端查询功能实现：商户进件申请：页面录入以下信息，商户号、代理商编号、地区ID 、 MCC码、法人姓名、法人手机号码、商户名称、经营地址、经营范围、营业执照号、法人身份证号、常用邮箱、账户姓名、 账户号、开户行、联行号、清算标志、法人身份证正反面照、 法人手持身份证半身照、银行卡正反面照、营业执照照片、 税务登记证照片、组织机构代码证照片、门头照片、内景照 片、是否OTC商户、开户证明；以及终端信息包括：终端号、终端名称（小票名） 、联系人姓名、联系人手机号码、地址；一个商户可申请多个终端，最少一个;商户号生成规则：固定 15位，3位代理商编号+4位地区码+4位MCC马+4位顺序位终端号生产规则：3位代理商编号+5位顺序位0T0商户，终端可增加最多两名收银员，输入会员卡号；（后期可修改来完善）代理商编号：获取当前登陆用户所属代理商编号，赋给商 户号头三位；地区码：获取地区表字段，下拉列表显示，将所选地区4位地区码赋值给商户号第 3-7位；MCC马：获取MCC马表字段，下拉列表显示，将所选行业 MCC马赋值给商户号第 8-12位；选定MCC马的同时，将对应手续费扣率记入商户扣率当做 默认推荐扣率保存；联行号：联行号文本框后头跟一个link，选择联行号,点 击弹出悬浮窗，根据清算银行，支行进行模糊查询，加载相 应联行号，选中某个联行号，点击确定，关闭悬浮窗，对应 联行号显示在文本框内，支行名称出现在开户行全程内；所有照片，上传后，统一放在以商户号新建的文件夹内，上传完毕，页面需显示缩略图;0T0商户，需选择积分规则、设置冻结金额、业务员姓名等;状态：默认0；进件日期：默认系统时间进件用户Id :当前登陆用户Id ；商户进件审核：点击默认显示merStat =0的代理商列表信息，抬头如下； 序号、代理商编号、商户号、商户名称、法人、手机号、所属区域、状态、录入时间、查看详情点击查看详情，进入详情页面，将商户信息全部显示出来；最下端添加两个功能按钮，一个审核通过，一个审核驳回;配置费率：默认显示 MCC寸应费率，根据签约实际费率进行配置；选择风控规则：获取风控规则表(risk_regular_i nfo )信息，下拉列表显示;配置交易类型：复选框显示银行卡功能、会员卡功能、支付宝功能；分配渠道：默认点对点类型，点击选择弹出悬浮窗，加载 同地区商户渠道信息，支持模糊查询，查找对应渠道商户终 端，选定将主键 ID 赋值给商户表的 chId 字段；分配用户：默认商户号作为登陆账号， 密码默认 1234qwer， 角色默认商户；审核通过：状态字段 merStat 为 2，审核用户 Id ：当前登陆用户 Id ；审核通过日期：当期系统日期；审核驳回： merStat 为 1；审核用户 Id ：当前登陆用户 Id ；审核通过日期：当期系统日期； 当前页面关闭，显示待审核商户列表；商户清算变更：查询条件：商户号、终端号；显示信息：该商户清算标志、签约费率、开户行名称、开户行行号、账户姓名、账户号；可对以上信息进行修改；商户查询:查询条件：商户号、终端号、所属区域、录入时间、审核 状态、商户名称查询结果显示字段为：序号、商户号、商户名称、法人、手机号、所属区域、商 户状态、录入时间、查看详情点击查看详情，进入详情页面，将商户信息全部显示出来;具有相应修改权限的用户，可选中某条记录，点击修改按 钮，进入修改页面；修改界面，只能修改基本信息，不包含商户清算信息（签 约费率、清算银行、清算账户等）；终端查询：查询条件：终端号、联系人、终端状态查询结果显示字段为：序号、商户号、终端号、小票抬头、联系人、手机号、终 端状态、录入时间、查看详情点击查看详情， 进入详情页面， 将终端信息全部显示出来；具有相应修改权限的用户，可选中某条记录，点击修改按钮，进入修改页面；渠道管理菜单目录结构：渠道管理 渠道地址管理 渠道商户管理 渠道费率管理功能实现：渠道地址管理：点击默认显示所有渠道地址信息，字段如下：序号、渠道名称、IP地址、端口、TPDU HEADER机构号、渠道状态、渠道密钥、开通日期； 根据登陆用户权限，显示功能按钮（新增、修改） ， 点击新增，弹出新增窗口，录入信息如下：渠道名称、 IP地址、端口、TPDU HEADEH机构号、渠道密钥；点击修改，可对以上信息包括渠道状态进行修改；渠道商户管理：查询字段：渠道商户号、渠道终端号、代理商、地区；点击默认显示所有渠道商户信息，字段如下：序号、渠道商户名称、渠道商户号、渠道终端号、渠道批 次号、渠道流水号、渠道状态、渠道类型、开通日期、详细 信息；点击详细，显示以上信息外加所属地址、所属代理商、地区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机构ld+批次( RY141100101 )后 5 位为 00001 累加；申请状态为 0 ； 制卡审核：更改审核状态，通过后，出现“生成制卡文件”按钮；生成卡号、二磁道、密码等数据，插入 card_info 表的同 时，生成制卡文件；制卡文件生成好后，以 zip 格式提示下载；卡号生成规则：6 位卡 bin + 4 位卡种类 + 2 位批次 + 6 位起始卡号+ 1 位校验位902001 0001 01 000001 3校验位算法为 Luhn 模 10“隔位 2 倍加”的计算公式； 二磁道生成规则：；卡号 = 有效期 +服务码 +补 0？ 除去起始位总共 37 位；90000013=000000？ 制卡文件格式：制卡序号 | 卡号 | 密码 | 有效期 | 二磁道信息 |插入cardnfo 时，密码跟二磁道信息采用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 ，如 14 5401 01 000001 总共14 位清算管理 菜单目录结构：交易管理 银联渠道对账 基础费率设置 清算报表下载 提现申请功能实现：银联渠道对账：导入银联对账文件，解析对账文件，跟数据库流水进行比 较，如果平，交易流水对账标志位 checkStatus = 2 ，不平 checkStatus =1 ，长款情况（渠道有本地无），将该条记录插入对账信息表 中，标志为长款情况；短款情况（渠道无本地有），将该条记录插入对账信息表 中，标志为短款情况；此处以银联渠道为例，实际根据上游渠道来解析对账文件，流程不变；基础费率设置：待定清算报表下载：输入元素：清算日期，代理商编号，商户号显示信息：序号，代理商编号，商户号，交易笔数，交易金额，手续费，结算金额，账户名，账号，联行号，开户行，明细对账操作后，统计对账平的记录；可对查询信息进行excel导出；点击明细，进入商户交易明细查询；提现申请：默认显示当前待提现申请信息；查询条件：提现日期，类型，角色，状态；显示信息：序号，提现日期，类型，提现角色，提现金额，状态，账户名，开户行，账号，联行号；当财务处理完转账后，可对记录状态进行变更操作；风控管理菜单目录结构：风控管理风控规则设置黑名单查询异常交易查询功能实现：风控规则设置：默认显示规则列表 : 序号，规则名称，每日交易次数，单笔交易限额，每日交 易总额，最后修改时间；可进行新增、修改、删除操作；黑名单查询：输入元素：卡号默认显示黑名单列表： 序号，商户号，终端号，交易日期，交易时间，流水号， 卡号，交易金额，应答码；异常交易查询：输入元素：起始日期，结束日期expFlag = 1 的交易为异常交易； 默认显示当天异常交易：交易日期、交易时间、商户、终端号、流水号、消费类型、卡号、会员姓名、手机号交易金额、交易状态、应答码、详细用户管理菜单目录结构：用户管理用户管理角色管理资源管理个人中心功能实现：用户管理：默认显示后台用户信息列表：序号，用户账号，用户姓名，描述，状态，开通日期，所属角色，所属代理商，详细；可对该表进行新增，修改，删除操作；可对用户进行角色分配；角色管理:默认显示角色列表：序号，角色名称，角色标识，角色描述，角色状态；可对新增、修改、删除 操作；可对角色进行资源权限分配；资源管理：输入元素：资源名称默认显示：序号，资源名称， Url ，资源描述，状态，标识，权值；对该表进行新增，修改，删除操作；个人中心：显示当前登陆用户详细信息；用户账号， 用户姓名， 描述，状态， 开通日期， 所属角色，所属代理商，最后登录时间；可对密码进行修改操作；系统管理菜单目录结构：系统管理MCC管理 卡 BIN 管理 联行号管理 地区码管理功能实现：MCC管理：查询元素：MCC马，关键字显示信息：MCC马，名称卡 BIN 管理： 查询元素：卡 Bin 号显示信息：序号，卡 Bin 号，所属银行，卡片类型，卡名称可新增卡 Bin ；联行号管理：查询元素：联行号，银行名称显示信息：序号，所属银行，联行号，银行全称地区码管理：查询元素：地区码，地区名称显示信息：地区码，地区名称