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 |
主题变量（颜色/间距），换主题不改业务样式 |
相关
