feat(api): artifact subsystem foundation (schema + lifecycle + queue)

packages/api/migrations/0022_artifact_subsystem.sql

@@ -0,0 +1,204 @@
+-- Shared enums ---------------------------------------------------------------
+
+CREATE TYPE "artifact_status" AS ENUM (
+  'draft',
+  'in_review',
+  'changes_requested',
+  'rejected',
+  'published',
+  'cancelled',
+  'completed',
+  'expired',
+  'closed',
+  'archived'
+);--> statement-breakpoint
+
+CREATE TYPE "artifact_scope" AS ENUM (
+  'public',
+  'community',
+  'group',
+  'staff_only'
+);--> statement-breakpoint
+
+CREATE TYPE "artifact_review_decision" AS ENUM (
+  'approve',
+  'reject',
+  'request_changes'
+);--> statement-breakpoint
+
+CREATE TYPE "broadcast_channel" AS ENUM (
+  'site_banner',
+  'workspace_chat',
+  'newsletter',
+  'twitter_x',
+  'bluesky',
+  'mastodon',
+  'linkedin'
+);--> statement-breakpoint
+
+CREATE TYPE "broadcast_channel_status" AS ENUM (
+  'requested',
+  'approved',
+  'declined',
+  'posted'
+);--> statement-breakpoint
+
+CREATE TYPE "artifact_entity_type" AS ENUM (
+  'event',
+  'announcement',
+  'form',
+  'group'
+);--> statement-breakpoint
+
+-- Extend existing events table ----------------------------------------------
+-- Existing events are already live on the public site, so they default to
+-- status='published' + scope='public'. After backfill we flip the column
+-- defaults so new INSERTs default to draft/community.
+
+ALTER TABLE "events"
+  ADD COLUMN "status" "artifact_status" NOT NULL DEFAULT 'published',
+  ADD COLUMN "revision" integer NOT NULL DEFAULT 1,
+  ADD COLUMN "author_id" uuid REFERENCES "users"("id") ON DELETE SET NULL,
+  ADD COLUMN "scope" "artifact_scope" NOT NULL DEFAULT 'public',
+  ADD COLUMN "host_group_id" uuid REFERENCES "groups"("id") ON DELETE SET NULL,
+  ADD COLUMN "host_org_id" uuid REFERENCES "organizations"("id") ON DELETE SET NULL,
+  ADD COLUMN "external_url" text,
+  ADD COLUMN "thumbnail_key" text;--> statement-breakpoint
+
+ALTER TABLE "events" ALTER COLUMN "status" SET DEFAULT 'draft';--> statement-breakpoint
+ALTER TABLE "events" ALTER COLUMN "scope" SET DEFAULT 'community';--> statement-breakpoint
+
+CREATE INDEX "events_status_idx" ON "events" ("status", "created_at" DESC)
+  WHERE "deleted_at" IS NULL;--> statement-breakpoint
+
+-- announcements --------------------------------------------------------------
+
+CREATE TABLE "announcements" (
+  "id" uuid PRIMARY KEY DEFAULT gen_random_uuid(),
+  "status" "artifact_status" NOT NULL DEFAULT 'draft',
+  "revision" integer NOT NULL DEFAULT 1,
+  "author_id" uuid REFERENCES "users"("id") ON DELETE SET NULL,
+  "scope" "artifact_scope" NOT NULL DEFAULT 'community',
+  "host_group_id" uuid REFERENCES "groups"("id") ON DELETE SET NULL,
+  "host_org_id" uuid REFERENCES "organizations"("id") ON DELETE SET NULL,
+  "title" text NOT NULL,
+  "body" text NOT NULL,
+  "link_url" text,
+  "expires_at" timestamptz,
+  "thumbnail_key" text,
+  "created_at" timestamptz NOT NULL DEFAULT now(),
+  "updated_at" timestamptz NOT NULL DEFAULT now(),
+  "deleted_at" timestamptz
+);--> statement-breakpoint
+
+CREATE INDEX "announcements_status_idx" ON "announcements" ("status", "created_at" DESC)
+  WHERE "deleted_at" IS NULL;--> statement-breakpoint
+
+-- forms ----------------------------------------------------------------------
+
+CREATE TABLE "forms" (
+  "id" uuid PRIMARY KEY DEFAULT gen_random_uuid(),
+  "status" "artifact_status" NOT NULL DEFAULT 'draft',
+  "revision" integer NOT NULL DEFAULT 1,
+  "author_id" uuid REFERENCES "users"("id") ON DELETE SET NULL,
+  "scope" "artifact_scope" NOT NULL DEFAULT 'community',
+  "host_group_id" uuid REFERENCES "groups"("id") ON DELETE SET NULL,
+  "slug" text NOT NULL UNIQUE,
+  "title" text NOT NULL,
+  "description" text,
+  "schema" jsonb NOT NULL,
+  "entity_type" "artifact_entity_type",
+  "entity_id" uuid,
+  "accepts_submissions" boolean NOT NULL DEFAULT true,
+  "created_at" timestamptz NOT NULL DEFAULT now(),
+  "updated_at" timestamptz NOT NULL DEFAULT now(),
+  "deleted_at" timestamptz,
+  CONSTRAINT "forms_entity_both_or_neither"
+    CHECK (("entity_type" IS NULL) = ("entity_id" IS NULL))
+);--> statement-breakpoint
+
+CREATE INDEX "forms_status_idx" ON "forms" ("status", "created_at" DESC)
+  WHERE "deleted_at" IS NULL;--> statement-breakpoint
+
+CREATE INDEX "forms_entity_idx" ON "forms" ("entity_type", "entity_id")
+  WHERE "entity_type" IS NOT NULL;--> statement-breakpoint
+
+-- form_submissions -----------------------------------------------------------
+
+CREATE TABLE "form_submissions" (
+  "id" uuid PRIMARY KEY DEFAULT gen_random_uuid(),
+  "form_id" uuid NOT NULL REFERENCES "forms"("id") ON DELETE CASCADE,
+  "form_revision" integer NOT NULL,
+  "submitter_user_id" uuid REFERENCES "users"("id") ON DELETE SET NULL,
+  "payload" jsonb NOT NULL,
+  "submitted_at" timestamptz NOT NULL DEFAULT now()
+);--> statement-breakpoint
+
+CREATE INDEX "form_submissions_form_idx" ON "form_submissions" ("form_id", "submitted_at" DESC);--> statement-breakpoint
+
+-- artifact_reviews -----------------------------------------------------------
+
+CREATE TABLE "artifact_reviews" (
+  "id" uuid PRIMARY KEY DEFAULT gen_random_uuid(),
+  "entity_type" "artifact_entity_type" NOT NULL,
+  "entity_id" uuid NOT NULL,
+  "entity_revision" integer NOT NULL,
+  "reviewer_id" uuid NOT NULL REFERENCES "users"("id") ON DELETE RESTRICT,
+  "decision" "artifact_review_decision" NOT NULL,
+  "comment" text,
+  "created_at" timestamptz NOT NULL DEFAULT now()
+);--> statement-breakpoint
+
+CREATE INDEX "artifact_reviews_entity_idx"
+  ON "artifact_reviews" ("entity_type", "entity_id", "entity_revision");--> statement-breakpoint
+
+-- artifact_comments ----------------------------------------------------------
+
+CREATE TABLE "artifact_comments" (
+  "id" uuid PRIMARY KEY DEFAULT gen_random_uuid(),
+  "entity_type" "artifact_entity_type" NOT NULL,
+  "entity_id" uuid NOT NULL,
+  "author_id" uuid NOT NULL REFERENCES "users"("id") ON DELETE RESTRICT,
+  "body" text NOT NULL,
+  "created_at" timestamptz NOT NULL DEFAULT now()
+);--> statement-breakpoint
+
+CREATE INDEX "artifact_comments_entity_idx"
+  ON "artifact_comments" ("entity_type", "entity_id", "created_at");--> statement-breakpoint
+
+-- broadcast_requests ---------------------------------------------------------
+
+CREATE TABLE "broadcast_requests" (
+  "id" uuid PRIMARY KEY DEFAULT gen_random_uuid(),
+  "entity_type" "artifact_entity_type" NOT NULL,
+  "entity_id" uuid NOT NULL,
+  "created_by" uuid NOT NULL REFERENCES "users"("id") ON DELETE RESTRICT,
+  "created_at" timestamptz NOT NULL DEFAULT now(),
+  CONSTRAINT "broadcast_requests_unique_per_artifact"
+    UNIQUE ("entity_type", "entity_id")
+);--> statement-breakpoint
+
+-- broadcast_channels ---------------------------------------------------------
+
+CREATE TABLE "broadcast_channels" (
+  "id" uuid PRIMARY KEY DEFAULT gen_random_uuid(),
+  "broadcast_request_id" uuid NOT NULL
+    REFERENCES "broadcast_requests"("id") ON DELETE CASCADE,
+  "channel" "broadcast_channel" NOT NULL,
+  "status" "broadcast_channel_status" NOT NULL DEFAULT 'requested',
+  "decided_by" uuid REFERENCES "users"("id") ON DELETE SET NULL,
+  "decided_at" timestamptz,
+  "posted_by" uuid REFERENCES "users"("id") ON DELETE SET NULL,
+  "posted_at" timestamptz,
+  "post_url" text,
+  "decline_reason" text,
+  "prepared_text" text,
+  "prepared_image_key" text,
+  "created_at" timestamptz NOT NULL DEFAULT now(),
+  CONSTRAINT "broadcast_channels_unique_channel_per_request"
+    UNIQUE ("broadcast_request_id", "channel")
+);--> statement-breakpoint
+
+CREATE INDEX "broadcast_channels_status_idx"
+  ON "broadcast_channels" ("status", "channel")
+  WHERE "status" IN ('approved', 'posted');

packages/api/migrations/meta/_journal.json

@@ -141,6 +141,27 @@
       "when": 1778788921927,
       "tag": "0019_groups_publishable",
       "breakpoints": true
+    },
+    {
+      "idx": 20,
+      "version": "7",
+      "when": 1779043200000,
+      "tag": "0020_organizations_public_profile",
+      "breakpoints": true
+    },
+    {
+      "idx": 21,
+      "version": "7",
+      "when": 1779129600000,
+      "tag": "0021_profile_slack_username",
+      "breakpoints": true
+    },
+    {
+      "idx": 22,
+      "version": "7",
+      "when": 1779216000000,
+      "tag": "0022_artifact_subsystem",
+      "breakpoints": true
     }
   ]
 }

packages/api/src/db/schema/announcements.ts

@@ -0,0 +1,64 @@
+import { relations, sql } from "drizzle-orm";
+import {
+  index,
+  integer,
+  pgTable,
+  text,
+  timestamp,
+  uuid,
+} from "drizzle-orm/pg-core";
+import { artifactScope, artifactStatus } from "./enums";
+import { groups } from "./groups";
+import { organizations } from "./vocab";
+import { users } from "./users";
+
+export const announcements = pgTable(
+  "announcements",
+  {
+    id: uuid("id").primaryKey().defaultRandom(),
+    status: artifactStatus("status").notNull().default("draft"),
+    revision: integer("revision").notNull().default(1),
+    authorId: uuid("author_id").references(() => users.id, {
+      onDelete: "set null",
+    }),
+    scope: artifactScope("scope").notNull().default("community"),
+    hostGroupId: uuid("host_group_id").references(() => groups.id, {
+      onDelete: "set null",
+    }),
+    hostOrgId: uuid("host_org_id").references(() => organizations.id, {
+      onDelete: "set null",
+    }),
+    title: text("title").notNull(),
+    body: text("body").notNull(),
+    linkUrl: text("link_url"),
+    expiresAt: timestamp("expires_at", { withTimezone: true }),
+    thumbnailKey: text("thumbnail_key"),
+    createdAt: timestamp("created_at", { withTimezone: true })
+      .notNull()
+      .defaultNow(),
+    updatedAt: timestamp("updated_at", { withTimezone: true })
+      .notNull()
+      .defaultNow(),
+    deletedAt: timestamp("deleted_at", { withTimezone: true }),
+  },
+  (t) => [
+    index("announcements_status_idx")
+      .on(t.status, t.createdAt)
+      .where(sql`deleted_at IS NULL`),
+  ]
+);
+
+export const announcementsRelations = relations(announcements, ({ one }) => ({
+  author: one(users, {
+    fields: [announcements.authorId],
+    references: [users.id],
+  }),
+  hostGroup: one(groups, {
+    fields: [announcements.hostGroupId],
+    references: [groups.id],
+  }),
+  hostOrg: one(organizations, {
+    fields: [announcements.hostOrgId],
+    references: [organizations.id],
+  }),
+}));