开始使用
与上游 5.X 的差异
本平台的底座来自 RuoYi-Vue-Plus 5.X。框架自身的能力——权限、租户、数据权限、OSS、缓存、消息队列、工作流、SnailJob——以官方文档为准，本文只列平台在其上新增、替换或移除的部分。
官方文档已完整收录在本站：
一张表看清差异
| 领域 | 上游 5.X | 本平台 | 文档 |
|---|---|---|---|
| 应用市场 | 无 | 目录 + 安装实例 + 任务中心 + 上架端 | 应用市场 |
| 插件运行时 | 无 | 每应用独立类加载器 / Spring 子上下文 / 热加载 | 插件运行时 |
| 远程前端 | 无 | 后台按 appCode 加载 ESM 产物 | 远程应用 |
| 打包与签名 | 无 | 应用包、迁移脚本、signature.txt、enforce 校验 | 打包与上架 |
| 系统配置 | 参数管理（键值表） | 可视化「系统配置」页，按网站 / 安全 / 登录 / 邮箱 / 号码认证 / 短信 / 存储 / 客户端分栏 | 可视化配置 |
| 邮箱 | 配置在 yml | 数据库配置，运行期读取，改完即生效 | 邮件配置 |
| 号码认证登录 | 无 | 阿里云 / 腾讯云 / 华为云服务商配置 + phoneverify 登录策略 | 号码认证 |
| 登录验证码 | 固定实现 | 类型、干扰样式、字符集、尺寸全部可配 | 登录配置 |
| 消息中心 | 无 | 系统消息、站内信、消息设置、发送日志 | 消息中心 |
| 地区数据 | 无 | sys_area 地址树与开放接口 | 地址管理 |
| 待办 | 无 | 用户待办 sys_user_todo | 待办 |
| 客户端管理 | 有 sys_client 表 | 并入「系统配置 → 客户端」可视化维护 | 客户端 |
| 多端前端 | 仅 plus-ui | plus-ui + PC 用户端 + uni-app（H5 / App / 小程序） | 多端前端 |
| 定时任务 | 宿主 wujies-job 模块 | 执行器随应用走，宿主只提供 SnailJob 客户端 | 部署 · 任务调度 |
| 代码生成 / demo | 宿主模块 | 不在宿主；需要时作为独立应用或工具使用 | — |
新增的后端模块
| 模块 | 作用 |
|---|---|
wujies-modules/wujies-app-market | 应用目录、安装实例、插件运行时、包安全、任务中心 |
wujies-common/wujies-common-phone-verify | 号码认证服务商适配（阿里云 / 腾讯云 / 华为云） |
wujies-modules/wujies-system 扩展 | 系统配置、消息中心、地区、待办、号码认证配置 |
wujies-common/wujies-common-plugin-sdk | 插件扩展点契约（跨应用调用、平台能力） |
新增的数据库表
| 表 | 说明 |
|---|---|
app_info / app_version / app_category / app_plan | 应用目录（平台级，不按租户隔离） |
app_install / app_install_task | 安装实例与任务进度 |
app_version_menu / app_version_route | 版本菜单映射、插件路由清单 |
app_schema_history | 迁移脚本执行账本 |
app_route_index | 部署级路由墓碑，用于「应用未安装」提示 |
sys_phone_verify_config | 号码认证服务商配置 |
sys_message / sys_message_log / sys_message_settings | 消息中心 |
sys_area | 地区树 |
sys_user_todo | 用户待办 |
完整表结构见 平台初始化 SQL 对应的本仓库 script/sql/platform_init.sql。
被移除或替换的上游能力
wujies-job：定时任务执行器随应用进入插件（cn.wujies.<app>.task），宿主只保留wujies-common-job的 SnailJob 客户端配置。wujies-demo/wujies-generator：不再作为宿主模块；代码生成能力如需要，单独作为工具或应用提供。- 宿主
*-api模块：已全部移除。插件是自包含的，契约随插件走；跨插件调用通过平台 SPI 或事件。 - 邮件 yml 配置：保留 yml 作为兜底，但后台可视化配置优先，
MailConfig每次发送时从数据库读取。
升级上游时的注意事项
- 不要直接覆盖
wujies-system/wujies-admin，上游改动需要逐项合并。 - 插件相关表与菜单不要回退：
app_*表、sys_menu的 5/6/7 号根菜单、11500系统配置节点都是平台自研，上游脚本不会包含。 - 官方 SQL 不能直接用于本平台：唯一权威初始化脚本是
script/sql/platform_init.sql；上游ry_vue_5.X.sql已归档，仅作参考。 - 前端远程应用约定不能丢：
appCode、remote-apps/<appCode>/、?v=<version>、import map 垫片四者必须一致，详见远程应用。 - 先读 开发须知 中列出的不变量，再动插件加载、菜单同步、迁移账本这三块代码。