签入版本
This commit is contained in:
小蚂蚁云
@@ -1,72 +1,64 @@
|
||||
# J. 术语表
|
||||
# K. 术语表
|
||||
|
||||
## 后端术语
|
||||
:::tip 说明
|
||||
项目核心术语速查，按主题排列。首次出现的专业词都能在这里找到一句话解释。
|
||||
:::
|
||||
|
||||
| 术语 | 全称 | 说明 |
|
||||
|------|------|------|
|
||||
| JWT | JSON Web Token | 无状态认证令牌，用于接口认证 |
|
||||
| RBAC | Role-Based Access Control | 基于角色的访问控制 |
|
||||
| CORS | Cross-Origin Resource Sharing | 跨域资源共享 |
|
||||
| ORM | Object-Relational Mapping | 对象关系映射，数据库操作抽象层 |
|
||||
| CRUD | Create/Read/Update/Delete | 增删改查 |
|
||||
| API | Application Programming Interface | 应用程序编程接口 |
|
||||
| bcrypt | - | 密码哈希算法，内置盐值 |
|
||||
| OPcache | - | PHP 字节码缓存扩展 |
|
||||
| Redis | - | 内存数据库，用于缓存 |
|
||||
| Nginx | - | Web 服务器 / 反向代理 |
|
||||
| Composer | - | PHP 依赖管理工具 |
|
||||
| PSR | PHP Standards Recommendation | PHP 标准推荐 |
|
||||
| FPM | FastCGI Process Manager | PHP 进程管理器 |
|
||||
| DNF | Dandified Yum | Rocky Linux / CentOS 包管理器 |
|
||||
| PECL | PHP Extension Community Library | PHP 扩展安装工具 |
|
||||
## 架构
|
||||
|
||||
## 前端术语
|
||||
| 术语 | 解释 |
|
||||
|---|---|
|
||||
| 四件套 | 一个模块的四个文件：dto / repository / service / handler |
|
||||
| RouteSpec | 路由声明表：一条声明同时定义注册/权限/日志/公开 |
|
||||
| 路由元数据 | RouteSpec 注册时写入进程内表，authz/日志/OpenAPI 同源消费 |
|
||||
| 反射元数据驱动 | router.Bind 按方法签名反射注册路由的机制 |
|
||||
| ModuleSpec | 声明式 CRUD 基座：差异进声明字段与钩子 |
|
||||
| 逃生舱 | 写不进声明的复杂逻辑手写方法的合法通道 |
|
||||
| WireCheck | 启动期探测中间件接线完整性（缺失告警降级） |
|
||||
| fail-fast | 配置非法拒绝启动的设计原则 |
|
||||
|
||||
| 术语 | 全称 | 说明 |
|
||||
|------|------|------|
|
||||
| Vue | - | 渐进式 JavaScript 框架 |
|
||||
| TypeScript | - | JavaScript 超集，类型安全 |
|
||||
| Vite | - | 前端构建工具 |
|
||||
| Pinia | - | Vue 3 官方状态管理库 |
|
||||
| ElementPlus | - | Vue 3 UI 组件库 |
|
||||
| Axios | - | HTTP 请求库 |
|
||||
| TailwindCSS | - | 原子化 CSS 框架 |
|
||||
| TinyMce | - | 富文本编辑器 |
|
||||
| ECharts | - | 数据可视化图表库 |
|
||||
| pnpm | - | 高性能 Node.js 包管理器 |
|
||||
| ESLint | - | JavaScript/TypeScript 代码检查工具 |
|
||||
| Prettier | - | 代码格式化工具 |
|
||||
| keep-alive | - | Vue 组件缓存机制 |
|
||||
## 数据
|
||||
|
||||
## 业务术语
|
||||
| 术语 | 解释 |
|
||||
|---|---|
|
||||
| 软删除 | UPDATE del_flag=1；物理删除被钩子拦截 |
|
||||
| 审计盖章 | Create/Update 钩子自动补齐审计字段 |
|
||||
| 租户白名单 | 9 张含 tenant_id 的租户级表清单（hooks.tenantTables） |
|
||||
| 数据权限 | 行级过滤（全部/本部门及以下/本部门/仅本人） |
|
||||
| Scope | repository.Ctx 在 SQL 构建前注入的查询条件 |
|
||||
| WithTrans | 事务入口，回调 ctx 携带事务连接 |
|
||||
| WithPhysicalDelete | 显式放行物理删除的 ctx 开关 |
|
||||
|
||||
| 术语 | 说明 |
|
||||
|------|------|
|
||||
| 软删除 | 通过 `is_delete` 字段标记删除，不物理删除 |
|
||||
| 租户隔离 | 通过 `tenant_id` 字段实现多租户数据隔离 |
|
||||
| 数据权限 | 基于角色的 data_scope 控制数据可见范围 |
|
||||
| access_token | 访问令牌，短期有效（默认 2 小时） |
|
||||
| refresh_token | 刷新令牌，长期有效（默认 7 天） |
|
||||
| 驼峰命名 | camelCase，如 `createTime` |
|
||||
| 下划线命名 | snake_case，如 `create_time` |
|
||||
| RBAC | 基于角色的访问控制：用户 → 角色 → 菜单/权限 |
|
||||
| 超级管理员 | uid=1 的用户，跳过所有权限校验 |
|
||||
| 租户管理员 | tenant_id=0 的用户，不受租户隔离限制 |
|
||||
| 声明式 CRUD | 通过属性配置定义行为，无需编写通用代码 |
|
||||
| 生命周期钩子 | beforeAdd/afterAdd 等，用于注入定制逻辑 |
|
||||
## 认证安全
|
||||
|
||||
## 框架术语
|
||||
| 术语 | 解释 |
|
||||
|---|---|
|
||||
| 双令牌 | access_token（短）+ refresh_token（长） |
|
||||
| jti | 令牌唯一标识，黑名单与在线登记的键 |
|
||||
| 黑名单 | 缓存登记失效令牌，TTL 取剩余有效期 |
|
||||
| 通配码 | `*:*:*`，超管全通过 |
|
||||
| 受信代理 | api.proxyIps 列表内来源才信任转发头 |
|
||||
|
||||
| 术语 | 说明 |
|
||||
|------|------|
|
||||
| BaseLogic | 业务逻辑基类，提供声明式 CRUD 能力 |
|
||||
| BaseTenantLogic | 租户逻辑基类，继承 BaseLogic，自动租户隔离 |
|
||||
| BaseController | 控制器基类，提供统一响应和通用 CRUD 方法 |
|
||||
| BaseModel | 模型基类，提供软删除和审计字段 |
|
||||
| Result | 统一响应类，构造标准 JSON 响应 |
|
||||
| ExceptionHandle | 异常处理类，统一捕获异常并返回 JSON |
|
||||
| AttributeService | 注解服务，通过反射读取控制器方法注解 |
|
||||
| DictService | 字典服务，提供字典项读取和缓存 |
|
||||
| ParamService | 参数服务，提供系统参数读取和缓存 |
|
||||
| PasswordService | 密码服务，bcrypt 双重加盐加密 |
|
||||
| JwtService | JWT 服务，签发/刷新/解析令牌 |
|
||||
## 文件
|
||||
|
||||
| 术语 | 解释 |
|
||||
|---|---|
|
||||
| 两段式上传 | 先 temp 后转正；未保存不落正式目录 |
|
||||
| saveTransform | 写侧转正（temp → 模块目录） |
|
||||
| readTransform | 读侧补访问域名 |
|
||||
| 占位符契约 | 富文本正文存 [IMG_URL]/{相对路径} |
|
||||
| ExpandContentFields | 占位符还原的唯一出口 |
|
||||
|
||||
## 前端
|
||||
|
||||
| 术语 | 解释 |
|
||||
|---|---|
|
||||
| 动态路由 | 登录后按菜单 API 生成注入的路由表 |
|
||||
| 信封解包 | http 拦截器把统一响应拆成 data/错误 |
|
||||
| v-perm / v-perms | 按权限码移除元素的指令（任一/全部） |
|
||||
| 设计 token | 主题变量（颜色/间距），换主题不改业务样式 |
|
||||
|
||||
## 相关
|
||||
|
||||
- [1.1 项目介绍](/zh/introduction.html)
|
||||
- [4.1 整体架构概览](/zh/architecture/overview.html)
|
||||
|
||||
Reference in New Issue
Block a user