CRMEB Pro V4 二开助手

解决什么问题

在 CRMEB 多门店 Pro V4（ThinkPHP 8.0 + Swoole 4）上做二次开发，最常见的翻车方式有：改了 crmeb/ 或 vendor/ 下的代码，官方升级一来全部覆盖；业务逻辑堆在 Controller 里，Services/Dao 层形同虚设；发券、分账、通知这类跨模块副作用直接写进主流程，牵一发动全身；门店查询忘了加 store_id 作用域，A 店能看到 B 店的订单。这个技能把上述坑逐一固化成规则与模板。

技能如何工作

核心是六条动手前必读的原则：只改 app/ 目录、严格分层（Controller 收参校验 → Services 业务 → Dao 查询 → Model 结构）、用 event() + 监听器解耦副作用、配置走 sys_config('key')、门店查询强制 store_id 作用域、Swoole 模式下改码后 php think clear 并重启守护进程。

配套 references/ 下的 8 份文档按任务选读：新增后端模块走 7 步链路（Model→Dao→Services→Validate→Controller→Route→权限），直接复制代码模板再替换命名与字段；多门店需求先看 04-multistore.md 的数据隔离与扩展任务清单，门店端代码放 controller/api/store 与 route/api.php；后台 Vue 页面与 uni-app 移动端各有对应章节；联调查接口约定，部署查安装手册，报错按现象查 FAQ。

适用边界

模板中的类名、字段、表前缀需以目标项目的 .env、app/event.php 为准，涉及数据库变更必须给出迁移 SQL。官方文档站正文为 JS 动态渲染，链接仅供人工核实细节，不能替代对目标项目的实际确认。