sub2api/backend/migrations/migrations.go

// Package migrations 包含嵌入的 SQL 数据库迁移文件。
//
// 该包使用 Go 1.16+ 的 embed 功能将 SQL 文件嵌入到编译后的二进制文件中。
// 这种方式的优点：
//   - 部署时无需额外的迁移文件
//   - 迁移文件与代码版本一致
//   - 便于版本控制和代码审查
package migrations

import "embed"

// FS 包含本目录下所有嵌入的 SQL 迁移文件。
//
// 迁移命名规范：
//   - 使用零填充的数字前缀确保正确的执行顺序
//   - 格式：NNN_description.sql（如 001_init.sql, 002_add_users.sql）
//   - 描述部分使用下划线分隔的小写单词
//
// 迁移文件要求：
//   - 必须是幂等的（可重复执行而不产生错误）
//   - 推荐使用 IF NOT EXISTS / IF EXISTS 语法
//   - 一旦应用，不应修改已有的迁移文件（通过 checksum 校验）
//
// 示例迁移文件：
//
//	-- 001_init.sql
//	CREATE TABLE IF NOT EXISTS users (
//	    id BIGSERIAL PRIMARY KEY,
//	    email VARCHAR(255) NOT NULL UNIQUE,
//	    created_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
//	);
//
//go:embed *.sql
var FS embed.FS