# J. 术语表

:::tip 概述
项目核心术语速查（按字母/主题排序）。首次出现的概念均可在对应章节深入。
:::

## A-D

| 术语 | 释义 |
|------|------|
| access_token | 访问令牌（JWT HS256，2h），接口认证凭证，Header Bearer 携带 |
| ApplyDataScope | 行级数据权限共享工厂（logic/data_scope.go），spec 声明即接线 |
| BatchGenerate | 生成器批量生成（逐表独立成败+统计） |
| BodyUnmarshaler | 请求体自定义解析逃生舱接口（跳过默认 Parse） |
| BuildTree | 泛型平铺转树（base.go） |
| CheckUnique | 唯一性 UX 快速预检（TOCTOU；真值靠 uk_* 索引） |
| ChunkQuery | 分块遍历查询（导出防 OOM，默认 500/页） |
| CleanTemp | 上传临时目录清理（每日 03:30，tempExpireDays 控制） |
| del_flag | 软删除标志（0-正常 1-已删除；删除接口全部软删） |
| {field}Text | 枚举字段显示名（字典驱动填充，如 statusText） |
| DomainUrl | file.domainUrl 文件访问域名（空=相对 /upload/） |

## E-J

| 术语 | 释义 |
|------|------|
| execute_policy | 任务执行策略（1 立即执行/2 执行一次/3 放弃执行） |
| Filter | ModuleSpec 复杂条件逃生舱 |
| genDomainMap | 生成器域归属映射（user→system、默认 tool） |
| GF_ | 环境变量覆盖配置前缀 |
| golden（黄金样本） | hack/golden 接口响应回归基线 |
| gmeta | gf 框架元标签；本项目扩展解析 method/path/permission/log 等 |
| gvalid | gf 参数校验（结构体 v 标签） |
| hooks（模型钩子） | internal/model/hooks：审计盖章/软删改写/租户隔离 |
| IdentityLoader | 身份加载器（中间件 wire 接线，= logic.LoadIdentity） |
| is_sync | 任务执行方式（1 同步/0 异步） |

## K-R

| 术语 | 释义 |
|------|------|
| KeywordFields | req.keyword 多列 OR 筛选（基座保留能力，模块默认不声明） |
| LikeFields | 逐列模糊筛选声明（值取 req 同名驼峰字段） |
| LogClean | 内置日志清理任务（每日 02:30，三张日志表物理清理） |
| LogSink | 操作日志落库函数（operation_log 模块 init 注册） |
| ModuleSpec | 泛型声明式 CRUD 基座（[Item, LItem, DRes] 三类型参数） |
| MergeOld | 全量覆盖辅助（把 data 缺失键用库中旧值补齐） |
| OnlinUser | 在线用户（无表；Redis zset+info；双令牌强退） |
| PageData[T] | 分页泛型壳（records/total/size/current/pages） |
| publicPaths | 免登录白名单（middleware/public.go 精确匹配） |
| refresh_token | 刷新令牌（7d；仅 /api/oauth2/token；轮换即拉黑旧值） |

## S-Z

| 术语 | 释义 |
|------|------|
| SaveTemp / SaveFromTemp | 上传两段式（临时落盘/表单保存转正） |
| serializeMaps | 模块头部字典映射声明（{字段: 字典编码}） |
| skipTables | 生成器整表跳过清单（role_menu/user_role） |
| spec | ModuleSpec 声明实例（如 userSpec/jobSpec） |
| tenantTables | 租户级表清单（hooks.tenantTables，9 张，新表须手工登记） |
| ToData | spec 的 req→map 转换（新增/修改共用，全量表单语义） |
| uk_* | 唯一索引命名规范（含 del_flag；并发唯一性最终保证） |
| [IMG_URL] | 富文本持久化契约（存库占位符；ExpandContentFields 唯一还原） |
| wire.go | 中间件依赖接线（三函数变量：Identity/Tenant/LogSink） |
| 超管 | ROLE_SUPER_ADMIN 角色；绕过权限；前端通配 *:*:* |
| 数据权限 | role.data_scope 四档行级过滤（仅 Page/List/导出） |
| 两段式 | 上传协议（temp 中转 → 表单保存转正到业务目录） |
| 受信代理 | api.proxyIps（精确 IP/CIDR）；信任其 XFF/X-Real-IP |