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

πŸ” NestJS + Next.js둜 ν”„λ‘œκ·Έλž¨ μ‹ μ²­μ„œ 심사 및 μž…κΈˆ 관리 μ‹œμŠ€ν…œ 개발기

🎯 ν”„λ‘œμ νŠΈ κ°œμš”

ERP μ‹œμŠ€ν…œμ˜ ν”„λ‘œκ·Έλž¨ μ‹ μ²­μ„œ 관리 κΈ°λŠ₯을 ν™•μž₯ν•˜μ—¬, κ΄€λ¦¬μžκ°€ μ‹ μ²­μ„œλ₯Ό μ‹¬μ‚¬ν•˜κ³  μž…κΈˆ μƒνƒœλ₯Ό 관리할 수 μžˆλŠ” μ‹œμŠ€ν…œμ„ κ°œλ°œν–ˆμŠ΅λ‹ˆλ‹€. 이 κΈ€μ—μ„œλŠ” 개발 κ³Όμ •μ—μ„œ κ²ͺ은 λ¬Έμ œμ λ“€κ³Ό ν•΄κ²° 방법을 μƒμ„Ένžˆ κΈ°λ‘ν•©λ‹ˆλ‹€.

πŸ“Š ν”„λ‘œμ νŠΈ κ°œμš”

ERP μ‹œμŠ€ν…œμ˜ ν”„λ‘œκ·Έλž¨ μ‹ μ²­μ„œ 관리 κΈ°λŠ₯을 ν™•μž₯ν•˜μ—¬, κ΄€λ¦¬μžκ°€ μ‹ μ²­μ„œλ₯Ό μ‹¬μ‚¬ν•˜κ³  μž…κΈˆ μƒνƒœλ₯Ό 관리할 수 μžˆλŠ” μ‹œμŠ€ν…œμ„ κ°œλ°œν–ˆμŠ΅λ‹ˆλ‹€. 이번 ν”„λ‘œμ νŠΈμ—μ„œλŠ” λ°±μ—”λ“œ API κ°œλ°œλΆ€ν„° ν”„λ‘ νŠΈμ—”λ“œ UI κ΅¬ν˜„κΉŒμ§€ 전체적인 ν’€μŠ€νƒ 개발 과정을 κ²½ν—˜ν•  수 μžˆμ—ˆμŠ΅λ‹ˆλ‹€.

2
μƒˆλ‘œμš΄ API μ—”λ“œν¬μΈνŠΈ
3
λ°μ΄ν„°λ² μ΄μŠ€ 컬럼 μΆ”κ°€
5
ν•΄κ²°ν•œ λ¬Έμ œλ“€
1
μ§„ν–‰ 쀑인 문제

πŸ› οΈ 기술 μŠ€νƒ

πŸ”§
Backend
NestJS, TypeORM, PostgreSQL
βš›οΈ
Frontend
Next.js 15, React, Shadcn UI
πŸ—„οΈ
Database
PostgreSQL
🐳
Containerization
Docker, Docker Compose

πŸš€ κ΅¬ν˜„ν•œ κΈ°λŠ₯

1. λ°μ΄ν„°λ² μ΄μŠ€ μŠ€ν‚€λ§ˆ ν™•μž₯

Application μ—”ν‹°ν‹° μ—…λ°μ΄νŠΈ

// Application 엔티티에 μž…κΈˆ κ΄€λ ¨ ν•„λ“œ μΆ”κ°€ @Column({ default: false }) isPaymentReceived: boolean; @Column({ type: 'timestamp', nullable: true }) paymentReceivedAt: Date;

Program μ—”ν‹°ν‹° μ—…λ°μ΄νŠΈ

// Program 엔티티에 맀좜 ν•„λ“œ μΆ”κ°€ @Column({ type: 'int', default: 0 }) revenue: number;

2. λ°±μ—”λ“œ API 개발

ApplicationsService에 μƒˆλ‘œμš΄ λ©”μ„œλ“œ μΆ”κ°€

πŸ“ reviewApplication λ©”μ„œλ“œ

  • μ‹ μ²­μ„œλ₯Ό 합격 λ˜λŠ” λΆˆν•©κ²©μœΌλ‘œ 처리
  • κΆŒν•œ 검증 및 μƒνƒœ 검증 둜직 포함
  • 이미 처리된 μ‹ μ²­μ„œμ— λŒ€ν•œ 쀑볡 처리 λ°©μ§€

πŸ’° updatePaymentStatus λ©”μ„œλ“œ

  • μž…κΈˆ μƒνƒœ μ—…λ°μ΄νŠΈ
  • μž…κΈˆ 확인 μ‹œ ν”„λ‘œκ·Έλž¨ λ§€μΆœμ— μ°Έκ°€λΉ„ μžλ™ 반영
  • μž…κΈˆ μ·¨μ†Œ μ‹œ λ§€μΆœμ—μ„œ 차감
  • ν•©κ²©λœ μ‹ μ²­μ„œλ§Œ μž…κΈˆ μƒνƒœ λ³€κ²½ κ°€λŠ₯

ApplicationsController에 API μ—”λ“œν¬μΈνŠΈ μΆ”κ°€

// 심사 API μ—”λ“œν¬μΈνŠΈ @Patch(':id/review') @UseGuards(RolesGuard) @Roles(UserRole.ADMIN, UserRole.OPERATOR) review(@Param('id') id: string, @Body() body: { decision: 'selected' | 'rejected' }, @Request() req) { return this.applicationsService.reviewApplication(id, body.decision, req.user); } // μž…κΈˆ μƒνƒœ μ—…λ°μ΄νŠΈ API μ—”λ“œν¬μΈνŠΈ @Patch(':id/payment') @UseGuards(RolesGuard) @Roles(UserRole.ADMIN, UserRole.OPERATOR) updatePaymentStatus(@Param('id') id: string, @Body() body: { isPaymentReceived: boolean }, @Request() req) { return this.applicationsService.updatePaymentStatus(id, body.isPaymentReceived, req.user); }

3. ν”„λ‘ νŠΈμ—”λ“œ UI 개발

βš–οΈ
심사 관리 UI
Dialog μ»΄ν¬λ„ŒνŠΈλ₯Ό μ‚¬μš©ν•œ λͺ¨λ‹¬ λ°©μ‹μ˜ 심사 μΈν„°νŽ˜μ΄μŠ€
πŸ’°
μž…κΈˆ 관리 UI
ν•©κ²©λœ μ‹ μ²­μžμ—κ²Œλ§Œ ν‘œμ‹œλ˜λŠ” μž…κΈˆ 확인 μ²΄ν¬λ°•μŠ€
πŸ“Š
맀좜 정보 ν‘œμ‹œ
ν”„λ‘œκ·Έλž¨ 참가비와 ν˜„μž¬ 맀좜 μ‹€μ‹œκ°„ ν‘œμ‹œ
πŸ””
μ‹€μ‹œκ°„ ν”Όλ“œλ°±
Toast μ•Œλ¦ΌμœΌλ‘œ μ‚¬μš©μžμ—κ²Œ κ²°κ³Ό 전달

πŸ”§ 개발 κ³Όμ •μ—μ„œ κ²ͺ은 λ¬Έμ œμ λ“€

1. λ°μ΄ν„°λ² μ΄μŠ€ μŠ€ν‚€λ§ˆ μ—…λ°μ΄νŠΈ 문제

❌ 문제

Docker ν™˜κ²½μ—μ„œ TypeORM의 synchronize μ˜΅μ…˜μ΄ μ œλŒ€λ‘œ μž‘λ™ν•˜μ§€ μ•Šμ•„ μƒˆλ‘œμš΄ 컬럼이 μƒμ„±λ˜μ§€ μ•ŠμŒ

βœ… ν•΄κ²°

μˆ˜λ™μœΌλ‘œ SQL λͺ…λ Ήμ–΄λ₯Ό μ‹€ν–‰ν•˜μ—¬ 컬럼 μΆ”κ°€

-- μˆ˜λ™μœΌλ‘œ 컬럼 μΆ”κ°€ ALTER TABLE applications ADD COLUMN "isPaymentReceived" boolean DEFAULT false; ALTER TABLE applications ADD COLUMN "paymentReceivedAt" timestamp; ALTER TABLE programs ADD COLUMN revenue integer DEFAULT 0;

πŸ’‘ κ΅ν›ˆ

ν”„λ‘œλ•μ…˜ ν™˜κ²½μ—μ„œλŠ” λ§ˆμ΄κ·Έλ ˆμ΄μ…˜μ„ μ‚¬μš©ν•˜λŠ” 것이 μ•ˆμ „ν•˜λ©°, 개발 ν™˜κ²½μ—μ„œλ„ synchronize μ˜΅μ…˜μ˜ ν•œκ³„λ₯Ό 인지해야 함

2. Docker λΉŒλ“œ μΊμ‹œ 문제

❌ 문제

μ½”λ“œ λ³€κ²½ ν›„ Docker μž¬λΉŒλ“œ μ‹œ 변경사항이 λ°˜μ˜λ˜μ§€ μ•ŠμŒ

βœ… ν•΄κ²°

--force-recreate μ˜΅μ…˜μ„ μ‚¬μš©ν•˜μ—¬ κ°•μ œ μž¬μƒμ„±

# Docker μΊμ‹œ 문제 ν•΄κ²° docker-compose down docker-compose up --build --force-recreate

3. API μ—”λ“œν¬μΈνŠΈ 404 였λ₯˜

❌ 문제

μƒˆλ‘œ μΆ”κ°€ν•œ API μ—”λ“œν¬μΈνŠΈκ°€ 404 였λ₯˜λ₯Ό λ°˜ν™˜

βœ… ν•΄κ²°

λ°±μ—”λ“œ μ»¨ν…Œμ΄λ„ˆ μ™„μ „ μž¬μ‹œμž‘ 및 Docker 이미지 μž¬λΉŒλ“œ

원인 뢄석

  • λ°±μ—”λ“œ μ»¨ν…Œμ΄λ„ˆκ°€ μ œλŒ€λ‘œ μž¬μ‹œμž‘λ˜μ§€ μ•ŠμŒ
  • μƒˆλ‘œμš΄ λΌμš°νŠΈκ°€ λ“±λ‘λ˜μ§€ μ•ŠμŒ
  • Docker λΉŒλ“œ κ³Όμ •μ—μ„œ μ½”λ“œ 변경사항이 λ°˜μ˜λ˜μ§€ μ•ŠμŒ

4. ν”„λ‘ νŠΈμ—”λ“œ UI μ»΄ν¬λ„ŒνŠΈ 문제

❌ 문제

Dialog μ»΄ν¬λ„ŒνŠΈκ°€ μ œλŒ€λ‘œ μž‘λ™ν•˜μ§€ μ•ŠμŒ

βœ… ν•΄κ²°

Dialog μ»΄ν¬λ„ŒνŠΈ μž¬κ΅¬ν˜„ 및 단계적 μ ‘κ·Ό

ν•΄κ²° κ³Όμ •

  1. 초기 μ ‘κ·Ό: Dialog μ»΄ν¬λ„ŒνŠΈ μ‚¬μš©
  2. 문제 λ°œμƒ: λ²„νŠΌ 클릭이 μž‘λ™ν•˜μ§€ μ•ŠμŒ
  3. μž„μ‹œ ν•΄κ²°: confirm λ‹€μ΄μ–Όλ‘œκ·Έλ‘œ λŒ€μ²΄
  4. μ΅œμ’… ν•΄κ²°: Dialog μ»΄ν¬λ„ŒνŠΈ μž¬κ΅¬ν˜„

⚠️ 아직 ν•΄κ²°λ˜μ§€ μ•Šμ€ 문제

API μ—”λ“œν¬μΈνŠΈ 404 였λ₯˜ 지속

🚨 ν˜„μž¬ 상황

  • λ°±μ—”λ“œ μ»¨νŠΈλ‘€λŸ¬μ— μƒˆλ‘œμš΄ μ—”λ“œν¬μΈνŠΈκ°€ μ •μ˜λ˜μ–΄ 있음
  • Docker μž¬λΉŒλ“œ 후에도 λΌμš°νŠΈκ°€ λ“±λ‘λ˜μ§€ μ•ŠμŒ
  • ν”„λ‘ νŠΈμ—”λ“œμ—μ„œ PATCH /api/applications/:id/review μš”μ²­ μ‹œ 404 였λ₯˜

μ˜ˆμƒ 원인

  1. Docker λΉŒλ“œ μΊμ‹œ 문제: 이전 λΉŒλ“œ κ²°κ³Όκ°€ μΊμ‹œλ˜μ–΄ μƒˆλ‘œμš΄ μ½”λ“œκ°€ λ°˜μ˜λ˜μ§€ μ•ŠμŒ
  2. TypeScript 컴파일 문제: λΉŒλ“œ κ³Όμ •μ—μ„œ TypeScript 컴파일 였λ₯˜
  3. λͺ¨λ“ˆ λ‘œλ”© 문제: ApplicationsControllerκ°€ μ œλŒ€λ‘œ λ‘œλ“œλ˜μ§€ μ•ŠμŒ
  4. 포트 좩돌: ν”„λ‘ νŠΈμ—”λ“œκ°€ λ‘œμ»¬μ—μ„œ μ‹€ν–‰ μ€‘μ΄μ–΄μ„œ Docker μ»¨ν…Œμ΄λ„ˆ μ‹œμž‘ μ‹€νŒ¨

μ˜ˆμƒ ν•΄κ²° 방법

🧹
Docker μΊμ‹œ μ™„μ „ μ‚­μ œ
docker system prune -a둜 λͺ¨λ“  μΊμ‹œ μ‚­μ œ
πŸ”§
λ°±μ—”λ“œλ§Œ 별도 μ‹€ν–‰
ν”„λ‘ νŠΈμ—”λ“œλŠ” 둜컬, λ°±μ—”λ“œμ™€ DB만 Docker둜 μ‹€ν–‰
πŸ“Š
λ°±μ—”λ“œ 둜그 상세 확인
라우트 등둝 둜그λ₯Ό 톡해 문제 원인 νŒŒμ•…
πŸ§ͺ
μˆ˜λ™ API ν…ŒμŠ€νŠΈ
curl을 μ‚¬μš©ν•œ 직접 API ν…ŒμŠ€νŠΈ

πŸ“š 개발 κ³Όμ •μ—μ„œμ˜ κ΅ν›ˆ

1. 점진적 개발의 μ€‘μš”μ„±

  • λ³΅μž‘ν•œ κΈ°λŠ₯을 ν•œ λ²ˆμ— κ΅¬ν˜„ν•˜λ € ν•˜μ§€ 말고 λ‹¨κ³„μ μœΌλ‘œ μ ‘κ·Ό
  • 각 λ‹¨κ³„λ§ˆλ‹€ ν…ŒμŠ€νŠΈν•˜κ³  κ²€μ¦ν•˜λŠ” μŠ΅κ΄€ ν•„μš”

2. Docker ν™˜κ²½ 관리

  • 개발 ν™˜κ²½μ—μ„œ Docker μΊμ‹œ λ¬Έμ œλŠ” 자주 λ°œμƒ
  • --force-recreate μ˜΅μ…˜μ„ 적극 ν™œμš©
  • 둜그λ₯Ό 톡해 문제 원인 νŒŒμ•…ν•˜λŠ” μŠ΅κ΄€ ν•„μš”

3. API 개발 μ‹œ μ£Όμ˜μ‚¬ν•­

  • μƒˆλ‘œμš΄ μ—”λ“œν¬μΈνŠΈ μΆ”κ°€ ν›„ λ°˜λ“œμ‹œ μ„œλ²„ μž¬μ‹œμž‘
  • 라우트 등둝 둜그 ν™•μΈμœΌλ‘œ 문제 μ‘°κΈ° 발견
  • κΆŒν•œ μ„€μ •κ³Ό 데이터 검증 λ‘œμ§μ„ μ² μ €νžˆ κ΅¬ν˜„

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

  • API μ—”λ“œν¬μΈνŠΈκ°€ μ œλŒ€λ‘œ λ“±λ‘λ˜μ—ˆλŠ”μ§€ λ¨Όμ € 확인
  • λ„€νŠΈμ›Œν¬ νƒ­μ—μ„œ μ‹€μ œ μš”μ²­ URLκ³Ό 응닡 확인
  • μ—λŸ¬ μ²˜λ¦¬μ™€ μ‚¬μš©μž ν”Όλ“œλ°±μ„ 적절히 κ΅¬ν˜„

πŸš€ ν–₯ν›„ κ°œμ„  λ°©ν–₯

πŸ—„οΈ
λ°μ΄ν„°λ² μ΄μŠ€ λ§ˆμ΄κ·Έλ ˆμ΄μ…˜ μ‹œμŠ€ν…œ ꡬ좕
TypeORM λ§ˆμ΄κ·Έλ ˆμ΄μ…˜μ„ μ‚¬μš©ν•œ μŠ€ν‚€λ§ˆ 관리
πŸ“š
API λ¬Έμ„œν™” κ°•ν™”
Swaggerλ₯Ό ν™œμš©ν•œ API λ¬Έμ„œ μžλ™ 생성
⚠️
μ—λŸ¬ 처리 κ°œμ„ 
ꡬ체적인 μ—λŸ¬ λ©”μ‹œμ§€μ™€ μ‚¬μš©μž μΉœν™”μ  ν‘œμ‹œ
πŸ§ͺ
ν…ŒμŠ€νŠΈ μ½”λ“œ μž‘μ„±
λ‹¨μœ„ ν…ŒμŠ€νŠΈμ™€ 톡합 ν…ŒμŠ€νŠΈ μΆ”κ°€

πŸŽ‰ κ²°λ‘ 

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

이번 ν”„λ‘œμ νŠΈλ₯Ό 톡해 NestJS와 Next.jsλ₯Ό μ‚¬μš©ν•œ ν’€μŠ€νƒ 개발의 μ „ 과정을 κ²½ν—˜ν•  수 μžˆμ—ˆμŠ΅λ‹ˆλ‹€. 특히 Docker ν™˜κ²½μ—μ„œμ˜ 개발과 API 개발, ν”„λ‘ νŠΈμ—”λ“œ-λ°±μ—”λ“œ 연동 κ³Όμ •μ—μ„œ λ§Žμ€ 문제λ₯Ό κ²ͺμ—ˆμ§€λ§Œ, 이λ₯Ό 톡해 μ‹€λ¬΄μ—μ„œ 자주 λ°œμƒν•˜λŠ” λ¬Έμ œλ“€κ³Ό ν•΄κ²° 방법을 ν•™μŠ΅ν•  수 μžˆμ—ˆμŠ΅λ‹ˆλ‹€.

πŸ”§ 기술적 μ„±μž₯

Docker ν™˜κ²½ 관리, API 개발, λ°μ΄ν„°λ² μ΄μŠ€ μŠ€ν‚€λ§ˆ 섀계 λ“± λ‹€μ–‘ν•œ 기술적 도전을 톡해 ν’€μŠ€νƒ κ°œλ°œμžλ‘œμ„œμ˜ μ—­λŸ‰μ„ 크게 ν–₯μƒμ‹œν‚¬ 수 μžˆμ—ˆμŠ΅λ‹ˆλ‹€.

πŸ› 문제 ν•΄κ²° λŠ₯λ ₯

404 였λ₯˜, Docker μΊμ‹œ 문제, UI μ»΄ν¬λ„ŒνŠΈ 이슈 λ“± λ‹€μ–‘ν•œ 문제λ₯Ό ν•΄κ²°ν•˜λŠ” κ³Όμ •μ—μ„œ 디버깅 λŠ₯λ ₯κ³Ό 문제 ν•΄κ²° 사고λ ₯을 κΈ°λ₯Ό 수 μžˆμ—ˆμŠ΅λ‹ˆλ‹€.

πŸ“ˆ 지속적인 ν•™μŠ΅

아직 μ™„μ „νžˆ ν•΄κ²°λ˜μ§€ μ•Šμ€ API 404 였λ₯˜ λ¬Έμ œλŠ” λ‹€μŒ λ‹¨κ³„μ—μ„œ ν•΄κ²°ν•  μ˜ˆμ •μ΄λ©°, 이λ₯Ό 톡해 λ”μš± κ²¬κ³ ν•œ μ‹œμŠ€ν…œμ„ ꡬ좕할 수 μžˆμ„ κ²ƒμž…λ‹ˆλ‹€.

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

이번 ν”„λ‘œμ νŠΈμ—μ„œ 배운 κ²½ν—˜μ„ λ°”νƒ•μœΌλ‘œ λ”μš± μ•ˆμ •μ μ΄κ³  ν™•μž₯ κ°€λŠ₯ν•œ μ‹œμŠ€ν…œμ„ κ΅¬μΆ•ν•˜κ² μŠ΅λ‹ˆλ‹€. 특히 ν…ŒμŠ€νŠΈ μ½”λ“œ μž‘μ„±κ³Ό API λ¬Έμ„œν™”μ— λ”μš± μ‹ κ²½ μ¨μ„œ μœ μ§€λ³΄μˆ˜μ„±μ΄ 높은 μ½”λ“œλ₯Ό μž‘μ„±ν•˜κ² μŠ΅λ‹ˆλ‹€.

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