feat: bootstrap auto virtual tryon admin frontend

app/(dashboard)/layout.tsx

@@ -0,0 +1,11 @@
+import type { ReactNode } from "react";
+
+import { DashboardShell } from "@/components/layout/dashboard-shell";
+
+type DashboardLayoutProps = {
+  children: ReactNode;
+};
+
+export default function DashboardLayout({ children }: DashboardLayoutProps) {
+  return <DashboardShell>{children}</DashboardShell>;
+}

app/(dashboard)/libraries/garments/page.tsx

@@ -0,0 +1,5 @@
+import { LibraryPageScreen } from "@/features/libraries/library-page";
+
+export default function GarmentsLibraryPage() {
+  return <LibraryPageScreen libraryType="garments" />;
+}

app/(dashboard)/libraries/models/page.tsx

@@ -0,0 +1,5 @@
+import { LibraryPageScreen } from "@/features/libraries/library-page";
+
+export default function ModelsLibraryPage() {
+  return <LibraryPageScreen libraryType="models" />;
+}

app/(dashboard)/libraries/scenes/page.tsx

@@ -0,0 +1,5 @@
+import { LibraryPageScreen } from "@/features/libraries/library-page";
+
+export default function ScenesLibraryPage() {
+  return <LibraryPageScreen libraryType="scenes" />;
+}

app/(dashboard)/orders/[orderId]/page.tsx

@@ -0,0 +1,15 @@
+import { OrderDetailScreen } from "@/features/orders/order-detail";
+
+type OrderDetailPageProps = {
+  params: Promise<{
+    orderId: string;
+  }>;
+};
+
+export default async function OrderDetailPage({
+  params,
+}: OrderDetailPageProps) {
+  const { orderId } = await params;
+
+  return <OrderDetailScreen orderId={Number(orderId)} />;
+}

app/(dashboard)/orders/page.tsx

@@ -0,0 +1,5 @@
+import { OrdersHomeScreen } from "@/features/orders/orders-home";
+
+export default function OrdersPage() {
+  return <OrdersHomeScreen />;
+}

app/(dashboard)/reviews/workbench/[orderId]/page.tsx

@@ -0,0 +1,15 @@
+import { ReviewWorkbenchDetailScreen } from "@/features/reviews/review-workbench-detail";
+
+type ReviewWorkbenchDetailPageProps = {
+  params: Promise<{
+    orderId: string;
+  }>;
+};
+
+export default async function ReviewWorkbenchDetailPage({
+  params,
+}: ReviewWorkbenchDetailPageProps) {
+  const { orderId } = await params;
+
+  return <ReviewWorkbenchDetailScreen orderId={Number(orderId)} />;
+}

app/(dashboard)/reviews/workbench/page.tsx

@@ -0,0 +1,5 @@
+import { ReviewWorkbenchListScreen } from "@/features/reviews/review-workbench-list";
+
+export default function ReviewWorkbenchPage() {
+  return <ReviewWorkbenchListScreen />;
+}

app/(dashboard)/settings/page.tsx

@@ -0,0 +1,5 @@
+import { SettingsPlaceholder } from "@/features/settings/settings-placeholder";
+
+export default function SettingsPage() {
+  return <SettingsPlaceholder />;
+}

app/(dashboard)/submit-workbench/page.tsx

@@ -0,0 +1,5 @@
+import { SubmitWorkbench } from "@/features/orders/submit-workbench";
+
+export default function SubmitWorkbenchPage() {
+  return <SubmitWorkbench />;
+}

app/(dashboard)/workflows/[orderId]/page.tsx

@@ -0,0 +1,15 @@
+import { WorkflowDetailScreen } from "@/features/workflows/workflow-detail";
+
+type WorkflowDetailPageProps = {
+  params: Promise<{
+    orderId: string;
+  }>;
+};
+
+export default async function WorkflowDetailPage({
+  params,
+}: WorkflowDetailPageProps) {
+  const { orderId } = await params;
+
+  return <WorkflowDetailScreen orderId={Number(orderId)} />;
+}

app/(dashboard)/workflows/page.tsx

@@ -0,0 +1,5 @@
+import { WorkflowLookupScreen } from "@/features/workflows/workflow-lookup";
+
+export default function WorkflowsPage() {
+  return <WorkflowLookupScreen />;
+}

app/api/dashboard/orders-overview/route.ts

@@ -0,0 +1,63 @@
+import { adaptOrderSummary } from "@/lib/adapters/orders";
+import { backendRequest } from "@/lib/http/backend-client";
+import {
+  jsonSuccess,
+  parsePositiveIntegerParam,
+  withErrorHandling,
+} from "@/lib/http/response";
+import type { OrderListResponseDto, OrderStatus } from "@/lib/types/backend";
+
+const MESSAGE = "订单总览当前显示真实后端最近订单。";
+const DEFAULT_LIMIT = 6;
+const ALLOWED_STATUS = new Set<OrderStatus>([
+  "created",
+  "running",
+  "waiting_review",
+  "succeeded",
+  "failed",
+  "cancelled",
+]);
+
+export async function GET(request: Request) {
+  return withErrorHandling(async () => {
+    const url = new URL(request.url);
+    const pageParam = url.searchParams.get("page");
+    const limitParam = url.searchParams.get("limit");
+    const queryParam = url.searchParams.get("query")?.trim();
+    const statusParam = url.searchParams.get("status")?.trim();
+    const params = new URLSearchParams({
+      page: String(
+        pageParam ? parsePositiveIntegerParam(pageParam, "page") : 1,
+      ),
+      limit: String(
+        limitParam ? parsePositiveIntegerParam(limitParam, "limit") : DEFAULT_LIMIT,
+      ),
+    });
+
+    if (statusParam && ALLOWED_STATUS.has(statusParam as OrderStatus)) {
+      params.set("status", statusParam);
+    }
+
+    if (queryParam) {
+      params.set("query", queryParam);
+    }
+
+    const response = await backendRequest<OrderListResponseDto>(
+      `/orders?${params.toString()}`,
+    );
+
+    return jsonSuccess(
+      {
+        page: response.data.page,
+        limit: response.data.limit,
+        total: response.data.total,
+        totalPages: response.data.total_pages,
+        items: response.data.items.map(adaptOrderSummary),
+      },
+      {
+        mode: "proxy",
+        message: MESSAGE,
+      },
+    );
+  });
+}

app/api/dashboard/workflow-lookup/route.ts

@@ -0,0 +1,63 @@
+import { adaptWorkflowLookupItem } from "@/lib/adapters/workflows";
+import { backendRequest } from "@/lib/http/backend-client";
+import {
+  jsonSuccess,
+  parsePositiveIntegerParam,
+  withErrorHandling,
+} from "@/lib/http/response";
+import type { OrderStatus, WorkflowListResponseDto } from "@/lib/types/backend";
+
+const MESSAGE = "流程追踪首页当前显示真实后端最近流程。";
+const DEFAULT_LIMIT = 8;
+const ALLOWED_STATUS = new Set<OrderStatus>([
+  "created",
+  "running",
+  "waiting_review",
+  "succeeded",
+  "failed",
+  "cancelled",
+]);
+
+export async function GET(request: Request) {
+  return withErrorHandling(async () => {
+    const url = new URL(request.url);
+    const pageParam = url.searchParams.get("page");
+    const limitParam = url.searchParams.get("limit");
+    const queryParam = url.searchParams.get("query")?.trim();
+    const statusParam = url.searchParams.get("status")?.trim();
+    const params = new URLSearchParams({
+      page: String(
+        pageParam ? parsePositiveIntegerParam(pageParam, "page") : 1,
+      ),
+      limit: String(
+        limitParam ? parsePositiveIntegerParam(limitParam, "limit") : DEFAULT_LIMIT,
+      ),
+    });
+
+    if (statusParam && ALLOWED_STATUS.has(statusParam as OrderStatus)) {
+      params.set("status", statusParam);
+    }
+
+    if (queryParam) {
+      params.set("query", queryParam);
+    }
+
+    const response = await backendRequest<WorkflowListResponseDto>(
+      `/workflows?${params.toString()}`,
+    );
+
+    return jsonSuccess(
+      {
+        page: response.data.page,
+        limit: response.data.limit,
+        total: response.data.total,
+        totalPages: response.data.total_pages,
+        items: response.data.items.map(adaptWorkflowLookupItem),
+      },
+      {
+        mode: "proxy",
+        message: MESSAGE,
+      },
+    );
+  });
+}

app/api/libraries/[libraryType]/route.ts

@@ -0,0 +1,45 @@
+import {
+  GARMENT_LIBRARY_FIXTURES,
+  MODEL_LIBRARY_FIXTURES,
+  SCENE_LIBRARY_FIXTURES,
+} from "@/lib/mock/libraries";
+import { RouteError, jsonSuccess, withErrorHandling } from "@/lib/http/response";
+import type { LibraryItemVM, LibraryType } from "@/lib/types/view-models";
+
+type RouteContext = {
+  params: Promise<{
+    libraryType: string;
+  }>;
+};
+
+const LIBRARY_FIXTURE_MAP: Record<LibraryType, LibraryItemVM[]> = {
+  models: MODEL_LIBRARY_FIXTURES,
+  scenes: SCENE_LIBRARY_FIXTURES,
+  garments: GARMENT_LIBRARY_FIXTURES,
+};
+
+const MESSAGE = "资源库当前使用占位数据，真实后端接口尚未提供。";
+
+function isLibraryType(value: string): value is LibraryType {
+  return Object.hasOwn(LIBRARY_FIXTURE_MAP, value);
+}
+
+export async function GET(_request: Request, context: RouteContext) {
+  return withErrorHandling(async () => {
+    const { libraryType } = await context.params;
+
+    if (!isLibraryType(libraryType)) {
+      throw new RouteError(404, "NOT_FOUND", "不支持的资源库类型。");
+    }
+
+    return jsonSuccess(
+      {
+        items: LIBRARY_FIXTURE_MAP[libraryType],
+      },
+      {
+        mode: "placeholder",
+        message: MESSAGE,
+      },
+    );
+  });
+}

app/api/orders/[orderId]/assets/route.ts

@@ -0,0 +1,36 @@
+import { adaptAsset } from "@/lib/adapters/orders";
+import { backendRequest } from "@/lib/http/backend-client";
+import {
+  jsonSuccess,
+  parsePositiveIntegerParam,
+  withErrorHandling,
+} from "@/lib/http/response";
+import type { AssetDto } from "@/lib/types/backend";
+import { businessEmptyState, READY_STATE } from "@/lib/types/view-models";
+
+type RouteContext = {
+  params: Promise<{
+    orderId: string;
+  }>;
+};
+
+export async function GET(_request: Request, context: RouteContext) {
+  return withErrorHandling(async () => {
+    const { orderId: rawOrderId } = await context.params;
+    const orderId = parsePositiveIntegerParam(rawOrderId, "orderId");
+    const response = await backendRequest<AssetDto[]>(`/orders/${orderId}/assets`);
+    const items = response.data.map(adaptAsset);
+
+    return jsonSuccess(
+      {
+        items,
+        state: items.length
+          ? READY_STATE
+          : businessEmptyState("暂无资产", "当前订单还没有生成可查看的资产列表。"),
+      },
+      {
+        mode: "proxy",
+      },
+    );
+  });
+}

app/api/orders/[orderId]/revisions/route.ts

@@ -0,0 +1,54 @@
+import { adaptRevisionChain, adaptRevisionRegistration } from "@/lib/adapters/revisions";
+import { backendRequest } from "@/lib/http/backend-client";
+import {
+  jsonSuccess,
+  parseJsonBody,
+  parsePositiveIntegerParam,
+  withErrorHandling,
+} from "@/lib/http/response";
+import type {
+  RegisterRevisionResponseDto,
+  RevisionChainResponseDto,
+} from "@/lib/types/backend";
+import { parseRegisterRevisionPayload } from "@/lib/validation/revision";
+
+type RouteContext = {
+  params: Promise<{
+    orderId: string;
+  }>;
+};
+
+export async function GET(_request: Request, context: RouteContext) {
+  return withErrorHandling(async () => {
+    const { orderId: rawOrderId } = await context.params;
+    const orderId = parsePositiveIntegerParam(rawOrderId, "orderId");
+    const response = await backendRequest<RevisionChainResponseDto>(
+      `/orders/${orderId}/revisions`,
+    );
+
+    return jsonSuccess(adaptRevisionChain(response.data), {
+      mode: "proxy",
+    });
+  });
+}
+
+export async function POST(request: Request, context: RouteContext) {
+  return withErrorHandling(async () => {
+    const { orderId: rawOrderId } = await context.params;
+    const orderId = parsePositiveIntegerParam(rawOrderId, "orderId");
+    const rawPayload = await parseJsonBody(request);
+    const payload = parseRegisterRevisionPayload(rawPayload);
+    const response = await backendRequest<RegisterRevisionResponseDto>(
+      `/orders/${orderId}/revisions`,
+      {
+        method: "POST",
+        body: JSON.stringify(payload),
+      },
+    );
+
+    return jsonSuccess(adaptRevisionRegistration(response.data), {
+      status: response.status,
+      mode: "proxy",
+    });
+  });
+}

app/api/orders/[orderId]/route.ts

@@ -0,0 +1,32 @@
+import { adaptOrderDetail } from "@/lib/adapters/orders";
+import { backendRequest } from "@/lib/http/backend-client";
+import {
+  jsonSuccess,
+  parsePositiveIntegerParam,
+  withErrorHandling,
+} from "@/lib/http/response";
+import type { AssetDto, OrderDetailResponseDto } from "@/lib/types/backend";
+
+type RouteContext = {
+  params: Promise<{
+    orderId: string;
+  }>;
+};
+
+export async function GET(_request: Request, context: RouteContext) {
+  return withErrorHandling(async () => {
+    const { orderId: rawOrderId } = await context.params;
+    const orderId = parsePositiveIntegerParam(rawOrderId, "orderId");
+    const [orderResponse, assetsResponse] = await Promise.all([
+      backendRequest<OrderDetailResponseDto>(`/orders/${orderId}`),
+      backendRequest<AssetDto[]>(`/orders/${orderId}/assets`),
+    ]);
+
+    return jsonSuccess(
+      adaptOrderDetail(orderResponse.data, assetsResponse.data),
+      {
+        mode: "proxy",
+      },
+    );
+  });
+}

app/api/orders/route.ts

@@ -0,0 +1,32 @@
+import type { CreateOrderResponseDto } from "@/lib/types/backend";
+import { backendRequest } from "@/lib/http/backend-client";
+import {
+  jsonSuccess,
+  parseJsonBody,
+  withErrorHandling,
+} from "@/lib/http/response";
+import { parseCreateOrderPayload } from "@/lib/validation/create-order";
+
+function normalizeCreateOrderResponse(payload: CreateOrderResponseDto) {
+  return {
+    orderId: payload.order_id,
+    workflowId: payload.workflow_id,
+    status: payload.status,
+  };
+}
+
+export async function POST(request: Request) {
+  return withErrorHandling(async () => {
+    const rawPayload = await parseJsonBody(request);
+    const payload = parseCreateOrderPayload(rawPayload);
+    const response = await backendRequest<CreateOrderResponseDto>("/orders", {
+      method: "POST",
+      body: JSON.stringify(payload),
+    });
+
+    return jsonSuccess(normalizeCreateOrderResponse(response.data), {
+      status: response.status,
+      mode: "proxy",
+    });
+  });
+}

app/api/reviews/[orderId]/confirm-revision/route.ts

@@ -0,0 +1,37 @@
+import { adaptReviewSubmission } from "@/lib/adapters/reviews";
+import { backendRequest } from "@/lib/http/backend-client";
+import {
+  jsonSuccess,
+  parseJsonBody,
+  parsePositiveIntegerParam,
+  withErrorHandling,
+} from "@/lib/http/response";
+import type { ConfirmRevisionResponseDto } from "@/lib/types/backend";
+import { parseConfirmRevisionPayload } from "@/lib/validation/revision";
+
+type RouteContext = {
+  params: Promise<{
+    orderId: string;
+  }>;
+};
+
+export async function POST(request: Request, context: RouteContext) {
+  return withErrorHandling(async () => {
+    const { orderId: rawOrderId } = await context.params;
+    const orderId = parsePositiveIntegerParam(rawOrderId, "orderId");
+    const rawPayload = await parseJsonBody(request);
+    const payload = parseConfirmRevisionPayload(rawPayload);
+    const response = await backendRequest<ConfirmRevisionResponseDto>(
+      `/reviews/${orderId}/confirm-revision`,
+      {
+        method: "POST",
+        body: JSON.stringify(payload),
+      },
+    );
+
+    return jsonSuccess(adaptReviewSubmission(response.data), {
+      status: response.status,
+      mode: "proxy",
+    });
+  });
+}

app/api/reviews/[orderId]/submit/route.ts

@@ -0,0 +1,36 @@
+import { adaptReviewSubmission } from "@/lib/adapters/reviews";
+import { backendRequest } from "@/lib/http/backend-client";
+import {
+  jsonSuccess,
+  parseJsonBody,
+  parsePositiveIntegerParam,
+  withErrorHandling,
+} from "@/lib/http/response";
+import type { SubmitReviewResponseDto } from "@/lib/types/backend";
+import { parseReviewActionPayload } from "@/lib/validation/review-action";
+
+type RouteContext = {
+  params: Promise<{
+    orderId: string;
+  }>;
+};
+
+export async function POST(request: Request, context: RouteContext) {
+  return withErrorHandling(async () => {
+    const { orderId: rawOrderId } = await context.params;
+    const orderId = parsePositiveIntegerParam(rawOrderId, "orderId");
+    const rawPayload = await parseJsonBody(request);
+    const payload = parseReviewActionPayload(rawPayload);
+    const response = await backendRequest<SubmitReviewResponseDto>(
+      `/reviews/${orderId}/submit`,
+      {
+        method: "POST",
+        body: JSON.stringify(payload),
+      },
+    );
+
+    return jsonSuccess(adaptReviewSubmission(response.data), {
+      mode: "proxy",
+    });
+  });
+}

app/api/reviews/pending/route.ts

@@ -0,0 +1,50 @@
+import { adaptPendingReviews } from "@/lib/adapters/reviews";
+import { backendRequest } from "@/lib/http/backend-client";
+import { jsonSuccess, withErrorHandling } from "@/lib/http/response";
+import type {
+  PendingReviewResponseDto,
+  WorkflowStatusResponseDto,
+} from "@/lib/types/backend";
+import { adaptWorkflowDetail } from "@/lib/adapters/workflows";
+import type { ReviewQueueItemVM } from "@/lib/types/view-models";
+
+async function enrichQueueItem(
+  item: ReviewQueueItemVM,
+): Promise<ReviewQueueItemVM> {
+  try {
+    const workflowResponse = await backendRequest<WorkflowStatusResponseDto>(
+      `/workflows/${item.orderId}`,
+    );
+    const workflow = adaptWorkflowDetail(workflowResponse.data);
+
+    return {
+      ...item,
+      workflowType: workflow.workflowType,
+      hasMockAssets: workflow.hasMockAssets,
+      failureCount: workflow.failureCount,
+    };
+  } catch {
+    return item;
+  }
+}
+
+export async function GET(request: Request) {
+  return withErrorHandling(async () => {
+    void request;
+    const response = await backendRequest<PendingReviewResponseDto[]>(
+      "/reviews/pending",
+    );
+    const queue = adaptPendingReviews(response.data);
+    const items = await Promise.all(queue.items.map(enrichQueueItem));
+
+    return jsonSuccess(
+      {
+        ...queue,
+        items,
+      },
+      {
+      mode: "proxy",
+      },
+    );
+  });
+}

app/api/workflows/[orderId]/route.ts

@@ -0,0 +1,28 @@
+import { adaptWorkflowDetail } from "@/lib/adapters/workflows";
+import { backendRequest } from "@/lib/http/backend-client";
+import {
+  jsonSuccess,
+  parsePositiveIntegerParam,
+  withErrorHandling,
+} from "@/lib/http/response";
+import type { WorkflowStatusResponseDto } from "@/lib/types/backend";
+
+type RouteContext = {
+  params: Promise<{
+    orderId: string;
+  }>;
+};
+
+export async function GET(_request: Request, context: RouteContext) {
+  return withErrorHandling(async () => {
+    const { orderId: rawOrderId } = await context.params;
+    const orderId = parsePositiveIntegerParam(rawOrderId, "orderId");
+    const response = await backendRequest<WorkflowStatusResponseDto>(
+      `/workflows/${orderId}`,
+    );
+
+    return jsonSuccess(adaptWorkflowDetail(response.data), {
+      mode: "proxy",
+    });
+  });
+}

app/globals.css

@@ -0,0 +1,59 @@
+@import "tailwindcss";
+
+:root {
+  --bg-canvas: #f6f1e8;
+  --bg-canvas-strong: #efe5d7;
+  --bg-elevated: rgba(255, 250, 243, 0.86);
+  --surface: #fffaf2;
+  --surface-muted: #f3ece1;
+  --surface-strong: #fffdf8;
+  --shell: #1e2724;
+  --shell-muted: #7d8a80;
+  --shell-border: rgba(242, 237, 229, 0.12);
+  --ink-strong: #23303a;
+  --ink: #2f352f;
+  --ink-muted: #6a645a;
+  --ink-faint: #8f8576;
+  --accent-primary: #6e7f52;
+  --accent-primary-strong: #5d6b46;
+  --accent-ink: #f8f5ef;
+  --accent-ring: rgba(110, 127, 82, 0.3);
+  --accent-soft: rgba(110, 127, 82, 0.14);
+  --border-soft: rgba(99, 87, 71, 0.16);
+  --border-strong: rgba(82, 71, 57, 0.24);
+  --shadow-shell: 0 28px 80px rgba(47, 38, 28, 0.12);
+  --shadow-card: 0 18px 40px rgba(62, 46, 27, 0.08);
+  --font-sans:
+    "Noto Sans SC", "PingFang SC", "Hiragino Sans GB", "Microsoft YaHei",
+    sans-serif;
+  --font-mono: "IBM Plex Mono", "SFMono-Regular", "SF Mono", monospace;
+}
+
+* {
+  box-sizing: border-box;
+}
+
+html {
+  background:
+    radial-gradient(circle at top, rgba(229, 214, 190, 0.9), transparent 42%),
+    linear-gradient(180deg, var(--bg-canvas) 0%, var(--bg-canvas-strong) 100%);
+}
+
+body {
+  margin: 0;
+  min-height: 100vh;
+  background: transparent;
+  color: var(--ink);
+  font-family: var(--font-sans);
+  text-rendering: optimizeLegibility;
+  -webkit-font-smoothing: antialiased;
+}
+
+a {
+  color: inherit;
+  text-decoration: none;
+}
+
+::selection {
+  background: var(--accent-soft);
+}

app/layout.tsx

@@ -0,0 +1,21 @@
+import type { Metadata } from "next";
+import type { ReactNode } from "react";
+
+import "./globals.css";
+
+export const metadata: Metadata = {
+  title: "Auto Virtual Tryon Admin",
+  description: "Operations console for virtual try-on workflows.",
+};
+
+type RootLayoutProps = {
+  children: ReactNode;
+};
+
+export default function RootLayout({ children }: RootLayoutProps) {
+  return (
+    <html lang="zh-CN">
+      <body>{children}</body>
+    </html>
+  );
+}

app/login/page.tsx

@@ -0,0 +1,5 @@
+import { LoginPlaceholder } from "@/features/auth/login-placeholder";
+
+export default function LoginPage() {
+  return <LoginPlaceholder />;
+}

app/page.tsx

@@ -0,0 +1,5 @@
+import { redirect } from "next/navigation";
+
+export default function HomePage() {
+  redirect("/orders");
+}