@actuate-media/cms-core 0.25.1 → 0.26.0

package/prisma/schema.prisma

@@ -1,6 +1,6 @@
 generator client {
-  provider = "prisma-client"
-  output   = "../generated"
+  provider        = "prisma-client"
+  output          = "../generated"
   // `relationJoins` is the Preview-feature flag that makes
   // `relationLoadStrategy: 'join'` a recognised argument on
   // findUnique / findMany / findFirst. Without it the option is
@@ -73,6 +73,26 @@ enum AuditEvent {
   import_completed
 }
 
+enum ContentIssueType {
+  // Document is published but missing a `metaDescription` /
+  // `seoDescription` field — the dashboard surfaces these so editors
+  // can fix the SERP snippet before a competitor outranks them.
+  MISSING_META_DESCRIPTION
+  // Document HTML contains <img> tags without alt attributes. Hurts
+  // both a11y and SEO. Counted per *document* not per image — so a
+  // page with 5 alt-less images is 1 row, not 5, with `details.count`
+  // capturing the per-document count.
+  MISSING_ALT_TEXT
+  // Internal link (same-origin URL or relative path) returned 404 /
+  // 410 / DNS-failure when the link checker probed it. `details.url`
+  // holds the offending URL.
+  BROKEN_INTERNAL_LINK
+  // Published document not touched in >90 days. Encourages refresh
+  // of stale content — particularly important for "best of YEAR"
+  // posts that decay rapidly.
+  OUTDATED_CONTENT
+}
+
 enum NotificationType {
   DOCUMENT_PUBLISHED
   DOCUMENT_ASSIGNED
@@ -143,31 +163,31 @@ model User {
   createdAt     DateTime  @default(now())
   updatedAt     DateTime  @updatedAt
 
-  sessions              Session[]
-  oauthAccounts         OAuthAccount[]
-  apiKeys               ApiKey[]
-  documents             Document[]       @relation("CreatedDocuments")
-  updatedDocuments      Document[]       @relation("UpdatedDocuments")
-  versions              Version[]
-  media                 Media[]
-  contentLocks          ContentLock[]
-  notifications         InAppNotification[]
-  contentTemplates      ContentTemplate[]
-  workflowAssigned      WorkflowState[]
-  passwordResetTokens   PasswordResetToken[]
+  sessions            Session[]
+  oauthAccounts       OAuthAccount[]
+  apiKeys             ApiKey[]
+  documents           Document[]           @relation("CreatedDocuments")
+  updatedDocuments    Document[]           @relation("UpdatedDocuments")
+  versions            Version[]
+  media               Media[]
+  contentLocks        ContentLock[]
+  notifications       InAppNotification[]
+  contentTemplates    ContentTemplate[]
+  workflowAssigned    WorkflowState[]
+  passwordResetTokens PasswordResetToken[]
 
   @@map("actuate_users")
 }
 
 model OAuthAccount {
-  id                String   @id @default(cuid())
+  id                String    @id @default(cuid())
   userId            String
   provider          String
   providerAccountId String
   accessToken       String?
   refreshToken      String?
   expiresAt         DateTime?
-  createdAt         DateTime @default(now())
+  createdAt         DateTime  @default(now())
 
   user User @relation(fields: [userId], references: [id], onDelete: Cascade)
 
@@ -247,40 +267,41 @@ model Folder {
 }
 
 model Document {
-  id                    String         @id @default(cuid())
-  collection            String
-  title                 String?
-  slug                  String?
-  data                  Json
-  status                DocumentStatus @default(DRAFT)
-  locale                String?
-  localeGroupId         String?
-  createdById           String
-  updatedById           String
-  publishedAt           DateTime?
-  scheduledAt           DateTime?
-  scheduledUnpublishAt  DateTime?
-  deletedAt             DateTime?
-  searchVector          String?
-  plainText             String?
-  contentHash           String?
-  structuredData        Json?
-  contentGraph          Json?
-  siteId                String?
-  templateId            String?
-  workflowStage         WorkflowStage  @default(DRAFT)
-  reviewerId            String?
-  reviewNote            String?
-  folderId              String?
-  createdAt             DateTime       @default(now())
-  updatedAt             DateTime       @updatedAt
-
-  createdBy    User          @relation("CreatedDocuments", fields: [createdById], references: [id])
-  updatedBy    User          @relation("UpdatedDocuments", fields: [updatedById], references: [id])
-  folder       Folder?       @relation(fields: [folderId], references: [id], onDelete: SetNull)
-  versions     Version[]
-  mediaUsages  MediaUsage[]
-  contentLocks ContentLock[]
+  id                   String         @id @default(cuid())
+  collection           String
+  title                String?
+  slug                 String?
+  data                 Json
+  status               DocumentStatus @default(DRAFT)
+  locale               String?
+  localeGroupId        String?
+  createdById          String
+  updatedById          String
+  publishedAt          DateTime?
+  scheduledAt          DateTime?
+  scheduledUnpublishAt DateTime?
+  deletedAt            DateTime?
+  searchVector         String?
+  plainText            String?
+  contentHash          String?
+  structuredData       Json?
+  contentGraph         Json?
+  siteId               String?
+  templateId           String?
+  workflowStage        WorkflowStage  @default(DRAFT)
+  reviewerId           String?
+  reviewNote           String?
+  folderId             String?
+  createdAt            DateTime       @default(now())
+  updatedAt            DateTime       @updatedAt
+
+  createdBy     User           @relation("CreatedDocuments", fields: [createdById], references: [id])
+  updatedBy     User           @relation("UpdatedDocuments", fields: [updatedById], references: [id])
+  folder        Folder?        @relation(fields: [folderId], references: [id], onDelete: SetNull)
+  versions      Version[]
+  mediaUsages   MediaUsage[]
+  contentLocks  ContentLock[]
+  contentIssues ContentIssue[]
 
   @@unique([collection, slug])
   @@index([collection])
@@ -310,25 +331,25 @@ model Version {
 }
 
 model Media {
-  id           String   @id @default(cuid())
-  filename     String
-  storageKey   String   @unique
-  mimeType     String
-  fileSize     Int
-  width        Int?
-  height       Int?
-  altText      String?
-  title        String?
-  uploadedById String
-  focalPointX  Float?
-  focalPointY  Float?
-  blurHash     String?
-  aiAltText    String?
-  aiTags       Json?
+  id            String   @id @default(cuid())
+  filename      String
+  storageKey    String   @unique
+  mimeType      String
+  fileSize      Int
+  width         Int?
+  height        Int?
+  altText       String?
+  title         String?
+  uploadedById  String
+  focalPointX   Float?
+  focalPointY   Float?
+  blurHash      String?
+  aiAltText     String?
+  aiTags        Json?
   aiDescription String?
-  folderId     String?
-  createdAt    DateTime @default(now())
-  updatedAt    DateTime @updatedAt
+  folderId      String?
+  createdAt     DateTime @default(now())
+  updatedAt     DateTime @updatedAt
 
   uploadedBy  User         @relation(fields: [uploadedById], references: [id])
   folder      Folder?      @relation(fields: [folderId], references: [id], onDelete: SetNull)
@@ -478,18 +499,18 @@ model WebhookEndpoint {
 }
 
 model WebhookDeliveryLog {
-  id             String   @id @default(cuid())
+  id             String    @id @default(cuid())
   endpointId     String
   event          String
   payload        Json
-  status         String   @default("pending")
-  attempts       Int      @default(0)
-  maxAttempts    Int      @default(3)
+  status         String    @default("pending")
+  attempts       Int       @default(0)
+  maxAttempts    Int       @default(3)
   lastAttemptAt  DateTime?
   nextRetryAt    DateTime?
   responseStatus Int?
   responseBody   String?
-  createdAt      DateTime @default(now())
+  createdAt      DateTime  @default(now())
 
   endpoint WebhookEndpoint @relation(fields: [endpointId], references: [id], onDelete: Cascade)
 
@@ -561,3 +582,89 @@ model SavedSection {
   @@index([category])
   @@map("actuate_saved_sections")
 }
+
+// ─── Dashboard metrics ─────────────────────────────────────────────────────
+
+/// Per-minute pre-aggregated request counters that power the
+/// "Delivery API" dashboard tiles (request volume, error rate,
+/// average latency, p95). One row per (bucketStart × route × statusBucket).
+///
+/// Why pre-aggregated minute buckets and not per-request rows:
+///   - 24h of traffic at 10 req/s on 20 routes ≈ 17M raw rows; the
+///     equivalent minute-bucketed table is ≤ 28,800 rows (1440 × 20).
+///   - Vercel Functions are concurrency-bounded; an O(1) UPSERT per
+///     request is cheaper than O(write+query) per dashboard load.
+///   - 7-day retention is enforced by the
+///     `/api/cms/cron/api-metrics-prune` cron, so the table stays
+///     bounded.
+///
+/// `latencyHistogram` is a fixed 12-bucket log-scale array (ms):
+///   [<1, 1-2, 2-4, 4-8, 8-16, 16-32, 32-64, 64-128, 128-256,
+///    256-512, 512-1024, >1024]
+/// Cumulative-sum to estimate p95 with ~10% accuracy without
+/// per-request samples. The `delivery-stats` reader merges
+/// histograms across buckets before estimating.
+model ApiRequestMetric {
+  id               String   @id @default(cuid())
+  /// UTC minute boundary (`floor(time, '1 minute')`). The unique
+  /// constraint on `(bucketStart, route, statusBucket)` lets the
+  /// request logger UPSERT in one round-trip per request.
+  bucketStart      DateTime
+  /// Normalised request route (e.g. `/collections/posts` — never
+  /// the per-document `/collections/posts/abc123`). Normalisation
+  /// happens in `instrumentation.ts` so the cardinality stays
+  /// bounded.
+  route            String
+  /// HTTP status family — one of `2xx`, `3xx`, `4xx`, `5xx`,
+  /// `other`. Storing the bucket rather than the raw status lets
+  /// us answer "error rate?" with a single GROUP BY.
+  statusBucket     String
+  count            Int      @default(0)
+  /// Sum of `responseMs` across `count` requests. Average latency
+  /// = `sum(sumLatencyMs) / sum(count)` over the window.
+  sumLatencyMs     Float    @default(0)
+  /// Max single-request latency in this bucket. Useful as a
+  /// fast-path tail-latency indicator and as a sanity check on
+  /// the histogram estimator.
+  maxLatencyMs     Float    @default(0)
+  /// 12-bucket log-scale histogram (see model doc). Stored as
+  /// `Json` so the schema doesn't have to change when we revise
+  /// bucket boundaries.
+  latencyHistogram Json
+  updatedAt        DateTime @updatedAt
+
+  @@unique([bucketStart, route, statusBucket])
+  @@index([bucketStart])
+  @@map("actuate_api_request_metrics")
+}
+
+/// Persisted content-quality issues surfaced by the nightly
+/// content-health scan. The Dashboard's "Content Health" card
+/// aggregates these rows by `type` to produce the issue list.
+///
+/// Upsert key is `(documentId, type)` so the scanner is
+/// idempotent — re-running yields the same row count, and a row
+/// "self-resolves" by being absent from the next scan (the
+/// scanner uses a `firstScanAt`-watermark + delete pattern).
+model ContentIssue {
+  id          String           @id @default(cuid())
+  documentId  String
+  type        ContentIssueType
+  /// Per-issue count (e.g. 5 alt-less images = `count: 5` even
+  /// though it's 1 row). Lets the dashboard show real numbers
+  /// without re-scanning the document HTML on each page load.
+  count       Int              @default(1)
+  /// Type-specific payload — the broken URL, the page's
+  /// `updatedAt`, the offending image src, etc. JSON so each
+  /// issue type can carry its own shape without schema churn.
+  details     Json?
+  firstSeenAt DateTime         @default(now())
+  lastSeenAt  DateTime         @default(now())
+
+  document Document @relation(fields: [documentId], references: [id], onDelete: Cascade)
+
+  @@unique([documentId, type])
+  @@index([type])
+  @@index([documentId])
+  @@map("actuate_content_issues")
+}