签入版本

RXThinkCMF_Laravel13_NaiveVue/zh/appendix/glossary.md

@@ -4,19 +4,20 @@
 
 | 术语 | 全称 | 说明 |
 |------|------|------|
-| JWT | JSON Web Token | 无状态认证令牌，用于接口认证 |
+| JWT | JSON Web Token | 无状态认证令牌，用于接口认证（本项目 Redis 有状态双令牌） |
 | RBAC | Role-Based Access Control | 基于角色的访问控制 |
 | CORS | Cross-Origin Resource Sharing | 跨域资源共享 |
-| ORM | Object-Relational Mapping | 对象关系映射，数据库操作抽象层 |
+| ORM | Object-Relational Mapping | 对象关系映射（本项目使用 Laravel Eloquent） |
 | CRUD | Create/Read/Update/Delete | 增删改查 |
 | API | Application Programming Interface | 应用程序编程接口 |
 | bcrypt | - | 密码哈希算法，内置盐值 |
 | OPcache | - | PHP 字节码缓存扩展 |
-| Redis | - | 内存数据库，用于缓存 |
+| Redis | - | 内存数据库，用于缓存/会话/队列/JWT 状态 |
 | Nginx | - | Web 服务器 / 反向代理 |
 | Composer | - | PHP 依赖管理工具 |
 | PSR | PHP Standards Recommendation | PHP 标准推荐 |
 | FPM | FastCGI Process Manager | PHP 进程管理器 |
+| Artisan | - | Laravel 命令行工具（`php artisan ...`） |
 | DNF | Dandified Yum | Rocky Linux / CentOS 包管理器 |
 | PECL | PHP Extension Community Library | PHP 扩展安装工具 |
 
@@ -44,14 +45,14 @@
 |------|------|
 | 软删除 | 通过 `is_delete` 字段标记删除，不物理删除 |
 | 租户隔离 | 通过 `tenant_id` 字段实现多租户数据隔离 |
-| 数据权限 | 基于角色的 data_scope 控制数据可见范围 |
-| access_token | 访问令牌，短期有效（默认 2 小时） |
-| refresh_token | 刷新令牌，长期有效（默认 7 天） |
+| 数据权限 | `HasDataScope` 按角色数据范围过滤（当前角色不存储范围字段，默认全部数据） |
+| access_token | 访问令牌，短期有效（`JWT_ACCESS_TTL` 默认 7200 秒） |
+| refresh_token | 刷新令牌，长期有效（`JWT_REFRESH_TTL` 默认 604800 秒） |
 | 驼峰命名 | camelCase，如 `createTime` |
 | 下划线命名 | snake_case，如 `create_time` |
 | RBAC | 基于角色的访问控制：用户 → 角色 → 菜单/权限 |
-| 超级管理员 | uid=1 的用户，跳过所有权限校验 |
-| 租户管理员 | tenant_id=0 的用户，不受租户隔离限制 |
+| 超级管理员 | uid=1 的用户，跳过权限与租户校验 |
+| 平台用户 | `tenant_id = 0` 的用户，不属于任何租户 |
 | 声明式 CRUD | 通过属性配置定义行为，无需编写通用代码 |
 | 生命周期钩子 | beforeAdd/afterAdd 等，用于注入定制逻辑 |
 
@@ -59,14 +60,16 @@
 
 | 术语 | 说明 |
 |------|------|
-| BaseLogic | 业务逻辑基类，提供声明式 CRUD 能力 |
-| BaseTenantLogic | 租户逻辑基类，继承 BaseLogic，自动租户隔离 |
-| BaseController | 控制器基类，提供统一响应和通用 CRUD 方法 |
-| BaseModel | 模型基类，提供软删除和审计字段 |
-| Result | 统一响应类，构造标准 JSON 响应 |
-| ExceptionHandle | 异常处理类，统一捕获异常并返回 JSON |
-| AttributeService | 注解服务，通过反射读取控制器方法注解 |
-| DictService | 字典服务，提供字典项读取和缓存 |
-| ParamService | 参数服务，提供系统参数读取和缓存 |
-| PasswordService | 密码服务，bcrypt 双重加盐加密 |
-| JwtService | JWT 服务，签发/刷新/解析令牌 |
+| BaseService | 业务服务基类，声明式 CRUD 能力（6 个 Trait 组合） |
+| BaseTenantService | 租户服务基类，继承 BaseService，自动租户隔离 |
+| Controller 基类 | `App\Http\Controllers\Controller`，提供 success/fail/paginate/_page 等通用方法 |
+| Eloquent Model | 模型基类，配合 `SoftDeletesByFlag`（软删除）与 `HasAuditColumns`（审计字段）Trait |
+| Result | 统一响应类（`app/Support/Result.php`），构造标准 JSON 响应 |
+| Handler | 异常处理类（`app/Exceptions/Handler.php`），统一捕获异常并返回 JSON |
+| BizException | 业务异常，`code` 携带业务错误码，转为失败响应 |
+| 权限/日志注解 | `#[Permission]` / `#[OperationLog]` / `#[DemoAllow]`（`app/Attributes/`），由中间件反射读取 |
+| DictCacheService | 字典服务，提供字典项读取和两级缓存 |
+| ParamService | 参数服务，提供系统参数读取（请求级缓存） |
+| PasswordService | 密码服务，加盐哈希加密与校验 |
+| JwtService | JWT 服务，签发/刷新/解析令牌 |
+| FormRequest | Laravel 表单请求验证器（`app/Http/Requests/`），本项目基类 `BaseRequest` |