From c1d15d6bd55c5e1fe1c7325946fb3b64b8c66a0b Mon Sep 17 00:00:00 2001
From: bumpsoo <bumpsoo063@gmail.com>
Date: Tue, 17 Feb 2026 15:06:38 +0000
Subject: [PATCH] doc: update README

---
 README.md | 21 +++++++++++++++++++++
 1 file changed, 21 insertions(+)

diff --git a/README.md b/README.md
index 8ce4581..5ccc094 100644
--- a/README.md
+++ b/README.md
@@ -44,6 +44,27 @@ cmake --build build
 - DatabaseManager: 비동기 데이터베이스 작업 및 락 제어
 - Packet: Protobuf 기반 직렬화 프로토콜 (proto/Protocol.proto)
 
+```mermaid
+flowchart TD
+    Client("Python GUI Client") <-->|"Protobuf (Packet)"| NetworkService
+
+    subgraph Server ["C++20 Sword Game Server"]
+        NetworkService["NetworkService(io_context 이벤트 루프)"]
+        SessionManager["SessionManager(글로벌 세션 관리 및 브로드캐스팅)"]
+        Session["Session(개별 클라이언트 비동기 송수신)"]
+        PacketHandler["PacketHandler(패킷 ID별 로직 디스패칭)"]
+        DatabaseManager["DatabaseManager(비동기 DB 작업 및 락 제어)"]
+
+        NetworkService -->|"Connection Accept"| Session
+        SessionManager -.->|"Manage & Broadcast"| Session
+        Session <-->|"Dispatch / Response"| PacketHandler
+        PacketHandler <-->|"Request DB Operation"| DatabaseManager
+        PacketHandler -->|"Broadcast Request"| SessionManager
+    end
+
+    DatabaseManager <-->|"SQL / 비동기 통신"| MySQL[(MySQL DB)]
+```
+
 ## Python GUI 클라이언트
 
 [README.md](https://git.bumpsoo.dev/bumpsoo/sword_game/src/branch/main/client/README.md)