中国 帮助

仓库目录

这一页回答"哪个文件该放哪"。代码分属多套 git 仓库(没有共同根,各自提交), 所以目录结构本身就是一条约定:先看它属于哪个仓库,再决定改哪里。 本章节其它页面讲"为什么这么设计";这一页只讲"东西在哪"。 目录是照着实际文件系统

仓库目录
封面

> 本文整理自平台文档 docs/wujies/5.x/platform/architecture/repo-layout.mdx,用于站点内容演示。

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

这一页回答"哪个文件该放哪"。代码分属多套 git 仓库(没有共同根,各自提交), 所以目录结构本身就是一条约定:先看它属于哪个仓库,再决定改哪里。

> 本章节其它页面讲"为什么这么设计";这一页只讲"东西在哪"。 > 目录是照着实际文件系统读出来的(2026-10 工作区),不是凭记忆写的 —— > 结构变了请重读一遍再改这一页。

仓库一览

仓库内容默认分支
wujies-platform后端(Java / Spring Boot)+ 平台 SQL 脚本feature/app-market
wujies-<code>-plugin(12 个)一个应用一个仓库:后端模块 + app.json + migrations/ + frontend/ 前端工程 + 完整打包脚本一份 + keys/master
wujies-admin宿主前端(Vue 3 / Vite)feature/app-market
wujies-ui前端 SDK 四件套(@wujies/ui-shared / components / api-client / ui-plugin-bundler-kit),发 npmmaster
wujies-webPC 用户端(Vue 3 + Element Plus)master
wujies-uniapp移动端(uni-app:H5 / App / 小程序)master
wujies-site本站(官网 + 文档站,Next.js 静态导出)main
wujies-market私有仓库,不公开:中心上架服务(目录与上架的唯一维护处),见[应用市场模块](/docs/wujies/5.x/platform/architecture/app-market-module)master

> 早期那棵 wujies-plugins 单体仓库已经不是开发入口:各应用拆仓之后它没有再公开 > (Gitee 上取不到),里面的 package.ps1、keys/、脚手架都已按应用拆进各自仓库。 > 本机还留着它,只剩旧脚手架模板(frontend/hello-app)与 docs/ 这些历史内容。 > 读到旧文档里的 wujies-plugins/xxx 路径,一律换成 wujies-<code>-plugin/xxx。

它们没有共同 git 根:改一个功能经常要跨仓库提交两到三次。 本机布局是一个项目根(wujies/)下摆所有仓库,12 个应用仓库收在 wujies/plugins/ 这一层, 与 wujies-admin/、wujies-platform/ 同级 —— 宿主的守门脚本和 dev server 就按这层关系自动找工程 (<项目根>/plugins/wujies-<code>-plugin/frontend,旧的宿主同级布局仍兼容)。 工程在项目根之外时设 VITE_PLUGIN_REPOS 指定(; 或 , 分隔); WUJIES_FRONTEND_DIR 覆盖的是单体那一路(指向一个装着若干 <code>-app 的目录)。

---

一、wujies-platform/ —— 后端

反应堆根 pom.xml 的 <modules> 只有 4 个聚合模块: wujies-admin、wujies-common、wujies-extend、wujies-modules。

wujies-platform/
├── pom.xml                       反应堆根:<modules> 只列上面 4 个聚合模块
├── AGENTS.md                     ★ 改代码前扫一遍的"不变量与已知坑"清单(权威,优先级最高)
├── wujies-admin/                 后端启动模块(Java)。产物 wujies-admin.jar
│   ├── Dockerfile
│   └── src/                      PluginClassPathLoader 在这里(Spring 之前执行)
├── wujies-common/                基础设施,27 个子模块(见下)
├── wujies-extend/                旁挂服务,独立进程
│   ├── wujies-monitor-admin/     监控端
│   └── wujies-snailjob-server/   定时任务调度服务端
├── wujies-modules/               业务模块,5 个
│   ├── wujies-app-market/        ★ 应用市场:安装编排 + 插件运行时 + 落位与任务
│   ├── wujies-market-core/       ★ 上架判据内核:目录访问 / 包摘要与验签 / 清单校验与菜单计划
│   │                             (平台与中心上架服务共用这一份字节码)
│   ├── wujies-system/            系统管理(用户 / 部门 / 角色 / 菜单 / 字典 / OSS / 消息)
│   ├── wujies-workflow/          工作流
│   └── wujies-plugin-probe/      插件运行时探针
├── script/                       运维与数据脚本
│   ├── sql/                      平台建表脚本(`platform_init.sql` / `app_market_schema.sql`)+ `update/` 增量
│   ├── docker/ · leave/
├── deploy/                       部署物料与工具
│   ├── 1panel/                   1Panel 应用包定义
│   ├── docker/ · dist/
│   └── tools/                    种子 SQL / 迁移拆分等生成器(Node 脚本)
├── plugins-dist/                 ★ 插件 jar 的落位目录(`app-market.deploy.plugin-dir` 默认值,
│                                 loader.path 指向它,只读根下、不递归;首次部署才生成)
│   ├── active-plugins.txt        本机启用清单:不在清单里的 jar 不挂载
│   ├── wujies-<app>-plugin-<版本>.jar
│   └── migrations/<appCode>/     随包迁移脚本(子目录,刻意不会被当插件加载)
├── docs/                         平台侧文档与 SQL 片段
└── logs/                         运行日志

### wujies-common/ 的 27 个子模块

章节导览
THE END

喜欢就支持以下吧

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

回到内容