Skip to content

Commit 59699f5

Browse files
committed
docs: add comprehensive WebSocket explanation with comparison table
1 parent ceec17e commit 59699f5

1 file changed

Lines changed: 24 additions & 0 deletions

File tree

CLONE_MANUAL_DETAILED.md

Lines changed: 24 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1600,6 +1600,30 @@ export async function createHttpServer(params: any) {
16001600
16011601
HTTP가 "똑똑, 거기 누구 있나요?" 하고 묻는 **단발성 대화**라면, WebSocket은 전화선을 뽑지 않고 계속 들고 있는 **실시간 통화**입니다. 이것은 봇의 **"신경망(Nervous System)"** 이자 **"귀(Ears)"** 입니다.
16021602
1603+
> [!NOTE]
1604+
> **🔌 WebSocket이란?**
1605+
>
1606+
> **WebSocket**은 클라이언트(브라우저)와 서버 간의 **양방향 실시간 통신 채널**을 제공하는 프로토콜입니다.
1607+
>
1608+
> #### HTTP vs WebSocket 비교:
1609+
>
1610+
> | 특징 | HTTP | WebSocket |
1611+
> |------|------|-----------|
1612+
> | **연결 방식** | 요청-응답 후 연결 종료 | 한 번 연결하면 계속 유지 |
1613+
> | **통신 방향** | 단방향 (클라이언트 → 서버) | 양방향 (서버 ↔ 클라이언트) |
1614+
> | **실시간성** | 없음 (폴링 필요) | 즉각적 (푸시 가능) |
1615+
> | **오버헤드** | 매 요청마다 헤더 전송 | 최초 1회만 핸드셰이크 |
1616+
> | **비유** | 우편 배달 (편지 보내고 답장 기다림) | 전화 통화 (계속 연결 상태) |
1617+
>
1618+
> #### 실제 사용 사례:
1619+
> - **채팅 앱**: 메시지가 오면 즉시 화면에 표시
1620+
> - **실시간 대시보드**: 서버 상태, 로그가 실시간으로 업데이트
1621+
> - **게임**: 플레이어 위치, 점수 등을 지연 없이 동기화
1622+
> - **주식 거래**: 실시간 시세 변동 알림
1623+
>
1624+
> #### 왜 Gateway에 필요한가?
1625+
> 관리자가 브라우저 대시보드에서 봇의 상태를 **실시간으로 모니터링**하고, 명령을 즉시 전달하기 위해 필수적입니다. HTTP만으로는 "1초마다 새로고침"하는 비효율적인 방법밖에 없습니다.
1626+
16031627
> [!NOTE]
16041628
> **🛠️ VS Code 실전 조립 절차**
16051629
> 1. **파일 생성**: `src/gateway/server-ws-runtime.ts` 파일을 생성합니다.

0 commit comments

Comments
 (0)