docs(规则体系): 清理 v8.1.xu 废弃分支指称

This commit is contained in:
sugar1569 2026-09-27 16:51:46 +08:00
parent 3952b5caa8
commit 9e4d203425
6 changed files with 9 additions and 9 deletions

View File

@ -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

View File

@ -110,7 +110,7 @@ event(OrderPaySuccess::class, [$orderId]);
## 登录密码 / 分支
- 后台:`admin` / `crmeb.com`;用户端:`13679281569` / `12345678`
- 分支:`v8.1.xu`(基于 v8.0 创建)
- 分支:`internal`(当前开发分支)
## 数据库连接环境

View File

@ -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 文件**:
| 触发场景 | 需更新的章节 | 联动更新 | 示例 |
|---------|-------------|---------|------|

View File

@ -763,7 +763,7 @@ protected function getNoticeChannelDefinitions(): array
---
**版本**:v8.1.xu
**版本**:CRMEB v8
**最后更新**:2026-08-27
**适用范围**:CRMEB v8 分支
**相关规则**:[.crmeb/rules/架构规范详解.md](../../../../rules/架构规范详解.md)(消息通知架构章节)

View File

@ -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`

View File

@ -166,7 +166,7 @@ return [
| 数据访问 | 读系统表走自有 DAO 只读;写数据只能调用对应核心 Service 公开方法,禁止直写系统表(红线见 [插件开发规范.md](../../../rules/插件开发规范.md) 第三节) |
| 生命周期 | 插件禁用/卸载后 `event.php` 不再加载,工具自动失效,Installer 无需任何清理逻辑 |
## 已知限制(截至 v8.1.xu)
## 已知限制(截至 2026-09)
| 限制 | 绕行方案 |
| --- | --- |