migrations/Version20260626120000.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.  * Creates the creator_classification table.
  12.  *
  13.  * This is the authoritative, machine-written record of a creator's
  14.  * classification as produced by the EXTERNAL classifier service. It is the
  15.  * system of record and carries the full provenance, confidence and
  16.  * reversibility of every classification:
  17.  *  - provenance: model_provider / model_id / prompt_version /
  18.  *    classification_version / input_kind / source_images / cost_usd /
  19.  *    classified_at, so every value can be traced back to the exact run that
  20.  *    wrote it;
  21.  *  - confidence: the per-attribute confidence map plus trust_score /
  22.  *    trust_band / trust_breakdown / signals, so downstream consumers can gate
  23.  *    decisions on certainty;
  24.  *  - reversibility: the prior_* columns snapshot the previous creator.* values
  25.  *    before write-back, so a classification can be cleanly restored/rolled back.
  26.  *
  27.  * It is deliberately SEPARATE from the legacy creator.* enum columns
  28.  * (creator.ethnicity, creator.age_group, creator.category_gender,
  29.  * creator.category_parent, creator.attractiveness_level, creator.tier). The
  30.  * classifier service writes its results BACK into those creator.* columns so
  31.  * the existing admin UI keeps working unchanged; those columns are a
  32.  * denormalised projection for the UI, whereas this table is the source of
  33.  * truth. The prior_* columns mirror the creator.* column types (BIGINT
  34.  * UNSIGNED) precisely so a clean restore of the legacy columns is possible.
  35.  *
  36.  * creator_id is the primary key and equals creator.id, but NO foreign key
  37.  * constraint is declared on purpose: the relation is enforced at the
  38.  * application layer so the external service can upsert rows independently of
  39.  * (and without locking against) the creator table. Because there is no FK,
  40.  * deleting a creator does NOT cascade-delete its classification row; orphan
  41.  * rows are cleaned up out-of-band by the external classifier service (or a
  42.  * periodic reconciliation job), which is the deliberate trade-off for keeping
  43.  * external-service upserts independent of the creator table.
  44.  */
  45. final class Version20260626120000 extends AbstractMigration
  46. {
  47.     public function getDescription(): string
  48.     {
  49.         return 'Create creator_classification table (authoritative record written by the external classifier service)';
  50.     }
  52.     public function up(Schema $schema): void
  53.     {
  54.         $this->addSql(<<<'SQL'
  55.             CREATE TABLE creator_classification (
  56.                 creator_id BIGINT UNSIGNED NOT NULL COMMENT 'Primary key; equals creator.id. No FK constraint by design so the external classifier service can upsert independently; the relation is enforced at the application layer.',
  57.                 ethnicity TINYINT UNSIGNED DEFAULT NULL,
  58.                 age_group TINYINT UNSIGNED DEFAULT NULL,
  59.                 category_gender TINYINT UNSIGNED DEFAULT NULL,
  60.                 category_parent TINYINT UNSIGNED DEFAULT NULL,
  61.                 attractiveness_level TINYINT UNSIGNED DEFAULT NULL,
  62.                 tier TINYINT UNSIGNED DEFAULT NULL,
  63.                 trust_score DECIMAL(5, 2) DEFAULT NULL,
  64.                 trust_band TINYINT UNSIGNED DEFAULT NULL,
  65.                 confidence JSON DEFAULT NULL,
  66.                 signals JSON DEFAULT NULL,
  67.                 trust_breakdown JSON DEFAULT NULL,
  68.                 input_kind VARCHAR(24) NOT NULL DEFAULT 'avatar_plus_posts',
  69.                 source_images JSON DEFAULT NULL,
  70.                 model_provider VARCHAR(32) DEFAULT NULL,
  71.                 model_id VARCHAR(64) DEFAULT NULL,
  72.                 prompt_version VARCHAR(16) DEFAULT NULL,
  73.                 classification_version INT NOT NULL DEFAULT 0,
  74.                 cost_usd DECIMAL(8, 5) DEFAULT NULL,
  75.                 had_human_label TINYINT(1) NOT NULL DEFAULT 0,
  76.                 prior_ethnicity BIGINT UNSIGNED DEFAULT NULL,
  77.                 prior_age_group BIGINT UNSIGNED DEFAULT NULL,
  78.                 prior_category_gender BIGINT UNSIGNED DEFAULT NULL,
  79.                 prior_category_parent BIGINT UNSIGNED DEFAULT NULL,
  80.                 prior_attractiveness_level BIGINT UNSIGNED DEFAULT NULL,
  81.                 prior_tier BIGINT UNSIGNED DEFAULT NULL,
  82.                 error TEXT DEFAULT NULL,
  83.                 classified_at DATETIME DEFAULT NULL,
  84.                 updated_at DATETIME DEFAULT NULL,
  85.                 INDEX idx_cc_ethnicity (ethnicity),
  86.                 INDEX idx_cc_age_group (age_group),
  87.                 INDEX idx_cc_tier (tier),
  88.                 INDEX idx_cc_version (classification_version),
  89.                 INDEX idx_cc_classified_at (classified_at),
  90.                 INDEX idx_cc_target (category_gender, ethnicity, tier),
  91.                 PRIMARY KEY(creator_id)
  92.             ) DEFAULT CHARACTER SET utf8mb4 COLLATE `utf8mb4_unicode_ci` ENGINE = InnoDB
  93.             SQL);
  94.     }
  96.     public function down(Schema $schema): void
  97.     {
  98.         $this->addSql('DROP TABLE creator_classification');
  99.     }
  100. }