블로그로 돌아가기

🚀 Intu ERP 시스템 개발 일지: 프로그램 상태 관리 시스템 개선

최근 17개의 커밋을 통해 Intu ERP 시스템의 프로그램 상태 관리 시스템을 대폭 개선했습니다. 이번 업데이트에서는 한국 시간대 기반의 실시간 상태 계산, 하위 호환성을 보장하는 상태 체계 통합, 그리고 사용자 경험 개선에 중점을 두었습니다.

기존의 UTC 기반 시간 관리에서 한국 시간대(Asia/Seoul)를 기준으로 한 정확한 상태 계산 시스템을 구현하고, 실시간으로 상태를 계산하여 사용자에게 표시하는 기능을 추가했습니다. 또한 기존 데이터와의 호환성을 보장하면서 새로운 상태 체계를 도입했습니다.

📅 2025년 10월 26일 개발 작업 내용

🎯 오늘의 주요 작업

  1. 한국 시간대 기반 상태 관리 시스템 구현
  2. 실시간 상태 계산 및 표시 기능 추가
  3. 하위 호환성을 보장하는 상태 체계 통합
  4. UI/UX 개선 및 접근 권한 개선
  5. Next.js 호환성 개선

🕐 1. 한국 시간대 기반 상태 관리 시스템

문제 상황

  • 기존 UTC 기반 시간 관리로 인한 상태 계산 오류
  • 한국 사용자에게 부정확한 시간 정보 제공
  • 프론트엔드와 백엔드 간의 시간대 처리 불일치

해결 과정

1.1 새로운 상태 체계 도입

ProgramStatus 열거형 확장:

// backend/src/programs/enums/program-status.enum.ts export enum ProgramStatus { // 기존 상태들 (하위 호환성) DRAFT = 'draft', OPEN = 'open', CLOSED = 'closed', ONGOING = 'ongoing', COMPLETED = 'completed', ARCHIVED = 'archived', // 새로운 상태들 BEFORE_APPLICATION = 'before_application', APPLICATION_OPEN = 'application_open', IN_PROGRESS = 'in_progress', }

1.2 실시간 상태 계산 로직 구현

한국 시간대 기반 상태 계산 함수:

// backend/src/programs/utils/program-status.util.ts export function calculateProgramStatus( applyStart: string, applyEnd: string, programStart: string, programEnd: string ): 'draft' | 'open' | 'closed' | 'ongoing' | 'completed' | 'before_application' | 'application_open' | 'in_progress' { // 한국 시간 기준 현재 시간 const now = new Date(new Date().toLocaleString('en-US', { timeZone: 'Asia/Seoul' })); const applyStartDate = new Date(applyStart); const applyEndDate = new Date(applyEnd); const programStartDate = new Date(programStart); const programEndDate = new Date(programEnd); // 신청 기간 전 if (now < applyStartDate) { return 'before_application'; } // 신청 기간 중 if (now >= applyStartDate && now <= applyEndDate) { return 'application_open'; } // 신청 기간 종료 후, 활동 시작 전 if (now > applyEndDate && programStartDate && now < programStartDate) { return 'in_progress'; } // 활동 기간 중 if (programStartDate && programEndDate && now >= programStartDate && now <= programEndDate) { return 'in_progress'; } // 활동 종료 후 if (programEndDate && now > programEndDate) { return 'completed'; } return 'in_progress'; }

1.3 한국 시간대 유틸리티 함수 구현

시간 변환 유틸리티 함수들:

// backend/src/common/utils/time.util.ts // 한국 시간대 기준으로 현재 날짜를 YYYY-MM-DD 형식으로 반환 export function getKoreanDateString(date?: Date): string { const now = date || new Date(); const koreanTime = new Date(now.getTime() + (9 * 60 * 60 * 1000)); // UTC+9 return koreanTime.toISOString().split('T')[0]; } // 한국 날짜시간 문자열을 UTC Date 객체로 변환 export function koreanDateTimeStringToUTC(dateTimeString: string): Date { const koreanDate = new Date(dateTimeString); return new Date(koreanDate.getTime() - (9 * 60 * 60 * 1000)); // UTC로 변환 }

✅ 결과

한국 시간대 기준으로 정확한 상태 계산 및 시간 처리


⚡ 2. 실시간 상태 표시 UI 구현

문제 상황

  • 사용자가 날짜를 입력할 때 실시간으로 상태를 확인할 수 없음
  • 프로그램 등록/수정 시 현재 상태를 즉시 파악하기 어려움
  • 정적 상태 표시로 인한 사용자 경험 저하

해결 과정

2.1 실시간 시간 표시 구현

현재 시간 실시간 업데이트:

// frontend/src/app/admin/programs/create/page.tsx const [currentTime, setCurrentTime] = useState(new Date()); useEffect(() => { const timer = setInterval(() => { setCurrentTime(new Date()); }, 1000); return () => clearInterval(timer); }, []);

2.2 실시간 상태 계산 및 표시

React Hook Form의 watch 기능 활용:

// 실시간 상태 계산 const watchedValues = watch(); const realTimeStatus = useMemo(() => { if (watchedValues.applyStart && watchedValues.applyEnd && watchedValues.programStart && watchedValues.programEnd) { return calculateProgramStatus( watchedValues.applyStart, watchedValues.applyEnd, watchedValues.programStart, watchedValues.programEnd ); } return null; }, [watchedValues]); // 상태 표시 UI {realTimeStatus && (

현재 상태 미리보기

{getStatusLabel(realTimeStatus)}
)}

2.3 상태별 색상 구분

직관적인 색상 시스템:

// frontend/src/utils/status.util.ts const getStatusColor = (status: string) => { switch (status) { case 'before_application': return 'bg-gray-100 text-gray-800'; case 'application_open': return 'bg-green-100 text-green-800'; case 'in_progress': return 'bg-blue-100 text-blue-800'; case 'completed': return 'bg-purple-100 text-purple-800'; default: return 'bg-gray-100 text-gray-800'; } };

✅ 결과

사용자가 날짜 입력 시 실시간으로 상태를 확인할 수 있는 직관적인 UI 제공


🔄 3. 하위 호환성 보장

문제 상황

  • 기존 데이터와 새로운 상태 체계 간의 호환성 문제
  • 기존 상태를 새로운 상태로 변환하는 로직 필요
  • 데이터 마이그레이션 없이 점진적 전환 필요

해결 과정

3.1 백엔드 상태 변환 로직

기존 상태를 새로운 상태로 변환:

// backend/src/programs/programs.service.ts private calculateProgramStatus(program: Program): ProgramStatus { const now = new Date(new Date().toLocaleString('en-US', { timeZone: 'Asia/Seoul' })); // 기존 상태가 있으면 새로운 상태로 변환 if (program.status === ProgramStatus.OPEN) { return ProgramStatus.APPLICATION_OPEN; } if (program.status === ProgramStatus.CLOSED) { return ProgramStatus.IN_PROGRESS; } if (program.status === ProgramStatus.ONGOING) { return ProgramStatus.IN_PROGRESS; } // 날짜 기반 상태 계산 if (program.applyStart && program.applyEnd && program.programStart && program.programEnd) { return calculateProgramStatus( program.applyStart, program.applyEnd, program.programStart, program.programEnd ); } return program.status; }

3.2 프론트엔드 상태 매핑

상태 라벨 매핑 함수:

// frontend/src/utils/status.util.ts export const getStatusLabel = (status: string): string => { const statusLabels: Record<string, string> = { 'draft': '초안', 'open': '신청 가능', 'closed': '신청 마감', 'ongoing': '진행 중', 'completed': '완료', 'archived': '보관', 'before_application': '신청 전', 'application_open': '신청 가능', 'in_progress': '진행 중', }; return statusLabels[status] || status; };

✅ 결과

기존 데이터와 새로운 상태 체계 간의 완벽한 호환성 보장


🎨 4. UI/UX 개선사항

4.1 배지 스타일 통일

일관된 배지 디자인:

// 모든 Badge 컴포넌트에 border-0 클래스 추가 <Badge variant="secondary" className="border-0"> {getStatusLabel(status)} </Badge>

4.2 접근 권한 개선

프로그램 상세 페이지 접근 권한 확대:

// backend/src/programs/programs.controller.ts @Get(':id') @ApiOperation({ summary: '프로그램 상세 조회' }) async findOne(@Param('id') id: string): Promise<ApiResponseDto<Program>> { const program = await this.programsService.findOne(id); return new ApiResponseDto(program, true, '프로그램을 조회했습니다.'); }

백엔드 권한 체크 수정:

// backend/src/programs/programs.service.ts async findOne(id: string): Promise<Program> { const program = await this.programRepository.findOne({ where: { id }, relations: ['organizer'], }); if (!program) { throw new NotFoundException('프로그램을 찾을 수 없습니다.'); } // 모든 사용자가 접근 가능하도록 권한 체크 제거 return program; }

✅ 결과

비로그인 사용자와 신청자도 모든 프로그램 상세 페이지에 접근 가능


⚛️ 5. Next.js 호환성 개선

문제 상황

  • Next.js 15의 Suspense boundary 요구사항 미준수
  • useSearchParams 사용 시 빌드 오류 발생
  • 클라이언트 컴포넌트와 서버 컴포넌트 분리 필요

해결 과정

5.1 Suspense Boundary 구현

useSearchParams를 Suspense로 감싸기:

// frontend/src/app/auth/login/page.tsx export default function LoginPage() { return ( <Suspense fallback={<div>Loading...</div>}> <LoginPageContent /> </Suspense> ); } function LoginPageContent() { const searchParams = useSearchParams(); // ... 나머지 로직 }

5.2 클라이언트 컴포넌트 분리

동적 기능을 클라이언트 컴포넌트로 분리:

// frontend/src/components/auth/login-form.tsx 'use client'; import { useSearchParams } from 'next/navigation'; export default function LoginForm() { const searchParams = useSearchParams(); // ... 로그인 폼 로직 }

✅ 결과

Next.js 15 호환성 확보 및 빌드 오류 해결


📊 6. 개발 통계 및 성과

커밋 통계

17
총 커밋
8
기능 추가
5
버그 수정
4
리팩토링

주요 성과

✅ 달성한 기능들

  • 한국 시간대 기반 정확한 상태 관리
  • 실시간 상태 계산 및 표시
  • 하위 호환성 보장
  • 일관된 UI/UX 제공
  • 접근 권한 개선
  • Next.js 호환성 확보

🚀 7. 기술적 도전과 해결책

1. 시간대 불일치 문제

❌ 문제 상황

프론트엔드와 백엔드 간의 시간대 처리 불일치로 인한 상태 계산 오류

✅ 해결 방법

한국 시간대 기준으로 통일하고 UTC 변환 함수를 구현

2. 하위 호환성 유지

❌ 문제 상황

기존 데이터와 새로운 상태 체계 간의 호환성 문제

✅ 해결 방법

기존 상태를 새로운 상태로 변환하는 로직 구현

3. 실시간 UI 업데이트

❌ 문제 상황

사용자가 날짜를 입력할 때 실시간으로 상태를 확인할 수 없는 문제

✅ 해결 방법

React Hook Form의 watch 기능과 useEffect를 활용한 실시간 상태 계산


🔮 8. 향후 개선 계획

단기 계획

  • 상태 변경 이벤트 알림 시스템: 프로그램 상태 변경 시 관련자에게 알림
  • 상태별 통계 대시보드: 각 상태별 프로그램 수 및 통계 정보 제공
  • 실시간 알림 기능: 웹소켓을 활용한 실시간 상태 업데이트

장기 계획

  • 모바일 최적화: 모바일 환경에서의 상태 관리 개선
  • AI 기반 상태 예측: 과거 데이터를 바탕으로 한 상태 예측 기능
  • 고급 분석 기능: 상태별 트렌드 분석 및 인사이트 제공

💡 9. 개발 팁 및 인사이트

1. 시간대 처리

// 한국 시간대 기준 현재 시간 가져오기 const getKoreanTime = () => { return new Date(new Date().toLocaleString('en-US', { timeZone: 'Asia/Seoul' })); };

2. 실시간 상태 계산

// React Hook Form과 함께 사용하는 실시간 계산 const watchedValues = watch(); const realTimeStatus = useMemo(() => { if (watchedValues.applyStart && watchedValues.applyEnd) { return calculateProgramStatus( watchedValues.applyStart, watchedValues.applyEnd, watchedValues.programStart, watchedValues.programEnd ); } return null; }, [watchedValues]);

3. 하위 호환성 보장

// 기존 상태를 새로운 상태로 변환 const mapLegacyStatus = (oldStatus: string) => { const statusMap = { 'open': 'application_open', 'closed': 'in_progress', 'ongoing': 'in_progress', }; return statusMap[oldStatus] || oldStatus; };

📝 결론

이번 업데이트를 통해 Intu ERP 시스템의 프로그램 상태 관리가 크게 개선되었습니다. 한국 시간대 기반의 정확한 상태 계산, 실시간 UI 업데이트, 그리고 하위 호환성 보장을 통해 사용자 경험이 향상되었습니다.

특히 실시간 상태 계산 기능은 사용자가 프로그램을 등록하거나 수정할 때 즉시 현재 상태를 확인할 수 있게 해주어, 더욱 직관적이고 효율적인 워크플로우를 제공합니다. 또한 하위 호환성을 보장하면서 새로운 상태 체계를 도입함으로써 기존 데이터의 안정성을 유지하면서도 시스템의 기능을 확장할 수 있었습니다.

앞으로도 지속적인 개선을 통해 더 나은 시스템을 만들어가겠습니다. 상태 변경 알림, 통계 대시보드, 모바일 최적화 등 사용자에게 더 큰 가치를 제공할 수 있는 기능들을 단계적으로 구현해 나갈 예정입니다.