간략한 요약
이 튜토리얼 시리즈는 깨끗한 아키텍처와 견고한 원칙을 사용하여 현대적인 전자 상거래 애플리케이션을 구축하는 과정을 안내합니다. 핵심 API 개발부터 시작하여 제품 목록, 사용자 인증, 프런트 엔드 클라이언트 통합까지 다룹니다.
- 클린 아키텍처를 기반으로 전자상거래 앱 API 구축
- 제품, 카테고리 모델 생성 및 관리
- 리포지토리 패턴을 사용하여 데이터 액세스 추상화
- 서비스 계층을 통해 비즈니스 로직 구현
- 컨트롤러를 사용하여 API 엔드포인트 생성
- 전역 예외 처리 및 로깅 통합
- CORS 설정 및 ID 인증 추가
- 모델 유효성 검사 및 결제 방법, 장바구니 기능 구현
- 프런트 엔드 템플릿 통합 및 컴포넌트 생성
전자상거래 프로젝트 소개
이 비디오는 Netcode Hub 채널의 프레드가 진행하며, 현대적인 전자상거래 애플리케이션을 처음부터 구축하는 새로운 프로젝트를 소개합니다. 이 시리즈는 핵심 API 개발부터 시작하여 제품 목록 카드, 사용자 인증, 사용자 친화적인 프런트 엔드 클라이언트 구축까지 단계별로 안내합니다. 클린 아키텍처를 사용하여 소프트웨어를 쉽게 이해하고 유지하며 유연하게 대처할 수 있도록 합니다.
프로젝트 생성
프로젝트는 애플리케이션, 도메인, 호스트, 인프라의 네 가지 주요 프로젝트로 구성됩니다. 호스트 프로젝트는 API를 제공하며, 클라이언트를 만드는 데 사용됩니다. 애플리케이션은 도메인 로직을 구현하고, 인프라는 데이터 액세스와 관련된 구현을 담당합니다.
모델 생성
간단한 전자상거래 앱에 필요한 모델은 제품과 카테고리입니다. 제품 모델은 ID, 이름, 설명, 가격, 이미지, 수량, 카테고리 ID 등의 속성을 가집니다. 카테고리 모델은 ID와 이름을 가집니다. 제품과 카테고리 간에는 일대다 관계가 설정됩니다. DTO(Data Transfer Object)는 모델과 서비스 간의 데이터 전송을 위해 생성됩니다.
제품 및 카테고리 리포지토리 생성
리포지토리 패턴을 사용하여 데이터 액세스를 추상화합니다. 일반적인 리포지토리 인터페이스를 생성하여 CRUD(Create, Read, Update, Delete) 작업을 정의하고, 이를 구현하는 일반적인 리포지토리 클래스를 생성합니다. 제품과 카테고리에 대한 특정 리포지토리는 이 일반적인 리포지토리를 상속받아 구현됩니다.
제품 및 카테고리 서비스 생성
제품 및 카테고리 서비스는 비즈니스 로직을 구현합니다. 각 모델에 대한 특정 서비스 인터페이스를 생성하고, 이를 구현하는 서비스 클래스를 생성합니다. 서비스는 리포지토리를 사용하여 데이터에 액세스하고, DTO를 사용하여 데이터를 전송합니다. 응답 모델을 사용하여 서비스 호출 결과를 반환합니다.
제품 및 카테고리 컨트롤러 생성
제품 및 카테고리 컨트롤러는 API 엔드포인트를 제공합니다. 각 모델에 대한 컨트롤러를 생성하고, 서비스를 주입받아 API 요청을 처리합니다. 컨트롤러는 서비스의 응답 모델을 사용하여 API 응답을 생성합니다. 모델 상태 유효성 검사를 사용하여 요청 데이터를 검증합니다.
전역 예외 처리
전역 예외 처리 미들웨어를 생성하여 애플리케이션에서 발생하는 예외를 처리합니다. 이 미들웨어는 SQL 예외와 DB 업데이트 예외를 처리하고, 사용자에게 친숙한 메시지를 반환합니다. 알 수 없는 예외는 로깅하고, 500 내부 서버 오류를 반환합니다.
로깅 통합
Serilog를 사용하여 애플리케이션에 로깅을 통합합니다. 로깅 인터페이스를 생성하고, Serilog를 사용하여 이를 구현합니다. 로깅은 콘솔과 파일에 기록되며, 오류, 정보, 경고 등의 로그 레벨을 지원합니다.
CORS 추가
CORS(Cross-Origin Resource Sharing)를 추가하여 다른 도메인에서 API에 액세스할 수 있도록 합니다. 특정 원본을 허용하거나, 모든 원본을 허용하도록 CORS를 구성할 수 있습니다.
ID 인증 통합
ID 인증을 통합하여 사용자를 인증하고 권한을 부여합니다. 앱 사용자 클래스를 생성하여 ID 사용자 클래스를 확장하고, 전체 이름 속성을 추가합니다. JWT(JSON Web Token)를 사용하여 인증 토큰을 생성하고, 토큰의 유효성을 검사합니다. 사용자 관리, 토큰 관리 인터페이스를 생성하고, 이를 구현하는 클래스를 생성합니다.
모델 유효성 검사 추가
FluentValidation을 사용하여 모델 유효성 검사를 추가합니다. 생성 사용자 및 로그인 사용자에 대한 유효성 검사기를 생성하고, 유효성 검사 규칙을 정의합니다. 유효성 검사 서비스 인터페이스를 생성하고, 이를 구현하는 클래스를 생성합니다. 컨트롤러에서 유효성 검사 서비스를 사용하여 요청 데이터를 검증합니다.
결제 방법 리포지토리, 서비스 및 컨트롤러 추가
결제 방법 리포지토리, 서비스 및 컨트롤러를 추가하여 결제 방법을 관리합니다. 결제 방법 엔터티를 생성하고, 리포지토리 인터페이스와 구현을 생성합니다. 서비스 인터페이스와 구현을 생성하고, 컨트롤러를 생성하여 API 엔드포인트를 제공합니다.
장바구니 리포지토리, 서비스 및 컨트롤러 추가
장바구니 리포지토리, 서비스 및 컨트롤러를 추가하여 장바구니를 관리합니다. 장바구니 엔터티를 생성하고, 리포지토리 인터페이스와 구현을 생성합니다. 서비스 인터페이스와 구현을 생성하고, 컨트롤러를 생성하여 API 엔드포인트를 제공합니다.
소비 서비스 생성
소비 서비스를 생성하여 API를 소비합니다.
전자상거래 템플릿 통합
전자상거래 템플릿을 통합하여 프런트 엔드 UI를 제공합니다.
컴포넌트 생성
컴포넌트를 생성하여 UI를 구성합니다.
앱 실행
애플리케이션을 실행하고 테스트합니다.
