数据库升级包目录（install/upgrades）
================================================

用途
----
将「升级脚本」（.sql 文件）放入本目录后，进入后台「数据库升级」页面，
系统会自动扫描并提示「发现 N 个可升级数据库脚本」，管理员可一键或逐个执行。
每次执行都会在 db_upgrades 表中留下记录（文件名、内容指纹 MD5、执行时间、操作人），
便于追溯与审计。

命名建议
--------
  序号_功能描述.sql     例如  001_add_member_level.sql
序号便于排序与阅读，文件名（不含路径）作为唯一标识写入 db_upgrades。
若同一文件内容被修改后再次放入，系统会识别为「内容已变更」并提示重新升级。

编写规范
--------
1. 仅放 DDL / DML 的标准 MySQL 脚本；多条语句以分号（;）分隔，自动拆分执行。
2. 优先使用「幂等写法」，避免重复执行报错，例如：
     CREATE TABLE IF NOT EXISTS xxx (...);
     ALTER TABLE yyy ADD COLUMN IF NOT EXISTS zzz ...;   -- MySQL 8.0.28+
     INSERT INTO ... ON DUPLICATE KEY UPDATE ...;
3. 不建议在升级包中执行 DROP TABLE / TRUNCATE 等破坏性语句，除非确有必要。
4. 升级前请务必备份数据库。

说明
----
- 本目录下的 examples/ 子目录为示例，不会被自动扫描（仅扫描本目录根下的 *.sql）。
- 想试用示例时，请将 examples/ 中的文件复制到本目录根下再执行。