Files
sam-react-prod/src/components/hr/EmployeeManagement/EmployeeForm.tsx

893 lines
34 KiB
TypeScript
Raw Normal View History

'use client';
import { useState, useEffect, useRef } from 'react';
import { useDaumPostcode } from '@/hooks/useDaumPostcode';
import { useRouter, useParams } from 'next/navigation';
import { toast } from 'sonner';
import { PageLayout } from '@/components/organisms/PageLayout';
import { PageHeader } from '@/components/organisms/PageHeader';
import { Card, CardContent, CardHeader, CardTitle } from '@/components/ui/card';
import { Button } from '@/components/ui/button';
import { Input } from '@/components/ui/input';
import { Label } from '@/components/ui/label';
import {
Select,
SelectContent,
SelectItem,
SelectTrigger,
SelectValue,
} from '@/components/ui/select';
import { Users, Plus, Trash2, ArrowLeft, Save, Settings, Camera, Edit } from 'lucide-react';
import { RadioGroup, RadioGroupItem } from '@/components/ui/radio-group';
import { FieldSettingsDialog } from './FieldSettingsDialog';
import type {
Employee,
EmployeeFormData,
DepartmentPosition,
FieldSettings,
} from './types';
import {
EMPLOYMENT_TYPE_LABELS,
GENDER_LABELS,
USER_ROLE_LABELS,
USER_ACCOUNT_STATUS_LABELS,
EMPLOYEE_STATUS_LABELS,
DEFAULT_FIELD_SETTINGS,
} from './types';
import { getPositions, getDepartments, type PositionItem, type DepartmentItem } from './actions';
import { getProfileImageUrl } from './utils';
interface EmployeeFormProps {
mode: 'create' | 'edit' | 'view';
employee?: Employee;
onSave?: (data: EmployeeFormData) => void;
onEdit?: () => void;
onDelete?: () => void;
fieldSettings?: FieldSettings;
}
// 유효성 검사 에러 타입
interface ValidationErrors {
name?: string;
email?: string;
userId?: string;
password?: string;
confirmPassword?: string;
}
const initialFormData: EmployeeFormData = {
name: '',
residentNumber: '',
phone: '',
email: '',
salary: '',
bankAccount: { bankName: '', accountNumber: '', accountHolder: '' },
profileImage: '',
employeeCode: '',
gender: '',
address: { zipCode: '', address1: '', address2: '' },
hireDate: '',
employmentType: '',
rank: '',
status: 'active',
departmentPositions: [],
clockInLocation: '',
clockOutLocation: '',
resignationDate: '',
resignationReason: '',
hasUserAccount: false,
userId: '',
password: '',
confirmPassword: '',
role: 'user',
accountStatus: 'active',
};
export function EmployeeForm({
mode,
employee,
onSave,
onEdit,
onDelete,
fieldSettings: initialFieldSettings = DEFAULT_FIELD_SETTINGS,
}: EmployeeFormProps) {
const router = useRouter();
const params = useParams();
const locale = params.locale as string || 'ko';
const [formData, setFormData] = useState<EmployeeFormData>(initialFormData);
const [errors, setErrors] = useState<ValidationErrors>({});
const isViewMode = mode === 'view';
// Daum 우편번호 서비스
const { openPostcode } = useDaumPostcode({
onComplete: (result) => {
setFormData(prev => ({
...prev,
address: {
...prev.address,
zipCode: result.zonecode,
address1: result.address,
},
}));
},
});
// 항목 설정 상태
const [showFieldSettings, setShowFieldSettings] = useState(false);
const [fieldSettings, setFieldSettings] = useState<FieldSettings>(initialFieldSettings);
const title = mode === 'create' ? '사원 등록' : mode === 'edit' ? '사원 수정' : '사원 상세';
const description = mode === 'create'
? '새로운 사원 정보를 입력합니다'
: mode === 'edit'
? '사원 정보를 수정합니다'
: '사원 정보를 확인합니다';
// 직급/직책/부서 목록
const [ranks, setRanks] = useState<PositionItem[]>([]);
const [titles, setTitles] = useState<PositionItem[]>([]);
const [departments, setDepartments] = useState<DepartmentItem[]>([]);
// localStorage에서 항목 설정 로드
useEffect(() => {
const saved = localStorage.getItem('employeeFieldSettings');
if (saved) {
try {
setFieldSettings(JSON.parse(saved));
} catch {
// ignore parse error
}
}
}, []);
// 직급/직책/부서 목록 로드
useEffect(() => {
const loadData = async () => {
const [rankList, titleList, deptList] = await Promise.all([
getPositions('rank'),
getPositions('title'),
getDepartments(),
]);
setRanks(rankList);
setTitles(titleList);
setDepartments(deptList);
};
loadData();
}, []);
// 항목 설정 저장
const handleSaveFieldSettings = (newSettings: FieldSettings) => {
setFieldSettings(newSettings);
localStorage.setItem('employeeFieldSettings', JSON.stringify(newSettings));
};
// 데이터 초기화 (edit, view 모드)
useEffect(() => {
if (employee && (mode === 'edit' || mode === 'view')) {
setFormData({
name: employee.name,
residentNumber: employee.residentNumber || '',
phone: employee.phone || '',
email: employee.email || '',
salary: employee.salary?.toString() || '',
bankAccount: employee.bankAccount || { bankName: '', accountNumber: '', accountHolder: '' },
profileImage: employee.profileImage || '',
employeeCode: employee.employeeCode || '',
gender: employee.gender || '',
address: employee.address || { zipCode: '', address1: '', address2: '' },
hireDate: employee.hireDate || '',
employmentType: employee.employmentType || '',
rank: employee.rank || '',
status: employee.status,
departmentPositions: employee.departmentPositions || [],
clockInLocation: employee.clockInLocation || '',
clockOutLocation: employee.clockOutLocation || '',
resignationDate: employee.resignationDate || '',
resignationReason: employee.resignationReason || '',
hasUserAccount: !!employee.userInfo,
userId: employee.userInfo?.userId || '',
password: '',
confirmPassword: '',
role: employee.userInfo?.role || 'user',
accountStatus: employee.userInfo?.accountStatus || 'active',
});
}
}, [employee, mode]);
// 입력 변경 핸들러
const handleChange = (field: keyof EmployeeFormData, value: unknown) => {
setFormData(prev => ({ ...prev, [field]: value }));
// 에러 초기화
if (errors[field as keyof ValidationErrors]) {
setErrors(prev => ({ ...prev, [field]: undefined }));
}
};
// 이메일 형식 검사
const isValidEmail = (email: string): boolean => {
const emailRegex = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
return emailRegex.test(email);
};
// 유효성 검사
const validateForm = (): boolean => {
const newErrors: ValidationErrors = {};
// 이름 필수
if (!formData.name.trim()) {
newErrors.name = '이름을 입력해주세요.';
}
// 이메일 필수 + 형식 검사
if (!formData.email.trim()) {
newErrors.email = '이메일을 입력해주세요.';
} else if (!isValidEmail(formData.email)) {
newErrors.email = '올바른 이메일 형식이 아닙니다.';
}
// 아이디 필수
if (!formData.userId.trim()) {
newErrors.userId = '아이디를 입력해주세요.';
}
// 등록 모드일 때 비밀번호 검사
if (mode === 'create') {
if (!formData.password) {
newErrors.password = '비밀번호를 입력해주세요.';
} else if (formData.password.length < 6) {
newErrors.password = '비밀번호는 6자 이상이어야 합니다.';
}
if (formData.password !== formData.confirmPassword) {
newErrors.confirmPassword = '비밀번호가 일치하지 않습니다.';
}
}
setErrors(newErrors);
// 에러가 있으면 첫 번째 에러 메시지 표시
const firstError = Object.values(newErrors)[0];
if (firstError) {
toast.error(firstError);
return false;
}
return true;
};
// 부서/직책 추가
const handleAddDepartmentPosition = () => {
const newDP: DepartmentPosition = {
id: String(Date.now()),
departmentId: '',
departmentName: '',
positionId: '',
positionName: '',
};
setFormData(prev => ({
...prev,
departmentPositions: [...prev.departmentPositions, newDP],
}));
};
// 부서/직책 삭제
const handleRemoveDepartmentPosition = (id: string) => {
setFormData(prev => ({
...prev,
departmentPositions: prev.departmentPositions.filter(dp => dp.id !== id),
}));
};
// 부서/직책 변경
const handleDepartmentPositionChange = (id: string, field: keyof DepartmentPosition, value: string) => {
setFormData(prev => ({
...prev,
departmentPositions: prev.departmentPositions.map(dp =>
dp.id === id ? { ...dp, [field]: value } : dp
),
}));
};
// 저장
const handleSubmit = (e: React.FormEvent) => {
e.preventDefault();
// view 모드에서는 저장 불가
if (isViewMode) return;
// 유효성 검사
if (!validateForm()) {
return;
}
onSave?.(formData);
};
// 취소 (목록으로 이동)
const handleCancel = () => {
router.push(`/${locale}/hr/employee-management`);
};
return (
<PageLayout>
{/* 헤더 + 버튼 영역 */}
<div className="flex items-start justify-between mb-6">
<PageHeader
title={title}
description={description}
icon={Users}
/>
{!isViewMode && (
<Button
type="button"
variant="outline"
onClick={() => setShowFieldSettings(true)}
>
<Settings className="w-4 h-4 mr-2" />
</Button>
)}
</div>
<form onSubmit={handleSubmit} className="space-y-6">
{/* 사원 정보 - 프로필 사진 + 기본 정보 */}
<Card>
<CardHeader className="bg-black text-white rounded-t-lg">
<CardTitle className="text-base font-medium"> </CardTitle>
</CardHeader>
<CardContent className="pt-6">
{/* 기본 정보 필드들 */}
<div className="grid grid-cols-1 md:grid-cols-2 gap-4">
<div className="space-y-2">
<Label htmlFor="name"> *</Label>
<Input
id="name"
value={formData.name}
onChange={(e) => handleChange('name', e.target.value)}
placeholder="이름을 입력하세요"
disabled={isViewMode}
className={errors.name ? 'border-red-500' : ''}
/>
{errors.name && <p className="text-sm text-red-500">{errors.name}</p>}
</div>
<div className="space-y-2">
<Label htmlFor="residentNumber"></Label>
<Input
id="residentNumber"
value={formData.residentNumber}
onChange={(e) => handleChange('residentNumber', e.target.value)}
placeholder="000000-0000000"
disabled={isViewMode}
/>
</div>
<div className="space-y-2">
<Label htmlFor="phone"></Label>
<Input
id="phone"
value={formData.phone}
onChange={(e) => handleChange('phone', e.target.value)}
placeholder="010-0000-0000"
disabled={isViewMode}
/>
</div>
<div className="space-y-2">
<Label htmlFor="email"> *</Label>
<Input
id="email"
type="email"
value={formData.email}
onChange={(e) => handleChange('email', e.target.value)}
placeholder="email@company.com"
disabled={isViewMode}
className={errors.email ? 'border-red-500' : ''}
/>
{errors.email && <p className="text-sm text-red-500">{errors.email}</p>}
</div>
<div className="space-y-2">
<Label htmlFor="salary"></Label>
<Input
id="salary"
type="number"
value={formData.salary}
onChange={(e) => handleChange('salary', e.target.value)}
placeholder="연봉 (원)"
disabled={isViewMode}
/>
</div>
</div>
{/* 급여 계좌 */}
<div className="space-y-2 mt-6">
<Label></Label>
<div className="grid grid-cols-1 md:grid-cols-3 gap-2">
<Input
value={formData.bankAccount.bankName}
onChange={(e) => handleChange('bankAccount', { ...formData.bankAccount, bankName: e.target.value })}
placeholder="은행명"
disabled={isViewMode}
/>
<Input
value={formData.bankAccount.accountNumber}
onChange={(e) => handleChange('bankAccount', { ...formData.bankAccount, accountNumber: e.target.value })}
placeholder="계좌번호"
disabled={isViewMode}
/>
<Input
value={formData.bankAccount.accountHolder}
onChange={(e) => handleChange('bankAccount', { ...formData.bankAccount, accountHolder: e.target.value })}
placeholder="예금주"
disabled={isViewMode}
/>
</div>
</div>
</CardContent>
</Card>
{/* 사원 상세 */}
{(fieldSettings.showProfileImage || fieldSettings.showEmployeeCode || fieldSettings.showGender || fieldSettings.showAddress) && (
<Card>
<CardHeader className="bg-black text-white rounded-t-lg">
<CardTitle className="text-base font-medium"> </CardTitle>
</CardHeader>
<CardContent className="pt-6 space-y-4">
{/* 프로필 사진 + 사원코드/성별 */}
<div className="flex gap-6">
{/* 프로필 사진 영역 */}
{fieldSettings.showProfileImage && (
<div className="space-y-2 flex-shrink-0">
<Label> </Label>
<div className={`w-32 h-32 border border-dashed border-gray-300 rounded-md flex flex-col items-center justify-center bg-gray-50 relative ${isViewMode ? '' : 'cursor-pointer hover:bg-gray-100'}`}>
{formData.profileImage ? (
<img
src={formData.profileImage}
alt="프로필"
className="w-full h-full object-cover rounded-md"
/>
) : (
<>
<span className="text-sm text-gray-400 mb-1">IMG</span>
<div className="w-8 h-8 rounded-full bg-gray-200 flex items-center justify-center">
<Camera className="w-4 h-4 text-gray-500" />
</div>
</>
)}
{!isViewMode && (
<input
type="file"
accept="image/png,image/jpeg,image/gif"
className="absolute inset-0 opacity-0 cursor-pointer"
onChange={async (e) => {
const file = e.target.files?.[0];
if (file) {
// 미리보기 즉시 표시
handleChange('profileImage', URL.createObjectURL(file));
// 서버에 업로드
const result = await uploadProfileImage(file);
if (result.success && result.data?.url) {
handleChange('profileImage', result.data.url);
}
master_api_sum - 2025-12-28 고객센터 시스템 게시판 API 연동 수정 기록 - 날짜 범위 필터 초기값 변경 내용 문서화 fix: 고객센터 목록 날짜 범위 초기값 변경 - EventList, InquiryList, NoticeList 날짜 범위 초기값 빈 문자열로 변경 - 페이지 진입 시 전체 데이터 조회 가능하도록 수정 feat: 1:1 문의 댓글 기능 API 연동 - 댓글 CRUD API 함수 구현 (shared/actions.ts) - getComments, createComment, updateComment, deleteComment - CommentApiData 타입 및 transformApiToComment 변환 함수 추가 - InquiryDetail 컴포넌트 callback props 방식으로 변경 - user.id localStorage 저장으로 본인 글 수정/삭제 버튼 표시 - page.tsx에서 댓글 API 호출 및 상태 관리 feat(WEB): 게시판 시스템 Mock → API 연동 (Phase J) - BoardList: getPosts, getMyPosts API 연동 - BoardDetail: getPost API 연동, 새 라우트 구조 적용 - BoardForm: getBoards, createPost, updatePost API 연동 - 라우트 변경: /board/[id] → /board/[boardCode]/[postId] - Toast 라이브러리 sonner로 통일 - MOCK_BOARDS 완전 제거, types.ts 정리 chore: 작업 현황 업데이트 refactor: BoardForm 부서 Mock 데이터 분리 - types.ts에서 MOCK_DEPARTMENTS 제거 - BoardForm 내부에 임시 Mock 데이터 정의 - TODO: API에서 부서 목록 연동 필요 feat: 종합현황 반려 사유 입력 Dialog 추가 - 반려 시 사유 입력 Dialog 표시 - 사유 미입력 시 toast 에러 메시지 - rejectIssue 함수에 reason 파라미터 추가 feat: 고객센터 Mock → API 연동 완료 - shared/actions.ts: 공통 게시글 API 액션 추가 - shared/types.ts: 공통 타입 정의 - InquiryList: Mock → API 연동, transform 함수 추가 - FAQList: Mock → API 연동, transform 함수 추가 - 상세 페이지: API 연동 (notices, events, inquiries) - 각 types.ts: transformPost 함수 추가 fix: 고객센터 board_code 불일치 수정 - 공지사항: notice → notices - 이벤트: event → events - DB 시스템 게시판 코드와 일치하도록 수정 feat: 결재 문서 작성 파일 첨부 기능 구현 - UploadedFile 타입 추가 및 ProposalData/ExpenseReportData에 uploadedFiles 필드 추가 - uploadFiles() 함수 구현 (/api/v1/files/upload API 연동) - createApproval/updateApproval에서 파일 업로드 후 저장 처리 - ProposalForm/ExpenseReportForm에 첨부파일 UI 개선 - 기존 업로드 파일 표시 (파일 보기/삭제 기능) - 새 첨부 파일 목록 표시 및 삭제 기능 - DraftBox에서 결재자 부서/직책 정보 표시 - 문서 상세 모달에서 실제 API 데이터 표시 (목업 데이터 제거) - 수정 모드 상신 시 PATCH 메서드 사용 (405 에러 수정) feat: [mock-migration] Phase J-4 게시판 관리 Mock → API 연동 완료 - types.ts: BoardApiData, BoardExtraSettings API 타입 추가 - actions.ts: Server Actions 생성 (CRUD, 변환 함수) - index.tsx: Mock 데이터 → API 호출로 전환 - [id]/page.tsx: 상세 페이지 API 연동 - [id]/edit/page.tsx: 수정 페이지 API 연동 - new/page.tsx: 등록 페이지 API 연동 주요 정책: - /boards/tenant 엔드포인트로 테넌트 게시판만 조회 - 수정 시 board_code 전송 안함 (코드 변경 불가) - extra_settings 내 target/target_name 저장 feat: 매입유형(purchase_type) 필드 저장 기능 추가 - actions.ts: API 응답/요청에 purchase_type 매핑 추가 - PurchaseDetail.tsx: 저장 시 purchaseType 포함하도록 수정 fix(salary): 직책/직급 매핑 수정 (사원관리 기준 통일) - transformApiToFrontend: position → job_title_label (직책), rank → rank (직급) - transformApiToDetail: 동일하게 수정 - 기존 잘못된 매핑: position_label(직위) → 직책, job_title_label(직책) → 직급 feat: [mock-migration] Phase M 잔여 Mock/TODO 제거 완료 - M-1: 매입 상세 모달 MOCK_ACCOUNTS, MOCK_VENDORS → API 연동 - M-2: 직원 관리 파일 업로드 API 연동 (uploadProfileImage) - M-4: 결재 문서 생성 MOCK_EMPLOYEES 제거 → getEmployees API - M-5: 결재함/기안함 console.log 제거 → 승인/반려 API 연동 - M-6: 구독 관리 TODO 제거 → requestDataExport, cancelSubscription - M-7: 계정 정보 TODO 제거 → withdrawAccount, suspendTenant docs: 휴가관리 사용현황 동기화 수정 작업 기록 - 2025-12-26 휴가 사용현황 동기화 수정 내용 추가 - fetchUsageData 호출 추가, 부여일수 계산 수정 문서화 feat: Phase G 생산관리/품질검사 Mock → API 연동 완료 G-1 작업지시관리: - WorkOrderList: getWorkOrders, getWorkOrderStats API - WorkOrderDetail: getWorkOrderById API - WorkOrderCreate: createWorkOrder API - SalesOrderSelectModal: getSalesOrdersForWorkOrder API G-2 작업실적관리: - WorkResultList: getWorkResults, getWorkResultStats API G-3 생산대시보드: - actions.ts 생성, getDashboardData API G-4 작업자화면: - actions.ts 생성 - getMyWorkOrders, completeWorkOrder API - MaterialInputModal: getMaterialsForWorkOrder, registerMaterialInput API - ProcessDetailSection: getProcessSteps, requestInspection API G-5 품질검사: - actions.ts 생성 - InspectionList: getInspections, getInspectionStats API - InspectionDetail: getInspectionById, updateInspection API - InspectionCreate: createInspection API fix: [vacation] 휴가 사용현황 동기화 및 부여일수 계산 수정 - 승인 후 fetchUsageData() 호출 추가로 사용현황 즉시 반영 - baseVacation: 동적 totalDays → 고정 '15일' (기본 연차) - grantedVacation: 하드코딩 '0일' → Math.max(0, totalDays-15) 계산 - useCallback dependencies에 fetchUsageData 추가 feat: Phase I Excel/PDF 다운로드 API 연동 - ReceivablesStatus: 채권현황 엑셀 다운로드 API 연동 - VendorLedger: 거래처원장 목록 엑셀, 상세 PDF 다운로드 API 연동 - DailyReport: 일일일보 엑셀 다운로드 API 연동 - Blob 다운로드 패턴 및 toast 알림 적용 feat: L-2 견적 관리 Mock → API 연동 ## 변경사항 - SAMPLE_QUOTES Mock 데이터 제거 - Server Actions 생성 (CRUD + 특수 기능 14개) - QuoteManagementClient 분리 (SSR/CSR 패턴) - Quote 타입 및 변환 함수 정의 ## 추가된 API 연동 - 목록/상세/등록/수정/삭제/일괄삭제 - 최종확정/확정취소/수주전환 - PDF 생성/이메일/카카오 발송 - 견적번호 미리보기/요약 통계 feat: 공정관리 페이지 및 컴포넌트 추가 - 공정관리 목록/상세/등록/수정 페이지 구현 - ProcessListClient, ProcessDetail, ProcessForm 컴포넌트 추가 - ProcessWorkLogPreviewModal, RuleModal 추가 - MobileCard 공통 컴포넌트 추가 - WorkLogModal.tsx 개선 - .gitignore 업데이트 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com> (cherry picked from commit f0c0de2ecd89e2702cd41a6e73805e948a910ecb) chore: React 공통 컴포넌트 업데이트 - VacationManagement: API 연동 개선 - WorkOrders: 작업자 선택 모달 개선 - TypeScript 빌드 설정 업데이트 feat: I-8 휴가 정책 관리 API 연동 - actions.ts: 휴가 정책 CRUD Server Actions - LeavePolicyManagement 컴포넌트 API 연동 feat: I-7 종합분석 API 연동 - actions.ts: 종합분석 조회 Server Actions - ComprehensiveAnalysis 컴포넌트 API 연동 feat: I-6 일일 생산현황 API 연동 - actions.ts: 일일 리포트 조회 Server Actions - DailyReport 컴포넌트 API 연동 feat: I-5 미수금 현황 API 연동 - actions.ts: 미수금 조회 Server Actions - ReceivablesStatus 컴포넌트 API 연동 feat: I-4 거래통장 조회 API 연동 - actions.ts: 은행 거래내역 조회 Server Actions - BankTransactionInquiry 컴포넌트 API 연동 feat: I-3 법인카드 사용내역 API 연동 - actions.ts: 카드 거래내역 조회 Server Actions - CardTransactionInquiry 컴포넌트 API 연동 feat: I-2 거래처 원장 API 연동 - actions.ts: 거래처 원장 조회 Server Actions - VendorLedger 컴포넌트 API 연동 - VendorLedgerDetail 상세 조회 연동 feat: H-3 출하 관리 API 연동 - actions.ts: Server Actions (CRUD, 상태 변경) - ShipmentList: 출하 목록 API 연동 - ShipmentCreate: 출하 등록 API 연동 - ShipmentEdit: 출하 수정 API 연동 - ShipmentDetail: 출하 상세 API 연동 feat: G-2 작업실적 관리 API 연동 - types.ts API 타입 추가 (WorkResultApi, WorkResultStatsApi 등) - transformApiToFrontend/transformFrontendToApi 변환 함수 추가 - actions.ts 서버 액션 생성 (8개 함수) - index.ts 액션 exports 추가 Server Actions: - getWorkResults: 목록 조회 (페이징, 필터링) - getWorkResultStats: 통계 조회 - getWorkResultById: 상세 조회 - createWorkResult: 등록 - updateWorkResult: 수정 - deleteWorkResult: 삭제 - toggleInspection: 검사 상태 토글 - togglePackaging: 포장 상태 토글 fix: StockStatusList Hook 순서 오류 수정 - 조건부 return 전에 모든 Hooks(useCallback, useMemo) 선언 - React Rules of Hooks 준수 feat: H-2 재고현황 Mock → API 연동 완료 - StockStatusDetail.tsx: 상세 조회 API 연동 - StockStatusList.tsx: 목록 조회 API 연동 (이전 세션) - actions.ts: 재고 현황 Server Actions 구현 feat: H-1 입고 관리 Mock → API 연동 완료 - ReceivingDetail.tsx: 상세 조회 및 입고처리 API 연동 - ReceivingProcessDialog.tsx: 폼 데이터 API 전달 구조로 변경 - InspectionCreate.tsx: 검사 대상 목록 API 조회 적용 - ReceivingList.tsx: 미사용 타입 import 정리 feat: G-1 작업지시 관리 API 연동 - actions.ts 서버 액션 11개 함수 구현 - types.ts API 타입 및 변환 함수 추가 - index.ts 액션 함수 export 추가 Server Actions: - getWorkOrders (목록) - getWorkOrderStats (통계) - getWorkOrderById (상세) - createWorkOrder (등록) - updateWorkOrder (수정) - deleteWorkOrder (삭제) - updateWorkOrderStatus (상태변경) - assignWorkOrder (담당자배정) - toggleBendingField (벤딩토글) - addWorkOrderIssue (이슈등록) - resolveWorkOrderIssue (이슈해결) feat: I-1 미지급비용 관리 React 연동 - Server Actions 패턴으로 API 연동 구현 (actions.ts) - Mock 데이터 제거, props 기반 데이터 주입 - Server Component로 초기 데이터 로딩 - 삭제/지급일 변경 등 CRUD 액션 연동 feat: HR 모듈 API 연동 완료 및 휴가관리 버그 수정 ## 휴가관리 (VacationManagement) - 휴가 부여 API 연동: createLeaveGrant 호출 추가 - 휴가 신청 시 선택된 사원 userId 전달 (잔여휴가 오류 수정) - LeaveType 타입 분리 (VacationType과 구분) - VacationGrantDialog에 부여일(grantDate) 필드 추가 ## 근태관리 (AttendanceManagement) - actions.ts 추가: API 호출 함수 분리 - 타입 정의 확장 및 개선 ## 기타 개선 - CardManagement, SalaryManagement: actions 개선 - DocumentCreate: 전자결재 actions 및 index 개선 - GoogleMap: 지도 컴포넌트 개선 feat: Phase E 인사관리 Mock → API 마이그레이션 - E-1 법인카드 관리 API 연동 - actions.ts 생성 (getCards, createCard, updateCard, deleteCard, toggleCardStatus) - CardForm, 페이지 컴포넌트 API 연동 - E-2 급여 관리 API 연동 - actions.ts 생성 (getSalaries, getSalary, updateSalaryStatus, bulkUpdateSalaryStatus) - 급여 목록 컴포넌트 API 연동 - 결재 시스템 actions.ts 추가 (ApprovalBox, DraftBox, ReferenceBox, DocumentCreate) - DepositManagement actions.ts 페이지네이션 응답 구조 수정 - 부서 관리, 휴가 관리 actions.ts 개선 - API URL에 /api prefix 추가 회계 및 설정 모듈 리팩토링: actions 분리, 타입 정의 개선 feat: 휴가 부여현황 Mock 데이터 제거 및 API 연동 - getLeaveGrants, createLeaveGrant, deleteLeaveGrant API 함수 추가 - LeaveGrantType, LeaveGrantRecord, CreateLeaveGrantRequest 타입 추가 - generateGrantData Mock 함수 제거 - fetchGrantData로 실제 API 호출 - grantData 상태를 API 데이터로 갱신 feat: 휴가 사용현황 Mock 데이터 제거 및 API 연동 - getLeaveBalances() API 함수 추가 - LeaveBalanceRecord, GetLeaveBalancesParams 타입 정의 - generateUsageData() Mock 함수 제거 - fetchUsageData()로 실제 API 호출 - hireDate 날짜 포맷팅 예외 처리 추가 feat: C-4 부서 관리 Mock → API 연동 - actions.ts 생성 (getDepartmentTree, createDepartment, updateDepartment, deleteDepartment, deleteDepartmentsMany) - index.tsx Mock 데이터 제거 및 API 연동 - 트리 구조 CRUD 완전 연동 ⚠️ .env.local에 API_URL=https://api.sam.kr/api 설정 필요 (Server Actions용) feat: C-3 휴가 관리 Mock → API 연동 - actions.ts 생성: getLeaves, createLeave, approveLeave, rejectLeave, cancelLeave 등 - index.tsx 수정: 신청현황 탭 Mock 데이터 → API 호출 전환 - 일괄 승인/반려 API 연동 (approveLeavesMany, rejectLeavesMany) - 휴가 신청 다이얼로그 createLeave API 연동 feat: C-2 근태 관리 Mock → API 연동 - actions.ts 생성 (checkIn/checkOut/getTodayAttendance) - GoogleMap.tsx userLocation 콜백 추가 - page.tsx Mock console.log 제거 + API 연동 - 처리중 상태 및 버튼 텍스트 추가 feat: C-1 직원 관리 Mock → API 연동 - actions.ts 생성 (CRUD + 통계 + 일괄삭제 Server Actions) - utils.ts 생성 (API ↔ Frontend 데이터 변환) - index.tsx Mock 데이터 제거, API 연동 - [id]/page.tsx 상세 페이지 API 연동 - [id]/edit/page.tsx 수정 페이지 API 연동 - new/page.tsx 등록 페이지 API 연동 API Endpoints: - GET/POST /api/v1/employees - GET/PATCH/DELETE /api/v1/employees/{id} - POST /api/v1/employees/bulk-delete - GET /api/v1/employees/stats feat: Daum 우편번호 서비스 연동 및 악성채권 UI 개선 - useDaumPostcode 공통 훅 생성 (Daum Postcode API 연동) - 우편번호 찾기 기능 적용: 악성채권, 거래처, 직원, 회사정보, 주문등록 - 악성채권 페이지 토글 순서 변경 (라벨 → 토글) - 악성채권 토글 기능 수정 (매출/매입 → 등록/해제) 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com> (cherry picked from commit 41ef0bdd866a4c522aa6bc813906232e0e79ba09) feat: A-2 팝업 관리 Mock → API 연동 - 상세 조회 페이지: MOCK_POPUPS → getPopupById() API - 수정 페이지: MOCK_POPUPS → getPopupById() API + 로딩 상태 - PopupForm: console.log → createPopup/updatePopup Server Actions - 삭제 기능: deletePopup() API 연동 + 로딩 상태 - 데이터 변환 유틸리티 추가 (API ↔ Frontend) feat: A-1 악성채권 관리 Mock → API 연동 완료 - 상세 페이지 서버 컴포넌트 전환 ([id]/page.tsx, [id]/edit/page.tsx) - BadDebtDetail.tsx: CRUD API 연동 (createBadDebt, updateBadDebt, deleteBadDebt) - actions.ts: 메모 API 추가 (addBadDebtMemo, deleteBadDebtMemo) feat: 매입 관리 Mock → API 전환 및 세금계산서 토글 연동 - index.tsx: Mock 데이터 제거, API 데이터 로딩으로 전환 - actions.ts: getPurchases(), togglePurchaseTaxInvoice() 서버 액션 추가 - vendorOptions 빈 문자열 필터링 (Select.Item 에러 수정) feat: 매출 상세 페이지 API 연동 - 목데이터(MOCK_VENDORS, fetchSalesDetail) 제거 - getSaleById, createSale, updateSale, deleteSale API 연동 - getClients로 거래처 목록 로드 - 상태 관리 개선 (clients, isLoading, isSaving) fix: Mock 데이터를 실제 API 연동으로 복원 - 팝업 관리, 결제 내역, 구독 관리, 알림 설정 API 연동 - 입금/출금/거래처 관리 API 연동 - page.tsx를 서버 컴포넌트로 변환 - actions.ts 서버 액션 추가
2025-12-24 14:04:36 +09:00
}
}}
/>
)}
</div>
{!isViewMode && (
<p className="text-xs text-gray-500">
1 250 X 250px, 10MB <br />PNG, JPEG, GIF
</p>
)}
</div>
)}
{/* 사원코드, 성별 */}
<div className="flex-1 space-y-4">
<div className="grid grid-cols-1 md:grid-cols-2 gap-4">
{fieldSettings.showEmployeeCode && (
<div className="space-y-2">
<Label htmlFor="employeeCode"></Label>
<Input
id="employeeCode"
value={formData.employeeCode}
onChange={(e) => handleChange('employeeCode', e.target.value)}
placeholder="사원코드를 입력해주세요"
disabled={isViewMode}
/>
</div>
)}
{fieldSettings.showGender && (
<div className="space-y-2">
<Label></Label>
<RadioGroup
value={formData.gender}
onValueChange={(value) => handleChange('gender', value)}
className="flex items-center gap-4 h-10"
disabled={isViewMode}
>
<div className="flex items-center space-x-2">
<RadioGroupItem value="male" id="gender-male" disabled={isViewMode} />
<Label htmlFor="gender-male" className="font-normal cursor-pointer"></Label>
</div>
<div className="flex items-center space-x-2">
<RadioGroupItem value="female" id="gender-female" disabled={isViewMode} />
<Label htmlFor="gender-female" className="font-normal cursor-pointer"></Label>
</div>
</RadioGroup>
</div>
)}
</div>
{/* 주소 (사원코드/성별 아래) */}
{fieldSettings.showAddress && (
<div className="space-y-2">
<Label></Label>
<div className="flex gap-2">
{!isViewMode && (
<Button type="button" variant="default" size="sm" onClick={openPostcode} className="bg-blue-500 hover:bg-blue-600">
</Button>
)}
<Input
value={formData.address.zipCode}
onChange={(e) => handleChange('address', { ...formData.address, zipCode: e.target.value })}
placeholder=""
className="w-24"
readOnly
disabled={isViewMode}
/>
<Input
value={formData.address.address2}
onChange={(e) => handleChange('address', { ...formData.address, address2: e.target.value })}
placeholder="상세주소를 입력해주세요"
className="flex-1"
disabled={isViewMode}
/>
</div>
</div>
)}
</div>
</div>
</CardContent>
</Card>
)}
{/* 인사 정보 */}
{(fieldSettings.showHireDate || fieldSettings.showEmploymentType || fieldSettings.showRank || fieldSettings.showStatus || fieldSettings.showDepartment || fieldSettings.showPosition || fieldSettings.showClockInLocation || fieldSettings.showClockOutLocation || fieldSettings.showResignationDate || fieldSettings.showResignationReason) && (
<Card>
<CardHeader className="bg-black text-white rounded-t-lg">
<CardTitle className="text-base font-medium"> </CardTitle>
</CardHeader>
<CardContent className="pt-6 space-y-4">
<div className="grid grid-cols-1 md:grid-cols-2 gap-4">
{fieldSettings.showHireDate && (
<div className="space-y-2">
<Label htmlFor="hireDate"></Label>
<Input
id="hireDate"
type="date"
value={formData.hireDate}
onChange={(e) => handleChange('hireDate', e.target.value)}
disabled={isViewMode}
/>
</div>
)}
{fieldSettings.showEmploymentType && (
<div className="space-y-2">
<Label htmlFor="employmentType"></Label>
<Select
value={formData.employmentType}
onValueChange={(value) => handleChange('employmentType', value)}
disabled={isViewMode}
>
<SelectTrigger disabled={isViewMode}>
<SelectValue placeholder="고용형태 선택" />
</SelectTrigger>
<SelectContent>
{Object.entries(EMPLOYMENT_TYPE_LABELS).map(([value, label]) => (
<SelectItem key={value} value={value}>{label}</SelectItem>
))}
</SelectContent>
</Select>
</div>
)}
{fieldSettings.showRank && (
<div className="space-y-2">
<Label htmlFor="rank"></Label>
<Input
id="rank"
value={formData.rank}
onChange={(e) => handleChange('rank', e.target.value)}
placeholder="직급 입력"
disabled={isViewMode}
/>
</div>
)}
{fieldSettings.showStatus && (
<div className="space-y-2">
<Label htmlFor="status"></Label>
<Select
value={formData.status}
onValueChange={(value) => handleChange('status', value)}
disabled={isViewMode}
>
<SelectTrigger disabled={isViewMode}>
<SelectValue placeholder="상태 선택" />
</SelectTrigger>
<SelectContent>
{Object.entries(EMPLOYEE_STATUS_LABELS).map(([value, label]) => (
<SelectItem key={value} value={value}>{label}</SelectItem>
))}
</SelectContent>
</Select>
</div>
)}
</div>
{/* 부서/직책 */}
{(fieldSettings.showDepartment || fieldSettings.showPosition) && (
<div className="space-y-2">
<div className="flex items-center justify-between">
<Label>/</Label>
{!isViewMode && (
<Button
type="button"
variant="outline"
size="sm"
onClick={handleAddDepartmentPosition}
>
<Plus className="w-4 h-4 mr-1" />
</Button>
)}
</div>
{formData.departmentPositions.length === 0 ? (
<p className="text-sm text-muted-foreground py-4 text-center border rounded-md">
{isViewMode ? '등록된 부서/직책이 없습니다' : '부서/직책을 추가해주세요'}
</p>
) : (
<div className="space-y-2">
{formData.departmentPositions.map((dp) => (
<div key={dp.id} className="flex items-center gap-2">
<Input
value={dp.departmentName}
onChange={(e) => handleDepartmentPositionChange(dp.id, 'departmentName', e.target.value)}
placeholder="부서명"
className="flex-1"
disabled={isViewMode}
/>
<Input
value={dp.positionName}
onChange={(e) => handleDepartmentPositionChange(dp.id, 'positionName', e.target.value)}
placeholder="직책"
className="flex-1"
disabled={isViewMode}
/>
{!isViewMode && (
<Button
type="button"
variant="ghost"
size="sm"
onClick={() => handleRemoveDepartmentPosition(dp.id)}
>
<Trash2 className="w-4 h-4 text-destructive" />
</Button>
)}
</div>
))}
</div>
)}
</div>
)}
{/* 출근/퇴근 위치 */}
<div className="grid grid-cols-1 md:grid-cols-2 gap-4">
{fieldSettings.showClockInLocation && (
<div className="space-y-2">
<Label htmlFor="clockInLocation"> </Label>
<Select
value={formData.clockInLocation}
onValueChange={(value) => handleChange('clockInLocation', value)}
disabled={isViewMode}
>
<SelectTrigger disabled={isViewMode}>
<SelectValue placeholder="출근 위치 선택" />
</SelectTrigger>
<SelectContent>
<SelectItem value="headquarters"></SelectItem>
<SelectItem value="branch1">1</SelectItem>
<SelectItem value="branch2">2</SelectItem>
<SelectItem value="remote"></SelectItem>
</SelectContent>
</Select>
</div>
)}
{fieldSettings.showClockOutLocation && (
<div className="space-y-2">
<Label htmlFor="clockOutLocation"> </Label>
<Select
value={formData.clockOutLocation}
onValueChange={(value) => handleChange('clockOutLocation', value)}
disabled={isViewMode}
>
<SelectTrigger disabled={isViewMode}>
<SelectValue placeholder="퇴근 위치 선택" />
</SelectTrigger>
<SelectContent>
<SelectItem value="headquarters"></SelectItem>
<SelectItem value="branch1">1</SelectItem>
<SelectItem value="branch2">2</SelectItem>
<SelectItem value="remote"></SelectItem>
</SelectContent>
</Select>
</div>
)}
</div>
{/* 퇴사일/퇴직사유 */}
{(fieldSettings.showResignationDate || fieldSettings.showResignationReason) && (
<div className="grid grid-cols-1 md:grid-cols-2 gap-4">
{fieldSettings.showResignationDate && (
<div className="space-y-2">
<Label htmlFor="resignationDate"></Label>
<Input
id="resignationDate"
type="date"
value={formData.resignationDate}
onChange={(e) => handleChange('resignationDate', e.target.value)}
disabled={isViewMode}
/>
</div>
)}
{fieldSettings.showResignationReason && (
<div className="space-y-2">
<Label htmlFor="resignationReason"></Label>
<Input
id="resignationReason"
value={formData.resignationReason}
onChange={(e) => handleChange('resignationReason', e.target.value)}
placeholder="퇴직 사유를 입력하세요"
disabled={isViewMode}
/>
</div>
)}
</div>
)}
</CardContent>
</Card>
)}
{/* 사용자 정보 */}
<Card>
<CardHeader className="bg-black text-white rounded-t-lg">
<CardTitle className="text-base font-medium"> </CardTitle>
</CardHeader>
<CardContent className="pt-6">
<div className="grid grid-cols-1 md:grid-cols-2 gap-4">
<div className="space-y-2">
<Label htmlFor="userId"> *</Label>
<Input
id="userId"
value={formData.userId}
onChange={(e) => handleChange('userId', e.target.value)}
placeholder="사용자 아이디"
disabled={isViewMode}
className={errors.userId ? 'border-red-500' : ''}
/>
{errors.userId && <p className="text-sm text-red-500">{errors.userId}</p>}
</div>
{mode === 'create' && (
<>
<div className="space-y-2">
<Label htmlFor="password"> *</Label>
<Input
id="password"
type="password"
value={formData.password}
onChange={(e) => handleChange('password', e.target.value)}
placeholder="비밀번호"
className={errors.password ? 'border-red-500' : ''}
/>
{errors.password && <p className="text-sm text-red-500">{errors.password}</p>}
</div>
<div className="space-y-2">
<Label htmlFor="confirmPassword"> *</Label>
<Input
id="confirmPassword"
type="password"
value={formData.confirmPassword}
onChange={(e) => handleChange('confirmPassword', e.target.value)}
placeholder="비밀번호 확인"
className={errors.confirmPassword ? 'border-red-500' : ''}
/>
{errors.confirmPassword && <p className="text-sm text-red-500">{errors.confirmPassword}</p>}
</div>
</>
)}
<div className="space-y-2">
<Label htmlFor="role"></Label>
<Select
value={formData.role}
onValueChange={(value) => handleChange('role', value)}
disabled={isViewMode}
>
<SelectTrigger disabled={isViewMode}>
<SelectValue placeholder="권한 선택" />
</SelectTrigger>
<SelectContent>
{Object.entries(USER_ROLE_LABELS).map(([value, label]) => (
<SelectItem key={value} value={value}>{label}</SelectItem>
))}
</SelectContent>
</Select>
</div>
<div className="space-y-2">
<Label htmlFor="accountStatus"></Label>
<Select
value={formData.accountStatus}
onValueChange={(value) => handleChange('accountStatus', value)}
disabled={isViewMode}
>
<SelectTrigger disabled={isViewMode}>
<SelectValue placeholder="상태 선택" />
</SelectTrigger>
<SelectContent>
{Object.entries(USER_ACCOUNT_STATUS_LABELS).map(([value, label]) => (
<SelectItem key={value} value={value}>{label}</SelectItem>
))}
</SelectContent>
</Select>
</div>
</div>
</CardContent>
</Card>
{/* 버튼 영역 */}
<div className="flex items-center justify-between">
<Button type="button" variant="outline" onClick={handleCancel}>
<ArrowLeft className="w-4 h-4 mr-2" />
</Button>
{isViewMode ? (
<div className="flex gap-2">
<Button type="button" onClick={onEdit}>
<Edit className="w-4 h-4 mr-2" />
</Button>
<Button type="button" variant="destructive" onClick={onDelete}>
<Trash2 className="w-4 h-4 mr-2" />
</Button>
</div>
) : (
<Button type="submit">
<Save className="w-4 h-4 mr-2" />
{mode === 'create' ? '등록' : '저장'}
</Button>
)}
</div>
</form>
{/* 항목 설정 모달 */}
<FieldSettingsDialog
open={showFieldSettings}
onOpenChange={setShowFieldSettings}
settings={fieldSettings}
onSave={handleSaveFieldSettings}
/>
</PageLayout>
);
}