mirror of
https://github.com/crmeb/CRMEB.git
synced 2026-10-28 13:31:04 +00:00
docs(规则体系): 清理 v8.1.xu 废弃分支指称
This commit is contained in:
parent
3952b5caa8
commit
9e4d203425
@ -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
|
||||
|
||||
@ -110,7 +110,7 @@ event(OrderPaySuccess::class, [$orderId]);
|
||||
## 登录密码 / 分支
|
||||
|
||||
- 后台:`admin` / `crmeb.com`;用户端:`13679281569` / `12345678`
|
||||
- 分支:`v8.1.xu`(基于 v8.0 创建)
|
||||
- 分支:`internal`(当前开发分支)
|
||||
|
||||
## 数据库连接环境
|
||||
|
||||
|
||||
@ -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 文件**:
|
||||
|
||||
| 触发场景 | 需更新的章节 | 联动更新 | 示例 |
|
||||
|---------|-------------|---------|------|
|
||||
|
||||
@ -763,7 +763,7 @@ protected function getNoticeChannelDefinitions(): array
|
||||
|
||||
---
|
||||
|
||||
**版本**:v8.1.xu
|
||||
**版本**:CRMEB v8
|
||||
**最后更新**:2026-08-27
|
||||
**适用范围**:CRMEB v8 分支
|
||||
**相关规则**:[.crmeb/rules/架构规范详解.md](../../../../rules/架构规范详解.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`
|
||||
|
||||
@ -166,7 +166,7 @@ return [
|
||||
| 数据访问 | 读系统表走自有 DAO 只读;写数据只能调用对应核心 Service 公开方法,禁止直写系统表(红线见 [插件开发规范.md](../../../rules/插件开发规范.md) 第三节) |
|
||||
| 生命周期 | 插件禁用/卸载后 `event.php` 不再加载,工具自动失效,Installer 无需任何清理逻辑 |
|
||||
|
||||
## 已知限制(截至 v8.1.xu)
|
||||
## 已知限制(截至 2026-09)
|
||||
|
||||
| 限制 | 绕行方案 |
|
||||
| --- | --- |
|
||||
|
||||
Loading…
x
Reference in New Issue
Block a user