目录结构总览

只列属于框架的目录。am-serve/plugin/* 与 am_frontends/* 下的具体目录都是插件，不是框架本体。

atrman/
├── am-serve/                     # 后端基座（Webman）
│   ├── app/
│   │   ├── basic/                #   扩展内核与基类
│   │   │                         #     BaseController / BaseModel / BaseValidate / BasePlugin
│   │   │                         #     EventRegistry / ServiceRegistry / AdapterRegistry
│   │   │                         #     MiddlewareRegistry / TaskRegistry / ChannelAuthRegistry
│   │   │                         #     PluginRegistrar / MemberAuth
│   │   ├── controller/           #   控制器（system / notify / plugin 等）
│   │   ├── service/              #   服务（PluginManager / IdentityService / TicketService / NotifyService / BackupService 等）
│   │   ├── model/                #   数据模型
│   │   ├── middleware/           #   中间件（鉴权 / 操作日志 / 插件织入）
│   │   ├── bootstrap/            #   PluginBootstrapper（每进程调用插件 boot()）
│   │   ├── process/              #   自定义进程（HTTP / Monitor / PluginTask）
│   │   ├── queue/                #   队列消费者
│   │   └── utils/ validate/ cache/ exception/
│   ├── config/                   #   配置（database / route / plugin_extend.php 等）
│   ├── install/                  #   install.sql / seed.sql / 安装脚本
│   ├── stub/plugin/              #   后端骨架模板真源（基座"创建插件"从这里生成）
│   └── plugin/                   #   ⚠ 插件目录（各插件独立存在）
│
├── am-web/                       # 基座管理前端（Vue3 + qiankun 主应用）
│
├── am_plugin/                    # 插件前端开发框架真源（装配到各插件工作区）
│
├── am_frontends/                 # 前端插件工作区装配根目录
│   └── create-plugin.mjs         #   ⭐ 插件前端装配脚本（框架提供的开发工具）
│
└── 文档                            # 开发文档与规范

框架 vs 插件

位置	归属	说明
am-serve/app、config、stub	框架	基座内核与系统能力
am-serve/plugin/{name}	插件	后端插件（清单/生命周期/控制器/视图）
am-web、am_plugin	框架	管理前端与插件前端框架
am_frontends/{name}	插件	前端插件工作区（源码，构建产物回写插件目录）

一个插件的骨架

am-serve/plugin/{name}/
├── Plugin.php          # 生命周期 Hook（继承 BasePlugin）
├── manifest.json       # 清单：入口、版本、依赖、Bridge scope 等
├── install.sql         # 建表（表名以 {name}_ 前缀）
├── app/                # controller / model / service / validate / view
├── config/             # app.php / route.php / event.php 等
└── public/             # 前端构建产物 + logo + widget