# K. 术语表

:::tip 说明
项目核心术语速查，按主题排列。首次出现的专业词都能在这里找到一句话解释。
:::

## 架构

| 术语 | 解释 |
|---|---|
| 四件套 | 一个模块的四个文件：dto / repository / service / handler |
| RouteSpec | 路由声明表：一条声明同时定义注册/权限/日志/公开 |
| 路由元数据 | RouteSpec 注册时写入进程内表，authz/日志/OpenAPI 同源消费 |
| 反射元数据驱动 | router.Bind 按方法签名反射注册路由的机制 |
| ModuleSpec | 声明式 CRUD 基座：差异进声明字段与钩子 |
| 逃生舱 | 写不进声明的复杂逻辑手写方法的合法通道 |
| WireCheck | 启动期探测中间件接线完整性（缺失告警降级） |
| fail-fast | 配置非法拒绝启动的设计原则 |

## 数据

| 术语 | 解释 |
|---|---|
| 软删除 | UPDATE del_flag=1；物理删除被钩子拦截 |
| 审计盖章 | Create/Update 钩子自动补齐审计字段 |
| 租户白名单 | 9 张含 tenant_id 的租户级表清单（hooks.tenantTables） |
| 数据权限 | 行级过滤（全部/本部门及以下/本部门/仅本人） |
| Scope | repository.Ctx 在 SQL 构建前注入的查询条件 |
| WithTrans | 事务入口，回调 ctx 携带事务连接 |
| WithPhysicalDelete | 显式放行物理删除的 ctx 开关 |

## 认证安全

| 术语 | 解释 |
|---|---|
| 双令牌 | access_token（短）+ refresh_token（长） |
| jti | 令牌唯一标识，黑名单与在线登记的键 |
| 黑名单 | 缓存登记失效令牌，TTL 取剩余有效期 |
| 通配码 | `*:*:*`，超管全通过 |
| 受信代理 | api.proxyIps 列表内来源才信任转发头 |

## 文件

| 术语 | 解释 |
|---|---|
| 两段式上传 | 先 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)