中国 帮助

项目结构

这一页解决什么问题 接手这个项目时,真正会让人走错路的不是"目录很多",而是三件事: 1. 代码不在一个仓库里 —— 后端、插件、宿主前端各自是独立 git 仓库,改一个功能常常要动两个; 2. 应用不是平台的模块 —— 每个应用的实

项目结构
封面

> 本文整理自平台文档 docs/wujies/1.x/guide/structure.mdx,用于站点内容演示。

(https://console.wujies.cn/remote-apps/cms-assets/doc-277d2183a745-cover.svg)

这一页解决什么问题

接手这个项目时,真正会让人走错路的不是"目录很多",而是三件事:

1. 代码不在一个仓库里 —— 后端、插件、宿主前端各自是独立 git 仓库,改一个功能常常要动两个; 2. 应用不是平台的模块 —— 每个应用的实体、Mapper、XML、Service、controller、迁移脚本、 清单都在插件仓库里,平台里找不到它的源码; 3. 同名目录指的不是同一个东西 —— 顶层 wujies-admin/ 和 wujies-platform/wujies-admin/ 是两回事,plus-ui/package.json 里的 name 又写着 wujies-admin。

下面按"仓库 → 后端 → 插件 → 前端 → 脚本 → 配置"的顺序给出当前真实布局, 以及每条结论的查证方式。本页对应的是当前工作区,不是历史文档里的旧布局。

三个仓库,没有共同 git 根

仓库角色技术栈顶层标志物
wujies-platform/后端宿主 + 平台 SQLJava 17 / Spring Boot 3.5.15pom.xml(revision 5.6.2)、wujies-admin/
wujies/wujies-plugins/插件本体 + 插件前端工程 + 打包器Maven(wujies-plugins-parent)+ pnpm workspacepackage.ps1、pnpm-workspace.yaml、frontend/
plus-ui/宿主前端Vue 3.5 / Vite 6.3vite.config.ts、src/、app-market-dist/

三个目录各自执行 git rev-parse --show-toplevel,会得到各自的路径 —— 它们没有共同 git 根,需要分别提交。

这个坑已经误导过两次排查,读任何路径前先按"有没有 pom.xml / package.json"判一下:

你看到的写法实际指判据
wujies-platform/wujies-admin/后端启动模块(Java,产物 wujies-admin.jar)有 pom.xml、src/main
工作区顶层的 wujies-admin/前端产物落位目录,里面只有 app-market-dist/没有 package.json、没有 src/
plus-ui/宿主前端仓库有 vite.config.ts、src/;package.json 的 name = wujies-admin(混淆的根源)

plus-ui/package.json 的 name 字段确实是 wujies-admin,那是名字不是位置。 凡是指向 src/plugins/、src/views/、app-market-dist/** 的,都是前端 = plus-ui/。

工作区根的 docs/(含开发问题记录、教程、方案)不在任何 git 仓库里, 改它不会留下版本历史。要长期保留的内容放到 wujies/wujies-plugins/docs/ 或 wujies-platform/docs/。

后端:wujies-platform/

平台根 pom 只挂四个聚合模块,全反应堆 38 个 pom.xml(含各层 parent):

wujies-platform/
├── wujies-admin/                 启动模块(PluginClassPathLoader 在这里,Spring 之前执行)
├── wujies-common/                基础设施(27 个子模块)
│   ├── wujies-common-core/       PluginServiceProvider + MenuOwnershipProvider(宿主反查插件/菜单归属的 SPI)
│   ├── wujies-common-web/        GlobalExceptionHandler(异常 → 前端的唯一出口)
│   └── wujies-common-plugin-sdk/ 宿主向插件暴露的能力契约(插件唯一应依赖的宿主入口)
├── wujies-modules/
│   ├── wujies-app-market/        ★ 应用市场:目录 + 运行时 + 上架端 + 安全
│   │   ├── catalog/              IAppCatalogService + Local/Remote 实现(目录访问的唯一入口)
│   │   ├── edition/              版本形态开关(official / client)
│   │   ├── plugin/               PluginClassLoader / PluginHandlerMapping
│   │   │                         / PluginRuntimeManager / PluginMapperRegistrar
│   │   ├── security/             PackageDigest / Inspector / SignerMain
│   │   ├── service/impl/         AppInstallServiceImpl(生命周期编排)
│   │   ├── spi/                  AppInstaller(安装器 SPI)
│   │   └── support/              AppTaskRecorder(进度落库)
│   ├── wujies-system/            系统管理(用户/部门/角色/菜单/字典/OSS/消息)
│   ├── wujies-workflow/          工作流
│   └── wujies-plugin-probe/      插件运行时探针(自带 mapper XML 与定时任务的最小样本)
├── wujies-extend/                独立服务:wujies-monitor-admin、wujies-snailjob-server
├── script/
│   ├── prune/                    start-host.ps1 / prune-plugins.ps1 / prune-plugins.sh
│   └── sql/                      platform_init.sql、update/*.sql、archive-upstream/、backup/
├── deploy/                       1Panel 应用模板与构建工具(deploy/tools/*.mjs)
├── plugins-dist/                 ★ 后端插件 jar 落位目录(不递归子目录)
├── dist-packages/                ⚠️ **历史**产物目录(打包器早已不再往这里写,仍在 .gitignore)
└── docs/                         平台侧文档 + docs/removed/(已归档的 wujies-portal、wujies-openapi)

平台里没有 *-api 契约模块,也没有 wujies-job / wujies-generator (定时任务随应用走,宿主只提供 wujies-common-job)。

wujies-platform/docs/removed/,不在任何 <modules> 里、不参与编译。 它们里面仍有 import cn.wujies.gallery.* 这类语句;把这批文件排除之后, 真正参与编译的模块里对 cn.wujies.<app>.* 的引用只剩一处测试 (wujies-app-market/src/test/.../PluginClassLoaderIdentityTest.java,用途是断言 PluginClassLoader.ownerAppCodeOf(...) 能按包名识别归属应用)。

  • wujies-modules/*-api 模块数为 0:在 wujies-platform 下
  • 已归档的 portal / openapi 不算平台引用:这两个模块的源码在

契约随插件走:每个应用是自包含的一个工程

这是整套结构里最需要记住的一条,也是最近一次被推翻的设计。 旧结构是"契约放 *-api 模块(在 reactor 内)+ 实现放 plugins/*"——已废弃。

现在每个应用的全部代码都在插件仓库自己的目录里:

章节导览
THE END

喜欢就支持以下吧

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

回到内容