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

πŸ”§ NestJS + Next.js ERP μ‹œμŠ€ν…œ κ°œλ°œμΌμ§€ #8: μ‹œμŠ€ν…œ 문제 ν•΄κ²° 및 μ΅œμ ν™”

πŸ”§ ERP μ‹œμŠ€ν…œ μ΅œμ ν™” μž‘μ—…

졜근 λ„ˆλ¬΄ λ°”λΉ΄λ‹€. 일정도 λ§Žμ•˜κ³  κ°œλ°œμ„ λ§ˆλ¬΄λ¦¬ν•΄μ•Ό ν•˜λŠ” λ‹¨κ³„μ—μ„œ λΈ”λ‘œκ·Έ 올리기 νž˜λ“€μ—ˆλ‹€. ν”„λ‘œμ νŠΈ 마감이 λ‹€κ°€μ˜€λ©΄μ„œ λ”μš± 집쀑해야 ν•  μ‹œμ μ΄μ—ˆκ³ , 맀일맀일 μƒˆλ‘œμš΄ λ¬Έμ œλ“€μ΄ μŸμ•„μ Έ λ‚˜μ˜€λŠ” μƒν™©μ—μ„œ λΈ”λ‘œκ·Έ μž‘μ„±κΉŒμ§€ μ‹ κ²½ μ“Έ μ—¬μœ κ°€ μ—†μ—ˆλ‹€. ν•˜μ§€λ§Œ λͺ‡ μ£Ό 남지 μ•Šμ€ λ°λ“œλΌμΈμ„ μ§€ν‚€κΈ° μœ„ν•΄ 더 μ—΄μ‹¬νžˆ ν•˜κ² λ‹€λŠ” 마음으둜, 였늘 ν•˜λ£¨ λ™μ•ˆ ν•΄κ²°ν•œ λ¬Έμ œλ“€κ³Ό κ°œμ„ μ‚¬ν•­λ“€μ„ 정리해보렀고 ν•œλ‹€.

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

ERP μ‹œμŠ€ν…œμ˜ 핡심 κΈ°λŠ₯듀을 μ•ˆμ •ν™”μ‹œν‚€κ³ , μ‚¬μš©μž κ²½ν—˜μ„ κ°œμ„ ν•˜λŠ” κ³Όμ •μ—μ„œ λ§Žμ€ 것을 λ°°μ› λ‹€. 였늘 ν•˜λ£¨ λ™μ•ˆ ν•΄κ²°ν•œ μ£Όμš” λ¬Έμ œλ“€κ³Ό κ°œμ„ μ‚¬ν•­λ“€μ„ μ •λ¦¬ν•΄λ³΄κ² μŠ΅λ‹ˆλ‹€.

πŸ”§ μ£Όμš” ν•΄κ²° 문제

  1. 직원 κΆŒν•œ 문제 ν•΄κ²°
  2. λŒ€μ‹œλ³΄λ“œ μ‚­μ œλœ ν”„λ‘œκ·Έλž¨ ν‘œμ‹œ 문제 ν•΄κ²°
  3. 이미지 μ—…λ‘œλ“œ 및 ν‘œμ‹œ 문제 ν•΄κ²°
  4. uploads 폴더 μœ„μΉ˜ λ³€κ²½
  5. Next.js 이미지 도메인 μ„€μ •

πŸ”§ 1. 직원 κΆŒν•œ 문제 ν•΄κ²°

문제 상황

  • 직원(staff)이 λΆˆλŸ‰νšŒμ› 관리 νŽ˜μ΄μ§€μ— μ ‘κ·Όν•  수 μ—†μŒ
  • νŽ˜μ΄μ§€κ°€ 계속 λ‘œλ”© μƒνƒœλ‘œ ν‘œμ‹œλ¨
  • μš΄μ˜μžμ™€ μ§μ›μ˜ κΆŒν•œμ΄ 동일해야 함

ν•΄κ²° κ³Όμ •

1.1 λ°±μ—”λ“œ κΆŒν•œ μ„€μ • μˆ˜μ •

UserReportsController μˆ˜μ •:

// backend/src/user-reports/user-reports.controller.ts @Controller('user-reports') @UseGuards(JwtAuthGuard, RolesGuard) export class UserReportsController { @Get() @Roles(UserRole.ADMIN, UserRole.OPERATOR, UserRole.STAFF) // STAFF μΆ”κ°€ async findAll(@Request() req) { return this.userReportsService.findAll(req.user); } @Post() @Roles(UserRole.ADMIN, UserRole.OPERATOR, UserRole.STAFF) // STAFF μΆ”κ°€ async create(@Body() createUserReportDto: CreateUserReportDto, @Request() req) { return this.userReportsService.create(createUserReportDto, req.user); } }

UserReportsService μˆ˜μ •:

// backend/src/user-reports/user-reports.service.ts async findAll(user: User) { if (user.role === UserRole.ADMIN || user.role === UserRole.OPERATOR || user.role === UserRole.STAFF) { // λͺ¨λ“  λ§ˆμ„μ˜ μ‹ κ³ λ₯Ό λ³Ό 수 있음 return this.userReportRepository.find({ relations: ['reporter', 'reportedUser', 'reviewer'], order: { createdAt: 'DESC' }, }); } // ... }

1.2 ν”„λ‘ νŠΈμ—”λ“œ κΆŒν•œ μˆ˜μ •

UserReportsPage μˆ˜μ •:

// frontend/src/app/admin/users/reports/page.tsx useEffect(() => { if (user?.role === 'admin' || user?.role === 'operator' || user?.role === 'staff') { fetchReports(currentPage, searchTerm); } }, [user, currentPage, searchTerm]);

Sidebar λ„€λΉ„κ²Œμ΄μ…˜ μˆ˜μ •:

// frontend/src/components/layout/sidebar.tsx const getNavigation = (userRole: string) => { if (userRole === 'admin' || userRole === 'operator' || userRole === 'staff') { return [ { name: 'λŒ€μ‹œλ³΄λ“œ', href: '/admin', icon: Home }, { name: 'ν”„λ‘œκ·Έλž¨ 관리', href: '/admin/programs', icon: Calendar }, { name: 'μ‚¬μš©μž 관리', href: '/admin/users', icon: Users }, { name: 'λΆˆλŸ‰νšŒμ› 관리', href: '/admin/users/reports', icon: Flag }, // ... ]; } // ... };

βœ… κ²°κ³Ό

직원이 μš΄μ˜μžμ™€ λ™μΌν•œ κΆŒν•œμœΌλ‘œ λͺ¨λ“  관리 κΈ°λŠ₯에 μ ‘κ·Ό κ°€λŠ₯

πŸ—‘οΈ 2. λŒ€μ‹œλ³΄λ“œ μ‚­μ œλœ ν”„λ‘œκ·Έλž¨ ν‘œμ‹œ 문제 ν•΄κ²°

문제 상황

  • λŒ€μ‹œλ³΄λ“œμ—μ„œ μ‚­μ œλœ ν”„λ‘œκ·Έλž¨(isActive: false)이 졜근 ν”„λ‘œκ·Έλž¨μœΌλ‘œ ν‘œμ‹œλ¨
  • ν™œμ„±ν™”λœ ν”„λ‘œκ·Έλž¨λ§Œ ν‘œμ‹œλ˜μ–΄μ•Ό 함

ν•΄κ²° κ³Όμ •

DashboardService μˆ˜μ •:

// backend/src/dashboard/dashboard.service.ts private async getRecentPrograms(limit = 5, organizationId?: string) { let programs; if (!organizationId) { programs = await this.programRepository.find({ where: { isActive: true }, // isActive ν•„ν„° μΆ”κ°€ relations: ['organizer', 'applications'], order: { createdAt: 'DESC' }, take: limit, }); } else { programs = await this.programRepository.find({ where: { organizerId: organizationId, isActive: true }, // isActive ν•„ν„° μΆ”κ°€ relations: ['organizer', 'applications'], order: { createdAt: 'DESC' }, take: limit, }); } // ... }

βœ… κ²°κ³Ό

λŒ€μ‹œλ³΄λ“œμ—μ„œ ν™œμ„±ν™”λœ ν”„λ‘œκ·Έλž¨λ§Œ ν‘œμ‹œλ¨

πŸ“Έ 3. 이미지 μ—…λ‘œλ“œ 및 ν‘œμ‹œ 문제 ν•΄κ²°

문제 상황

  1. 이미지 μ—…λ‘œλ“œλŠ” λ˜μ§€λ§Œ 화면에 ν‘œμ‹œλ˜μ§€ μ•ŠμŒ
  2. 400 Bad Request μ—λŸ¬ λ°œμƒ
  3. Next.js Image μ»΄ν¬λ„ŒνŠΈκ°€ μ™ΈλΆ€ 도메인을 차단

ν•΄κ²° κ³Όμ •

3.1 μ—…λ‘œλ“œ 폴더 μœ„μΉ˜ λ³€κ²½

Docker Compose μ„€μ • μˆ˜μ •:

# docker-compose.prod.yml backend: volumes: - ../uploads:/app/uploads:rw # ./uploads β†’ ../uploads nginx: volumes: - ../uploads:/var/www/uploads:rw # ./uploads β†’ ../uploads

폴더 ꡬ쑰 λ³€κ²½:

nuvio/ β”œβ”€β”€ uploads/ # ← μƒˆλ‘œμš΄ μœ„μΉ˜ β”‚ └── images/ └── intu_erp/ β”œβ”€β”€ backend/ β”œβ”€β”€ frontend/ └── docker-compose.prod.yml

3.2 이미지 URL μ ˆλŒ€ 경둜 λ³€ν™˜

ImageUpload μ»΄ν¬λ„ŒνŠΈ μˆ˜μ •:

// frontend/src/components/ui/image-upload.tsx const data = await response.json(); const { url } = data; // μƒλŒ€ 경둜λ₯Ό μ ˆλŒ€ URL둜 λ³€ν™˜ const fullUrl = url.startsWith('http') ? url : `https://nuvio.kr${url}`; setPreview(fullUrl); onChange(fullUrl);

3.3 Next.js 이미지 도메인 μ„€μ •

next.config.ts μˆ˜μ •:

// frontend/next.config.ts const nextConfig: NextConfig = { // ... κΈ°μ‘΄ μ„€μ • images: { remotePatterns: [ { protocol: 'https', hostname: 'nuvio.kr', port: '', pathname: '/uploads/images/**', }, { protocol: 'https', hostname: 'www.nuvio.kr', port: '', pathname: '/uploads/images/**', }, ], }, };

3.4 Nginx 이미지 μ„œλΉ™ μ„€μ •

nginx.conf μˆ˜μ •:

# nginx/nginx.conf location /uploads/ { alias /var/www/uploads/; expires 1y; add_header Cache-Control "public, immutable"; # 이미지 파일 MIME νƒ€μž… μ„€μ • location ~* \.(jpg|jpeg|png|gif|webp|svg)$ { add_header Content-Type image/jpeg; add_header Content-Type image/png; add_header Content-Type image/gif; add_header Content-Type image/webp; add_header Content-Type image/svg+xml; } }

βœ… κ²°κ³Ό

이미지 μ—…λ‘œλ“œ 및 ν‘œμ‹œκ°€ μ •μƒμ μœΌλ‘œ μž‘λ™

πŸ”§ 4. ν”„λ‘œκ·Έλž¨ 생성 κΆŒν•œ 문제 ν•΄κ²°

문제 상황

  • 직원이 ν”„λ‘œκ·Έλž¨ 생성 μ‹œ 403 Forbidden μ—λŸ¬ λ°œμƒ
  • μ»¨νŠΈλ‘€λŸ¬μ—λŠ” κΆŒν•œμ΄ μžˆμ§€λ§Œ μ„œλΉ„μŠ€ λ‘œμ§μ—μ„œ λˆ„λ½

ν•΄κ²° κ³Όμ •

ProgramsService μˆ˜μ •:

// backend/src/programs/programs.service.ts async create(createProgramDto: CreateProgramDto, user: User): Promise<Program> { // κΆŒν•œ 확인: κ΄€λ¦¬μž, 운영자, μ§μ›λ§Œ ν”„λ‘œκ·Έλž¨ 생성 κ°€λŠ₯ if (user.role !== UserRole.ADMIN && user.role !== UserRole.OPERATOR && user.role !== UserRole.STAFF) { throw new ForbiddenException('ν”„λ‘œκ·Έλž¨ 생성 κΆŒν•œμ΄ μ—†μŠ΅λ‹ˆλ‹€.'); } // ... }

βœ… κ²°κ³Ό

직원이 ν”„λ‘œκ·Έλž¨μ„ μ •μƒμ μœΌλ‘œ 생성할 수 있음

πŸš€ 5. 배포 및 운영

배포 슀크립트

#!/bin/bash # deploy.sh echo "πŸš€ ν”„λ‘œλ•μ…˜ 배포 μ‹œμž‘..." # μ΅œμ‹  μ½”λ“œ κ°€μ Έμ˜€κΈ° git pull origin main # κΈ°μ‘΄ μ»¨ν…Œμ΄λ„ˆ 정리 docker-compose -f docker-compose.prod.yml --env-file .env.production down # μƒˆ μ»¨ν…Œμ΄λ„ˆ λΉŒλ“œ 및 μ‹€ν–‰ docker-compose -f docker-compose.prod.yml --env-file .env.production up -d --build echo "βœ… 배포 μ™„λ£Œ!"

μ„œλ²„ λͺ…λ Ήμ–΄

# μ΅œμ‹  μ½”λ“œ κ°€μ Έμ˜€κΈ° git pull origin main # μ»¨ν…Œμ΄λ„ˆ μž¬μ‹œμž‘ docker-compose -f docker-compose.prod.yml --env-file .env.production down docker-compose -f docker-compose.prod.yml --env-file .env.production up -d # νŠΉμ • μ„œλΉ„μŠ€λ§Œ μž¬λΉŒλ“œ docker-compose -f docker-compose.prod.yml --env-file .env.production up -d --build frontend

πŸ“Š 6. 문제 ν•΄κ²° κ³Όμ •μ—μ„œ 배운 점

1. κΆŒν•œ κ΄€λ¦¬μ˜ μ€‘μš”μ„±

  • ν”„λ‘ νŠΈμ—”λ“œμ™€ λ°±μ—”λ“œ λͺ¨λ‘μ—μ„œ μΌκ΄€λœ κΆŒν•œ 체크 ν•„μš”
  • μ—­ν•  기반 μ ‘κ·Ό μ œμ–΄(RBAC) κ΅¬ν˜„ μ‹œ λͺ¨λ“  λ ˆμ΄μ–΄μ—μ„œ 검증

2. 이미지 처리의 λ³΅μž‘μ„±

  • μƒλŒ€ 경둜 vs μ ˆλŒ€ 경둜 처리
  • Next.js Image μ»΄ν¬λ„ŒνŠΈμ˜ μ™ΈλΆ€ 도메인 μ œν•œ
  • Nginxλ₯Ό ν†΅ν•œ 정적 파일 μ„œλΉ™ μ„€μ •

3. Docker μ»¨ν…Œμ΄λ„ˆ κΆŒν•œ 문제

  • 파일 μ—…λ‘œλ“œ μ‹œ μ»¨ν…Œμ΄λ„ˆ μ‚¬μš©μž κΆŒν•œ μ„€μ •
  • λ³Όλ₯¨ 마운트 μ‹œ ν˜ΈμŠ€νŠΈμ™€ μ»¨ν…Œμ΄λ„ˆ κΆŒν•œ 일치

4. ν™˜κ²½λ³„ μ„€μ • 관리

  • 개발/ν”„λ‘œλ•μ…˜ ν™˜κ²½ 뢄리
  • ν™˜κ²½ λ³€μˆ˜λ₯Ό ν†΅ν•œ μ„€μ • 관리
  • Docker Composeλ₯Ό ν†΅ν•œ ν™˜κ²½ ꡬ성

🎯 7. λ‹€μŒ 단계 κ³„νš

1. μ„±λŠ₯ μ΅œμ ν™”

  • 이미지 μ••μΆ• 및 μ΅œμ ν™”
  • λ°μ΄ν„°λ² μ΄μŠ€ 쿼리 μ΅œμ ν™”
  • 캐싱 μ „λž΅ κ΅¬ν˜„

2. λ³΄μ•ˆ κ°•ν™”

  • 파일 μ—…λ‘œλ“œ λ³΄μ•ˆ 검증
  • API 레이트 λ¦¬λ―ΈνŒ…
  • μž…λ ₯ 데이터 검증 κ°•ν™”

3. λͺ¨λ‹ˆν„°λ§ 및 λ‘œκΉ…

  • μ• ν”Œλ¦¬μΌ€μ΄μ…˜ λ‘œκΉ… μ‹œμŠ€ν…œ
  • μ—λŸ¬ 좔적 및 μ•Œλ¦Ό
  • μ„±λŠ₯ λͺ¨λ‹ˆν„°λ§

4. μ‚¬μš©μž κ²½ν—˜ κ°œμ„ 

  • λ°˜μ‘ν˜• λ””μžμΈ μ΅œμ ν™”
  • λ‘œλ”© μƒνƒœ κ°œμ„ 
  • μ—λŸ¬ λ©”μ‹œμ§€ μ‚¬μš©μž μΉœν™”μ μœΌλ‘œ κ°œμ„ 

πŸ“ κ²°λ‘ 

였늘의 μž‘μ—…μ„ 톡해 ERP μ‹œμŠ€ν…œμ˜ 핡심 κΈ°λŠ₯듀을 μ•ˆμ •μ μœΌλ‘œ ꡬ좕할 수 μžˆμ—ˆμŠ΅λ‹ˆλ‹€. 특히 κΆŒν•œ 관리, 이미지 처리, 배포 μžλ™ν™” λ“± μ‹€μ œ 운영 ν™˜κ²½μ—μ„œ μ€‘μš”ν•œ μš”μ†Œλ“€μ„ 닀뀄보며 λ§Žμ€ μΈμ‚¬μ΄νŠΈλ₯Ό μ–»μ—ˆμŠ΅λ‹ˆλ‹€.

μ•žμœΌλ‘œλ„ 지속적인 κ°œμ„ κ³Ό μ΅œμ ν™”λ₯Ό 톡해 λ”μš± μ•ˆμ •μ μ΄κ³  μ‚¬μš©μž μΉœν™”μ μΈ μ‹œμŠ€ν…œμ„ λ§Œλ“€μ–΄ λ‚˜κ°€κ² μŠ΅λ‹ˆλ‹€.

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

이번 ERP μ‹œμŠ€ν…œ μ΅œμ ν™” μž‘μ—…μ„ 톡해 λ‹¨μˆœν•œ 버그 μˆ˜μ •μ„ λ„˜μ–΄μ„œ 전체적인 μ‹œμŠ€ν…œ μ•ˆμ •μ„±κ³Ό μ‚¬μš©μž κ²½ν—˜μ„ 크게 κ°œμ„ ν•  수 μžˆμ—ˆμŠ΅λ‹ˆλ‹€. 특히 κΆŒν•œ 관리, 이미지 처리, 배포 μžλ™ν™” λ“± μ‹€μ œ 운영 ν™˜κ²½μ—μ„œ μ€‘μš”ν•œ μš”μ†Œλ“€μ„ 닀뀄보며 λ§Žμ€ μΈμ‚¬μ΄νŠΈλ₯Ό μ–»μ—ˆμŠ΅λ‹ˆλ‹€.

πŸ” κΆŒν•œ κ΄€λ¦¬μ˜ μ€‘μš”μ„±

ν”„λ‘ νŠΈμ—”λ“œμ™€ λ°±μ—”λ“œ λͺ¨λ‘μ—μ„œ μΌκ΄€λœ κΆŒν•œ 체크의 μ€‘μš”μ„±μ„ κΉ¨λ‹¬μ•˜μŠ΅λ‹ˆλ‹€. μ—­ν•  기반 μ ‘κ·Ό μ œμ–΄(RBAC) κ΅¬ν˜„ μ‹œ λͺ¨λ“  λ ˆμ΄μ–΄μ—μ„œ κ²€μ¦ν•˜λŠ” 것이 μ–Όλ§ˆλ‚˜ μ€‘μš”ν•œμ§€ λ°°μ› μŠ΅λ‹ˆλ‹€.

πŸ–ΌοΈ 이미지 처리의 λ³΅μž‘μ„±

μƒλŒ€ 경둜 vs μ ˆλŒ€ 경둜 처리, Next.js Image μ»΄ν¬λ„ŒνŠΈμ˜ μ™ΈλΆ€ 도메인 μ œν•œ, Nginxλ₯Ό ν†΅ν•œ 정적 파일 μ„œλΉ™ μ„€μ • λ“± 이미지 처리의 λ³΅μž‘μ„±μ„ κ²½ν—˜ν–ˆμŠ΅λ‹ˆλ‹€.

🐳 Docker μ»¨ν…Œμ΄λ„ˆ κΆŒν•œ 문제

파일 μ—…λ‘œλ“œ μ‹œ μ»¨ν…Œμ΄λ„ˆ μ‚¬μš©μž κΆŒν•œ μ„€μ •κ³Ό λ³Όλ₯¨ 마운트 μ‹œ ν˜ΈμŠ€νŠΈμ™€ μ»¨ν…Œμ΄λ„ˆ κΆŒν•œ 일치의 μ€‘μš”μ„±μ„ λ°°μ› μŠ΅λ‹ˆλ‹€.

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

μ•žμœΌλ‘œλ„ 지속적인 κ°œμ„ κ³Ό μ΅œμ ν™”λ₯Ό 톡해 λ”μš± μ•ˆμ •μ μ΄κ³  μ‚¬μš©μž μΉœν™”μ μΈ μ‹œμŠ€ν…œμ„ λ§Œλ“€μ–΄ λ‚˜κ°€κ² μŠ΅λ‹ˆλ‹€. 이번 μž‘μ—…μ„ 톡해 배운 κΆŒν•œ 관리, 이미지 처리, 배포 μžλ™ν™” λ“±μ˜ λ…Έν•˜μš°λ₯Ό μ•žμœΌλ‘œμ˜ λͺ¨λ“  ν”„λ‘œμ νŠΈμ— μ μš©ν•˜κ² μŠ΅λ‹ˆλ‹€.

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