# J. 术语表

## 后端术语

| 术语 | 全称 | 说明 |
|------|------|------|
| JWT | JSON Web Token | 无状态认证令牌，用于接口认证（本项目 Redis 有状态双令牌） |
| RBAC | Role-Based Access Control | 基于角色的访问控制 |
| CORS | Cross-Origin Resource Sharing | 跨域资源共享 |
| ORM | Object-Relational Mapping | 对象关系映射（本项目使用 Laravel Eloquent） |
| CRUD | Create/Read/Update/Delete | 增删改查 |
| API | Application Programming Interface | 应用程序编程接口 |
| bcrypt | - | 密码哈希算法，内置盐值 |
| OPcache | - | PHP 字节码缓存扩展 |
| 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 扩展安装工具 |

## 前端术语

| 术语 | 全称 | 说明 |
|------|------|------|
| Vue | - | 渐进式 JavaScript 框架 |
| TypeScript | - | JavaScript 超集，类型安全 |
| Vite | - | 前端构建工具 |
| Pinia | - | Vue 3 官方状态管理库 |
| NaiveUI | - | Vue 3 UI 组件库 |
| Axios | - | HTTP 请求库 |
| TailwindCSS | - | 原子化 CSS 框架 |
| TinyMce | - | 富文本编辑器 |
| ECharts | - | 数据可视化图表库 |
| pnpm | - | 高性能 Node.js 包管理器 |
| ESLint | - | JavaScript/TypeScript 代码检查工具 |
| Prettier | - | 代码格式化工具 |
| keep-alive | - | Vue 组件缓存机制 |

## 业务术语

| 术语 | 说明 |
|------|------|
| 软删除 | 通过 `is_delete` 字段标记删除，不物理删除 |
| 租户隔离 | 通过 `tenant_id` 字段实现多租户数据隔离 |
| 数据权限 | `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` 的用户，不属于任何租户 |
| 声明式 CRUD | 通过属性配置定义行为，无需编写通用代码 |
| 生命周期钩子 | beforeAdd/afterAdd 等，用于注入定制逻辑 |

## 框架术语

| 术语 | 说明 |
|------|------|
| 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` |