Wujies 无界平台
应用

财务管理(finance)

商城收款、售后退款与会员余额流水的三屏聚合视图不产生任何数据,页面空不空取决于另外两个应用装没装。

应用编码 finance,本页对应应用版本 1.0.2(引擎要求 >=5.6.2 <6.0.0),商业授权(app.json 写 UNLICENSED,见 按应用授权),仓库 wujies-finance-plugin。

财务给的是账本的对账视图:把商城订单收款、售后退款、会员余额流水三摊钱并到一根时间轴上算合计,页面本身不产生任何业务数据。数据源头分属 商城 与 会员中心,财务侧只存展示逻辑。审核、退款、改余额都不在这些页里做,回到各自应用去操作。

因为不落数据,这三屏没有「数据坏了」这种故障形态:要么取到数,要么取不到数外加一句提示,下文把取不到的分支逐页拆开写。

装它

清单声明了 member 与 mall 两个依赖,但这个包只有前端产物(没有后端 jar、没有建表脚本),三屏的数据是打开页面那一刻调那两个应用的接口现取的,所以装得上和用得全是两件事,缺谁的表现见「出问题查什么」。

  1. 确认 mall 已启用,否则会员退款整页空,流水页里的订单收款与退款两摊也没有。
  2. 确认 member 已启用,否则会员收入整页空,流水页里的余额流水没有。
  3. 给用这三页的账号同时配上那两个应用的列表权限码。finance:*:list 三个码只管这三屏进不进得去,数据能不能取回按商城与会员接口自己的权限口径判。
  4. 升级或回退本应用不需要任何数据迁移准备:它没写过库,换包只影响这三屏的前端。

商业应用要先购买激活,流程见 应用目录;安装步骤与「装完菜单为什么没立刻出现」见 在部署里使用应用。

装成功后侧栏多一个「财务管理」,下面三项:

菜单路由需要的权限码
财务流水flowfinance:flow:list
会员退款refundfinance:refund:list
会员收入incomefinance: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 的并发取数写法与另两页的单路写法从代码推定,没在停装环境下联机点过(未联机验证)。

目录