AACE AI SW
👤ParticipantACE AI SW
DAY 05 · FRIDAY · BACKEND ARCHITECTURE

백엔드 프레임워크와
레이어드 아키텍처

화면 뒤에서 요청이 응답으로 바뀌는 과정을 배웁니다. Part 1에서는 어떤 프레임워크에도 통하는 MVC 패턴과 백엔드 기본기를, Part 2에서는 Django를 예시로 API·업무 규칙·DB·외부 결제를 책임별로 나누는 레이어드 아키텍처를 설계합니다.

Day 3에서 만든 문서(REQ · DATA · API)가 오늘 백엔드 코드의 “어느 폴더, 어느 파일”로 들어가는지 연결합니다.

Today’s Flow

오늘의 진행 순서

프레임워크에 상관없는 기본기(MVC)를 먼저 잡고, Django로 실무형 레이어드 구조까지 확장합니다.

SESSION A · 80분 · PART 1

백엔드와 프레임워크

  • 요청 → 응답, HTTP 메서드·상태 코드
  • 백엔드가 하는 6가지 일
  • 프레임워크 비교 (Django·Express·Spring·Laravel …)
슬라이드 P1 · 1–6
SESSION B · 80분 · PART 1

MVC와 Django 시작

  • Model · View · Controller
  • Django MTV ↔ MVC 대응
  • startproject · startapp · 첫 API
  • Fat View의 한계
슬라이드 P1 · 7–13
SESSION C · 100분 · PART 2

레이어드 아키텍처

  • 5대 디렉터리와 의존성 방향
  • DTO · Rule · Policy · Calculator · Workflow · Port
  • 카페 주문 API와 container.py
슬라이드 P2 · 1–8
SESSION D · 80분 · PART 2

결제 확장 · 테스트 · AI 규격

  • Port & Adapter로 결제사 추가
  • 멱등성 · 웹훅 · Outbox
  • 3단계 테스트, AI 12단계 · 9대 금지
슬라이드 P2 · 9–13
실습 · 과제

내 프로젝트에 적용

  • Day 3 명세의 REQ를 계층에 배치
  • 파일 배치 퀴즈 8문항
  • BACKEND_RULES.md 작성
  • gstack /plan-eng-review로 검토
아래 실습 가이드

HTML Presentation

Day 5 발표 슬라이드

탭으로 Part 1(백엔드·MVC)과 Part 2(Django 레이어드 아키텍처)를 전환합니다. ←/→ 이동, N 키 또는 버튼으로 강의 노트를 엽니다.

ACE AI SW Startup Training · Day 5 · Part 1

버튼 하나 뒤에서
무슨 일이 일어날까?

사용자가 “주문하기”를 누르는 순간부터 화면에 “주문 완료”가 뜰 때까지 — 그 사이를 책임지는 것이 백엔드입니다.

사용자“주문하기”백엔드 서버DB결제 · 알림① 요청④ 응답③ 저장③ 연동② 검증 · 규칙 · 계산
Request브라우저·앱이 서버에 요청을 보낸다
Process검증하고, 규칙을 판단하고, 계산한다
PersistDB에 저장하고 외부 시스템과 연동한다
Response결과를 JSON 또는 HTML로 돌려준다
Client · Server · Database

프론트엔드는 보여 주고, 백엔드는 지킨다

모바일 앱 · 브라우저프론트엔드 · 보여 준다백엔드 서버규칙을 지킨다데이터베이스기록을 보관외부 API결제 · 알림 · 지도HTTP 요청 / 응답

프론트엔드 (Day 3 UI 명세)

  • 화면, 버튼, 입력 폼, 상태 표시
  • 사용자 경험과 즉각적인 피드백
  • 사용자가 조작할 수 있음 → 신뢰할 수 없음

백엔드 (Day 3 DATA · API · REQ)

  • “품절 메뉴는 주문 불가” 같은 업무 규칙의 최종 판단
  • 금액 계산, 데이터 저장, 권한 확인
  • 결제·알림 등 외부 시스템 연동
가격 계산을 브라우저에서만 하면? 사용자가 개발자 도구로 0원 주문을 보낼 수 있습니다. 규칙은 반드시 서버에서.
HANDS-ON 0110분짝 · 퀴즈

이 기능은 프론트엔드? 백엔드?

목표기능을 보고 어디에서 책임져야 하는지 스스로 판단한다
FRONTEND보여 준다화면 · 버튼 · 즉각 반응 · 조작 가능
BACKEND지킨다돈 · 권한 · 재고 · 저장 · 최종 판단
질문 1사용자가 바꿔도 괜찮나?No → 백엔드
질문 2돈 · 권한과 관련 있나?Yes → 백엔드
주문 버튼 색과 크기
✓ 프론트엔드 — 보이는 모양 — 사용자가 바꿔도 안전
품절 메뉴면 주문을 거부
✓ 백엔드 — 업무 규칙 — 브라우저에서만 막으면 우회 가능
주문 총액 최종 계산
✓ 백엔드 — 돈 — 브라우저 계산은 0원으로 조작 가능
입력 중 남은 글자 수 표시
✓ 프론트엔드 — 즉각적인 안내 — 조작돼도 피해 없음
관리자만 품절 처리 가능
✓ 백엔드 — 권한 — 서버에서 확인해야 안전
로딩 중 스피너 표시
✓ 프론트엔드 — 사용자 경험 — 보여 주기
정답 0 / 6
0/4
체크하면서
스스로 확인해 보세요
취창업 연결“이 규칙은 서버에서 검증해야 한다”를 아는 개발자는 보안 사고를 막는 사람으로 신뢰받습니다.
HTTP basics

요청과 응답: 메서드 · URL · 본문 · 상태 코드

요청 (Request)

POST /api/v1/cafe/orders
Content-Type: application/json

{ "items": [
    { "menu_id": 1, "quantity": 2 },
    { "menu_id": 3, "quantity": 1 } ] }

응답 (Response)

201 Created

{ "order_id": 1042,
  "status": "RECEIVED",
  "total_price": 13500 }
메서드의미상태 코드의미
GET조회200 / 201성공 / 생성됨
POST생성400 / 401 / 403잘못된 요청 / 인증 필요 / 권한 없음
PATCH · PUT수정404 / 409없음 / 충돌(중복 등)
DELETE삭제500서버 내부 오류
Analogy · 편지와 답장

HTTP는 편지를 보내고 답장을 받는 것

요청 = 보내는 편지받는 주소 (URL)/api/v1/cafe/orders편지 종류 (메서드)POST = 새로 만들어 주세요내용물 (본문 JSON)치킨 샌드위치 2개, 콜라 1개백엔드 = 우체국 + 사무실응답 = 답장201Created주문번호 1042합계 ₦13,500200성공201만들어짐400편지 내용이 이상해요401누구세요?403권한 없음404그런 주소 없음409이미 처리됨 (중복)500우체국 사고도장(상태 코드)만 봐도 결과를 안다: 2xx 성공 · 4xx 보낸 사람 문제 · 5xx 서버 문제
HANDS-ON 0210분짝 · 퀴즈

이 상황엔 어떤 도장(상태 코드)?

목표응답 숫자만 보고 무슨 일이 일어났는지 읽을 수 있다
2xx성공200 조회 · 201 생성
4xx보낸 쪽 문제400 · 401 · 403 · 404 · 409
5xx서버 쪽 문제500 내부 오류
팁앞자리부터 보기누구 잘못인지 먼저
새 주문이 저장됐다
✓ 201 — 새로 만들어짐 = Created
메뉴 목록을 불러왔다
✓ 200 — 조회 성공 = OK
quantity에 -1을 보냈다
✓ 400 — 요청 내용이 잘못됨 = Bad Request
로그인 없이 주문을 보냈다
✓ 401 — 누구인지 모름 = Unauthorized
없는 주문 번호 9999를 조회했다
✓ 404 — 그런 것 없음 = Not Found
같은 결제 키로 금액을 바꿔 보냈다
✓ 409 — 충돌 = Conflict (멱등성)
정답 0 / 6
0/4
체크하면서
스스로 확인해 보세요
취창업 연결상태 코드를 읽을 줄 알면 버그 원인을 절반은 찾은 것입니다. 백엔드 · QA 면접 단골 질문이에요.
What a backend does

백엔드가 하는 6가지 일

① 라우팅URL과 메서드를 보고 어떤 코드가 처리할지 결정/api/v1/cafe/orders → 주문 생성
② 입력 검증필수 값, 타입, 범위 확인quantity는 1 이상 정수인가?
③ 인증 · 권한누구인지, 이 일을 해도 되는지관리자만 품절 처리 가능
④ 업무 규칙 · 계산판매 가능 여부, 할인, 총액서비스의 핵심 가치
⑤ 데이터 저장DB에 일관성 있게 기록 (트랜잭션)주문 + 주문 항목 함께 저장
⑥ 외부 연동결제, 문자·이메일 알림, 지도 등실패·지연에 대비
Why frameworks?

프레임워크 = 반복되는 일 + 코드 위치의 약속

프레임워크 없이

  • URL 파싱, DB 연결, 세션, 보안을 매번 직접 구현
  • 사람마다 코드 위치와 스타일이 제각각
  • SQL 인젝션·CSRF 같은 보안 실수 위험

프레임워크와 함께

  • 라우팅 · ORM · 인증 · 관리자 · 보안 기능 기본 제공
  • “모델은 여기, 뷰는 여기” 공통 구조 → 협업 용이
  • AI도 정해진 위치에 코드를 작성하기 쉬움
내 코드내가 부른다라이브러리 (도구)프레임워크 (집의 뼈대)urls.pyviews.pymodels.py나를 부른다정해진 자리에 내 코드
라이브러리는 내가 부르는 도구, 프레임워크는 나를 불러 주는 뼈대입니다. (제어의 역전)
Popular backend frameworks

언어는 달라도 구조는 MVC 계열

프레임워크언어성격구조 패턴이럴 때
Django (+ DRF)Python풀스택 · 기능 내장(ORM·Admin·Auth)MTV (= MVC)빠른 MVP, 관리자 화면, 데이터 중심 서비스
FastAPI · FlaskPython마이크로 · API 중심자유 구성가벼운 API, AI 모델 서빙
Express · NestJSJavaScript / TS마이크로 / 구조화MVC · 모듈프론트와 같은 언어, 실시간
Spring BootJava / Kotlin엔터프라이즈 · 강한 구조Spring MVC · 계층형대규모·금융·공공 시스템
LaravelPHP풀스택 · 생산성MVC웹 서비스, 호스팅 환경이 PHP인 경우
Ruby on RailsRuby풀스택 · 관례 우선MVC스타트업 초기 제품
MVC pattern

MVC: 세 가지 책임을 나눈다

손님요청 “주문하기”Controller웨이터 — 주문 받고 전달OrderController.create()① 데이터 요청② 화면 결정Model주방 — 재료와 조리 규칙Menu · Order · OrderItemView접시 — 보여지는 결과주문 완료 화면 / JSON데이터를 화면에 담아 표시
🍽️ 식당 비유 — 웨이터(Controller)가 주문을 받아 주방(Model)에 전달하고, 완성된 요리(View)를 손님에게 내놓는다.
MVC request flow

요청 하나가 응답이 되기까지 6단계

사용자RouterControllerModel ↔ DBView1 POST /orders2 담당 선택3·4 메뉴 조회 · 주문 저장저장 결과5 화면/JSON 만들기6 201 Created + 주문번호
Expressroutes/ → controllers/ → models/ → views/
Spring MVC@Controller → @Service → @Repository → View/JSON
Laravel · Railsroutes → Controller → Model(Eloquent/ActiveRecord) → View
HANDS-ON 0310분짝 · 순서 맞히기

요청 하나의 여행, 순서대로 놓기

목표요청이 응답이 되기까지 누가 어떤 순서로 일하는지 설명한다
1
손님“주문할게요”
2
웨이터 (Controller)주문 확인 · 전달
3
주방 (Model)재료 · 조리 · 저장
4
접시 (View)결과를 담아 내놓기

① 카드를 순서대로 누르세요

② 내가 고른 순서

1…
2…
3…
4…
5…
6…
0 / 6 선택함
0/4
체크하면서
스스로 확인해 보세요
취창업 연결요청 흐름을 그림으로 설명하는 능력은 기술 면접 화이트보드 문제에서 가장 자주 쓰입니다.
Django MTV = MVC

Django의 MTV는 이름만 다른 MVC

MVC 이름Django 이름RouterURLconfurls.pyControllerView ⚠views.pyModelModelmodels.pyView (표현)Template ⚠ / Serializertemplates · DRF⚠ 이름이 엇갈려요Django View = Controller
Django에서 “View”라고 하면 요청을 처리하는 함수/클래스(MVC의 Controller)입니다.
Hands-on · Django in 5 commands

Django 프로젝트 시작하기

가상환경venv설치pip install프로젝트 · 앱startprojectDB 반영migrate실행runserver

명령어

# 가상환경 + 설치
python -m venv .venv
source .venv/bin/activate   # Windows: .venv\Scripts\activate
pip install django djangorestframework

# 프로젝트 · 앱 생성
django-admin startproject config .
python manage.py startapp cafe

# Model → DB 반영, 서버 실행
python manage.py makemigrations
python manage.py migrate
python manage.py runserver

생성되는 기본 구조

backend/
├── manage.py
├── config/   # settings · urls · wsgi/asgi
└── cafe/
    ├── migrations/
    ├── admin.py
    ├── apps.py
    ├── models.py   # Model
    ├── views.py    # Controller 역할
    └── tests.py
HANDS-ON 0420분혼자 · 터미널

Django 서버 직접 띄워 보기

목표내 컴퓨터에서 Django 서버를 실행하고 첫 화면을 확인한다
1
가상환경프로젝트 전용 상자
2
설치django · DRF
3
프로젝트 · 앱config · cafe
4
실행localhost:8000
팁Windows는 .venv\Scripts\activate · 오류가 나면 먼저 가상환경이 켜졌는지 확인하세요.

순서대로 실행 · 복사 버튼 사용

1
가상환경 만들고 켜기python -m venv .venv source .venv/bin/activate
2
설치pip install django djangorestframework
3
프로젝트 · 앱 만들기django-admin startproject config . python manage.py startapp cafe
4
DB 반영 · 실행python manage.py migrate python manage.py runserver

성공 확인

0 / 5
0/4
체크하면서
스스로 확인해 보세요
취창업 연결“로컬에서 서버를 띄우고 오류를 스스로 해결한다”는 것은 주니어 백엔드 개발자의 첫 번째 관문입니다.
Basic Django flow

urls → views → models 한눈에 보기

① urls.pyURL → 어느 View?② views.py요청 처리 (Controller)③ models.py데이터 · DB

models.py · Model

class Menu(models.Model):
    name = models.CharField(max_length=50)
    price = models.IntegerField()
    is_available = models.BooleanField(
        default=True)

views.py · Controller

class MenuListView(APIView):
    def get(self, request):
        menus = Menu.objects.filter(
            is_available=True)
        data = MenuSerializer(
            menus, many=True).data
        return Response(data)

urls.py · Router

urlpatterns = [
    path("api/v1/cafe/menus",
         MenuListView.as_view()),
]
Anti-pattern · Fat View / Fat Controller

한 View가 모든 일을 할 때 생기는 문제

책임 6개가 섞인 View

class OrderCreateView(APIView):
    def post(self, request):
        menu = Menu.objects.get(           # DB 조회
            id=request.data["menu_id"])
        if not menu.is_available:          # 업무 규칙
            raise ValidationError("판매 중 아님")
        total = menu.price * \
            request.data["quantity"]       # 계산
        order = Order.objects.create(      # 저장
            user=request.user, total_price=total)
        PaymentAPI.confirm(...)            # 외부 결제
        return Response({"order_id": order.id})

규모가 커지면

  • 같은 규칙이 여러 API에 중복된다
  • DB 없이 업무 로직을 테스트할 수 없다
  • 여러 개발자가 같은 파일을 고쳐 충돌한다
  • 결제사 변경이 서비스 전체에 영향을 준다
  • AI가 코드 위치를 일관되게 판단하지 못한다
HANDS-ON 0515분팀 · 분해 게임

Fat View를 조각내 제자리에 보내기

목표한 View에 섞인 코드를 책임별 계층으로 나눌 수 있다
APIView요청 받기 · 응답 돌려주기
Rule / Calculatorbusiness판단 · 계산 (DB 없이)
RepositoryinfrastructureDB 읽기 · 쓰기
Adapterinfrastructure외부 결제 · 알림
힌트.objects가 보이면 DB → Repository · 외부 회사 이름이 보이면 → Adapter
menu = Menu.objects.get(id=…)
정답: Repository
if not menu.is_available: raise …
정답: Rule
total = menu.price * quantity
정답: Calculator
Order.objects.create(…, total_price=total)
정답: Repository
PaymentAPI.confirm(…)
정답: Adapter
return Response({"order_id": …})
정답: API
0 / 6 분류함
0/4
체크하면서
스스로 확인해 보세요
취창업 연결레거시 코드를 책임별로 나누는 리팩터링 능력은 실무에서 가장 자주 쓰이는 기술 중 하나입니다.
From MVC to layers

MVC는 출발점, 규모가 커지면 계층을 더 나눈다

기본 MVC — 작은 서비스Controller (점점 비대해짐)Model (점점 비대해짐)View레이어드 — 규칙이 많아질 때API (View · Serializer)Workflow — 순서Rule · Policy · CalculatorPort ← Adapter (DB · 결제)더 잘게
Spring의 Controller → Service → Repository, NestJS의 Controller → Provider도 같은 생각입니다. Part 2에서 Django로 구체화합니다.
Day 5 · Part 2 · Django layered architecture

변경의 영향을
한 곳에 가두는 구조

✗ 한 곳을 고치면여기저기 영향✓ 계층으로 가두면APIWorkflowRules ← 여기만Infra변경이 한 층에 머문다
① API ↔ 업무 로직 분리View가 모든 일을 하지 않게
② DB 접근 분리ORM 쿼리를 Repository 뒤에
③ 업무 규칙 라이브러리화Rule · Policy · Calculator
④ 동시 개발 용이파일 단위 책임 → Git 충돌 최소화
⑤ 외부 결제 구조화Port & Adapter로 느슨한 결합
⑥ AI 개발 규격AI가 일관된 위치에 코드 작성
Target architecture

5대 디렉터리로 책임을 나눈다

backend/
├── manage.py
├── config/          # Django 전역 설정
├── apps/            # Django · HTTP 계층
│   ├── cafe/
│   └── billing/
├── business/        # 순수 업무 로직 (Django import 금지)
│   ├── core/  cafe/  billing/
├── infrastructure/  # DB · 외부 시스템 구현 (Port 구현체)
│   ├── repositories/  transactions/
│   ├── payment_gateways/  notifications/  outbox/
└── tests/
    ├── unit/  integration/  contract/
config/Django 전역 설정settings · urls · wsgi/asgiapps/Django · HTTP 계층DRF API · Model · Admin · container.pybusiness/순수 업무 로직 ★Rule · Policy · Calculator · Workflow · Port · DTOinfrastructure/DB · 외부 시스템Repository · 트랜잭션 · 결제 Adapter · Outboxtests/3단계 테스트unit · integration · contract
Dependency rule

의존성은 한 방향으로만 흐른다

apps / APIView · Serializer — HTTP 요청 검증, Workflow 호출
↓ calls
business / Workflow유스케이스 전체 처리 순서 조율
↓ orchestrates
business / Rule · Policy · Calculator순수 업무 규칙 · 정책 결정 · 금액 계산 (Django 비의존)
↓ depends on interface
business / Port (Protocol)OrderRepository · PaymentGateway 인터페이스
↑ implements
infrastructure / Repository · AdapterDjango ORM · 결제사 API · Outbox 구현체
Analogy · 식당 운영

레이어드 아키텍처를 식당 운영으로 이해하기

apps / API홀 직원주문을 받고 확인해 넘긴다View · Serializer
Workflow매니저순서를 정하고 일을 나눠 준다CreateOrderWorkflow
Rule · Policy · Calc레시피 · 가격표“재료 없으면 판매 불가”OrderQuantityRule
Port납품 주문서 양식“이런 형식으로 가져와 주세요”OrderRepository
Adapter · Repository납품 업체양식대로 실제 재료를 가져온다DjangoOrderRepository
납품 업체(DB · 결제사)가 바뀌어도 매니저와 레시피는 그대로입니다. 양식(Port)만 지키면 됩니다.
Forbidden vs allowed

Business는 어떤 DB를 쓰는지 모른다

금지 — business에서 ORM 직접 호출

from django.db import transaction
from apps.cafe.models import Order

Order.objects.create(...)

허용 — Port 인터페이스 주입

class CreateOrderWorkflow:
    def __init__(self,
                 order_repository: OrderRepository):
        self.order_repository = order_repository
판단 질문: “이 코드는 Django와 DB가 없어도 실행할 수 있는 업무 규칙인가?” → Yes면 business/
HANDS-ON 0610분짝 · 퀴즈

이 코드는 어느 폴더에 둘까?

목표새 코드를 만들 때 정해진 자리를 바로 고를 수 있다
apps/HTTP · DjangoSerializer · View · container
business/순수 업무 로직Rule · Policy · Calc · Port
infrastructure/DB · 외부 시스템Repository · Adapter
tests/검증unit · integration · contract
판단“이 코드는 Django와 DB가 없어도 실행할 수 있는 업무 규칙인가?” → Yes면 business/
class OrderQuantityRule
✓ business — 순수 업무 규칙 — Django 없이 실행
class OrderCreateSerializer
✓ apps — HTTP 요청 검증 — DRF
class DjangoOrderRepository
✓ infrastructure — Django ORM으로 DB 접근
class PaystackAdapter
✓ infrastructure — 외부 결제사 연동
class PaymentGateway(Protocol)
✓ business — business가 정한 규격(Port)
test_quantity_21_is_rejected
✓ tests — Unit 테스트
정답 0 / 6
0/4
체크하면서
스스로 확인해 보세요
취창업 연결팀 규칙대로 코드 자리를 지키는 개발자는 코드 리뷰가 빠르고 협업 충돌이 적습니다.
Business layer components

Business 계층의 6대 구성요소

DTO계층 사이 데이터를 전달하는 불변 객체 (Model 사용 안 함)CreateOrderCommand
Rule하나의 업무 조건만 판단OrderQuantityRule, MenuAvailableRule
Policy여러 Rule을 조합해 최종 결정OrderAcceptancePolicy
Calculator같은 입력 → 같은 결과. DB·외부 호출 없음, 금액에 float 금지OrderPriceCalculator
Workflow유스케이스의 처리 순서 조율. 직접 판단하지 않고 조합CreateOrderWorkflow
Port외부 계층에 요구하는 기능의 Protocol 인터페이스OrderRepository, PaymentGateway
Rule · Policy · Calculator

Day 3의 REQ가 순수 Python 규칙이 된다

Day 3 문서REQ-006 수량 1~20Rule 클래스OrderQuantityRuleUnit 테스트DB 없이 0.01초

Rule · REQ-006

class OrderQuantityRule:
    MAX = 20

    def evaluate(self, quantity):
        if quantity < 1 or quantity > self.MAX:
            return RuleResult.reject(
                "QUANTITY_OUT_OF_RANGE")
        return RuleResult.accept()

Policy

class OrderAcceptancePolicy:
    def __init__(self, rules):
        self.rules = rules

    def evaluate(self, context):
        for rule in self.rules:
            result = rule.evaluate(context)
            if not result.passed:
                return result
        return RuleResult.accept()

Calculator

class OrderPriceCalculator:
    def calculate(self, items):
        return sum(
            item.unit_price * item.quantity
            for item in items
        )
# 금액은 정수(최소 화폐 단위)
# 또는 Decimal 사용, float 금지
HANDS-ON 0710분혼자 · 코드

수량 Rule을 직접 만들고 테스트하기

목표Day 3 요구사항을 순수 Python Rule로 옮기고 테스트로 확인한다
1
요구 읽기REQ-006 수량 1~20
2
Rule 작성MIN · MAX 채우기
3
테스트 실행DB 없이 즉시
4
경계값 확인0 · 1 · 20 · 21
경계값버그는 대부분 경계(0과 1, 20과 21)에서 생깁니다. 테스트는 꼭 경계에서!
class OrderQuantityRule:      # REQ-006
    MIN =     MAX = 
    def evaluate(self, quantity):
        if quantity < self.MIN or quantity > self.MAX:
            return reject("QUANTITY_OUT_OF_RANGE")
        return accept()
quantity0기대: 거절–
quantity1기대: 통과–
quantity10기대: 통과–
quantity20기대: 통과–
quantity21기대: 거절–
MIN · MAX를 넣어 보세요
0/4
체크하면서
스스로 확인해 보세요
취창업 연결“테스트로 증명하는 개발자”는 어떤 팀에서도 환영받습니다. 경계값 테스트는 QA 면접 필수 개념입니다.
Case 1 · Cafe order API

주문 생성 7단계와 담당 계층

#처리담당파일
1요청 데이터 검증APIapps/cafe/api/serializers.py
2CreateOrderCommand DTO 생성API → businessbusiness/cafe/dto/order_command.py
3메뉴 조회Port → Repositoryinfrastructure/repositories/django_menu_repository.py
4판매 가능 + 수량 검증Policy · Rulebusiness/cafe/policies/order_acceptance_policy.py
5총금액 계산Calculatorbusiness/cafe/calculators/order_price_calculator.py
6주문 + 항목 트랜잭션 저장Repository · UoWinfrastructure/transactions/django_unit_of_work.py
7결과 반환 (201 Created)APIapps/cafe/api/views.py
Workflow & dependency injection

Workflow는 순서만, 조립은 container.py에서

business/cafe/workflows/create_order_workflow.py

def execute(self, command):
    menus = self.menu_repository.get_available_menus(
        menu_ids=[i.menu_id for i in command.items])
    self.acceptance_policy.validate(
        menus=menus, items=command.items)
    total = self.price_calculator.calculate(
        items=command.items, menus=menus)
    with self.unit_of_work:
        return self.order_repository.create_order(
            customer_id=command.customer_id,
            items=command.items, total_price=total)

apps/cafe/container.py

def create_order_workflow():
    return CreateOrderWorkflow(
        menu_repository=DjangoMenuRepository(),
        order_repository=DjangoOrderRepository(),
        acceptance_policy=OrderAcceptancePolicy(...),
        price_calculator=OrderPriceCalculator(),
        unit_of_work=DjangoUnitOfWork(),
    )
  • 테스트에서 FakeRepository 즉시 주입
  • DB·외부 API 구현체 교체 용이
Analogy · 콘센트와 어댑터

Port & Adapter = 벽 콘센트와 여행용 어댑터

벽 콘센트 = Portbusiness가 정한 규격 하나PaymentGateway여행용 어댑터Paystack AdapterPaystack여행용 어댑터Flutterwave AdapterFlutterwave여행용 어댑터Toss AdapterToss결제사 플러그 모양은 제각각새 결제사가 와도 어댑터 하나만 추가 → Workflow(벽 속 배선)는 0줄 수정
Case 2 · Billing with Port & Adapter

결제사를 바꿔도 Workflow는 0줄 수정

Port (business)

class PaymentGateway(Protocol):
    provider_code: str
    def confirm(self, command) -> PaymentResult: ...
    def get_payment(self, payment_id) -> PaymentResult: ...
    def cancel(self, command) -> RefundResult: ...
    def verify_webhook(self, raw_body, headers) -> bool: ...

Registry (조립)

class PaymentGatewayRegistry:
    def __init__(self, gateways):
        self._gateways = {
            g.provider_code: g for g in gateways}
    def get(self, provider_code):
        return self._gateways[provider_code]
Workflow결제사 이름 모름PortPaymentGatewayRegistryprovider_code로 선택toss/ Adapterpaystack/ Adapterflutterwave/ Adapter

각 Adapter 폴더: adapter · client · mapper · schemas · signature · exceptions

Analogy · 엘리베이터 버튼

두 번 눌러도 한 번만: 멱등성

엘리베이터 버튼▲1번 누름▲2번 누름▲3번 누름엘리베이터1번만 온다여러 번 눌러도 결과는 한 번 = 멱등성결제 버튼도 똑같아야 한다₦13,500 결제네트워크가 느려 2번 누름Idempotency-Key: abc-123같은 키 → 기존 결과돈은 1번만같은 키인데 금액이 다르면?409 Conflict — 처리 거부(실수 · 조작 방지)
Payment safety

돈이 오가는 곳의 5가지 안전장치

READYPENDINGPAIDFAILEDREFUNDED✗ FAILED → REFUNDED 금지
상태 전이READY → PENDING → PAID / FAILED
PAID → REFUNDED
금지: FAILED → REFUNDED
TX 분리TX1: PENDING 저장 → TX 밖: 결제사 호출 → TX2: 결과 + OutboxTimeout ≠ 즉시 실패
멱등성Idempotency-Key 필수. 같은 키 + 같은 요청 → 기존 결과다른 금액 → 409
웹훅Raw Body 서명 검증, event_id Unique과거 이벤트가 최신 상태 덮어쓰기 금지
Outbox결제 저장과 이벤트를 같은 TX에, 후속 작업은 Commit 후 비동기알림 장애 ≠ 결제 롤백
HANDS-ON 0810분짝 · 시뮬레이터

결제 버튼을 여러 번 눌러 보기

목표멱등성 키가 중복 결제를 어떻게 막는지 직접 확인한다
1
예측하기장부가 얼마가 될까?
2
버튼 누르기같은 키 · 다른 금액 · 새 키
3
응답 보기201 · 200 · 409
4
장부 확인실제로 나간 돈
규칙같은 키 + 같은 요청 → 기존 결과 · 같은 키 + 다른 금액 → 409 · 새 키 → 새 결제

결제 요청 보내기

서버 응답

—버튼을 눌러 보세요
실제로 나간 돈 ₦0
0/4
체크하면서
스스로 확인해 보세요
취창업 연결결제 · 핀테크(Paystack · Flutterwave · Moniepoint 등) 회사 면접에서 멱등성은 단골 질문입니다.
3-level test strategy

계층이 나뉘면 테스트도 나뉜다

업무 규칙은 DB 없이 Unit으로 빠르게, DB·결제사 연결은 위쪽 테스트로 확인합니다.

Contract결제사 Adapter 규격tests/contract/Integration실제 DB · 트랜잭션tests/integration/UnitDB 없이 business 규칙tests/unit/business/느림빠름 · 많이
🧪 Unit · tests/unit/business/DB 없이 순수 business를 밀리초 단위로수량·판매 가능·총액 · 결제 상태 전이 · 중복 결제
🔗 Integration · tests/integration/실제 Django 모델·트랜잭션·DB 제약주문+항목 원자적 저장 · 웹훅 1회 처리
📜 Contract · tests/contract/모든 결제사 Adapter가 같은 규격을 지키는가DTO 변환 · Timeout 분류 · 서명 검증
Day 3 추적표의 TEST-###를 이 세 폴더 중 하나에 배치하세요. 업무 규칙 테스트는 대부분 Unit입니다.
HANDS-ON 0910분짝 · 퀴즈

이 테스트는 피라미드 어느 층?

목표테스트마다 알맞은 종류를 골라 빠르고 믿을 수 있는 검증을 만든다
UnitDB 없이Rule · Policy · Calc · 상태 전이
Integration실제 DB저장 · 트랜잭션 · 제약
Contract결제사 규격Adapter 변환 · 서명 · Timeout
비율아래가 가장 많이Unit ≫ Integration > Contract
수량 21이면 거절된다
✓ Unit — 규칙만 확인 — DB 필요 없음
주문과 주문 항목이 함께 저장된다
✓ Integration — 실제 DB 트랜잭션 확인
Paystack Adapter가 Timeout을 올바르게 분류한다
✓ Contract — 결제사 Adapter 규격 확인
총액 = 단가 × 수량이 맞다
✓ Unit — 순수 계산
같은 웹훅이 와도 1번만 처리된다 (DB unique)
✓ Integration — DB 제약 조건 확인
Flutterwave 웹훅 서명을 검증한다
✓ Contract — 결제사별 서명 규격
정답 0 / 6
0/4
체크하면서
스스로 확인해 보세요
취창업 연결테스트 전략을 설명할 수 있으면 QA · 백엔드 직무 모두에서 한 단계 높은 평가를 받습니다.
AI development spec

AI 에이전트를 위한 12단계 순서 · 9대 금지

구현 순서

1규격 읽기2기존 코드 검색3DTO · 오류 코드4Rule · Calc5단위 테스트6Port 정의7Workflow8Model · DB9Repo · Adapter10API11container 조립12전체 테스트규칙(business)부터 → 바깥(API)은 나중에

절대 하지 않을 것

  • View에 복잡한 업무 로직
  • business에서 Django ORM 사용
  • 기존 Rule 확인 없이 복제
  • 결제사 원본 응답을 그대로 반환
  • 실패 테스트 없이 임시 조건문으로 버그 수정
  • 기존 Migration 임의 변경 · Secret Key 하드코딩
  • 요청 없는 대규모 리팩터링 · 실행 안 한 테스트 통과 보고
Wrap-up

폴더를 늘리는 게 아니라 변경의 영향을 가두는 것

이런 변경이 생기면여기만 바뀐다
API 스펙 변경apps/<domain>/api
업무 규칙 변경business/<domain>/rules · policies
금액 계산 공식 변경business/<domain>/calculators
DB 접근 방식 변경infrastructure/repositories
결제사 추가 · 변경infrastructure/payment_gateways/<provider>
  • View는 요청을 받고 Workflow를 호출한다
  • Workflow는 업무 처리 순서를 관리한다
  • Rule · Policy · Calculator는 순수 업무 로직
  • DB와 외부 시스템은 Port와 Adapter로 연결, business는 Django에 의존하지 않는다
P1 · 1
LECTURE NOTE

MVC Across Frameworks

같은 MVC, 프레임워크별 이름

어떤 프레임워크를 만나도 “라우터 → 요청 처리 → 업무 로직 → 데이터 → 표현” 위치만 찾으면 구조가 보입니다.

역할Django (DRF)Express · NestJSSpring BootLaravelRuby on Rails
Routerurls.pyroutes/ · @Controller() 경로@RequestMappingroutes/web.php · api.phpconfig/routes.rb
Controllerviews.py (APIView · ViewSet)controllers/@RestControllerapp/Http/Controllersapp/controllers
업무 로직 (확장)business/ (오늘의 구조)services/ · Provider@Serviceapp/Services · ActionsService Object
Model · 데이터models.py + ORMMongoose · Prisma · TypeORM@Entity + @Repository (JPA)Eloquent ModelActiveRecord
View · 표현Template / Serializer(JSON)템플릿 엔진 / res.json()Thymeleaf / JSONBlade / API ResourceERB / Jbuilder

Hands-on Lab Guide

내 프로젝트에 레이어드 구조 적용하기

Day 3에서 만든 명세(REQ · DATA · API)를 오늘 배운 계층에 배치합니다. 막히면 아래 프롬프트를 gstack과 함께 사용하세요.

단계할 일입력산출물통과 조건
1. MVC 흐름도대표 API 1개의 요청 → 응답 6단계 그리기Day 3 API-###MVC_FLOW.mdRouter·Controller·Model·View 위치가 표시됨
2. Django 시작venv · startproject · startapp · runserver—backend/ 기본 구조runserver 화면 확인, git 커밋
3. 폴더 설계config · apps · business · infrastructure · tests 생성도메인 목록ARCHITECTURE.md각 폴더 책임 1줄, business에 Django import 없음
4. 계층 배치REQ마다 Rule/Policy/Calculator/Workflow 지정TRACEABILITY.mdLAYER_MAP.md모든 REQ에 담당 파일 경로가 있음
5. 주문 API 설계7단계 흐름과 DTO · Port 정의API 명세ORDER_API_DESIGN.md요청·응답·오류 코드·상태 전이 포함
6. AI 규격12단계 순서 · 9대 금지 · 배치표오늘 슬라이드BACKEND_RULES.mdAI에게 그대로 줄 수 있는 문서
7. 검토gstack /plan-eng-review로 설계 검토3~6 산출물검토 결과 + DECISION_LOG지적별 채택/수정/반려 이유

① 계층 배치 요청

/plan-eng-review (Codex: gstack-plan-eng-review 스킬)

/plan-eng-review
TRACEABILITY.md 의 각 REQ를 Django 레이어드 아키텍처에 배치해 줘.
구조: config / apps / business / infrastructure / tests
- 각 REQ마다 Rule · Policy · Calculator · Workflow · Port · Repository · Adapter 중
  어디에 들어가는지와 파일 경로를 표로 제안
- business 계층에는 Django·DRF import 금지
- 판단이 애매한 REQ는 "사람 결정 필요"로 표시
아직 코드를 작성하지 마.

② BACKEND_RULES.md 초안

AI 개발 규격 문서 만들기

이 프로젝트의 백엔드 개발 규격 BACKEND_RULES.md 초안을 작성해 줘.
포함할 내용:
1. 5대 디렉터리와 각 책임
2. 의존성 방향: API → Workflow → Rule/Policy/Calculator → Port ← Adapter
3. 새 기능 구현 12단계 순서
4. AI가 절대 하지 말아야 할 9가지
5. 파일 배치 판단표 (코드 종류 → 작성 위치)
6. 테스트 3단계 (unit / integration / contract) 위치와 기준
내 프로젝트 도메인 이름: [예: cafe, billing]
파일은 내가 검토한 뒤 저장할게.

③ 기능 하나 구현 계약

다음 시간 구현 단계에서 사용

BACKEND_RULES.md 와 LAYER_MAP.md 를 먼저 읽어 줘.
이번 범위는 [REQ-___] 하나다.
12단계 순서를 따르되, 코드를 쓰기 전에
1) 생성·수정할 파일 경로 2) 정의할 DTO·Port 3) 작성할 단위 테스트
를 먼저 보고해 줘. 승인 후 구현하고,
실제로 실행한 테스트 결과만 보고해 줘.

④ 규칙 위반 리뷰

/review (Codex: gstack-review 스킬)

/review
현재 diff를 BACKEND_RULES.md 기준으로 검토해 줘.
특히 다음을 우선 확인:
- business/ 안의 django · rest_framework import
- View 안의 업무 규칙 · 금액 계산 · ORM 직접 호출
- 기존 Rule 중복 구현
- 결제사 원본 응답 노출, 하드코딩된 Secret
심각도 · 파일 · 줄 · 근거만 보고하고 수정하지 마.

Quick Check

파일 배치 퀴즈: 이 코드는 어디에?

판단 질문: “Django와 DB가 없어도 실행할 수 있는 업무 규칙인가?” Yes면 business/ 입니다.

0 / 8 정답

10-Day Course Navigation

상단 버튼을 클릭해 Day 1~10 학습 페이지로 이동할 수 있습니다.

Learning Workspace

백엔드 · MVC · Django 영상과 Day 5 AI 도우미

프레임워크 개요 → MVC → Django 기초 → 레이어드·클린 아키텍처 순서로 정리했습니다.

관련 YouTube 영상Day 5 추천 학습 자료
  • MVC 패턴
  • 1. MVC Explained in 4 MinutesModel · View · Controller 핵심 요약EN
  • 2. What is MVC? The Simplest Explanation You'll Ever See비유로 이해하는 MVCEN
  • 3. Learn MVC Pattern with ExpressJS and NodeJS다른 프레임워크(Express)에서의 MVCEN
  • 백엔드 프레임워크
  • 4. Backend Frameworks for Web Development: Which One Should You Learn?주요 백엔드 프레임워크 개요EN
  • 5. Every Backend Framework Ranked & Explained (FastAPI, Django, Node.js …)프레임워크별 특징 비교EN
  • Django · DRF
  • 6. Django(장고) 프레임워크 제대로 배우기 (입문) Part.1 Django BasicDjango 기본 구조와 동작KR
  • 7. 밑바닥부터 시작하는 파이썬 장고 (Python Django From Scratch)설치부터 따라 하는 입문KR
  • 8. What is MVT Architecture in Django and How it WorksDjango MTV(MVT)와 MVC 대응EN
  • 9. Getting Started With Django REST FrameworkDRF로 첫 API 만들기EN
  • 10. Django REST Framework Full Course - Beginner to ProDRF 전체 과정 (장편 · 복습용)EN
  • 레이어드 · 클린 아키텍처
  • 11. Where to Put Business Logic in Django업무 로직의 위치 — 오늘의 핵심 질문EN
  • 12. Django - service layers and "thin views" for business logicFat View에서 Thin View로EN
  • 13. Clean Architecture vs Django’s Pragmatic DesignDjango 기본 방식과 계층 분리의 장단점EN
  • 14. Service Layer Design Pattern Explained서비스(업무) 계층 패턴EN
  • 15. Hexagonal Architecture Explained in 10 MinutesPort & Adapter의 원리EN
  • 16. Ports and Adapters Architecture외부 시스템과 느슨하게 연결하기EN

영상은 YouTube 공개 영상을 임베드합니다. 게시자 설정에 따라 재생이 제한되면 YouTube에서 직접 열어 주세요.

Day 5 · Daily Feedback

오늘의 교육 만족도 조사

Day 5 수업을 마친 후 간단한 설문에 참여해 주세요. 응답은 다음 수업과 교육 운영을 개선하는 데 활용됩니다.

Open Day 5 Survey버튼 또는 QR 코드로 참여
Day 5 Daily Feedback Survey QR codeSCAN TO OPENNigeria AI Training · Day 5