feat: 增加规格匹配建议与决策审计 (#90)

admin/repository/mysql_db.go

@@ -19,7 +19,7 @@ import (
 	"cmautobuy/admin/spec"
 )
 
-const mysqlSchemaVersion = 3
+const mysqlSchemaVersion = 4
 
 // OpenMySQL 打开生产 MySQL 8 数据库。错误信息绝不包含完整 DSN 或密码。
 func OpenMySQL(cfg config.DatabaseConfig) (*sql.DB, error) {
@@ -387,6 +387,21 @@ const mysqlSchemaV3SpecMappings = `CREATE TABLE IF NOT EXISTS spec_mappings (
 	KEY idx_spec_mappings_pdd (pdd_goods_id)
 ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci`
 
+const mysqlSchemaV4Decisions = `CREATE TABLE IF NOT EXISTS spec_mapping_decisions (
+	id BIGINT AUTO_INCREMENT PRIMARY KEY,
+	shopee_goods_id VARCHAR(191) COLLATE utf8mb4_bin NOT NULL,
+	spec_key VARCHAR(191) COLLATE utf8mb4_bin NOT NULL,
+	pdd_goods_id VARCHAR(191) COLLATE utf8mb4_bin NOT NULL,
+	rules_version VARCHAR(32) NOT NULL,
+	suggested_option_key VARCHAR(191) COLLATE utf8mb4_bin,
+	chosen_option_key VARCHAR(191) COLLATE utf8mb4_bin NOT NULL,
+	accepted TINYINT NOT NULL,
+	decided_by VARCHAR(191),
+	decided_at VARCHAR(35) NOT NULL,
+	CONSTRAINT chk_spec_mapping_decisions_accepted CHECK (accepted IN (0,1)),
+	KEY idx_decisions_mapping (shopee_goods_id, spec_key, pdd_goods_id)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci`
+
 // MigrateMySQL 建立或升级 MySQL schema。生产迁移只能在这里追加新版本。
 func MigrateMySQL(db *sql.DB) error {
 	if _, err := db.Exec(`CREATE TABLE IF NOT EXISTS schema_migrations (
@@ -437,17 +452,37 @@ func MigrateMySQL(db *sql.DB) error {
 		if err := migrateMySQLV3(db); err != nil {
 			return fmt.Errorf("执行 MySQL schema v3 失败: %w", err)
 		}
-		if err := CheckMySQLSchema(db); err != nil {
+		if err := checkMySQLSchemaV3(db); err != nil {
 			return fmt.Errorf("MySQL schema v3 自检失败，未记录版本: %w", err)
 		}
 		if _, err := db.Exec(`INSERT INTO schema_migrations (version, applied_at) VALUES (?, ?)`,
 			3, time.Now().UTC().Format(time.RFC3339Nano)); err != nil {
 			return fmt.Errorf("记录 MySQL schema v3 失败: %w", err)
 		}
+		current = 3
+	}
+	if current < 4 {
+		if _, err := db.Exec(mysqlSchemaV4Decisions); err != nil {
+			return fmt.Errorf("执行 MySQL schema v4 失败: %w", err)
+		}
+		if err := checkMySQLV4Shape(db); err != nil {
+			return fmt.Errorf("MySQL schema v4 自检失败，未记录版本: %w", err)
+		}
+		if _, err := db.Exec(`INSERT INTO schema_migrations (version, applied_at) VALUES (?, ?)`, 4, time.Now().UTC().Format(time.RFC3339Nano)); err != nil {
+			return fmt.Errorf("记录 MySQL schema v4 失败: %w", err)
+		}
 	}
 	return CheckMySQLSchema(db)
 }
 
+func checkMySQLSchemaV3(db *sql.DB) error {
+	tables := []string{"shopee_products", "shopee_skus", "pdd_products", "syb_orders", "spec_mappings", "tasks", "clients", "idempotency_keys", "task_claims", "syb_session", "syb_sync_state", "users", "web_sessions", "client_user_assignments", "syb_sync_runs", "admin_initialization_lock"}
+	if err := checkMySQLSchema(db, tables); err != nil {
+		return err
+	}
+	return checkMySQLV3Shape(db)
+}
+
 // migrateMySQLV3 把采购规格身份从蝦皮 SKU 改为顺运宝商品规格原文。
 // 每一步都可重放：DDL 已提交但版本尚未记录时，再启动仍会收敛。
 func migrateMySQLV3(db *sql.DB) error {
@@ -686,11 +721,44 @@ func CheckMySQLSchema(db *sql.DB) error {
 		"shopee_products", "shopee_skus", "pdd_products", "syb_orders", "spec_mappings",
 		"tasks", "clients", "idempotency_keys", "task_claims", "syb_session", "syb_sync_state",
 		"users", "web_sessions", "client_user_assignments", "syb_sync_runs", "admin_initialization_lock",
+		"spec_mapping_decisions",
 	}
 	if err := checkMySQLSchema(db, mysqlRequiredTables); err != nil {
 		return err
 	}
-	return checkMySQLV3Shape(db)
+	if err := checkMySQLV3Shape(db); err != nil {
+		return err
+	}
+	return checkMySQLV4Shape(db)
+}
+
+func checkMySQLV4Shape(db *sql.DB) error {
+	for _, c := range []struct {
+		name     string
+		length   int64
+		nullable bool
+		coll     string
+	}{
+		{"shopee_goods_id", 191, false, "utf8mb4_bin"}, {"spec_key", 191, false, "utf8mb4_bin"}, {"pdd_goods_id", 191, false, "utf8mb4_bin"},
+		{"rules_version", 32, false, "utf8mb4_0900_ai_ci"}, {"suggested_option_key", 191, true, "utf8mb4_bin"}, {"chosen_option_key", 191, false, "utf8mb4_bin"},
+	} {
+		if err := checkMySQLVarcharColumn(db, "spec_mapping_decisions", c.name, c.length, c.nullable, c.coll, ""); err != nil {
+			return err
+		}
+	}
+	var enforced, clause string
+	if err := db.QueryRow(`SELECT tc.enforced,cc.check_clause FROM information_schema.table_constraints tc JOIN information_schema.check_constraints cc ON cc.constraint_schema=tc.constraint_schema AND cc.constraint_name=tc.constraint_name WHERE tc.constraint_schema=DATABASE() AND tc.table_name='spec_mapping_decisions' AND tc.constraint_name='chk_spec_mapping_decisions_accepted'`).Scan(&enforced, &clause); err != nil {
+		return fmt.Errorf("审计 accepted CHECK 缺失: %w", err)
+	}
+	n := strings.NewReplacer("`", "", " ", "", "(", "", ")", "", "_utf8mb4", "", `\`, "").Replace(strings.ToLower(clause))
+	if enforced != "YES" || n != "acceptedin0,1" {
+		return fmt.Errorf("审计 accepted CHECK 不正确")
+	}
+	var cols string
+	if err := db.QueryRow(`SELECT GROUP_CONCAT(column_name ORDER BY seq_in_index) FROM information_schema.statistics WHERE table_schema=DATABASE() AND table_name='spec_mapping_decisions' AND index_name='idx_decisions_mapping'`).Scan(&cols); err != nil || cols != "shopee_goods_id,spec_key,pdd_goods_id" {
+		return fmt.Errorf("审计映射索引不正确")
+	}
+	return nil
 }
 
 func checkMySQLSchema(db *sql.DB, tables []string) error {