λΈ”λ‘œκ·Έλ‘œ λŒμ•„κ°€κΈ°

πŸš€ NestJS + Next.js ERP μ‹œμŠ€ν…œ κ°œλ°œμΌμ§€ #1: μ‹ μ²­μ„œ 관리 μ‹œμŠ€ν…œ ꡬ좕

πŸ“ 첫 λΈ”λ‘œκ·Έ 포슀트λ₯Ό μ‹œμž‘ν•˜λ©°

μ•ˆλ…•ν•˜μ„Έμš”! μ˜€λŠ˜λΆ€ν„° 개발 λΈ”λ‘œκ·Έλ₯Ό μ‹œμž‘ν•˜κ²Œ λ˜μ—ˆμŠ΅λ‹ˆλ‹€. μ΄λ²ˆμ— μ²­λ…„ λ§ˆμ„μ˜ ERP μ‹œμŠ€ν…œ 개발 μ™Έμ£Όλ₯Ό 맑게 λ˜λ©΄μ„œ, 개발 κ³Όμ •μ—μ„œ 배우고 κ²½ν—˜ν•œ 것듀을 λ¬Έμ„œλ‘œ 남겨두면 μ’‹κ² λ‹€λŠ” 생각이 λ“€μ—ˆμŠ΅λ‹ˆλ‹€. ν’€μŠ€νƒμœΌλ‘œ μƒμš© ERPλ₯Ό 혼자 κ°œλ°œν•˜κ²Œ λ˜μ–΄ λ³΄μ•ˆ, UI/UX, νšŒμ›κ°€μž… μ‹œμŠ€ν…œ, λ°μ΄ν„°λ² μ΄μŠ€ 섀계 λ“± μ‹ κ²½ 써야 ν•  뢀뢄이 정말 λ§Žλ‹€λŠ” 것을 μ‹€κ°ν•˜κ³  μžˆμŠ΅λ‹ˆλ‹€. 이 λΈ”λ‘œκ·Έλ₯Ό 톡해 개발 κ³Όμ •μ˜ 기둝과 ν•¨κ»˜ μ„±μž₯ν•˜λŠ” λͺ¨μŠ΅μ„ κ³΅μœ ν•˜κ³  μ‹ΆμŠ΅λ‹ˆλ‹€! πŸš€

🎯 였늘의 μž‘μ—… λͺ©ν‘œ

  • ν”„λ‘œκ·Έλž¨ μ‹ μ²­μ„œ 등둝 ν›„ λΌμš°νŒ… κ°œμ„ 
  • μ‚¬μš©μžλ³„ μ‹ μ²­ λͺ©λ‘ 보기 κΈ°λŠ₯ κ΅¬ν˜„
  • κ΄€λ¦¬μžμš© ν”„λ‘œκ·Έλž¨λ³„ μ‹ μ²­μž λͺ©λ‘ νŽ˜μ΄μ§€ 생성
  • Admin도 ν…ŒμŠ€νŠΈμš©μœΌλ‘œ ν”„λ‘œκ·Έλž¨ μ‹ μ²­ κ°€λŠ₯ν•˜λ„λ‘ μˆ˜μ •

πŸ› οΈ κ΅¬ν˜„ν•œ κΈ°λŠ₯λ“€

1. μ‹ μ²­μ„œ 등둝 ν›„ λΌμš°νŒ… μˆ˜μ •

❌ 문제

μ‹ μ²­μ„œ 등둝 ν›„ /applications νŽ˜μ΄μ§€λ‘œ μ΄λ™ν•˜λŠ”λ°, μ‚¬μš©μžκ°€ ν”„λ‘œκ·Έλž¨ 상세 정보λ₯Ό λ‹€μ‹œ ν™•μΈν•˜κ³  싢어함

βœ… ν•΄κ²°

μ‹ μ²­ μ™„λ£Œ ν›„ ν•΄λ‹Ή ν”„λ‘œκ·Έλž¨ 상세 νŽ˜μ΄μ§€λ‘œ λ¦¬λ‹€μ΄λ ‰νŠΈν•˜λ„λ‘ μˆ˜μ •

// κΈ°μ‘΄ router.push('/applications'); // μˆ˜μ • ν›„ router.push(`/programs/${programId}`);

2. μ‚¬μš©μžλ³„ μ‹ μ²­ λͺ©λ‘ νŽ˜μ΄μ§€ 생성

μƒˆλ‘œ μƒμ„±ν•œ νŽ˜μ΄μ§€: /frontend/src/app/applications/page.tsx

  • μ‚¬μš©μžκ°€ μ‹ μ²­ν•œ λͺ¨λ“  ν”„λ‘œκ·Έλž¨ λͺ©λ‘ ν‘œμ‹œ
  • μ‹ μ²­ μƒνƒœλ³„ λ°°μ§€ ν‘œμ‹œ (제좜됨, 심사쀑, 선정됨, λΆˆν•©κ²©, 철회됨)
  • 각 μ‹ μ²­μ„œλ³„ 상세보기 링크 제곡

3. μ‹ μ²­μ„œ 상세 보기 νŽ˜μ΄μ§€

μƒˆλ‘œ μƒμ„±ν•œ νŽ˜μ΄μ§€: /frontend/src/app/applications/[id]/page.tsx

  • μ‹ μ²­μ„œ λ‚΄μš©κ³Ό ν”„λ‘œκ·Έλž¨ 정보λ₯Ό ν•¨κ»˜ ν‘œμ‹œ
  • μ‹ μ²­μž 정보와 μ‹ μ²­ μƒνƒœ ν‘œμ‹œ
  • ν”„λ‘œκ·Έλž¨ μƒμ„Έλ³΄κΈ°λ‘œ μ΄λ™ν•˜λŠ” 링크 제곡

4. κ΄€λ¦¬μžμš© μ‹ μ²­μž λͺ©λ‘ νŽ˜μ΄μ§€

μƒˆλ‘œ μƒμ„±ν•œ νŽ˜μ΄μ§€: /frontend/src/app/admin/programs/[id]/applications/page.tsx

  • νŠΉμ • ν”„λ‘œκ·Έλž¨μ˜ λͺ¨λ“  μ‹ μ²­μž λͺ©λ‘ ν‘œμ‹œ
  • μ‹ μ²­μž 검색 κΈ°λŠ₯ (이름, 이메일, μ†Œμ†)
  • μ‹ μ²­ μƒνƒœλ³„ 톡계 ν‘œμ‹œ
  • 각 μ‹ μ²­μžλ³„ 상세보기 및 심사 κΈ°λŠ₯

5. Admin μ‹ μ²­ κ°€λŠ₯ κΈ°λŠ₯ (ν…ŒμŠ€νŠΈμš©)

❌ 문제

Admin이 ν”„λ‘œκ·Έλž¨μ— μ‹ μ²­ν•  수 μ—†μ–΄μ„œ ν…ŒμŠ€νŠΈκ°€ 어렀움

βœ… ν•΄κ²°

Admin도 μ‹ μ²­ν•  수 μžˆλ„λ‘ κΆŒν•œ 체크 둜직 μˆ˜μ •

// κΈ°μ‘΄ const canApply = user?.role === 'applicant' && program.status === 'open'; // μˆ˜μ • ν›„ const canApply = user && program.status === 'open'; // admin도 μ‹ μ²­ κ°€λŠ₯

6. ν”„λ‘œκ·Έλž¨ μˆ˜μ • νŽ˜μ΄μ§€ μƒνƒœ ν‘œμ‹œ 문제

❌ 문제

ν”„λ‘œκ·Έλž¨ μˆ˜μ • νŽ˜μ΄μ§€μ—μ„œ ν˜„μž¬ μƒνƒœκ°€ λ“œλ‘­λ‹€μš΄μ— ν‘œμ‹œλ˜μ§€ μ•ŠμŒ

βœ… ν•΄κ²°

useForm의 watch ν•¨μˆ˜λ₯Ό μ‚¬μš©ν•˜μ—¬ μ‹€μ‹œκ°„μœΌλ‘œ ν˜„μž¬ κ°’ ν‘œμ‹œ

<Select value={watch('status') || ''} onValueChange={(value) => setValue('status', value)} >

7. λ„€λΉ„κ²Œμ΄μ…˜ κ°œμ„ 

  • 헀더에 "λ‚΄ μ‹ μ²­ λͺ©λ‘" 링크 μΆ”κ°€
  • μ‚¬μ΄λ“œλ°”μ— "μ‹ μ²­μ„œ" 메뉴 μΆ”κ°€
  • μ–΄λ“œλ―Ό ν”„λ‘œκ·Έλž¨ λͺ©λ‘μ— 각 ν”„λ‘œκ·Έλž¨λ³„ "μ‹ μ²­μž λͺ©λ‘" λ²„νŠΌ μΆ”κ°€

πŸ”§ ν•΄κ²°ν•œ 기술적 λ¬Έμ œλ“€

1. organizerId μ—…λ°μ΄νŠΈ μ œν•œ 문제

⚠️ 문제 상황

ν”„λ‘œκ·Έλž¨ μˆ˜μ • μ‹œ organizerId 속성이 μ‘΄μž¬ν•˜μ§€ μ•Šμ•„μ•Ό ν•œλ‹€λŠ” 였λ₯˜ λ°œμƒ

원인: λ³΄μ•ˆμƒμ˜ 이유둜 ν”„λ‘œκ·Έλž¨ 생성 ν›„ 주졜 κΈ°κ΄€ 변경을 μ œν•œν•΄μ•Ό 함

// λ°±μ—”λ“œ μ„œλΉ„μŠ€μ—μ„œ organizerId μ œμ™Έ const { organizerId, ...updateData } = updateProgramDto; // ν”„λ‘ νŠΈμ—”λ“œμ—μ„œλ„ organizerId μ œμ™Έ const { organizerId, ...updateData } = data;

2. TypeScript λ¦°ν„° 였λ₯˜λ“€

  • any νƒ€μž… μ‚¬μš© β†’ unknown νƒ€μž…μœΌλ‘œ λ³€κ²½
  • μ‚¬μš©ν•˜μ§€ μ•ŠλŠ” import 제거
  • ESLint κ²½κ³  λ¬΄μ‹œ 주석 μΆ”κ°€

3. 도컀 λΉŒλ“œ μ‹€νŒ¨

문제: ν”„λ‘ νŠΈμ—”λ“œ λΉŒλ“œ μ‹œ TypeScript 였λ₯˜λ‘œ μΈν•œ μ‹€νŒ¨

ν•΄κ²°: λͺ¨λ“  λ¦°ν„° 였λ₯˜ μˆ˜μ • ν›„ μž¬λΉŒλ“œ 성곡

🎯 μ£Όμš” ν•™μŠ΅ 포인트

1. Next.js App Router ꡬ쑰 이해

  • 동적 λΌμš°νŒ… [id] μ‚¬μš©λ²•
  • ν΄λΌμ΄μ–ΈνŠΈ μ»΄ν¬λ„ŒνŠΈμ™€ μ„œλ²„ μ»΄ν¬λ„ŒνŠΈ ꡬ뢄
  • API λΌμš°νŒ…κ³Ό νŽ˜μ΄μ§€ λΌμš°νŒ… 뢄리

2. React Hook Form ν™œμš©

  • useForm의 watch, setValue, reset ν•¨μˆ˜ ν™œμš©
  • Zod μŠ€ν‚€λ§ˆλ₯Ό ν†΅ν•œ 폼 검증
  • μ‹€μ‹œκ°„ 폼 μƒνƒœ 관리

3. TypeScript νƒ€μž… μ•ˆμ •μ„±

  • μΈν„°νŽ˜μ΄μŠ€ μ •μ˜μ™€ νƒ€μž… μΆ”λ‘ 
  • unknown vs any νƒ€μž…μ˜ 차이점
  • μ œλ„€λ¦­μ„ ν™œμš©ν•œ API 응닡 νƒ€μž… μ •μ˜

4. λ°±μ—”λ“œ-ν”„λ‘ νŠΈμ—”λ“œ 연동

  • RESTful API 섀계 원칙
  • μ—λŸ¬ 핸듀링과 μ‚¬μš©μž ν”Όλ“œλ°±
  • κΆŒν•œ 기반 μ ‘κ·Ό μ œμ–΄

πŸ“‹ λ‹€μŒ 단계 κ³„νš

  1. μ‹ μ²­μ„œ 심사 κΈ°λŠ₯ κ΅¬ν˜„
  2. 이메일 μ•Œλ¦Ό μ‹œμŠ€ν…œ μΆ”κ°€
  3. λŒ€μ‹œλ³΄λ“œ 톡계 κΈ°λŠ₯ κ°•ν™”
  4. λͺ¨λ°”일 λ°˜μ‘ν˜• λ””μžμΈ κ°œμ„ 

πŸ’‘ 개발 팁

πŸš€ 효과적인 개발 방법

  • 점진적 개발: ν•œ λ²ˆμ— λͺ¨λ“  κΈ°λŠ₯을 κ΅¬ν˜„ν•˜μ§€ 말고 λ‹¨κ³„λ³„λ‘œ μ ‘κ·Ό
  • νƒ€μž… μ•ˆμ •μ„±: TypeScriptλ₯Ό 적극 ν™œμš©ν•˜μ—¬ λŸ°νƒ€μž„ 였λ₯˜ λ°©μ§€
  • μ‚¬μš©μž κ²½ν—˜: 개발자 관점이 μ•„λ‹Œ μ‚¬μš©μž κ΄€μ μ—μ„œ κΈ°λŠ₯ 섀계
  • μ—λŸ¬ 핸듀링: λͺ¨λ“  API ν˜ΈμΆœμ— μ μ ˆν•œ μ—λŸ¬ μ²˜λ¦¬μ™€ μ‚¬μš©μž ν”Όλ“œλ°± 제곡

이번 μž‘μ—…μ„ 톡해 전체적인 μ‹ μ²­μ„œ 관리 μ‹œμŠ€ν…œμ˜ κΈ°λ°˜μ„ λ§ˆλ ¨ν–ˆκ³ , μ‚¬μš©μžμ™€ κ΄€λ¦¬μž λͺ¨λ‘μ—κ²Œ νŽΈλ¦¬ν•œ μΈν„°νŽ˜μ΄μŠ€λ₯Ό μ œκ³΅ν•  수 있게 λ˜μ—ˆμŠ΅λ‹ˆλ‹€! πŸŽ‰

πŸ’­ κ°œλ°œμ„ 마치며 λŠλ‚€ 점

이번 μ²­λ…„ λ§ˆμ„ ERP ν”„λ‘œμ νŠΈλ₯Ό μ§„ν–‰ν•˜λ©΄μ„œ 정말 λ§Žμ€ 것을 배우고 μžˆμŠ΅λ‹ˆλ‹€. ν’€μŠ€νƒμœΌλ‘œ μƒμš© ERPλ₯Ό 혼자 κ°œλ°œν•œλ‹€λŠ” 것이 μ–Όλ§ˆλ‚˜ 큰 도전인지 μ΄μ œμ•Ό μ‹€κ°ν•˜κ³  μžˆμŠ΅λ‹ˆλ‹€.

πŸ” λ³΄μ•ˆμ˜ μ€‘μš”μ„±

λ‹¨μˆœνžˆ κΈ°λŠ₯을 κ΅¬ν˜„ν•˜λŠ” κ²ƒλ§ŒμœΌλ‘œλŠ” λΆ€μ‘±ν•˜λ‹€λŠ” 것을 κΉ¨λ‹¬μ•˜μŠ΅λ‹ˆλ‹€. μ‚¬μš©μž 인증, κΆŒν•œ 관리, 데이터 μ•”ν˜Έν™”, SQL μΈμ μ…˜ λ°©μ§€ λ“± λ³΄μ•ˆμ— μ‹ κ²½ 써야 ν•  뢀뢄이 정말 λ§ŽμŠ΅λ‹ˆλ‹€. 특히 ERP μ‹œμŠ€ν…œμ€ λ―Όκ°ν•œ 정보λ₯Ό 닀루기 λ•Œλ¬Έμ— λ”μš± 신쀑해야 ν•©λ‹ˆλ‹€.

🎨 μ‚¬μš©μž κ²½ν—˜μ˜ μ€‘μš”μ„±

개발자 κ΄€μ μ—μ„œλ§Œ μƒκ°ν•˜λ‹€ 보면 μ‚¬μš©μžκ°€ μ‹€μ œλ‘œ μ‚¬μš©ν•˜κΈ° μ–΄λ €μš΄ μΈν„°νŽ˜μ΄μŠ€κ°€ 될 수 μžˆμŠ΅λ‹ˆλ‹€. 직관적인 λ„€λΉ„κ²Œμ΄μ…˜, λͺ…ν™•ν•œ ν”Όλ“œλ°±, λ°˜μ‘ν˜• λ””μžμΈ λ“± μ‚¬μš©μž κ²½ν—˜μ„ κ³ λ €ν•œ 개발이 μ–Όλ§ˆλ‚˜ μ€‘μš”ν•œμ§€ λ°°μ› μŠ΅λ‹ˆλ‹€.

⚑ 개발 νš¨μœ¨μ„±μ˜ ν•„μš”μ„±

MVP 개발 기간이 μΆ©λΆ„ν•˜μ§€ μ•Šμ€ μƒν™©μ—μ„œ λ”μš± 효율적인 개발 방법을 μ°Ύμ•„μ•Ό ν•œλ‹€λŠ” 것을 λŠκΌˆμŠ΅λ‹ˆλ‹€. μ½”λ“œ μž¬μ‚¬μš©μ„±, μ»΄ν¬λ„ŒνŠΈ 섀계, API 섀계 λ“± μ²˜μŒλΆ€ν„° 잘 μ„€κ³„ν•˜λŠ” 것이 λ‚˜μ€‘μ— μ‹œκ°„μ„ μ ˆμ•½ν•˜λŠ” ν•΅μ‹¬μ΄λΌλŠ” 것을 κΉ¨λ‹¬μ•˜μŠ΅λ‹ˆλ‹€.

πŸ“š 지속적인 ν•™μŠ΅μ˜ ν•„μš”μ„±

NestJS, Next.js, TypeScript λ“± μƒˆλ‘œμš΄ κΈ°μˆ λ“€μ„ ν”„λ‘œμ νŠΈμ— μ μš©ν•˜λ©΄μ„œ λΆ€μ‘±ν•œ 뢀뢄이 λ§Žλ‹€λŠ” 것을 μ‹€κ°ν–ˆμŠ΅λ‹ˆλ‹€. ν•˜μ§€λ§Œ μ΄λ‘ λ§ŒμœΌλ‘œλŠ” λΆ€μ‘±ν•˜κ³ , μ‹€μ œ ν”„λ‘œμ νŠΈμ— μ μš©ν•΄λ³΄λ©΄μ„œ λ°°μš°λŠ” 것이 κ°€μž₯ νš¨κ³Όμ μ΄λΌλŠ” 것을 λŠκΌˆμŠ΅λ‹ˆλ‹€.

🎯 μ•žμœΌλ‘œμ˜ 닀짐

μ œν•œλœ μ‹œκ°„ μ•ˆμ— 완성도 높은 ERP μ‹œμŠ€ν…œμ„ κ°œλ°œν•˜κΈ° μœ„ν•΄μ„œλŠ” λ”μš± μ§‘μ€‘ν•˜κ³  효율적으둜 κ°œλ°œν•΄μ•Ό ν•©λ‹ˆλ‹€. λΆˆν•„μš”ν•œ κΈ°λŠ₯λ³΄λ‹€λŠ” 핡심 κΈ°λŠ₯에 μ§‘μ€‘ν•˜κ³ , μ‚¬μš©μžμ—κ²Œ μ§„μ •ν•œ κ°€μΉ˜λ₯Ό μ œκ³΅ν•˜λŠ” μ‹œμŠ€ν…œμ„ λ§Œλ“œλŠ” 것이 λͺ©ν‘œμž…λ‹ˆλ‹€. 이 λΈ”λ‘œκ·Έλ₯Ό 톡해 개발 과정을 κΈ°λ‘ν•˜κ³ , 같은 고민을 ν•˜λŠ” κ°œλ°œμžλ“€κ³Ό ν•¨κ»˜ μ„±μž₯ν•΄λ‚˜κ°€κ³  μ‹ΆμŠ΅λ‹ˆλ‹€.

ν•¨κ»˜ μ„±μž₯ν•˜λŠ” κ°œλ°œμžκ°€ λ˜κ² μŠ΅λ‹ˆλ‹€! πŸš€