数据库结构 - BlogLoom

BlogLoom 使用 MySQL 持久化内容与日志数据，数据库脚本统一放在 sql/ 目录，初始化与升级都通过增量脚本完成。

脚本布局

sql/
├── increment/          # 待执行增量 SQL，按版本分目录
│   └── 1.0/            #   1.0 版本，按时间戳命名
│       ├── 20260915000000_v1.0.x.sql   # 基线（含建库建表）
│       └── 2026..._v1.0.x.sql
└── local/              # 已执行 SQL 的记录（本机，不入库）

文件名格式：<时间戳>_v<版本>.x.sql，脚本按文件名排序执行。
sql/increment/1.0/ 中最早的基线脚本包含完整的建表语句。
sql/local/ 是扁平执行记录，已加入 .gitignore。

初始化与升级

创建数据库后，配置 bin/local/deploy.conf 并执行：

bin/local/upgrate-sql.sh --dry-run   # 预览待执行 SQL
bin/local/upgrate-sql.sh             # 执行并记录

详见初始化数据库。

执行规则

已记录在 sql/local/ 的脚本会被跳过，可安全重复执行。
不同版本、不同变更不能使用相同文件名（记录目录是扁平的）。
新增增量 SQL 使用当前开发时间；补录历史变更使用对应历史时间，保证时间戳顺序正确。

主要数据对象

文章、分类、标签、专栏及其关联表
动态、评论与点赞
站点配置、友链与关于页
用户、角色与日志

注意事项

结构或初始数据变化时，新增增量 SQL，而不是修改已执行的脚本。
修改初始化数据后，已运行环境需同步数据库并按需清理缓存。

下一步