> 本文整理自平台文档 docs/wujies/1.x/guide/quickstart.mdx,用于站点内容演示。
(https://console.wujies.cn/remote-apps/cms-assets/doc-db6694dbfcf3-cover.svg)
这一页只解决一件事:在开发机上从空库走到「装上第一个应用」,把数据库、后端宿主、插件运行时、前端、迁移与菜单这条链路走通。
读完之后你能回答下面这些问题:
| 问题 | 本文位置 | 权威依据 |
|---|---|---|
三个仓库各是什么,wujies-admin 指的到底是哪一个 | §1 | wujies-platform/AGENTS.md §0 |
| 要导哪些 SQL、按什么顺序导 | §2 | script/sql/README.md、deploy/tools/build-1panel.ps1 |
| 怎么编译、怎么启动后端(并真的加载插件) | §3–§4 | script/prune/start-host.ps1、wujies-admin/src/main/resources/application.yml |
| 怎么起前端,它连的是哪个后端 | §5 | plus-ui/vite.config.ts、plus-ui/.env.development |
| 怎么装一个应用,怎么判断它真的生效了 | §6–§7 | AGENTS.md §3.2、§3.4 |
| 怎么跑测试 | §8 | 根 pom.xml |
本页不讲:怎么写一个应用(见 [应用清单](/docs/wujies/1.x/plugin-dev/basics/manifest)、[必须遵守的不变量](/docs/wujies/1.x/plugin-dev/basics/invariants))、怎么打包上架(见 [发布应用包](/docs/wujies/1.x/package/publish))、生产部署(见 [在部署里使用应用](/docs/wujies/1.x/basics/using-apps)、[升级](/docs/wujies/1.x/deploy/upgrade))。
---
1. 先认清楚三个仓库
三个仓库没有共同的 git 根,各自提交、各自分支。
| 目录(相对工作区根) | 是什么 | 怎么认出来 |
|---|---|---|
wujies-platform/ | 后端(Java / Spring Boot)+ SQL 脚本 | 有 pom.xml、wujies-admin/、script/sql/ |
wujies/wujies-plugins/ | 应用本体(插件)+ 应用前端工程(pnpm workspace)+ 打包器 | 有 package.ps1、wujies-<app>/、frontend/<app>-app/、keys/ |
plus-ui/ | 宿主前端(Vue 3 / Vite) | 有 vite.config.ts、src/ |
| 写法 | 实际指 | 判据 |
|---|---|---|
wujies-platform/wujies-admin/ | 后端启动模块,产物 wujies-admin/target/wujies-admin.jar | 有 pom.xml、src/main/、Dockerfile |
工作区顶层的 wujies-admin/ | 只有 app-market-dist/,前端产物的落位目录 | 没有 package.json、没有 src/ |
plus-ui/ | 宿主前端仓库;它的 package.json 里 name 就是 wujies-admin(混淆的根源) | 有 vite.config.ts、src/ |
### 后端模块地图
| 路径 | 内容 |
|---|---|
wujies-admin/ | 启动模块。PluginClassPathLoader 在这里,在 Spring 之前执行 |
wujies-common/ | 基础设施:wujies-common-core、-web、-mybatis、-job、-plugin-sdk 等 |
wujies-modules/wujies-app-market/ | 应用市场:目录、插件运行时、上架端、包安全 |
wujies-modules/wujies-system/ | 用户 / 角色 / 菜单 / 租户等底座 |
wujies-modules/wujies-workflow/ | 工作流 |
wujies-modules/wujies-plugin-probe/ | 插件运行时探针 |
wujies-extend/ | 独立服务:调度中心、监控中心 |
有三样东西不存在,别去找:
- 平台里没有任何给应用准备的契约模块。
wujies-modules/下只有上表那几个,平台对cn.wujies.<app>.*的 Java 引用数量是 0。契约随插件走。 - 没有
wujies-job/wujies-generator/wujies-demo模块(已删除)。定时任务随应用走,宿主只提供wujies-common-job。 - 平台仓库里没有
plugins/目录。插件本体在另一个仓库。
### 应用长什么样
每个应用是 wujies-plugins/wujies-<app>/ 下一个自包含工程,契约与实现同处一室:
wujies-plugins/wujies-gallery/
├── app.json 清单:code / version / assets / menus
├── pom.xml 平台依赖一律 provided
├── migrations/01-create-gallery-tables.sql
└── src/main/
├── java/cn/wujies/gallery/{domain,domain/bo,domain/vo,mapper,service,service/impl,controller,open,listener}
└── resources/mapper/gallery/*.xml ← Mapper XML 在插件里,随 jar 走
- 实体 / BO / VO / Mapper 接口 / Mapper XML / Service 接口与实现 / controller / open / listener / task 全在插件模块自己的
src/下; - Mapper XML 由
PluginMapperRegistrar在插件加载时动态注册进宿主的SqlSessionFactory,不是靠宿主扫mapperLocations; - 插件之间要对方的契约时,依赖兄弟插件构件(同样
provided)。
「契约单独放一个平台模块」「Mapper XML 必须留在平台侧」「靠宿主的 mapperLocations 扫插件里的 XML」都是 2026-09-30 之前的规则,已经不成立。看到这类描述(包括本站其它页面里的)以 AGENTS.md §2.2 为准。
应用有两种形态,都不奇怪:
| 形态 | 判据 | 例子 |
|---|---|---|
| 全栈应用 | 有 app.json、pom.xml、后端 src/,也有 frontend/<app>-app/ | wujies-gallery、wujies-exam、wujies-mall |
| 纯前端应用 | 目录下只有 app.json,包里没有 jar | wujies-finance |
---
2. 建库:按这个顺序导 SQL
全新部署只认平台自己的初始化脚本。应用自己的表不在这里,它们随应用包走。
| 顺序 | 文件 | 内容 |
|---|---|---|
| ① | wujies-platform/script/sql/platform_init.sql | 平台初始化:25 张 sys_* 表 + 地区 / 字典 / 参数 / 菜单 / 角色授权 / 租户 / 默认账号 |
| ② | wujies-platform/script/sql/update/ 下的 7 个脚本(见下) | 应用市场的表结构 |
| ③ | wujies-platform/script/sql/app_catalog_seed.sql | 应用目录种子(app_info / app_version / app_category)。不导市场里什么都没有 |
第 ② 步的清单与顺序(不是"按文件名排序",是这份固定清单):


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