# B. 数据库表结构速查

:::tip 概述
25 张业务表速查：表名/中文/域/租户级/关键列。定稿脚本 document/{mysql,postgresql,sqlserver,oracle,sqlite}/，MySQL 为规范基准。详细设计见 [4.9 数据库设计](../architecture/database-design)。
:::

## 全表统一审计列

```text
id（int 自增主键）create_user create_time update_user update_time del_flag
租户级表另有 tenant_id（0=平台级）
```

## 表清单

| 表 | 中文 | 域 | 租户级 | 关键列 |
|----|------|-----|--------|--------|
| goframe_user | 用户 | system | 是 | username/password/salt/mobile/email/avatar/dept_id/level_id/position_id/status/code |
| goframe_role | 角色 | system | 是 | code/data_scope(1-4) |
| goframe_role_menu | 角色菜单关联 | system | 否 | role_id/menu_id（无模块文件） |
| goframe_user_role | 用户角色关联 | system | 否 | user_id/role_id（无模块文件） |
| goframe_menu | 菜单 | system | 否 | parent_id/type(0菜单1权限)/permission/status/hide/sort |
| goframe_dept | 部门 | system | 是 | 树形 parent_id |
| goframe_level | 职级 | system | 是 | 导入导出 |
| goframe_position | 岗位 | system | 是 | |
| goframe_tenant | 租户 | system | 否 | code(T+ID)/status/expire_time/max_user_num |
| goframe_config | 系统配置 | data | 否 | code(uk) |
| goframe_config_item | 配置项 | data | 否 | config_id/value/options/type |
| goframe_param | 系统参数 | data | 否 | code(uk) |
| goframe_dict | 数据字典 | data | 否 | code(uk) |
| goframe_dict_item | 字典项 | data | 否 | dict_id/value |
| goframe_notice | 通知公告 | data | 是 | status |
| goframe_city | 行政区划 | data | 否 | pid/parent_code/area_code/level（78万+大表） |
| goframe_article | 文章 | content | 是 | category_id/cover/images/content(富文本)/status/click/sort |
| goframe_category | 文章分类 | content | 是 | 树形 parent_id |
| goframe_link | 友链 | content | 是 | 无 status |
| goframe_operation_log | 操作日志 | monitor | 否 | title/type/param/result/ip/location/consume_time/status |
| goframe_login_log | 登录日志 | monitor | 否 | log_type/ip/location/os/browser/status |
| goframe_job | 定时任务 | monitor | 否 | cron_expression/execute_policy/is_sync/url/params/status |
| goframe_job_log | 任务日志 | monitor | 否 | job_id/status/consume_time/exception_info |
| goframe_example | 案例演示 | tool | 否 | 七件套+导入导出演示 |
| goframe_file_template | 文件模板 | tool | 否 | code(uk) |

## 唯一索引（13 个）

```text
goframe_user        uk_tenant_username (tenant_id, username, del_flag)
goframe_user        uk_tenant_mobile   (tenant_id, mobile, del_flag)
goframe_user        uk_tenant_code     (tenant_id, code, del_flag)
goframe_role        uk_tenant_code     (tenant_id, code, del_flag)
goframe_dept        uk_tenant_name     (tenant_id, name, del_flag)
goframe_level       uk_tenant_name     (tenant_id, name, del_flag)
goframe_position    uk_tenant_name     (tenant_id, name, del_flag)
goframe_category    uk_tenant_name     (tenant_id, category_name, del_flag)
goframe_config      uk_code            (code)
goframe_dict        uk_code            (code)
goframe_param       uk_code            (code)
goframe_file_template uk_code          (code)
goframe_tenant      uk_code            (code)
```

要点：含 del_flag（软删行不占坑）；含 tenant_id 的索引，预检范围必须等于索引范围。

## 常见枚举定稿

```text
status             1-正常 2-禁用
article.status     0-正常 1-下架
menu.type          0-菜单 1-权限节点
job.status         0-未发布 1-运行中 2-暂停
job.execute_policy 1-立即执行 2-执行一次 3-放弃执行
job.is_sync        1-同步 0-异步
role.data_scope    1-全部 2-本部门及以下 3-本部门 4-仅本人
city.level         0-省份 1-城市 2-县区 3-街道 4-社区
login_log.log_type 1-登录 2-退出
del_flag           0-正常 1-已删除
operation_log.type consts/log_type.go（0-40/99，静态映射）
```

## 租户级表（9 张，hooks.tenantTables）

```text
user / role / dept / level / position / article / category / notice / link
新增租户级表必须同步登记 internal/model/hooks/hooks.go（生成器不自动维护）
```