[BE] 사용자는 준비완료 상태를 나타낼 수 있다. (#112)

* feat: player-data DTO 추가

* feat: 준비 완료, 강퇴 기능 추가

* test: 준비 완료, 강퇴 테스트

* docs: swagger 정리

be/gameServer/src/app.module.ts

@@ -2,6 +2,7 @@ import { Module } from '@nestjs/common';
 import { ConfigModule } from '@nestjs/config';
 import appConfig from './config/app.config';
 import { RoomsModule } from './modules/rooms/rooms.module';
+import { GamesModule } from './modules/games/games.module';
 
 @Module({
   imports: [
@@ -10,6 +11,7 @@ import { RoomsModule } from './modules/rooms/rooms.module';
       load: [appConfig],
     }),
     RoomsModule,
+    GamesModule,
   ],
 })
 export class AppModule {}

be/gameServer/src/modules/games/games.gateway.ts

@@ -0,0 +1,23 @@
+import { WebSocketGateway, WebSocketServer } from '@nestjs/websockets';
+import { Server } from 'socket.io';
+import { RedisService } from '../../redis/redis.service';
+import { Logger, UseFilters } from '@nestjs/common';
+import { WsExceptionsFilter } from '../../common/filters/ws-exceptions.filter';
+
+@WebSocketGateway({
+  namespace: '/games',
+  cors: {
+    origin: '*',
+    methods: ['GET', 'POST'],
+    credentials: true,
+  },
+})
+@UseFilters(WsExceptionsFilter)
+export class GamesGateway {
+  private readonly logger = new Logger(GamesGateway.name);
+
+  @WebSocketServer()
+  server: Server;
+
+  constructor(private readonly redisService: RedisService) {}
+}

be/gameServer/src/modules/games/games.module.ts

@@ -0,0 +1,10 @@
+import { Module } from '@nestjs/common';
+import { RedisModule } from '../../redis/redis.module';
+import { GamesGateway } from './games.gateway';
+
+@Module({
+  imports: [RedisModule],
+  providers: [GamesGateway],
+  controllers: [],
+})
+export class GamesModule {}

be/gameServer/src/modules/games/games.websocket.emit.controller.ts

@@ -0,0 +1,6 @@
+import { Controller } from '@nestjs/common';
+import { ApiTags } from '@nestjs/swagger';
+
+@ApiTags('Games (WebSocket: 서버에서 발행하는 이벤트)')
+@Controller('games')
+export class RoomsWebSocketEmitController {}

be/gameServer/src/modules/games/games.websocket.on.controller.ts

@@ -0,0 +1,6 @@
+import { Controller } from '@nestjs/common';
+import { ApiTags } from '@nestjs/swagger';
+
+@ApiTags('Games (WebSocket: 서버에서 수신하는 이벤트)')
+@Controller('games')
+export class RoomsWebSocketOnController {}

be/gameServer/src/modules/players/dto/player-data.dto.ts

@@ -0,0 +1,15 @@
+import { ApiProperty } from '@nestjs/swagger';
+
+export class PlayerDataDto {
+  @ApiProperty({
+    example: 'playerNickname123',
+    description: '플레이어의 닉네임',
+  })
+  playerNickname: string;
+
+  @ApiProperty({
+    example: true,
+    description: '플레이어의 준비 상태 (true: 준비 완료, false: 대기 중)',
+  })
+  isReady: boolean;
+}

be/gameServer/src/modules/rooms/dto/room-data.dto.ts

@@ -1,4 +1,5 @@
 import { ApiProperty } from '@nestjs/swagger';
+import { PlayerDataDto } from '../../players/dto/player-data.dto';
 
 export class RoomDataDto {
   @ApiProperty({
@@ -20,10 +21,20 @@ export class RoomDataDto {
   hostNickname: string;
 
   @ApiProperty({
-    example: ['hostNickname123'],
-    description: '현재 방에 참여한 플레이어 목록',
+    type: [PlayerDataDto],
+    example: [
+      {
+        nickname: 'hostNickname123',
+        ready: true,
+      },
+      {
+        nickname: 'player1',
+        ready: false,
+      },
+    ],
+    description: '현재 방에 참여한 플레이어 목록과 준비 상태',
   })
-  players: string[];
+  players: PlayerDataDto[];
 
   @ApiProperty({
     example: 'waiting',

be/gameServer/src/modules/rooms/room-utils.ts

@@ -1,4 +1,5 @@
 import { RoomDataDto } from './dto/room-data.dto';
+import { PlayerDataDto } from '../players/dto/player-data.dto';
 
 export const MAX_PLAYERS = 4;
 
@@ -10,16 +11,20 @@ export const isNicknameTaken = (
   roomData: RoomDataDto,
   playerNickname: string,
 ): boolean => {
-  return roomData.players.includes(playerNickname);
+  return roomData.players.some(
+    (player: PlayerDataDto) => player.playerNickname === playerNickname,
+  );
 };
 
 export const removePlayerFromRoom = (
   roomData: RoomDataDto,
   nickname: string,
 ): void => {
-  roomData.players = roomData.players.filter((player) => player !== nickname);
+  roomData.players = roomData.players.filter(
+    (player: PlayerDataDto) => player.playerNickname !== nickname,
+  );
 };
 
 export const changeRoomHost = (roomData: RoomDataDto): void => {
-  roomData.hostNickname = roomData.players[0];
+  roomData.hostNickname = roomData.players[0].playerNickname;
 };