diff --git a/.crmeb/rules/事件规范.md b/.crmeb/rules/事件规范.md index 1aee00d9e..a72eb7872 100644 --- a/.crmeb/rules/事件规范.md +++ b/.crmeb/rules/事件规范.md @@ -83,7 +83,7 @@ event(OrderRefundRefuseListener::class, [$orderRefundInfo]); ## 三、事件注册分布 -v8.1.xu 采用三层架构,事件监听器分布在核心层和模块层: +CRMEB v8 采用三层架构,事件监听器分布在核心层和模块层: ### 3.1 核心层(app/event.php) @@ -358,7 +358,7 @@ event('UserExpChange', [$uid, $data['number'], $data['type'], $data['remark']]); --- -**版本**: v8.1.xu +**版本**: CRMEB v8 **创建日期**: 2026-06-01 **最后更新**: 2026-09-27(登记 McpToolsRegister 工具注册扩展事件并纳入安全事件清单;McpToolInterface 契约下沉至 crmeb\interfaces) **适用范围**: CRMEB v8 diff --git a/.crmeb/rules/架构规范.md b/.crmeb/rules/架构规范.md index b8705a047..f2cd4a683 100644 --- a/.crmeb/rules/架构规范.md +++ b/.crmeb/rules/架构规范.md @@ -110,7 +110,7 @@ event(OrderPaySuccess::class, [$orderId]); ## 登录密码 / 分支 - 后台:`admin` / `crmeb.com`;用户端:`13679281569` / `12345678` -- 分支:`v8.1.xu`(基于 v8.0 创建) +- 分支:`internal`(当前开发分支) ## 数据库连接环境 diff --git a/.crmeb/rules/架构规范详解.md b/.crmeb/rules/架构规范详解.md index 5f1f3d6e5..2e5b8c14d 100644 --- a/.crmeb/rules/架构规范详解.md +++ b/.crmeb/rules/架构规范详解.md @@ -1,8 +1,8 @@ --- alwaysApply: false -description: v8.1.xu 后端架构完整详解(按需加载)。目录结构树、消息通知架构、模块注册机制、第三方驱动后台管理规范、模块路由自动加载、系统配置菜单路径、前端经验记录、规则变更维护说明。常驻铁律见《架构规范.md》 +description: CRMEB v8 后端架构完整详解(按需加载)。目录结构树、消息通知架构、模块注册机制、第三方驱动后台管理规范、模块路由自动加载、系统配置菜单路径、前端经验记录、规则变更维护说明。常驻铁律见《架构规范.md》 --- -# v8.1.xu 后端架构规则(完整详解版) +# CRMEB v8 后端架构规则(完整详解版) > 本文件是**架构权威完整版**(`alwaysApply: false`,按需加载)。常驻精简版见 [架构规范.md](架构规范.md)(`alwaysApply: true`,只含高频铁律)。内容冲突时以本文件为准;涉及架构/扩展点/目录变更时**必须**同步更新本文件。 @@ -606,7 +606,7 @@ if (!$menu && $tab['menus_id']) { ... } ## 规则变更维护说明 -> **知识资产总入口见[.crmeb/AGENTS.md](../AGENTS.md)**(四类资产职责边界 + 索引清单 + 更新义务)。本文件是 **v8.1.xu 分支的架构权威参考**,实际代码发生以下类型变更时,**必须同步更新本文件及相关 rules 文件**: +> **知识资产总入口见[.crmeb/AGENTS.md](../AGENTS.md)**(四类资产职责边界 + 索引清单 + 更新义务)。本文件是 **CRMEB v8 的架构权威参考**,实际代码发生以下类型变更时,**必须同步更新本文件及相关 rules 文件**: | 触发场景 | 需更新的章节 | 联动更新 | 示例 | |---------|-------------|---------|------| diff --git a/.crmeb/skills/crmeb-dev/references/10-消息通知/notice.md b/.crmeb/skills/crmeb-dev/references/10-消息通知/notice.md index dc40141bc..a61f6c030 100644 --- a/.crmeb/skills/crmeb-dev/references/10-消息通知/notice.md +++ b/.crmeb/skills/crmeb-dev/references/10-消息通知/notice.md @@ -763,7 +763,7 @@ protected function getNoticeChannelDefinitions(): array --- -**版本**:v8.1.xu +**版本**:CRMEB v8 **最后更新**:2026-08-27 **适用范围**:CRMEB v8 分支 **相关规则**:[.crmeb/rules/架构规范详解.md](../../../../rules/架构规范详解.md)(消息通知架构章节) diff --git a/.crmeb/skills/crmeb-dev/references/11-业务领域/exceptions.md b/.crmeb/skills/crmeb-dev/references/11-业务领域/exceptions.md index 5199608e7..0c19cd8e1 100644 --- a/.crmeb/skills/crmeb-dev/references/11-业务领域/exceptions.md +++ b/.crmeb/skills/crmeb-dev/references/11-业务领域/exceptions.md @@ -276,7 +276,7 @@ throw new ApiStatusException(400, '业务错误', ['order_id' => 123]); 系统通过全局异常处理器统一捕获这些异常,并根据异常类型返回不同的HTTP响应。 -**异常处理配置位置**(v8.1.xu 现状): +**异常处理配置位置**(当前现状): - 三端 API 公共基类:`app/http/BaseApiExceptionHandle.php`(`abstract class BaseApiExceptionHandle extends Handle`,收口统一的异常日志格式与 JSON 渲染流程) - 各端子类:`app/api/ApiExceptionHandle.php`、`app/adminapi/AdminApiExceptionHandle.php`(继承 `BaseApiExceptionHandle`,各端仅覆写 `operatorId()`/`renderCustom()` 等差异扩展点) - 全局默认兜底:`app/ExceptionHandle.php` diff --git a/.crmeb/skills/crmeb-plugin-dev/references/mcp-tools.md b/.crmeb/skills/crmeb-plugin-dev/references/mcp-tools.md index 99065ca3c..adbfb28ad 100644 --- a/.crmeb/skills/crmeb-plugin-dev/references/mcp-tools.md +++ b/.crmeb/skills/crmeb-plugin-dev/references/mcp-tools.md @@ -166,7 +166,7 @@ return [ | 数据访问 | 读系统表走自有 DAO 只读;写数据只能调用对应核心 Service 公开方法,禁止直写系统表(红线见 [插件开发规范.md](../../../rules/插件开发规范.md) 第三节) | | 生命周期 | 插件禁用/卸载后 `event.php` 不再加载,工具自动失效,Installer 无需任何清理逻辑 | -## 已知限制(截至 v8.1.xu) +## 已知限制(截至 2026-09) | 限制 | 绕行方案 | | --- | --- |