feat: implement user data CSV export with dynamic metadata columns

adminfront/src/features/user-groups/routes/TenantUserGroupsTab.tsx

@@ -17,7 +17,7 @@ import {
   UserPlus,
   Users,
 } from "lucide-react";
-import type React from "react";
+import * as React from "react";
 import { useMemo, useState } from "react";
 import { Link, useNavigate, useParams } from "react-router-dom";
 import { toast } from "sonner";

adminfront/src/features/users/UserListPage.tsx

@@ -3,6 +3,7 @@ import type { AxiosError } from "axios";
 import {
   ChevronLeft,
   ChevronRight,
+  FileDown,
   Pencil,
   Plus,
   RefreshCw,
@@ -48,6 +49,7 @@ import {
   fetchTenant,
   fetchTenants,
   fetchUsers,
+  exportUsersCSVUrl,
 } from "../../lib/adminApi";
 import { t } from "../../lib/i18n";
 import { UserBulkUploadModal } from "./components/UserBulkUploadModal";
@@ -149,6 +151,11 @@ function UserListPage() {
     }
   };
 
+  const handleExport = () => {
+    const url = exportUsersCSVUrl(search, selectedCompany);
+    window.open(url, "_blank");
+  };
+
   const errorMsg = (query.error as AxiosError<{ error?: string }>)?.response
     ?.data?.error;
   const fallbackError =
@@ -252,6 +259,10 @@ function UserListPage() {
             <RefreshCw size={16} />
             {t("ui.common.refresh", "새로고침")}
           </Button>
+          <Button variant="outline" onClick={handleExport} className="gap-2">
+            <FileDown size={16} />
+            {t("ui.common.export", "내보내기")}
+          </Button>
           <UserBulkUploadModal onSuccess={() => query.refetch()} />
           <Dialog>
             <DialogTrigger asChild>

adminfront/src/lib/adminApi.ts

@@ -445,6 +445,19 @@ export async function createUser(payload: UserCreateRequest) {
   return data;
 }
 
+export function exportUsersCSVUrl(search?: string, companyCode?: string) {
+  const params = new URLSearchParams();
+  if (search) params.append("search", search);
+  if (companyCode) params.append("companyCode", companyCode);
+  
+  // Get mock role from storage if exists for dev environment
+  const mockRole = window.localStorage.getItem("X-Mock-Role");
+  if (mockRole) params.append("x-test-role", mockRole);
+
+  const baseUrl = import.meta.env.VITE_ADMIN_API_BASE ?? "/api/v1";
+  return `${baseUrl}/admin/users/export?${params.toString()}`;
+}
+
 export async function bulkCreateUsers(users: BulkUserItem[]) {
   const { data } = await apiClient.post<BulkUserResponse>(
     "/v1/admin/users/bulk",