IRC (Internet Relay Chat Protocol) 란?

                           [ Server 15 ]  [ Server 13 ] [ Server 14]
                                 /                \         /
                                /                  \       /
        [ Server 11 ] ------ [ Server 1 ]       [ Server 12]
                              /        \          /
                             /          \        /
                  [ Server 2 ]          [ Server 3 ]
                    /       \                      \
                   /         \                      \
           [ Server 4 ]    [ Server 5 ]         [ Server 6 ]
            /    |    \                           /
           /     |     \                         /
          /      |      \____                   /
         /       |           \                 /
 [ Server 7 ] [ Server 8 ] [ Server 9 ]   [ Server 10 ]

                                  :
                               [ etc. ]
                                  :

                 [ Fig. 1. Format of IRC server network ]

                          1--\
                              A        D---4
                          2--/ \      /
                                B----C
                               /      \
                              3        E

   Servers: A, B, C, D, E         Clients: 1, 2, 3, 4

                    [ Fig. 2. Sample small IRC network ]

[':' <prefix> <SPACE>] <command> [<SPACE> <parameters>] <CR-LF>

JOIN #<channel>,#<channel> <CR-LF>

:<nickname>!<client>@<host address> JOIN #<channel>{, #<channel>} <CR-LF>

:foo!foo@foo.tmi.twitch.tv JOIN #bar <CR-LF>

PART #<channel>,#<channel> <CR-LF>

:<nickname>!<client>@<host address> PART #<channel>{,<channel>} <CR-LF>

PRIVMSG <receiver>{, <receiver>} <text to be sent> <CR-LF>

ex) PRIVMSG #<channel name> :This is a sample message <CR-LF>

:Angel PRIVMSG Wiz :Hello are you receiving this message ?<CR-LF>

# 채널에 메시지 전송
PRIVMSG #programming :안녕하세요! 새로운 멤버입니다.<CR-LF>

# 개인에게 메시지 전송
PRIVMSG nickname :안녕하세요, 개인 메시지입니다.<CR-LF>

# 여러 대상에게 동시 전송
PRIVMSG #room1,#room2 :여러 채널에 보내는 메시지입니다.<CR-LF>

# 이모티콘이나 특수문자 포함
PRIVMSG #programming :코드 리뷰 부탁드립니다! :)<CR-LF>

# 긴 메시지 (최대 510바이트까지)
PRIVMSG #programming :이것은 매우 긴 메시지입니다... (중략) ...끝<CR-LF>

MODE #channel +o nickname  // 운영자 권한 부여
MODE #channel -o nickname  // 운영자 권한 제거

{
  "type": "CREATE_CHANNEL",
  "sender": {
    "nickname": "user1",
    "role": "user" // 채널 생성 시 자동으로 operator로 승격됨
  },
  "channel": {
    "title": "기아 vs 삼성 승부 예측", // 사용자가 지정한 방 제목
    "options": {
      "option1": "기아",
      "option2": "삼성"
    },
    "settings": {
      "duration": 120, // 진행 시간 (초 단위)
      "minBet": 100, // 최소 베팅 금액
      "maxParticipants": 300 // 최대 참여 인원
    }
  },
  "timestamp": "2024-11-10T10:00:00Z"
}

{
  "status": 200,
  "data": {
    "channel": {
      "id": "12345",
      "name": "#betting_room_12345",
      "title": "기아 vs 삼성 승부 예측",
      "creator": {
        "nickname": "host123",
        "role": "operator"
      },
      "options": {
        "option1": {
          "name": "기아",
          "currentBets": 0,
          "participants": 0
        },
        "option2": {
          "name": "삼성",
          "currentBets": 0,
          "participants": 0
        }
      },
      "status": "waiting", // waiting, active, finished
      "settings": {
        "minBet": 100, // 최소 베팅 금액
        "duration": 120, // 초 단위
        "maxParticipants": 300 // 최대 참여 인원
      },
      "metadata": {
        "createdAt": "2024-11-10T10:00:00Z",
        "startAt": null,
        "endAt": null
      },
      "urls": {
        "websocket": "ws://example.com/ws/betting_room_12345",
        "invite": "http://example.com/room/12345"
      }
    },
    "message": "OK"
  }
}

{
  "type": "PRIVMSG",
  "sender": {
    "nickname": "user1",
    "role": "user"
  },
  "channel": "#betting_1234", // 단순 채널명으로 수정
  "content": "안녕하세요!", // message 대신 content로 통일
  "timestamp": "2024-11-10T10:00:00Z"
}

{
  "status": 200,
  "data": {
    "type": "ACK",
    "messageId": "msg_123456", // 메시지 추적을 위한 고유 ID
    "timestamp": "2024-11-10T10:00:00Z",
    "message": "OK"
  }
}

// Request
{
  "type": "KICK",
  "sender": {
    "nickname": "operator1",
    "role": "operator" // KICK 명령어는 operator만 사용 가능
  },
  "channel": "#betting_1234",
  "content": {
    "targetUser": "user1", // 추방할 사용자
    "reason": "부적절한 채팅" // 추방 사유 (선택적)
  },
  "timestamp": "2024-11-10T10:00:00Z"
}

// Success Response
{
  "status": 200,
  "data": {
    "type": "KICK_ACK",
    "channel": "#betting_1234",
    "targetUser": "user1",
    "message": "사용자가 성공적으로 추방되었습니다",
    "timestamp": "2024-11-10T10:00:00Z"
  }
}

{
    "status": 403,
    "data": {
        "type": "ERROR",
        "code": "INSUFFICIENT_PERMISSIONS",
        "message": "해당 작업을 수행할 권한이 없습니다",
        "timestamp": "2024-11-10T10:00:00Z"
    }
}

{
    "status": 404,
    "data": {
        "type": "ERROR",
        "code": "USER_NOT_FOUND",
        "message": "해당 사용자를 찾을 수 없습니다",
        "timestamp": "2024-11-10T10:00:00Z"
    }
}

// 1. 채널 종료 알림 (WALLOPS)
{
    "type": "WALLOPS",
    "sender": {
        "nickname": "operator1",
        "role": "operator"
    },
    "channel": "#betting_1234",
    "content": "이 채널은 1분 후에 종료됩니다. 모든 베팅이 정산되며 결과 페이지로 이동됩니다.",
    "timestamp": "2024-11-10T10:00:00Z"
}

// 2. 전체 참여자 추방 (KICK)
{
    "type": "KICK_ALL",
    "sender": {
        "nickname": "operator1",
        "role": "operator"
    },
    "channel": "#betting_1234",
    "content": {
        "reason": "채널 종료",
        "redirectUrl": "/result/betting_1234"  // 결과 페이지 URL
    },
    "timestamp": "2024-11-10T10:00:00Z"
}

// 3. 채널 종료 (CLOSE)
{
    "type": "CLOSE",
    "sender": {
        "nickname": "operator1",
        "role": "operator"
    },
    "channel": "#betting_1234",
    "content": {
        "reason": "베팅 종료",
        "betResult": {
            "winningOption": "option1",
            "totalParticipants": 150,
            "totalBetAmount": 15000
        }
    },
    "timestamp": "2024-11-10T10:00:00Z"
}

// Success Response
{
    "status": 200,
    "data": {
        "type": "CLOSE_ACK",
        "channel": "#betting_1234",
        "message": "채널이 성공적으로 종료되었습니다",
        "timestamp": "2024-11-10T10:00:00Z"
    }
}

// Error Response
{
    "status": 403,
    "data": {
        "type": "ERROR",
        "code": "INSUFFICIENT_PERMISSIONS",
        "message": "채널을 종료할 권한이 없습니다",
        "timestamp": "2024-11-10T10:00:00Z"
    }
}

{
  "type": "SYSTEM",
  "channel": "#betting_1234",
  "content": "채널이 종료되었습니다. 결과 페이지로 이동합니다.",
  "redirectUrl": "/result/betting_1234",
  "timestamp": "2024-11-10T10:00:00Z"
}