用途:为 Shopware 的 DAL 实体搭建独立的后台管理模块,覆盖列表页、详情/创建页、ACL 权限、搜索、筛选、行内编辑与 i18n 片段。
主要能力:按优先级组织规则——模块设置(注册、文件结构、命名约定)、页面(列表页与详情/创建页模式)、ACL 与搜索(权限映射、搜索配置)、片段与筛选(i18n 结构、筛选设置)。
使用方式:调用时需提供实体名(如 webhook)、列表与详情要展示的字段(或从 EntityDefinition PHP 类自动读取)、模块前缀(默认 frosh-tools-<entity>)。随后读取 references/ 目录下的参考文件并按其中模式生成全部文件。后台源码根目录为 src/Resources/app/administration/src/。
命名约定:模块名 frosh-tools-<entity>(连字符);路由前缀 frosh.tools.<entity>(点号,由模块名替换连字符得到);ACL 键 frosh_tools_<entity>(下划线)。
文件结构:module/<module-name>/ 下含 index.js(模块注册、搜索类型、懒加载组件)、default-search-configuration.js(搜索排序配置)、acl/index.js(ACL 权限映射)、snippet/en-GB.json 与 de-DE.json、page/<module-name>-list/ 与 page/<module-name>-detail/(各含 index.js 与 template.html.twig)。另需在 main.js 中添加 import './module/<module-name>';。
适用场景:新建实体后台模块、为实体添加列表/详情/创建页、配置 ACL、为列表添加搜索筛选与行内编辑、为新模块搭建 i18n 片段。
限制:资料未提供具体版本兼容性、依赖要求、收费或效果说明,暂未提供。