feat: bootstrap auto virtual tryon admin frontend

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",
+    });
+  });
+}