Skip to content

07_VisualMap.md

Latest commit

 

History

History
96 lines (76 loc) · 2.74 KB

07_VisualMap.md

File metadata and controls

96 lines (76 loc) · 2.74 KB
Raw

코드-문서 시각 맵 (현재 기준)

코드 구조와 핵심 문서가 어디를 설명하는지 빠르게 연결해 보는 인덱스입니다.

1. 전체 구조

flowchart LR
    subgraph Runtime[Runtime]
        C[TestClient]
        S[TestServer]
        D[TestDBServer optional]
        E[ServerEngine]
    end

    subgraph Docs[Documents]
        O1[01_ProjectOverview]
        O2[02_Architecture]
        O3[03_Protocol]
        O4[04_API]
        O5[05_DevelopmentGuide]
        O6[06_SolutionGuide]
    end

    C --> S
    S --> D
    C --> E
    S --> E
    D --> E

    O1 -. scope .-> C
    O1 -. scope .-> S
    O2 -. design .-> E
    O3 -. packet spec .-> C
    O3 -. packet spec .-> S
    O4 -. interface .-> E
    O5 -. run/build .-> Runtime
    O6 -. solution map .-> Runtime
Loading

2. 런타임 패킷 경로

sequenceDiagram
    participant TC as TestClient
    participant TS as TestServer
    participant TDB as TestDBServer (optional)

    TC->>TS: SessionConnectReq
    TS-->>TC: SessionConnectRes

    loop Ping interval
        TC->>TS: PingReq(clientTime, sequence)
        TS-->>TC: PongRes(clientTime, serverTime, sequence)
    end

    opt DB server link enabled
        TS->>TDB: ServerPingReq / DBSavePingTimeReq
        TDB-->>TS: ServerPongRes / DBSavePingTimeRes
    end
Loading

3. 코드 디렉터리 매핑

Server/ServerEngine/
  Network/Core/          <- 엔진 인터페이스, 세션, 패킷
  Network/Platforms/     <- Windows/Linux/macOS 구현
  Concurrency/           <- KeyedDispatcher, TimerQueue, AsyncScope
  Database/              <- DB 추상화

Server/TestServer/
  src/TestServer.cpp     <- 클라이언트 수용 + 로컬 DBTaskQueue + (옵션) TestDBServer 링크

Server/DBServer/
  src/TestDBServer.cpp   <- 서버 간 패킷 수신/처리

Client/TestClient/
  src/TestClient.cpp     <- 접속, Ping/Pong, RTT 통계

4. 문서-코드 매핑 표

문서 기준 코드
Docs/01_ProjectOverview.md Server/, Client/, Docs/
Docs/02_Architecture.md Server/ServerEngine/, Server/TestServer/, Server/DBServer/
Docs/03_Protocol.md Network/Core/PacketDefine.h, Network/Core/ServerPacketDefine.h
Docs/04_API.md Network/Core/NetworkEngine.h, 각 실행파일 main.cpp
Docs/05_DevelopmentGuide.md run_*.ps1, *.vcxproj, 테스트 스크립트
Docs/06_SolutionGuide.md NetworkModuleTest.sln 및 솔루션 프로젝트

5. 주의 사항

  • 기본 포트는 플랫폼 define 기반입니다. Windows: Server 19010, DB 18002; Linux/macOS: Server 9000, DB 8001.
  • 검증 페이로드가 포함된 PingPong 포맷은 ServerEngine/Tests/Protocols의 테스트 경로이며, 기본 운영 패킷과 분리됩니다.