migrations/Version20260626120100.php line 1

Open in your IDE?
  1. <?php
  3. declare(strict_types=1);
  5. namespace DoctrineMigrations;
  7. use Doctrine\DBAL\Schema\Schema;
  8. use Doctrine\Migrations\AbstractMigration;
  10. /**
  11.  * Snapshot of human-entered creator demographic labels for reversibility.
  12.  *
  13.  * The demographic columns on `creator` (ethnicity, age_group, category_gender,
  14.  * category_parent, attractiveness_level, tier) are populated by humans via the
  15.  * backend CreatorCategoryForm. A later automated data-classification job is
  16.  * allowed to overwrite those same columns, which would otherwise destroy the
  17.  * manually-curated labels with no way back.
  18.  *
  19.  * This migration creates `creator_classification_human_backup` and, in the same
  20.  * deploy step, copies every creator that currently has at least one
  21.  * human-entered label into it (source = 'human'). It runs once at deploy time,
  22.  * BEFORE the classifier overwrites creator.*, so each environment snapshots its
  23.  * own human labels and a restore back into creator.* stays possible.
  24.  *
  25.  * Columns mirror creator.* types exactly so a restore is a clean column-for-column
  26.  * copy. The populate step uses INSERT IGNORE so that a re-run after a partial
  27.  * failure (the CREATE TABLE above is auto-committed and cannot be rolled back)
  28.  * simply skips creators that were already backed up instead of erroring on the
  29.  * creator_id primary key.
  30.  *
  31.  * Depends on MR-1's doctrine.yaml schema_filter ('~^(?!creator_classification)~'),
  32.  * which excludes the unmapped classifier tables from schema tooling. That filter
  33.  * also covers this creator_classification_human_backup table, so migrations:diff
  34.  * will not emit a spurious DROP for it.
  35.  */
  36. final class Version20260626120100 extends AbstractMigration
  37. {
  38.     public function getDescription(): string
  39.     {
  40.         return 'Create creator_classification_human_backup and snapshot human-entered demographic labels before the classifier overwrites creator.*';
  41.     }
  43.     public function up(Schema $schema): void
  44.     {
  45.         $this->addSql(<<<'SQL'
  46.             CREATE TABLE creator_classification_human_backup (
  47.                 creator_id BIGINT UNSIGNED NOT NULL,
  48.                 ethnicity BIGINT UNSIGNED DEFAULT NULL,
  49.                 age_group BIGINT UNSIGNED DEFAULT NULL,
  50.                 category_gender BIGINT UNSIGNED DEFAULT NULL,
  51.                 category_parent BIGINT UNSIGNED DEFAULT NULL,
  52.                 attractiveness_level BIGINT UNSIGNED DEFAULT NULL,
  53.                 tier BIGINT UNSIGNED DEFAULT NULL,
  54.                 source VARCHAR(16) NOT NULL DEFAULT 'human',
  55.                 backed_up_at DATETIME DEFAULT NULL,
  56.                 PRIMARY KEY(creator_id)
  57.             ) DEFAULT CHARACTER SET utf8mb4 COLLATE `utf8mb4_unicode_ci` ENGINE = InnoDB
  58.             SQL);
  60.         $this->addSql(<<<'SQL'
  61.             INSERT IGNORE INTO creator_classification_human_backup
  62.                 (creator_id, ethnicity, age_group, category_gender, category_parent, attractiveness_level, tier, source, backed_up_at)
  63.             SELECT id, ethnicity, age_group, category_gender, category_parent, attractiveness_level, tier, 'human', NOW()
  64.             FROM creator
  65.             WHERE ethnicity IS NOT NULL
  66.                 OR age_group IS NOT NULL
  67.                 OR category_gender IS NOT NULL
  68.                 OR category_parent IS NOT NULL
  69.                 OR attractiveness_level IS NOT NULL
  70.                 OR tier IS NOT NULL
  71.             SQL);
  72.     }
  74.     public function down(Schema $schema): void
  75.     {
  76.         $this->addSql(<<<'SQL'
  77.             DROP TABLE creator_classification_human_backup
  78.             SQL);
  79.     }
  80. }