> 本文整理自平台文档 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/ | 后端宿主 + 平台 SQL | Java 17 / Spring Boot 3.5.15 | pom.xml(revision 5.6.2)、wujies-admin/ |
wujies/wujies-plugins/ | 插件本体 + 插件前端工程 + 打包器 | Maven(wujies-plugins-parent)+ pnpm workspace | package.ps1、pnpm-workspace.yaml、frontend/ |
plus-ui/ | 宿主前端 | Vue 3.5 / Vite 6.3 | vite.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/*"——已废弃。
现在每个应用的全部代码都在插件仓库自己的目录里:


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