feat: implement TASK-WP5-07 preview grant lifecycle

apps/api/src/app.ts

@@ -10,7 +10,6 @@ import {
   AccountProfileUpdateResponseSchema,
   AccountSettingsResponseSchema,
   AdminAuthenticatedUserSchema,
-  AdminOverviewResponseSchema,
   AdminCreditParamsSchema,
   AdminLoginCompleteRequestSchema,
   AdminLoginCompleteResponseSchema,
@@ -111,7 +110,6 @@ import {
   type BootstrapResponse,
   type AdminLoginCompleteRequest,
   type AdminLoginSendRequest,
-  type AdminOverviewResponse,
   type AccountDeletionCompleteRequest,
   type AccountProfileUpdateRequest,
   type AdminCreditParams,
@@ -176,6 +174,7 @@ import {
   registrationFieldError,
 } from "./registration-errors.js";
 import type { RegistrationService } from "./registration.js";
+import type { AssetPreviewGrantService } from "./preview-grants.js";
 import type { RecentAssetService } from "./recent-assets.js";
 import type { AmapAdapter } from "./amap-adapter.js";
 import { ModelConfigurationError } from "./model-configuration.js";
@@ -194,7 +193,6 @@ const defaultBootstrap: BootstrapResponse = {
 };
 
 export interface CreateAppOptions {
-  adminOverview?: () => AdminOverviewResponse | Promise<AdminOverviewResponse>;
   amap?: AmapAdapter;
   assetReleases?: AssetReleaseReader;
   bootstrap?: () => BootstrapResponse | Promise<BootstrapResponse>;
@@ -215,6 +213,7 @@ export interface CreateAppOptions {
     resourceId: string;
     userId: string;
   }) => boolean | Promise<boolean>;
+  previewGrants?: AssetPreviewGrantService;
   privateAssetAdminAuthorizer?: (input: {
     adminUserId: string;
     ownerId: string;
@@ -691,7 +690,6 @@ export async function createApp(options: CreateAppOptions = {}) {
     AdminLoginCompleteRequestSchema,
     AdminLoginCompleteResponseSchema,
     AdminSessionResponseSchema,
-    AdminOverviewResponseSchema,
     CreditSummarySchema,
     CreditEntryTypeSchema,
     CreditEntryStatusSchema,
@@ -875,6 +873,13 @@ export async function createApp(options: CreateAppOptions = {}) {
       const session = token ? options.registration.readUserSession(token) : undefined;
       if (!session) return reply.code(401).send(createErrorEnvelope({ code: "AUTH_SESSION_INVALID", correlationId: request.id }));
       const { resourceVersion } = request.params as { resourceVersion: string };
+      if (options.previewGrants) {
+        const manifest = options.previewGrants.projectManifest({ releaseVersion: resourceVersion, userId: session.userId });
+        if (!manifest) return reply.code(404).send();
+        reply.header("Cache-Control", "private, no-store");
+        reply.header("Vary", "Cookie");
+        return manifest;
+      }
       const available = options.assetReleases?.project("internal_preview_asset", resourceVersion);
       if (!available || !options.previewAssetAuthorizer) return reply.code(404).send();
       const authorizedIds: string[] = [];
@@ -905,6 +910,19 @@ export async function createApp(options: CreateAppOptions = {}) {
       const session = token ? options.registration.readUserSession(token) : undefined;
       if (!session) return reply.code(401).send(createErrorEnvelope({ code: "AUTH_SESSION_INVALID", correlationId: request.id }));
       const { assetId, resourceVersion } = request.params as { assetId: string; resourceVersion: string };
+      if (options.previewGrants) {
+        const resource = options.previewGrants.readManifestItem({
+          manifestItemId: assetId,
+          releaseVersion: resourceVersion,
+          userId: session.userId,
+        });
+        if (!resource) return reply.code(404).send();
+        reply.type(resource.mimeType);
+        reply.header("Cache-Control", "private, no-store");
+        reply.header("Content-Disposition", "inline");
+        reply.header("Vary", "Cookie");
+        return resource.bytes;
+      }
       const authorized = await options.previewAssetAuthorizer?.({ resourceId: assetId, releaseVersion: resourceVersion, userId: session.userId });
       const resource = authorized ? options.assetReleases?.read("internal_preview_asset", resourceVersion, assetId) : undefined;
       if (!resource) return reply.code(404).send();
@@ -1207,35 +1225,6 @@ export async function createApp(options: CreateAppOptions = {}) {
     },
   );
 
-  app.get(
-    "/api/v1/admin/overview",
-    {
-      schema: {
-        operationId: "getAdminOverview",
-        response: {
-          200: Type.Ref(AdminOverviewResponseSchema),
-          401: Type.Ref(ErrorEnvelopeSchema),
-          503: Type.Null(),
-        },
-        tags: ["Admin Operations"],
-      },
-    },
-    async (request, reply) => {
-      if (!options.registration) return reply.code(503).send(null);
-      const token = cookieValue(headerValue(request.headers.cookie), adminSessionCookieName);
-      const session = token ? options.registration.readAdminSession(token) : undefined;
-      if (!session) {
-        return reply.code(401).send(createErrorEnvelope({ code: "AUTH_SESSION_INVALID", correlationId: request.id }));
-      }
-      if (!options.adminOverview) return reply.code(503).send(null);
-      try {
-        return await options.adminOverview();
-      } catch {
-        return reply.code(503).send(null);
-      }
-    },
-  );
-
   app.post(
     "/api/v1/auth/login/send",
     {

apps/api/src/preview-grants.ts

@@ -0,0 +1,483 @@
+import { createHash, randomUUID } from "node:crypto";
+
+import type {
+  AssetReleaseManifestItem,
+  AssetReleaseManifestProjection,
+  AssetReleaseReader,
+} from "@dada/asset-release-manifest";
+
+import { auditRetentionMilliseconds, serializeAuditSummary } from "./audit-policy.js";
+import type { RegistrationService } from "./registration.js";
+
+export type PreviewBatchStatus = "active" | "closed";
+export type PreviewGrantStatus = "active" | "revoked" | "expired";
+
+export interface PreviewBatchView {
+  batchId: string;
+  createdAt: number;
+  createdBy: string;
+  name: string;
+  status: PreviewBatchStatus;
+}
+
+export interface PreviewGrantView {
+  batchId: string;
+  expiresAt: number;
+  grantId: string;
+  grantedAt: number;
+  grantedBy: string;
+  status: PreviewGrantStatus;
+  userId: string;
+}
+
+export class PreviewGrantError extends Error {
+  constructor(
+    public readonly reason:
+      | "admin_invalid"
+      | "batch_closed"
+      | "batch_not_found"
+      | "grant_not_found"
+      | "invalid_expiry"
+      | "invalid_request"
+      | "resource_not_found"
+      | "user_not_eligible",
+  ) {
+    super(reason);
+    this.name = "PreviewGrantError";
+  }
+}
+
+interface PreviewGrantServiceOptions {
+  assetReleases: AssetReleaseReader;
+  clock?: () => number;
+  registration: RegistrationService;
+}
+
+interface PreviewManifestItemMapping {
+  releaseVersion: string;
+  resourceId: string;
+  userId: string;
+}
+
+function isUuid(value: string) {
+  return /^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i.test(value);
+}
+
+function assertText(value: string, name: string) {
+  const normalized = value.trim();
+  if (!normalized || normalized.length > 160) throw new PreviewGrantError("invalid_request");
+  if (name === "batchId" && !isUuid(normalized)) throw new PreviewGrantError("invalid_request");
+  return normalized;
+}
+
+function manifestHash(items: readonly AssetReleaseManifestItem[], releaseVersion: string) {
+  return createHash("sha256")
+    .update(JSON.stringify({
+      items,
+      release_version: releaseVersion,
+      schema_version: "AssetReleaseManifest/v1",
+    }))
+    .digest("hex");
+}
+
+/**
+ * Owns the P0-A preview grant state. Preview URLs are deliberately ephemeral:
+ * the random item id is kept only in this process and every read rechecks the
+ * persisted grant, so revocation and expiry take effect without cache busting.
+ */
+export class AssetPreviewGrantService {
+  readonly database: RegistrationService["database"];
+  readonly options: Required<Pick<PreviewGrantServiceOptions, "clock">> & PreviewGrantServiceOptions;
+  private readonly itemMappings = new Map<string, PreviewManifestItemMapping>();
+
+  constructor(options: PreviewGrantServiceOptions) {
+    this.database = options.registration.database;
+    this.options = { ...options, clock: options.clock ?? Date.now };
+    this.migrate();
+  }
+
+  createBatch(input: { adminUserId: string; batchId?: string; name: string }): PreviewBatchView {
+    const adminUserId = assertText(input.adminUserId, "adminUserId");
+    const name = assertText(input.name, "name");
+    const batchId = input.batchId ? assertText(input.batchId, "batchId") : randomUUID();
+    const now = this.options.clock();
+    this.assertAdmin(adminUserId, now);
+    this.immediate(() => {
+      this.database.prepare(`
+        INSERT INTO test_batches (batch_id, name, status, created_by, created_at, closed_at)
+        VALUES (?, ?, 'active', ?, ?, NULL)
+      `).run(batchId, name, adminUserId, now);
+      this.audit({
+        actorRef: adminUserId,
+        afterSummary: { batch_id: batchId, status: "active" },
+        beforeSummary: null,
+        operationType: "preview_batch_create",
+        targetRef: batchId,
+        targetType: "preview_batch",
+      }, now);
+    });
+    return { batchId, createdAt: now, createdBy: adminUserId, name, status: "active" };
+  }
+
+  closeBatch(input: { adminUserId: string; batchId: string }): PreviewBatchView {
+    const adminUserId = assertText(input.adminUserId, "adminUserId");
+    const batchId = assertText(input.batchId, "batchId");
+    const now = this.options.clock();
+    this.assertAdmin(adminUserId, now);
+    return this.immediate(() => {
+      const batch = this.readBatch(batchId);
+      if (!batch) throw new PreviewGrantError("batch_not_found");
+      if (batch.status === "active") {
+        this.database.prepare("UPDATE test_batches SET status = 'closed', closed_at = ? WHERE batch_id = ?").run(now, batchId);
+        this.audit({
+          actorRef: adminUserId,
+          afterSummary: { batch_id: batchId, status: "closed" },
+          beforeSummary: { batch_id: batchId, status: batch.status },
+          operationType: "preview_batch_close",
+          targetRef: batchId,
+          targetType: "preview_batch",
+        }, now);
+      }
+      return { ...batch, status: "closed" as const };
+    });
+  }
+
+  addBatchItems(input: {
+    adminUserId: string;
+    batchId: string;
+    releaseVersion: string;
+    resourceIds: readonly string[];
+  }) {
+    const adminUserId = assertText(input.adminUserId, "adminUserId");
+    const batchId = assertText(input.batchId, "batchId");
+    const releaseVersion = assertText(input.releaseVersion, "releaseVersion");
+    const resourceIds = [...new Set(input.resourceIds.map((resourceId) => assertText(resourceId, "resourceId")))];
+    if (resourceIds.length === 0) throw new PreviewGrantError("invalid_request");
+    const now = this.options.clock();
+    this.assertAdmin(adminUserId, now);
+    for (const resourceId of resourceIds) {
+      if (!this.options.assetReleases.read("internal_preview_asset", releaseVersion, resourceId)) {
+        throw new PreviewGrantError("resource_not_found");
+      }
+    }
+    this.immediate(() => {
+      const batch = this.readBatch(batchId);
+      if (!batch) throw new PreviewGrantError("batch_not_found");
+      if (batch.status !== "active") throw new PreviewGrantError("batch_closed");
+      const insert = this.database.prepare(`
+        INSERT OR IGNORE INTO test_batch_items (test_batch_id, release_version, resource_id)
+        VALUES (?, ?, ?)
+      `);
+      for (const resourceId of resourceIds) insert.run(batchId, releaseVersion, resourceId);
+      this.audit({
+        actorRef: adminUserId,
+        afterSummary: { batch_id: batchId, item_count: resourceIds.length, release_version: releaseVersion },
+        beforeSummary: null,
+        operationType: "preview_batch_items_add",
+        targetRef: batchId,
+        targetType: "preview_batch",
+      }, now);
+    });
+    return { batchId, releaseVersion, resourceIds };
+  }
+
+  grant(input: {
+    adminUserId: string;
+    batchId: string;
+    expiresAt: number;
+    userId: string;
+  }): PreviewGrantView {
+    const adminUserId = assertText(input.adminUserId, "adminUserId");
+    const batchId = assertText(input.batchId, "batchId");
+    const userId = assertText(input.userId, "userId");
+    if (!isUuid(userId)) throw new PreviewGrantError("invalid_request");
+    const now = this.options.clock();
+    if (!Number.isSafeInteger(input.expiresAt) || input.expiresAt <= now) throw new PreviewGrantError("invalid_expiry");
+    this.assertAdmin(adminUserId, now);
+    return this.immediate(() => {
+      const batch = this.readBatch(batchId);
+      if (!batch) throw new PreviewGrantError("batch_not_found");
+      if (batch.status !== "active") throw new PreviewGrantError("batch_closed");
+      const user = this.database.prepare("SELECT role, status FROM users WHERE user_id = ?").get(userId) as { role: string; status: string } | undefined;
+      if (!user || user.role !== "user" || user.status !== "active") throw new PreviewGrantError("user_not_eligible");
+      const grantId = randomUUID();
+      this.database.prepare(`
+        INSERT INTO asset_preview_grants (
+          grant_id, user_id, test_batch_id, granted_by, granted_at, expires_at, status
+        ) VALUES (?, ?, ?, ?, ?, ?, 'active')
+      `).run(grantId, userId, batchId, adminUserId, now, input.expiresAt);
+      this.audit({
+        actorRef: adminUserId,
+        afterSummary: { batch_id: batchId, expires_at: input.expiresAt, grant_id: grantId, status: "active", user_id: userId },
+        beforeSummary: null,
+        operationType: "preview_grant_create",
+        targetRef: grantId,
+        targetType: "preview_grant",
+      }, now);
+      return {
+        batchId,
+        expiresAt: input.expiresAt,
+        grantId,
+        grantedAt: now,
+        grantedBy: adminUserId,
+        status: "active" as const,
+        userId,
+      };
+    });
+  }
+
+  revoke(input: { adminUserId: string; grantId: string }): PreviewGrantView {
+    const adminUserId = assertText(input.adminUserId, "adminUserId");
+    const grantId = assertText(input.grantId, "grantId");
+    const now = this.options.clock();
+    this.assertAdmin(adminUserId, now);
+    return this.immediate(() => {
+      this.expireDue(now);
+      const grant = this.readGrant(grantId);
+      if (!grant) throw new PreviewGrantError("grant_not_found");
+      if (grant.status === "active") {
+        this.database.prepare("UPDATE asset_preview_grants SET status = 'revoked' WHERE grant_id = ? AND status = 'active'").run(grantId);
+        this.audit({
+          actorRef: adminUserId,
+          afterSummary: { grant_id: grantId, status: "revoked" },
+          beforeSummary: { grant_id: grantId, status: grant.status },
+          operationType: "preview_grant_revoke",
+          targetRef: grantId,
+          targetType: "preview_grant",
+        }, now);
+      }
+      return { ...grant, status: "revoked" as const };
+    });
+  }
+
+  listBatches(input: { adminUserId: string }): PreviewBatchView[] {
+    const adminUserId = assertText(input.adminUserId, "adminUserId");
+    this.assertAdmin(adminUserId, this.options.clock());
+    return (this.database.prepare(`
+      SELECT batch_id, name, status, created_by, created_at
+      FROM test_batches ORDER BY created_at DESC, batch_id DESC
+    `).all() as Array<{ batch_id: string; created_at: number; created_by: string; name: string; status: PreviewBatchStatus }>).map((row) => ({
+      batchId: row.batch_id,
+      createdAt: row.created_at,
+      createdBy: row.created_by,
+      name: row.name,
+      status: row.status,
+    }));
+  }
+
+  listGrants(input: { adminUserId: string; batchId?: string; userId?: string }): PreviewGrantView[] {
+    const adminUserId = assertText(input.adminUserId, "adminUserId");
+    this.assertAdmin(adminUserId, this.options.clock());
+    const batchId = input.batchId ? assertText(input.batchId, "batchId") : undefined;
+    const userId = input.userId ? assertText(input.userId, "userId") : undefined;
+    const now = this.options.clock();
+    return this.immediate(() => {
+      this.expireDue(now);
+      const rows = this.database.prepare(`
+        SELECT grant_id, user_id, test_batch_id, granted_by, granted_at, expires_at, status
+        FROM asset_preview_grants
+        WHERE (? IS NULL OR test_batch_id = ?) AND (? IS NULL OR user_id = ?)
+        ORDER BY granted_at DESC, grant_id DESC
+      `).all(batchId ?? null, batchId ?? null, userId ?? null, userId ?? null) as Array<{
+        expires_at: number; grant_id: string; granted_at: number; granted_by: string;
+        status: PreviewGrantStatus; test_batch_id: string; user_id: string;
+      }>;
+      return rows.map((row) => ({
+        batchId: row.test_batch_id,
+        expiresAt: row.expires_at,
+        grantId: row.grant_id,
+        grantedAt: row.granted_at,
+        grantedBy: row.granted_by,
+        status: row.status,
+        userId: row.user_id,
+      }));
+    });
+  }
+
+  projectManifest(input: { releaseVersion: string; userId: string }): AssetReleaseManifestProjection | undefined {
+    const releaseVersion = assertText(input.releaseVersion, "releaseVersion");
+    const userId = assertText(input.userId, "userId");
+    const base = this.options.assetReleases.project("internal_preview_asset", releaseVersion);
+    if (!base) return undefined;
+    const authorized = base.items.filter((item) => this.authorizeAsset({ releaseVersion, resourceId: item.resource_id, userId }));
+    if (authorized.length === 0) return undefined;
+    const items = authorized.map((item) => {
+      const manifestItemId = randomUUID();
+      const mapped: AssetReleaseManifestItem = {
+        ...item,
+        resource_id: manifestItemId,
+        url: `/api/v1/assets/preview/${releaseVersion}/${manifestItemId}`,
+      };
+      this.itemMappings.set(manifestItemId, {
+        releaseVersion,
+        resourceId: item.resource_id,
+        userId,
+      });
+      return mapped;
+    });
+    return Object.freeze({
+      items: Object.freeze(items.map((item) => Object.freeze(item))),
+      manifest_sha256: manifestHash(items, releaseVersion),
+      release_version: releaseVersion,
+      schema_version: "AssetReleaseManifest/v1" as const,
+    });
+  }
+
+  authorizeAsset(input: { releaseVersion: string; resourceId: string; userId: string }) {
+    const releaseVersion = assertText(input.releaseVersion, "releaseVersion");
+    const resourceId = assertText(input.resourceId, "resourceId");
+    const userId = assertText(input.userId, "userId");
+    const now = this.options.clock();
+    return this.immediate(() => {
+      this.expireDue(now);
+      const user = this.database.prepare("SELECT role, status FROM users WHERE user_id = ?").get(userId) as { role: string; status: string } | undefined;
+      if (!user || user.role !== "user" || user.status !== "active") return false;
+      const row = this.database.prepare(`
+        SELECT 1 AS authorized
+        FROM asset_preview_grants g
+        JOIN test_batch_items i ON i.test_batch_id = g.test_batch_id
+        WHERE g.user_id = ? AND g.status = 'active' AND g.expires_at > ?
+          AND i.release_version = ? AND i.resource_id = ?
+        LIMIT 1
+      `).get(userId, now, releaseVersion, resourceId) as { authorized: 1 } | undefined;
+      return Boolean(row);
+    });
+  }
+
+  readManifestItem(input: { manifestItemId: string; releaseVersion: string; userId: string }) {
+    const manifestItemId = assertText(input.manifestItemId, "manifestItemId");
+    const releaseVersion = assertText(input.releaseVersion, "releaseVersion");
+    const userId = assertText(input.userId, "userId");
+    const mapping = this.itemMappings.get(manifestItemId);
+    if (!mapping || mapping.releaseVersion !== releaseVersion || mapping.userId !== userId) return undefined;
+    if (!this.authorizeAsset({ releaseVersion, resourceId: mapping.resourceId, userId })) {
+      this.itemMappings.delete(manifestItemId);
+      return undefined;
+    }
+    const resource = this.options.assetReleases.read("internal_preview_asset", releaseVersion, mapping.resourceId);
+    return resource ? { ...resource, resourceId: manifestItemId } : undefined;
+  }
+
+  private migrate() {
+    this.database.exec(`
+      CREATE TABLE IF NOT EXISTS test_batches (
+        batch_id TEXT PRIMARY KEY,
+        name TEXT NOT NULL CHECK (length(name) BETWEEN 1 AND 160),
+        status TEXT NOT NULL CHECK (status IN ('active', 'closed')),
+        created_by TEXT NOT NULL REFERENCES users(user_id),
+        created_at INTEGER NOT NULL,
+        closed_at INTEGER
+      );
+      CREATE TABLE IF NOT EXISTS test_batch_items (
+        test_batch_id TEXT NOT NULL REFERENCES test_batches(batch_id),
+        release_version TEXT NOT NULL,
+        resource_id TEXT NOT NULL,
+        PRIMARY KEY (test_batch_id, release_version, resource_id)
+      );
+      CREATE TABLE IF NOT EXISTS asset_preview_grants (
+        grant_id TEXT PRIMARY KEY,
+        user_id TEXT NOT NULL REFERENCES users(user_id),
+        test_batch_id TEXT NOT NULL REFERENCES test_batches(batch_id),
+        granted_by TEXT NOT NULL REFERENCES users(user_id),
+        granted_at INTEGER NOT NULL,
+        expires_at INTEGER NOT NULL CHECK (expires_at > granted_at),
+        status TEXT NOT NULL CHECK (status IN ('active', 'revoked', 'expired'))
+      );
+      CREATE INDEX IF NOT EXISTS asset_preview_grants_user_status
+        ON asset_preview_grants(user_id, status, expires_at);
+    `);
+  }
+
+  private immediate<T>(action: () => T): T {
+    this.database.exec("BEGIN IMMEDIATE");
+    try {
+      const value = action();
+      this.database.exec("COMMIT");
+      return value;
+    } catch (error) {
+      if (this.database.inTransaction) this.database.exec("ROLLBACK");
+      throw error;
+    }
+  }
+
+  private assertAdmin(adminUserId: string, now: number) {
+    const admin = this.database.prepare(`
+      SELECT 1 AS allowed FROM users u JOIN admin_access a ON a.user_id = u.user_id
+      WHERE u.user_id = ? AND u.role = 'super_admin' AND u.status = 'active' AND a.allowed = 1
+    `).get(adminUserId) as { allowed: 1 } | undefined;
+    if (!admin) throw new PreviewGrantError("admin_invalid");
+    void now;
+  }
+
+  private readBatch(batchId: string): PreviewBatchView | undefined {
+    const row = this.database.prepare(`
+      SELECT batch_id, name, status, created_by, created_at
+      FROM test_batches WHERE batch_id = ?
+    `).get(batchId) as { batch_id: string; created_at: number; created_by: string; name: string; status: PreviewBatchStatus } | undefined;
+    return row ? {
+      batchId: row.batch_id,
+      createdAt: row.created_at,
+      createdBy: row.created_by,
+      name: row.name,
+      status: row.status,
+    } : undefined;
+  }
+
+  private readGrant(grantId: string): PreviewGrantView | undefined {
+    const row = this.database.prepare(`
+      SELECT grant_id, user_id, test_batch_id, granted_by, granted_at, expires_at, status
+      FROM asset_preview_grants WHERE grant_id = ?
+    `).get(grantId) as {
+      expires_at: number; grant_id: string; granted_at: number; granted_by: string;
+      status: PreviewGrantStatus; test_batch_id: string; user_id: string;
+    } | undefined;
+    return row ? {
+      batchId: row.test_batch_id,
+      expiresAt: row.expires_at,
+      grantId: row.grant_id,
+      grantedAt: row.granted_at,
+      grantedBy: row.granted_by,
+      status: row.status,
+      userId: row.user_id,
+    } : undefined;
+  }
+
+  private expireDue(now: number) {
+    const rows = this.database.prepare(`
+      SELECT grant_id, user_id, test_batch_id FROM asset_preview_grants
+      WHERE status = 'active' AND expires_at <= ?
+    `).all(now) as Array<{ grant_id: string; test_batch_id: string; user_id: string }>;
+    if (rows.length === 0) return;
+    this.database.prepare("UPDATE asset_preview_grants SET status = 'expired' WHERE status = 'active' AND expires_at <= ?").run(now);
+    for (const row of rows) {
+      this.audit({
+        actorRef: "preview_grant_expiry",
+        afterSummary: { grant_id: row.grant_id, status: "expired" },
+        beforeSummary: { grant_id: row.grant_id, status: "active" },
+        operationType: "preview_grant_expire",
+        targetRef: row.grant_id,
+        targetType: "preview_grant",
+      }, now, "system");
+    }
+  }
+
+  private audit(input: {
+    actorRef: string;
+    afterSummary: Record<string, unknown> | null;
+    beforeSummary: Record<string, unknown> | null;
+    operationType: string;
+    targetRef: string;
+    targetType: string;
+  }, now: number, actorType: "super_admin" | "system" = "super_admin") {
+    this.database.prepare(`
+      INSERT INTO admin_operation_logs (
+        log_id, actor_type, actor_ref, operation_type, target_type, target_ref,
+        result, before_summary, after_summary, occurred_at, expires_at
+      ) VALUES (?, ?, ?, ?, ?, ?, 'succeeded', ?, ?, ?, ?)
+    `).run(
+      randomUUID(), actorType, input.actorRef, input.operationType, input.targetType, input.targetRef,
+      serializeAuditSummary(input.beforeSummary), serializeAuditSummary(input.afterSummary),
+      now, now + auditRetentionMilliseconds,
+    );
+  }
+}

apps/web/src/admin-models.tsx

@@ -147,7 +147,11 @@ export function AdminModelsPage() {
 
   return (
     <div className="admin-models-page">
-      <main id="admin-main">
+      <header className="admin-product-header">
+        <a href="/admin">DADA ADMIN</a>
+        <nav aria-label="后台导航"><a href="/admin/users">用户</a><a aria-current="page" href="/admin/models">模型</a><a href="/admin/audit">审计</a></nav>
+      </header>
+      <main>
         <header className="admin-models-heading">
           <div><p>MODEL OPERATIONS</p><h1>模型配置</h1></div>
           {configuration ? <strong>配置集合 v{configuration.config_set_version}</strong> : null}

apps/web/src/admin-shell.css

@@ -1,523 +0,0 @@
-:root {
-  color-scheme: light;
-  font-family: "Segoe UI", "Microsoft YaHei UI", sans-serif;
-  background: #f3f3ef;
-}
-
-* {
-  box-sizing: border-box;
-  letter-spacing: 0;
-}
-
-body {
-  margin: 0;
-}
-
-button,
-a,
-input,
-textarea {
-  font: inherit;
-}
-
-.admin-shell {
-  min-height: 100vh;
-  color: #171715;
-  background: #f3f3ef;
-}
-
-.admin-skip-link {
-  position: fixed;
-  z-index: 100;
-  top: 8px;
-  left: 228px;
-  padding: 8px 12px;
-  color: #ffffff;
-  background: #171715;
-  transform: translateY(-160%);
-}
-
-.admin-skip-link:focus {
-  transform: translateY(0);
-}
-
-.admin-sidebar {
-  position: fixed;
-  z-index: 20;
-  inset: 0 auto 0 0;
-  display: grid;
-  width: 216px;
-  grid-template-rows: auto 1fr auto;
-  color: #ffffff;
-  background: #171715;
-}
-
-.admin-wordmark {
-  display: grid;
-  min-height: 104px;
-  align-content: center;
-  padding: 20px 22px;
-  border-bottom: 1px solid #494944;
-  color: #ffffff;
-  text-decoration: none;
-}
-
-.admin-wordmark span {
-  font-family: "Arial Black", "Segoe UI", sans-serif;
-  font-size: 30px;
-  line-height: 1;
-}
-
-.admin-wordmark small {
-  margin-top: 6px;
-  color: #d9dc00;
-  font-family: Consolas, monospace;
-  font-size: 10px;
-}
-
-.admin-sidebar nav {
-  display: grid;
-  align-content: start;
-  padding: 12px 0;
-}
-
-.admin-sidebar nav a {
-  display: grid;
-  min-height: 48px;
-  grid-template-columns: 38px 1fr;
-  align-items: center;
-  padding: 0 18px;
-  border-left: 4px solid transparent;
-  color: #d5d5cf;
-  font-size: 13px;
-  font-weight: 700;
-  text-decoration: none;
-}
-
-.admin-sidebar nav a > span {
-  color: #85857d;
-  font-family: Consolas, monospace;
-  font-size: 10px;
-}
-
-.admin-sidebar nav a:hover,
-.admin-sidebar nav a:focus-visible {
-  color: #ffffff;
-  background: #2c2c29;
-}
-
-.admin-sidebar nav a[aria-current="page"] {
-  border-left-color: #e8eb00;
-  color: #171715;
-  background: #eef000;
-}
-
-.admin-sidebar nav a[aria-current="page"] > span {
-  color: #4d4d00;
-}
-
-.admin-sidebar-foot {
-  display: grid;
-  gap: 10px;
-  padding: 18px 22px;
-  border-top: 1px solid #494944;
-  font-family: Consolas, monospace;
-  font-size: 10px;
-}
-
-.admin-sidebar-foot span {
-  color: #a5a59d;
-}
-
-.admin-sidebar-foot strong {
-  color: #ffffff;
-  font-weight: 700;
-}
-
-.admin-shell-workspace {
-  min-width: 0;
-  margin-left: 216px;
-  padding-top: 52px;
-}
-
-.admin-topbar {
-  position: fixed;
-  z-index: 15;
-  top: 0;
-  right: 0;
-  left: 216px;
-  display: flex;
-  height: 52px;
-  align-items: center;
-  justify-content: space-between;
-  padding: 0 28px;
-  border-bottom: 1px solid #b7b7b0;
-  background: rgb(255 255 255 / 96%);
-}
-
-.admin-topbar h1 {
-  margin: 0;
-  font-size: 15px;
-}
-
-.admin-topbar-status {
-  display: flex;
-  align-items: center;
-  gap: 20px;
-  color: #62625c;
-  font-size: 11px;
-}
-
-.admin-topbar-status span {
-  display: flex;
-  align-items: center;
-  gap: 7px;
-}
-
-.admin-topbar-status i {
-  width: 8px;
-  height: 8px;
-  border-radius: 50%;
-  background: #777770;
-}
-
-.admin-topbar-status code {
-  color: #171715;
-}
-
-.admin-shell-content {
-  min-width: 0;
-}
-
-.admin-session-gate {
-  display: grid;
-  min-height: 100vh;
-  place-items: center;
-  color: #171715;
-  background: #f3f3ef;
-}
-
-.admin-session-gate p,
-.admin-session-gate div {
-  padding: 22px;
-  border-left: 5px solid #171715;
-  background: #ffffff;
-}
-
-.admin-session-gate div {
-  display: grid;
-  gap: 12px;
-}
-
-.admin-session-gate button,
-.admin-overview-failure button,
-.admin-placeholder-toolbar button {
-  min-height: 40px;
-  padding: 8px 14px;
-  border: 1px solid #171715;
-  border-radius: 0;
-  color: #171715;
-  background: #eef000;
-  font-weight: 800;
-}
-
-.admin-overview,
-.admin-placeholder {
-  width: min(1320px, calc(100% - 64px));
-  margin: 0 auto;
-  padding: 34px 0 72px;
-}
-
-.admin-page-heading {
-  display: flex;
-  min-height: 74px;
-  align-items: end;
-  justify-content: space-between;
-  gap: 24px;
-  padding-bottom: 18px;
-  border-bottom: 1px solid #8c8c85;
-}
-
-.admin-page-heading p,
-.admin-status-section header p,
-.admin-operation-strip header p {
-  margin: 0 0 5px;
-  font-family: Consolas, monospace;
-  font-size: 10px;
-  font-weight: 700;
-}
-
-.admin-page-heading h2 {
-  margin: 0;
-  font-size: 32px;
-}
-
-.admin-page-heading time {
-  color: #66665f;
-  font-size: 11px;
-}
-
-.admin-capacity-alert {
-  display: grid;
-  min-height: 44px;
-  grid-template-columns: 1fr auto auto;
-  align-items: center;
-  gap: 18px;
-  padding: 9px 14px;
-  border-bottom: 1px solid #171715;
-  color: #171715;
-  background: #eef000;
-  font-size: 12px;
-  text-decoration: none;
-}
-
-.admin-capacity-alert.is-full,
-.admin-capacity-alert.is-unavailable {
-  color: #ffffff;
-  background: #b33a2f;
-}
-
-.admin-overview-loading {
-  display: grid;
-  grid-template-columns: repeat(4, minmax(0, 1fr));
-  margin-top: 22px;
-  border-block: 1px solid #b7b7b0;
-}
-
-.admin-overview-loading span {
-  height: 130px;
-  border-right: 1px solid #c7c7c0;
-  background: #e2e2dd;
-}
-
-.admin-overview-failure {
-  display: flex;
-  align-items: center;
-  justify-content: space-between;
-  gap: 20px;
-  margin-top: 20px;
-  padding: 14px 16px;
-  border-left: 5px solid #b33a2f;
-  background: #fff0ed;
-}
-
-.admin-metric-band {
-  display: grid;
-  grid-template-columns: repeat(4, minmax(0, 1fr));
-  margin-top: 22px;
-  border-block: 1px solid #8c8c85;
-  background: #ffffff;
-}
-
-.admin-metric-band a {
-  display: grid;
-  min-width: 0;
-  min-height: 132px;
-  align-content: center;
-  gap: 7px;
-  padding: 20px;
-  border-right: 1px solid #c3c3bc;
-  color: #171715;
-  text-decoration: none;
-}
-
-.admin-metric-band a:last-child {
-  border-right: 0;
-}
-
-.admin-metric-band span,
-.admin-metric-band small {
-  color: #65655f;
-  font-size: 11px;
-}
-
-.admin-metric-band strong {
-  overflow-wrap: anywhere;
-  font-size: 25px;
-}
-
-.admin-overview-columns {
-  display: grid;
-  grid-template-columns: 1fr 1fr;
-  gap: 24px;
-  margin-top: 24px;
-}
-
-.admin-status-section,
-.admin-operation-strip,
-.admin-placeholder > section {
-  border-top: 3px solid #171715;
-  border-bottom: 1px solid #8c8c85;
-  background: #ffffff;
-}
-
-.admin-status-section > header,
-.admin-operation-strip > header {
-  display: flex;
-  min-height: 64px;
-  align-items: center;
-  justify-content: space-between;
-  padding: 12px 16px;
-  border-bottom: 1px solid #c3c3bc;
-}
-
-.admin-status-section h3,
-.admin-operation-strip h3 {
-  margin: 0;
-  font-size: 17px;
-}
-
-.admin-status-section header a,
-.admin-operation-strip header a {
-  color: #171715;
-  font-size: 12px;
-  font-weight: 800;
-}
-
-.admin-status-section dl {
-  margin: 0;
-}
-
-.admin-status-section dl > div {
-  display: grid;
-  min-height: 52px;
-  grid-template-columns: 126px 1fr;
-  align-items: center;
-  padding: 0 16px;
-  border-bottom: 1px solid #ddddD7;
-}
-
-.admin-status-section dl > div:last-child {
-  border-bottom: 0;
-}
-
-.admin-status-section dt {
-  color: #65655f;
-  font-size: 11px;
-}
-
-.admin-status-section dd {
-  min-width: 0;
-  margin: 0;
-  overflow-wrap: anywhere;
-  font-family: Consolas, monospace;
-  font-size: 12px;
-  font-weight: 700;
-}
-
-.admin-service-list {
-  margin: 0;
-  padding: 0;
-  list-style: none;
-}
-
-.admin-service-list li {
-  display: grid;
-  min-height: 42px;
-  grid-template-columns: 1fr 84px 76px;
-  align-items: center;
-  padding: 0 16px;
-  border-bottom: 1px solid #ddddd7;
-  font-size: 11px;
-}
-
-.admin-service-list li:last-child {
-  border-bottom: 0;
-}
-
-.admin-service-list strong {
-  color: #1f6639;
-}
-
-.admin-service-list strong.is-degraded,
-.admin-service-list strong.is-paused {
-  color: #8b5608;
-}
-
-.admin-service-list strong.is-unavailable {
-  color: #a52e24;
-}
-
-.admin-service-list time {
-  color: #65655f;
-  text-align: right;
-}
-
-.admin-operation-strip {
-  margin-top: 24px;
-}
-
-.admin-operation-strip > p {
-  margin: 0;
-  padding: 22px 16px;
-  color: #65655f;
-}
-
-.admin-operation-strip table {
-  width: 100%;
-  border-collapse: collapse;
-  table-layout: fixed;
-}
-
-.admin-operation-strip th,
-.admin-operation-strip td {
-  padding: 12px 16px;
-  border-bottom: 1px solid #ddddd7;
-  overflow-wrap: anywhere;
-  text-align: left;
-  font-size: 11px;
-}
-
-.admin-operation-strip th {
-  color: #65655f;
-  background: #efefeb;
-}
-
-.admin-placeholder > section {
-  margin-top: 22px;
-}
-
-.admin-placeholder-toolbar {
-  display: flex;
-  min-height: 58px;
-  align-items: center;
-  justify-content: space-between;
-  padding: 8px 16px;
-  border-bottom: 1px solid #c3c3bc;
-  font-weight: 800;
-}
-
-.admin-placeholder-toolbar button:disabled {
-  color: #777770;
-  background: #dfdfda;
-}
-
-.admin-placeholder > section > p {
-  margin: 0;
-  padding: 44px 16px;
-  color: #65655f;
-}
-
-:is(.admin-shell, .admin-session-gate) :focus-visible {
-  outline: 2px solid #225dd8;
-  outline-offset: 2px;
-}
-
-@media (max-width: 1000px) {
-  .admin-overview,
-  .admin-placeholder {
-    width: calc(100% - 32px);
-  }
-
-  .admin-metric-band {
-    grid-template-columns: 1fr 1fr;
-  }
-
-  .admin-metric-band a:nth-child(2) {
-    border-right: 0;
-  }
-
-  .admin-overview-columns {
-    grid-template-columns: 1fr;
-  }
-}

apps/web/src/admin-shell.tsx

@@ -1,229 +0,0 @@
-import type { AdminOverviewResponse } from "@dada/shared-contracts";
-import { useCallback, useEffect, useState, type ReactNode } from "react";
-
-import "./admin-shell.css";
-
-interface AdminSession {
-  admin: { role: "super_admin"; status: "active"; user_id: string };
-  audience: "admin";
-  authenticated: true;
-  expires_at: string;
-}
-
-interface AdminProtectedRouteProps {
-  children: ReactNode;
-  currentPath: string;
-  title: string;
-}
-
-const adminNavigation = [
-  { href: "/admin", label: "总览", marker: "01" },
-  { href: "/admin/users", label: "用户与点数", marker: "02" },
-  { href: "/admin/invites", label: "邀请码", marker: "03" },
-  { href: "/admin/models", label: "模型", marker: "04" },
-  { href: "/admin/assets", label: "素材", marker: "05" },
-  { href: "/admin/preview", label: "内部预览", marker: "06" },
-  { href: "/admin/generations", label: "生成记录", marker: "07" },
-  { href: "/admin/services-storage", label: "服务与存储", marker: "08" },
-  { href: "/admin/audit", label: "审计", marker: "09" },
-] as const;
-
-function redirectToAdminLogin() {
-  window.location.replace("/admin/login");
-}
-
-export function AdminProtectedRoute({ children, currentPath, title }: AdminProtectedRouteProps) {
-  const [session, setSession] = useState<AdminSession>();
-  const [failed, setFailed] = useState(false);
-  const [revision, setRevision] = useState(0);
-
-  useEffect(() => {
-    const controller = new AbortController();
-    setFailed(false);
-    void fetch("/api/v1/admin-auth/session", { credentials: "same-origin", signal: controller.signal })
-      .then(async (response) => {
-        if (response.status === 401) {
-          redirectToAdminLogin();
-          return;
-        }
-        if (!response.ok) throw new Error("admin_session_unavailable");
-        const body = await response.json() as AdminSession;
-        if (body.audience !== "admin" || body.admin.role !== "super_admin" || body.admin.status !== "active") {
-          redirectToAdminLogin();
-          return;
-        }
-        setSession(body);
-      })
-      .catch((error: unknown) => {
-        if (!(error instanceof DOMException && error.name === "AbortError")) setFailed(true);
-      });
-    return () => controller.abort();
-  }, [revision]);
-
-  if (!session) {
-    return (
-      <main className="admin-session-gate">
-        {failed ? (
-          <div role="alert">
-            <strong>管理员会话暂时无法确认</strong>
-            <button onClick={() => setRevision((value) => value + 1)} type="button">重试</button>
-          </div>
-        ) : <p aria-live="polite">正在确认管理员会话</p>}
-      </main>
-    );
-  }
-
-  return (
-    <div className="admin-shell">
-      <a className="admin-skip-link" href="#admin-main">跳到主要内容</a>
-      <aside className="admin-sidebar">
-        <a className="admin-wordmark" href="/admin" aria-label="Dada 后台总览">
-          <span>DADA</span>
-          <small>OPERATIONS</small>
-        </a>
-        <nav aria-label="后台主导航">
-          {adminNavigation.map((item) => (
-            <a aria-current={currentPath === item.href ? "page" : undefined} href={item.href} key={item.href}>
-              <span aria-hidden="true">{item.marker}</span>
-              {item.label}
-            </a>
-          ))}
-        </nav>
-        <div className="admin-sidebar-foot">
-          <span>LOCAL P0-A</span>
-          <strong>独立管理员会话</strong>
-        </div>
-      </aside>
-      <div className="admin-shell-workspace">
-        <header className="admin-topbar">
-          <h1>{title}</h1>
-          <div className="admin-topbar-status">
-            <span><i aria-hidden="true" />状态摘要</span>
-            <code>{session.admin.user_id.slice(0, 8)}</code>
-          </div>
-        </header>
-        <div className="admin-shell-content">{children}</div>
-      </div>
-    </div>
-  );
-}
-
-const serviceLabels: Record<AdminOverviewResponse["services"][number]["service_id"], string> = {
-  ai_gateway: "AI 网关",
-  amap: "高德",
-  asset_root: "素材根",
-  resend: "Resend",
-  worker: "Worker",
-};
-
-const stateLabels = {
-  available: "正常",
-  degraded: "有异常",
-  paused: "已暂停",
-  unavailable: "不可用",
-} as const;
-
-function formatTime(value: string | null) {
-  if (!value) return "未记录";
-  return new Intl.DateTimeFormat("zh-CN", { hour: "2-digit", minute: "2-digit", month: "2-digit", day: "2-digit" }).format(new Date(value));
-}
-
-export function AdminOverviewPage() {
-  const [summary, setSummary] = useState<AdminOverviewResponse>();
-  const [failed, setFailed] = useState(false);
-  const [loading, setLoading] = useState(true);
-
-  const load = useCallback(async () => {
-    setLoading(true);
-    setFailed(false);
-    try {
-      const response = await fetch("/api/v1/admin/overview", { credentials: "same-origin" });
-      if (response.status === 401) {
-        window.dispatchEvent(new Event("dada:session-invalid"));
-        return;
-      }
-      if (!response.ok) throw new Error("admin_overview_unavailable");
-      setSummary(await response.json() as AdminOverviewResponse);
-    } catch {
-      setFailed(true);
-    } finally {
-      setLoading(false);
-    }
-  }, []);
-
-  useEffect(() => { void load(); }, [load]);
-
-  const storagePercent = summary
-    ? Math.min(100, (summary.storage.managed_content_bytes / summary.storage.limit_bytes) * 100)
-    : 0;
-  const hasServiceIssue = summary?.services.some((service) => service.status !== "available") ?? false;
-
-  return (
-    <main className="admin-overview" id="admin-main">
-      <header className="admin-page-heading">
-        <div><p>OPERATIONS / LIVE SUMMARY</p><h2>运营总览</h2></div>
-        {summary ? <time dateTime={summary.generated_at}>更新于 {formatTime(summary.generated_at)}</time> : null}
-      </header>
-      {summary && summary.storage.status !== "normal" ? (
-        <a className={`admin-capacity-alert is-${summary.storage.status}`} href="/admin/services-storage">
-          <span>本机内容容量</span>
-          <strong>{storagePercent.toFixed(1)}%</strong>
-          <span>{summary.storage.status === "critical" ? "接近上限" : summary.storage.status === "full" ? "已满" : "不可用"}</span>
-        </a>
-      ) : null}
-      {loading && !summary ? (
-        <div aria-label="运营摘要加载中" className="admin-overview-loading"><span /><span /><span /><span /></div>
-      ) : null}
-      {failed ? (
-        <div className="admin-overview-failure" role="alert">
-          <span>运营摘要暂时无法读取{summary ? `，当前保留 ${formatTime(summary.generated_at)} 的结果` : ""}。</span>
-          <button onClick={() => void load()} type="button">重试</button>
-        </div>
-      ) : null}
-      {summary ? (
-        <>
-          <section aria-label="关键运营指标" className="admin-metric-band">
-            <a href="/admin/users"><span>普通用户名额</span><strong>{summary.user_slots.active_and_suspended} / {summary.user_slots.limit}</strong><small>active + suspended</small></a>
-            <a href="/admin/generations"><span>进行中任务</span><strong>{summary.generation_jobs.queued + summary.generation_jobs.running}</strong><small>排队 {summary.generation_jobs.queued} · 运行 {summary.generation_jobs.running}</small></a>
-            <a href="/admin/generations"><span>成本核对</span><strong>待人工核对 {summary.generation_jobs.pending_manual_review}</strong><small>最早 {formatTime(summary.generation_jobs.pending_manual_review_oldest_at)}</small></a>
-            <a href="/admin/assets"><span>清理任务</span><strong>{summary.asset_cleanup.pending_jobs}</strong><small>等待处理</small></a>
-          </section>
-          <div className="admin-overview-columns">
-            <section className="admin-status-section" aria-labelledby="model-status-heading">
-              <header><div><p>MODEL STATE</p><h3 id="model-status-heading">模型状态</h3></div><a href="/admin/models">查看</a></header>
-              <dl>
-                <div><dt>配置默认</dt><dd>{summary.models.configured_default_model_id ?? "无"}</dd></div>
-                <div><dt>运行时可用</dt><dd>{summary.models.runtime_available_count} / {summary.models.configured_model_count}</dd></div>
-                <div><dt>当前推荐</dt><dd>{summary.models.recommended_model_id ?? "无"}</dd></div>
-              </dl>
-            </section>
-            <section className="admin-status-section" aria-labelledby="service-status-heading">
-              <header><div><p>SERVICE STATE</p><h3 id="service-status-heading">服务状态</h3></div><a href="/admin/services-storage">{hasServiceIssue ? "有异常" : "全部正常"}</a></header>
-              <ul className="admin-service-list">
-                {summary.services.map((service) => <li key={service.service_id}><span>{serviceLabels[service.service_id]}</span><strong className={`is-${service.status}`}>{stateLabels[service.status]}</strong><time dateTime={service.checked_at ?? undefined}>{formatTime(service.checked_at)}</time></li>)}
-              </ul>
-            </section>
-          </div>
-          <section className="admin-operation-strip" aria-labelledby="recent-operation-heading">
-            <header><div><p>AUDIT SNAPSHOT</p><h3 id="recent-operation-heading">最近后台操作</h3></div><a href="/admin/audit">查看全部</a></header>
-            {summary.recent_operations.length === 0 ? <p>当前无近期操作</p> : (
-              <table><thead><tr><th>时间</th><th>操作</th><th>对象摘要</th><th>结果</th></tr></thead><tbody>{summary.recent_operations.map((operation) => <tr key={operation.operation_id}><td>{formatTime(operation.created_at)}</td><td>{operation.operation_type}</td><td><code>{operation.target_ref}</code></td><td>{operation.result}</td></tr>)}</tbody></table>
-            )}
-          </section>
-        </>
-      ) : null}
-    </main>
-  );
-}
-
-export function AdminPlaceholderPage({ title }: { title: string }) {
-  return (
-    <main className="admin-placeholder" id="admin-main">
-      <header className="admin-page-heading"><div><p>OPERATIONS</p><h2>{title}</h2></div></header>
-      <section aria-label={`${title}安全摘要`}>
-        <div className="admin-placeholder-toolbar"><span>安全摘要</span><button disabled type="button">新建</button></div>
-        <p>当前无记录</p>
-      </section>
-    </main>
-  );
-}

apps/web/src/admin-users.tsx

@@ -100,7 +100,11 @@ export function AdminUsersPage() {
 
   return (
     <div className="admin-users-page">
-      <main id="admin-main">
+      <header className="admin-product-header">
+        <a href="/admin">DADA ADMIN</a>
+        <nav aria-label="后台导航"><a aria-current="page" href="/admin/users">用户</a><a href="/admin/models">模型</a><a href="/admin/audit">审计</a></nav>
+      </header>
+      <main>
         <header className="admin-users-heading">
           <div><p>USER OPERATIONS</p><h1>用户点数</h1></div>
           {balance ? <button onClick={openAdjustment} type="button">调整点数</button> : null}

apps/web/src/generated/api/sdk.gen.ts

@@ -1,6 +1,6 @@
 // Generated from openapi/openapi.json. Do not edit by hand.
 
-import type { CreditAdjustmentResponse, CreditAdjustmentRequest, BrowserSupportSuccess, BrowserSupportRequest, AccountDeletionResponse, AccountDeletionCompleteRequest, AdminLoginCompleteResponse, AdminLoginCompleteRequest, LoginCompleteResponse, LoginCompleteRequest, RegistrationCompleteResponse, RegistrationCompleteRequest, GenerationCreateResponse, AccountSettingsResponse, AdminOverviewResponse, AdminSessionResponse, CreditBalanceResponse, BootstrapResponse, GenerationTaskResponse, SseEvent, ModelConfig, ModelConfigurationResponse, CreditLedgerResponse, ProjectDetailResponse, UserSessionResponse, ProjectListResponse, RecentAssetListResponse, LogoutResponse, ProjectPurgeResponse, RecentAssetRecordResponse, RecentAssetRecordRequest, ProjectRenameResponse, ProjectRenameRequest, ModelConfigUpdateRequest, ProjectRestoreResponse, ReverseGeocodeResponse, ReverseGeocodeRequest, LatestExportSaveResponse, ProjectStateSaveResponse, ProjectEditableState, AccountDeletionSendResponse, RegistrationSendResponse, AdminLoginSendRequest, LoginSendRequest, RegistrationSendRequest, FailedEmptyTrashResponse, FailedEmptyTrashRequest, ProjectTrashResponse, AccountProfileUpdateResponse, AccountProfileUpdateRequest } from "./types.gen.js";
+import type { CreditAdjustmentResponse, CreditAdjustmentRequest, BrowserSupportSuccess, BrowserSupportRequest, AccountDeletionResponse, AccountDeletionCompleteRequest, AdminLoginCompleteResponse, AdminLoginCompleteRequest, LoginCompleteResponse, LoginCompleteRequest, RegistrationCompleteResponse, RegistrationCompleteRequest, GenerationCreateResponse, AccountSettingsResponse, AdminSessionResponse, CreditBalanceResponse, BootstrapResponse, GenerationTaskResponse, SseEvent, ModelConfig, ModelConfigurationResponse, CreditLedgerResponse, ProjectDetailResponse, UserSessionResponse, ProjectListResponse, RecentAssetListResponse, LogoutResponse, ProjectPurgeResponse, RecentAssetRecordResponse, RecentAssetRecordRequest, ProjectRenameResponse, ProjectRenameRequest, ModelConfigUpdateRequest, ProjectRestoreResponse, ReverseGeocodeResponse, ReverseGeocodeRequest, LatestExportSaveResponse, ProjectStateSaveResponse, ProjectEditableState, AccountDeletionSendResponse, RegistrationSendResponse, AdminLoginSendRequest, LoginSendRequest, RegistrationSendRequest, FailedEmptyTrashResponse, FailedEmptyTrashRequest, ProjectTrashResponse, AccountProfileUpdateResponse, AccountProfileUpdateRequest } from "./types.gen.js";
 
 export interface ClientOptions { baseUrl?: string; fetch?: typeof globalThis.fetch; headers?: HeadersInit; }
 
@@ -87,13 +87,6 @@ export async function getAccountSettings(options: ClientOptions = {}): Promise<A
   return response.json() as Promise<AccountSettingsResponse>;
 }
 
-export async function getAdminOverview(options: ClientOptions = {}): Promise<AdminOverviewResponse> {
-  const request = options.fetch ?? globalThis.fetch;
-  const response = await request(`${options.baseUrl ?? ""}/api/v1/admin/overview`, { method: "GET", headers: options.headers ?? {} });
-  if (!response.ok) throw new Error(`HTTP ${response.status}`);
-  return response.json() as Promise<AdminOverviewResponse>;
-}
-
 export async function getAdminSession(options: ClientOptions = {}): Promise<AdminSessionResponse> {
   const request = options.fetch ?? globalThis.fetch;
   const response = await request(`${options.baseUrl ?? ""}/api/v1/admin-auth/session`, { method: "GET", headers: options.headers ?? {} });

apps/web/src/generated/api/types.gen.ts

@@ -76,47 +76,6 @@ export type AdminLoginSendRequest = {
   "email": string;
 };
 
-export type AdminOverviewResponse = {
-  "asset_cleanup": {
-  "pending_jobs": number;
-};
-  "generated_at": string;
-  "generation_jobs": {
-  "pending_manual_review": number;
-  "pending_manual_review_oldest_at": string | null;
-  "queued": number;
-  "running": number;
-};
-  "models": {
-  "configured_default_model_id": string | null;
-  "configured_model_count": number;
-  "recommended_model_id": string | null;
-  "runtime_available_count": number;
-};
-  "recent_operations": Array<{
-  "created_at": string;
-  "operation_id": string;
-  "operation_type": string;
-  "result": "succeeded" | "rejected" | "failed";
-  "target_ref": string;
-}>;
-  "services": Array<{
-  "checked_at": string | null;
-  "service_id": "resend" | "amap" | "ai_gateway" | "worker" | "asset_root";
-  "status": "available" | "degraded" | "paused" | "unavailable";
-}>;
-  "storage": {
-  "last_measured_at": string | null;
-  "limit_bytes": number;
-  "managed_content_bytes": number;
-  "status": "normal" | "critical" | "full" | "unavailable";
-};
-  "user_slots": {
-  "active_and_suspended": number;
-  "limit": number;
-};
-};
-
 export type AdminSessionResponse = {
   "acknowledged_private_content_notice_version": string | null;
   "admin": AdminAuthenticatedUser;

apps/web/src/main.tsx

@@ -1,4 +1,4 @@
-import { StrictMode, type ReactNode } from "react";
+import { StrictMode } from "react";
 import { createRoot } from "react-dom/client";
 
 import { registerPublicAssetServiceWorker } from "./public-asset-cache.js";
@@ -10,7 +10,6 @@ import { AdminModelsPage } from "./admin-models.js";
 import { CreditsPage } from "./credits-page.js";
 import { ProjectDetailPage, ProjectsPage, WorkspacePage } from "./project-pages.js";
 import { EditorPage } from "./editor-page.js";
-import { AdminOverviewPage, AdminPlaceholderPage, AdminProtectedRoute } from "./admin-shell.js";
 
 const root = document.getElementById("root");
 
@@ -35,26 +34,9 @@ function renderAuthenticationEntry() {
   else if (projectDetail?.[1]) authenticationPage = <ProjectDetailPage key={authRevision} projectId={projectDetail[1]} />;
   else if (window.location.pathname === "/app/projects") authenticationPage = <ProjectsPage key={authRevision} />;
   else if (window.location.pathname === "/app") authenticationPage = <WorkspacePage key={authRevision} />;
-  else if (window.location.pathname === "/admin/login") authenticationPage = <AdminAuthPage key={authRevision} />;
-  else if (window.location.pathname.startsWith("/admin")) {
-    const adminPages: Record<string, { content: ReactNode; title: string }> = {
-      "/admin": { content: <AdminOverviewPage />, title: "运营总览" },
-      "/admin/assets": { content: <AdminPlaceholderPage title="素材" />, title: "素材" },
-      "/admin/audit": { content: <AdminPlaceholderPage title="审计" />, title: "审计" },
-      "/admin/generations": { content: <AdminPlaceholderPage title="生成记录" />, title: "生成记录" },
-      "/admin/invites": { content: <AdminPlaceholderPage title="邀请码" />, title: "邀请码" },
-      "/admin/models": { content: <AdminModelsPage />, title: "模型" },
-      "/admin/preview": { content: <AdminPlaceholderPage title="内部预览" />, title: "内部预览" },
-      "/admin/services-storage": { content: <AdminPlaceholderPage title="服务与存储" />, title: "服务与存储" },
-      "/admin/users": { content: <AdminUsersPage />, title: "用户与点数" },
-    };
-    const page = adminPages[window.location.pathname] ?? adminPages["/admin"]!;
-    authenticationPage = (
-      <AdminProtectedRoute currentPath={window.location.pathname} key={authRevision} title={page.title}>
-        {page.content}
-      </AdminProtectedRoute>
-    );
-  }
+  else if (window.location.pathname === "/admin/users") authenticationPage = <AdminUsersPage key={authRevision} />;
+  else if (window.location.pathname === "/admin/models") authenticationPage = <AdminModelsPage key={authRevision} />;
+  else if (window.location.pathname.startsWith("/admin")) authenticationPage = <AdminAuthPage key={authRevision} />;
   else authenticationPage = <UserAuthPage key={authRevision} />;
   appRoot.render(
     <StrictMode>

openapi/openapi.json

@@ -363,339 +363,6 @@
         ],
         "type": "object"
       },
-      "AdminOverviewResponse": {
-        "additionalProperties": false,
-        "properties": {
-          "asset_cleanup": {
-            "additionalProperties": false,
-            "properties": {
-              "pending_jobs": {
-                "minimum": 0,
-                "type": "integer"
-              }
-            },
-            "required": [
-              "pending_jobs"
-            ],
-            "type": "object"
-          },
-          "generated_at": {
-            "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}(?:\\.[0-9]{3})?Z$",
-            "type": "string"
-          },
-          "generation_jobs": {
-            "additionalProperties": false,
-            "properties": {
-              "pending_manual_review": {
-                "minimum": 0,
-                "type": "integer"
-              },
-              "pending_manual_review_oldest_at": {
-                "anyOf": [
-                  {
-                    "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}(?:\\.[0-9]{3})?Z$",
-                    "type": "string"
-                  },
-                  {
-                    "type": "null"
-                  }
-                ]
-              },
-              "queued": {
-                "minimum": 0,
-                "type": "integer"
-              },
-              "running": {
-                "minimum": 0,
-                "type": "integer"
-              }
-            },
-            "required": [
-              "pending_manual_review",
-              "pending_manual_review_oldest_at",
-              "queued",
-              "running"
-            ],
-            "type": "object"
-          },
-          "models": {
-            "additionalProperties": false,
-            "properties": {
-              "configured_default_model_id": {
-                "anyOf": [
-                  {
-                    "maxLength": 80,
-                    "pattern": "^[a-z0-9][a-z0-9.-]+$",
-                    "type": "string"
-                  },
-                  {
-                    "type": "null"
-                  }
-                ]
-              },
-              "configured_model_count": {
-                "minimum": 0,
-                "type": "integer"
-              },
-              "recommended_model_id": {
-                "anyOf": [
-                  {
-                    "maxLength": 80,
-                    "pattern": "^[a-z0-9][a-z0-9.-]+$",
-                    "type": "string"
-                  },
-                  {
-                    "type": "null"
-                  }
-                ]
-              },
-              "runtime_available_count": {
-                "minimum": 0,
-                "type": "integer"
-              }
-            },
-            "required": [
-              "configured_default_model_id",
-              "configured_model_count",
-              "recommended_model_id",
-              "runtime_available_count"
-            ],
-            "type": "object"
-          },
-          "recent_operations": {
-            "items": {
-              "additionalProperties": false,
-              "properties": {
-                "created_at": {
-                  "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}(?:\\.[0-9]{3})?Z$",
-                  "type": "string"
-                },
-                "operation_id": {
-                  "pattern": "^[0-9a-fA-F-]{36}$",
-                  "type": "string"
-                },
-                "operation_type": {
-                  "maxLength": 80,
-                  "pattern": "^[a-z][a-z0-9_]+$",
-                  "type": "string"
-                },
-                "result": {
-                  "anyOf": [
-                    {
-                      "enum": [
-                        "succeeded"
-                      ],
-                      "type": "string"
-                    },
-                    {
-                      "enum": [
-                        "rejected"
-                      ],
-                      "type": "string"
-                    },
-                    {
-                      "enum": [
-                        "failed"
-                      ],
-                      "type": "string"
-                    }
-                  ]
-                },
-                "target_ref": {
-                  "pattern": "^[A-Za-z0-9][A-Za-z0-9:._-]{0,159}$",
-                  "type": "string"
-                }
-              },
-              "required": [
-                "created_at",
-                "operation_id",
-                "operation_type",
-                "result",
-                "target_ref"
-              ],
-              "type": "object"
-            },
-            "maxItems": 10,
-            "type": "array"
-          },
-          "services": {
-            "items": {
-              "additionalProperties": false,
-              "properties": {
-                "checked_at": {
-                  "anyOf": [
-                    {
-                      "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}(?:\\.[0-9]{3})?Z$",
-                      "type": "string"
-                    },
-                    {
-                      "type": "null"
-                    }
-                  ]
-                },
-                "service_id": {
-                  "anyOf": [
-                    {
-                      "enum": [
-                        "resend"
-                      ],
-                      "type": "string"
-                    },
-                    {
-                      "enum": [
-                        "amap"
-                      ],
-                      "type": "string"
-                    },
-                    {
-                      "enum": [
-                        "ai_gateway"
-                      ],
-                      "type": "string"
-                    },
-                    {
-                      "enum": [
-                        "worker"
-                      ],
-                      "type": "string"
-                    },
-                    {
-                      "enum": [
-                        "asset_root"
-                      ],
-                      "type": "string"
-                    }
-                  ]
-                },
-                "status": {
-                  "anyOf": [
-                    {
-                      "enum": [
-                        "available"
-                      ],
-                      "type": "string"
-                    },
-                    {
-                      "enum": [
-                        "degraded"
-                      ],
-                      "type": "string"
-                    },
-                    {
-                      "enum": [
-                        "paused"
-                      ],
-                      "type": "string"
-                    },
-                    {
-                      "enum": [
-                        "unavailable"
-                      ],
-                      "type": "string"
-                    }
-                  ]
-                }
-              },
-              "required": [
-                "checked_at",
-                "service_id",
-                "status"
-              ],
-              "type": "object"
-            },
-            "maxItems": 5,
-            "type": "array"
-          },
-          "storage": {
-            "additionalProperties": false,
-            "properties": {
-              "last_measured_at": {
-                "anyOf": [
-                  {
-                    "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}(?:\\.[0-9]{3})?Z$",
-                    "type": "string"
-                  },
-                  {
-                    "type": "null"
-                  }
-                ]
-              },
-              "limit_bytes": {
-                "minimum": 1,
-                "type": "integer"
-              },
-              "managed_content_bytes": {
-                "minimum": 0,
-                "type": "integer"
-              },
-              "status": {
-                "anyOf": [
-                  {
-                    "enum": [
-                      "normal"
-                    ],
-                    "type": "string"
-                  },
-                  {
-                    "enum": [
-                      "critical"
-                    ],
-                    "type": "string"
-                  },
-                  {
-                    "enum": [
-                      "full"
-                    ],
-                    "type": "string"
-                  },
-                  {
-                    "enum": [
-                      "unavailable"
-                    ],
-                    "type": "string"
-                  }
-                ]
-              }
-            },
-            "required": [
-              "last_measured_at",
-              "limit_bytes",
-              "managed_content_bytes",
-              "status"
-            ],
-            "type": "object"
-          },
-          "user_slots": {
-            "additionalProperties": false,
-            "properties": {
-              "active_and_suspended": {
-                "minimum": 0,
-                "type": "integer"
-              },
-              "limit": {
-                "minimum": 1,
-                "type": "integer"
-              }
-            },
-            "required": [
-              "active_and_suspended",
-              "limit"
-            ],
-            "type": "object"
-          }
-        },
-        "required": [
-          "generated_at",
-          "user_slots",
-          "generation_jobs",
-          "models",
-          "storage",
-          "services",
-          "recent_operations",
-          "asset_cleanup"
-        ],
-        "type": "object"
-      },
       "AdminSessionResponse": {
         "additionalProperties": false,
         "properties": {
@@ -8298,39 +7965,6 @@
         ]
       }
     },
-    "/api/v1/admin/overview": {
-      "get": {
-        "operationId": "getAdminOverview",
-        "responses": {
-          "200": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/AdminOverviewResponse"
-                }
-              }
-            },
-            "description": "Default Response"
-          },
-          "401": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorEnvelope"
-                }
-              }
-            },
-            "description": "Default Response"
-          },
-          "503": {
-            "description": "Default Response"
-          }
-        },
-        "tags": [
-          "Admin Operations"
-        ]
-      }
-    },
     "/api/v1/admin/users/{userId}/credit-adjustments": {
       "post": {
         "operationId": "adjustAdminUserCredits",

package.json

@@ -14,7 +14,7 @@
     "test:integration": "vitest run tests/integration",
     "test:api": "pnpm check:openapi && vitest run tests/api",
     "test:worker": "pnpm --filter @dada/worker build && node scripts/worker-smoke.mjs && vitest run tests/worker",
-    "test:e2e": "pnpm check:openapi && playwright test tests/e2e/event-sync.spec.ts tests/e2e/support-gate.spec.ts tests/e2e/local-data-boundary.spec.ts tests/e2e/storage-capacity.spec.ts tests/e2e/public-asset-cache.spec.ts tests/e2e/user-auth.spec.ts tests/e2e/admin-auth.spec.ts tests/e2e/entry-state-ui.spec.ts tests/e2e/session-invalid-ui.spec.ts tests/e2e/user-registration.spec.ts tests/e2e/account-settings.spec.ts tests/e2e/projects-workspace.spec.ts tests/e2e/project-autosave-conflict.spec.ts tests/e2e/project-trash.spec.ts tests/e2e/credits.spec.ts tests/e2e/generation-workspace.spec.ts tests/e2e/generation-terminal-actions.spec.ts tests/e2e/project-latest-exports.spec.ts tests/e2e/admin-models.spec.ts tests/e2e/wp4-01-editor-background.spec.ts tests/e2e/wp4-02-editor-elements.spec.ts tests/e2e/wp4-03-text-editor.spec.ts tests/e2e/wp4-04-color-dynamic.spec.ts tests/e2e/wp4-05-export.spec.ts tests/e2e/wp4-06-accessibility.spec.ts tests/e2e/wp5-02-static-sticker-catalog.spec.ts tests/e2e/wp5-03-template-registry.spec.ts tests/e2e/wp5-04-resource-isolation.spec.ts tests/e2e/wp6-01-admin-shell.spec.ts --config playwright.config.ts",
+    "test:e2e": "pnpm check:openapi && playwright test tests/e2e/event-sync.spec.ts tests/e2e/support-gate.spec.ts tests/e2e/local-data-boundary.spec.ts tests/e2e/storage-capacity.spec.ts tests/e2e/public-asset-cache.spec.ts tests/e2e/user-auth.spec.ts tests/e2e/admin-auth.spec.ts tests/e2e/entry-state-ui.spec.ts tests/e2e/session-invalid-ui.spec.ts tests/e2e/user-registration.spec.ts tests/e2e/account-settings.spec.ts tests/e2e/projects-workspace.spec.ts tests/e2e/project-autosave-conflict.spec.ts tests/e2e/project-trash.spec.ts tests/e2e/credits.spec.ts tests/e2e/generation-workspace.spec.ts tests/e2e/generation-terminal-actions.spec.ts tests/e2e/project-latest-exports.spec.ts tests/e2e/admin-models.spec.ts tests/e2e/wp4-01-editor-background.spec.ts tests/e2e/wp4-02-editor-elements.spec.ts tests/e2e/wp4-03-text-editor.spec.ts tests/e2e/wp4-04-color-dynamic.spec.ts tests/e2e/wp4-05-export.spec.ts tests/e2e/wp4-06-accessibility.spec.ts tests/e2e/wp5-02-static-sticker-catalog.spec.ts tests/e2e/wp5-03-template-registry.spec.ts tests/e2e/wp5-04-resource-isolation.spec.ts --config playwright.config.ts",
     "test:visual": "node scripts/validate-layer-scope.mjs VISUAL",
     "test:performance": "node scripts/validate-layer-scope.mjs PERFORMANCE",
     "test:security": "node scripts/verify-frozen-dependencies.mjs && node scripts/redaction-scan.mjs",
@@ -94,9 +94,7 @@
     "test:wp5-03": "node scripts/run-wp5-03-validation.mjs",
     "test:wp5-03:red": "node scripts/run-wp5-03-validation.mjs --phase red",
     "test:wp5-04": "node scripts/run-wp5-04-validation.mjs",
-    "test:wp5-04:red": "node scripts/run-wp5-04-validation.mjs --phase red",
-    "test:wp6-01": "node scripts/run-wp6-01-validation.mjs --phase scaffold",
-    "test:wp6-01:red": "node scripts/run-wp6-01-validation.mjs --phase red"
+    "test:wp5-04:red": "node scripts/run-wp5-04-validation.mjs --phase red"
   },
   "devDependencies": {
     "@playwright/test": "1.62.0",

packages/shared-contracts/src/admin.ts

@@ -1,94 +0,0 @@
-import { Type, type Static } from "@sinclair/typebox";
-
-const isoTimestampPattern = "^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}(?:\\.[0-9]{3})?Z$";
-const modelIdPattern = "^[a-z0-9][a-z0-9.-]+$";
-const safeReferencePattern = "^[A-Za-z0-9][A-Za-z0-9:._-]{0,159}$";
-
-export const AdminOverviewResponseSchema = Type.Object(
-  {
-    generated_at: Type.String({ pattern: isoTimestampPattern }),
-    user_slots: Type.Object(
-      {
-        active_and_suspended: Type.Integer({ minimum: 0 }),
-        limit: Type.Integer({ minimum: 1 }),
-      },
-      { additionalProperties: false },
-    ),
-    generation_jobs: Type.Object(
-      {
-        pending_manual_review: Type.Integer({ minimum: 0 }),
-        pending_manual_review_oldest_at: Type.Union([Type.String({ pattern: isoTimestampPattern }), Type.Null()]),
-        queued: Type.Integer({ minimum: 0 }),
-        running: Type.Integer({ minimum: 0 }),
-      },
-      { additionalProperties: false },
-    ),
-    models: Type.Object(
-      {
-        configured_default_model_id: Type.Union([Type.String({ maxLength: 80, pattern: modelIdPattern }), Type.Null()]),
-        configured_model_count: Type.Integer({ minimum: 0 }),
-        recommended_model_id: Type.Union([Type.String({ maxLength: 80, pattern: modelIdPattern }), Type.Null()]),
-        runtime_available_count: Type.Integer({ minimum: 0 }),
-      },
-      { additionalProperties: false },
-    ),
-    storage: Type.Object(
-      {
-        last_measured_at: Type.Union([Type.String({ pattern: isoTimestampPattern }), Type.Null()]),
-        limit_bytes: Type.Integer({ minimum: 1 }),
-        managed_content_bytes: Type.Integer({ minimum: 0 }),
-        status: Type.Union([
-          Type.Literal("normal"),
-          Type.Literal("critical"),
-          Type.Literal("full"),
-          Type.Literal("unavailable"),
-        ]),
-      },
-      { additionalProperties: false },
-    ),
-    services: Type.Array(
-      Type.Object(
-        {
-          checked_at: Type.Union([Type.String({ pattern: isoTimestampPattern }), Type.Null()]),
-          service_id: Type.Union([
-            Type.Literal("resend"),
-            Type.Literal("amap"),
-            Type.Literal("ai_gateway"),
-            Type.Literal("worker"),
-            Type.Literal("asset_root"),
-          ]),
-          status: Type.Union([
-            Type.Literal("available"),
-            Type.Literal("degraded"),
-            Type.Literal("paused"),
-            Type.Literal("unavailable"),
-          ]),
-        },
-        { additionalProperties: false },
-      ),
-      { maxItems: 5 },
-    ),
-    recent_operations: Type.Array(
-      Type.Object(
-        {
-          created_at: Type.String({ pattern: isoTimestampPattern }),
-          operation_id: Type.String({ pattern: "^[0-9a-fA-F-]{36}$" }),
-          operation_type: Type.String({ maxLength: 80, pattern: "^[a-z][a-z0-9_]+$" }),
-          result: Type.Union([Type.Literal("succeeded"), Type.Literal("rejected"), Type.Literal("failed")]),
-          target_ref: Type.String({ pattern: safeReferencePattern }),
-        },
-        { additionalProperties: false },
-      ),
-      { maxItems: 10 },
-    ),
-    asset_cleanup: Type.Object(
-      {
-        pending_jobs: Type.Integer({ minimum: 0 }),
-      },
-      { additionalProperties: false },
-    ),
-  },
-  { additionalProperties: false, $id: "AdminOverviewResponse" },
-);
-
-export type AdminOverviewResponse = Static<typeof AdminOverviewResponseSchema>;

packages/shared-contracts/src/index.ts

@@ -1,6 +1,5 @@
 export { Type } from "@sinclair/typebox";
 export * from "./api.js";
-export * from "./admin.js";
 export * from "./assets.js";
 export * from "./auth.js";
 export * from "./bootstrap.js";

scripts/lib/openapi.mjs

@@ -13,9 +13,7 @@ function runPnpm(args) {
 }
 
 export function buildApiContracts() {
-  runPnpm(["--filter", "@dada/asset-release-manifest", "build"]);
-  runPnpm(["--filter", "@dada/shared-contracts", "build"]);
-  runPnpm(["--filter", "@dada/api", "build"]);
+  runPnpm(["--filter", "@dada/api...", "build"]);
 }
 
 export async function createOpenApiDocument() {

scripts/run-wp6-01-validation.mjs

@@ -1,115 +0,0 @@
-import { createHash } from "node:crypto";
-import { spawnSync } from "node:child_process";
-import { copyFileSync, existsSync, mkdirSync, readFileSync, readdirSync, writeFileSync } from "node:fs";
-import { resolve } from "node:path";
-
-const phaseIndex = process.argv.indexOf("--phase");
-const phase = phaseIndex >= 0 ? process.argv[phaseIndex + 1] : "scaffold";
-if (!new Set(["red", "scaffold"]).has(phase)) throw new Error(`Unsupported phase: ${phase}`);
-
-const runId = process.env.DADA_TDD_RUN_ID ?? `wp6-01-${phase}-${new Date().toISOString().replace(/[^0-9]/g, "")}`;
-const runDirectory = resolve("artifacts", "tdd", runId);
-const caseDirectory = resolve(runDirectory, "cases", "TDD-WP6-ADM-001-role-and-summary");
-if (existsSync(runDirectory)) throw new Error(`Evidence run already exists: ${runId}`);
-mkdirSync(caseDirectory, { recursive: true });
-
-const environment = {
-  ...process.env,
-  DADA_EVIDENCE_DIR_ADMIN: caseDirectory,
-  DADA_PLAYWRIGHT_OUTPUT_DIR: resolve(runDirectory, "playwright-output"),
-  DADA_WP6_01_EVIDENCE_DIR: caseDirectory,
-};
-const commands = phase === "red"
-  ? [
-      ["api-red", "pnpm exec vitest run tests/api/wp6-01-admin-shell.test.ts"],
-      ["e2e-red", "pnpm exec playwright test tests/e2e/wp6-01-admin-shell.spec.ts --config playwright.config.ts"],
-    ]
-  : [
-      ["api", "pnpm test:api"],
-      ["e2e", "pnpm test:e2e"],
-      ["security", "pnpm test:security"],
-      ["tdd-trace", "pnpm validate:tdd-trace"],
-    ];
-
-const commandResults = [];
-for (const [name, command] of commands) {
-  const started_at = new Date().toISOString();
-  const result = spawnSync(process.env.ComSpec ?? "cmd.exe", ["/d", "/s", "/c", command], {
-    encoding: "utf8",
-    env: environment,
-    maxBuffer: 40 * 1024 * 1024,
-  });
-  if (result.stdout) process.stdout.write(result.stdout);
-  if (result.stderr) process.stderr.write(result.stderr);
-  commandResults.push({ command, exit_code: result.status ?? 1, finished_at: new Date().toISOString(), name, started_at });
-  if (phase === "scaffold" && (result.status ?? 1) !== 0) break;
-}
-
-const redConfirmed = phase === "red" && commandResults.length === commands.length && commandResults.every((item) => item.exit_code !== 0);
-if (phase === "red") {
-  writeFileSync(resolve(caseDirectory, "red-observation.json"), `${JSON.stringify({
-    expected_failure: "The protected admin overview route, nine-entry admin shell, denied-session redirect, and disabled-session ejection are absent before TASK-WP6-01.",
-    observed_commands: commandResults,
-    red_reason: "TDD-WP6-ADM-001 first Red: ordinary or preview subjects can reach the unguarded admin route, while no safe summary API exists.",
-    status: redConfirmed ? "red_confirmed" : "failed",
-  }, null, 2)}\n`);
-}
-
-function findFiles(directory, name) {
-  if (!existsSync(directory)) return [];
-  const matches = [];
-  for (const entry of readdirSync(directory, { withFileTypes: true })) {
-    const path = resolve(directory, entry.name);
-    if (entry.isDirectory()) matches.push(...findFiles(path, name));
-    else if (entry.name === name) matches.push(path);
-  }
-  return matches;
-}
-
-if (phase === "scaffold") {
-  const trace = findFiles(environment.DADA_PLAYWRIGHT_OUTPUT_DIR, "trace.zip")
-    .find((path) => path.toLowerCase().includes("wp6-01-admin-shell"));
-  if (trace) copyFileSync(trace, resolve(caseDirectory, "trace.zip"));
-}
-
-const expectedEvidence = phase === "red"
-  ? ["red-observation.json"]
-  : ["response.json", "db-access.json", "trace.zip", "screenshots/admin-denied.png", "screenshots/admin-overview.png"];
-const missingEvidence = expectedEvidence.filter((file) => !existsSync(resolve(caseDirectory, file)));
-const commandsPassed = phase === "scaffold" && commandResults.length === commands.length && commandResults.every((item) => item.exit_code === 0);
-const status = phase === "red"
-  ? redConfirmed && missingEvidence.length === 0 ? "red_confirmed" : "failed"
-  : commandsPassed && missingEvidence.length === 0 ? "red" : "failed";
-const commit = spawnSync("git", ["rev-parse", "HEAD"], { encoding: "utf8" }).stdout.trim();
-const wp5BaselineSha = spawnSync("git", ["rev-parse", "origin/codex/wp5-04"], { encoding: "utf8" }).stdout.trim();
-const manifest = {
-  path: "tasks.manifest.json",
-  sha256: createHash("sha256").update(readFileSync("tasks.manifest.json")).digest("hex").toUpperCase(),
-};
-const result = {
-  acceptance_criteria: ["AC-25", "AC-49"],
-  automation: ["automated"],
-  commit,
-  dependency_gate: {
-    blocked_by: ["TASK-WP5-05", "TASK-WP5-06", "TASK-WP5-07"],
-    baseline_remote_branch: "origin/codex/wp5-04",
-    baseline_remote_sha: wp5BaselineSha,
-    final_green_allowed: false,
-  },
-  evidence_refs: expectedEvidence,
-  layer: ["API", "E2E"],
-  manifest,
-  missing_evidence: missingEvidence,
-  phase,
-  requirements: ["ADMIN-01", "ADMIN-02", "ADMIN-04", "ADMIN-08"],
-  run_id: runId,
-  status,
-  task_id: "TASK-WP6-01",
-  test_id: "TDD-WP6-ADM-001-role-and-summary",
-  work_package: "WP-6",
-};
-writeFileSync(resolve(caseDirectory, "commands.json"), `${JSON.stringify({ commands: commandResults, phase, run_id: runId }, null, 2)}\n`);
-writeFileSync(resolve(caseDirectory, "result.json"), `${JSON.stringify(result, null, 2)}\n`);
-writeFileSync(resolve(runDirectory, "evidence.json"), `${JSON.stringify({ cases: [{ missing_evidence: missingEvidence, status, test_id: result.test_id }], phase, run_id: runId, status }, null, 2)}\n`);
-console.log(JSON.stringify({ phase, run_id: runId, status }, null, 2));
-if (status === "failed") process.exit(1);

tests/api/wp5-07-preview-grants.test.ts

@@ -0,0 +1,179 @@
+import { randomUUID } from "node:crypto";
+import { mkdtempSync, rmSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+
+import { afterEach, describe, expect, it } from "vitest";
+
+import { createApp } from "../../apps/api/src/app.js";
+import { AssetPreviewGrantService } from "../../apps/api/src/preview-grants.js";
+import { RegistrationService } from "../../apps/api/src/registration.js";
+import { MockResendAdapter } from "../../apps/api/src/resend-adapter.js";
+import { createAssetReleaseManifest } from "../../packages/asset-release-manifest/src/index.js";
+
+const start = Date.parse("2026-08-04T08:00:00.000Z");
+const releaseVersion = "asset-20260804.1";
+const previewResourceId = "8f9b5c62-7488-4c7a-9f0c-3b8f3fc34f92";
+const roots: string[] = [];
+const registrations: RegistrationService[] = [];
+
+function harness() {
+  const root = mkdtempSync(join(tmpdir(), "dada-wp5-07-"));
+  roots.push(root);
+  let now = start;
+  const registration = new RegistrationService({
+    challengePepper: Buffer.alloc(32, 0x71),
+    clock: () => now,
+    currentPrivacyNoticeVersion: "p0a-registration-notice-v1",
+    databasePath: join(root, "dada.sqlite3"),
+    invitePepper: Buffer.alloc(32, 0x72),
+    resend: new MockResendAdapter(),
+    sessionPepper: Buffer.alloc(32, 0x73),
+  });
+  registrations.push(registration);
+  const userId = randomUUID();
+  registration.database.prepare(`
+    INSERT INTO users (
+      user_id, normalized_email, role, status, counts_toward_stage_limit,
+      registration_id, created_at
+    ) VALUES (?, ?, 'user', 'active', 1, ?, ?)
+  `).run(userId, `${userId}@example.invalid`, randomUUID(), start);
+  registration.database.prepare(`
+    INSERT INTO user_profiles (user_id, creator_name, social_id)
+    VALUES (?, 'Preview User', '@preview_user')
+  `).run(userId);
+  registration.database.prepare(`
+    INSERT INTO credit_accounts (user_id, available_balance, reserved_balance, updated_at)
+    VALUES (?, 10, 0, ?)
+  `).run(userId, start);
+  const adminId = randomUUID();
+  registration.database.prepare(`
+    INSERT INTO users (
+      user_id, normalized_email, role, status, counts_toward_stage_limit,
+      registration_id, created_at
+    ) VALUES (?, ?, 'super_admin', 'active', 0, ?, ?)
+  `).run(adminId, `${adminId}@example.invalid`, randomUUID(), start);
+  registration.database.prepare("INSERT INTO admin_access (user_id, allowed) VALUES (?, 1)").run(adminId);
+  const assetReleases = createAssetReleaseManifest({
+    items: [{
+      access_class: "internal_preview_asset",
+      content: Buffer.from("preview-content"),
+      mime_type: "image/webp",
+      relative_path: "preview/TEMPLATE.webp",
+      resource_id: previewResourceId,
+      root_ref: "canonical-assets",
+    }],
+    release_version: releaseVersion,
+  });
+  const service = new AssetPreviewGrantService({ assetReleases, registration, clock: () => now });
+  return {
+    advance(milliseconds: number) { now += milliseconds; },
+    adminId,
+    registration,
+    service,
+    userId,
+  };
+}
+
+afterEach(() => {
+  for (const registration of registrations.splice(0)) registration.close();
+  for (const root of roots.splice(0)) rmSync(root, { force: true, recursive: true });
+});
+
+describe("TASK-WP5-07 internal preview grant lifecycle", () => {
+  it("keeps ordinary role, returns randomized manifest item IDs, and blocks revoked/expired grants", () => {
+    const test = harness();
+    const batch = test.service.createBatch({
+      name: "WP5 preview batch",
+      adminUserId: test.adminId,
+    });
+    test.service.addBatchItems({
+      adminUserId: test.adminId,
+      batchId: batch.batchId,
+      releaseVersion,
+      resourceIds: [previewResourceId],
+    });
+    const grant = test.service.grant({
+      adminUserId: test.adminId,
+      batchId: batch.batchId,
+      expiresAt: start + 60_000,
+      userId: test.userId,
+    });
+
+    const firstManifest = test.service.projectManifest({ releaseVersion, userId: test.userId });
+    expect(firstManifest?.items).toHaveLength(1);
+    expect(firstManifest?.items[0].resource_id).not.toBe(previewResourceId);
+    expect(firstManifest?.items[0].url).toContain(firstManifest?.items[0].resource_id ?? "");
+    expect(test.service.readManifestItem({
+      manifestItemId: firstManifest!.items[0].resource_id,
+      releaseVersion,
+      userId: test.userId,
+    })?.bytes).toEqual(Buffer.from("preview-content"));
+    expect(test.registration.database.prepare("SELECT role FROM users WHERE user_id = ?").get(test.userId)).toEqual({ role: "user" });
+
+    test.service.revoke({ adminUserId: test.adminId, grantId: grant.grantId });
+    expect(test.service.projectManifest({ releaseVersion, userId: test.userId })).toBeUndefined();
+    expect(test.service.readManifestItem({
+      manifestItemId: firstManifest!.items[0].resource_id,
+      releaseVersion,
+      userId: test.userId,
+    })).toBeUndefined();
+
+    const secondGrant = test.service.grant({
+      adminUserId: test.adminId,
+      batchId: batch.batchId,
+      expiresAt: start + 10_000,
+      userId: test.userId,
+    });
+    expect(secondGrant.status).toBe("active");
+    test.advance(10_001);
+    expect(test.service.projectManifest({ releaseVersion, userId: test.userId })).toBeUndefined();
+    expect(test.registration.database.prepare("SELECT status FROM asset_preview_grants WHERE grant_id = ?").get(secondGrant.grantId)).toEqual({ status: "expired" });
+
+    test.registration.database.prepare("UPDATE users SET status = 'active' WHERE user_id = ?").run(test.userId);
+    test.service.grant({
+      adminUserId: test.adminId,
+      batchId: batch.batchId,
+      expiresAt: start + 120_000,
+      userId: test.userId,
+    });
+    test.registration.changeUserStatus(test.userId, "suspended");
+    expect(test.service.projectManifest({ releaseVersion, userId: test.userId })).toBeUndefined();
+    expect(test.registration.database.prepare("SELECT COUNT(*) AS count FROM admin_operation_logs WHERE operation_type LIKE 'preview_grant_%'").get()).toEqual({ count: 5 });
+  });
+
+  it("serves the randomized item through the authenticated no-store route", async () => {
+    const test = harness();
+    const batch = test.service.createBatch({ name: "WP5 route batch", adminUserId: test.adminId });
+    test.service.addBatchItems({
+      adminUserId: test.adminId,
+      batchId: batch.batchId,
+      releaseVersion,
+      resourceIds: [previewResourceId],
+    });
+    const grant = test.service.grant({ adminUserId: test.adminId, batchId: batch.batchId, expiresAt: start + 60_000, userId: test.userId });
+    const session = test.registration.issueAuthenticatedSession(test.userId, "user");
+    const app = await createApp({
+      browserGate: false,
+      networkBoundary: { allowTestPort: true },
+      previewGrants: test.service,
+      registration: test.registration,
+    });
+    try {
+      const headers = { cookie: `dada_session=${session.sessionToken}`, host: "127.0.0.1:43121", origin: "http://127.0.0.1:43121" };
+      const manifest = await app.inject({ headers, method: "GET", url: `/api/v1/assets/preview/${releaseVersion}/manifest` });
+      expect(manifest.statusCode).toBe(200);
+      const itemId = manifest.json().items[0].resource_id;
+      expect(itemId).not.toBe(previewResourceId);
+      const asset = await app.inject({ headers, method: "GET", url: `/api/v1/assets/preview/${releaseVersion}/${itemId}` });
+      expect(asset.statusCode).toBe(200);
+      expect(asset.headers["cache-control"]).toBe("private, no-store");
+      expect(asset.rawPayload).toEqual(Buffer.from("preview-content"));
+      test.service.revoke({ adminUserId: test.adminId, grantId: grant.grantId });
+      const revoked = await app.inject({ headers, method: "GET", url: `/api/v1/assets/preview/${releaseVersion}/${itemId}` });
+      expect(revoked.statusCode).toBe(404);
+    } finally {
+      await app.close();
+    }
+  });
+});

tests/api/wp6-01-admin-shell.test.ts

@@ -1,140 +0,0 @@
-import { randomUUID } from "node:crypto";
-import { mkdirSync, mkdtempSync, rmSync, writeFileSync } from "node:fs";
-import { tmpdir } from "node:os";
-import { join, resolve } from "node:path";
-
-import { afterEach, describe, expect, it } from "vitest";
-
-import { createApp } from "../../apps/api/src/app.js";
-import { RegistrationService } from "../../apps/api/src/registration.js";
-import { MockResendAdapter } from "../../apps/api/src/resend-adapter.js";
-import { adminOverviewFixture } from "../fixtures/wp6-01-admin-overview.js";
-
-const roots: string[] = [];
-const services: RegistrationService[] = [];
-const now = Date.parse("2026-08-03T09:30:00.000Z");
-const requestHeaders = { host: "127.0.0.1:43121", origin: "http://127.0.0.1:43121" };
-
-function createRegistration() {
-  const root = mkdtempSync(join(tmpdir(), "dada-wp6-01-api-"));
-  roots.push(root);
-  const registration = new RegistrationService({
-    adminAllowlistPepper: Buffer.alloc(32, 0xd1),
-    challengePepper: Buffer.alloc(32, 0xd2),
-    clock: () => now,
-    currentPrivacyNoticeVersion: "p0a-registration-notice-v1",
-    databasePath: join(root, "dada.sqlite3"),
-    invitePepper: Buffer.alloc(32, 0xd3),
-    resend: new MockResendAdapter(),
-    sessionPepper: Buffer.alloc(32, 0xd4),
-  });
-  services.push(registration);
-  return registration;
-}
-
-function seedSubject(registration: RegistrationService, role: "super_admin" | "user") {
-  const userId = randomUUID();
-  registration.database.prepare(`
-    INSERT INTO users (
-      user_id, normalized_email, role, status, counts_toward_stage_limit,
-      registration_id, created_at
-    ) VALUES (?, ?, ?, 'active', ?, ?, ?)
-  `).run(userId, `${role}-${userId}@example.invalid`, role, role === "user" ? 1 : 0, randomUUID(), now);
-  if (role === "super_admin") {
-    registration.database.prepare("INSERT INTO admin_access (user_id, allowed) VALUES (?, 1)").run(userId);
-  }
-  return userId;
-}
-
-function tableCounts(registration: RegistrationService) {
-  return {
-    admin: (registration.database.prepare("SELECT COUNT(*) AS count FROM admin_operation_logs").get() as { count: number }).count,
-    private: (registration.database.prepare("SELECT COUNT(*) AS count FROM private_content_access_logs").get() as { count: number }).count,
-  };
-}
-
-afterEach(() => {
-  for (const service of services.splice(0)) service.close();
-  for (const root of roots.splice(0)) rmSync(root, { force: true, recursive: true });
-});
-
-describe("TDD-WP6-ADM-001-role-and-summary", () => {
-  it("authorizes only an active admin audience and returns a schema-redacted summary", async () => {
-    const registration = createRegistration();
-    const adminId = seedSubject(registration, "super_admin");
-    const ordinaryId = seedSubject(registration, "user");
-    const previewId = seedSubject(registration, "user");
-    registration.database.exec("CREATE TABLE asset_preview_grants_fixture (user_id TEXT PRIMARY KEY, status TEXT NOT NULL)");
-    registration.database.prepare("INSERT INTO asset_preview_grants_fixture (user_id, status) VALUES (?, 'active')").run(previewId);
-
-    const adminSession = registration.issueAuthenticatedSession(adminId, "admin");
-    const ordinarySession = registration.issueAuthenticatedSession(ordinaryId, "user");
-    const previewSession = registration.issueAuthenticatedSession(previewId, "user");
-    let providerCalls = 0;
-    const app = await createApp({
-      adminOverview: async () => {
-        providerCalls += 1;
-        return {
-          ...adminOverviewFixture,
-          absolute_path: "forbidden-path-trap",
-          ["api" + "_key"]: "forbidden-key-trap",
-          private_prompt: "forbidden-prompt-trap",
-          recent_operations: adminOverviewFixture.recent_operations.map((operation) => ({
-            ...operation,
-            actor_email: "forbidden@example.invalid",
-          })),
-        };
-      },
-      browserGate: false,
-      networkBoundary: { allowTestPort: true },
-      registration,
-    });
-
-    for (const token of [undefined, ordinarySession.sessionToken, previewSession.sessionToken]) {
-      const response = await app.inject({
-        headers: token ? { ...requestHeaders, cookie: `dada_admin_session=${token}` } : requestHeaders,
-        method: "GET",
-        url: "/api/v1/admin/overview",
-      });
-      expect(response.statusCode).toBe(401);
-    }
-    expect(providerCalls).toBe(0);
-
-    const before = tableCounts(registration);
-    const allowed = await app.inject({
-      headers: { ...requestHeaders, cookie: `dada_admin_session=${adminSession.sessionToken}` },
-      method: "GET",
-      url: "/api/v1/admin/overview",
-    });
-    expect(allowed.statusCode).toBe(200);
-    expect(allowed.json()).toEqual(adminOverviewFixture);
-    expect(JSON.stringify(allowed.json())).not.toMatch(/absolute_path|api_key|private_prompt|actor_email|forbidden/i);
-    expect(providerCalls).toBe(1);
-    expect(tableCounts(registration)).toEqual(before);
-
-    registration.revokeAdminSessions(adminId, "disabled");
-    const afterDisable = tableCounts(registration);
-    const revoked = await app.inject({
-      headers: { ...requestHeaders, cookie: `dada_admin_session=${adminSession.sessionToken}` },
-      method: "GET",
-      url: "/api/v1/admin/overview",
-    });
-    expect(revoked.statusCode).toBe(401);
-    expect(providerCalls).toBe(1);
-    expect(tableCounts(registration)).toEqual(afterDisable);
-    const evidenceRoot = process.env.DADA_WP6_01_EVIDENCE_DIR;
-    if (evidenceRoot) {
-      mkdirSync(evidenceRoot, { recursive: true });
-      writeFileSync(resolve(evidenceRoot, "response.json"), `${JSON.stringify({
-        active_admin: allowed.json(),
-        denied_statuses: { anonymous: 401, ordinary: 401, preview: 401, suspended_admin: revoked.statusCode },
-      }, null, 2)}\n`);
-      writeFileSync(resolve(evidenceRoot, "db-access.json"), `${JSON.stringify({
-        active_read_delta: { admin_operation_logs: 0, private_content_access_logs: 0 },
-        denied_read_delta: { admin_operation_logs: 0, private_content_access_logs: 0 },
-        provider_calls: providerCalls,
-      }, null, 2)}\n`);
-    }
-    await app.close();
-  });
-});

tests/e2e/wp6-01-admin-shell.spec.ts

@@ -1,137 +0,0 @@
-import { mkdirSync } from "node:fs";
-import { resolve } from "node:path";
-
-import { expect, test, type Page } from "@playwright/test";
-import { createServer, type ViteDevServer } from "vite";
-
-import { adminOverviewFixture } from "../fixtures/wp6-01-admin-overview.js";
-
-let vite: ViteDevServer;
-let webUrl: string;
-
-const adminSession = {
-  acknowledged_private_content_notice_version: null,
-  admin: { role: "super_admin", status: "active", user_id: "00000000-0000-4000-8000-000000000601" },
-  audience: "admin",
-  authenticated: true,
-  csrf_token: "csrf-admin-shell-fixture-000000000000000000000000000000000",
-  current_private_content_notice_version: null,
-  expires_at: "2026-09-02T09:30:00.000Z",
-  notice_acknowledged: false,
-};
-
-const navigation = [
-  ["总览", "/admin"],
-  ["用户与点数", "/admin/users"],
-  ["邀请码", "/admin/invites"],
-  ["模型", "/admin/models"],
-  ["素材", "/admin/assets"],
-  ["内部预览", "/admin/preview"],
-  ["生成记录", "/admin/generations"],
-  ["服务与存储", "/admin/services-storage"],
-  ["审计", "/admin/audit"],
-] as const;
-
-test.beforeAll(async () => {
-  vite = await createServer({
-    configFile: resolve("apps/web/vite.config.ts"),
-    root: resolve("apps/web"),
-    server: { host: "127.0.0.1", port: 0 },
-  });
-  await vite.listen();
-  const address = vite.httpServer?.address();
-  if (!address || typeof address === "string") throw new Error("Vite did not expose a test port.");
-  webUrl = `http://127.0.0.1:${address.port}`;
-});
-
-test.afterAll(async () => vite.close());
-
-async function routeActiveAdmin(page: Page) {
-  await page.route("**/api/v1/admin-auth/session", (route) => route.fulfill({
-    body: JSON.stringify(adminSession),
-    contentType: "application/json",
-    status: 200,
-  }));
-  await page.route("**/api/v1/admin/overview", (route) => route.fulfill({
-    body: JSON.stringify(adminOverviewFixture),
-    contentType: "application/json",
-    status: 200,
-  }));
-}
-
-test("TDD-WP6-ADM-001-role-and-summary renders the protected nine-entry admin shell", async ({ page }) => {
-  const requests: string[] = [];
-  page.on("request", (request) => requests.push(request.url()));
-  await routeActiveAdmin(page);
-  await page.goto(`${webUrl}/admin`);
-
-  await expect(page.getByRole("heading", { level: 2, name: "运营总览" })).toBeVisible();
-  const sidebar = page.getByRole("navigation", { name: "后台主导航" });
-  await expect(sidebar).toBeVisible();
-  for (const [name, href] of navigation) {
-    await expect(sidebar.getByRole("link", { name, exact: true })).toHaveAttribute("href", href);
-  }
-  expect(Math.round((await sidebar.boundingBox())?.width ?? 0)).toBe(216);
-  await expect(page.getByText("4 / 10", { exact: true })).toBeVisible();
-  await expect(page.getByText("待人工核对 1", { exact: true })).toBeVisible();
-  await expect(page.getByText("85.0%", { exact: true })).toBeVisible();
-  await expect(page.getByRole("link", { name: "有异常", exact: true })).toBeVisible();
-  await expect(page.locator("body")).not.toContainText(/forbidden|example\.invalid|api[_ -]?key|完整提示词/i);
-  expect(requests.some((url) => /prompt|private-content|image-content/i.test(url))).toBe(false);
-
-  const evidenceRoot = process.env.DADA_EVIDENCE_DIR_ADMIN;
-  if (evidenceRoot) {
-    const screenshotDirectory = resolve(evidenceRoot, "screenshots");
-    mkdirSync(screenshotDirectory, { recursive: true });
-    await page.screenshot({ fullPage: true, path: resolve(screenshotDirectory, "admin-overview.png") });
-  }
-});
-
-test("TDD-WP6-ADM-001-role-and-summary keeps ordinary and preview sessions outside admin", async ({ page }) => {
-  let overviewCalls = 0;
-  await page.route("**/api/v1/admin-auth/session", (route) => route.fulfill({
-    body: JSON.stringify({ error: { code: "AUTH_SESSION_INVALID", subject: "preview_user" } }),
-    contentType: "application/json",
-    status: 401,
-  }));
-  await page.route("**/api/v1/admin/overview", (route) => {
-    overviewCalls += 1;
-    return route.fulfill({ body: "null", contentType: "application/json", status: 401 });
-  });
-
-  await page.goto(`${webUrl}/admin`);
-  await expect(page).toHaveURL(`${webUrl}/admin/login`);
-  await expect(page.getByRole("heading", { name: "管理员邮箱验证码登录" })).toBeVisible();
-  expect(overviewCalls).toBe(0);
-  await expect(page.getByText("DADA ADMIN", { exact: true })).toHaveCount(0);
-  const evidenceRoot = process.env.DADA_EVIDENCE_DIR_ADMIN;
-  if (evidenceRoot) {
-    const screenshotDirectory = resolve(evidenceRoot, "screenshots");
-    mkdirSync(screenshotDirectory, { recursive: true });
-    await page.screenshot({ fullPage: true, path: resolve(screenshotDirectory, "admin-denied.png") });
-  }
-});
-
-test("TDD-WP6-ADM-001-role-and-summary ejects a disabled admin when the session is rechecked", async ({ page }) => {
-  let active = true;
-  await page.route("**/api/v1/admin-auth/session", (route) => route.fulfill(active ? {
-    body: JSON.stringify(adminSession),
-    contentType: "application/json",
-    status: 200,
-  } : {
-    body: JSON.stringify({ error: { code: "AUTH_SESSION_INVALID" } }),
-    contentType: "application/json",
-    status: 401,
-  }));
-  await page.route("**/api/v1/admin/overview", (route) => route.fulfill({
-    body: JSON.stringify(adminOverviewFixture),
-    contentType: "application/json",
-    status: 200,
-  }));
-  await page.goto(`${webUrl}/admin`);
-  await expect(page.getByRole("heading", { level: 2, name: "运营总览" })).toBeVisible();
-
-  active = false;
-  await page.evaluate(() => window.dispatchEvent(new Event("dada:session-invalid")));
-  await expect(page).toHaveURL(`${webUrl}/admin/login`);
-});

tests/fixtures/wp6-01-admin-overview.ts

@@ -1,44 +0,0 @@
-export const adminOverviewFixture = {
-  generated_at: "2026-08-03T09:30:00.000Z",
-  user_slots: {
-    active_and_suspended: 4,
-    limit: 10,
-  },
-  generation_jobs: {
-    pending_manual_review: 1,
-    pending_manual_review_oldest_at: "2026-08-03T09:12:00.000Z",
-    queued: 2,
-    running: 1,
-  },
-  models: {
-    configured_default_model_id: "gemini-3.1-flash-image-preview",
-    configured_model_count: 3,
-    recommended_model_id: "gemini-3-pro-image-preview",
-    runtime_available_count: 2,
-  },
-  storage: {
-    last_measured_at: "2026-08-03T09:29:00.000Z",
-    limit_bytes: 5_368_709_120,
-    managed_content_bytes: 4_563_402_752,
-    status: "critical" as const,
-  },
-  services: [
-    { checked_at: "2026-08-03T09:29:00.000Z", service_id: "resend", status: "available" as const },
-    { checked_at: "2026-08-03T09:29:00.000Z", service_id: "amap", status: "available" as const },
-    { checked_at: "2026-08-03T09:29:00.000Z", service_id: "ai_gateway", status: "degraded" as const },
-    { checked_at: "2026-08-03T09:29:00.000Z", service_id: "worker", status: "available" as const },
-    { checked_at: "2026-08-03T09:29:00.000Z", service_id: "asset_root", status: "degraded" as const },
-  ],
-  recent_operations: [
-    {
-      created_at: "2026-08-03T09:20:00.000Z",
-      operation_id: "00000000-0000-4000-8000-000000000621",
-      operation_type: "model_configuration_update",
-      result: "succeeded" as const,
-      target_ref: "model-config-set:7",
-    },
-  ],
-  asset_cleanup: {
-    pending_jobs: 0,
-  },
-};