一体化模块架构 ​

Dux PHP Admin 采用 一体化模块架构：后端接口、权限与前端页面放在同一模块体系里组织。它保留传统全栈的直观体验，同时又具备前后端分离的规范化优势。

为什么要这样做 ​

• 像传统全栈一样好写：页面就放在模块里，结构直观。
• 像前后端分离一样规范：接口、权限、菜单都有统一规则。
• 改完直接生效：无需为每个页面单独构建，开发效率更高。

结构关系（类比） ​

可以理解为 iOS + App 或 微信 + 小程序 的关系：

• 后端是基座：负责统一的路由、权限、接口、菜单、配置。
• 页面是模块：按需加载，放在模块里即可使用。

模块里都有什么 ​

app/模块名/
  App.php        # 模块入口
  app.json       # 菜单与模块信息
  Admin/         # 后台 API + 页面
  Models/        # 模型
  Api/           # 对外 API（签名）
  Service/       # 业务服务

这就是“一体化模块架构”的核心：后端与前端统一放在模块中管理。

进一步阅读 ​

• 前端基座机制：/guide/frontend-base
• 模块开发实战：/guide/module-workflow