中国 帮助

财务管理

官方 付费 插件

Wujies 无界平台(wujies.cn)的财务管理应用,一个插件一个仓库。它是这批插件里少见的

v1.0.3 1 次安装 本季度 1 次

<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) | 引擎 &gt;=5.6.2 &lt;6.0.0 | 无后端构件

✨ 功能特性

  • 💰 财务流水 — 聚合商城订单收款:订单号、支付方式、金额、状态、下单与支付时间,可按条件筛选并导出核对。
  • ↩️ 会员退款 — 售后退款单视图:退款单号、关联订单、退款金额与审核状态,与商城售后同一份数据。
  • 📈 会员收入 — 会员余额流水视图:充值 / 消费 / 退款等变动明细,带汇总(/member/balanceLog/summary)。
  • 🔗 零后端、零建表 — 不新增业务表、不新增接口:三屏只是把商城订单、售后退款与会员余额流水按财务口径聚合展示 (原始设计即「不新增业务表」)。
  • 📤 导出 — 三屏各自带上架时那套导出按钮,走各来源应用既有的导出能力。
  • 🔐 多租户 — 数据来自 mall / member 的租户表,租户口径由宿主拦截器与那两个应用自己收口。
  • 🧩 纯前端形态 — 包里只有 frontend/index.js 与样式,没有 jar;装、升级、卸载都不碰后端与数据库。

📸 预览

财务管理主界面

![财务管理主界面](docs/screenshots/finance.png)

🚀 安装

环境要求

| 项 | 要求 | |---|---| | 平台版本 | &gt;=5.6.2 &lt;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)发布后拉取 |

从应用市场安装

  1. 打开管理端「应用市场 → 本地安装」,上传打包好的 zip;或经上架中心发布后由平台拉取。
  2. 本应用没有迁移脚本:安装只登记应用、落位前端产物、按 menus 幂等写菜单并授权当前租户管理员。
  3. 装完刷新菜单,出现「财务管理」下三屏即成功;点开是空列表就先看 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 &amp;&amp; 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\&lt;时间戳&gt;\)。 参数全表与产物结构见文档站「打包应用」与「密钥与签名」两页。

升级与卸载

  • 升级:换 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 &amp;&amp; npm install &amp;&amp; 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;三档口径(社区版 / 专业版 / 企业版) 见官网文档「授权与版本」。

💬 反馈与建议

参考

wujies-hello-plugin(已按新布局跑通前端独立构建的样板)、 wujies-ui(npm 上 @wujies/* 四件套的源码仓)、 wujies-mall-plugin 与 wujies-member-plugin(三屏的数据来源)、 文档站「插件开发」章节。

v1.0.3 2026-11-08 平台 >=5.6.2 <6.0.0 8 KB

修复

  • 同步公钥检查——开源仓 yml 只有环境变量占位符时改比部署仓 keys/package-public.pem

其他

  • finance 1.0.3 —— 版本号同步
v1.0.1 2026-10-02 平台 >=5.6.2 <6.0.0 7 KB

这个版本没有写更新日志。

评论区需要浏览器启用 JavaScript 才能加载。