@allbluecn/database 0.4.4 → 0.4.6

package/migrations/20260805174545_add_story_activity_is_ai/migration.sql

@@ -0,0 +1,2 @@
+-- AlterTable
+ALTER TABLE "story_activities" ADD COLUMN     "isAI" BOOLEAN NOT NULL DEFAULT false;

package/migrations/20260806035202_story_archived/migration.sql

@@ -0,0 +1,6 @@
+-- AlterTable
+ALTER TABLE "stories" ADD COLUMN     "archived" BOOLEAN NOT NULL DEFAULT false,
+ADD COLUMN     "archivedAt" TIMESTAMP(3);
+
+-- CreateIndex
+CREATE INDEX "stories_archived_idx" ON "stories"("archived");

package/migrations/20260806061157_builtin_independent_project/migration.sql

@@ -0,0 +1,26 @@
+-- 1. 为每个有 projectId IS NULL 的 Story 的 createdById 用户补建内置项目
+DO $$
+DECLARE uid text; pid text;
+BEGIN
+  FOR uid IN SELECT DISTINCT "createdById" FROM "stories" WHERE "projectId" IS NULL LOOP
+    INSERT INTO "projects" ("id", "displayId", "name", "icon", "ownerId", "createdAt", "updatedAt")
+    VALUES (lower(gen_random_uuid()::text), 'STORY', '独立需求', 'sprout', uid, now(), now())
+    ON CONFLICT ("ownerId", "displayId") DO NOTHING;
+
+    SELECT "id" INTO pid FROM "projects" WHERE "ownerId" = uid AND "displayId" = 'STORY';
+
+    INSERT INTO "project_members" ("id", "projectId", "userId", "role", "status", "joinedAt")
+    VALUES (lower(gen_random_uuid()::text), pid, uid, 'owner', 'active', now())
+    ON CONFLICT ("projectId", "userId") DO NOTHING;
+
+    UPDATE "stories" SET "projectId" = pid WHERE "projectId" IS NULL AND "createdById" = uid;
+  END LOOP;
+END $$;
+
+-- 2. 添加 NOT NULL 约束
+ALTER TABLE "stories" ALTER COLUMN "projectId" SET NOT NULL;
+
+-- 3. 改外键 onDelete: SET NULL → RESTRICT
+ALTER TABLE "stories" DROP CONSTRAINT "stories_projectId_fkey";
+ALTER TABLE "stories" ADD CONSTRAINT "stories_projectId_fkey"
+  FOREIGN KEY ("projectId") REFERENCES "projects"("id") ON DELETE RESTRICT ON UPDATE CASCADE;

package/migrations/20260806144250_tanstack_ai_persistence/migration.sql

@@ -0,0 +1,129 @@
+-- DropForeignKey
+ALTER TABLE "conversations" DROP CONSTRAINT "conversations_userId_fkey";
+
+-- DropForeignKey
+ALTER TABLE "messages" DROP CONSTRAINT "messages_conversationId_fkey";
+
+-- DropTable
+DROP TABLE "conversations";
+
+-- DropTable
+DROP TABLE "messages";
+
+-- CreateTable
+CREATE TABLE "chat_threads" (
+    "id" TEXT NOT NULL,
+    "userId" TEXT NOT NULL,
+    "title" TEXT,
+    "isArchived" BOOLEAN NOT NULL DEFAULT false,
+    "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updatedAt" TIMESTAMP(3) NOT NULL,
+
+    CONSTRAINT "chat_threads_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateTable
+CREATE TABLE "chat_messages" (
+    "id" TEXT NOT NULL,
+    "threadId" TEXT NOT NULL,
+    "role" TEXT NOT NULL,
+    "content" TEXT NOT NULL,
+    "parts" JSONB,
+    "thinking" TEXT,
+    "citations" JSONB,
+    "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+
+    CONSTRAINT "chat_messages_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateTable
+CREATE TABLE "chat_runs" (
+    "id" TEXT NOT NULL,
+    "threadId" TEXT NOT NULL,
+    "userId" TEXT NOT NULL,
+    "status" TEXT NOT NULL,
+    "startedAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "finishedAt" TIMESTAMP(3),
+    "detachedSince" TIMESTAMP(3),
+    "usage" JSONB,
+    "error" TEXT,
+
+    CONSTRAINT "chat_runs_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateTable
+CREATE TABLE "chat_interrupts" (
+    "id" TEXT NOT NULL,
+    "runId" TEXT NOT NULL,
+    "threadId" TEXT NOT NULL,
+    "userId" TEXT NOT NULL,
+    "kind" TEXT NOT NULL,
+    "toolName" TEXT,
+    "state" TEXT NOT NULL,
+    "payload" JSONB,
+    "resolution" JSONB,
+    "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "resolvedAt" TIMESTAMP(3),
+
+    CONSTRAINT "chat_interrupts_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateTable
+CREATE TABLE "generation_runs" (
+    "id" TEXT NOT NULL,
+    "threadId" TEXT NOT NULL,
+    "userId" TEXT NOT NULL,
+    "kind" TEXT NOT NULL,
+    "status" TEXT NOT NULL,
+    "input" JSONB,
+    "result" JSONB,
+    "artifactId" TEXT,
+    "error" TEXT,
+    "startedAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "finishedAt" TIMESTAMP(3),
+
+    CONSTRAINT "generation_runs_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateIndex
+CREATE INDEX "chat_threads_userId_updatedAt_idx" ON "chat_threads"("userId", "updatedAt");
+
+-- CreateIndex
+CREATE INDEX "chat_messages_threadId_createdAt_idx" ON "chat_messages"("threadId", "createdAt");
+
+-- CreateIndex
+CREATE INDEX "chat_runs_threadId_startedAt_idx" ON "chat_runs"("threadId", "startedAt");
+
+-- CreateIndex
+CREATE INDEX "chat_runs_userId_status_idx" ON "chat_runs"("userId", "status");
+
+-- CreateIndex
+CREATE INDEX "chat_interrupts_runId_idx" ON "chat_interrupts"("runId");
+
+-- CreateIndex
+CREATE INDEX "chat_interrupts_threadId_state_idx" ON "chat_interrupts"("threadId", "state");
+
+-- CreateIndex
+CREATE INDEX "generation_runs_threadId_startedAt_idx" ON "generation_runs"("threadId", "startedAt");
+
+-- CreateIndex
+CREATE INDEX "generation_runs_userId_status_idx" ON "generation_runs"("userId", "status");
+
+-- AddForeignKey
+ALTER TABLE "chat_threads" ADD CONSTRAINT "chat_threads_userId_fkey" FOREIGN KEY ("userId") REFERENCES "users"("id") ON DELETE CASCADE ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "chat_messages" ADD CONSTRAINT "chat_messages_threadId_fkey" FOREIGN KEY ("threadId") REFERENCES "chat_threads"("id") ON DELETE CASCADE ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "chat_runs" ADD CONSTRAINT "chat_runs_threadId_fkey" FOREIGN KEY ("threadId") REFERENCES "chat_threads"("id") ON DELETE CASCADE ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "chat_interrupts" ADD CONSTRAINT "chat_interrupts_runId_fkey" FOREIGN KEY ("runId") REFERENCES "chat_runs"("id") ON DELETE CASCADE ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "chat_interrupts" ADD CONSTRAINT "chat_interrupts_threadId_fkey" FOREIGN KEY ("threadId") REFERENCES "chat_threads"("id") ON DELETE CASCADE ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "generation_runs" ADD CONSTRAINT "generation_runs_threadId_fkey" FOREIGN KEY ("threadId") REFERENCES "chat_threads"("id") ON DELETE CASCADE ON UPDATE CASCADE;
+

package/migrations/20260809080004_add_monitoring_observability/migration.sql

@@ -0,0 +1,75 @@
+-- CreateTable
+CREATE TABLE "monitoring_request_logs" (
+    "id" TEXT NOT NULL,
+    "timestamp" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "method" VARCHAR(10) NOT NULL,
+    "path" VARCHAR(512) NOT NULL,
+    "status" INTEGER NOT NULL,
+    "duration" INTEGER NOT NULL,
+    "ip" VARCHAR(45),
+    "userAgent" TEXT,
+
+    CONSTRAINT "monitoring_request_logs_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateTable
+CREATE TABLE "monitoring_error_reports" (
+    "id" TEXT NOT NULL,
+    "timestamp" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "errorName" VARCHAR(128) NOT NULL,
+    "errorMessage" TEXT NOT NULL,
+    "stackTrace" TEXT,
+    "count" INTEGER NOT NULL DEFAULT 1,
+    "firstSeen" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "lastSeen" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "context" JSONB NOT NULL DEFAULT '{}',
+
+    CONSTRAINT "monitoring_error_reports_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateTable
+CREATE TABLE "monitoring_metrics_snapshots" (
+    "id" TEXT NOT NULL,
+    "recordedAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "metricName" VARCHAR(256) NOT NULL,
+    "count" INTEGER NOT NULL,
+    "avg" DOUBLE PRECISION NOT NULL,
+    "p50" DOUBLE PRECISION NOT NULL,
+    "p95" DOUBLE PRECISION NOT NULL,
+    "p99" DOUBLE PRECISION NOT NULL,
+    "min" DOUBLE PRECISION NOT NULL,
+    "max" DOUBLE PRECISION NOT NULL,
+
+    CONSTRAINT "monitoring_metrics_snapshots_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateTable
+CREATE TABLE "monitoring_health_snapshots" (
+    "id" TEXT NOT NULL,
+    "timestamp" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "status" VARCHAR(16) NOT NULL,
+    "uptimeSeconds" DOUBLE PRECISION NOT NULL,
+    "memoryUsage" JSONB NOT NULL,
+    "dbStatus" VARCHAR(16) NOT NULL,
+    "dbLatencyMs" INTEGER,
+
+    CONSTRAINT "monitoring_health_snapshots_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateIndex
+CREATE INDEX "idx_request_log_timestamp" ON "monitoring_request_logs"("timestamp");
+
+-- CreateIndex
+CREATE INDEX "idx_request_log_path_ts" ON "monitoring_request_logs"("path", "timestamp");
+
+-- CreateIndex
+CREATE INDEX "idx_error_report_name" ON "monitoring_error_reports"("errorName");
+
+-- CreateIndex
+CREATE INDEX "idx_error_report_last_seen" ON "monitoring_error_reports"("lastSeen");
+
+-- CreateIndex
+CREATE INDEX "idx_metrics_name_ts" ON "monitoring_metrics_snapshots"("metricName", "recordedAt");
+
+-- CreateIndex
+CREATE INDEX "idx_health_snapshot_ts" ON "monitoring_health_snapshots"("timestamp");

package/migrations/20260811112502_add_workspace/migration.sql

@@ -0,0 +1,89 @@
+-- AlterTable
+ALTER TABLE "projects" ADD COLUMN     "workspaceId" TEXT;
+
+-- CreateTable
+CREATE TABLE "workspaces" (
+    "id" TEXT NOT NULL,
+    "name" TEXT NOT NULL,
+    "icon" TEXT NOT NULL DEFAULT 'folder',
+    "description" TEXT,
+    "ownerId" TEXT NOT NULL,
+    "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updatedAt" TIMESTAMP(3) NOT NULL,
+
+    CONSTRAINT "workspaces_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateTable
+CREATE TABLE "workspace_members" (
+    "id" TEXT NOT NULL,
+    "workspaceId" TEXT NOT NULL,
+    "userId" TEXT NOT NULL,
+    "role" TEXT NOT NULL DEFAULT 'member',
+    "status" TEXT NOT NULL DEFAULT 'invited',
+    "joinedAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+
+    CONSTRAINT "workspace_members_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateIndex
+CREATE INDEX "workspaces_ownerId_idx" ON "workspaces"("ownerId");
+
+-- CreateIndex
+CREATE INDEX "workspace_members_workspaceId_idx" ON "workspace_members"("workspaceId");
+
+-- CreateIndex
+CREATE INDEX "workspace_members_userId_idx" ON "workspace_members"("userId");
+
+-- CreateIndex
+CREATE UNIQUE INDEX "workspace_members_workspaceId_userId_key" ON "workspace_members"("workspaceId", "userId");
+
+-- CreateIndex
+CREATE INDEX "projects_workspaceId_idx" ON "projects"("workspaceId");
+
+-- AddForeignKey
+ALTER TABLE "projects" ADD CONSTRAINT "projects_workspaceId_fkey" FOREIGN KEY ("workspaceId") REFERENCES "workspaces"("id") ON DELETE SET NULL ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "workspaces" ADD CONSTRAINT "workspaces_ownerId_fkey" FOREIGN KEY ("ownerId") REFERENCES "users"("id") ON DELETE RESTRICT ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "workspace_members" ADD CONSTRAINT "workspace_members_workspaceId_fkey" FOREIGN KEY ("workspaceId") REFERENCES "workspaces"("id") ON DELETE CASCADE ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "workspace_members" ADD CONSTRAINT "workspace_members_userId_fkey" FOREIGN KEY ("userId") REFERENCES "users"("id") ON DELETE CASCADE ON UPDATE CASCADE;
+
+-- Backfill: 为每个有项目且 workspaceId 为 null 的 owner 创建一个默认工作空间
+INSERT INTO "workspaces" ("id", "name", "icon", "description", "ownerId", "createdAt", "updatedAt")
+SELECT
+  gen_random_uuid()::text,
+  COALESCE(u."username", split_part(u."email", '@', 1)) || ' 的工作空间',
+  'folder',
+  '系统自动创建的默认工作空间',
+  p."ownerId",
+  NOW(),
+  NOW()
+FROM (SELECT DISTINCT "ownerId" FROM "projects" WHERE "workspaceId" IS NULL) p
+JOIN "users" u ON u."id" = p."ownerId"
+WHERE NOT EXISTS (
+  SELECT 1 FROM "workspaces" w
+  WHERE w."ownerId" = p."ownerId" AND w."description" = '系统自动创建的默认工作空间'
+);
+
+-- Backfill: 回填 project.workspaceId
+UPDATE "projects"
+SET "workspaceId" = (
+  SELECT "id" FROM "workspaces"
+  WHERE "ownerId" = "projects"."ownerId"
+    AND "description" = '系统自动创建的默认工作空间'
+  LIMIT 1
+)
+WHERE "workspaceId" IS NULL;
+
+-- Backfill: 把每个默认工作空间的 owner 加入为 owner 角色
+INSERT INTO "workspace_members" ("id", "workspaceId", "userId", "role", "status", "joinedAt")
+SELECT gen_random_uuid()::text, w."id", w."ownerId", 'owner', 'active', NOW()
+FROM "workspaces" w
+WHERE NOT EXISTS (
+  SELECT 1 FROM "workspace_members" wm WHERE wm."workspaceId" = w."id"
+);

package/migrations/20260811153719_add_hosted_ai_tables/migration.sql

@@ -0,0 +1,119 @@
+-- CreateEnum
+CREATE TYPE "SubscriptionStatus" AS ENUM ('TRIALING', 'ACTIVE', 'PAST_DUE', 'CANCELED', 'EXPIRED', 'UNPAID');
+
+-- CreateEnum
+CREATE TYPE "UsageMetric" AS ENUM ('AI_CALL', 'STORAGE_MB', 'SEAT');
+
+-- CreateTable
+CREATE TABLE "plans" (
+    "id" TEXT NOT NULL,
+    "name" TEXT NOT NULL,
+    "displayName" TEXT NOT NULL,
+    "description" TEXT,
+    "priceMonthly" INTEGER NOT NULL DEFAULT 0,
+    "priceYearly" INTEGER,
+    "currency" TEXT NOT NULL DEFAULT 'usd',
+    "maxSeats" INTEGER,
+    "maxWorkspaces" INTEGER,
+    "aiQuotaMonthly" INTEGER,
+    "features" JSONB NOT NULL,
+    "isPublic" BOOLEAN NOT NULL DEFAULT true,
+    "sortOrder" INTEGER NOT NULL DEFAULT 0,
+    "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updatedAt" TIMESTAMP(3) NOT NULL,
+
+    CONSTRAINT "plans_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateTable
+CREATE TABLE "subscriptions" (
+    "id" TEXT NOT NULL,
+    "workspaceId" TEXT NOT NULL,
+    "planId" TEXT NOT NULL,
+    "status" "SubscriptionStatus" NOT NULL DEFAULT 'ACTIVE',
+    "seats" INTEGER NOT NULL DEFAULT 1,
+    "stripeCustomerId" TEXT,
+    "stripeSubscriptionId" TEXT,
+    "stripePriceId" TEXT,
+    "currentPeriodStart" TIMESTAMP(3),
+    "currentPeriodEnd" TIMESTAMP(3),
+    "cancelAtPeriodEnd" BOOLEAN NOT NULL DEFAULT false,
+    "canceledAt" TIMESTAMP(3),
+    "trialEndsAt" TIMESTAMP(3),
+    "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updatedAt" TIMESTAMP(3) NOT NULL,
+
+    CONSTRAINT "subscriptions_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateTable
+CREATE TABLE "usage_records" (
+    "id" TEXT NOT NULL,
+    "workspaceId" TEXT NOT NULL,
+    "metric" "UsageMetric" NOT NULL,
+    "period" TEXT NOT NULL,
+    "count" INTEGER NOT NULL DEFAULT 0,
+    "resetAt" TIMESTAMP(3) NOT NULL,
+    "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updatedAt" TIMESTAMP(3) NOT NULL,
+
+    CONSTRAINT "usage_records_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateTable
+CREATE TABLE "ai_usage_logs" (
+    "id" TEXT NOT NULL,
+    "workspaceId" TEXT NOT NULL,
+    "userId" TEXT NOT NULL,
+    "source" TEXT NOT NULL DEFAULT 'byok',
+    "provider" TEXT NOT NULL,
+    "model" TEXT NOT NULL,
+    "inputTokens" INTEGER NOT NULL DEFAULT 0,
+    "outputTokens" INTEGER NOT NULL DEFAULT 0,
+    "costUsd" DECIMAL(10,6),
+    "success" BOOLEAN NOT NULL DEFAULT true,
+    "errorMessage" TEXT,
+    "durationMs" INTEGER,
+    "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+
+    CONSTRAINT "ai_usage_logs_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateIndex
+CREATE UNIQUE INDEX "plans_name_key" ON "plans"("name");
+
+-- CreateIndex
+CREATE UNIQUE INDEX "subscriptions_workspaceId_key" ON "subscriptions"("workspaceId");
+
+-- CreateIndex
+CREATE INDEX "usage_records_workspaceId_metric_idx" ON "usage_records"("workspaceId", "metric");
+
+-- CreateIndex
+CREATE UNIQUE INDEX "usage_records_workspaceId_metric_period_key" ON "usage_records"("workspaceId", "metric", "period");
+
+-- CreateIndex
+CREATE INDEX "ai_usage_logs_workspaceId_createdAt_idx" ON "ai_usage_logs"("workspaceId", "createdAt");
+
+-- CreateIndex
+CREATE INDEX "ai_usage_logs_userId_createdAt_idx" ON "ai_usage_logs"("userId", "createdAt");
+
+-- CreateIndex
+CREATE INDEX "ai_usage_logs_workspaceId_source_createdAt_idx" ON "ai_usage_logs"("workspaceId", "source", "createdAt");
+
+-- CreateIndex
+CREATE INDEX "ai_usage_logs_workspaceId_success_createdAt_idx" ON "ai_usage_logs"("workspaceId", "success", "createdAt");
+
+-- AddForeignKey
+ALTER TABLE "subscriptions" ADD CONSTRAINT "subscriptions_workspaceId_fkey" FOREIGN KEY ("workspaceId") REFERENCES "workspaces"("id") ON DELETE RESTRICT ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "subscriptions" ADD CONSTRAINT "subscriptions_planId_fkey" FOREIGN KEY ("planId") REFERENCES "plans"("id") ON DELETE RESTRICT ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "usage_records" ADD CONSTRAINT "usage_records_workspaceId_fkey" FOREIGN KEY ("workspaceId") REFERENCES "workspaces"("id") ON DELETE RESTRICT ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "ai_usage_logs" ADD CONSTRAINT "ai_usage_logs_workspaceId_fkey" FOREIGN KEY ("workspaceId") REFERENCES "workspaces"("id") ON DELETE RESTRICT ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "ai_usage_logs" ADD CONSTRAINT "ai_usage_logs_userId_fkey" FOREIGN KEY ("userId") REFERENCES "users"("id") ON DELETE RESTRICT ON UPDATE CASCADE;

package/migrations/20260812043944_add_billing_tables/migration.sql

@@ -0,0 +1,86 @@
+-- 幂等化迁移：子项目 3 新增 Invoice/StripeEvent 表 + Plan/User/Subscription 字段
+
+-- 为 Plan 表添加 Stripe 字段（幂等：列已存在则跳过）
+DO $$
+BEGIN
+  IF NOT EXISTS (SELECT 1 FROM information_schema.columns WHERE table_name = 'plans' AND column_name = 'stripeProductId') THEN
+    ALTER TABLE "plans" ADD COLUMN "stripeProductId" TEXT;
+  END IF;
+  IF NOT EXISTS (SELECT 1 FROM information_schema.columns WHERE table_name = 'plans' AND column_name = 'stripePriceIdUsd') THEN
+    ALTER TABLE "plans" ADD COLUMN "stripePriceIdUsd" TEXT;
+  END IF;
+  IF NOT EXISTS (SELECT 1 FROM information_schema.columns WHERE table_name = 'plans' AND column_name = 'stripePriceIdCny') THEN
+    ALTER TABLE "plans" ADD COLUMN "stripePriceIdCny" TEXT;
+  END IF;
+  IF NOT EXISTS (SELECT 1 FROM information_schema.columns WHERE table_name = 'plans' AND column_name = 'stripePriceIdUsdYearly') THEN
+    ALTER TABLE "plans" ADD COLUMN "stripePriceIdUsdYearly" TEXT;
+  END IF;
+  IF NOT EXISTS (SELECT 1 FROM information_schema.columns WHERE table_name = 'plans' AND column_name = 'stripePriceIdCnyYearly') THEN
+    ALTER TABLE "plans" ADD COLUMN "stripePriceIdCnyYearly" TEXT;
+  END IF;
+END $$;
+
+-- 为 User 表添加 preferredCurrency（幂等）
+DO $$
+BEGIN
+  IF NOT EXISTS (SELECT 1 FROM information_schema.columns WHERE table_name = 'users' AND column_name = 'preferredCurrency') THEN
+    ALTER TABLE "users" ADD COLUMN "preferredCurrency" TEXT NOT NULL DEFAULT 'usd';
+  END IF;
+END $$;
+
+-- 创建 Invoice 表（幂等）
+CREATE TABLE IF NOT EXISTS "invoices" (
+    "id" TEXT NOT NULL,
+    "subscriptionId" TEXT NOT NULL,
+    "stripeInvoiceId" TEXT NOT NULL,
+    "stripeEventId" TEXT,
+    "amountDue" INTEGER NOT NULL,
+    "amountPaid" INTEGER NOT NULL,
+    "currency" TEXT NOT NULL DEFAULT 'usd',
+    "status" TEXT NOT NULL,
+    "pdfUrl" TEXT,
+    "hostedInvoiceUrl" TEXT,
+    "periodStart" TIMESTAMP(3) NOT NULL,
+    "periodEnd" TIMESTAMP(3) NOT NULL,
+    "paidAt" TIMESTAMP(3),
+    "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+
+    CONSTRAINT "invoices_pkey" PRIMARY KEY ("id")
+);
+
+-- 创建 StripeEvent 表（幂等）
+CREATE TABLE IF NOT EXISTS "stripe_events" (
+    "id" TEXT NOT NULL,
+    "stripeEventId" TEXT NOT NULL,
+    "type" TEXT NOT NULL,
+    "status" TEXT NOT NULL DEFAULT 'processing',
+    "payload" JSONB,
+    "errorMessage" TEXT,
+    "processedAt" TIMESTAMP(3),
+    "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+
+    CONSTRAINT "stripe_events_pkey" PRIMARY KEY ("id")
+);
+
+-- 创建唯一索引（幂等）
+CREATE UNIQUE INDEX IF NOT EXISTS "invoices_stripeInvoiceId_key" ON "invoices"("stripeInvoiceId");
+CREATE UNIQUE INDEX IF NOT EXISTS "stripe_events_stripeEventId_key" ON "stripe_events"("stripeEventId");
+
+-- 创建普通索引（幂等）
+CREATE INDEX IF NOT EXISTS "invoices_subscriptionId_createdAt_idx" ON "invoices"("subscriptionId", "createdAt");
+CREATE INDEX IF NOT EXISTS "stripe_events_type_createdAt_idx" ON "stripe_events"("type", "createdAt");
+
+-- 添加外键（幂等：已存在则跳过）
+DO $$
+BEGIN
+  IF NOT EXISTS (
+    SELECT 1 FROM information_schema.table_constraints
+    WHERE constraint_name = 'invoices_subscriptionId_fkey'
+  ) THEN
+    ALTER TABLE "invoices"
+    ADD CONSTRAINT "invoices_subscriptionId_fkey"
+    FOREIGN KEY ("subscriptionId")
+    REFERENCES "subscriptions"("id")
+    ON DELETE RESTRICT ON UPDATE CASCADE;
+  END IF;
+END $$;

package/migrations/20260813040200_sub3_stripe_subscription_unique/migration.sql

@@ -0,0 +1,6 @@
+-- 子项目 3: stripeSubscriptionId 添加 @unique 约束
+-- 用于 webhook 反查订阅（subscription.ts syncSubscriptionFromStripe）
+-- 字段可空（free plan 无 Stripe 订阅），但非空值必须唯一
+
+CREATE UNIQUE INDEX IF NOT EXISTS "subscriptions_stripeSubscriptionId_key"
+ON "subscriptions"("stripeSubscriptionId");