<p> <a href="https://wujies.cn" target="_blank" rel="nofollow"> <img width="100" src="https://wujies.cn/brand/logo-stacked.svg" alt="Wujies 无界 logo"> </a> </p>
<p><b>财务管理</b>,聚合商城订单收款、售后退款与会员余额流水,给出财务流水 / 会员退款 / 会员收入三个财务视图。</p> <p> <a rel="nofollow"><img alt="应用版本" src="https://img.shields.io/badge/app-1.0.3-111111?style=flat-square"></a> <a rel="nofollow"><img alt="应用编码" src="https://img.shields.io/badge/code-finance-0057FE?style=flat-square"></a> <a rel="nofollow"><img alt="License" src="https://img.shields.io/badge/license-commercial-orange?style=flat-square"></a> <br> <a rel="nofollow">功能特性</a> <a rel="nofollow">预览</a> <a rel="nofollow">安装</a> <a rel="nofollow">设置</a> <a rel="nofollow">常见问题</a> <a href="https://docs.wujies.cn/docs/wujies/5.x/platform/plugin" rel="nofollow">插件开发</a> <a href="https://gitee.com/wujies" rel="nofollow">Gitee</a> </p>
Wujies 无界平台(wujies.cn)的财务管理应用,一个插件一个仓库。它是这批插件里少见的
纯前端包:整个仓库只有 frontend/,没有 pom.xml、没有 src/、没有 migrations/,app.json 也只声明了
assets.frontend。
- 后台:应用市场装上后多一个「财务管理」菜单,下挂财务流水 / 会员退款 / 会员收入三屏 (
finance:flow:list、finance:refund:list、finance:income:list),前端是远程应用(frontend/,16 个文件)。 - 数据来源:自己不落库、不写接口,读的是别的插件现成的接口 ——
frontend/src/api/下就是mall/order、mall/afterSale、member/balanceLog那几组;所以app.json的dependencies声明了member与mall,这两个应用没装时三屏就是空的。 - 前台:没有公开直出页(
src/main/resources/site-templates/不存在),只有管理端三屏。
应用编码 finance | 应用版本 1.0.3 | 清单 type = plugin(企业数据与考试系统写的是 app)
| 引擎 >=5.6.2 <6.0.0 | 无后端构件
✨ 功能特性
- 💰 财务流水 — 聚合商城订单收款:订单号、支付方式、金额、状态、下单与支付时间,可按条件筛选并导出核对。
- ↩️ 会员退款 — 售后退款单视图:退款单号、关联订单、退款金额与审核状态,与商城售后同一份数据。
- 📈 会员收入 — 会员余额流水视图:充值 / 消费 / 退款等变动明细,带汇总(
/member/balanceLog/summary)。 - 🔗 零后端、零建表 — 不新增业务表、不新增接口:三屏只是把商城订单、售后退款与会员余额流水按财务口径聚合展示 (原始设计即「不新增业务表」)。
- 📤 导出 — 三屏各自带上架时那套导出按钮,走各来源应用既有的导出能力。
- 🔐 多租户 — 数据来自
mall/member的租户表,租户口径由宿主拦截器与那两个应用自己收口。 - 🧩 纯前端形态 — 包里只有
frontend/index.js与样式,没有 jar;装、升级、卸载都不碰后端与数据库。
📸 预览
财务管理主界面

🚀 安装
环境要求
| 项 | 要求 |
|---|---|
| 平台版本 | >=5.6.2 <6.0.0(app.json 的 engine) |
| 后端构建 | 无(纯前端应用,仓库里没有 pom.xml);签名仍要 JDK 17+ —— 签名工具是 Java 写的 |
| 前端构建 | Node.js 18+(建议 20 LTS 及以上),npm |
| 依赖应用 | member、mall 必须先装(app.json 的 dependencies) |
| 安装方式 | 管理端「应用市场 → 本地安装」上传 zip,或由上架中心(wujies-market)发布后拉取 |
从应用市场安装
- 打开管理端「应用市场 → 本地安装」,上传打包好的 zip;或经上架中心发布后由平台拉取。
- 本应用没有迁移脚本:安装只登记应用、落位前端产物、按
menus幂等写菜单并授权当前租户管理员。 - 装完刷新菜单,出现「财务管理」下三屏即成功;点开是空列表就先看
member/mall装没装、启没启用。
包里只有一个产物,路径由 app.json 的 assets 决定:frontend → frontend/index.js(没有 backend 那一路)。
从源码构建
在本仓库根打包(三条命令各管一段,都在本仓库根执行):
powershell -NoProfile -ExecutionPolicy Bypass -File package.ps1 -CheckOnly # ① 打包前检查:清单/产物/迁移/菜单/密钥,几秒返回
powershell -NoProfile -ExecutionPolicy Bypass -File package.ps1 -Dev # ② 开发包:不签名,落 ..\.plugin-dist\finance\dev
powershell -NoProfile -ExecutionPolicy Bypass -File package.ps1 # ③ 正式包:构建 + 用 keys\private.pem 签名关于上面三条命令的取值口径:
- 判据是「脚本所在仓库根有没有
app.json」,所以在本仓库里不要传-Plugin(它按子目录找清单, 会报「找不到插件目录」);-FrontendProject/-FrontendDist也不用传 —— 独立布局的前端工程固定就是 本仓库frontend/、产物frontend/dist,脚本自己跑npm run build(首次先cd frontend && npm install, 缺依赖时脚本会把这条命令直接报给你)。只想复用现成产物就加-SkipBuild。 -SkipFrontend只用于没有前端的纯后端应用:带前端时它会连「复制前端产物」一起跳过, 出的包只有app.json,装上去没有界面。本应用全是前端,任何时候都别加它。- 本应用是纯前端包:没有后端构建、没有
backend/这一步,但签名仍然要 JDK —— 签名工具是 Java 写的, 正式包那一步要求签名类可用。体检对纯前端的口径是明确的(CHECK|OK|后端产物|纯前端应用:没有后端产物(合法形态)), 不会因为缺pom.xml报 ERROR。 -CheckOnly打出的CHECK|级别|项|说明行就是管理端「开发工具 → 插件开发 → 打包」抽屉里那份体检清单, 两边跑的是同一套检查;有 ERROR 时正式打包会被直接拦下。签名密钥在本仓库keys/(private.pem+public.pem,已在.gitignore里),生成或更换用-Keygen(覆盖已有密钥要显式加-KeygenForce,旧钥先整份备份进keys\backup\<时间戳>\)。 参数全表与产物结构见文档站「打包应用」与「密钥与签名」两页。
升级与卸载
- 升级:换
app.json的version后重新打包上传,菜单按menu_key幂等 upsert(不会建出第二套)。 没有迁移脚本,所以不存在「已执行脚本不能改」的问题。 - 卸载:管理端「应用市场」里卸载。本应用没有自己的表,不会删
mall/member的任何数据; 菜单行按归属清理。
⚙️ 设置
本应用没有配置页、没有 sys_config 种子、没有字典:三屏的筛选条件与列都直接对应来源接口的查询参数,
没有可调的运行期开关。
要改变展示口径只能改来源应用(mall 的订单 / 售后、member 的余额流水),或者在财务这三屏里改前端
(frontend/src/views/finance/{flow,refund,income}/index.vue)。
菜单入口
| 菜单 | 路径 | 组件键 | 权限前缀 |
|---|---|---|---|
| 财务管理(目录) | finance | — | — |
| 财务流水 | finance/flow | remote:finance/finance/flow | finance:flow:list |
| 会员退款 | finance/refund | remote:finance/finance/refund | finance:refund:list |
| 会员收入 | finance/income | remote:finance/finance/income | finance:income:list |
三个 C 菜单都没有 F 按钮:页面里能点的操作,权限判据落在 mall / member 各自接口上
(例如导出、改单都走来源应用的 @SaCheckPermission)。
🧩 依赖与插件支持
| 项 | 说明 |
|---|---|
| 依赖插件 | member、mall(app.json 的 dependencies)。⚠️ 这两个只在清单里声明,仓库里没有对应的校验代码;装没装、声明怎么被宿主使用,回平台侧确认 |
| 数据来源 | /mall/order/list(订单收款)、/mall/afterSale/list(售后退款)、/member/balanceLog/list + /summary(会员余额流水) |
| 平台存储 | 不涉及(无上传、无落库) |
| 公共 API | 前端走打进包内的 @wujies/api-client,运行期由宿主 import map 提供 vue / element-plus / @wujies/ui-shared 单例 |
| 后端 | 无。纯前端应用是合法形态:平台落位时对 assets.backend 为空是判空处理的 |
开发环境
git clone git@gitee.com:wujies/wujies-finance-plugin.git
cd wujies-finance-plugin最快的路子不用打包、不用重启宿主:启动平台宿主,打开管理端「开发工具 → 插件开发」,找到 finance 这一行。
本应用没有后端,要点的是「启动前端」(常驻 vite build --watch,保存源码即重建,刷新页面生效,没有 HMR);
后端那一侧没有可编译的产物。全流程见文档站「插件开发」。
手工构建(就是整仓库唯一的构建动作):
cd frontend && npm install && npm run build # 产物 dist/index.js + assets/finance-app.css打包脚本:本仓库自带完整的 package.ps1(母本在 wujies-plugins 仓库根,各仓用
node scripts/sync-package-script.mjs 同步过来),clone 下来就能在本仓库根直接体检、构建、签名、出包、
生成密钥,不需要回到单体仓库,也不需要手工传产物路径。
前端 SDK:已迁到已发布的 @wujies/* SDK(ui-shared / components / api-client /
ui-plugin-bundler-kit)。frontend/vite.config.ts 只声明 defineRemoteApp({ appCode, root }),
共享依赖一律 external、运行期由宿主 import map 兜到同一份实例;宿主独有工具与业务模块
(@/utils/wujies、@/api/system/*、UserSelect/MemberSelect 等)按原样复制进了 frontend/src/,
proxy?.$modal / useDict / download 与 ImageUpload/UserDetail/Module*Settings 由宿主运行时提供。
本仓库前端可独立构建;要直接落位到宿主,构建前设
WUJIES_FRONTEND_DIST=/app-market-dist/remote-apps。
仓库布局
| 位置 | 内容 |
|---|---|
| app.json | 应用清单,打包器读的唯一事实来源(code / version / menus / assets / dependencies) |
| frontend/ | 远程应用源码(src/ 16 个文件),入口 frontend/src/index.ts,三屏在 views/finance/{flow,refund,income}/index.vue |
| frontend/src/api/ | 三个来源接口的包装层:mall/order、mall/afterSale、member/balanceLog(另有 coupon / orderItem / promotion 的类型定义) |
| docs/screenshots/finance.png | 「预览」那一张 |
| package.ps1、package.cmd、keys/ | 打包脚本与包签名密钥(keys/ 已 gitignore,不入库) |
没有 pom.xml、src/、migrations/、site-templates/ —— 纯前端应用的合法形态,不是漏搬。
app.json 的 migrations 是空数组,这也是正确写法:迁移脚本走仓库根的 migrations/ 目录(本仓没有)。
❓ 常见问题
Q:装好了,三屏都是空列表?
先确认 member 与 mall 都装了且是启用状态 —— 本应用自己不存数据,三屏全部读这两个应用的接口。
dependencies 只是清单声明,宿主不会替你补装。
Q:装完只有我这个管理员能看到菜单,别的角色进去没权限?
平台的安装器只把菜单授给安装者所属角色;其余角色要在「系统管理 → 角色管理」里自己勾
finance:flow:list / finance:refund:list / finance:income:list。平台侧另有幂等的批量授权脚本
(script/sql/update/finance_menu_grants.sql,按 menu_key 定位菜单),没有它就只能手工勾。
Q:打包脚本会不会因为「没有后端产物」报 ERROR?
不会。纯前端是明确支持的形态:-CheckOnly 打 CHECK|OK|后端产物|纯前端应用:没有后端产物(合法形态),
脚本跳过 Maven 与 jar 组装(也就不需要 JDK 编译);但签名仍要 JDK,签名工具是 Java 写的。
Q:能加 -SkipFrontend 省一步吗?
不能。本应用只有前端,加了它出的包只有 app.json,装上去三个菜单点开是空白。
Q:frontend/src/index.ts 里 manifest.version 还是 1.0.0,要不要改?
它只影响装载日志里那一行显示,不是判据;但改 app.json 的 version(当前 1.0.3)时这一处该一起动,
package.ps1 不会替你对账。
Q:前端构建产物里有裸 vue 之类的 import,会不会找不到?
正常。vue / element-plus / @wujies/ui-shared 由宿主 import map 提供单例,属于刻意 external。
Q:manifest.styles 写的 assets/finance-app.css 对不上产物文件名?
样式表名由 Vite 库模式按 frontend/package.json 的 name 生成,写错不报错,只是页面没样式;
构建后核一遍 frontend/dist/assets/ 下的真实文件名。
🔒 隐私与外部资源
- 不收集、不上报任何遥测;不落库、不缓存,页面数据全部来自
mall/member的接口。 - 前端不引第三方统计脚本;远程应用只经宿主 import map 取共享依赖。
- README 与仓库中不包含任何真实口令、token 或私钥;包签名密钥只在本机
keys/(已 gitignore)。
📄 许可证与致谢
商业授权:需要一枚覆盖本应用的有效授权凭证才允许安装与加载(条文见仓库根目录 LICENSE)。
清单 app.json 里 license 为 UNLICENSED、licenseRequired 为 true;三档口径(社区版 / 专业版 / 企业版)
见官网文档「授权与版本」。
💬 反馈与建议
- 仓库:gitee.com/wujies/wujies-finance-plugin
- 文档:插件开发见 docs.wujies.cn,打包见 「打包应用」
参考
wujies-hello-plugin(已按新布局跑通前端独立构建的样板)、
wujies-ui(npm 上 @wujies/* 四件套的源码仓)、
wujies-mall-plugin 与
wujies-member-plugin(三屏的数据来源)、
文档站「插件开发」章节。
评论区需要浏览器启用 JavaScript 才能加载。