프로젝트 소개

• 온라인 오목 게임 서버를 제작한 프로젝트입니다.
• 3개의 API 서버(Hive Auth 서버, Game API 서버, Matching 서버) 및 1개의 소켓 서버(오목 서버)로 구성되어 있습니다.
• 오목 서버의 경우 Scale Out이 가능하도록 설계하였습니다.

---

프로젝트 개요

• 개발 기간 : 2024.04. - 2024.06. (2개월)
• 참여 인원 : 1인
• 사용 언어 : C#
• 사용 도구 : ASP.NET Core 8, MySQL, Redis, AWS

---

전체 서버 구조

---

시퀀스 다이어그램

유저의 로그인

sequenceDiagram
    actor User
    participant GameServer
    participant HiveServer
    participant GameDB

    User->>+HiveServer: email과 pw을 통해 로그인 요청
    HiveServer->>HiveServer: 토큰을 생성하여 Redis에 저장
    HiveServer-->>-User: 토큰 전달
    User->>+GameServer: email과 토큰을 통해 로그인 요청
    GameServer->>+HiveServer: email과 토큰의 유효성 검증 요청
    HiveServer->>HiveServer: Redis에 검증 요청
    HiveServer-->>-GameServer: 유효성 검증 결과
    alt 검증 실패
        GameServer-->>User: 로그인 실패 응답
    end
    GameServer->>GameServer: 토큰을 Redis에 저장
    alt 최초 로그인
        GameServer->>+GameDB: 유저의 인게임 데이터 생성 요청
    end
    GameServer-->>-User: 로그인 성공 응답

Loading

새로운 유저의 계정 생성

sequenceDiagram
    actor User
    participant HiveServer
    participant HiveDB

    User->>+HiveServer: email과 pw를 통해 가입 요청
    HiveServer->>+HiveDB: email을 통해 데이터 조회
    HiveDB-->>-HiveServer: 데이터 조회 결과
    alt 이미 계정 존재
        HiveServer-->>User: 계정 생성 실패 응답
    end
    HiveServer->>+HiveDB: 유저의 계정 데이터 생성 요청
    HiveServer-->>-User: 계정 생성 성공 응답

Loading

HTTP 요청 시마다 유저 인증

sequenceDiagram
    actor User
    participant GameServer

    User->>+GameServer: HTTP 요청 (email 및 토큰 포함)
    GameServer->>GameServer: Redis에 검증 요청
    alt 검증 성공
        GameServer-->>User: HTTP 요청 처리 후 응답
    else 검증 실패
        GameServer-->>-User: 유저 인증 실패 응답
    end

Loading

유저 매칭

sequenceDiagram
    actor User
    participant GameServer
    participant MatchingServer
    participant OmokServer

    loop Every Second && Not Matched
        User-->>+GameServer: email을 통해 매칭 요청
        GameServer-->>+MatchingServer: email 및 매칭 요청 전달
        alt 매칭 완료 정보 존재
            MatchingServer-->>-GameServer: 오목서버 주소 및 방 번호 전달
            GameServer-->>-User: 오목서버 주소 및 방 번호 응답
        else else
            opt 매칭 대기 유저수 > 2
                MatchingServer->>MatchingServer: redis request list에 요청 push
                
            end
        end
    end

    loop Every Second
        OmokServer->>OmokServer: redis request list 확인
        opt request가 존재
            OmokServer->>OmokServer: 해당 request를 pop
            OmokServer->>OmokServer: redis complete list에 자신의 서버 주소 및 빈 방 정보 응답 push
        end
    end

    loop Every Second
        MatchingServer->>MatchingServer: redis complete list 확인
        opt response가 존재
            MatchingServer->>MatchingServer: 해당 response를 pop
            MatchingServer->>MatchingServer: 매칭 완료 정보 저장
        end
    end    

Loading

---

DB 스키마

유저의 계정 데이터

erDiagram
    user_account_data{
        INT uid PK
        VARCHAR(50) email UK
        VARCHAR(100) password
    }

Loading

유저의 인게임 데이터

erDiagram
    user_game_data{
        INT uid PK
        VARCHAR(50) email UK
        INT level
        INT exp
        INT win_count
        INT lose_count
    }

Loading

---

TODO-LIST

• 계정 기능

기능	완료 여부
유저 등록	✅
로그인	✅
유저 인증	✅
유저 데이터 로드	✅
게임 데이터 로드	✅
로그아웃	✅

• 게임 기능

기능	완료 여부
매칭	✅
방 입장	✅
채팅	✅
게임 준비	✅
돌 두기	✅
타임아웃	✅
heart-beat	✅
방 상태체크	✅
게임 종료	✅
방 나가기	✅
승패 기록 저장	✅

• 부가 기능

기능	완료 여부
출석 체크	⬜
우편함	⬜
친구	⬜

---

ASP.NET Core 학습 정리 문서

• ASP.NET Core Docs