财务管理(finance)
商城收款、售后退款与会员余额流水的三屏聚合视图不产生任何数据,页面空不空取决于另外两个应用装没装。
应用编码 finance,本页对应应用版本 1.0.2(引擎要求 >=5.6.2 <6.0.0),商业授权(app.json 写 UNLICENSED,见 按应用授权),仓库 wujies-finance-plugin。
财务给的是账本的对账视图:把商城订单收款、售后退款、会员余额流水三摊钱并到一根时间轴上算合计,页面本身不产生任何业务数据。数据源头分属 商城 与 会员中心,财务侧只存展示逻辑。审核、退款、改余额都不在这些页里做,回到各自应用去操作。
因为不落数据,这三屏没有「数据坏了」这种故障形态:要么取到数,要么取不到数外加一句提示,下文把取不到的分支逐页拆开写。
装它
清单声明了 member 与 mall 两个依赖,但这个包只有前端产物(没有后端 jar、没有建表脚本),三屏的数据是打开页面那一刻调那两个应用的接口现取的,所以装得上和用得全是两件事,缺谁的表现见「出问题查什么」。
- 确认
mall已启用,否则会员退款整页空,流水页里的订单收款与退款两摊也没有。 - 确认
member已启用,否则会员收入整页空,流水页里的余额流水没有。 - 给用这三页的账号同时配上那两个应用的列表权限码。
finance:*:list三个码只管这三屏进不进得去,数据能不能取回按商城与会员接口自己的权限口径判。 - 升级或回退本应用不需要任何数据迁移准备:它没写过库,换包只影响这三屏的前端。
商业应用要先购买激活,流程见 应用目录;安装步骤与「装完菜单为什么没立刻出现」见 在部署里使用应用。
装成功后侧栏多一个「财务管理」,下面三项:
| 菜单 | 路由 | 需要的权限码 |
|---|---|---|
| 财务流水 | flow | finance:flow:list |
| 会员退款 | refund | finance:refund:list |
| 会员收入 | income | finance:income:list |
没有按钮级权限码:三屏都是只读查询,行上没有任何写操作。
配它
本应用没有配置项:无设置页、无 sys_config 键、无迁移脚本。能改的口径都硬编码在前端页面里,要动就得改源码重新出包,见 构建应用包 与 升级。
记账口径三句话:
| 页 | 数据来源 | 收哪些 |
|---|---|---|
| 财务流水 | 商城订单、售后单、会员余额流水三路并发拉取后合并 | 订单收款按支付状态与订单状态两份清单判定;售后退款记负数;余额流水只收 changeType 为 1(充值)的正数 |
| 会员退款 | 商城售后单 | 全部,状态展示为待审核 / 已同意 / 已拒绝 / 已退款 / 已关闭 |
| 会员收入 | 会员余额流水 | 只收充值方向 |
表里出现的状态清单与判定值都硬编码在各页源码里;状态的业务含义查 商城 与 会员中心 各自那页,这里不重述第二遍。
流水页顶部四格汇总(流水笔数 / 收入金额 / 退款金额 / 净额)是对着上面合并结果现算的,每路来源单次只取前 200 条。业务量上来之后这个上限会先碰到,汇总格子统计的是取回范围内的数,别拿它当全量对账;需要全量就回 商城 与 会员中心 各自的分页列表或导出。
符号口径一句话:退款行记负数,净额等于收入减退款,全部在前端现算;对不上手工预期时先查退款行的符号与售后单号取的是哪一列。
合并后的每一行流水统一成单号、方向、金额、时间、备注:订单收款行备注固定「商城订单收款」;退款行取售后单号(没有就取退款单号),金额记负;余额行取该笔流水的业务单号。金额展示走前端统一的货币格式化。取数参数与判定清单都写死在 flow/index.vue,页面上没有开关能调口径。
用它
管理员打开「财务流水」按类型、关键字、日期段筛(筛选发生在浏览器里,筛的是已取回的 200×3 条),核对某天收款与退款;「会员退款」用来盯售后单进度;「会员收入」用来看充值。三屏都只有刷新 / 查询 / 重置。
会员与访客没有任何入口:本应用没有会员端路由、没有公开页、没有 /portal/** 接口。
三屏都没有导出按钮;要留台账回 商城 与 会员中心 各自导出再拼。
出问题查什么
| 现象 | 先看什么 |
|---|---|
| 流水页整页空表,同时弹出「应用「X」未安装或未启用…」 | 三路请求并发发起,任何一路失败整页就没有数据;装好或启用缺的那个应用再刷新 |
| 流水页空但没弹窗 | 当前账号缺商城订单 / 售后 / 会员余额流水的列表权限码,接口被权限挡了 |
| 会员退款页空、流水页正常 | mall 没装或没启用;该页只依赖这一个来源 |
| 会员收入页比预期少 | 只统计充值方向的流水,消费与退款不在收入口径里 |
| 合计数对不上实际成交 | 每路 200 条的取数上限;超出部分没取回也就没参与计算 |
| 行序或金额看着不对 | 排序与算术发生在浏览器里;对不上时先核对三路接口的返回,再对照页面上的判定清单 |
| 页面正常但数据停在旧记录 | 回来源应用确认有新的订单 / 售后 / 流水;财务没有同步任务可坏,它每次打开都在现查 |
| 装完侧栏没有「财务管理」 | 菜单树在登录时生成,重建入口见 在部署里使用应用 |
实现索引
| 项 | 值 |
|---|---|
| 数据表 | 无:纯前端应用,仓库里没有后端 jar 与 migrations/ |
| 菜单结构 | 一个「财务管理」目录加三页,没有 F 按钮(只读屏) |
| 后台接口 | 无自有接口;展示数据全部调用其他应用的既有接口 |
| 读取的接口 | GET /mall/order/list、GET /mall/afterSale/list、GET /member/balanceLog/list(参数与状态清单见各页源码) |
| 金额格式化 | 前端统一走 utils/wujies.ts 的 formatCurrency,财务页上没有货币或精度开关 |
| 数据权限 | 取数按来源应用的接口权限判,finance:*:list 不代管这些数据权限 |
| 会员端 / 公开端 | 无 |
| 自带静态资源 | frontend/index.js(后台三页的远程组件;由 frontend/ 构建产出 dist/index.js 与 assets/finance-app.css) |
| 前端源码 | flow / refund / income 三个页签各一个视图文件,三路接口的封装在 src/api 下 |
| 源码 | frontend/src |
没有表可删,卸载本应用不动任何业务数据:AppPurgeService 解析迁移脚本来确定删表范围,本应用解析结果为空集,菜单与前端资源另有清理路径(规则见 数据库迁移)。
上面「缺应用时整页空还是报错」的分支按 flow/index.vue 的并发取数写法与另两页的单路写法从代码推定,没在停装环境下联机点过(未联机验证)。