agentic-dev 0.2.10 → 0.2.12

package/client/admin/package.json

@@ -1,41 +0,0 @@
-{
-  "name": "@do4ai/client-admin-template",
-  "private": true,
-  "version": "0.1.0",
-  "type": "module",
-  "packageManager": "pnpm@10.32.0",
-  "scripts": {
-    "dev": "vite --host 0.0.0.0 --port 4000",
-    "build": "tsc -b && vite build",
-    "preview": "vite preview --host 0.0.0.0 --port 4400",
-    "ui:parity:init": "bash ../../sdd/99_toolchain/01_automation/agentic-dev/init_frontend_parity.sh ../.. admin",
-    "ui:parity:bootstrap": "bash ../../sdd/99_toolchain/01_automation/agentic-dev/bootstrap_frontend_parity.sh ../.. admin",
-    "ui:parity:scaffold": "bash ../../sdd/99_toolchain/01_automation/agentic-dev/run_frontend_target.sh scaffold ../.. admin",
-    "ui:parity:materialize-references": "bash ../../sdd/99_toolchain/01_automation/agentic-dev/run_frontend_target.sh materialize_references ../.. admin",
-    "ui:parity:route-gap": "bash ../../sdd/99_toolchain/01_automation/agentic-dev/run_frontend_target.sh route_gap ../.. admin",
-    "ui:parity:proof": "bash ../../sdd/99_toolchain/01_automation/agentic-dev/run_frontend_target.sh proof ../.. admin"
-  },
-  "dependencies": {
-    "class-variance-authority": "^0.7.1",
-    "clsx": "^2.1.1",
-    "lucide-react": "^0.576.0",
-    "react": "^18.3.1",
-    "react-dom": "^18.3.1",
-    "react-router-dom": "^6.30.1",
-    "tailwind-merge": "^3.5.0"
-  },
-  "devDependencies": {
-    "@playwright/test": "^1.58.2",
-    "@types/react": "^18.3.18",
-    "@types/react-dom": "^18.3.5",
-    "@vitejs/plugin-react": "^4.7.0",
-    "autoprefixer": "^10.4.21",
-    "pixelmatch": "^7.1.0",
-    "pngjs": "^7.0.0",
-    "postcss": "^8.5.3",
-    "tailwindcss": "^3.4.17",
-    "typescript": "^5.8.3",
-    "vite": "^5.4.19",
-    "yaml": "^2.8.1"
-  }
-}

package/client/admin/postcss.config.js

@@ -1,6 +0,0 @@
-export default {
-  plugins: {
-    tailwindcss: {},
-    autoprefixer: {},
-  },
-};

package/client/admin/scripts/ui-parity-admin-adapter.mjs

@@ -1,65 +0,0 @@
-import fs from "node:fs";
-import path from "node:path";
-import { fileURLToPath } from "node:url";
-
-const scriptDir = path.dirname(fileURLToPath(import.meta.url));
-const screens = JSON.parse(
-  fs.readFileSync(path.resolve(scriptDir, "../src/lib/specScreens.json"), "utf8"),
-);
-const routes = JSON.parse(
-  fs.readFileSync(path.resolve(scriptDir, "../src/lib/specRouteCatalog.json"), "utf8"),
-);
-
-const routeMap = new Map(routes.map((entry) => [entry.id, entry.route]));
-
-export default {
-  service: "templates-admin",
-  targetBaseUrl: "http://127.0.0.1:4400",
-  viewport: {
-    width: 1440,
-    height: 1024,
-  },
-  screens: screens.map((screen) => ({
-    id: screen.id,
-    title: screen.title,
-    route: routeMap.get(screen.id) ?? "/",
-    referenceImage: `sdd/03_verify/10_test/ui_parity/reference/${screen.id}.png`,
-    readySelector: "body",
-    readyTimeoutMs: 10000,
-    tags: ["template", "admin"],
-  })),
-  async preparePage(page, { route }) {
-    await page.route("**/auth/me", async (routeRequest) => {
-      await routeRequest.fulfill({
-        status: 200,
-        contentType: "application/json",
-        body: JSON.stringify({
-          id: "tmpl-admin",
-          name: "Template Admin",
-          email: "admin@example.com",
-          role: "admin",
-        }),
-      });
-    });
-    await page.addInitScript(() => {
-      window.localStorage.setItem(
-        "admin.auth.token",
-        JSON.stringify({
-          access_token: "template-access-token",
-          token_type: "bearer",
-        }),
-      );
-    });
-    if (route === "/login") {
-      await page.addInitScript(() => {
-        window.localStorage.removeItem("admin.auth.token");
-      });
-    }
-  },
-  async waitForReady(page) {
-    await page.waitForLoadState("networkidle");
-  },
-  async resolveMaskRects() {
-    return [];
-  },
-};

package/client/admin/src/api/alerts.ts

@@ -1,33 +0,0 @@
-import { apiGet, apiPost } from "@/api/client";
-
-export interface AlertItem {
-  id: string;
-  source: string;
-  title: string;
-  message: string;
-  tone: string;
-  created_at: string;
-  read: boolean;
-}
-
-export interface AlertsPayload {
-  unread_count: number;
-  items: AlertItem[];
-}
-
-export interface AlertsReadAllResult {
-  updated_count: number;
-  unread_count: number;
-}
-
-export function fetchAlerts(accessToken: string) {
-  return apiGet<AlertsPayload>("/alerts", { accessToken });
-}
-
-export function markAlertRead(alertId: string, accessToken: string) {
-  return apiPost<AlertItem>(`/alerts/${alertId}/read`, { accessToken });
-}
-
-export function markAllAlertsRead(accessToken: string) {
-  return apiPost<AlertsReadAllResult>("/alerts/read-all", { accessToken });
-}

package/client/admin/src/api/client.ts

@@ -1,71 +0,0 @@
-const API_BASE_URL =
-  (import.meta.env.VITE_API_BASE_URL as string | undefined)?.replace(/\/$/, "") ??
-  "";
-
-interface RequestOptions {
-  accessToken?: string;
-}
-
-interface WriteOptions extends RequestOptions {
-  body?: unknown;
-}
-
-async function readJson<T>(response: Response): Promise<T> {
-  if (!response.ok) {
-    let message = "Request failed";
-    try {
-      const data = (await response.json()) as { detail?: string };
-      if (typeof data.detail === "string" && data.detail.length > 0) {
-        message = data.detail;
-      }
-    } catch {
-      message = response.statusText || message;
-    }
-    throw new Error(message);
-  }
-
-  return (await response.json()) as T;
-}
-
-export async function apiGet<T>(
-  path: string,
-  options?: RequestOptions,
-): Promise<T> {
-  const response = await fetch(`${API_BASE_URL}${path}`, {
-    headers: options?.accessToken
-      ? { Authorization: `Bearer ${options.accessToken}` }
-      : undefined,
-  });
-
-  return readJson<T>(response);
-}
-
-async function writeJson<T>(
-  method: "POST" | "PATCH",
-  path: string,
-  options?: WriteOptions,
-): Promise<T> {
-  const headers: Record<string, string> = {
-    "Content-Type": "application/json",
-  };
-
-  if (options?.accessToken) {
-    headers.Authorization = `Bearer ${options.accessToken}`;
-  }
-
-  const response = await fetch(`${API_BASE_URL}${path}`, {
-    method,
-    headers,
-    body: JSON.stringify(options?.body ?? {}),
-  });
-
-  return readJson<T>(response);
-}
-
-export function apiPost<T>(path: string, options?: WriteOptions): Promise<T> {
-  return writeJson("POST", path, options);
-}
-
-export function apiPatch<T>(path: string, options?: WriteOptions): Promise<T> {
-  return writeJson("PATCH", path, options);
-}

package/client/admin/src/api/orders.ts

@@ -1,33 +0,0 @@
-import { apiGet } from "@/api/client";
-
-export interface DashboardCard {
-  label: string;
-  value: string;
-  tone?: string | null;
-}
-
-export interface StageStatus {
-  label: string;
-  value: string;
-}
-
-export interface AdminOverviewResponse {
-  cards: DashboardCard[];
-  stage_statuses: StageStatus[];
-}
-
-export interface AdminQueueItem {
-  order_id: string;
-  product_name: string;
-  customer_name: string;
-  status: string;
-  sla: string;
-}
-
-export function fetchAdminOverview(accessToken: string) {
-  return apiGet<AdminOverviewResponse>("/orders/admin/overview", { accessToken });
-}
-
-export function fetchAdminQueue(accessToken: string) {
-  return apiGet<AdminQueueItem[]>("/orders/admin/queue", { accessToken });
-}

package/client/admin/src/api/support.ts

@@ -1,11 +0,0 @@
-import { apiGet } from "@/api/client";
-
-export interface SupportFaq {
-  id: string;
-  question: string;
-  visibility: string;
-}
-
-export function fetchSupportFaqs(accessToken: string) {
-  return apiGet<SupportFaq[]>("/support/faqs", { accessToken });
-}

package/client/admin/src/app/App.tsx

@@ -1,23 +0,0 @@
-import { Route, Routes } from "react-router-dom";
-
-import { ProtectedRoute } from "@/auth/ProtectedRoute";
-import { AdminShell } from "@/components/AdminShell";
-import { AdminDashboardPage } from "@/pages/AdminDashboardPage";
-import { AdminLoginPage } from "@/pages/AdminLoginPage";
-import { AdminQueuePage } from "@/pages/AdminQueuePage";
-import { AdminSupportPage } from "@/pages/AdminSupportPage";
-
-export function App() {
-  return (
-    <Routes>
-      <Route path="/login" element={<AdminLoginPage />} />
-      <Route element={<ProtectedRoute />}>
-        <Route element={<AdminShell />}>
-          <Route path="/" element={<AdminDashboardPage />} />
-          <Route path="/queue" element={<AdminQueuePage />} />
-          <Route path="/support" element={<AdminSupportPage />} />
-        </Route>
-      </Route>
-    </Routes>
-  );
-}

package/client/admin/src/auth/AuthProvider.tsx

@@ -1,122 +0,0 @@
-import { createContext, useContext, useEffect, useMemo, useState, type ReactNode } from "react";
-
-import { getMe, login as loginRequest } from "@/auth/auth-client";
-import type { AuthToken, AuthUser, LoginCommand } from "@/auth/types";
-
-const STORAGE_KEY = "admin.auth.token";
-
-interface AuthContextValue {
-  user: AuthUser | null;
-  token: AuthToken | null;
-  initializing: boolean;
-  authenticating: boolean;
-  login: (command: LoginCommand) => Promise<void>;
-  logout: () => void;
-}
-
-const AuthContext = createContext<AuthContextValue | undefined>(undefined);
-
-function readStoredToken(): AuthToken | null {
-  const raw = window.localStorage.getItem(STORAGE_KEY);
-  if (!raw) {
-    return null;
-  }
-
-  try {
-    return JSON.parse(raw) as AuthToken;
-  } catch {
-    window.localStorage.removeItem(STORAGE_KEY);
-    return null;
-  }
-}
-
-function storeToken(token: AuthToken | null) {
-  if (token) {
-    window.localStorage.setItem(STORAGE_KEY, JSON.stringify(token));
-    return;
-  }
-
-  window.localStorage.removeItem(STORAGE_KEY);
-}
-
-export function AuthProvider({ children }: { children: ReactNode }) {
-  const [token, setToken] = useState<AuthToken | null>(() => readStoredToken());
-  const [user, setUser] = useState<AuthUser | null>(null);
-  const [initializing, setInitializing] = useState(true);
-  const [authenticating, setAuthenticating] = useState(false);
-
-  useEffect(() => {
-    let cancelled = false;
-
-    async function bootstrap() {
-      if (!token) {
-        setUser(null);
-        setInitializing(false);
-        return;
-      }
-
-      try {
-        const currentUser = await getMe(token.access_token);
-        if (!cancelled) {
-          setUser(currentUser);
-        }
-      } catch {
-        if (!cancelled) {
-          setToken(null);
-          setUser(null);
-          storeToken(null);
-        }
-      } finally {
-        if (!cancelled) {
-          setInitializing(false);
-        }
-      }
-    }
-
-    void bootstrap();
-
-    return () => {
-      cancelled = true;
-    };
-  }, [token]);
-
-  const value = useMemo<AuthContextValue>(
-    () => ({
-      user,
-      token,
-      initializing,
-      authenticating,
-      async login(command) {
-        setAuthenticating(true);
-        try {
-          const nextToken = await loginRequest(command);
-          storeToken(nextToken);
-          setToken(nextToken);
-          const currentUser = await getMe(nextToken.access_token);
-          setUser(currentUser);
-        } finally {
-          setAuthenticating(false);
-          setInitializing(false);
-        }
-      },
-      logout() {
-        storeToken(null);
-        setToken(null);
-        setUser(null);
-        setInitializing(false);
-      },
-    }),
-    [authenticating, initializing, token, user],
-  );
-
-  return <AuthContext.Provider value={value}>{children}</AuthContext.Provider>;
-}
-
-export function useAuth() {
-  const context = useContext(AuthContext);
-  if (!context) {
-    throw new Error("useAuth must be used within an AuthProvider");
-  }
-
-  return context;
-}

package/client/admin/src/auth/ProtectedRoute.tsx

@@ -1,22 +0,0 @@
-import { Navigate, Outlet, useLocation } from "react-router-dom";
-
-import { useAuth } from "@/auth/AuthProvider";
-
-export function ProtectedRoute() {
-  const { initializing, user } = useAuth();
-  const location = useLocation();
-
-  if (initializing) {
-    return (
-      <div className="flex min-h-screen items-center justify-center bg-[var(--admin-shell-bg)] text-sm font-medium text-[#5d6879]">
-        관리자 세션을 확인하는 중입니다.
-      </div>
-    );
-  }
-
-  if (!user) {
-    return <Navigate to="/login" replace state={{ from: location }} />;
-  }
-
-  return <Outlet />;
-}

package/client/admin/src/auth/auth-client.ts

@@ -1,38 +0,0 @@
-import type { AuthToken, AuthUser, LoginCommand } from "@/auth/types";
-
-const API_BASE_URL = (import.meta.env.VITE_API_BASE_URL as string | undefined)?.replace(/\/$/, "") ?? "";
-
-async function readJson<T>(response: Response): Promise<T> {
-  if (!response.ok) {
-    let message = "Request failed";
-    try {
-      const data = (await response.json()) as { detail?: string };
-      if (typeof data.detail === "string" && data.detail.length > 0) {
-        message = data.detail;
-      }
-    } catch {
-      message = response.statusText || message;
-    }
-    throw new Error(message);
-  }
-
-  return (await response.json()) as T;
-}
-
-export async function login(command: LoginCommand): Promise<AuthToken> {
-  const response = await fetch(`${API_BASE_URL}/auth/login`, {
-    method: "POST",
-    headers: { "Content-Type": "application/json" },
-    body: JSON.stringify(command),
-  });
-
-  return readJson<AuthToken>(response);
-}
-
-export async function getMe(accessToken: string): Promise<AuthUser> {
-  const response = await fetch(`${API_BASE_URL}/auth/me`, {
-    headers: { Authorization: `Bearer ${accessToken}` },
-  });
-
-  return readJson<AuthUser>(response);
-}

package/client/admin/src/auth/types.ts

@@ -1,18 +0,0 @@
-export interface AuthToken {
-  access_token: string;
-  token_type: string;
-  user_id: string;
-}
-
-export interface AuthUser {
-  id: string;
-  name: string;
-  email: string;
-  role: string;
-  status: string;
-}
-
-export interface LoginCommand {
-  email: string;
-  password: string;
-}

package/client/admin/src/components/AdminNotificationsDrawer.tsx

@@ -1,162 +0,0 @@
-import { Check, CircleDot, X } from "lucide-react";
-import { useEffect, useState } from "react";
-
-import {
-  fetchAlerts,
-  markAlertRead,
-  markAllAlertsRead,
-  type AlertItem,
-} from "@/api/alerts";
-import { useAuth } from "@/auth/AuthProvider";
-import { Button } from "@/components/ui/button";
-
-export function AdminNotificationsDrawer({
-  open,
-  onClose,
-}: {
-  open: boolean;
-  onClose: () => void;
-}) {
-  const { token } = useAuth();
-  const [items, setItems] = useState<AlertItem[]>([]);
-  const [loading, setLoading] = useState(false);
-  const [error, setError] = useState<string | null>(null);
-  const [unreadCount, setUnreadCount] = useState(0);
-
-  useEffect(() => {
-    if (!open || !token?.access_token) {
-      return;
-    }
-
-    let cancelled = false;
-    setLoading(true);
-    setError(null);
-
-    fetchAlerts(token.access_token)
-      .then((response) => {
-        if (!cancelled) {
-          setItems(response.items);
-          setUnreadCount(response.unread_count);
-        }
-      })
-      .catch((nextError: Error) => {
-        if (!cancelled) {
-          setError(nextError.message);
-          setItems([]);
-          setUnreadCount(0);
-        }
-      })
-      .finally(() => {
-        if (!cancelled) {
-          setLoading(false);
-        }
-      });
-
-    return () => {
-      cancelled = true;
-    };
-  }, [open, token?.access_token]);
-
-  if (!open) return null;
-
-  async function handleMarkRead(alertId: string) {
-    if (!token?.access_token) {
-      return;
-    }
-
-    const updated = await markAlertRead(alertId, token.access_token);
-    setItems((current) =>
-      current.map((item) => (item.id === updated.id ? updated : item)),
-    );
-    setUnreadCount((current) => Math.max(0, updated.read ? current - 1 : current));
-  }
-
-  async function handleMarkAllRead() {
-    if (!token?.access_token) {
-      return;
-    }
-
-    const result = await markAllAlertsRead(token.access_token);
-    setItems((current) => current.map((item) => ({ ...item, read: true })));
-    setUnreadCount(result.unread_count);
-  }
-
-  return (
-    <div className="fixed inset-0 z-50 bg-black/20">
-      <div className="ml-auto flex h-full w-[var(--admin-drawer-width)] flex-col border-l border-[var(--admin-border)] bg-white shadow-2xl">
-        <div className="flex items-center justify-between border-b border-[var(--admin-border)] px-6 py-5">
-          <div>
-            <h2 className="text-lg font-bold text-[#1f2634]">알림</h2>
-            <p className="mt-1 text-sm text-[var(--admin-muted)]">
-              운영 이벤트와 시스템 상태 · 미읽음 {unreadCount}건
-            </p>
-          </div>
-          <button
-            className="inline-flex h-10 w-10 items-center justify-center rounded-full border border-[var(--admin-border)]"
-            onClick={onClose}
-          >
-            <X className="h-4 w-4" />
-          </button>
-        </div>
-        <div className="flex-1 space-y-3 overflow-y-auto p-6">
-          {loading ? (
-            <div className="text-sm text-[var(--admin-muted)]">
-              알림을 불러오는 중입니다.
-            </div>
-          ) : null}
-          {error ? (
-            <div className="text-sm font-semibold text-[var(--admin-danger)]">
-              {error}
-            </div>
-          ) : null}
-          {!loading && !error && !items.length ? (
-            <div className="text-sm text-[var(--admin-muted)]">
-              표시할 알림이 없습니다.
-            </div>
-          ) : null}
-          {items.map((item) => (
-            <div
-              key={item.id}
-              className="rounded-2xl border border-[var(--admin-border)] bg-[#fafbfd] p-4"
-            >
-              <div className="flex items-start justify-between gap-3">
-                <div>
-                  <p className="font-semibold text-[#202939]">{item.title}</p>
-                  <p className="mt-1 text-sm text-[var(--admin-muted)]">
-                    {item.message}
-                  </p>
-                  <p className="mt-2 text-xs text-[var(--admin-muted)]">
-                    {item.source} · {item.created_at}
-                  </p>
-                </div>
-                {!item.read ? (
-                  <button
-                    className="inline-flex items-center gap-1 rounded-full bg-white px-3 py-1 text-xs font-semibold text-[#344156]"
-                    onClick={() => void handleMarkRead(item.id)}
-                  >
-                    <CircleDot className="h-3.5 w-3.5" />
-                    읽음
-                  </button>
-                ) : (
-                  <span className="rounded-full bg-white px-3 py-1 text-xs font-semibold text-[var(--admin-muted)]">
-                    읽음
-                  </span>
-                )}
-              </div>
-            </div>
-          ))}
-        </div>
-        <div className="border-t border-[var(--admin-border)] p-6">
-          <Button
-            variant="outline"
-            className="w-full justify-center gap-2"
-            onClick={() => void handleMarkAllRead()}
-          >
-            <Check className="h-4 w-4" />
-            모두 읽음
-          </Button>
-        </div>
-      </div>
-    </div>
-  );
-}