BadouCMS 表结构说明（框架表 + CMS 表）

适用范围：本文只覆盖 框架表（19 张） 和 CMS 表（16 张），以及 CMS 动态生成的 DIY 表。
不包含插件/模块表（shop_*、ai_*、inquiry_*、vip_*、geo、seo、spiderlog_* 等）。

每张表独立成段，包含：用途 / 核心字段 / 关联关系 / 典型使用场景。
生成时间：2026-09-18

全局约定

时间字段风格：CMS 表用 datetime（如 create_time），框架/用户/配置表用 bigint 时间戳（秒）。两套并存。

缓存约定：CMS 数据统一打 cms_cache 标签，框架配置打 sys_config 标签，后台菜单缓存键 __menu__。

一、框架表（19 张）

1. bd_admin — 后台管理员表

用途：存储后台管理员账号、登录状态与基础资料。

核心字段

关联关系

• bd_admin_group_access.uid → bd_admin.id（多对多挂角色）
• bd_admin_log.admin_id → bd_admin.id
• bd_admin_group.rules 中的节点 ID → bd_admin_rule.id

典型使用场景

• 后台登录认证（AdminAuth）。
• 分配角色：通过 bd_admin_group_access 关联多个 bd_admin_group。
• 操作日志记录操作人。

2. bd_admin_group — 后台权限组/角色表

用途：定义后台角色及其拥有的权限节点集合。

核心字段

关联关系

• rules → bd_admin_rule.id
• 被 bd_admin_group_access.group_id 引用

典型使用场景

• 后台角色管理（超管、编辑、运营）。
• 登录后聚合该组 rules 计算菜单与按钮权限。

3. bd_admin_group_access — 管理员-角色关联表

用途：管理员与权限组的多对多关系表。

核心字段

关联关系

• uid → bd_admin.id
• group_id → bd_admin_group.id

典型使用场景

• 给管理员分配一个或多个角色。
• 权限校验时按 uid 反查所有 group_id。

4. bd_admin_rule — 后台菜单/权限节点表

用途：后台菜单树与权限节点的统一定义表。

核心字段

关联关系

• pid 自关联形成菜单树
• 被 bd_admin_group.rules 引用
• Adminlog::record() 通过 name 反查 title 作为日志标题

典型使用场景

• 后台左侧菜单渲染（缓存 __menu__）。
• 按钮级权限校验。
• 菜单/节点的增删改（菜单管理页）。

5. bd_admin_log — 后台操作日志表

用途：记录后台管理员的写操作，供审计追溯。

核心字段

关联关系

• admin_id → bd_admin.id

典型使用场景

• 后台增删改自动写日志（Adminlog::record()）。
• 审计谁在何时改了什么。

6. bd_user — 会员表

用途：前台会员账号、资料、余额积分与登录信息。

核心字段

关联关系

• group_id → bd_user_group.id
• level → bd_user_level.gcode
• 被 bd_cms_member_comment.uid/puid、bd_user_money_log.user_id、bd_user_score_log.user_id、bd_token.user_id 引用

典型使用场景

• 前台注册 / 登录 / 个人中心。
• 余额、积分变更（User::money() / User::score()）。
• 积分升级等级（nextlevel()）。
• 评论时作为评论人 / 被回复人。

7. bd_user_group — 会员组表

用途：定义前台会员分组及其功能权限。

核心字段

关联关系

• 被 bd_user.group_id 引用
• rules → bd_user_rule.id

典型使用场景

• 前台会员分级（普通、VIP、企业）。
• 控制不同组可访问的前台功能。

8. bd_user_level — 会员等级表

用途：按积分区间划分会员等级。

核心字段

关联关系

• 被 bd_user.level 引用（level 数值 = gcode）

典型使用场景

• 积分变动后自动计算等级（User::score() → nextlevel()）。
• 等级权益展示。

9. bd_user_rule — 会员权限规则表

用途：前台会员功能权限节点定义（树形）。

核心字段

关联关系

• pid 自关联成树
• 被 bd_user_group.rules 引用

典型使用场景

• 会员组权限勾选（UserRule::getTreeList()）。
• 前台功能鉴权。

10. bd_user_money_log — 会员余额变动流水表

用途：记录每一次会员余额的增减，可追溯。

核心字段

关联关系

• user_id → bd_user.id

典型使用场景

• 后台改余额、前台消费/充值。
• 财务对账与流水查询。

11. bd_user_score_log — 会员积分变动流水表

用途：记录每一次会员积分的增减。

核心字段

关联关系

• user_id → bd_user.id

典型使用场景

• 签到、消费、后台调整积分。
• 积分明细查询。

12. bd_user_field — 会员自定义字段表（历史遗留）

用途：早期用于定义会员扩展字段。

核心字段

关联关系

• 当前代码库中无任何引用

典型使用场景

• 历史遗留表，现版本会员扩展字段已改为固定列，保留仅为兼容。

13. bd_config — 系统配置表

用途：全站系统参数的结构化配置（key/value + 表单元信息）。

核心字段

关联关系

• 逻辑上驱动后台"系统配置"表单
• 缓存标签 sys_config
• 无外键

典型使用场景

• 站点基础设置、上传、邮件、短信、AI 等全局参数。
• 读取：get_sys_config()；写入：Config::setSysConfig()。

14. bd_attachment — 附件表

用途：记录上传的文件/图片及其元信息，统一附件管理。

核心字段

关联关系

• admin_id / user_id 弱关联操作人
• url 被内容、封面、轮播等字段以字符串引用

典型使用场景

• 后台附件管理、选择图片。
• 云存储缩略图样式（thumb_style 依赖 storage 配置）。

15. bd_token — 用户 Token 表

用途：持久化前台/API 登录令牌，支持校验与过期。

核心字段

关联关系

• user_id → bd_user.id

典型使用场景

• 前台登录态保持、API 鉴权、Token 过期清理。

16. bd_ems — 邮箱验证码表

用途：存储邮箱验证码发送记录，用于校验。

核心字段

关联关系

• 无外键

典型使用场景

• 发送 / 校验邮箱验证码，限制次数与频率。

17. bd_sms — 短信验证码表

用途：存储短信验证码发送记录，用于校验。

核心字段

关联关系

• 无外键

典型使用场景

• 短信验证码发送与校验（注册、登录、改绑）。

18. bd_migrations — 数据库迁移记录表

用途：Phinx 迁移框架的版本记录表，标记已执行的迁移。

核心字段

关联关系

• 无外键

典型使用场景

• 模块安装/升级时记录并跳过已执行的迁移。

19. bd_area — 省市区地区表（历史遗留）

用途：内置的省 / 市 / 区三级地区基础数据。

核心字段

关联关系

• pid 自关联
• 当前代码库中无引用（电商地区使用 bd_shop_region）

典型使用场景

• 历史遗留地区数据，现版本代码未使用。

二、CMS 表（16 张）

20. bd_cms_content — 内容/文章主表

用途：存储文章、产品、单页等所有 CMS 内容。

核心字段

关联关系

• scode → bd_cms_content_sort.scode（Content::contentsort()）
• acode → bd_cms_area.acode
• 扩展值：bd_cms_content_ext.contentid → 本表 id（删除时级联删除）
• 被 bd_cms_member_comment.contentid 引用

典型使用场景

• 后台内容列表 / 编辑 / 复制 / 移动栏目。
• 前台文章详情、列表、搜索。
• 单页模型（type=1）栏目自动创建一条内容。

21. bd_cms_content_ext — 内容扩展字段值表

用途：存储各内容模型自定义字段的值。

核心字段

关联关系

• contentid → bd_cms_content.id
• 列结构由 bd_cms_extfield 定义，增删字段会 ALTER 本表

典型使用场景

• 产品价格、颜色、规格等自定义字段读写（ContentExt::getExtData()）。
• 模型字段变更时自动加列 / 改列 / 删列。

22. bd_cms_content_sort — 栏目/分类表

用途：CMS 栏目树（分类），绑定列表页与内容页模板。

核心字段

关联关系

• mcode → bd_cms_model.mcode（ContentSort::models()）
• pcode 自关联（树，防循环校验）
• scode 被 bd_cms_content.scode 引用
• acode → bd_cms_area.acode

典型使用场景

• 栏目管理、拖拽排序、模板绑定。
• 获取子栏目（getChildrenIds()）。
• 单页模型（type=1）自动建内容。

23. bd_cms_model — 内容模型表

用途：定义内容类型（文章、产品、单页等）及其模板。

核心字段

关联关系

• mcode 被 bd_cms_content_sort.mcode 和 bd_cms_extfield.mcode 引用

典型使用场景

• 新建内容模型（如"产品""案例"）。
• 决定栏目是单页还是列表形态。

24. bd_cms_extfield — 模型字段定义表

用途：为内容模型定义自定义字段，并同步修改扩展表结构。

核心字段

关联关系

• mcode → bd_cms_model.mcode
• name 对应 bd_cms_content_ext 的实际列

典型使用场景

• 后台"模型字段"管理。
• 新增字段自动 ALTER bd_cms_content_ext；删除字段自动 DROP COLUMN。
• 多图类型自动追加一个 *title 字段。

25. bd_cms_area — CMS 区域/站点/语言表

用途：多站点 / 多语言 / 多域名区域的核心表。

核心字段

关联关系

• acode 被几乎所有 CMS 表的 acode 引用
• 删除区域时级联删除 bd_cms_site、bd_cms_company 对应记录

典型使用场景

• 新增语言/站点区域，自动创建语言包文件。
• 前台按域名解析 acode 实现多站点。
• 默认区域与启用状态保护（不可删默认/启用区域）。

26. bd_cms_site — 站点配置表

用途：按区域保存站点级配置（SEO、主题、备案、统计等）。

核心字段

关联关系

• acode → bd_cms_area.acode

典型使用场景

• 后台"站点设置"。
• 前台模板读取站点 SEO、主题、备案。

27. bd_cms_company — 公司信息表

用途：按区域保存公司联系方式等企业信息。

核心字段

关联关系

• acode → bd_cms_area.acode

典型使用场景

• 前台页脚、联系我们页面。
• 区域删除时级联清理。

28. bd_cms_tags — 文章内链词表

用途：配置正文中自动加链接的关键词（SEO 内链）。

核心字段

关联关系

• acode → bd_cms_area.acode
• 与 bd_cms_content.tags 不同：本表是"关键词自动内链"配置

典型使用场景

• 前台正文渲染时为指定关键词自动加超链接。

29. bd_cms_link — 友情链接表

用途：友情链接管理，支持分组。

核心字段

关联关系

• acode → bd_cms_area.acode
• gid 逻辑分组（非外键）

典型使用场景

• 前台页脚友链展示，按分组调用。

30. bd_cms_slide — 轮播图表

用途：管理各区域/分组的轮播图。

核心字段

关联关系

• acode → bd_cms_area.acode
• gid 逻辑分组

典型使用场景

• 首页 / 栏目轮播图，按 acode + gid 调用。

31. bd_cms_label — 定制标签表

用途：供模板调用的全局自定义标签（如电话、版权、Banner）。

核心字段

关联关系

• acode → bd_cms_area.acode
• 多图类型自动追加 *title 标签

典型使用场景

• 模板中用 {bd:label name="xxx"} 输出全局内容。
• 后台"定制标签"维护。

32. bd_cms_member_comment — 会员评论表

用途：存储会员对内容的评论与回复。

核心字段

关联关系

• contentid → bd_cms_content.id（MemberComment::content()）
• uid → bd_user.id（user()）
• puid → bd_user.id（puser()）
• pid 自关联（评论树）

典型使用场景

• 内容详情页评论、回复、点赞。
• 后台评论审核与回复。

33. bd_cms_message — 在线留言表

用途：存储前台在线留言/简易表单的提交数据。

核心字段

关联关系

• acode → bd_cms_area.acode
• uid → bd_user.id（默认匿名用户）
• 对应 bd_cms_form 中 fcode=1 的"在线留言"表单

典型使用场景

• 前台"在线留言"提交。
• 后台留言查看、回复、导出。

34. bd_cms_form — 自定义表单表

用途：定义自定义表单，并为其动态创建数据表。

核心字段

关联关系

• table_name 指向动态创建的 bd_cms_diy_* 数据表
• fcode 被 bd_cms_form_field.fcode 引用

典型使用场景

• 后台新建自定义表单（报名、预约、询价）。
• 创建时自动建表（固定含 id/acode/create_time）。
• fcode=1 为内置"在线留言"，不可删除。

35. bd_cms_form_field — 表单字段定义表

用途：定义自定义表单的字段，并同步修改对应数据表。

核心字段

关联关系

• fcode → bd_cms_form.fcode
• name 对应表单数据表（bd_cms_diy_*）的实际列

典型使用场景

• 表单字段设计；增删字段自动 ALTER 对应 DIY 数据表。

三、CMS 动态生成的 DIY 表

由 bd_cms_form 创建表单时动态生成，表名 bd_cms_diy_<table_name>，固定包含：

当前库中的 DIY 表：bd_cms_diy_aaa、bd_cms_diy_abcd、bd_cms_diy_baoming、bd_cms_diy_ces、bd_cms_diy_job、bd_cms_diy_test1、bd_diy_aaaa

典型使用场景

• 自定义表单提交数据落库；后台按表单查看/导出数据。

四、关键关联链速查

bd_cms_area.acode
   ├─ bd_cms_content.acode
   ├─ bd_cms_content_sort.acode
   ├─ bd_cms_site.acode
   ├─ bd_cms_company.acode
   ├─ bd_cms_link.acode / bd_cms_slide.acode / bd_cms_label.acode
   ├─ bd_cms_message.acode / bd_cms_tags.acode
   └─ bd_cms_diy_*.acode

bd_cms_model.mcode
   ├─ bd_cms_content_sort.mcode
   └─ bd_cms_extfield.mcode ──(name)──> bd_cms_content_ext 的列

bd_cms_content_sort.scode
   └─ bd_cms_content.scode

bd_cms_content.id
   ├─ bd_cms_content_ext.contentid
   └─ bd_cms_member_comment.contentid

bd_cms_form.fcode
   ├─ bd_cms_form_field.fcode ──(name)──> bd_cms_diy_* 的列
   └─ table_name ──> bd_cms_diy_*

bd_admin.id
   ├─ bd_admin_group_access.uid ──> bd_admin_group.id ──> bd_admin_rule.id
   └─ bd_admin_log.admin_id

bd_user.id
   ├─ bd_user_money_log.user_id
   ├─ bd_user_score_log.user_id
   ├─ bd_cms_member_comment.uid / puid
   └─ bd_token.user_id

bd_user_group.id ──> bd_user.group_id
bd_user_level.gcode ──> bd_user.level

两套"动态列"机制（易混淆）

• bd_cms_extfield + bd_cms_content_ext：给内容模型加字段。
• bd_cms_form_field + bd_cms_diy_*：给自定义表单加字段。
  两者都是直接改物理表结构，而非 EAV 键值存储。