@actuate-media/cms-core 0.28.1 → 0.30.0

package/prisma/migrations/0009_seo/migration.sql

@@ -0,0 +1,143 @@
+-- SEO Operations Center
+--
+-- Adds the persistence layer for the SEO module:
+--   * Redirect: runtime + management columns (enabled, priority, preserveQuery,
+--     source_kind, hits, lastHitAt, createdById).
+--   * SeoAuditRun: one row per audit execution (score + issue-count snapshot).
+--   * SeoIssue: detected SEO problems, status carried across runs via issueKey.
+--   * Redirect404Hit: aggregated 404 traffic observed by the middleware.
+--   * RedirectSuggestion: confidence-scored 404 recovery / chain suggestions.
+--
+-- Safe to apply to a populated database:
+--   * Every new Redirect column is nullable or has a default — no backfill.
+--   * New tables/enums are additive; no existing column is dropped or retyped.
+
+-- ---------------------------------------------------------------------------
+-- Enums
+-- ---------------------------------------------------------------------------
+CREATE TYPE "SeoAuditStatus" AS ENUM ('RUNNING', 'COMPLETED', 'FAILED');
+CREATE TYPE "SeoIssueSeverity" AS ENUM ('critical', 'warning', 'info');
+CREATE TYPE "SeoIssueStatus" AS ENUM ('open', 'ignored', 'resolved', 'recurring');
+CREATE TYPE "SeoIssueCategory" AS ENUM (
+  'content', 'technical', 'redirects', 'media',
+  'performance', 'schema', 'social', 'indexing'
+);
+
+-- ---------------------------------------------------------------------------
+-- actuate_redirects new columns
+-- ---------------------------------------------------------------------------
+ALTER TABLE "actuate_redirects"
+  ADD COLUMN "enabled"       BOOLEAN NOT NULL DEFAULT true,
+  ADD COLUMN "priority"      INTEGER NOT NULL DEFAULT 0,
+  ADD COLUMN "preserveQuery" BOOLEAN NOT NULL DEFAULT false,
+  ADD COLUMN "source_kind"   TEXT NOT NULL DEFAULT 'manual',
+  ADD COLUMN "hits"          INTEGER NOT NULL DEFAULT 0,
+  ADD COLUMN "lastHitAt"     TIMESTAMP(3),
+  ADD COLUMN "createdById"   TEXT;
+
+CREATE INDEX "actuate_redirects_enabled_idx" ON "actuate_redirects" ("enabled");
+CREATE INDEX "actuate_redirects_lastHitAt_idx" ON "actuate_redirects" ("lastHitAt");
+
+-- ---------------------------------------------------------------------------
+-- actuate_seo_audit_runs
+-- ---------------------------------------------------------------------------
+CREATE TABLE "actuate_seo_audit_runs" (
+  "id"              TEXT NOT NULL,
+  "status"          "SeoAuditStatus" NOT NULL DEFAULT 'RUNNING',
+  "scope"           TEXT NOT NULL DEFAULT 'full',
+  "startedById"     TEXT,
+  "startedAt"       TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+  "finishedAt"      TIMESTAMP(3),
+  "siteScoreBefore" INTEGER,
+  "siteScoreAfter"  INTEGER,
+  "pagesScanned"    INTEGER NOT NULL DEFAULT 0,
+  "issuesFound"     INTEGER NOT NULL DEFAULT 0,
+  "criticalCount"   INTEGER NOT NULL DEFAULT 0,
+  "warningCount"    INTEGER NOT NULL DEFAULT 0,
+  "infoCount"       INTEGER NOT NULL DEFAULT 0,
+  "errorMessage"    TEXT,
+  "metadata"        JSONB,
+  CONSTRAINT "actuate_seo_audit_runs_pkey" PRIMARY KEY ("id")
+);
+
+CREATE INDEX "actuate_seo_audit_runs_status_idx" ON "actuate_seo_audit_runs" ("status");
+CREATE INDEX "actuate_seo_audit_runs_startedAt_idx" ON "actuate_seo_audit_runs" ("startedAt");
+
+-- ---------------------------------------------------------------------------
+-- actuate_seo_issues
+-- ---------------------------------------------------------------------------
+CREATE TABLE "actuate_seo_issues" (
+  "id"               TEXT NOT NULL,
+  "auditRunId"       TEXT,
+  "issueKey"         TEXT NOT NULL,
+  "entityType"       TEXT,
+  "entityId"         TEXT,
+  "entityTitle"      TEXT,
+  "url"              TEXT,
+  "severity"         "SeoIssueSeverity" NOT NULL,
+  "category"         "SeoIssueCategory" NOT NULL,
+  "type"             TEXT NOT NULL,
+  "title"            TEXT NOT NULL,
+  "description"      TEXT,
+  "impact"           TEXT,
+  "recommendation"   TEXT,
+  "status"           "SeoIssueStatus" NOT NULL DEFAULT 'open',
+  "fixable"          BOOLEAN NOT NULL DEFAULT false,
+  "fixActionType"    TEXT,
+  "relatedEntityIds" JSONB,
+  "source"           TEXT NOT NULL DEFAULT 'audit',
+  "firstDetectedAt"  TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+  "lastDetectedAt"   TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+  "resolvedAt"       TIMESTAMP(3),
+  "resolvedById"     TEXT,
+  "metadata"         JSONB,
+  CONSTRAINT "actuate_seo_issues_pkey" PRIMARY KEY ("id")
+);
+
+CREATE INDEX "actuate_seo_issues_auditRunId_idx" ON "actuate_seo_issues" ("auditRunId");
+CREATE INDEX "actuate_seo_issues_status_idx" ON "actuate_seo_issues" ("status");
+CREATE INDEX "actuate_seo_issues_severity_idx" ON "actuate_seo_issues" ("severity");
+CREATE INDEX "actuate_seo_issues_category_idx" ON "actuate_seo_issues" ("category");
+CREATE INDEX "actuate_seo_issues_issueKey_idx" ON "actuate_seo_issues" ("issueKey");
+
+ALTER TABLE "actuate_seo_issues"
+  ADD CONSTRAINT "actuate_seo_issues_auditRunId_fkey"
+  FOREIGN KEY ("auditRunId") REFERENCES "actuate_seo_audit_runs"("id")
+  ON DELETE SET NULL ON UPDATE CASCADE;
+
+-- ---------------------------------------------------------------------------
+-- actuate_redirect_404_hits
+-- ---------------------------------------------------------------------------
+CREATE TABLE "actuate_redirect_404_hits" (
+  "id"          TEXT NOT NULL,
+  "path"        TEXT NOT NULL,
+  "hits"        INTEGER NOT NULL DEFAULT 1,
+  "referrer"    TEXT,
+  "resolvedAt"  TIMESTAMP(3),
+  "firstSeenAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+  "lastSeenAt"  TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+  CONSTRAINT "actuate_redirect_404_hits_pkey" PRIMARY KEY ("id")
+);
+
+CREATE UNIQUE INDEX "actuate_redirect_404_hits_path_key" ON "actuate_redirect_404_hits" ("path");
+CREATE INDEX "actuate_redirect_404_hits_lastSeenAt_idx" ON "actuate_redirect_404_hits" ("lastSeenAt");
+
+-- ---------------------------------------------------------------------------
+-- actuate_redirect_suggestions
+-- ---------------------------------------------------------------------------
+CREATE TABLE "actuate_redirect_suggestions" (
+  "id"         TEXT NOT NULL,
+  "fromPath"   TEXT NOT NULL,
+  "toPath"     TEXT NOT NULL,
+  "confidence" INTEGER NOT NULL DEFAULT 0,
+  "reason"     TEXT,
+  "status"     TEXT NOT NULL DEFAULT 'open',
+  "source"     TEXT NOT NULL DEFAULT 'ai-404-recovery',
+  "metadata"   JSONB,
+  "createdAt"  TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+  "updatedAt"  TIMESTAMP(3) NOT NULL,
+  CONSTRAINT "actuate_redirect_suggestions_pkey" PRIMARY KEY ("id")
+);
+
+CREATE INDEX "actuate_redirect_suggestions_status_idx" ON "actuate_redirect_suggestions" ("status");
+CREATE INDEX "actuate_redirect_suggestions_fromPath_idx" ON "actuate_redirect_suggestions" ("fromPath");

package/prisma/schema.prisma

@@ -330,6 +330,12 @@ model Version {
   @@map("actuate_versions")
 }
 
+enum MediaStatus {
+  PROCESSING
+  READY
+  FAILED
+}
+
 model Media {
   id            String   @id @default(cuid())
   filename      String
@@ -351,11 +357,34 @@ model Media {
   createdAt     DateTime @default(now())
   updatedAt     DateTime @updatedAt
 
+  // ── Media Center additions ──────────────────────────────────────
+  // All nullable / defaulted so they're safe to add to a populated DB
+  // with no backfill. SEO score/issues are intentionally NOT stored —
+  // they're derived on read by `calculateMediaSeoScore()` so they can
+  // never drift from the metadata below.
+  originalFileName   String?
+  caption            String?
+  description        String?
+  focusKeyword       String?
+  tags               Json?
+  // `storageKey` historically held the public URL; `publicUrl` splits
+  // that concern out. New uploads populate both; legacy rows keep the
+  // URL in `storageKey` and `mediaUrl()` still resolves it.
+  publicUrl          String?
+  storageProvider    String?
+  durationSeconds    Float?
+  thumbnailUrl       String?
+  responsiveVariants Json?
+  status             MediaStatus @default(READY)
+  deletedAt          DateTime?
+
   uploadedBy  User         @relation(fields: [uploadedById], references: [id])
   folder      Folder?      @relation(fields: [folderId], references: [id], onDelete: SetNull)
   mediaUsages MediaUsage[]
 
   @@index([folderId])
+  @@index([deletedAt])
+  @@index([mimeType])
   @@map("actuate_media")
 }
 
@@ -444,19 +473,165 @@ model WorkflowState {
 }
 
 model Redirect {
-  id          String   @id @default(cuid())
-  source      String
-  destination String
-  statusCode  Int      @default(301)
-  isRegex     Boolean  @default(false)
-  notes       String?
-  createdAt   DateTime @default(now())
-  updatedAt   DateTime @updatedAt
+  id            String    @id @default(cuid())
+  source        String
+  destination   String
+  statusCode    Int       @default(301)
+  isRegex       Boolean   @default(false)
+  notes         String?
+  // Runtime + management metadata (added in 0009_seo). All defaulted so the
+  // migration is safe to apply to a populated table with no backfill.
+  enabled       Boolean   @default(true)
+  priority      Int       @default(0)
+  preserveQuery Boolean   @default(false)
+  // "manual" | "import" | "ai-404-recovery" | "chain-flatten"
+  source_kind   String    @default("manual")
+  hits          Int       @default(0)
+  lastHitAt     DateTime?
+  createdById   String?
+  createdAt     DateTime  @default(now())
+  updatedAt     DateTime  @updatedAt
 
   @@unique([source])
+  @@index([enabled])
+  @@index([lastHitAt])
   @@map("actuate_redirects")
 }
 
+// ─── SEO module (0009_seo) ──────────────────────────────────────────
+
+enum SeoAuditStatus {
+  RUNNING
+  COMPLETED
+  FAILED
+}
+
+enum SeoIssueSeverity {
+  critical
+  warning
+  info
+}
+
+enum SeoIssueStatus {
+  open
+  ignored
+  resolved
+  recurring
+}
+
+enum SeoIssueCategory {
+  content
+  technical
+  redirects
+  media
+  performance
+  schema
+  social
+  indexing
+}
+
+/// One execution of the SEO audit engine. Holds a snapshot of the site
+/// score and issue counts so the Audit tab can show run history without
+/// recomputing. Issues belong to a run via SEOIssue.auditRunId.
+model SeoAuditRun {
+  id              String         @id @default(cuid())
+  status          SeoAuditStatus @default(RUNNING)
+  scope           String         @default("full")
+  startedById     String?
+  startedAt       DateTime       @default(now())
+  finishedAt      DateTime?
+  siteScoreBefore Int?
+  siteScoreAfter  Int?
+  pagesScanned    Int            @default(0)
+  issuesFound     Int            @default(0)
+  criticalCount   Int            @default(0)
+  warningCount    Int            @default(0)
+  infoCount       Int            @default(0)
+  errorMessage    String?
+  metadata        Json?
+
+  issues SeoIssue[]
+
+  @@index([status])
+  @@index([startedAt])
+  @@map("actuate_seo_audit_runs")
+}
+
+/// A single SEO problem detected by an audit run. `issueKey` is a stable
+/// hash of (type + entityId/url) used to carry status across runs so a
+/// resolved/ignored issue stays resolved/ignored when re-detected.
+model SeoIssue {
+  id              String           @id @default(cuid())
+  auditRunId      String?
+  issueKey        String
+  entityType      String?
+  entityId        String?
+  entityTitle     String?
+  url             String?
+  severity        SeoIssueSeverity
+  category        SeoIssueCategory
+  type            String
+  title           String
+  description     String?
+  impact          String?
+  recommendation  String?
+  status          SeoIssueStatus   @default(open)
+  fixable         Boolean          @default(false)
+  fixActionType   String?
+  relatedEntityIds Json?
+  source          String           @default("audit")
+  firstDetectedAt DateTime         @default(now())
+  lastDetectedAt  DateTime         @default(now())
+  resolvedAt      DateTime?
+  resolvedById    String?
+  metadata        Json?
+
+  auditRun SeoAuditRun? @relation(fields: [auditRunId], references: [id], onDelete: SetNull)
+
+  @@index([auditRunId])
+  @@index([status])
+  @@index([severity])
+  @@index([category])
+  @@index([issueKey])
+  @@map("actuate_seo_issues")
+}
+
+/// A 404 hit observed by the redirect middleware. Aggregated per path so
+/// the Redirects tab can surface "broken URLs still getting traffic".
+model Redirect404Hit {
+  id         String   @id @default(cuid())
+  path       String
+  hits       Int      @default(1)
+  referrer   String?
+  resolvedAt DateTime?
+  firstSeenAt DateTime @default(now())
+  lastSeenAt DateTime @default(now())
+
+  @@unique([path])
+  @@index([lastSeenAt])
+  @@map("actuate_redirect_404_hits")
+}
+
+/// An AI/heuristic suggestion for a 404 destination. Confidence-scored and
+/// never auto-applied below the configured threshold.
+model RedirectSuggestion {
+  id         String   @id @default(cuid())
+  fromPath   String
+  toPath     String
+  confidence Int      @default(0)
+  reason     String?
+  // "open" | "accepted" | "dismissed"
+  status     String   @default("open")
+  source     String   @default("ai-404-recovery")
+  metadata   Json?
+  createdAt  DateTime @default(now())
+  updatedAt  DateTime @updatedAt
+
+  @@index([status])
+  @@index([fromPath])
+  @@map("actuate_redirect_suggestions")
+}
+
 model FormSubmission {
   id          String   @id @default(cuid())
   formId      String