Menü
MallBase ThinkPHP 框架边界规则；涉及 mall_base 底层、业务服务放置或跨层职责判断时使用。
Mit Codex oder Claude installieren Kopieren Sie diesen Prompt, fügen Sie ihn in Codex, Claude oder einen anderen Assistant ein und lassen Sie die Skill-Seite prüfen und installieren.
Basierend auf der SOC-Berufsklassifikation
MallBase 扩展槽边界规范；涉及会员、积分、分销、余额、优惠等权益扩展接入订单、商品编辑或 UniApp 展示时使用。
MallBase schema 真相源与幂等升级 SQL 规则；升级 SQL 仅在用户明确要求已有库升级时使用。
MallBase ThinkPHP 后端规则索引；仅在需要浏览或选择后端规则、且无法确定具体 ThinkPHP skill 时使用。
MallBase 已有库升级 SQL 边界规则；只有用户明确要求考虑已有库升级、测试服/线上升级或 upgrade SQL 时使用。
MallBase ThinkPHP 模型字段访问器与素材回显规则；在 Model 字段读写、访问器、修改器、with 关联、素材 ID 回显或 Service 字段组装优化时使用。
MallBase preview 演示站分支边界规则；涉及 preview 分支、演示站专用功能、main 与 preview 合并、反向合并、演示站部署或公开演示能力修改时使用。
| name | mall-base-boundary |
| description | MallBase ThinkPHP 框架边界规则；涉及 mall_base 底层、业务服务放置或跨层职责判断时使用。 |
涉及 backend/mall_base/ 目录的任何新增或修改。
mall_base/ 是项目的框架底层，提供通用基础设施，不包含任何业务逻辑。
业务逻辑统一放在 backend/app/ 层。
| 目录 | 定位 | 允许放什么 | 禁止放什么 |
|---|---|---|---|
mall_base/base/ | 基类 | BaseDriver、BaseModel、BaseException 等抽象基类 | 业务服务、具体实现 |
mall_base/drivers/ | 驱动 | 通过 DriverManager 管理的驱动实现（SMS、Upload 等） | 业务编排、频控、缓存策略 |
mall_base/exception/ | 异常 | 统一异常类（BusinessException、SmsException 等） | 业务逻辑 |
mall_base/enum/ | 枚举 | 框架级枚举与常量 | 业务场景枚举 |
| 组件类型 | 正确位置 | 示例 |
|---|---|---|
| 业务服务 | app/service/ | SmsService、UploadService |
| 业务编排 | app/service/client/ 或 app/service/admin/ | SmsAuthService、UserService |
| 频控/缓存策略 | app/service/<domain>/ | SmsRateLimiter、SmsCache |
| 控制器 | app/controller/ | UserController |
| 场景常量 | app/service/<domain>/ 或 app/enum/ | SmsScene |
新增驱动时遵循 Upload 驱动的已有模式：
mall_base/drivers/<type>/ 下新建 Base<Type>Driver（继承 BaseDriver）和具体驱动类。app/AppService.php 的 register() 中注册驱动并设置默认值。app/provider.php 中通过 DriverManager::driver() 获取实例注入业务服务。bool + getError()，不做业务判断。app/service/）负责编排逻辑、频控、缓存、异常转换。mall_base/ 下新建业务模块目录（如 mall_base/sms/mall_base/order/mall_base/ 中编写业务编排、频控策略、缓存策略等业务逻辑。mall_base/ 中定义 Adapter/Interface 做驱动选择。mall_base/exception/。app/。mall_base/exception/ 下？app/service/ 下？SMS 子系统曾在 mall_base/sms/ 下放置了 SmsService、SmsRateLimiter、SmsAdapter 等业务组件，同时与 mall_base/drivers/sms/ 的已有驱动形成重复架构。此 skill 确保不再出现类似的分层混乱。