Merge remote-tracking branch 'origin/master'

# Conflicts:
#	src/components/hr/SalaryManagement/index.tsx
#	src/components/production/WorkResults/WorkResultList.tsx
#	tsconfig.tsbuildinfo
This commit is contained in:
2026-01-16 15:47:13 +09:00
91 changed files with 21969 additions and 20128 deletions

View File

@@ -1,24 +1,30 @@
'use client';
/**
* 작업지시 목록 페이지
* IntegratedListTemplateV2 패턴 적용
* API 연동 완료 (2025-12-26)
* 작업지시 목록 - UniversalListPage 마이그레이션
*
* 기존 IntegratedListTemplateV2 → UniversalListPage config 기반으로 변환
* - 서버 사이드 페이지네이션 (getWorkOrders API)
* - 통계 카드 (getWorkOrderStats API)
* - 탭 기반 상태 필터링
*/
import { useState, useCallback, useEffect } from 'react';
import { useState, useEffect, useMemo, useCallback } from 'react';
import { useRouter } from 'next/navigation';
import { Plus, FileText, Calendar, Users, CheckCircle2, Loader2 } from 'lucide-react';
import { Plus, FileText, Calendar, Users, CheckCircle2 } from 'lucide-react';
import { Button } from '@/components/ui/button';
import { Badge } from '@/components/ui/badge';
import { TableCell, TableRow } from '@/components/ui/table';
import { Checkbox } from '@/components/ui/checkbox';
import {
IntegratedListTemplateV2,
TabOption,
TableColumn,
StatCard,
} from '@/components/templates/IntegratedListTemplateV2';
UniversalListPage,
type UniversalListConfig,
type SelectionHandlers,
type RowClickHandlers,
type TabOption,
type StatCard,
type ListParams,
} from '@/components/templates/UniversalListPage';
import { ListMobileCard, InfoField } from '@/components/organisms/ListMobileCard';
import { toast } from 'sonner';
import { getWorkOrders, getWorkOrderStats } from './actions';
@@ -30,18 +36,6 @@ import {
} from './types';
import { isNextRedirectError } from '@/lib/utils/redirect-error';
// Debounce 훅
function useDebounce<T>(value: T, delay: number): T {
const [debouncedValue, setDebouncedValue] = useState<T>(value);
useEffect(() => {
const timer = setTimeout(() => setDebouncedValue(value), delay);
return () => clearTimeout(timer);
}, [value, delay]);
return debouncedValue;
}
// 탭 필터 정의
type TabFilter = 'all' | 'unassigned' | 'pending' | 'waiting' | 'in_progress' | 'completed';
@@ -50,16 +44,8 @@ const ITEMS_PER_PAGE = 20;
export function WorkOrderList() {
const router = useRouter();
const [searchTerm, setSearchTerm] = useState('');
const [activeTab, setActiveTab] = useState<TabFilter>('all');
const [selectedItems, setSelectedItems] = useState<Set<string>>(new Set());
const [currentPage, setCurrentPage] = useState(1);
// 디바운스된 검색어 (300ms 딜레이)
const debouncedSearchTerm = useDebounce(searchTerm, 300);
// API 데이터 상태
const [workOrders, setWorkOrders] = useState<WorkOrder[]>([]);
// ===== 통계 데이터 (외부 관리 - 별도 API) =====
const [statsData, setStatsData] = useState<WorkOrderStats>({
total: 0,
unassigned: 0,
@@ -68,282 +54,253 @@ export function WorkOrderList() {
inProgress: 0,
completed: 0,
});
const [isLoading, setIsLoading] = useState(true);
const [totalItems, setTotalItems] = useState(0);
const [totalPages, setTotalPages] = useState(1);
// 초기 로드 및 필터 변경 시 데이터 다시 로드
// 통계 데이터 로드 (초기 1회)
useEffect(() => {
let isMounted = true;
const loadData = async () => {
setIsLoading(true);
const loadStats = async () => {
try {
// 목록과 통계를 병렬로 조회
const [listResult, statsResult] = await Promise.all([
getWorkOrders({
page: currentPage,
perPage: ITEMS_PER_PAGE,
status: activeTab === 'all' ? undefined : activeTab,
search: debouncedSearchTerm || undefined,
}),
getWorkOrderStats(),
]);
// 컴포넌트가 언마운트되었으면 상태 업데이트 중단
if (!isMounted) return;
if (listResult.success) {
setWorkOrders(listResult.data);
setTotalItems(listResult.pagination.total);
setTotalPages(listResult.pagination.lastPage);
} else {
toast.error(listResult.error || '목록 조회에 실패했습니다.');
}
if (statsResult.success && statsResult.data) {
setStatsData(statsResult.data);
const result = await getWorkOrderStats();
if (result.success && result.data) {
setStatsData(result.data);
}
} catch (error) {
if (!isMounted) return;
if (isNextRedirectError(error)) throw error;
console.error('[WorkOrderList] loadData error:', error);
toast.error('데이터 로드 중 오류가 발생했습니다.');
} finally {
if (isMounted) {
setIsLoading(false);
}
console.error('[WorkOrderList] loadStats error:', error);
}
};
loadData();
return () => {
isMounted = false;
};
}, [currentPage, activeTab, debouncedSearchTerm]);
// 탭 옵션 (통계 데이터 기반)
const tabs: TabOption[] = [
{ value: 'all', label: '전체', count: statsData.total },
{ value: 'unassigned', label: '미배정', count: statsData.unassigned, color: 'gray' },
{ value: 'pending', label: '승인대기', count: statsData.pending, color: 'orange' },
{ value: 'waiting', label: '작업대기', count: statsData.waiting, color: 'yellow' },
{ value: 'in_progress', label: '작업중', count: statsData.inProgress, color: 'blue' },
{ value: 'completed', label: '작업완료', count: statsData.completed, color: 'green' },
];
// 통계 카드
const stats: StatCard[] = [
{
label: '전체',
value: statsData.total,
icon: FileText,
iconColor: 'text-gray-600',
},
{
label: '작업대기',
value: statsData.waiting + statsData.unassigned + statsData.pending,
icon: Calendar,
iconColor: 'text-orange-600',
},
{
label: '작업중',
value: statsData.inProgress,
icon: Users,
iconColor: 'text-blue-600',
},
{
label: '작업완료',
value: statsData.completed,
icon: CheckCircle2,
iconColor: 'text-green-600',
},
];
// 테이블 컬럼
const tableColumns: TableColumn[] = [
{ key: 'no', label: '번호', className: 'w-[60px] text-center' },
{ key: 'workOrderNo', label: '작업지시번호', className: 'min-w-[140px]' },
{ key: 'processType', label: '공정', className: 'w-[80px]' },
{ key: 'lotNo', label: '로트번호', className: 'min-w-[120px]' },
{ key: 'orderDate', label: '지시일', className: 'w-[100px]' },
{ key: 'isAssigned', label: '배정', className: 'w-[60px] text-center' },
{ key: 'hasWork', label: '작업', className: 'w-[60px] text-center' },
{ key: 'isStarted', label: '시작', className: 'w-[60px] text-center' },
{ key: 'status', label: '작업상태', className: 'w-[100px]' },
{ key: 'priority', label: '현장순위', className: 'w-[80px] text-center' },
{ key: 'assignee', label: '작업자', className: 'w-[80px]' },
{ key: 'projectName', label: '현장명', className: 'min-w-[150px]' },
{ key: 'shipmentDate', label: '출고예정일', className: 'w-[110px]' },
];
// 페이지네이션 설정 (API에서 페이징 처리)
const pagination = {
currentPage,
totalPages,
totalItems,
itemsPerPage: ITEMS_PER_PAGE,
onPageChange: setCurrentPage,
};
// 선택 핸들러
const handleToggleSelection = useCallback((id: string) => {
setSelectedItems((prev) => {
const newSet = new Set(prev);
if (newSet.has(id)) {
newSet.delete(id);
} else {
newSet.add(id);
}
return newSet;
});
loadStats();
}, []);
const handleToggleSelectAll = useCallback(() => {
if (selectedItems.size === workOrders.length) {
setSelectedItems(new Set());
} else {
setSelectedItems(new Set(workOrders.map((o) => o.id)));
}
}, [workOrders, selectedItems.size]);
// ===== 행 클릭 핸들러 =====
const handleRowClick = useCallback(
(item: WorkOrder) => {
router.push(`/ko/production/work-orders/${item.id}`);
},
[router]
);
// 상세 페이지 이동
const handleView = useCallback((id: string) => {
router.push(`/production/work-orders/${id}`);
// ===== 등록 핸들러 =====
const handleCreate = useCallback(() => {
router.push('/ko/production/work-orders/create');
}, [router]);
// 등록 페이지 이동
const handleCreate = () => {
router.push('/production/work-orders/create');
};
// ===== 탭 옵션 (통계 데이터 기반) =====
const tabs: TabOption[] = useMemo(
() => [
{ value: 'all', label: '전체', count: statsData.total },
{ value: 'unassigned', label: '미배정', count: statsData.unassigned, color: 'gray' },
{ value: 'pending', label: '승인대기', count: statsData.pending, color: 'orange' },
{ value: 'waiting', label: '작업대기', count: statsData.waiting, color: 'yellow' },
{ value: 'in_progress', label: '작업중', count: statsData.inProgress, color: 'blue' },
{ value: 'completed', label: '작업완료', count: statsData.completed, color: 'green' },
],
[statsData]
);
// 탭 변경 시 페이지 리셋
const handleTabChange = (value: string) => {
setActiveTab(value as TabFilter);
setCurrentPage(1);
setSelectedItems(new Set());
};
// ===== 통계 카드 =====
const stats: StatCard[] = useMemo(
() => [
{
label: '전체',
value: statsData.total,
icon: FileText,
iconColor: 'text-gray-600',
},
{
label: '작업대기',
value: statsData.waiting + statsData.unassigned + statsData.pending,
icon: Calendar,
iconColor: 'text-orange-600',
},
{
label: '작업중',
value: statsData.inProgress,
icon: Users,
iconColor: 'text-blue-600',
},
{
label: '작업완료',
value: statsData.completed,
icon: CheckCircle2,
iconColor: 'text-green-600',
},
],
[statsData]
);
// 검색 변경 시 페이지 리셋
const handleSearchChange = (value: string) => {
setSearchTerm(value);
setCurrentPage(1);
};
// ===== UniversalListPage Config =====
const config: UniversalListConfig<WorkOrder> = useMemo(
() => ({
// 페이지 기본 정보
title: '작업지시 목록',
description: '생산 작업지시 관리',
icon: FileText,
basePath: '/production/work-orders',
// 테이블 행 렌더링
const renderTableRow = (order: WorkOrder, index: number, globalIndex: number) => {
const isSelected = selectedItems.has(order.id);
// ID 추출
idField: 'id',
return (
<TableRow
key={order.id}
className={`cursor-pointer hover:bg-muted/50 ${isSelected ? 'bg-blue-50' : ''}`}
onClick={() => handleView(order.id)}
>
<TableCell className="text-center" onClick={(e) => e.stopPropagation()}>
<Checkbox
checked={isSelected}
onCheckedChange={() => handleToggleSelection(order.id)}
// API 액션 (서버 사이드 페이지네이션)
actions: {
getList: async (params?: ListParams) => {
try {
const result = await getWorkOrders({
page: params?.page || 1,
perPage: params?.pageSize || ITEMS_PER_PAGE,
status: params?.tab === 'all' ? undefined : (params?.tab as TabFilter),
search: params?.search || undefined,
});
if (result.success) {
// 통계도 다시 로드 (탭 변경 시 최신 데이터 반영)
const statsResult = await getWorkOrderStats();
if (statsResult.success && statsResult.data) {
setStatsData(statsResult.data);
}
return {
success: true,
data: result.data,
totalCount: result.pagination.total,
totalPages: result.pagination.lastPage,
};
}
return { success: false, error: result.error };
} catch (error) {
if (isNextRedirectError(error)) throw error;
return { success: false, error: '데이터 로드 중 오류가 발생했습니다.' };
}
},
},
// 테이블 컬럼
columns: [
{ key: 'no', label: '번호', className: 'w-[60px] text-center' },
{ key: 'workOrderNo', label: '작업지시번호', className: 'min-w-[140px]' },
{ key: 'processType', label: '공정', className: 'w-[80px]' },
{ key: 'lotNo', label: '로트번호', className: 'min-w-[120px]' },
{ key: 'orderDate', label: '지시일', className: 'w-[100px]' },
{ key: 'isAssigned', label: '배정', className: 'w-[60px] text-center' },
{ key: 'hasWork', label: '작업', className: 'w-[60px] text-center' },
{ key: 'isStarted', label: '시작', className: 'w-[60px] text-center' },
{ key: 'status', label: '작업상태', className: 'w-[100px]' },
{ key: 'priority', label: '현장순위', className: 'w-[80px] text-center' },
{ key: 'assignee', label: '작업자', className: 'w-[80px]' },
{ key: 'projectName', label: '현장명', className: 'min-w-[150px]' },
{ key: 'shipmentDate', label: '출고예정일', className: 'w-[110px]' },
],
// 서버 사이드 페이지네이션
clientSideFiltering: false,
itemsPerPage: ITEMS_PER_PAGE,
// 검색
searchPlaceholder: '작업지시번호, 발주처, 현장명 검색...',
// 탭 설정
tabs,
defaultTab: 'all',
// 통계 카드
stats,
// 헤더 액션 (등록 버튼)
headerActions: () => (
<Button onClick={handleCreate}>
<Plus className="w-4 h-4 mr-1.5" />
</Button>
),
// 테이블 행 렌더링
renderTableRow: (
item: WorkOrder,
index: number,
globalIndex: number,
handlers: SelectionHandlers & RowClickHandlers<WorkOrder>
) => {
return (
<TableRow
key={item.id}
className={`cursor-pointer hover:bg-muted/50 ${handlers.isSelected ? 'bg-blue-50' : ''}`}
onClick={() => handleRowClick(item)}
>
<TableCell className="text-center" onClick={(e) => e.stopPropagation()}>
<Checkbox
checked={handlers.isSelected}
onCheckedChange={handlers.onToggle}
/>
</TableCell>
<TableCell className="text-center text-muted-foreground">{globalIndex}</TableCell>
<TableCell className="font-medium">{item.workOrderNo}</TableCell>
<TableCell>{item.processName}</TableCell>
<TableCell>{item.lotNo}</TableCell>
<TableCell>{item.orderDate}</TableCell>
<TableCell className="text-center">{item.isAssigned ? 'Y' : '-'}</TableCell>
<TableCell className="text-center">
{item.status !== 'unassigned' && item.status !== 'pending' ? 'Y' : '-'}
</TableCell>
<TableCell className="text-center">{item.isStarted ? 'Y' : '-'}</TableCell>
<TableCell>
<Badge className={`${WORK_ORDER_STATUS_COLORS[item.status]} border-0`}>
{WORK_ORDER_STATUS_LABELS[item.status]}
</Badge>
</TableCell>
<TableCell className="text-center">{item.priority}</TableCell>
<TableCell>{item.assignee}</TableCell>
<TableCell className="max-w-[200px] truncate">{item.projectName}</TableCell>
<TableCell>{item.shipmentDate}</TableCell>
</TableRow>
);
},
// 모바일 카드 렌더링
renderMobileCard: (
item: WorkOrder,
index: number,
globalIndex: number,
handlers: SelectionHandlers & RowClickHandlers<WorkOrder>
) => {
return (
<ListMobileCard
key={item.id}
id={item.id}
isSelected={handlers.isSelected}
onToggleSelection={handlers.onToggle}
onClick={() => handleRowClick(item)}
headerBadges={
<>
<Badge variant="outline" className="text-xs">
#{globalIndex}
</Badge>
<Badge variant="outline" className="text-xs">
{item.workOrderNo}
</Badge>
</>
}
title={item.projectName}
statusBadge={
<Badge className={`${WORK_ORDER_STATUS_COLORS[item.status]} border-0`}>
{WORK_ORDER_STATUS_LABELS[item.status]}
</Badge>
}
infoGrid={
<div className="grid grid-cols-2 gap-x-4 gap-y-3">
<InfoField label="공정" value={item.processName} />
<InfoField label="로트번호" value={item.lotNo} />
<InfoField label="발주처" value={item.client} />
<InfoField label="작업자" value={item.assignee || '-'} />
<InfoField label="지시일" value={item.orderDate} />
<InfoField label="출고예정일" value={item.shipmentDate} />
<InfoField label="현장순위" value={item.priority} />
</div>
}
/>
</TableCell>
<TableCell className="text-center text-muted-foreground">{globalIndex}</TableCell>
<TableCell className="font-medium">{order.workOrderNo}</TableCell>
<TableCell>{order.processName}</TableCell>
<TableCell>{order.lotNo}</TableCell>
<TableCell>{order.orderDate}</TableCell>
<TableCell className="text-center">{order.isAssigned ? 'Y' : '-'}</TableCell>
<TableCell className="text-center">
{order.status !== 'unassigned' && order.status !== 'pending' ? 'Y' : '-'}
</TableCell>
<TableCell className="text-center">{order.isStarted ? 'Y' : '-'}</TableCell>
<TableCell>
<Badge className={`${WORK_ORDER_STATUS_COLORS[order.status]} border-0`}>
{WORK_ORDER_STATUS_LABELS[order.status]}
</Badge>
</TableCell>
<TableCell className="text-center">{order.priority}</TableCell>
<TableCell>{order.assignee}</TableCell>
<TableCell className="max-w-[200px] truncate">{order.projectName}</TableCell>
<TableCell>{order.shipmentDate}</TableCell>
</TableRow>
);
};
// 모바일 카드 렌더링
const renderMobileCard = (
order: WorkOrder,
index: number,
globalIndex: number,
isSelected: boolean,
onToggle: () => void
) => {
return (
<ListMobileCard
id={order.id}
isSelected={isSelected}
onToggleSelection={onToggle}
onClick={() => handleView(order.id)}
headerBadges={
<>
<Badge variant="outline" className="text-xs">#{globalIndex}</Badge>
<Badge variant="outline" className="text-xs">{order.workOrderNo}</Badge>
</>
}
title={order.projectName}
statusBadge={
<Badge className={`${WORK_ORDER_STATUS_COLORS[order.status]} border-0`}>
{WORK_ORDER_STATUS_LABELS[order.status]}
</Badge>
}
infoGrid={
<div className="grid grid-cols-2 gap-x-4 gap-y-3">
<InfoField label="공정" value={order.processName} />
<InfoField label="로트번호" value={order.lotNo} />
<InfoField label="발주처" value={order.client} />
<InfoField label="작업자" value={order.assignee || '-'} />
<InfoField label="지시일" value={order.orderDate} />
<InfoField label="출고예정일" value={order.shipmentDate} />
<InfoField label="현장순위" value={order.priority} />
</div>
}
/>
);
};
// 헤더 액션
const headerActions = (
<Button className="ml-auto" onClick={handleCreate}>
<Plus className="w-4 h-4 mr-1.5" />
</Button>
);
},
}),
[tabs, stats, handleRowClick, handleCreate]
);
return (
<IntegratedListTemplateV2<WorkOrder>
title="작업지시 목록"
description="생산 작업지시 관리"
icon={FileText}
headerActions={headerActions}
stats={stats}
searchValue={searchTerm}
onSearchChange={handleSearchChange}
searchPlaceholder="작업지시번호, 발주처, 현장명 검색..."
tabs={tabs}
activeTab={activeTab}
onTabChange={handleTabChange}
tableColumns={tableColumns}
data={workOrders}
totalCount={totalItems}
allData={workOrders}
isLoading={isLoading}
selectedItems={selectedItems}
onToggleSelection={handleToggleSelection}
onToggleSelectAll={handleToggleSelectAll}
getItemId={(order) => order.id}
renderTableRow={renderTableRow}
renderMobileCard={renderMobileCard}
pagination={pagination}
/>
);
}
return <UniversalListPage config={config} />;
}