Skip to content

Commit c7e8440

Browse files
committed
Add 'What is a Gateway Server?' foundational explanation to Chapter 2
1 parent 72d1f3b commit c7e8440

1 file changed

Lines changed: 20 additions & 0 deletions

File tree

CLONE_MANUAL_DETAILED.md

Lines changed: 20 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -576,6 +576,26 @@ npx tsc --init
576576
577577
Gateway는 단순한 서버가 아닙니다. 모든 데이터(메시지, 명령)가 지나가는 **고속도로이자, 시스템의 중추 신경망**입니다.
578578
579+
### 🛑 도대체 "Gateway Server"가 뭔가요? (What is a Gateway Server?)
580+
581+
"그냥 서버라고 하면 되지, 왜 게이트웨이라는 어려운 말을 쓰나요?"
582+
583+
#### 1. 정의 (Definition)
584+
게이트웨이(Gateway)는 직역하면 **"관문"** 입니다. 서로 다른 네트워크나 시스템이 만나는 '통로' 역할을 하는 특수 서버를 말합니다. 우리 프로젝트에서 Gateway는 **"외부 메신저(WhatsApp 등)와 내부 AI 에이전트 사이의 중계실"** 입니다.
585+
586+
#### 2. 은유 (Metaphor): "인천 공항의 입출국 심사대"
587+
* **외부 세상**: 미국, 중국, 일본 등 언어와 규격이 다른 여러 나라 (WhatsApp, Slack, Telegram...)
588+
* **공항 (Gateway)**: 모든 손님은 일단 공항으로 들어옵니다. 여기서 여권을 검사하고, 공통된 서류(표준 데이터)를 작성합니다.
589+
* **내부 도시 (AI Brain)**: 공항을 통과한 손님은 이제 '대한민국 표준 법규'를 따릅니다. AI는 손님이 어느 나라에서 왔든 상관없이, 공항에서 처리해준 **표준 양식**만 보고 대화하면 됩니다.
590+
591+
#### 3. 핵심 역할 (Key Roles)
592+
1. **언어 통일 (Normalization)**: WhatsApp의 복잡한 데이터를 AI가 알아듣기 쉬운 깔끔한 텍스트로 바꿔줍니다.
593+
2. **보안 검문 (Security)**: 이상한 명령이나 해킹 시도가 없는지 입구에서 컷(Cut)합니다.
594+
3. **교통 정리 (Routing)**: 질문은 AI에게 보내고, 설정 변경은 데이터베이스로 보내는 등 업무를 배분합니다.
595+
596+
---
597+
598+
579599
### 2-0. [심층 분석] 왜 굳이 "Gateway" 구조를 선택했는가? (Developer's Intent)
580600
581601
개발자가 단순히 API 서버를 만들지 않고 `Gateway` 패턴을 도입한 데에는 명확한 **건축학적 의도(Architectural Intent)** 가 있습니다.

0 commit comments

Comments
 (0)