feat(db): add golang-migrate runner

internal/infra/db/migrate.go

@@ -0,0 +1,28 @@
+// Package db 提供数据库相关的基础设施工具，包括 golang-migrate 迁移运行器。
+package db
+
+import (
+	"errors"
+	"fmt"
+
+	"github.com/golang-migrate/migrate/v4"
+	// 注册 postgres 数据库驱动（database://postgres）。
+	_ "github.com/golang-migrate/migrate/v4/database/postgres"
+	// 注册 file:// 迁移源驱动。
+	_ "github.com/golang-migrate/migrate/v4/source/file"
+)
+
+// Migrate 跑指定路径下的迁移到最新版本。
+// migrationsPath 形如 "file://migrations"，dsn 为 postgres 连接串。
+// 当无新迁移可应用时（migrate.ErrNoChange）视为成功，返回 nil。
+func Migrate(dsn, migrationsPath string) error {
+	m, err := migrate.New(migrationsPath, dsn)
+	if err != nil {
+		return fmt.Errorf("init migrate: %w", err)
+	}
+	defer func() { _, _ = m.Close() }()
+	if err := m.Up(); err != nil && !errors.Is(err, migrate.ErrNoChange) {
+		return fmt.Errorf("migrate up: %w", err)
+	}
+	return nil
+}