From b89b01e5caabc633b31713836b7fc92922b9dc27 Mon Sep 17 00:00:00 2001
From: hyein Heo <128613248+hye-inA@users.noreply.github.com>
Date: Mon, 26 Jan 2026 00:41:06 +0900
Subject: [PATCH 1/2] =?UTF-8?q?feature=20:=20Cognito=20Authorizer(?=
 =?UTF-8?q?=ED=86=A0=ED=81=B0)=EC=97=90=EC=84=9C=20=EB=8B=89=EB=84=A4?=
 =?UTF-8?q?=EC=9E=84=EC=9D=84=20=EC=B6=94=EC=B6=9C=20+=20DB=EC=97=90=20?=
 =?UTF-8?q?=EC=A0=80=EC=9E=A5=20(#543)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

* test: BadgeType enum 단위 테스트 추가

* test: BadgeKey 상수 단위 테스트 추가

* test: WordStatus enum 단위 테스트 추가

* test: TestType enum 단위 테스트 추가

* test: VocabularyConfig 단위 테스트 추가

* test: VocabKey 상수 단위 테스트 추가

* test: VocabularyErrorCode 단위 테스트 추가

* test: VocabularyException 단위 테스트 추가

* test: SpacedRepetitionContext 단위 테스트 추가

* test: GrammarLevel enum 단위 테스트 추가

* test: GrammarConfig 단위 테스트 추가

* test: GrammarErrorCode 단위 테스트 추가

* test: GrammarException 단위 테스트 추가

* test: GameStatus enum 단위 테스트 추가

* test: GameConfig 단위 테스트 추가

* test: ChattingErrorCode 단위 테스트 추가

* test: ChattingException 단위 테스트 추가

* fix: OPIc FeedbackResponse.java 문법 오류 수정

* style: AwsClients 코드 포맷팅

* style: EnvConfig 코드 포맷팅

* style: RoomTokenConfig 코드 포맷팅

* style: WebSocketConfig 코드 포맷팅

* style: JsonUtil 코드 포맷팅

* style: GameConfig 코드 포맷팅

* style: GrammarConfig 코드 포맷팅

* style: GrammarKey 코드 포맷팅

* style: GrammarErrorCode 코드 포맷팅

* style: GrammarException 코드 포맷팅

* style: BedrockGrammarCheckFactory 코드 포맷팅

* style: GrammarConversationService 코드 포맷팅

* style: FeedbackResponse 코드 포맷팅

* style: SessionReportResponse 코드 포맷팅

* style: SpeakingError 코드 포맷팅

* style: SpeakingErrorType 코드 포맷팅

* style: OPIcException 코드 포맷팅

* style: OPIcAnswer 코드 포맷팅

* style: OPIcQuestion 코드 포맷팅

* style: OPIcSession 코드 포맷팅

* style: OPIcRepository 코드 포맷팅

* style: FeedbackService 코드 포맷팅

* style: TranscribeProxyService 코드 포맷팅

* style: VocabularyConfig 코드 포맷팅

* style: DailyStudyCommandService 코드 포맷팅

* style: TestCommandService 코드 포맷팅

* style: TestService 코드 포맷팅

* style: CommonErrorCodeSpec 코드 포맷팅

* style: JsonUtilSpec 코드 포맷팅

* style: BadgeTypeSpec 코드 포맷팅

* style: ChattingErrorCodeSpec 코드 포맷팅

* style: GrammarLevelSpec 코드 포맷팅

* style: GrammarErrorCodeSpec 코드 포맷팅

* style: VocabularyErrorCodeSpec 코드 포맷팅

* feature : OPIc 세션관리 + 답변 처리 파이프라인 구현  (#413)

* feat : OPIc 질문 & 세션 관련 dto 생성

* refactor : @DynamoDbBean 주석 추가

* feat : 주제 + 소주제 + 레벨로 오픽 질문 조회 추가

* feat : OPIc 세션, 질문, 답변 종합 handler 구현

* feat : 오픽 주제, 소주제별 seed 데이터 추가

* refactor : Transcribe API KEY 환경변수명 수정

* refactor : Bedrock에 사용하는 클로드 모델 변경

* refactor : S3 Key 대신 Proxy에서 요청하는 Base64 값으로 변환

* feat: GAME_START, ROUND_END 메시지에 serverTime 추가

- broadcastGameStart(): serverTime, roundDuration 필드 추가
- broadcastRoundEnd(): serverTime, roundStartTime, roundDuration 필드 추가
- GameService.endRound(): data에 roundStartTime, roundDuration 포함
- 타이머 동기화 버그 수정을 위한 서버 시간 제공

* feat: WebSocketMessageHelper 유틸리티 클래스 추가

- domain 필드 포함 메시지 생성 헬퍼
- DOMAIN_CHAT, DOMAIN_GAME 상수 정의
- buildChatMessage(), buildGameMessage() 메서드

* feat: 모든 WebSocket 메시지에 domain 필드 추가

- ScoreUpdateMessage에 domain 필드 추가
- broadcastGameStart에 domain:"game" 추가
- broadcastRoundEnd에 domain:"game" 추가
- broadcastCorrectAnswerMessage에 domain:"game" 추가
- handleCommandResult 시스템 메시지에 domain:"game" 추가
- handleRegularMessage 채팅 메시지에 domain:"chat" 추가

Closes #426, #427

* feat: GameSession 모델 클래스 생성

- DynamoDB Enhanced Client 어노테이션 적용
- GSI1: roomId로 활성 게임 세션 조회 가능
- 게임 상태 관리용 헬퍼 메서드 포함

Closes #428

* feat: GameSessionRepository 구현

- 기본 CRUD (save, findById, delete)
- roomId로 활성/전체 게임 세션 조회
- 상태, 라운드, 점수 업데이트 메서드
- 정답자 추가, 힌트 사용, 게임 종료 처리

Closes #429

* refactor: ChatRoom에서 게임 필드 분리

- 게임 관련 필드 제거 (gameStatus, currentRound 등)
- activeGameSessionId 필드 추가
- 게임 상태는 GameSession으로 분리됨

Note: 의존 코드 수정은 #431에서 진행

Closes #430

* refactor: GameSession 기반으로 전체 게임 로직 리팩토링

- GameService: ChatRoom 대신 GameSession 사용
- GameStatsService: GameSession 매개변수로 변경
- CommandService: GameSession 기반 점수 조회
- GameHandler: GameSession 기반 REST API
- WebSocketMessageHandler: GameSession 기반 브로드캐스트
- GameStatusResponse, ScoreboardResponse: GameSession 매개변수

Closes #431

* feat: GameSessionHandler Lambda 및 게임 세션 API 구현

- POST /rooms/{roomId}/games - 게임 세션 생성
- GET /games/{gameSessionId} - 게임 상태 조회 (재접속용)
- POST /games/{gameSessionId}/start - 게임 시작
- POST /games/{gameSessionId}/stop - 게임 종료

모든 응답에 serverTime 포함 (타이머 동기화)
출제자에게만 currentWord 포함

Closes #432, #433

* feat: 게임 시작 7분 후 자동 종료 기능 구현

- GameConfig에 gameTimeLimit() 메서드 추가 (기본값: 420초)
- GameSchedulerClient 유틸리티 클래스 생성 (EventBridge Scheduler 연동)
- GameService에 스케줄 생성/취소 로직 추가
- GameAutoCloseHandler Lambda 함수 생성
- template.yaml에 Lambda, IAM Role, Schedule Group 추가

Closes #417

* fix : 메모리 증가 및 Lambda 응답 제한 시간 Cognito 트리거 제한시간과 동일하게 수정 (#439)

* feat: 캐치마인드 게임 방 분리 기능 구현 (#455)

- Room 타입 분리 (CHAT/GAME)
  - RoomType, RoomStatus enum 추가
  - ChatRoom 모델에 type, gameType, gameSettings, status, hostId 필드 추가
  - GameSettings 모델 추가

- 방 생성/조회 API 수정
  - CreateRoomRequest에 type, gameType, gameSettings 필드 추가
  - 방 목록 조회 시 type, gameType, status 필터 지원

- 게임 시작 조건 검증
  - GAME 타입 방에서만 게임 시작 가능 (GAME_007 에러)

- 게임 재시작 API 구현 (#452)
  - POST /rooms/{roomId}/game/restart 엔드포인트 추가
  - 방장만 재시작 가능 (GAME_009 에러)
  - 게임 진행 중 재시작 불가 (GAME_008 에러)

- 방장 변경 로직 구현 (#453)
  - 방장 퇴장 시 다음 멤버에게 자동 이전
  - 모든 멤버 퇴장 시 방 자동 삭제

- WebSocket 메시지 타입 추가 (#454)
  - ROOM_STATUS_CHANGE, HOST_CHANGE 메시지 타입 추가
  - WebSocketMessageHelper에 빌더 메서드 추가

- 테스트 추가
  - RoomType, RoomStatus enum 테스트
  - GameSettings 모델 테스트
  - ChattingErrorCode 테스트 업데이트

Related: #440, #441, #442, #443, #444, #445, #446
Closes: #447, #448, #449, #450, #451, #452, #453, #454

* feat: 참가자 닉네임 및 방장 변경 WebSocket 알림 구현 (#456)

- RoomParticipant DTO 추가 (userId, nickname, isHost)
- ChatRoomQueryService에 닉네임 조회 메서드 추가
  - getParticipantsWithNicknames(): 참가자 목록 + 닉네임
  - getHostNickname(): 방장 닉네임 조회
- ChatRoomHandler.getRoom() 응답에 participants, hostNickname 추가
- ChatRoomCommandService.leaveRoom()에서 방장 변경 시 WebSocket 브로드캐스트

Related: #440

* fix: ChatRoomFunction에 UserTable DynamoDB 권한 추가

- 참가자/방장 닉네임 조회를 위한 UserTable 읽기 권한 추가
- DynamoDBReadPolicy로 UserTable 접근 허용

Fixes #457

* fix: GameSettings에 @DynamoDbBean 어노테이션 추가

- DynamoDB Enhanced Client가 중첩 객체를 직렬화/역직렬화할 수 있도록 수정
- ChatRoom 저장/조회 시 GameSettings 변환 오류 해결

Fixes #457

* fix: ChatRoomFunction에 WEBSOCKET_ENDPOINT 환경변수 및 권한 추가

- leaveRoom에서 WebSocketBroadcaster 사용을 위한 환경변수 추가
- execute-api:ManageConnections 권한 추가

* fix: WebSocket Lambda 함수들에 WEBSOCKET_ENDPOINT 환경변수 추가

- WebSocketConnectFunction에 WEBSOCKET_ENDPOINT 추가
- WebSocketDisconnectFunction에 WEBSOCKET_ENDPOINT 추가
- execute-api:ManageConnections 권한 추가

* fix: Grammar WebSocket Lambda 환경 변수 및 권한 추가

- GrammarStreamingConnectFunction에 WEBSOCKET_ENDPOINT 환경 변수 추가
- GrammarStreamingDisconnectFunction에 WEBSOCKET_ENDPOINT 환경 변수 추가
- 두 함수에 execute-api:ManageConnections 권한 추가

* feat: GSI1SK 확장성 있는 재설계 및 DB 레벨 필터링

## 변경 사항

### GSI1SK 포맷 변경
- 기존: {level}#{createdAt}
- 신규: {type}#{gameType}#{status}#{level}#{createdAt}

### 지원 쿼리 패턴
- 전체 방: GSI1PK = "ROOMS"
- 게임방만: begins_with(GSI1SK, "GAME#")
- 캐치마인드만: begins_with(GSI1SK, "GAME#CATCHMIND#")
- 대기중 캐치마인드: begins_with(GSI1SK, "GAME#CATCHMIND#WAITING#")

### 파일 수정
- ChatRoomCommandService.java: 방 생성 시 새 GSI1SK 포맷 적용
- ChatRoomRepository.java: findByFilters() 메서드 추가, updateStatus() 메서드 추가
- ChatRoomQueryService.java: 메모리 필터링 제거, DB 레벨 필터링으로 변경
- GameService.java: 게임 시작/종료 시 방 상태 업데이트 (GSI1SK 포함)

### 마이그레이션
- scripts/migrate-gsi1sk.sh: 기존 데이터 마이그레이션 스크립트
- 37개 기존 방 마이그레이션 완료

* fix: increase stats query limit to 100 days

- Adjust maximum allowable limit for recent stats query from 30 to 100 days to support extended data range responses.

* feat: improve game round and connection management logic

- Added handling for game round timeout (`ROUND_TIMEOUT`) in WebSocketMessageHandler.
- Enhanced game start broadcast to include `currentWord` for the drawer only.
- Updated ConnectionRepository to remove duplicate user connections in the same room.
- Added `currentWordEnglish` to GameSession for better answer verification.
- Normalized ChatRoom levels to match database storage format.
- Updated template.yaml to include DynamoDBReadPolicy for VocabTable.

* refactor: 코드 정리 및 미사용 클래스 제거 (#459)

* refactor: remove unused WebSocketResponseUtil

* refactor: add AutoCloseable to WebSocketBroadcaster

* refactor: remove unused TestService

* refactor: remove unused WordService

* refactor: remove unused DailyStudyService

* refactor: remove unused UserWordService

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* fix: resolve N+1 query in StatsService

* refactor(all): DI 패턴 및 전략 패턴 적용 (#461)

- Repository, Service, Handler에 DI 생성자 추가 (테스트 용이성)
- BadgeService에 Strategy 패턴 적용 (뱃지 조건 검증 로직 분리)

* refactor: relocate and restructure seed data files

- Moved `question-homes.json` and `words.json` from subdirectories to `seed` folder.
- Updated file paths for better organization and clarity.

* chore: seed 데이터 폴더 구조 정리

* feat: add CI/CD pipeline configuration for CodePipeline

* fix: add SNS topic policy and DependsOn for notification rule

* fix: correct paths in buildspec.yml for CodeBuild

* fix: remove hardcoded JAVA_HOME, use runtime default

* fix: add gradle wrapper for CI/CD build

* fix: use single line sam package command with hardcoded bucket

* fix: use existing stack name group2-englishstudy-chatting

* fix: add missing WEBSOCKET_ENDPOINT env var to WebSocket connect functions

* docs: update FRONTEND-API-GUIDE with new RoomType/RoomStatus structure

* feat : WebSocket Connect, Disconnect 핸들러 & SpeakingConnecion 모델 구현

* feat : WebSocket 메시지 처리 handler, service 구현

* feat : WebSocket 연결 정보 Repository 구현

* fix: update WebSocketDisconnectHandler to use GameSession model

- Remove references to deleted ChatRoom game fields
- Use GameSessionRepository to finish active game sessions
- Use ChatRoomRepository.updateStatus() for room state management

* perf: optimize CI/CD build time

- Add pip cache for SAM CLI dependencies
- Enable Gradle parallel builds and build cache
- Add SAM build cache (.aws-sam)
- Use sam build --parallel --cached
- Skip SAM CLI install if already cached
- Remove unnecessary 'clean' to leverage cache

* feat: add custom CodeBuild Docker image with pre-installed tools

- Dockerfile with Java 21 + SAM CLI + Gradle pre-installed
- build-and-push.sh script for ECR deployment
- Updated buildspec.yml for custom image (removes SAM CLI install)
- Expected build time reduction: ~30-40 seconds

* feature : AI 영어 회화 연습 기능 (#468)

* feat : WebSocket Connect, Disconnect 핸들러 & SpeakingConnecion 모델 구현

* feat : WebSocket 메시지 처리 handler, service 구현

* feat : WebSocket 연결 정보 Repository 구현

* fix: remove typo in SpeakingConnectionRepository

* fix : 오타 수정

* chore: trigger build test with custom Docker image

* chore: remove unnecessary newlines and whitespace across WebSocket handlers and related classes

* chore: remove unnecessary newlines and whitespace across WebSocket handlers and related classes

* Release: 캐치마인드 게임 분리, AI 회화 연습, CI/CD 파이프라인 (#469)

* feature : OPIc 세션관리 + 답변 처리 파이프라인 구현  (#413)

* feat : OPIc 질문 & 세션 관련 dto 생성

* refactor : @DynamoDbBean 주석 추가

* feat : 주제 + 소주제 + 레벨로 오픽 질문 조회 추가

* feat : OPIc 세션, 질문, 답변 종합 handler 구현

* feat : 오픽 주제, 소주제별 seed 데이터 추가

* refactor : Transcribe API KEY 환경변수명 수정

* refactor : Bedrock에 사용하는 클로드 모델 변경

* refactor : S3 Key 대신 Proxy에서 요청하는 Base64 값으로 변환

* feat: GAME_START, ROUND_END 메시지에 serverTime 추가

- broadcastGameStart(): serverTime, roundDuration 필드 추가
- broadcastRoundEnd(): serverTime, roundStartTime, roundDuration 필드 추가
- GameService.endRound(): data에 roundStartTime, roundDuration 포함
- 타이머 동기화 버그 수정을 위한 서버 시간 제공

* feat: WebSocketMessageHelper 유틸리티 클래스 추가

- domain 필드 포함 메시지 생성 헬퍼
- DOMAIN_CHAT, DOMAIN_GAME 상수 정의
- buildChatMessage(), buildGameMessage() 메서드

* feat: 모든 WebSocket 메시지에 domain 필드 추가

- ScoreUpdateMessage에 domain 필드 추가
- broadcastGameStart에 domain:"game" 추가
- broadcastRoundEnd에 domain:"game" 추가
- broadcastCorrectAnswerMessage에 domain:"game" 추가
- handleCommandResult 시스템 메시지에 domain:"game" 추가
- handleRegularMessage 채팅 메시지에 domain:"chat" 추가

Closes #426, #427

* feat: GameSession 모델 클래스 생성

- DynamoDB Enhanced Client 어노테이션 적용
- GSI1: roomId로 활성 게임 세션 조회 가능
- 게임 상태 관리용 헬퍼 메서드 포함

Closes #428

* feat: GameSessionRepository 구현

- 기본 CRUD (save, findById, delete)
- roomId로 활성/전체 게임 세션 조회
- 상태, 라운드, 점수 업데이트 메서드
- 정답자 추가, 힌트 사용, 게임 종료 처리

Closes #429

* refactor: ChatRoom에서 게임 필드 분리

- 게임 관련 필드 제거 (gameStatus, currentRound 등)
- activeGameSessionId 필드 추가
- 게임 상태는 GameSession으로 분리됨

Note: 의존 코드 수정은 #431에서 진행

Closes #430

* refactor: GameSession 기반으로 전체 게임 로직 리팩토링

- GameService: ChatRoom 대신 GameSession 사용
- GameStatsService: GameSession 매개변수로 변경
- CommandService: GameSession 기반 점수 조회
- GameHandler: GameSession 기반 REST API
- WebSocketMessageHandler: GameSession 기반 브로드캐스트
- GameStatusResponse, ScoreboardResponse: GameSession 매개변수

Closes #431

* feat: GameSessionHandler Lambda 및 게임 세션 API 구현

- POST /rooms/{roomId}/games - 게임 세션 생성
- GET /games/{gameSessionId} - 게임 상태 조회 (재접속용)
- POST /games/{gameSessionId}/start - 게임 시작
- POST /games/{gameSessionId}/stop - 게임 종료

모든 응답에 serverTime 포함 (타이머 동기화)
출제자에게만 currentWord 포함

Closes #432, #433

* feat: 게임 시작 7분 후 자동 종료 기능 구현

- GameConfig에 gameTimeLimit() 메서드 추가 (기본값: 420초)
- GameSchedulerClient 유틸리티 클래스 생성 (EventBridge Scheduler 연동)
- GameService에 스케줄 생성/취소 로직 추가
- GameAutoCloseHandler Lambda 함수 생성
- template.yaml에 Lambda, IAM Role, Schedule Group 추가

Closes #417

* fix : 메모리 증가 및 Lambda 응답 제한 시간 Cognito 트리거 제한시간과 동일하게 수정 (#439)

* feat: 캐치마인드 게임 방 분리 기능 구현 (#455)

- Room 타입 분리 (CHAT/GAME)
  - RoomType, RoomStatus enum 추가
  - ChatRoom 모델에 type, gameType, gameSettings, status, hostId 필드 추가
  - GameSettings 모델 추가

- 방 생성/조회 API 수정
  - CreateRoomRequest에 type, gameType, gameSettings 필드 추가
  - 방 목록 조회 시 type, gameType, status 필터 지원

- 게임 시작 조건 검증
  - GAME 타입 방에서만 게임 시작 가능 (GAME_007 에러)

- 게임 재시작 API 구현 (#452)
  - POST /rooms/{roomId}/game/restart 엔드포인트 추가
  - 방장만 재시작 가능 (GAME_009 에러)
  - 게임 진행 중 재시작 불가 (GAME_008 에러)

- 방장 변경 로직 구현 (#453)
  - 방장 퇴장 시 다음 멤버에게 자동 이전
  - 모든 멤버 퇴장 시 방 자동 삭제

- WebSocket 메시지 타입 추가 (#454)
  - ROOM_STATUS_CHANGE, HOST_CHANGE 메시지 타입 추가
  - WebSocketMessageHelper에 빌더 메서드 추가

- 테스트 추가
  - RoomType, RoomStatus enum 테스트
  - GameSettings 모델 테스트
  - ChattingErrorCode 테스트 업데이트

Related: #440, #441, #442, #443, #444, #445, #446
Closes: #447, #448, #449, #450, #451, #452, #453, #454

* feat: 참가자 닉네임 및 방장 변경 WebSocket 알림 구현 (#456)

- RoomParticipant DTO 추가 (userId, nickname, isHost)
- ChatRoomQueryService에 닉네임 조회 메서드 추가
  - getParticipantsWithNicknames(): 참가자 목록 + 닉네임
  - getHostNickname(): 방장 닉네임 조회
- ChatRoomHandler.getRoom() 응답에 participants, hostNickname 추가
- ChatRoomCommandService.leaveRoom()에서 방장 변경 시 WebSocket 브로드캐스트

Related: #440

* fix: ChatRoomFunction에 UserTable DynamoDB 권한 추가

- 참가자/방장 닉네임 조회를 위한 UserTable 읽기 권한 추가
- DynamoDBReadPolicy로 UserTable 접근 허용

Fixes #457

* fix: GameSettings에 @DynamoDbBean 어노테이션 추가

- DynamoDB Enhanced Client가 중첩 객체를 직렬화/역직렬화할 수 있도록 수정
- ChatRoom 저장/조회 시 GameSettings 변환 오류 해결

Fixes #457

* fix: ChatRoomFunction에 WEBSOCKET_ENDPOINT 환경변수 및 권한 추가

- leaveRoom에서 WebSocketBroadcaster 사용을 위한 환경변수 추가
- execute-api:ManageConnections 권한 추가

* fix: WebSocket Lambda 함수들에 WEBSOCKET_ENDPOINT 환경변수 추가

- WebSocketConnectFunction에 WEBSOCKET_ENDPOINT 추가
- WebSocketDisconnectFunction에 WEBSOCKET_ENDPOINT 추가
- execute-api:ManageConnections 권한 추가

* fix: Grammar WebSocket Lambda 환경 변수 및 권한 추가

- GrammarStreamingConnectFunction에 WEBSOCKET_ENDPOINT 환경 변수 추가
- GrammarStreamingDisconnectFunction에 WEBSOCKET_ENDPOINT 환경 변수 추가
- 두 함수에 execute-api:ManageConnections 권한 추가

* feat: GSI1SK 확장성 있는 재설계 및 DB 레벨 필터링

## 변경 사항

### GSI1SK 포맷 변경
- 기존: {level}#{createdAt}
- 신규: {type}#{gameType}#{status}#{level}#{createdAt}

### 지원 쿼리 패턴
- 전체 방: GSI1PK = "ROOMS"
- 게임방만: begins_with(GSI1SK, "GAME#")
- 캐치마인드만: begins_with(GSI1SK, "GAME#CATCHMIND#")
- 대기중 캐치마인드: begins_with(GSI1SK, "GAME#CATCHMIND#WAITING#")

### 파일 수정
- ChatRoomCommandService.java: 방 생성 시 새 GSI1SK 포맷 적용
- ChatRoomRepository.java: findByFilters() 메서드 추가, updateStatus() 메서드 추가
- ChatRoomQueryService.java: 메모리 필터링 제거, DB 레벨 필터링으로 변경
- GameService.java: 게임 시작/종료 시 방 상태 업데이트 (GSI1SK 포함)

### 마이그레이션
- scripts/migrate-gsi1sk.sh: 기존 데이터 마이그레이션 스크립트
- 37개 기존 방 마이그레이션 완료

* fix: increase stats query limit to 100 days

- Adjust maximum allowable limit for recent stats query from 30 to 100 days to support extended data range responses.

* feat: improve game round and connection management logic

- Added handling for game round timeout (`ROUND_TIMEOUT`) in WebSocketMessageHandler.
- Enhanced game start broadcast to include `currentWord` for the drawer only.
- Updated ConnectionRepository to remove duplicate user connections in the same room.
- Added `currentWordEnglish` to GameSession for better answer verification.
- Normalized ChatRoom levels to match database storage format.
- Updated template.yaml to include DynamoDBReadPolicy for VocabTable.

* refactor: 코드 정리 및 미사용 클래스 제거 (#459)

* refactor: remove unused WebSocketResponseUtil

* refactor: add AutoCloseable to WebSocketBroadcaster

* refactor: remove unused TestService

* refactor: remove unused WordService

* refactor: remove unused DailyStudyService

* refactor: remove unused UserWordService

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* fix: resolve N+1 query in StatsService

* refactor(all): DI 패턴 및 전략 패턴 적용 (#461)

- Repository, Service, Handler에 DI 생성자 추가 (테스트 용이성)
- BadgeService에 Strategy 패턴 적용 (뱃지 조건 검증 로직 분리)

* refactor: relocate and restructure seed data files

- Moved `question-homes.json` and `words.json` from subdirectories to `seed` folder.
- Updated file paths for better organization and clarity.

* chore: seed 데이터 폴더 구조 정리

* feat: add CI/CD pipeline configuration for CodePipeline

* fix: add SNS topic policy and DependsOn for notification rule

* fix: correct paths in buildspec.yml for CodeBuild

* fix: remove hardcoded JAVA_HOME, use runtime default

* fix: add gradle wrapper for CI/CD build

* fix: use single line sam package command with hardcoded bucket

* fix: use existing stack name group2-englishstudy-chatting

* fix: add missing WEBSOCKET_ENDPOINT env var to WebSocket connect functions

* docs: update FRONTEND-API-GUIDE with new RoomType/RoomStatus structure

* fix: update WebSocketDisconnectHandler to use GameSession model

- Remove references to deleted ChatRoom game fields
- Use GameSessionRepository to finish active game sessions
- Use ChatRoomRepository.updateStatus() for room state management

* perf: optimize CI/CD build time

- Add pip cache for SAM CLI dependencies
- Enable Gradle parallel builds and build cache
- Add SAM build cache (.aws-sam)
- Use sam build --parallel --cached
- Skip SAM CLI install if already cached
- Remove unnecessary 'clean' to leverage cache

* feat: add custom CodeBuild Docker image with pre-installed tools

- Dockerfile with Java 21 + SAM CLI + Gradle pre-installed
- build-and-push.sh script for ECR deployment
- Updated buildspec.yml for custom image (removes SAM CLI install)
- Expected build time reduction: ~30-40 seconds

* feature : AI 영어 회화 연습 기능 (#468)

* feat : WebSocket Connect, Disconnect 핸들러 & SpeakingConnecion 모델 구현

* feat : WebSocket 메시지 처리 handler, service 구현

* feat : WebSocket 연결 정보 Repository 구현

* fix: remove typo in SpeakingConnectionRepository

* chore: trigger build test with custom Docker image

* chore: remove unnecessary newlines and whitespace across WebSocket handlers and related classes

* chore: remove unnecessary newlines and whitespace across WebSocket handlers and related classes

---------

Co-authored-by: hyein Heo <128613248+hye-inA@users.noreply.github.com>

* refactor : websocket -> rest api 전환

* feat : speaking handler REST로 교체

* feat : speaking 관련 dto 생성

* refacotor : 기존 service 코드 로직 재사용 및 repository 리펙토링

* fix: add CORS headers to API Gateway error responses (#479)

API Gateway의 인증 실패 등 에러 응답에 CORS 헤더가 누락되어
CloudFront를 통한 프론트엔드 요청이 차단되는 문제 수정

- UNAUTHORIZED (401) 응답에 CORS 헤더 추가
- ACCESS_DENIED (403) 응답에 CORS 헤더 추가
- DEFAULT_4XX/5XX 응답에 CORS 헤더 추가
- EXPIRED_TOKEN 응답에 CORS 헤더 추가

* feat(news): 뉴스 도메인 기반 구조 구축 (#385)

- NewsCategory, QuizType enum 추가
- NewsKey 상수 클래스 추가
- NewsErrorCode 예외 클래스 추가
- NewsArticle, KeywordInfo, QuizQuestion 모델 추가
- NewsArticleRepository CRUD 구현
- NewsTable DynamoDB 테이블 정의
- CORS GatewayResponses 설정 추가

* feat(news): 뉴스 수집 파이프라인 구현 (#386)

- NewsApiClient: NewsAPI 연동 서비스
- RssFeedParser: RSS 피드 파싱 (BBC, VOA, NPR)
- NewsDuplicateChecker: URL 기반 중복 필터링
- NewsCollectorService: 수집 오케스트레이션
- NewsCollectionHandler: Lambda 핸들러
- EventBridge 스케줄러: 매일 18시 KST 실행

* refactor(news): NewsAPI 제거, RSS만 사용

- NewsApiClient 삭제
- SSM Parameter 의존성 제거
- RSS 소스당 7개씩 수집 (BBC, VOA, NPR = 약 21개/일)

* feat(news): AI 뉴스 분석 시스템 구현 (#387)

- NewsAnalysisService: AI 분석 통합 서비스
  - Bedrock: CEFR 난이도 분석 (A1~C2)
  - Bedrock: 3줄 요약 + 퀴즈 3문제 생성
  - Comprehend: 핵심 키워드 추출
- NewsCollectorService: 수집 시 자동 분석 연동
- GSI1/GSI2 키 자동 설정 (레벨별, 카테고리별 조회)

* feat(news): 뉴스 학습 API 구현 (#388)

- NewsQueryService: 뉴스 조회 서비스
- NewsHandler: API 핸들러
  - GET /news - 목록 조회 (level, category 필터)
  - GET /news/today - 오늘의 뉴스
  - GET /news/recommended - 내 레벨 맞춤 추천
  - GET /news/{articleId} - 상세 조회 (조회수 증가)
- template.yaml: NewsFunction Lambda 추가

* feat(news): 뉴스 학습 부가 기능 구현 (#389)

- 읽기 완료 기록 API (POST /news/{articleId}/read)
- 북마크 토글 API (POST /news/{articleId}/bookmark)
- 북마크 목록 조회 API (GET /news/bookmarks)
- 학습 통계 조회 API (GET /news/stats)
- TTS 오디오 URL 조회 API (GET /news/{articleId}/audio)
- UserNewsRecord 모델 추가
- UserNewsRepository 추가
- NewsLearningService 추가

* feat(news): 복합 퀴즈 시스템 구현 (#471)

- 퀴즈 조회 API (GET /news/{articleId}/quiz)
- 퀴즈 제출 API (POST /news/{articleId}/quiz)
- 퀴즈 기록 조회 API (GET /news/quiz/history)
- NewsQuizResult 모델 추가
- QuizAnswerResult 모델 추가
- NewsQuizRepository 추가
- NewsQuizService 추가

* feat(news): 단어 수집 & Vocabulary 연동 구현 (#472)

- 단어 수집 API (POST /news/{articleId}/words)
- 수집 단어 목록 API (GET /news/words)
- 단어 상세 조회 API (GET /news/{articleId}/words/{word})
- 단어 삭제 API (DELETE /news/{articleId}/words/{word})
- Vocabulary 연동 API (POST /news/words/{word}/sync)
- NewsWordCollect 모델 추가
- NewsWordRepository 추가
- NewsWordService 추가

* feat: add multi-environment deployment support (dev/test/prod)

* fix: update buildspec.yml to deploy prod environment with parameter overrides

* feat(news): 뉴스 도메인 기반 구조 구축 (#385)

- NewsCategory, QuizType enum 추가
- NewsKey 상수 클래스 추가
- NewsErrorCode 예외 클래스 추가
- NewsArticle, KeywordInfo, QuizQuestion 모델 추가
- NewsArticleRepository CRUD 구현
- NewsTable DynamoDB 테이블 정의
- CORS GatewayResponses 설정 추가

* feat(news): 뉴스 수집 파이프라인 구현 (#386)

- NewsApiClient: NewsAPI 연동 서비스
- RssFeedParser: RSS 피드 파싱 (BBC, VOA, NPR)
- NewsDuplicateChecker: URL 기반 중복 필터링
- NewsCollectorService: 수집 오케스트레이션
- NewsCollectionHandler: Lambda 핸들러
- EventBridge 스케줄러: 매일 18시 KST 실행

* refactor(news): NewsAPI 제거, RSS만 사용

- NewsApiClient 삭제
- SSM Parameter 의존성 제거
- RSS 소스당 7개씩 수집 (BBC, VOA, NPR = 약 21개/일)

* feat(news): AI 뉴스 분석 시스템 구현 (#387)

- NewsAnalysisService: AI 분석 통합 서비스
  - Bedrock: CEFR 난이도 분석 (A1~C2)
  - Bedrock: 3줄 요약 + 퀴즈 3문제 생성
  - Comprehend: 핵심 키워드 추출
- NewsCollectorService: 수집 시 자동 분석 연동
- GSI1/GSI2 키 자동 설정 (레벨별, 카테고리별 조회)

* feat(news): 뉴스 학습 API 구현 (#388)

- NewsQueryService: 뉴스 조회 서비스
- NewsHandler: API 핸들러
  - GET /news - 목록 조회 (level, category 필터)
  - GET /news/today - 오늘의 뉴스
  - GET /news/recommended - 내 레벨 맞춤 추천
  - GET /news/{articleId} - 상세 조회 (조회수 증가)
- template.yaml: NewsFunction Lambda 추가

* feat(news): 뉴스 학습 부가 기능 구현 (#389)

- 읽기 완료 기록 API (POST /news/{articleId}/read)
- 북마크 토글 API (POST /news/{articleId}/bookmark)
- 북마크 목록 조회 API (GET /news/bookmarks)
- 학습 통계 조회 API (GET /news/stats)
- TTS 오디오 URL 조회 API (GET /news/{articleId}/audio)
- UserNewsRecord 모델 추가
- UserNewsRepository 추가
- NewsLearningService 추가

* feat(news): 복합 퀴즈 시스템 구현 (#471)

- 퀴즈 조회 API (GET /news/{articleId}/quiz)
- 퀴즈 제출 API (POST /news/{articleId}/quiz)
- 퀴즈 기록 조회 API (GET /news/quiz/history)
- NewsQuizResult 모델 추가
- QuizAnswerResult 모델 추가
- NewsQuizRepository 추가
- NewsQuizService 추가

* feat(news): 단어 수집 & Vocabulary 연동 구현 (#472)

- 단어 수집 API (POST /news/{articleId}/words)
- 수집 단어 목록 API (GET /news/words)
- 단어 상세 조회 API (GET /news/{articleId}/words/{word})
- 단어 삭제 API (DELETE /news/{articleId}/words/{word})
- Vocabulary 연동 API (POST /news/words/{word}/sync)
- NewsWordCollect 모델 추가
- NewsWordRepository 추가
- NewsWordService 추가

* feat: add multi-environment deployment support (dev/test/prod)

* fix: update buildspec.yml to deploy prod environment with parameter overrides

* refactor : AI 말하기 Websocket 구현 -> REST API 구현으로 리팩토링 (#490)

* feat : WebSocket Connect, Disconnect 핸들러 & SpeakingConnecion 모델 구현

* feat : WebSocket 메시지 처리 handler, service 구현

* feat : WebSocket 연결 정보 Repository 구현

* fix : 오타 수정

* refactor : websocket -> rest api 전환

* feat : speaking handler REST로 교체

* feat : speaking 관련 dto 생성

* refacotor : 기존 service 코드 로직 재사용 및 repository 리펙토링

* fix: revert buildspec.yml to build-only for CloudFormation deploy stage

* fix: revert buildspec.yml to build-only for CloudFormation deploy stage

* fix: update all API Gateway StageName to use Environment parameter

* fix: correct VocabularyTable and ContentBucket references in NewsFunction

* fix: correct VocabularyTable and ContentBucket references in NewsFunction

* fix: add stack name prefix to GameScheduleGroup and daily-stats schedule to avoid conflicts

* fix: add stack name prefix to GameScheduleGroup and daily-stats schedule to avoid conflicts

* feat: add support for existing Cognito User Pool reuse across environments

* fix: add conditional Cognito ARN reference in API Gateway Authorizer

* fix: remove Cognito resources completely, use existing Cognito only

* fix: remove Cognito resources completely, use existing Cognito only

* feat : speaking rest API 람다 함수 추가

* feat: add S3 bucket resource and fix environment-specific endpoints

- Add ContentBucket S3 resource for content storage
- Replace hardcoded /dev with ${Environment} in all WebSocket endpoints
- Update Output URLs to use dynamic environment stage

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* fix: add stack name prefix to news-collection schedule name

Prevent EventBridge rule name conflicts across environments

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* fix: add X-Requested-With and Accept headers to CORS config

Enable additional headers for CloudFront CORS compatibility

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* fix: use environment variable for S3 bucket URLs

Replace hardcoded bucket name with BUCKET_NAME env var for multi-env support:
- PreSignUpHandler: dynamic default profile URL
- PostConfirmationHandler: dynamic default profile URL
- UserService: dynamic default profile URL
- BadgeType: dynamic badge image base URL

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* fix: disable authorizer for CORS preflight requests

Add AddDefaultAuthorizerToCorsPreflight: false to prevent
Cognito Authorizer from blocking OPTIONS requests

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* feat : speaking REST API 람다 함수 추가  (#491)

* feature : OPIc 세션관리 + 답변 처리 파이프라인 구현  (#413)

* feat : OPIc 질문 & 세션 관련 dto 생성

* refactor : @DynamoDbBean 주석 추가

* feat : 주제 + 소주제 + 레벨로 오픽 질문 조회 추가

* feat : OPIc 세션, 질문, 답변 종합 handler 구현

* feat : 오픽 주제, 소주제별 seed 데이터 추가

* refactor : Transcribe API KEY 환경변수명 수정

* refactor : Bedrock에 사용하는 클로드 모델 변경

* refactor : S3 Key 대신 Proxy에서 요청하는 Base64 값으로 변환

* feat: GAME_START, ROUND_END 메시지에 serverTime 추가

- broadcastGameStart(): serverTime, roundDuration 필드 추가
- broadcastRoundEnd(): serverTime, roundStartTime, roundDuration 필드 추가
- GameService.endRound(): data에 roundStartTime, roundDuration 포함
- 타이머 동기화 버그 수정을 위한 서버 시간 제공

* feat: WebSocketMessageHelper 유틸리티 클래스 추가

- domain 필드 포함 메시지 생성 헬퍼
- DOMAIN_CHAT, DOMAIN_GAME 상수 정의
- buildChatMessage(), buildGameMessage() 메서드

* feat: 모든 WebSocket 메시지에 domain 필드 추가

- ScoreUpdateMessage에 domain 필드 추가
- broadcastGameStart에 domain:"game" 추가
- broadcastRoundEnd에 domain:"game" 추가
- broadcastCorrectAnswerMessage에 domain:"game" 추가
- handleCommandResult 시스템 메시지에 domain:"game" 추가
- handleRegularMessage 채팅 메시지에 domain:"chat" 추가

Closes #426, #427

* feat: GameSession 모델 클래스 생성

- DynamoDB Enhanced Client 어노테이션 적용
- GSI1: roomId로 활성 게임 세션 조회 가능
- 게임 상태 관리용 헬퍼 메서드 포함

Closes #428

* feat: GameSessionRepository 구현

- 기본 CRUD (save, findById, delete)
- roomId로 활성/전체 게임 세션 조회
- 상태, 라운드, 점수 업데이트 메서드
- 정답자 추가, 힌트 사용, 게임 종료 처리

Closes #429

* refactor: ChatRoom에서 게임 필드 분리

- 게임 관련 필드 제거 (gameStatus, currentRound 등)
- activeGameSessionId 필드 추가
- 게임 상태는 GameSession으로 분리됨

Note: 의존 코드 수정은 #431에서 진행

Closes #430

* refactor: GameSession 기반으로 전체 게임 로직 리팩토링

- GameService: ChatRoom 대신 GameSession 사용
- GameStatsService: GameSession 매개변수로 변경
- CommandService: GameSession 기반 점수 조회
- GameHandler: GameSession 기반 REST API
- WebSocketMessageHandler: GameSession 기반 브로드캐스트
- GameStatusResponse, ScoreboardResponse: GameSession 매개변수

Closes #431

* feat: GameSessionHandler Lambda 및 게임 세션 API 구현

- POST /rooms/{roomId}/games - 게임 세션 생성
- GET /games/{gameSessionId} - 게임 상태 조회 (재접속용)
- POST /games/{gameSessionId}/start - 게임 시작
- POST /games/{gameSessionId}/stop - 게임 종료

모든 응답에 serverTime 포함 (타이머 동기화)
출제자에게만 currentWord 포함

Closes #432, #433

* feat: 게임 시작 7분 후 자동 종료 기능 구현

- GameConfig에 gameTimeLimit() 메서드 추가 (기본값: 420초)
- GameSchedulerClient 유틸리티 클래스 생성 (EventBridge Scheduler 연동)
- GameService에 스케줄 생성/취소 로직 추가
- GameAutoCloseHandler Lambda 함수 생성
- template.yaml에 Lambda, IAM Role, Schedule Group 추가

Closes #417

* fix : 메모리 증가 및 Lambda 응답 제한 시간 Cognito 트리거 제한시간과 동일하게 수정 (#439)

* feat: 캐치마인드 게임 방 분리 기능 구현 (#455)

- Room 타입 분리 (CHAT/GAME)
  - RoomType, RoomStatus enum 추가
  - ChatRoom 모델에 type, gameType, gameSettings, status, hostId 필드 추가
  - GameSettings 모델 추가

- 방 생성/조회 API 수정
  - CreateRoomRequest에 type, gameType, gameSettings 필드 추가
  - 방 목록 조회 시 type, gameType, status 필터 지원

- 게임 시작 조건 검증
  - GAME 타입 방에서만 게임 시작 가능 (GAME_007 에러)

- 게임 재시작 API 구현 (#452)
  - POST /rooms/{roomId}/game/restart 엔드포인트 추가
  - 방장만 재시작 가능 (GAME_009 에러)
  - 게임 진행 중 재시작 불가 (GAME_008 에러)

- 방장 변경 로직 구현 (#453)
  - 방장 퇴장 시 다음 멤버에게 자동 이전
  - 모든 멤버 퇴장 시 방 자동 삭제

- WebSocket 메시지 타입 추가 (#454)
  - ROOM_STATUS_CHANGE, HOST_CHANGE 메시지 타입 추가
  - WebSocketMessageHelper에 빌더 메서드 추가

- 테스트 추가
  - RoomType, RoomStatus enum 테스트
  - GameSettings 모델 테스트
  - ChattingErrorCode 테스트 업데이트

Related: #440, #441, #442, #443, #444, #445, #446
Closes: #447, #448, #449, #450, #451, #452, #453, #454

* feat: 참가자 닉네임 및 방장 변경 WebSocket 알림 구현 (#456)

- RoomParticipant DTO 추가 (userId, nickname, isHost)
- ChatRoomQueryService에 닉네임 조회 메서드 추가
  - getParticipantsWithNicknames(): 참가자 목록 + 닉네임
  - getHostNickname(): 방장 닉네임 조회
- ChatRoomHandler.getRoom() 응답에 participants, hostNickname 추가
- ChatRoomCommandService.leaveRoom()에서 방장 변경 시 WebSocket 브로드캐스트

Related: #440

* fix: ChatRoomFunction에 UserTable DynamoDB 권한 추가

- 참가자/방장 닉네임 조회를 위한 UserTable 읽기 권한 추가
- DynamoDBReadPolicy로 UserTable 접근 허용

Fixes #457

* fix: GameSettings에 @DynamoDbBean 어노테이션 추가

- DynamoDB Enhanced Client가 중첩 객체를 직렬화/역직렬화할 수 있도록 수정
- ChatRoom 저장/조회 시 GameSettings 변환 오류 해결

Fixes #457

* fix: ChatRoomFunction에 WEBSOCKET_ENDPOINT 환경변수 및 권한 추가

- leaveRoom에서 WebSocketBroadcaster 사용을 위한 환경변수 추가
- execute-api:ManageConnections 권한 추가

* fix: WebSocket Lambda 함수들에 WEBSOCKET_ENDPOINT 환경변수 추가

- WebSocketConnectFunction에 WEBSOCKET_ENDPOINT 추가
- WebSocketDisconnectFunction에 WEBSOCKET_ENDPOINT 추가
- execute-api:ManageConnections 권한 추가

* fix: Grammar WebSocket Lambda 환경 변수 및 권한 추가

- GrammarStreamingConnectFunction에 WEBSOCKET_ENDPOINT 환경 변수 추가
- GrammarStreamingDisconnectFunction에 WEBSOCKET_ENDPOINT 환경 변수 추가
- 두 함수에 execute-api:ManageConnections 권한 추가

* feat: GSI1SK 확장성 있는 재설계 및 DB 레벨 필터링

- 기존: {level}#{createdAt}
- 신규: {type}#{gameType}#{status}#{level}#{createdAt}

- 전체 방: GSI1PK = "ROOMS"
- 게임방만: begins_with(GSI1SK, "GAME#")
- 캐치마인드만: begins_with(GSI1SK, "GAME#CATCHMIND#")
- 대기중 캐치마인드: begins_with(GSI1SK, "GAME#CATCHMIND#WAITING#")

- ChatRoomCommandService.java: 방 생성 시 새 GSI1SK 포맷 적용
- ChatRoomRepository.java: findByFilters() 메서드 추가, updateStatus() 메서드 추가
- ChatRoomQueryService.java: 메모리 필터링 제거, DB 레벨 필터링으로 변경
- GameService.java: 게임 시작/종료 시 방 상태 업데이트 (GSI1SK 포함)

- scripts/migrate-gsi1sk.sh: 기존 데이터 마이그레이션 스크립트
- 37개 기존 방 마이그레이션 완료

* fix: increase stats query limit to 100 days

- Adjust maximum allowable limit for recent stats query from 30 to 100 days to support extended data range responses.

* feat: improve game round and connection management logic

- Added handling for game round timeout (`ROUND_TIMEOUT`) in WebSocketMessageHandler.
- Enhanced game start broadcast to include `currentWord` for the drawer only.
- Updated ConnectionRepository to remove duplicate user connections in the same room.
- Added `currentWordEnglish` to GameSession for better answer verification.
- Normalized ChatRoom levels to match database storage format.
- Updated template.yaml to include DynamoDBReadPolicy for VocabTable.

* refactor: 코드 정리 및 미사용 클래스 제거 (#459)

* refactor: remove unused WebSocketResponseUtil

* refactor: add AutoCloseable to WebSocketBroadcaster

* refactor: remove unused TestService

* refactor: remove unused WordService

* refactor: remove unused DailyStudyService

* refactor: remove unused UserWordService

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* fix: resolve N+1 query in StatsService

* refactor(all): DI 패턴 및 전략 패턴 적용 (#461)

- Repository, Service, Handler에 DI 생성자 추가 (테스트 용이성)
- BadgeService에 Strategy 패턴 적용 (뱃지 조건 검증 로직 분리)

* refactor: relocate and restructure seed data files

- Moved `question-homes.json` and `words.json` from subdirectories to `seed` folder.
- Updated file paths for better organization and clarity.

* chore: seed 데이터 폴더 구조 정리

* feat: add CI/CD pipeline configuration for CodePipeline

* fix: add SNS topic policy and DependsOn for notification rule

* fix: correct paths in buildspec.yml for CodeBuild

* fix: remove hardcoded JAVA_HOME, use runtime default

* fix: add gradle wrapper for CI/CD build

* fix: use single line sam package command with hardcoded bucket

* fix: use existing stack name group2-englishstudy-chatting

* fix: add missing WEBSOCKET_ENDPOINT env var to WebSocket connect functions

* docs: update FRONTEND-API-GUIDE with new RoomType/RoomStatus structure

* feat : WebSocket Connect, Disconnect 핸들러 & SpeakingConnecion 모델 구현

* feat : WebSocket 메시지 처리 handler, service 구현

* feat : WebSocket 연결 정보 Repository 구현

* fix: update WebSocketDisconnectHandler to use GameSession model

- Remove references to deleted ChatRoom game fields
- Use GameSessionRepository to finish active game sessions
- Use ChatRoomRepository.updateStatus() for room state management

* perf: optimize CI/CD build time

- Add pip cache for SAM CLI dependencies
- Enable Gradle parallel builds and build cache
- Add SAM build cache (.aws-sam)
- Use sam build --parallel --cached
- Skip SAM CLI install if already cached
- Remove unnecessary 'clean' to leverage cache

* feat: add custom CodeBuild Docker image with pre-installed tools

- Dockerfile with Java 21 + SAM CLI + Gradle pre-installed
- build-and-push.sh script for ECR deployment
- Updated buildspec.yml for custom image (removes SAM CLI install)
- Expected build time reduction: ~30-40 seconds

* feature : AI 영어 회화 연습 기능 (#468)

* feat : WebSocket Connect, Disconnect 핸들러 & SpeakingConnecion 모델 구현

* feat : WebSocket 메시지 처리 handler, service 구현

* feat : WebSocket 연결 정보 Repository 구현

* fix: remove typo in SpeakingConnectionRepository

* fix : 오타 수정

* chore: trigger build test with custom Docker image

* chore: remove unnecessary newlines and whitespace across WebSocket handlers and related classes

* chore: remove unnecessary newlines and whitespace across WebSocket handlers and related classes

* refactor : websocket -> rest api 전환

* feat : speaking handler REST로 교체

* feat : speaking 관련 dto 생성

* refacotor : 기존 service 코드 로직 재사용 및 repository 리펙토링

* fix: add CORS headers to API Gateway error responses (#479)

API Gateway의 인증 실패 등 에러 응답에 CORS 헤더가 누락되어
CloudFront를 통한 프론트엔드 요청이 차단되는 문제 수정

- UNAUTHORIZED (401) 응답에 CORS 헤더 추가
- ACCESS_DENIED (403) 응답에 CORS 헤더 추가
- DEFAULT_4XX/5XX 응답에 CORS 헤더 추가
- EXPIRED_TOKEN 응답에 CORS 헤더 추가

* feat : speaking rest API 람다 함수 추가

---------

Co-authored-by: ddingjoo <ddingsha9@teambind.co.kr>

* refactor : speaking service 재사용

* refactor : AI 영어 회화 연습 코드 리팩토링

* feature : test 벡엔드 서버에 AI 말하기 연습 기능 배포 (#492)

* feat : WebSocket Connect, Disconnect 핸들러 & SpeakingConnecion 모델 구현

* feat : WebSocket 메시지 처리 handler, service 구현

* feat : WebSocket 연결 정보 Repository 구현

* fix : 오타 수정

* refactor : websocket -> rest api 전환

* feat : speaking handler REST로 교체

* feat : speaking 관련 dto 생성

* refacotor : 기존 service 코드 로직 재사용 및 repository 리펙토링

* feat : speaking rest API 람다 함수 추가

* refactor : speaking service 재사용

* refactor : AI 영어 회화 연습 코드 리팩토링

---------

Co-authored-by: DDING JOO <ddingsha9@teambind.co.kr>

* feat : handleChat 메서드 JsonNull 체크 푸가

* feature : handleChat 메서드 JsonNull 체크 추가 (#493)

* feat : WebSocket Connect, Disconnect 핸들러 & SpeakingConnecion 모델 구현

* feat : WebSocket 메시지 처리 handler, service 구현

* feat : WebSocket 연결 정보 Repository 구현

* fix : 오타 수정

* refactor : websocket -> rest api 전환

* feat : speaking handler REST로 교체

* feat : speaking 관련 dto 생성

* refacotor : 기존 service 코드 로직 재사용 및 repository 리펙토링

* feat : speaking rest API 람다 함수 추가

* refactor : speaking service 재사용

* refactor : AI 영어 회화 연습 코드 리팩토링

* feat : handleChat 메서드 JsonNull 체크 푸가

---------

Co-authored-by: DDING JOO <ddingsha9@teambind.co.kr>

* feat(news): 뉴스 학습 배지 시스템 구현 (#473)

- 14개 뉴스 관련 배지 추가 (읽기, 퀴즈, 단어수집, 연속학습, 마스터)
- UserStats에 뉴스 통계 필드 추가
- 6개 뉴스 배지 Strategy 클래스 생성
- 뉴스 읽기/퀴즈/단어수집 시 통계 업데이트 및 배지 체크 연동

* fix: add PATCH method to CORS AllowMethods

* test: BadgeType 개수 테스트 수정 (15 -> 29)

* fix: CORS PATCH 메서드 추가

* docs: 뉴스 기능 프론트엔드 연동 가이드 작성

* fix: NewsCollectionFunction에 Bedrock, Comprehend 권한 추가

* fix: add null check for collectWord request body

- Add INVALID_REQUEST error code to NewsErrorCode
- Check body and word field before accessing in collectWord()
- Prevents NullPointerException when request body is malformed

* feat: enhance stats API and bookmark response for frontend

- Add DAILY stats update for news read/quiz/word collection
- Add /stats/dashboard endpoint with frontend-requested format
  - today: wordsLearned, newsRead, quizzesTaken, wordsTotal
  - overall: totalWordsLearned, totalNewsRead, averageAccuracy, streaks
  - weeklyProgress: last 7 days with date/wordsLearned/newsRead
- Add news-related fields to all stats API responses
- Fix bookmark API to include full article details (title, summary, etc.)

* feat: add category classification to news AI analysis

- Add category field to AnalysisResult record
- Update Bedrock prompt to classify articles into categories
  (WORLD, POLITICS, BUSINESS, TECH, SCIENCE, HEALTH, SPORTS, ENTERTAINMENT, LIFESTYLE)
- Parse and set category from AI response
- Set GSI2 (CATEGORY#) index when category is available

* fix: add /stats/dashboard endpoint to template.yaml

* fix: filter by ARTICLE# prefix in findById to avoid returning UserNewsRecord

* docs: add News API troubleshooting guide

* feat: add Cognito authorizer to News API and enhance keyword extraction

- Set CognitoAuthorizer for all News API endpoints in template.yaml
- Update Bedrock AI to extract keywords with meanings and examples
- Add fallback to Comprehend for keyword extraction when Bedrock fails
- Modify KeywordInfo model to include example field
- Adjust AI prompt to include keyword extraction with examples
- Update AnalysisResult to store keywords and parse them from AI response

* Revert "Merge branch 'test' into prod"

This reverts commit c1a958eac6799d5838a76e4078ae304bcdb62278, reversing
changes made to a6662e0cfc46c6e12f20a89f0df285ff282160bc.

* feat: enhance bookmark and reading status tracking for News API

- Add bookmark and reading status to individual article responses
- Include bookmark status in paginated news responses
- Modify `KeywordInfo` to support Korean translations (`meaningKo`)
- Update AI prompts to extract Korean meanings for keywords

* refactor : session_id가 null 체크 추가

* fix : sessionId NullPointerException 에러 수정  (#496)

* feat : WebSocket Connect, Disconnect 핸들러 & SpeakingConnecion 모델 구현

* feat : WebSocket 메시지 처리 handler, service 구현

* feat : WebSocket 연결 정보 Repository 구현

* fix : 오타 수정

* refactor : websocket -> rest api 전환

* feat : speaking handler REST로 교체

* feat : speaking 관련 dto 생성

* refacotor : 기존 service 코드 로직 재사용 및 repository 리펙토링

* feat : speaking rest API 람다 함수 추가

* refactor : speaking service 재사용

* refactor : AI 영어 회화 연습 코드 리팩토링

* feat : handleChat 메서드 JsonNull 체크 푸가

* refactor : session_id가 null 체크 추가

* feat : template 환경변수 리펙토링

---------

Co-authored-by: DDING JOO <ddingsha9@teambind.co.kr>

* feat: enhance bookmark and reading status tracking for News API

- Add bookmark and reading status to individual article responses
- Include bookmark status in paginated news responses
- Modify `KeywordInfo` to support Korean translations (`meaningKo`)
- Update AI prompts to extract Korean meanings for keywords

* feat: add category filtering to UserWord API with enhanced query logic

- Introduce `category` filtering to `getUserWords` API
- Update WordCategory enums to include "news" category
- Apply category filter after enrichment with word info
- Adjust query limits for bookmarked and incorrect words queries

* feat: add default value for ExistingCognitoClientId in template.yaml

- Set default to an empty string to ensure compatibility with templates using this parameter without explicitly specifying a value.

* fix: SpeakingHandler getStringOrNull 컴파일 에러 수정

* fix: SpeakingHandler getStringOrNull 컴파일 에러 수정

* fix: SpeakingHandler getStringOrNull 컴파일 에러 수정

* fix: Bedrock 키워드(meaningKo 포함)를 article에 저장하도록 수정

* fix: Bedrock 키워드(meaningKo 포함)를 article에 저장하도록 수정

* fix: Bedrock 키워드(meaningKo 포함)를 article에 저장하도록 수정

* fix: Bedrock 키워드(meaningKo 포함)를 article에 저장하도록 수정

* feat: add dashboard stats API and enhance news stats tracking

- Introduce `/stats/dashboard` API for retrieving integrated user stats (today, overall, weekly progress, and level distribution)
- Update `UserStats` model to include additional fields for news stats (newsRead, newsQuizCompleted, newsQuizPerfect, newsWordsCollected, etc.)
- Add atomic updates to track news reading, quiz, and word stats in `UserStatsRepository`
- Modify CloudFormation `template.yaml` to register the new `/stats/dashboard` endpoint

* feat: add dashboard stats API and enhance news stats tracking

- Introduce `/stats/dashboard` API for retrieving integrated user stats (today, overall, weekly progress, and level distribution)
- Update `UserStats` model to include additional fields for news stats (newsRead, newsQuizCompleted, newsQuizPerfect, newsWordsCollected, etc.)
- Add atomic updates to track news reading, quiz, and word stats in `UserStatsRepository`
- Modify CloudFormation `template.yaml` to register the new `/stats/dashboard` endpoint

* feat: add dashboard stats API and enhance news stats tracking

- Introduce `/stats/dashboard` API for retrieving integrated user stats (today, overall, weekly progress, and level distribution)
- Update `UserStats` model to include additional fields for news stats (newsRead, newsQuizCompleted, newsQuizPerfect, newsWordsCollected, etc.)
- Add atomic updates to track news reading, quiz, and word stats in `UserStatsRepository`
- Modify CloudFormation `template.yaml` to register the new `/stats/dashboard` endpoint

* refactor: format code with consistent indentation and spacing

- Apply consistent formatting to improve code readability across multiple files
- Adjust indentation, spacing, and alignment in model classes, DTOs, and repository methods

* fix: filter by ARTICLE# prefix in findById to avoid returning bookmark records

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* feature : Speaking Table & Function template.yaml 파일에 추가 (#513)

* fix: BadgeRepository 클라이언트 초기화 패턴 통일

- 개별 DynamoDbEnhancedClient 생성 대신 AwsClients.dynamoDbEnhanced() 싱글톤 사용
- 다른 Repository들과 동일한 패턴 적용
- 불필요한 import 제거

Closes #396

* feat: EnvConfig 유틸리티 추가 및 환경 변수 검증 적용

환경 변수 미설정 시 명확한 에러 메시지를 제공하는 EnvConfig 유틸리티를 추가하고,
기존 System.getenv 호출을 EnvConfig.getRequired/getOrDefault로 대체함.

- EnvConfig: getRequired, getOrDefault, getIntOrDefault, getLongOrDefault 메서드 제공
- Lambda Cold Start 시점에 환경 변수 누락을 조기 감지
- 기존 Config 클래스(WebSocketConfig, RoomTokenConfig) EnvConfig 사용으로 통일

Closes #403

* refactor: TestService submitTest 메서드 책임 분리

submitTest 메서드를 단일 책임 원칙에 맞게 리팩토링:
- gradeAnswers(): 답안 채점 및 결과 집계
- isAnswerCorrect(): 단일 답안 정답 여부 판단
- buildResultItem(): 결과 항목 생성
- saveTestResult(): 테스트 결과 저장
- GradingResult record: 채점 결과 캡슐화

TestService와 TestCommandService 모두 동일하게 적용

Closes #404

* refactor: 하드코딩된 설정값 환경 변수로 외부화

각 도메인별 Config 클래스를 생성하여 하드코딩된 값들을 환경 변수로 설정 가능하게 변경.
기본값이 있어 환경 변수 미설정 시에도 기존 동작 유지.

## 새로 추가된 Config 클래스
- GrammarConfig: SESSION_TTL_DAYS, MAX_HISTORY_MESSAGES, MAX_TOKENS 등
- GameConfig: TOTAL_ROUNDS, ROUND_TIME_LIMIT, QUICK_GUESS_THRESHOLD_MS
- VocabularyConfig: NEW_WORDS_COUNT, REVIEW_WORDS_COUNT, 상태 전이 임계값 등

## 지원하는 환경 변수
- GRAMMAR_SESSION_TTL_DAYS, GRAMMAR_MAX_HISTORY_MESSAGES, GRAMMAR_MAX_TOKENS
- GAME_TOTAL_ROUNDS, GAME_ROUND_TIME_LIMIT, GAME_QUICK_GUESS_THRESHOLD_MS
- VOCAB_NEW_WORDS_COUNT, VOCAB_REVIEW_WORDS_COUNT
- VOCAB_TRANSITION_TO_REVIEWING, VOCAB_TRANSITION_TO_MASTERED

Closes #406

* test: StudyLevel enum 단위 테스트 추가

* test: Difficulty enum 단위 테스트 추가

* test: StudyConfig 단위 테스트 추가

* test: EnvConfig 단위 테스트 추가

* test: PaginatedResult 단위 테스트 추가

* test: JsonUtil 단위 테스트 추가

* test: CursorUtil 단위 테스트 추가

* test: CommonErrorCode 단위 테스트 추가

* test: CommonException 단위 테스트 추가

* test: BadgeType enum 단위 테스트 추가

* test: BadgeKey 상수 단위 테스트 추가

* test: WordStatus enum 단위 테스트 추가

* test: TestType enum 단위 테스트 추가

* test: VocabularyConfig 단위 테스트 추가

* test: VocabKey 상수 단위 테스트 추가

* test: VocabularyErrorCode 단위 테스트 추가

* test: VocabularyException 단위 테스트 추가

* test: SpacedRepetitionContext 단위 테스트 추가

* test: GrammarLevel enum 단위 테스트 추가

* test: GrammarConfig 단위 테스트 추가

* test: GrammarErrorCode 단위 테스트 추가

* test: GrammarException 단위 테스트 추가

* test: GameStatus enum 단위 테스트 추가

* test: GameConfig 단위 테스트 추가

* test: ChattingErrorCode 단위 테스트 추가

* test: ChattingException 단위 테스트 추가

* fix: OPIc FeedbackResponse.java 문법 오류 수정

* style: AwsClients 코드 포맷팅

* style: EnvConfig 코드 포맷팅

* style: RoomTokenConfig 코드 포맷팅

* style: WebSocketConfig 코드 포맷팅

* style: JsonUtil 코드 포맷팅

* style: GameConfig 코드 포맷팅

* style: GrammarConfig 코드 포맷팅

* style: GrammarKey 코드 포맷팅

* style: GrammarErrorCode 코드 포맷팅

* style: GrammarException 코드 포맷팅

* style: BedrockGrammarCheckFactory 코드 포맷팅

* style: GrammarConversationService 코드 포맷팅

* style: FeedbackResponse 코드 포맷팅

* style: SessionReportResponse 코드 포맷팅

* style: SpeakingError 코드 포맷팅

* style: SpeakingErrorType 코드 포맷팅

* style: OPIcException 코드 포맷팅

* style: OPIcAnswer 코드 포맷팅

* style: OPIcQuestion 코드 포맷팅

* style: OPIcSession 코드 포맷팅

* style: OPIcRepository 코드 포맷팅

* style: FeedbackService 코드 포맷팅

* style: TranscribeProxyService 코드 포맷팅

* style: VocabularyConfig 코드 포맷팅

* style: DailyStudyCommandService 코드 포맷팅

* style: TestCommandService 코드 포맷팅

* style: TestService 코드 포맷팅

* style: CommonErrorCodeSpec 코드 포맷팅

* style: JsonUtilSpec 코드 포맷팅

* style: BadgeTypeSpec 코드 포맷팅

* style: ChattingErrorCodeSpec 코드 포맷팅

* style: GrammarLevelSpec 코드 포맷팅

* style: GrammarErrorCodeSpec 코드 포맷팅

* style: VocabularyErrorCodeSpec 코드 포맷팅

* feature : OPIc 세션관리 + 답변 처리 파이프라인 구현  (#413)

* feat : OPIc 질문 & 세션 관련 dto 생성

* refactor : @DynamoDbBean 주석 추가

* feat : 주제 + 소주제 + 레벨로 오픽 질문 조회 추가

* feat : OPIc 세션, 질문, 답변 종합 handler 구현

* feat : 오픽 주제, 소주제별 seed 데이터 추가

* refactor : Transcribe API KEY 환경변수명 수정

* refactor : Bedrock에 사용하는 클로드 모델 변경

* refactor : S3 Key 대신 Proxy에서 요청하는 Base64 값으로 변환

* feat: GAME_START, ROUND_END 메시지에 serverTime 추가

- broadcastGameStart(): serverTime, roundDuration 필드 추가
- broadcastRoundEnd(): serverTime, roundStartTime, roundDuration 필드 추가
- GameService.endRound(): data에 roundStartTime, roundDuration 포함
- 타이머 동기화 버그 수정을 위한 서버 시간 제공

* feat: WebSocketMessageHelper 유틸리티 클래스 추가

- domain 필드 포함 메시지 생성 헬퍼
- DOMAIN_CHAT, DOMAIN_GAME 상수 정의
- buildChatMessage(), buildGameMessage() 메서드

* feat: 모든 WebSocket 메시지에 domain 필드 추가

- ScoreUpdateMessage에 domain 필드 추가
- broadcastGameStart에 domain:"game" 추가
- broadcastRoundEnd에 domain:"game" 추가
- broadcastCorrectAnswerMessage에 domain:"game" 추가
- handleCommandResult 시스템 메시지에 domain:"game" 추가
- handleRegularMessage 채팅 메시지에 domain:"chat" 추가

Closes #426, #427

* feat: GameSession 모델 클래스 생성

- DynamoDB Enhanced Client 어노테이션 적용
- GSI1: roomId로 활성 게임 세션 조회 가능
- 게임 상태 관리용 헬퍼 메서드 포함

Closes #428

* feat: GameSessionRepository 구현

- 기본 CRUD (save, findById, delete)
- roomId로 활성/전체 게임 세션 조회
- 상태, 라운드, 점수 업데이트 메서드
- 정답자 추가, 힌트 사용, 게임 종료 처리

Closes #429

* refactor: ChatRoom에서 게임 필드 분리

- 게임 관련 필드 제거 (gameStatus, currentRound 등)
- activeGameSessionId 필드 추가
- 게임 상태는 GameSession으로 분리됨

Note: 의존 코드 수정은 #431에서 진행

Closes #430

* refactor: GameSession 기반으로 전체 게임 로직 리팩토링

- GameService: ChatRoom 대신 GameSession 사용
- GameStatsService: GameSession 매개변수로 변경
- CommandService: GameSession 기반 점수 조회
- GameHandler: GameSession 기반 REST API
- WebSocketMessageHandler: GameSession 기반 브로드캐스트
- GameStatusResponse, ScoreboardResponse: GameSession 매개변수

Closes #431

* feat: GameSessionHandler Lambda 및 게임 세션 API 구현

- POST /rooms/{roomId}/games - 게임 세션 생성
- GET /games/{gameSessionId} - 게임 상태 조회 (재접속용)
- POST /games/{gameSessionId}/start - 게임 시작
- POST /games/{gameSessionId}/stop - 게임 종료

모든 응답에 serverTime 포함 (타이머 동기화)
출제자에게만 currentWord 포함

Closes #432, #433

* feat: 게임 시작 7분 후 자동 종료 기능 구현

- GameConfig에 gameTimeLimit() 메서드 추가 (기본값: 420초)
- GameSchedulerClient 유틸리티 클래스 생성 (EventBridge Scheduler 연동)
- GameService에 스케줄 생성/취소 로직 추가
- GameAutoCloseHandler Lambda 함수 생성
- template.yaml에 Lambda, IAM Role, Schedule Group 추가

Closes #417

* fix : 메모리 증가 및 Lambda 응답 제한 시간 Cognito 트리거 제한시간과 동일하게 수정 (#439)

* feat: 캐치마인드 게임 방 분리 기능 구현 (#455)

- Room 타입 분리 (CHAT/GAME)
  - RoomType, RoomStatus enum 추가
  - ChatRoom 모델에 type, gameType, gameSettings, status, hostId 필드 추가
  - GameSettings 모델 추가

- 방 생성/조회 API 수정
  - CreateRoomRequest에 type, gameType, gameSettings 필드 추가
  - 방 목록 조회 시 type, gameType, status 필터 지원

- 게임 시작 조건 검증
  - GAME 타입 방에서만 게임 시작 가능 (GAME_007 에러)

- 게임 재시작 API 구현 (#452)
  - POST /rooms/{roomId}/game/restart 엔드포인트 추가
  - 방장만 재시작 가능 (GAME_009 에러)
  - 게임 진행 중 재시작 불가 (GAME_008 에러)

- 방장 변경 로직 구현 (#453)
  - 방장 퇴장 시 다음 멤버에게 자동 이전
  - 모든 멤버 퇴장 시 방 자동 삭제

- WebSocket 메시지 타입 추가 (#454)
  - ROOM_STATUS_CHANGE, HOST_CHANGE 메시지 타입 추가
  - WebSocketMessageHelper에 빌더 메서드 추가

- 테스트 추가
  - RoomType, RoomStatus enum 테스트
  - GameSettings 모델 테스트
  - ChattingErrorCode 테스트 업데이트

Related: #440, #441, #442, #443, #444, #445, #446
Closes: #447, #448, #449, #450, #451, #452, #453, #454

* feat: 참가자 닉네임 및 방장 변경 WebSocket 알림 구현 (#456)

- RoomParticipant DTO 추가 (userId, nickname, isHost)
- ChatRoomQueryService에 닉네임 조회 메서드 추가
  - getParticipantsWithNicknames(): 참가자 목록 + 닉네임
  - getHostNickname(): 방장 닉네임 조회
- ChatRoomHandler.getRoom() 응답에 participants, hostNickname 추가
- ChatRoomCommandService.leaveRoom()에서 방장 변경 시 WebSocket 브로드캐스트

Related: #440

* fix: ChatRoomFunction에 UserTable DynamoDB 권한 추가

- 참가자/방장 닉네임 조회를 위한 UserTable 읽기 권한 추가
- DynamoDBReadPolicy로 UserTable 접근 허용

Fixes #457

* fix: GameSettings에 @DynamoDbBean 어노테이션 추가

- DynamoDB Enhanced Client가 중첩 객체를 직렬화/역직렬화할 수 있도록 수정
- ChatRoom 저장/조회 시 GameSettings 변환 오류 해결

Fixes #457

* fix: ChatRoomFunction에 WEBSOCKET_ENDPOINT 환경변수 및 권한 추가

- leaveRoom에서 WebSocketBroadcaster 사용을 위한 환경변수 추가
- execute-api:ManageConnections 권한 추가

* fix: WebSocket Lambda 함수들에 WEBSOCKET_ENDPOINT 환경변수 추가

- WebSocketConnectFunction에 WEBSOCKET_ENDPOINT 추가
- WebSocketDisconnectFunction에 WEBSOCKET_ENDPOINT 추가
- execute-api:ManageConnections 권한 추가

* fix: Grammar WebSocket Lambda 환경 변수 및 권한 추가

- GrammarStreamingConnectFunction에 WEBSOCKET_ENDPOINT 환경 변수 추가
- GrammarStreamingDisconnectFunction에 WEBSOCKET_ENDPOINT 환경 변수 추가
- 두 함수에 execute-api:ManageConnections 권한 추가

* feat: GSI1SK 확장성 있는 재설계 및 DB 레벨 필터링

## 변경 사항

### GSI1SK 포맷 변경
- 기존: {level}#{createdAt}
- 신규: {type}#{gameType}#{status}#{level}#{createdAt}

### 지원 쿼리 패턴
- 전체 방: GSI1PK = "ROOMS"
- 게임방만: begins_with(GSI1SK, "GAME#")
- 캐치마인드만: begins_with(GSI1SK, "GAME#CATCHMIND#")
- 대기중 캐치마인드: begins_with(GSI1SK, "GAME#CATCHMIND#WAITING#")

### 파일 수정
- ChatRoomCommandService.java: 방 생성 시 새 GSI1SK 포맷 적용
- ChatRoomRepository.java: findByFilters() 메서드 추가, updateStatus() 메서드 추가
- ChatRoomQueryService.java: 메모리 필터링 제거, DB 레벨 필터링으로 변경
- GameService.java: 게임 시작/종료 시 방 상태 업데이트 (GSI1SK 포함)

### 마이그레이션
- scripts/migrate-gsi1sk.sh: 기존 데이터 마이그레이션 스크립트
- 37개 기존 방 마이그레이션 완료

* fix: increase stats query limit to 100 days

- Adjust maximum allowable limit for recent stats query from 30 to 100 days to support extended data range responses.

* feat: improve game round and connection management logic

- Added handling for game round timeout (`ROUND_TIMEOUT`) in WebSocketMessageHandler.
- Enhanced game start broadcast to include `currentWord` for the drawer only.
- Updated ConnectionRepository to remove duplicate user connections in the same room.
- Added `currentWordEnglish` to GameSession for better answer verification.
- Normalized ChatRoom levels to match database storage format.
- Updated template.yaml to include DynamoDBReadPolicy for VocabTable.

* refactor: 코드 정리 및 미사용 클래스 제거 (#459)

* refactor: remove unused WebSocketResponseUtil

* refactor: add AutoCloseable to WebSocketBroadcaster

* refactor: remove unused TestService

* refactor: remove unused WordService

* refactor: remove unused DailyStudyService

* refactor: remove unused UserWordService

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* fix: resolve N+1 query in StatsService

* refactor(all): DI 패턴 및 전략 패턴 적용 (#461)

- Repository, Service, Handler에 DI 생성자 추가 (테스트 용이성)
- BadgeService에 Strategy 패턴 적용 (뱃지 조건 검증 로직 분리)

* refactor: relocate and restructure seed data files

- Moved `question-homes.json` and `words.json` from subdirectories to `seed` folder.
- Updated file paths for better organization and clarity.

* chore: seed 데이터 폴더 구조 정리

* feat: add CI/CD pipeline configuration for CodePipeline

* fix: add SNS topic policy and DependsOn for notification rule

* fix: correct paths in buildspec.yml for CodeBuild

* fix: remove hardcoded JAVA_HOME, use runtime default

* fix: add gradle wrapper for CI/CD build

* fix: use single line sam package command with hardcoded bucket

* fix: use existing stack name group2-englishstudy-chatting

* fix: add missing WEBSOCKET_ENDPOINT env var to WebSocket connect functions

* docs: update FRONTEND-API-GUIDE with new RoomType/RoomStatus structure

* feat : WebSocket Connect, Disconnect 핸들러 & SpeakingConnecion 모델 구현

* feat : WebSocket 메시지 처리 handler, service 구현

* feat : WebSocket 연결 정보 Repository 구현

* fix: update WebSocketDisconnectHandler to use GameSession model

- Remove references to deleted ChatRoom game fields
- Use GameSessionRepository to finish active game sessions
- Use ChatRoomRepository.updateStatus() for room state management

* perf: optimize CI/CD build time

- Add pip cache for SAM CLI dependencies
- Enable Gradle parallel builds and build cache
- Add SAM build cache (.aws-sam)
- Use sam build --parallel --cached
- Skip SAM CLI install if already cached
- Remove unnecessary 'clean' to leverage cache

* feat: add custom CodeBuild Docker image with pre-installed tools

- Dockerfile with Java 21 + SAM CLI + Gradle pre-installed
- build-and-push.sh script for ECR deployment
- Updated buildspec.yml for custom image (removes SAM CLI install)
- Expected build time reduction: ~30-40 seconds

* feature : AI 영어 회화 연습 기능 (#468)

* feat : WebSocket Connect, Disconnect 핸들러 & SpeakingConnecion 모델 구현

* feat : WebSocket 메시지 처리 handler, service 구현

* feat : WebSocket 연결 정보 Repository 구현

* fix: remove typo in SpeakingConnectionRepository

* fix : 오타 수정

* chore: trigger build test with custom Docker image

* chore: remove unnecessary newlines and whitespace across WebSocket handlers and related classes

* chore: remove unnecessary newlines and whitespace across WebSocket handlers and related classes

* Release: 캐치마인드 게임 분리, AI 회화 연습, CI/CD 파이프라인 (#469)

* feature : OPIc 세션관리 + 답변 처리 파이프라인 구현  (#413)

* feat : OPIc 질문 & 세션 관련 dto 생성

* refactor : @DynamoDbBean 주석 추가

* feat : 주제 + 소주제 + 레벨로 오픽 질문 조회 추가

* feat : OPIc 세션, 질문, 답변 종합 handler 구현

* feat : 오픽 주제, 소주제별 seed 데이터 추가

* refactor : Transcribe API KEY 환경변수명 수정

* refactor : Bedrock에 사용하는 클로드 모델 변경

* refactor : S3 Key 대신 Proxy에서 요청하는 Base64 값으로 변환

* feat: GAME_START, ROUND_END 메시지에 serverTime 추가

- broadcastGameStart(): serverTime, roundDuration 필드 추가
- broadcastRoundEnd(): serverTime, roundStartTime, roundDuration 필드 추가
- GameService.endRound(): data에 roundStartTime, roundDuration 포함
- 타이머 동기화 버그 수정을 위한 서버 시간 제공

* feat: WebSocketMessageHelper 유틸리티 클래스 추가

- domain 필드 포함 메시지 생성 헬퍼
- DOMAIN_CHAT, DOMAIN_GAME 상수 정의
- buildChatMessage(), buildGameMessage() 메서드

* feat: 모든 WebSocket 메시지에 domain 필드 추가

- ScoreUpdateMessage에 domain 필드 추가
- broadcastGameStart에 domain:"game" 추가
- broadcastRoundEnd에 domain:"game" 추가
- broadcastCorrectAnswerMessage에 domain:"game" 추가
- handleCommandResult 시스템 메시지에 domain:"game" 추가
- handleRegularMessage 채팅 메시지에 domain:"chat" 추가

Closes #426, #427

* feat: GameSession 모델 클래스 생성

- DynamoDB Enhanced Client 어노테이션 적용
- GSI1: roomId로 활성 게임 세션 조회 가능
- 게임 상태 관리용 헬퍼 메서드 포함

Closes #428

* feat: GameSessionRepository 구현

- 기본 CRUD (save, findById, delete)
- roomId로 활성/전체 게임 세션 조회
- 상태, 라운드, 점수 업데이트 메서드
- 정답자 추가, 힌트 사용, 게임 종료 처리

Closes #429

* refactor: ChatRoom에서 게임 필드 분리

- 게임 관련 필드 제거 (gameStatus, currentRound 등)
- activeGameSessionId 필드 추가
- 게임 상태는 GameSession으로 분리됨

Note: 의존 코드 수정은 #431에서 진행

Closes #430

* refactor: GameSession 기반으로 전체 게임 로직 리팩토링

- GameService: ChatRoom 대신 GameSession 사용
- GameStatsService: GameSession 매개변수로 변경
- CommandService: GameSession 기반 점수 조회
- GameHandler: GameSession 기반 REST API
- WebSocketMessageHandler: GameSession 기반 브로드캐스트
- GameStatusResponse, ScoreboardResponse: GameSession 매개변수

Closes #431

* feat: GameSessionHandler Lambda 및 게임 세션 API 구현

- POST /rooms/{roomId}/games - 게임 세션 생성
- GET /games/{gameSessionId} - 게임 상태 조회 (재접속용)
- POST /games/{gameSessionId}/start - 게임 시작
- POST /games/{gameSessionId}/stop - 게임 종료

모든 응답에 serverTime 포함 (타이머 동기화)
출제자에게만 currentWord 포함

Closes #432, #433

* feat: 게임 시작 7분 후 자동 종료 기능 구현

- GameConfig에 gameTimeLimit() 메서드 추가 (기본값: 420초)
- GameSchedulerClient 유틸리티 클래스 생성 (EventBridge Scheduler 연동)
- GameService에 스케줄 생성/취소 로직 추가
- GameAutoCloseHandler Lambda 함수 생성
- template.yaml에 Lambda, IAM Role, Schedule Group 추가

Closes #417

* fix : 메모리 증가 및 Lambda 응답 제한 시간 Cognito 트리거 제한시간과 동일하게 수정 (#439)

* feat: 캐치마인드 게임 방 분리 기능 구현 (#455)

- Room 타입 분리 (CHAT/GAME)
  - RoomType, RoomStatus enum 추가
  - ChatRoom 모델에 type, gameType, gameSettings, status, hostId 필드 추가
  - GameSettings 모델 추가

- 방 생성/조회 API 수정
  - CreateRoomRequest에 type, gameType, gameSettings 필드 추가
  - 방 목록 조회 시 type, gameType, status 필터 지원

- 게임 시작 조건 검증
  - GAME 타입 방에서만 게임 시작 가능 (GAME_007 에러)

- 게임 재시작 API 구현 (#452)
  - POST /rooms/{roomId}/game/restart 엔드포인트 추가
  - 방장만 재시작 가능 (GAME_009 에러)
  - 게임 진행 중 재시작 불가 (GAME_008 에러)

- 방장 변경 로직 구현 (#453)
  - 방장 퇴장 시 다음 멤버에게 자동 이전
  - 모든 멤버 퇴장 시 방 자동 삭제

- WebSocket 메시지 타입 추가 (#454)
  - ROOM_STATUS_CHANGE, HOST_CHANGE 메시지 타입 추가
  - WebSocketMessageHelper에 빌더 메서드 추가

- 테스트 추가
  - RoomType, RoomStatus enum 테스트
  - GameSettings 모델 테스트
  - ChattingErrorCode 테스트 업데이트

Related: #440, #441, #442, #443, #444, #445, #446
Closes: #447, #448, #449, #450, #451, #452, #453, #454

* feat: 참가자 닉네임 및 방장 변경 WebSocket 알림 구현 (#456)

- RoomParticipant DTO 추가 (userId, nickname, isHost)
- ChatRoomQueryService에 닉네임 조회 메서드 추가
  - getParticipantsWithNicknames(): 참가자 목록 + 닉네임
  - getHostNickname(): 방장 닉네임 조회
- ChatRoomHandler.getRoom() 응답에 participants, hostNickname 추가
- ChatRoomCommandService.leaveRoom()에서 방장 변경 시 WebSocket 브로드캐스트

Related: #440

* fix: ChatRoomFunction에 UserTable DynamoDB 권한 추가

- 참가자/방장 닉네임 조회를 위한 UserTable 읽기 권한 추가
- DynamoDBReadPolicy로 UserTable 접근 허용

Fixes #457

* fix: GameSettings에 @DynamoDbBean 어노테이션 추가

- DynamoDB Enhanced Client가 중첩 객체를 직렬화/역직렬화할 수 있도록 수정
- ChatRoom 저장/조회 시 GameSettings 변환 오류 해결

Fixes #457

* fix: ChatRoomFunction에 WEBSOCKET_ENDPOINT 환경변수 및 권한 추가

- leaveRoom에서 WebSocketBroadcaster 사용을 위한 환경변수 추가
- execute-api:ManageConnections 권한 추가

* fix: WebSocket Lambda 함수들에 WEBSOCKET_ENDPOINT 환경변수 추가

- WebSocketConnectFunction에 WEBSOCKET_ENDPOINT 추가
- WebSocketDisconnectFunction에 WEBSOCKET_ENDPOINT 추가
- execute-api:ManageConnections 권한 추가

* fix: Grammar WebSocket Lambda 환경 변수 및 권한 추가

- GrammarStreamingConnectFunction에 WEBSOCKET_ENDPOINT 환경 변수 추가
- GrammarStreamingDisconnectFunction에 WEBSOCKET_ENDPOINT 환경 변수 추가
- 두 함수에 execute-api:ManageConnections 권한 추가

* feat: GSI1SK 확장성 있는 재설계 및 DB 레벨 필터링

## 변경 사항

### GSI1SK 포맷 변경
- 기존: {level}#{createdAt}
- 신규: {type}#{gameType}#{status}#{level}#{createdAt}

### 지원 쿼리 패턴
- 전체 방: GSI1PK = "ROOMS"
- 게임방만: begins_with(GSI1SK, "GAME#")
- 캐치마인드만: begins_with(GSI1SK, "GAME#CATCHMIND#")
- 대기중 캐치마인드: begins_with(GSI1SK, "GAME#CATCHMIND#WAITING#")

### 파일 수정
- ChatRoomCommandService.java: 방 생성 시 새 GSI1SK 포맷 적용
- ChatRoomRepository.java: findByFilters() 메서드 추가, updateStatus() 메서드 추가
- ChatRoomQueryService.java: 메모리 필터링 제거, DB 레벨 필터링으로 변경
- GameService.java: 게임 시작/종료 시 방 상태 업데이트 (GSI1SK 포함)

### 마이그레이션
- scripts/migrate-gsi1sk.sh: 기존 데이터 마이그레이션 스크립트
- 37개 기존 방 마이그레이션 완료

* fix: increase stats query limit to 100 days

- Adjust maximum allowable limit for recent stats query from 30 to 100 days to support extended data range responses.

* feat: improve game round and connection management logic

- Added handling for game round timeout (`ROUND_TIMEOUT`) in WebSocketMessageHandler.
- Enhanced game start broadcast to include `currentWord` for the drawer only.
- Updated ConnectionRepository to remove duplicate user connections in the same room.
- Added `currentWordEnglish` to GameSession for better answer verification.
- Normalized ChatRoom levels to match database storage format.
- Updated template.yaml to include DynamoDBReadPolicy for VocabTable.

* refactor: 코드 정리 및 미사용 클래스 제거 (#459)

* refactor: remove unused WebSocketResponseUtil

* refactor: add AutoCloseable to WebSocketBroadcaster

* refactor: remove unused TestService

* refactor: remove unused WordService

* refactor: remove unused DailyStudyService

* refactor: remove unused UserWordService

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* fix: resolve N+1 query in StatsService

* refactor(all): DI 패턴 및 전략 패턴 적용 (#461)

- Repository, Service, Handler에 DI 생성자 추가 (테스트 용이성)
- BadgeService에 Strategy 패턴 적용 (뱃지 조건 검증 로직 분리)

* refactor: relocate and restructure seed data files

- Moved `question-homes.json` and `words.json` from subdirectories to `seed` folder.
- Updated file paths for better organization and clarity.

* chore: seed 데이터 폴더 구조 정리

* feat: add CI/CD pipeline configuration for CodePipeline

* fix: add SNS topic policy and DependsOn for notification rule

* fix: correct paths in buildspec.yml for CodeBuild

* fix: remove hardcoded JAVA_HOME, use runtime default

* fix: add gradle wrapper for CI/CD build

* fix: use single line sam package command with hardcoded bucket

* fix: use existing stack name group2-englishstudy-chatting

* fix: add missing WEBSOCKET_ENDPOINT env var to WebSocket connect functions

* docs: update FRONTEND-API-GUIDE with new RoomType/RoomStatus structure

* fix: update WebSocketDisconnectHandler to use GameSession model

- Remove references to deleted ChatRoom game fields
- Use GameSessionRepository to finish active game sessions
- Use ChatRoomRepository.updateStatus() for room state management

* perf: optimize CI/CD build time

- Add pip cache for SAM CLI dependencies
- Enable Gradle parallel builds and build cache
- Add SAM build cache (.aws-sam)
- Use sam build --parallel --cached
- Skip SAM CLI install if already cached
- Remove unnecessary 'clean' to leverage cache

* feat: add custom CodeBuild Docker image with pre-installed tools

- Dockerfile with Java 21 + SAM CLI + Gradle pre-installed
- build-and-push.sh script for ECR deployment
- Updated buildspec.yml for custom image (removes SAM CLI install)
- Expected build time reduction: ~30-40 seconds

* feature : AI 영어 회화 연습 기능 (#468)

* feat : WebSocket Connect, Disconnect 핸들러 & SpeakingConnecion 모델 구현

* feat : WebSocket 메시지 처리 handler, service 구현

* feat : WebSocket 연결 정보 Repository 구현

* fix: remove typo in SpeakingConnectionRepository

* chore: trigger build test with custom Docker image

* chore: remove unnecessary newlines and whitespace across WebSocket handlers and related classes

* chore: remove unnecessary newlines and whitespace across WebSocket handlers and related classes

---------

Co-authored-by: hyein Heo <128613248+hye-inA@users.noreply.github.com>

* refactor : websocket -> rest api 전환

* feat : speaking handler REST로 교체

* feat : speaking 관련 dto 생성

* refacotor : 기존 service 코드 로직 재사용 및 repository 리펙토링

* fix: add CORS headers to API Gateway error responses (#479)

API Gateway의 인증 실패 등 에러 응답에 CORS 헤더가 누락되어
CloudFront를 통한 프론트엔드 요청이 차단되는 문제 수정

- UNAUTHORIZED (401) 응답에 CORS 헤더 추가
- ACCESS_DENIED (403) 응답에 CORS 헤더 추가
- DEFAULT_4XX/5XX 응답에 CORS 헤더 추가
- EXPIRED_TOKEN 응답에 CORS 헤더 추가

* feat(news): 뉴스 도메인 기반 구조 구축 (#385)

- NewsCategory, QuizType enum 추가
- NewsKey 상수 클래스 추가
- NewsErrorCode 예외 클래스 추가
- NewsArticle, KeywordInfo, QuizQuestion 모델 추가
- NewsArticleRepository CRUD 구현
- NewsTable DynamoDB 테이블 정의
- CORS GatewayResponses 설정 추가

* feat(news): 뉴스 수집 파이프라인 구현 (#386)

- NewsApiClient: NewsAPI 연동 서비스
- RssFeedParser: RSS 피드 파싱 (BBC, VOA, NPR)
- NewsDuplicateChecker: URL 기반 중복 필터링
- NewsCollectorService: 수집 오케스트레이션
- NewsCollectionHandler: Lambda 핸들러
- EventBridge 스케줄러: 매일 18시 KST 실행

* refactor(news): NewsAPI 제거, RSS만 사용

- NewsApiClient 삭제
- SSM Parameter 의존성 제거
- RSS 소스당 7개씩 수집 (BBC, VOA, NPR = 약 21개/일)

* feat(news): AI 뉴스 분석 시스템 구현 (#387)

- NewsAnalysisService: AI 분석 통합 서비스
  - Bedrock: CEFR 난이도 분석 (A1~C2)
  - Bedrock: 3줄 요약 + 퀴즈 3문제 생성
  - Comprehend: 핵심 키워드 추출
- NewsCollectorService: 수집 시 자동 분석 연동
- GSI1/GSI2 키 자동 설정 (레벨별, 카테고리별 조회)

* feat(news): 뉴스 학습 API 구현 (#388)

- NewsQueryService: 뉴스 조회 서비스
- NewsHandler: API 핸들러
  - GET /news - 목록 조회 (level, category 필터)
  - GET /news/today - 오늘의 뉴스
  - GET /news/recommended - 내 레벨 맞춤 추천
  - GET /news/{articleId} - 상세 조회 (조회수 증가)
- template.yaml: NewsFunction Lambda 추가

* feat(news): 뉴스 학습 부가 기능 구현 (#389)

- 읽기 완료 기록 API (POST /news/{articleId}/read)
- 북마크 토글 API (POST /news/{articleId}/bookmark)
- 북마크 목록 조회 API (GET /news/bookmarks)
- 학습 통계 조회 API (GET /news/stats)
- TTS 오디오 URL 조회 API (GET /news/{articleId}/audio)
- UserNewsRecord 모델 추가
- UserNewsRepository 추가
- NewsLearningService 추가

* feat(news): 복합 퀴즈 시스템 구현 (#471)

- 퀴즈 조회 API (GET /news/{articleId}/quiz)
- 퀴즈 제출 API (POST /news/{articleId}/quiz)
- 퀴즈 기록 조회 API (GET /news/quiz/history)
- NewsQuizResult 모델 추가
- QuizAnswerResult 모델 추가
- NewsQuizRepository 추가
- NewsQuizService 추가

* feat(news): 단어 수집 & Vocabulary 연동 구현 (#472)

- 단어 수집 API (POST /news/{articleId}/words)
- 수집 단어 목록 API (GET /news/words)
- 단어 상세 조회 API (GET /news/{articleId}/words/{word})
- 단어 삭제 API (DELETE /news/{articleId}/words/{word})
- Vocabulary 연동 API (POST /news/words/{word}/sync)
- NewsWordCollect 모델 추가
- NewsWordRepository 추가
- NewsWordService 추가

* feat: add multi-environment deployment support (dev/test/prod)

* fix: update buildspec.yml to deploy prod environment with parameter overrides

* feat(news): 뉴스 도메인 기반 구조 구축 (#385)

- NewsCategory, QuizType enum 추가
- NewsKey 상수 클래스 추가
- NewsErrorCode 예외 클래스 추가
- NewsArticle, KeywordInfo, QuizQuestion 모델 추가
- NewsArticleRepository CRUD 구현
- NewsTable DynamoDB 테이블 정의
- CORS GatewayResponses 설정 추가

* feat(news): 뉴스 수집 파이프라인 구현 (#386)

- NewsApiClient: NewsAPI 연동 서비스
- RssFeedParser: RSS 피드 파싱 (BBC, VOA, NPR)
- NewsDuplicateChecker: URL 기반 중복 필터링
- NewsCollectorService: 수집 오케스트레이션
- NewsCollectionHandler: Lambda 핸들러
- EventBridge 스케줄러: 매일 18시 KST 실행

* refactor(news): NewsAPI 제거, RSS만 사용

- NewsApiClient 삭제
- SSM Parameter 의존성 제거
- RSS 소스당 7개씩 수집 (BBC, VOA, NPR = 약 21개/일)

* feat(news): AI 뉴스 분석 시스템 구현 (#387)

- NewsAnalysisService: AI 분석 통합 서비스
  - Bedrock: CEFR 난이도 분석 (A1~C2)
  - Bedrock: 3줄 요약 + 퀴즈 3문제 생성
  - Comprehend: 핵심 키워드 추출
- NewsCollectorService: 수집 시 자동 분석 연동
- GSI1/GSI2 키 자동 설정 (레벨별, 카테고리별 조회)

* feat(news): 뉴스 학습 API 구현 (#388)

- NewsQueryService: 뉴스 조회 서비스
- NewsHandler: API 핸들러
  - GET /news - 목록 조회 (level, category 필터)
  - GET /news/today - 오늘의 뉴스
  - GET /news/recommended - 내 레벨 맞춤 추천
  - GET /news/{articleId} - 상세 조회 (조회수 증가)
- template.yaml: NewsFunction Lambda 추가

* feat(news): 뉴스 학습 부가 기능 구현 (#389)

- 읽기 완료 기록 API (POST /news/{articleId}/read)
- 북마크 토글 API (POST /news/{articleId}/bookmark)
- 북마크 목록 조회 API (GET /news/bookmarks)
- 학습 통계 조회 API (GET /news/stats)
- TTS 오디오 URL 조회 API (GET /news/{articleId}/audio)
- UserNewsRecord 모델 추가
- UserNewsRepository 추가
- NewsLearningService 추가

* feat(news): 복합 퀴즈 시스템 구현 (#471)

- 퀴즈 조회 API (GET /news/{articleId}/quiz)
- 퀴즈 제출 API (POST /news/{articleId}/quiz)
- 퀴즈 기록 조회 API (GET /news/quiz/history)
- NewsQuizResult 모델 추가
- QuizAnswerResult 모델 추가
- NewsQuizRepository 추가
- NewsQuizService 추가

* feat(news): 단어 수집 & Vocabulary 연동 구현 (#472)

- 단어 수집 API (POST /news/{articleId}/words)
- 수집 단어 목록 API (GET /news/words)
- 단어 상세 조회 API (GET /news/{articleId}/words/{word})
- 단어 삭제 API (DELETE /news/{articleId}/words/{word})
- Vocabulary 연동 API (POST /news/words/{word}/sync)
- NewsWordCollect 모델 추가
- NewsWordRepository 추가
- NewsWordService 추가

* feat: add multi-environment deployment support (dev/test/prod)

* fix: update buildspec.yml to deploy prod environment with parameter overrides

* refactor : AI 말하기 Websocket 구현 -> REST API 구현으로 리팩토링 (#490)

* feat : WebSocket Connect, Disconnect 핸들러 & SpeakingConnecion 모델 구현

* feat : WebSocket 메시지 처리 handler, service 구현

* feat : WebSocket 연결 정보 Repository 구현

* fix : 오타 수정

* refactor : websocket -> rest api 전환

* feat : speaking handler REST로 교체

* feat : speaking 관련 dto 생성

* refacotor : 기존 service 코드 로직 재사용 및 repository 리펙토링

* fix: revert buildspec.yml to build-only for CloudFormation deploy stage

* fix: revert buildspec.yml to build-only for CloudFormation deploy stage

* fix: update all API Gateway StageName to use Environment parameter

* fix: correct VocabularyTable and ContentBucket references in NewsFunction

* fix: correct VocabularyTable and ContentBucket references in NewsFunction

* fix: add stack name prefix to GameScheduleGroup and daily-stats schedule to avoid conflicts

* fix: add stack name prefix to GameScheduleGroup and daily-stats schedule to avoid conflicts

* feat: add support for existing Cognito User Pool reuse across environments

* fix: add conditional Cognito ARN reference in API Gateway Authorizer

* fix: remove Cognito resources completely, use existing Cognito only

* fix: remove Cognito resources completely, use existing Cognito only

* feat : speaking rest API 람다 함수 추가

* feat: add S3 bucket resource and fix environment-specific endpoints

- Add ContentBucket S3 resource for content storage
- Replace hardcoded /dev with ${Environment} in all WebSocket endpoints
- Update Output URLs to use dynamic environment stage

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* fix: add stack name prefix to news-collection schedule name

Prevent EventBridge rule name conflicts across environments

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* fix: add X-Requested-With and Accept headers to CORS config

Enable additional headers for CloudFront CORS compatibility

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* fix: use environment variable for S3 bucket URLs

Replace hardcoded bucket name with BUCKET_NAME env var for multi-env support:
- PreSignUpHandler: dynamic default profile URL
- PostConfirmationHandler: dynamic default profile URL
- UserService: dynamic default profile URL
- BadgeType: dynamic badge image base URL

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* fix: disable authorizer for CORS preflight requests

Add AddDefaultAuthorizerToCorsPreflight: false to prevent
Cognito Authorizer from blocking OPTIONS requests

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* feat : speaking REST API 람다 함수 추가  (#491)

* feature : OPIc 세션관리 + 답변 처리 파이프라인 구현  (#413)

* feat : OPIc 질문 & 세션 관련 dto 생성

* refactor : @DynamoDbBean 주석 추가

* feat : 주제 + 소주제 + 레벨로 오픽 질문 조회 추가

* feat : OPIc 세션, 질문, 답변 종합 handler 구현

* feat : 오픽 주제, 소주제별 seed 데이터 추가

* refactor : Transcribe API KEY 환경변수명 수정

* refactor : Bedrock에 사용하는 클로드 모델 변경

* refactor : S3 Key 대신 Proxy에서 요청하는 Base64 값으로 변환

* feat: GAME_START, ROUND_END 메시지에 serverTime 추가

- broadcastGameStart(): serverTime, roundDuration 필드 추가
- broadcastRoundEnd(): serverTime, roundStartTime, roundDuration 필드 추가
- GameService.endRound(): data에 roundStartTime, roundDuration 포함
- 타이머 동기화 버그 수정을 위한 서버 시간 제공

* feat: WebSocketMessageHelper 유틸리티 클래스 추가

- domain 필드 포함 메시지 생성 헬퍼
- DOMAIN_CHAT, DOMAIN_GAME 상수 정의
- buildChatMessage(), buildGameMessage() 메서드

* feat: 모든 WebSocket 메시지에 domain 필드 추가

- ScoreUpdateMessage에 domain 필드 추가
- broadcastGameStart에 domain:"game" 추가
- broadcastRoundEnd에 domain:"game" 추가
- broadcastCorrectAnswerMessage에 domain:"game" 추가
- handleCommandResult 시스템 메시지에 domain:"game" 추가
- handleRegularMessage 채팅 메시지에 domain:"chat" 추가

Closes #426, #427

* feat: GameSession 모델 클래스 생성

- DynamoDB Enhanced Client 어노테이션 적용
- GSI1: roomId로 활성 게임 세션 조회 가능
- 게임 상태 관리용 헬퍼 메서드 포함

Closes #428

* feat: GameSessionRepository 구현

- 기본 CRUD (save, findById, delete)
- roomId로 활성/전체 게임 세션 조회
- 상태, 라운드, 점수 업데이트 메서드
- 정답자 추가, 힌트 사용, 게임 종료 처리

Closes #429

* refactor: ChatRoom에서 게임 필드 분리

- 게임 관련 필드 제거 (gameStatus, currentRound 등)
- activeGameSessionId 필드 추가
- 게임 상태는 GameSession으로 분리됨

Note: 의존 코드 수정은 #431에서 진행

Closes #430

* refactor: GameSession 기반으로 전체 게임 로직 리팩토링

- GameService: ChatRoom 대신 GameSession 사용
- GameStatsService: GameSession 매개변수로 변경
- CommandService: GameSession 기반 점수 조회
- GameHandler: GameSession 기반 REST API
- WebSocketMessageHandler: GameSession 기반 브로드캐스트
- GameStatusResponse, ScoreboardResponse: GameSession 매개변수

Closes #431

* feat: GameSessionHandler Lambda 및 게임 세션 API 구현

- POST /rooms/{roomId}/games - 게임 세션 생성
- GET /games/{gameSessionId} - 게임 상태 조회 (재접속용)
- POST /games/{gameSessionId}/start - 게임 시작
- POST /games/{gameSessionId}/stop - 게임 종료

모든 응답에 serverTime 포함 (타이머 동기화)
출제자에게만 currentWord 포함

Closes #432, #433

* feat: 게임 시작 7분 후 자동 종료 기능 구현

- GameConfig에 gameTimeLimit() 메서드 추가 (기본값: 420초)
- GameSchedulerClient 유틸리티 클래스 생성 (EventBridge Scheduler 연동)
- GameService에 스케줄 생성/취소 로직 추가
- GameAutoCloseHandler Lambda 함수 생성
- template.yaml에 Lambda, IAM Role, Schedule Group 추가

Closes #417

* fix : 메모리 증가 및 Lambda 응답 제한 시간 Cognito 트리거 제한시간과 동일하게 수정 (#439)

* feat: 캐치마인드 게임 방 분리 기능 구현 (#455)

- Room 타입 분리 (CHAT/GAME)
  - RoomType, RoomStatus enum 추가
  - ChatRoom 모델에 type, gameType, gameSettings, status, hostId 필드 추가
  - GameSettings 모델 추가

- 방 생성/조회 API 수정
  - CreateRoomRequest에 type, gameType, gameSettings 필드 추가
  - 방 목록 조회 시 type, gameType, status 필터 지원

- 게임 시작 조건 검증
  - GAME 타입 방에서만 게임 시작 가능 (GAME_007 에러)

- 게임 재시작 API 구현 (#452)
  - POST /rooms/{roomId}/game/restart 엔드포인트 추가
  - 방장만 재시작 가능 (GAME_009 에러)
  - 게임 진행 중 재시작 불가 (GAME_008 에러)

- 방장 변경 로직 구현 (#453)
  - 방장 퇴장 시 다음 멤버에게 자동 이전
  - 모든 멤버 퇴장 시 방 자동 삭제

- WebSocket 메시지 타입 추가 (#454)
  - ROOM_STATUS_CHANGE, HOST_CHANGE 메시지 타입 추가
  - WebSocketMessageHelper에 빌더 메서드 추가

- 테스트 추가
  - RoomType, RoomStatus enum 테스트
  - GameSettings 모델 테스트
  - ChattingErrorCode 테스트 업데이트

Related: #440, #441, #442, #443, #444, #445, #446
Closes: #447, #448, #449, #450, #451, #452, #453, #454

* feat: 참가자 닉네임 및 방장 변경 WebSocket 알림 구현 (#456)

- RoomParticipant DTO 추가 (userId, nickname, isHost)
- ChatRoomQueryService에 닉네임 조회 메서드 추가
  - getParticipantsWithNicknames(): 참가자 목록 + 닉네임
  - getHostNickname(): 방장 닉네임 조회
- ChatRoomHandler.getRoom() 응답에 participants, hostNickname 추가
- ChatRoomCommandService.leaveRoom()에서 방장 변경 시 WebSocket 브로드캐스트

Related: #440

* fix: ChatRoomFunction에 UserTable DynamoDB 권한 추가

- 참가자/방장 닉네임 조회를 위한 UserTable 읽기 권한 추가
- DynamoDBReadPolicy로 UserTable 접근 허용

Fixes #457

* fix: GameSettings에 @DynamoDbBean 어노테이션 추가

- DynamoDB Enhanced Client가 중첩 객체를 직렬화/역직렬화할 수 있도록 수정
- ChatRoom 저장/조회 시 GameSettings 변환 오류 해결

Fixes #457

* fix: ChatRoomFunction에 WEBSOCKET_ENDPOINT 환경변수 및 권한 추가

- leaveRoom에서 WebSocketBroadcaster 사용을 위한 환경변수 추가
- execute-api:ManageConnections 권한 추가

* fix: WebSocket Lambda 함수들에 WEBSOCKET_ENDPOINT 환경변수 추가

- WebSocketConnectFunction에 WEBSOCKET_ENDPOINT 추가
- WebSocketDisconnectFunction에 WEBSOCKET_ENDPOINT 추가
- execute-api:ManageConnections 권한 추가

* fix: Grammar WebSocket Lambda 환경 변수 및 권한 추가

- GrammarStreamingConnectFunction에 WEBSOCKET_ENDPOINT 환경 변수 추가
- GrammarStreamingDisconnectFunction에 WEBSOCKET_ENDPOINT 환경 변수 추가
- 두 함수에 execute-api:ManageConnections 권한 추가

* feat: GSI1SK 확장성 있는 재설계 및 DB 레벨 필터링

- 기존: {level}#{createdAt}
- 신규: {type}#{gameType}#{status}#{level}#{createdAt}

- 전체 방: GSI1PK = "ROOMS"
- 게임방만: begins_with(GSI1SK, "GAME#")
- 캐치마인드만: begins_with(GSI1SK, "GAME#CATCHMIND#")
- 대기중 캐치마인드: begins_with(GSI1SK, "GAME#CATCHMIND#WAITING#")

- ChatRoomCommandService.java: 방 생성 시 새 GSI1SK 포맷 적용
- ChatRoomRepository.java: findByFilters() 메서드 추가, updateStatus() 메서드 추가
- ChatRoomQueryService.java: 메모리 필터링 제거, DB 레벨 필터링으로 변경
- GameService.java: 게임 시작/종료 시 방 상태 업데이트 (GSI1SK 포함)

- scripts/migrate-gsi1sk.sh: 기존 데이터 마이그레이션 스크립트
- 37개 기존 방 마이그레이션 완료

* fix: increase stats query limit to 100 days

- Adjust maximum allowable limit for recent stats query from 30 to 100 days to support extended data range responses.

* feat: improve game round and connection management logic

- Added handling for game round timeout (`ROUND_TIMEOUT`) in WebSocketMessageHandler.
- Enhanced game start broadcast to include `currentWord` for the drawer only.
- Updated ConnectionRepository to remove duplicate user connections in the same room.
- Added `currentWordEnglish` to GameSession for better answer verification.
- Normalized ChatRoom levels to match database storage format.
- Updated template.yaml to include DynamoDBReadPolicy for VocabTable.

* refactor: 코드 정리 및 미사용 클래스 제거 (#459)

* refactor: remove unused WebSocketResponseUtil

* refactor: add AutoCloseable to WebSocketBroadcaster

* refactor: remove unused TestService

* refactor: remove unused WordService

* refactor: remove unused DailyStudyService

* refactor: remove unused UserWordService

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* fix: resolve N+1 query in StatsService

* refactor(all): DI 패턴 및 전략 패턴 적용 (#461)

- Repository, Service, Handler에 DI 생성자 추가 (테스트 용이성)
- BadgeService에 Strategy 패턴 적용 (뱃지 조건 검증 로직 분리)

* refactor: relocate and restructure seed data files

- Moved `question-homes.json` and `words.json` from subdirectories to `seed` folder.
- Updated file paths for better organization and clarity.

* chore: seed 데이터 폴더 구조 정리

* feat: add CI/CD pipeline configuration for CodePipeline

* fix: add SNS topic policy and DependsOn for notification rule

* fix: correct paths in buildspec.yml for CodeBuild

* fix: remove hardcoded JAVA_HOME, use runtime default

* fix: add gradle wrapper for CI/CD build

* fix: use single line sam package command with hardcoded bucket

* fix: use existing stack name group2-englishstudy-chatting

* fix: add missing WEBSOCKET_ENDPOINT env var to WebSocket connect functions

* docs: update FRONTEND-API-GUIDE with new RoomType/RoomStatus structure

* feat : WebSocket Connect, Disconnect 핸들러 & SpeakingConnecion 모델 구현

* feat : WebSocket 메시지 처리 handler, service 구현

* feat : WebSocket 연결 정보 Repository 구현

* fix: update WebSocketDisconnectHandler to use GameSession model

- Remove references to deleted ChatRoom game fields
- Use GameSessionRepository to finish active game sessions
- Use ChatRoomRepository.updateStatus() for room state management

* perf: optimize CI/CD build time

- Add pip cache for SAM CLI dependencies
- Enable Gradle parallel builds and build cache
- Add SAM build cache (.aws-sam)
- Use sam build --parallel --cached
- Skip SAM CLI install if already cached
- Remove unnecessary 'clean' to leverage cache

* feat: add custom CodeBuild Docker image with pre-installed tools

- Dockerfile with Java 21 + SAM CLI + Gradle pre-installed
- build-and-push.sh script for ECR deployment
- Updated buildspec.yml for custom image (removes SAM CLI install)
- Expected build time reduction: ~30-40 seconds

* feature : AI 영어 회화 연습 기능 (#468)

* feat : WebSocket Connect, Disconnect 핸들러 & SpeakingConnecion 모델 구현

* feat : WebSocket 메시지 처리 handler, service 구현

* feat : WebSocket 연결 정보 Repository 구현

* fix: remove typo in SpeakingConnectionRepository

* fix : 오타 수정

* chore: trigger build test with custom Docker image

* chore: remove unnecessary newlines and whitespace across WebSocket handlers and related classes

* chore: remove unnecessary newlines and whitespace across WebSocket handlers and related classes

* refactor : websocket -> rest api 전환

* feat : speaking handler REST로 교체

* feat : speaking 관련 dto 생성

* refacotor : 기존 service 코드 로직 재사용 및 repository 리펙토링

* fix: add CORS headers to API Gateway error responses (#479)

API Gateway의 인증 실패 등 에러 응답에 CORS 헤더가 누락되어
CloudFront를 통한 프론트엔드 요청이 차단되는 문제 수정

- UNAUTHORIZED (401) 응답에 CORS 헤더 추가
- ACCESS_DENIED (403) 응답에 CORS 헤더 추가
- DEFAULT_4XX/5XX 응답에 CORS 헤더 추가
- EXPIRED_TOKEN 응답에 CORS 헤더 추가

* feat : speaking rest API 람다 함수 추가

---------

Co-authored-by: ddingjoo <ddingsha9@teambind.co.kr>

* refactor : speaking service 재사용

* refactor : AI 영어 회화 연습 코드 리팩토링

* feature : test 벡엔드 서버에 AI 말하기 연습 기능 배포 (#492)

* feat : WebSocket Connect, Disconnect 핸들러 & SpeakingConnecion 모델 구현

* feat : WebSocket 메시지 처리 handler, service 구현

* feat : WebSocket 연결 정보 Repository 구현

* fix : 오타 수정

* refactor : websocket -> rest api 전환

* feat : speaking handler REST로 교체

* feat : speaking 관련 dto 생성

* refacotor : 기존 service 코드 로직 재사용 및 repository 리펙토링

* feat : speaking rest API 람다 함수 추가

* refactor : speaking service 재사용

* refactor : AI 영어 회화 연습 코드 리팩토링

---------

Co-authored-by: DDING JOO <ddingsha9@teambind.co.kr>

* feat : handleChat 메서드 JsonNull 체크 푸가

* feature : handleChat 메서드 JsonNull 체크 추가 (#493)

* feat : WebSocket Connect, Disconnect 핸들러 & SpeakingConnecion 모델 구현

* feat : WebSocket 메시지 처리 handler, service 구현

* feat : WebSocket 연결 정보 Repository 구현

* fix : 오타 수정

* refactor : websocket -> rest api 전환

* feat : speaking handler REST로 교체

* feat : speaking 관련 dto 생성

* refacotor : 기존 service 코드 로직 재사용 및 repository 리펙토링

* feat : speaking rest API 람다 함수 추가

* refactor : speaking service 재사용

* refactor : AI 영어 회화 연습 코드 리팩토링

* feat : handleChat 메서드 JsonNull 체크 푸가

---------

Co-authored-by: DDING JOO <ddingsha9@teambind.co.kr>

* feat(news): 뉴스 학습 배지 시스템 구현 (#473)

- 14개 뉴스 관련 배지 추가 (읽기, 퀴즈, 단어수집, 연속학습, 마스터)
- UserStats에 뉴스 통계 필드 추가
- 6개 뉴스 배지 Strategy 클래스 생성
- 뉴스 읽기/퀴즈/단어수집 시 통계 업데이트 및 배지 체크 연동

* fix: add PATCH method to CORS AllowMethods

* test: BadgeType 개수 테스트 수정 (15 -> 29)

* fix: CORS PATCH 메서드 추가

* docs: 뉴스 기능 프론트엔드 연동 가이드 작성

* fix: NewsCollectionFunction에 Bedrock, Comprehend 권한 추가

* fix: add null check for collectWord request body

- Add INVALID_REQUEST error code to NewsErrorCode
- Check body and word field before accessing in collectWord()
- Prevents NullPointerException when request body is malformed

* feat: enhance stats API and bookmark response for frontend

- Add DAILY stats update for news read/quiz/word collection
- Add /stats/dashboard endpoint with frontend-requested format
  - today: wordsLearned, newsRead, quizzesTaken, wordsTotal
  - overall: totalWordsLearned, totalNewsRead, averageAccuracy, streaks
  - weeklyProgress: last 7 days with date/wordsLearned/newsRead
- Add news-related fields to all stats API responses
- Fix bookmark API to include full article details (title, summary, etc.)

* feat: add category classification to news AI analysis

- Add category field to AnalysisResult record
- Update Bedrock prompt to classify articles into categories
  (WORLD, POLITICS, BUSINESS, TECH, SCIENCE, HEALTH, SPORTS, ENTERTAINMENT, LIFESTYLE)
- Parse and set category from AI response
- Set GSI2 (CATEGORY#) index when category is available

* fix: add /stats/dashboard endpoint to template.yaml

* fix: filter by ARTICLE# prefix in findById to avoid returning UserNewsRecord

* docs: add News API troubleshooting guide

* feat: add Cognito authorizer to News API and enhance keyword extraction

- Set CognitoAuthorizer for all News API endpoints in template.yaml
- Update Bedrock AI to extract keywords with meanings and examples
- Add fallback to Comprehend for keyword extraction when Bedrock fails
- Modify KeywordInfo model to include example field
- Adjust AI prompt to include keyword extraction with examples
- Update AnalysisResult to store keywords and parse them from AI response

* Revert "Merge branch 'test' into prod"

This reverts commit c1a958eac6799d5838a76e4078ae304bcdb62278, reversing
changes made to a6662e0cfc46c6e12f20a89f0df285ff282160bc.

* feat: enhance bookmark and reading status tracking for News API

- Add bookmark and reading status to individual article responses
- Include bookmark status in paginated news responses
- Modify `KeywordInfo` to support Korean translations (`meaningKo`)
- Update AI prompts to extract Korean meanings for keywords

* refactor : session_id가 null 체크 추가

* feat : template 환경변수 리펙토링

* fix : sessionId NullPointerException 에러 수정  (#496)

* feat : WebSocket Connect, Disconnect 핸들러 & SpeakingConnecion 모델 구현

* feat : WebSocket 메시지 처리 handler, service 구현

* feat : WebSocket 연결 정보 Repository 구현

* fix : 오타 수정

* refactor : websocket -> rest api 전환

* feat : speaking handler REST로 교체

* feat : speaking 관련 dto 생성

* refacotor : 기존 service 코드 로직 재사용 및 repository 리펙토링

* feat : speaking rest API 람다 함수 추가

* refactor : speaking service 재사용

* refactor : AI 영어 회화 연습 코드 리팩토링

* feat : handleChat 메서드 JsonNull 체크 푸가

* refactor : session_id가 null 체크 추가

* feat : template 환경변수 리펙토링

---------

Co-authored-by: DDING JOO <ddingsha9@teambind.co.kr>

* feat: enhance bookmark and reading status tracking for News API

- Add bookmark and reading status to individual article responses
- Include bookmark status in paginated news responses
- Modify `KeywordInfo` to support Korean translations (`meaningKo`)
- Update AI prompts to extract Korean meanings for keywords

* feat: add category filtering to UserWord API with enhanced query logic

- Introduce `category` filtering to `getUserWords` API
- Update WordCategory enums to include "news" category
- Apply category filter after enrichment with word info
- Adjust query limits for bookmarked and incorrect words queries

* feat: add default value for ExistingCognitoClientId in template.yaml

- Set default to an empty string to ensure compatibility with templates using this parameter without explicitly specifying a value.

* fix: SpeakingHandler getStringOrNull 컴파일 에러 수정

* fix: SpeakingHandler getStringOrNull 컴파일 에러 수정

* fix: Bedrock 키워드(meaningKo 포함)를 article에 저장하도록 수정

* fix: Bedrock 키워드(meaningKo 포함)를 article에 저장하도록 수정

* fix: Bedrock 키워드(meaningKo 포함)를 article에 저장하도록 수정

* feat: add dashboard stats API and enhance news stats tracking

- Introduce `/stats/dashboard` API for retrieving integrated user stats (today, overall, weekly progress, and level distribution)
- Update `UserStats` model to include additional fields for news stats (newsRead, newsQuizCompleted, newsQuizPerfect, newsWordsCollected, etc.)
- Add atomic updates to track news reading, quiz, and word stats in `UserStatsRepository`
- Modify CloudFormation `template.yaml` to register the new `/stats/dashboard` endpoint

* feat: add dashboard stats API and enhance news stats tracking

- Introduce `/stats/dashboard` API for retrieving integrated user stats (today, overall, weekly progress, and level distribution)
- Update `UserStats` model to include additional fields for news stats (newsRead, newsQuizCompleted, newsQuizPerfect, newsWordsCollected, etc.)
- Add atomic updates to track news reading, quiz, and word stats in `UserStatsRepository`
- Modify CloudFormation `template.yaml` to register the new `/stats/dashboard` endpoint

* feat: add dashboard stats API and enhance news stats tracking

- Introduce `/stats/dashboard` API for retrieving integrated user stats (today, overall, weekly progress, and level distribution)
- Update `UserStats` model to include additional fields for news stats (newsRead, newsQuizCompleted, newsQuizPerfect, newsWordsCollected, etc.)
- Add atomic updates to track news reading, quiz, and word stats in `UserStatsRepository`
- Modify CloudFormation `template.yaml` to register the new `/stats/dashboard` endpoint

* refactor: format code with consistent indentation and spacing

- Apply consistent formatting to improve code readability across multiple files
- Adjust indentation, spacing, and alignment in model classes, DTOs, and repository methods

* fix: filter by ARTICLE# prefix in findById to avoid returning bookmark records

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* feat : Speaking 관련 template 람다 함수 및 테이블 추가

---------

Co-authored-by: DDING JOO <ddingsha9@teambind.co.kr>
Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>

* feature : 말하기 연습 기능 polly 서비스 권한 추가 (#514)

* feat: EnvConfig 유틸리티 추가 및 환경 변수 검증 적용

환경 변수 미설정 시 명확한 에러 메시지를 제공하는 EnvConfig 유틸리티를 추가하고,
기존 System.getenv 호출을 EnvConfig.getRequired/getOrDefault로 대체함.

- EnvConfig: getRequired, getOrDefault, getIntOrDefault, getLongOrDefault 메서드 제공
- Lambda Cold Start 시점에 환경 변수 누락을 조기 감지
- 기존 Config 클래스(WebSocketConfig, RoomTokenConfig) EnvConfig 사용으로 통일

Closes #403

* refactor: TestService submitTest 메서드 책임 분리

submitTest 메서드를 단일 책임 원칙에 맞게 리팩토링:
- gradeAnswers(): 답안 채점 및 결과 집계
- isAnswerCorrect(): 단일 답안 정답 여부 판단
- buildResultItem(): 결과 항목 생성
- saveTestResult(): 테스트 결과 저장
- GradingResult record: 채점 결과 캡슐화

TestService와 TestCommandService 모두 동일하게 적용

Closes #404

* refactor: 하드코딩된 설정값 환경 변수로 외부화

각 도메인별 Config 클래스를 생성하여 하드코딩된 값들을 환경 변수로 설정 가능하게 변경.
기본값이 있어 환경 변수 미설정 시에도 기존 동작 유지.

## 새로 추가된 Config 클래스
- GrammarConfig: SESSION_TTL_DAYS, MAX_HISTORY_MESSAGES, MAX_TOKENS 등
- GameConfig: TOTAL_ROUNDS, ROUND_TIME_LIMIT, QUICK_GUESS_THRESHOLD_MS
- VocabularyConfig: NEW_WORDS_COUNT, REVIEW_WORDS_COUNT, 상태 전이 임계값 등

## 지원하는 환경 변수
- GRAMMAR_SESSION_TTL_DAYS, GRAMMAR_MAX_HISTORY_MESSAGES, GRAMMAR_MAX_TOKENS
- GAME_TOTAL_ROUNDS, GAME_ROUND_TIME_LIMIT, GAME_QUICK_GUESS_THRESHOLD_MS
- VOCAB_NEW_WORDS_COUNT, VOCAB_REVIEW_WORDS_COUNT
- VOCAB_TRANSITION_TO_REVIEWING, VOCAB_TRANSITION_TO_MASTERED

Closes #406

* test: StudyLevel enum 단위 테스트 추가

* test: Difficulty enum 단위 테스트 추가

* test: StudyConfig 단위 테스트 추가

* test: EnvConfig 단위 테스트 추가

* test: PaginatedResult 단위 테스트 추가

* test: JsonUtil 단위 테스트 추가

* test: CursorUtil 단위 테스트 추가

* test: CommonErrorCode 단위 테스트 추가

* test: CommonException 단위 테스트 추가

* test: BadgeType enum 단위 테스트 추가

* test: BadgeKey 상수 단위 테스트 추가

* test: WordStatus enum 단위 테스트 추가

* test: TestType enum 단위 테스트 추가

* test: VocabularyConfig 단위 테스트 추가

* test: VocabKey 상수 단위 테스트 추가

* test: VocabularyErrorCode 단위 테스트 추가

* test: VocabularyException 단위 테스트 추가

* test: SpacedRepetitionContext 단위 테스트 추가

* test: GrammarLevel enum 단위 테스트 추가

* test: GrammarConfig 단위 테스트 추가

* test: GrammarErrorCode 단위 테스트 추가

* test: GrammarException 단위 테스트 추가

* test: GameStatus enum 단위 테스트 추가

* test: GameConfig 단위 테스트 추가

* test: ChattingErrorCode 단위 테스트 추가

* test: ChattingException 단위 테스트 추가

* fix: OPIc FeedbackResponse.java 문법 오류 수정

* style: AwsClients 코드 포맷팅

* style: EnvConfig 코드 포맷팅

* style: RoomTokenConfig 코드 포맷팅

* style: WebSocketConfig 코드 포맷팅

* style: JsonUtil 코드 포맷팅

* style: GameConfig 코드 포맷팅

* style: GrammarConfig 코드 포맷팅

* style: GrammarKey 코드 포맷팅

* style: GrammarErrorCode 코드 포맷팅

* style: GrammarException 코드 포맷팅

* style: BedrockGrammarCheckFactory 코드 포맷팅

* style: GrammarConversationService 코드 포맷팅

* style: FeedbackResponse 코드 포맷팅

* style: SessionReportResponse 코드 포맷팅

* style: SpeakingError 코드 포맷팅

* style: SpeakingErrorType 코드 포맷팅

* style: OPIcException 코드 포맷팅

* style: OPIcAnswer 코드 포맷팅

* style: OPIcQuestion 코드 포맷팅

* style: OPIcSession 코드 포맷팅

* style: OPIcRepository 코드 포맷팅

* style: FeedbackService 코드 포맷팅

* style: TranscribeProxyService 코드 포맷팅

* style: VocabularyConfig 코드 포맷팅

* style: DailyStudyCommandService 코드 포맷팅

* style: TestCommandService 코드 포맷팅

* style: TestService 코드 포맷팅

* style: CommonErrorCodeSpec 코드 포맷팅

* style: JsonUtilSpec 코드 포맷팅

* style: BadgeTypeSpec 코드 포맷팅

* style: ChattingErrorCodeSpec 코드 포맷팅

* style: GrammarLevelSpec 코드 포맷팅

* style: GrammarErrorCodeSpec 코드 포맷팅

* style: VocabularyErrorCodeSpec 코드 포맷팅

* feature : OPIc 세션관리 + 답변 처리 파이프라인 구현  (#413)

* feat : OPIc 질문 & 세션 관련 dto 생성

* refactor : @DynamoDbBean 주석 추가

* feat : 주제 + 소주제 + 레벨로 오픽 질문 조회 추가

* feat : OPIc 세션, 질문, 답변 종합 handler 구현

* feat : 오픽 주제, 소주제별 seed 데이터 추가

* refactor : Transcribe API KEY 환경변수명 수정

* refactor : Bedrock에 사용하는 클로드 모델 변경

* refactor : S3 Key 대신 Proxy에서 요청하는 Base64 값으로 변환

* feat: GAME_START, ROUND_END 메시지에 serverTime 추가

- broadcastGameStart(): serverTime, roundDuration 필드 추가
- broadcastRoundEnd(): serverTime, roundStartTime, roundDuration 필드 추가
- GameService.endRound(): data에 roundStartTime, roundDuration 포함
- 타이머 동기화 버그 수정을 위한 서버 시간 제공

* feat: WebSocketMessageHelper 유틸리티 클래스 추가

- domain 필드 포함 메시지 생성 헬퍼
- DOMAIN_CHAT, DOMAIN_GAME 상수 정의
- buildChatMessage(), buildGameMessage() 메서드

* feat: 모든 WebSocket 메시지에 domain 필드 추가

- ScoreUpdateMessage에 domain 필드 추가
- broadcastGameStart에 domain:"game" 추가
- broadcastRoundEnd에 domain:"game" 추가
- broadcastCorrectAnswerMessage에 domain:"game" 추가
- handleCommandResult 시스템 메시지에 domain:"game" 추가
- handleRegularMessage 채팅 메시지에 domain:"chat" 추가

Closes #426, #427

* feat: GameSession 모델 클래스 생성

- DynamoDB Enhanced Client 어노테이션 적용
- GSI1: roomId로 활성 게임 세션 조회 가능
- 게임 상태 관리용 헬퍼 메서드 포함

Closes #428

* feat: GameSessionRepository 구현

- 기본 CRUD (save, findById, delete)
- roomId로 활성/전체 게임 세션 조회
- 상태, 라운드, 점수 업데이트 메서드
- 정답자 추가, 힌트 사용, 게임 종료 처리

Closes #429

* refactor: ChatRoom에서 게임 필드 분리

- 게임 관련 필드 제거 (gameStatus, currentRound 등)
- activeGameSessionId 필드 추가
- 게임 상태는 GameSession으로 분리됨

Note: 의존 코드 수정은 #431에서 진행

Closes #430

* refactor: GameSession 기반으로 전체 게임 로직 리팩토링

- GameService: ChatRoom 대신 GameSession 사용
- GameStatsService: GameSession 매개변수로 변경
- CommandService: GameSession 기반 점수 조회
- GameHandler: GameSession 기반 REST API
- WebSocketMessageHandler: GameSession 기반 브로드캐스트
- GameStatusResponse, ScoreboardResponse: GameSession 매개변수

Closes #431

* feat: GameSessionHandler Lambda 및 게임 세션 API 구현

- POST /rooms/{roomId}/games - 게임 세션 생성
- GET /games/{gameSessionId} - 게임 상태 조회 (재접속용)
- POST /games/{gameSessionId}/start - 게임 시작
- POST /games/{gameSessionId}/stop - 게임 종료

모든 응답에 serverTime 포함 (타이머 동기화)
출제자에게만 currentWord 포함

Closes #432, #433

* feat: 게임 시작 7분 후 자동 종료 기능 구현

- GameConfig에 gameTimeLimit() 메서드 추가 (기본값: 420초)
- GameSchedulerClient 유틸리티 클래스 생성 (EventBridge Scheduler 연동)
- GameService에 스케줄 생성/취소 로직 추가
- GameAutoCloseHandler Lambda 함수 생성
- template.yaml에 Lambda, IAM Role, Schedule Group 추가

Closes #417

* fix : 메모리 증가 및 Lambda 응답 제한 시간 Cognito 트리거 제한시간과 동일하게 수정 (#439)

* feat: 캐치마인드 게임 방 분리 기능 구현 (#455)

- Room 타입 분리 (CHAT/GAME)
  - RoomType, RoomStatus enum 추가
  - ChatRoom 모델에 type, gameType, gameSettings, status, hostId 필드 추가
  - GameSettings 모델 추가

- 방 생성/조회 API 수정
  - CreateRoomRequest에 type, gameType, gameSettings 필드 추가
  - 방 목록 조회 시 type, gameType, status 필터 지원

- 게임 시작 조건 검증
  - GAME 타입 방에서만 게임 시작 가능 (GAME_007 에러)

- 게임 재시작 API 구현 (#452)
  - POST /rooms/{roomId}/game/restart 엔드포인트 추가
  - 방장만 재시작 가능 (GAME_009 에러)
  - 게임 진행 중 재시작 불가 (GAME_008 에러)

- 방장 변경 로직 구현 (#453)
  - 방장 퇴장 시 다음 멤버에게 자동 이전
  - 모든 멤버 퇴장 시 방 자동 삭제

- WebSocket 메시지 타입 추가 (#454)
  - ROOM_STATUS_CHANGE, HOST_CHANGE 메시지 타입 추가
  - WebSocketMessageHelper에 빌더 메서드 추가

- 테스트 추가
  - RoomType, RoomStatus enum 테스트
  - GameSettings 모델 테스트
  - ChattingErrorCode 테스트 업데이트

Related: #440, #441, #442, #443, #444, #445, #446
Closes: #447, #448, #449, #450, #451, #452, #453, #454

* feat: 참가자 닉네임 및 방장 변경 WebSocket 알림 구현 (#456)

- RoomParticipant DTO 추가 (userId, nickname, isHost)
- ChatRoomQueryService에 닉네임 조회 메서드 추가
  - getParticipantsWithNicknames(): 참가자 목록 + 닉네임
  - getHostNickname(): 방장 닉네임 조회
- ChatRoomHandler.getRoom() 응답에 participants, hostNickname 추가
- ChatRoomCommandService.leaveRoom()에서 방장 변경 시 WebSocket 브로드캐스트

Related: #440

* fix: ChatRoomFunction에 UserTable DynamoDB 권한 추가

- 참가자/방장 닉네임 조회를 위한 UserTable 읽기 권한 추가
- DynamoDBReadPolicy로 UserTable 접근 허용

Fixes #457

* fix: GameSettings에 @DynamoDbBean 어노테이션 추가

- DynamoDB Enhanced Client가 중첩 객체를 직렬화/역직렬화할 수 있도록 수정
- ChatRoom 저장/조회 시 GameSettings 변환 오류 해결

Fixes #457

* fix: ChatRoomFunction에 WEBSOCKET_ENDPOINT 환경변수 및 권한 추가

- leaveRoom에서 WebSocketBroadcaster 사용을 위한 환경변수 추가
- execute-api:ManageConnections 권한 추가

* fix: WebSocket Lambda 함수들에 WEBSOCKET_ENDPOINT 환경변수 추가

- WebSocketConnectFunction에 WEBSOCKET_ENDPOINT 추가
- WebSocketDisconnectFunction에 WEBSOCKET_ENDPOINT 추가
- execute-api:ManageConnections 권한 추가

* fix: Grammar WebSocket Lambda 환경 변수 및 권한 추가

- GrammarStreamingConnectFunction에 WEBSOCKET_ENDPOINT 환경 변수 추가
- GrammarStreamingDisconnectFunction에 WEBSOCKET_ENDPOINT 환경 변수 추가
- 두 함수에 execute-api:ManageConnections 권한 추가

* feat: GSI1SK 확장성 있는 재설계 및 DB 레벨 필터링

## 변경 사항

### GSI1SK 포맷 변경
- 기존: {level}#{createdAt}
- 신규: {type}#{gameType}#{status}#{level}#{createdAt}

### 지원 쿼리 패턴
- 전체 방: GSI1PK = "ROOMS"
- 게임방만: begins_with(GSI1SK, "GAME#")
- 캐치마인드만: begins_with(GSI1SK, "GAME#CATCHMIND#")
- 대기중 캐치마인드: begins_with(GSI1SK, "GAME#CATCHMIND#WAITING#")

### 파일 수정
- ChatRoomCommandService.java: 방 생성 시 새 GSI1SK 포맷 적용
- ChatRoomRepository.java: findByFilters() 메서드 추가, updateStatus() 메서드 추가
- ChatRoomQueryService.java: 메모리 필터링 제거, DB 레벨 필터링으로 변경
- GameService.java: 게임 시작/종료 시 방 상태 업데이트 (GSI1SK 포함)

### 마이그레이션
- scripts/migrate-gsi1sk.sh: 기존 데이터 마이그레이션 스크립트
- 37개 기존 방 마이그레이션 완료

* fix: increase stats query limit to 100 days

- Adjust maximum allowable limit for recent stats query from 30 to 100 days to support extended data range responses.

* feat: improve game round and connection management logic

- Added handling for game round timeout (`ROUND_TIMEOUT`) in WebSocketMessageHandler.
- Enhanced game start broadcast to include `currentWord` for the drawer only.
- Updated ConnectionRepository to remove duplicate user connections in the same room.
- Added `currentWordEnglish` to GameSession for better answer verification.
- Normalized ChatRoom levels to match database storage format.
- Updated template.yaml to include DynamoDBReadPolicy for VocabTable.

* refactor: 코드 정리 및 미사용 클래스 제거 (#459)

* refactor: remove unused WebSocketResponseUtil

* refactor: add AutoCloseable to WebSocketBroadcaster

* refactor: remove unused TestService

* refactor: remove unused WordService

* refactor: remove unused DailyStudyService

* refactor: remove unused UserWordService

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* fix: resolve N+1 query in StatsService

* refactor(all): DI 패턴 및 전략 패턴 적용 (#461)

- Repository, Service, Handler에 DI 생성자 추가 (테스트 용이성)
- BadgeService에 Strategy 패턴 적용 (뱃지 조건 검증 로직 분리)

* refactor: relocate and restructure seed data files

- Moved `question-homes.json` and `words.json` from subdirectories to `seed` folder.
- Updated file paths for better organization and clarity.

* chore: seed 데이터 폴더 구조 정리

* feat: add CI/CD pipeline configuration for CodePipeline

* fix: add SNS topic policy and DependsOn for notification rule

* fix: correct paths in buildspec.yml for CodeBuild

* fix: remove hardcoded JAVA_HOME, use runtime default

* fix: add gradle wrapper for CI/CD build

* fix: use single line sam package command with hardcoded bucket

* fix: use existing stack name group2-englishstudy-chatting

* fix: add missing WEBSOCKET_ENDPOINT env var to WebSocket connect functions

* docs: update FRONTEND-API-GUIDE with new RoomType/RoomStatus structure

* feat : WebSocket Connect, Disconnect 핸들러 & SpeakingConnecion 모델 구현

* feat : WebSocket 메시지 처리 handler, service 구현

* feat : WebSocket 연결 정보 Repository 구현

* fix: update WebSocketDisconnectHandler to use GameSession model

- Remove references to deleted ChatRoom game fields
- Use GameSessionRepository to finish active game sessions
- Use ChatRoomRepository.updateStatus() for room state management

* perf: optimize CI/CD build time

- Add pip cache for SAM CLI dependencies
- Enable Gradle parallel builds and build cache
- Add SAM build cache (.aws-sam)
- Use sam build --parallel --cached
- Skip SAM CLI install if already cached
- Remove unnecessary 'clean' to leverage cache

* feat: add custom CodeBuild Docker image with pre-installed tools

- Dockerfile with Java 21 + SAM CLI + Gradle pre-installed
- build-and-push.sh script for ECR deployment
- Updated buildspec.yml for custom image (removes SAM CLI install)
- Expected build time reduction: ~30-40 seconds

* feature : AI 영어 회화 연습 기능 (#468)

* feat : WebSocket Connect, Disconnect 핸들러 & SpeakingConnecion 모델 구현

* feat : WebSocket 메시지 처리 handler, service 구현

* feat : WebSocket 연결 정보 Repository 구현

* fix: remove typo in SpeakingConnectionRepository

* fix : 오타 수정

* chore: trigger build test with custom Docker image

* chore: remove unnecessary newlines and whitespace across WebSocket handlers and related classes

* chore: remove unnecessary newlines and whitespace across WebSocket handlers and related classes

* Release: 캐치마인드 게임 분리, AI 회화 연습, CI/CD 파이프라인 (#469)

* feature : OPIc 세션관리 + 답변 처리 파이프라인 구현  (#413)

* feat : OPIc 질문 & 세션 관련 dto 생성

* refactor : @DynamoDbBean 주석 추가

* feat : 주제 + 소주제 + 레벨로 오픽 질문 조회 추가

* feat : OPIc 세션, 질문, 답변 종합 handler 구현

* feat : 오픽 주제, 소주제별 seed 데이터 추가

* refactor : Transcribe API KEY 환경변수명 수정

* refactor : Bedrock에 사용하는 클로드 모델 변경

* refactor : S3 Key 대신 Proxy에서 요청하는 Base64 값으로 변환

* feat: GAME_START, ROUND_END 메시지에 serverTime 추가

- broadcastGameStart(): serverTime, roundDuration 필드 추가
- broadcastRoundEnd(): serverTime, roundStartTime, roundDuration 필드 추가
- GameService.endRound(): data에 roundStartTime, roundDuration 포함
- 타이머 동기화 버그 수정을 위한 서버 시간 제공

* feat: WebSocketMessageHelper 유틸리티 클래스 추가

- domain 필드 포함 메시지 생성 헬퍼
- DOMAIN_CHAT, DOMAIN_GAME 상수 정의
- buildChatMessage(), buildGameMessage() 메서드

* feat: 모든 WebSocket 메시지에 domain 필드 추가

- ScoreUpdateMessage에 domain 필드 추가
- broadcastGameStart에 domain:"game" 추가
- broadcastRoundEnd에 domain:"game" 추가
- broadcastCorrectAnswerMessage에 domain:"game" 추가
- handleCommandResult 시스템 메시지에 domain:"game" 추가
- handleRegularMessage 채팅 메시지에 domain:"chat" 추가

Closes #426, #427

* feat: GameSession 모델 클래스 생성

- DynamoDB Enhanced Client 어노테이션 적용
- GSI1: roomId로 활성 게임 세션 조회 가능
- 게임 상태 관리용 헬퍼 메서드 포함

Closes #428

* feat: GameSessionRepository 구현

- 기본 CRUD (save, findById, delete)
- roomId로 활성/전체 게임 세션 조회
- 상태, 라운드, 점수 업데이트 메서드
- 정답자 추가, 힌트 사용, 게임 종료 처리

Closes #429

* refactor: ChatRoom에서 게임 필드 분리

- 게임 관련 필드 제거 (gameStatus, currentRound 등)
- activeGameSessionId 필드 추가
- 게임 상태는 GameSession으로 분리됨

Note: 의존 코드 수정은 #431에서 진행

Closes #430

* refactor: GameSession 기반으로 전체 게임 로직 리팩토링

- GameService: ChatRoom 대신 GameSession 사용
- GameStatsService: GameSession 매개변수로 변경
- CommandService: GameSession 기반 점수 조회
- GameHandler: GameSession 기반 REST API
- WebSocketMessageHandler: GameSession 기반 브로드캐스트
- GameStatusResponse, ScoreboardResponse: GameSession 매개변수

Closes #431

* feat: GameSessionHandler Lambda 및 게임 세션 API 구현

- POST /rooms/{roomId}/games - 게임 세션 생성
- GET /games/{gameSessionId} - 게임 상태 조회 (재접속용)
- POST /games/{gameSessionId}/start - 게임 시작
- POST /games/{gameSessionId}/stop - 게임 종료

모든 응답에 serverTime 포함 (타이머 동기화)
출제자에게만 currentWord 포함

Closes #432, #433

* feat: 게임 시작 7분 후 자동 종료 기능 구현

- GameConfig에 gameTimeLimit() 메서드 추가 (기본값: 420초)
- GameSchedulerClient 유틸리티 클래스 생성 (EventBridge Scheduler 연동)
- GameService에 스케줄 생성/취소 로직 추가
- GameAutoCloseHandler Lambda 함수 생성
- template.yaml에 Lambda, IAM Role, Schedule Group 추가

Closes #417

* fix : 메모리 증가 및 Lambda 응답 제한 시간 Cognito 트리거 제한시간과 동일하게 수정 (#439)

* feat: 캐치마인드 게임 방 분리 기능 구현 (#455)

- Room 타입 분리 (CHAT/GAME)
  - RoomType, RoomStatus enum 추가
  - ChatRoom 모델에 type, gameType, gameSettings, status, hostId 필드 추가
  - GameSettings 모델 추가

- 방 생성/조회 API 수정
  - CreateRoomRequest에 type, gameType, gameSettings 필드 추가
  - 방 목록 조회 시 type, gameType, status 필터 지원

- 게임 시작 조건 검증
  - GAME 타입 방에서만 게임 시작 가능 (GAME_007 에러)

- 게임 재시작 API 구현 (#452)
  - POST /rooms/{roomId}/game/restart 엔드포인트 추가
  - 방장만 재시작 가능 (GAME_009 에러)
  - 게임 진행 중 재시작 불가 (GAME_008 에러)

- 방장 변경 로직 구현 (#453)
  - 방장 퇴장 시 다음 멤버에게 자동 이전
  - 모든 멤버 퇴장 시 방 자동 삭제

- WebSocket 메시지 타입 추가 (#454)
  - ROOM_STATUS_CHANGE, HOST_CHANGE 메시지 타입 추가
  - WebSocketMessageHelper에 빌더 메서드 추가

- 테스트 추가
  - RoomType, RoomStatus enum 테스트
  - GameSettings 모델 테스트
  - ChattingErrorCode 테스트 업데이트

Related: #440, #441, #442, #443, #444, #445, #446
Closes: #447, #448, #449, #450, #451, #452, #453, #454

* feat: 참가자 닉네임 및 방장 변경 WebSocket 알림 구현 (#456)

- RoomParticipant DTO 추가 (userId, nickname, isHost)
- ChatRoomQueryService에 닉네임 조회 메서드 추가
  - getParticipantsWithNicknames(): 참가자 목록 + 닉네임
  - getHostNickname(): 방장 닉네임 조회
- ChatRoomHandler.getRoom() 응답에 participants, hostNickname 추가
- ChatRoomCommandService.leaveRoom()에서 방장 변경 시 WebSocket 브로드캐스트

Related: #440

* fix: ChatRoomFunction에 UserTable DynamoDB 권한 추가

- 참가자/방장 닉네임 조회를 위한 UserTable 읽기 권한 추가
- DynamoDBReadPolicy로 UserTable 접근 허용

Fixes #457

* fix: GameSettings에 @DynamoDbBean 어노테이션 추가

- DynamoDB Enhanced Client가 중첩 객체를 직렬화/역직렬화할 수 있도록 수정
- ChatRoom 저장/조회 시 GameSettings 변환 오류 해결

Fixes #457

* fix: ChatRoomFunction에 WEBSOCKET_ENDPOINT 환경변수 및 권한 추가

- leaveRoom에서 WebSocketBroadcaster 사용을 위한 환경변수 추가
- execute-api:ManageConnections 권한 추가

* fix: WebSocket Lambda 함수들에 WEBSOCKET_ENDPOINT 환경변수 추가

- WebSocketConnectFunction에 WEBSOCKET_ENDPOINT 추가
- WebSocketDisconnectFunction에 WEBSOCKET_ENDPOINT 추가
- execute-api:ManageConnections 권한 추가

* fix: Grammar WebSocket Lambda 환경 변수 및 권한 추가

- GrammarStreamingConnectFunction에 WEBSOCKET_ENDPOINT 환경 변수 추가
- GrammarStreamingDisconnectFunction에 WEBSOCKET_ENDPOINT 환경 변수 추가
- 두 함수에 execute-api:ManageConnections 권한 추가

* feat: GSI1SK 확장성 있는 재설계 및 DB 레벨 필터링

## 변경 사항

### GSI1SK 포맷 변경
- 기존: {level}#{createdAt}
- 신규: {type}#{gameType}#{status}#{level}#{createdAt}

### 지원 쿼리 패턴
- 전체 방: GSI1PK = "ROOMS"
- 게임방만: begins_with(GSI1SK, "GAME#")
- 캐치마인드만: begins_with(GSI1SK, "GAME#CATCHMIND#")
- 대기중 캐치마인드: begins_with(GSI1SK, "GAME#CATCHMIND#WAITING#")

### 파일 수정
- ChatRoomCommandService.java: 방 생성 시 새 GSI1SK 포맷 적용
- ChatRoomRepository.java: findByFilters() 메서드 추가, updateStatus() 메서드 추가
- ChatRoomQueryService.java: 메모리 필터링 제거, DB 레벨 필터링으로 변경
- GameService.java: 게임 시작/종료 시 방 상태 업데이트 (GSI1SK 포함)

### 마이그레이션
- scripts/migrate-gsi1sk.sh: 기존 데이터 마이그레이션 스크립트
- 37개 기존 방 마이그레이션 완료

* fix: increase stats query limit to 100 days

- Adjust maximum allowable limit for recent stats query from 30 to 100 days to support extended data range responses.

* feat: improve game round and connection management logic

- Added handling for game round timeout (`ROUND_TIMEOUT`) in WebSocketMessageHandler.
- Enhanced game start broadcast to include `currentWord` for the drawer only.
- Updated ConnectionRepository to remove duplicate user connections in the same room.
- Added `currentWordEnglish` to GameSession for better answer verification.
- Normalized ChatRoom levels to match database storage format.
- Updated template.yaml to include DynamoDBReadPolicy for VocabTable.

* refactor: 코드 정리 및 미사용 클래스 제거 (#459)

* refactor: remove unused WebSocketResponseUtil

* refactor: add AutoCloseable to WebSocketBroadcaster

* refactor: remove unused TestService

* refactor: remove unused WordService

* refactor: remove unused DailyStudyService

* refactor: remove unused UserWordService

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* fix: resolve N+1 query in StatsService

* refactor(all): DI 패턴 및 전략 패턴 적용 (#461)

- Repository, Service, Handler에 DI 생성자 추가 (테스트 용이성)
- BadgeService에 Strategy 패턴 적용 (뱃지 조건 검증 로직 분리)

* refactor: relocate and restructure seed data files

- Moved `question-homes.json` and `words.json` from subdirectories to `seed` folder.
- Updated file paths for better organization and clarity.

* chore: seed 데이터 폴더 구조 정리

* feat: add CI/CD pipeline configuration for CodePipeline

* fix: add SNS topic policy and DependsOn for notification rule

* fix: correct paths in buildspec.yml for CodeBuild

* fix: remove hardcoded JAVA_HOME, use runtime default

* fix: add gradle wrapper for CI/CD build

* fix: use single line sam package command with hardcoded bucket

* fix: use existing stack name group2-englishstudy-chatting

* fix: add missing WEBSOCKET_ENDPOINT env var to WebSocket connect functions

* docs: update FRONTEND-API-GUIDE with new RoomType/RoomStatus structure

* fix: update WebSocketDisconnectHandler to use GameSession model

- Remove references to deleted ChatRoom game fields
- Use GameSessionRepository to finish active game sessions
- Use ChatRoomRepository.updateStatus() for room state management

* perf: optimize CI/CD build time

- Add pip cache for SAM CLI dependencies
- Enable Gradle parallel builds and build cache
- Add SAM build cache (.aws-sam)
- Use sam build --parallel --cached
- Skip SAM CLI install if already cached
- Remove unnecessary 'clean' to leverage cache

* feat: add custom CodeBuild Docker image with pre-installed tools

- Dockerfile with Java 21 + SAM CLI + Gradle pre-installed
- build-and-push.sh script for ECR deployment
- Updated buildspec.yml for custom image (removes SAM CLI install)
- Expected build time reduction: ~30-40 seconds

* feature : AI 영어 회화 연습 기능 (#468)

* feat : WebSocket Connect, Disconnect 핸들러 & SpeakingConnecion 모델 구현

* feat : WebSocket 메시지 처리 handler, service 구현

* feat : WebSocket 연결 정보 Repository 구현

* fix: remove typo in SpeakingConnectionRepository

* chore: trigger build test with custom Docker image

* chore: remove unnecessary newlines and whitespace across WebSocket handlers and related classes

* chore: remove unnecessary newlines and whitespace across WebSocket handlers and related classes

---------

Co-authored-by: hyein Heo <128613248+hye-inA@users.noreply.github.com>

* refactor : websocket -> rest api 전환

* feat : speaking handler REST로 교체

* feat : speaking 관련 dto 생성

* refacotor : 기존 service 코드 로직 재사용 및 repository 리펙토링

* fix: add CORS headers to API Gateway error responses (#479)

API Gateway의 인증 실패 등 에러 응답에 CORS 헤더가 누락되어
CloudFront를 통한 프론트엔드 요청이 차단되는 문제 수정

- UNAUTHORIZED (401) 응답에 CORS 헤더 추가
- ACCESS_DENIED (403) 응답에 CORS 헤더 추가
- DEFAULT_4XX/5XX 응답에 CORS 헤더 추가
- EXPIRED_TOKEN 응답에 CORS 헤더 추가

* feat(news): 뉴스 도메인 기반 구조 구축 (#385)

- NewsCategory, QuizType enum 추가
- NewsKey 상수 클래스 추가
- NewsErrorCode 예외 클래스 추가
- NewsArticle, KeywordInfo, QuizQuestion 모델 추가
- NewsArticleRepository CRUD 구현
- NewsTable DynamoDB 테이블 정의
- CORS GatewayResponses 설정 추가

* feat(news): 뉴스 수집 파이프라인 구현 (#386)

- NewsApiClient: NewsAPI 연동 서비스
- RssFeedParser: RSS 피드 파싱 (BBC, VOA, NPR)
- NewsDuplicateChecker: URL 기반 중복 필터링
- NewsCollectorService: 수집 오케스트레이션
- NewsCollectionHandler: Lambda 핸들러
- EventBridge 스케줄러: 매일 18시 KST 실행

* refactor(news): NewsAPI 제거, RSS만 사용

- NewsApiClient 삭제
- SSM Parameter 의존성 제거
- RSS 소스당 7개씩 수집 (BBC, VOA, NPR = 약 21개/일)

* feat(news): AI 뉴스 분석 시스템 구현 (#387)

- NewsAnalysisService: AI 분석 통합 서비스
  - Bedrock: CEFR 난이도 분석 (A1~C2)
  - Bedrock: 3줄 요약 + 퀴즈 3문제 생성
  - Comprehend: 핵심 키워드 추출
- NewsCollectorService: 수집 시 자동 분석 연동
- GSI1/GSI2 키 자동 설정 (레벨별, 카테고리별 조회)

* feat(news): 뉴스 학습 API 구현 (#388)

- NewsQueryService: 뉴스 조회 서비스
- NewsHandler: API 핸들러
  - GET /news - 목록 조회 (level, category 필터)
  - GET /news/today - 오늘의 뉴스
  - GET /news/recommended - 내 레벨 맞춤 추천
  - GET /news/{articleId} - 상세 조회 (조회수 증가)
- template.yaml: NewsFunction Lambda 추가

* feat(news): 뉴스 학습 부가 기능 구현 (#389)

- 읽기 완료 기록 API (POST /news/{articleId}/read)
- 북마크 토글 API (POST /news/{articleId}/bookmark)
- 북마크 목록 조회 API (GET /news/bookmarks)
- 학습 통계 조회 API (GET /news/stats)
- TTS 오디오 URL 조회 API (GET /news/{articleId}/audio)
- UserNewsRecord 모델 추가
- UserNewsRepository 추가
- NewsLearningService 추가

* feat(news): 복합 퀴즈 시스템 구현 (#471)

- 퀴즈 조회 API (GET /news/{articleId}/quiz)
- 퀴즈 제출 API (POST /news/{articleId}/quiz)
- 퀴즈 기록 조회 API (GET /news/quiz/history)
- NewsQuizResult 모델 추가
- QuizAnswerResult 모델 추가
- NewsQuizRepository 추가
- NewsQuizService 추가

* feat(news): 단어 수집 & Vocabulary 연동 구현 (#472)

- 단어 수집 API (POST /news/{articleId}/words)
- 수집 단어 목록 API (GET /news/words)
- 단어 상세 조회 API (GET /news/{articleId}/words/{word})
- 단어 삭제 API (DELETE /news/{articleId}/words/{word})
- Vocabulary 연동 API (POST /news/words/{word}/sync)
- NewsWordCollect 모델 추가
- NewsWordRepository 추가
- NewsWordService 추가

* feat: add multi-environment deployment support (dev/test/prod)

* fix: update buildspec.yml to deploy prod environment with parameter overrides

* feat(news): 뉴스 도메인 기반 구조 구축 (#385)

- NewsCategory, QuizType enum 추가
- NewsKey 상수 클래스 추가
- NewsErrorCode 예외 클래스 추가
- NewsArticle, KeywordInfo, QuizQuestion 모델 추가
- NewsArticleRepository CRUD 구현
- NewsTable DynamoDB 테이블 정의
- CORS GatewayResponses 설정 추가

* feat(news): 뉴스 수집 파이프라인 구현 (#386)

- NewsApiClient: NewsAPI 연동 서비스
- RssFeedParser: RSS 피드 파싱 (BBC, VOA, NPR)
- NewsDuplicateChecker: URL 기반 중복 필터링
- NewsCollectorService: 수집 오케스트레이션
- NewsCollectionHandler: Lambda 핸들러
- EventBridge 스케줄러: 매일 18시 KST 실행

* refactor(news): NewsAPI 제거, RSS만 사용

- NewsApiClient 삭제
- SSM Parameter 의존성 제거
- RSS 소스당 7개씩 수집 (BBC, VOA, NPR = 약 21개/일)

* feat(news): AI 뉴스 분석 시스템 구현 (#387)

- NewsAnalysisService: AI 분석 통합 서비스
  - Bedrock: CEFR 난이도 분석 (A1~C2)
  - Bedrock: 3줄 요약 + 퀴즈 3문제 생성
  - Comprehend: 핵심 키워드 추출
- NewsCollectorService: 수집 시 자동 분석 연동
- GSI1/GSI2 키 자동 설정 (레벨별, 카테고리별 조회)

* feat(news): 뉴스 학습 API 구현 (#388)

- NewsQueryService: 뉴스 조회 서비스
- NewsHandler: API 핸들러
  - GET /news - 목록 조회 (level, category 필터)
  - GET /news/today - 오늘의 뉴스
  - GET /news/recommended - 내 레벨 맞춤 추천
  - GET /news/{articleId} - 상세 조회 (조회수 증가)
- template.yaml: NewsFunction Lambda 추가

* feat(news): 뉴스 학습 부가 기능 구현 (#389)

- 읽기 완료 기록 API (POST /news/{articleId}/read)
- 북마크 토글 API (POST /news/{articleId}/bookmark)
- 북마크 목록 조회 API (GET /news/bookmarks)
- 학습 통계 조회 API (GET /news/stats)
- TTS 오디오 URL 조회 API (GET /news/{articleId}/audio)
- UserNewsRecord 모델 추가
- UserNewsRepository 추가
- NewsLearningService 추가

* feat(news): 복합 퀴즈 시스템 구현 (#471)

- 퀴즈 조회 API (GET /news/{articleId}/quiz)
- 퀴즈 제출 API (POST /news/{articleId}/quiz)
- 퀴즈 기록 조회 API (GET /news/quiz/history)
- NewsQuizResult 모델 추가
- QuizAnswerResult 모델 추가
- NewsQuizRepository 추가
- NewsQuizService 추가

* feat(news): 단어 수집 & Vocabulary 연동 구현 (#472)

- 단어 수집 API (POST /news/{articleId}/words)
- 수집 단어 목록 API (GET /news/words)
- 단어 상세 조회 API (GET /news/{articleId}/words/{word})
- 단어 삭제 API (DELETE /news/{articleId}/words/{word})
- Vocabulary 연동 API (POST /news/words/{word}/sync)
- NewsWordCollect 모델 추가
- NewsWordRepository 추가
- NewsWordService 추가

* feat: add multi-environment deployment support (dev/test/prod)

* fix: update buildspec.yml to deploy prod environment with parameter overrides

* refactor : AI 말하기 Websocket 구현 -> REST API 구현으로 리팩토링 (#490)

* feat : WebSocket Connect, Disconnect 핸들러 & SpeakingConnecion 모델 구현

* feat : WebSocket 메시지 처리 handler, service 구현

* feat : WebSocket 연결 정보 Repository 구현

* fix : 오타 수정

* refactor : websocket -> rest api 전환

* feat : speaking handler REST로 교체

* feat : speaking 관련 dto 생성

* refacotor : 기존 service 코드 로직 재사용 및 repository 리펙토링

* fix: revert buildspec.yml to build-only for CloudFormation deploy stage

* fix: revert buildspec.yml to build-only for CloudFormation deploy stage

* fix: update all API Gateway StageName to use Environment parameter

* fix: correct VocabularyTable and ContentBucket references in NewsFunction

* fix: correct VocabularyTable and ContentBucket references in NewsFunction

* fix: add stack name prefix to GameScheduleGroup and daily-stats schedule to avoid conflicts

* fix: add stack name prefix to GameScheduleGroup and daily-stats schedule to avoid conflicts

* feat: add support for existing Cognito User Pool reuse across environments

* fix: add conditional Cognito ARN reference in API Gateway Authorizer

* fix: remove Cognito resources completely, use existing Cognito only

* fix: remove Cognito resources completely, use existing Cognito only

* feat : speaking rest API 람다 함수 추가

* feat: add S3 bucket resource and fix environment-specific endpoints

- Add ContentBucket S3 resource for content storage
- Replace hardcoded /dev with ${Environment} in all WebSocket endpoints
- Update Output URLs to use dynamic environment stage

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* fix: add stack name prefix to news-collection schedule name

Prevent EventBridge rule name conflicts across environments

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* fix: add X-Requested-With and Accept headers to CORS config

Enable additional headers for CloudFront CORS compatibility

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* fix: use environment variable for S3 bucket URLs

Replace hardcoded bucket name with BUCKET_NAME env var for multi-env support:
- PreSignUpHandler: dynamic default profile URL
- PostConfirmationHandler: dynamic default profile URL
- UserService: dynamic default profile URL
- BadgeType: dynamic badge image base URL

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* fix: disable authorizer for CORS preflight requests

Add AddDefaultAuthorizerToCorsPreflight: false to prevent
Cognito Authorizer from blocking OPTIONS requests

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* feat : speaking REST API 람다 함수 추가  (#491)

* feature : OPIc 세션관리 + 답변 처리 파이프라인 구현  (#413)

* feat : OPIc 질문 & 세션 관련 dto 생성

* refactor : @DynamoDbBean 주석 추가

* feat : 주제 + 소주제 + 레벨로 오픽 질문 조회 추가

* feat : OPIc 세션, 질문, 답변 종합 handler 구현

* feat : 오픽 주제, 소주제별 seed 데이터 추가

* refactor : Transcribe API KEY 환경변수명 수정

* refactor : Bedrock에 사용하는 클로드 모델 변경

* refactor : S3 Key 대신 Proxy에서 요청하는 Base64 값으로 변환

* feat: GAME_START, ROUND_END 메시지에 serverTime 추가

- broadcastGameStart(): serverTime, roundDuration 필드 추가
- broadcastRoundEnd(): serverTime, roundStartTime, roundDuration 필드 추가
- GameService.endRound(): data에 roundStartTime, roundDuration 포함
- 타이머 동기화 버그 수정을 위한 서버 시간 제공

* feat: WebSocketMessageHelper 유틸리티 클래스 추가

- domain 필드 포함 메시지 생성 헬퍼
- DOMAIN_CHAT, DOMAIN_GAME 상수 정의
- buildChatMessage(), buildGameMessage() 메서드

* feat: 모든 WebSocket 메시지에 domain 필드 추가

- ScoreUpdateMessage에 domain 필드 추가
- broadcastGameStart에 domain:"game" 추가
- broadcastRoundEnd에 domain:"game" 추가
- broadcastCorrectAnswerMessage에 domain:"game" 추가
- handleCommandResult 시스템 메시지에 domain:"game" 추가
- handleRegularMessage 채팅 메시지에 domain:"chat" 추가

Closes #426, #427

* feat: GameSession 모델 클래스 생성

- DynamoDB Enhanced Client 어노테이션 적용
- GSI1: roomId로 활성 게임 세션 조회 가능
- 게임 상태 관리용 헬퍼 메서드 포함

Closes #428

* feat: GameSessionRepository 구현

- 기본 CRUD (save, findById, delete)
- roomId로 활성/전체 게임 세션 조회
- 상태, 라운드, 점수 업데이트 메서드
- 정답자 추가, 힌트 사용, 게임 종료 처리

Closes #429

* refactor: ChatRoom에서 게임 필드 분리

- 게임 관련 필드 제거 (gameStatus, currentRound 등)
- activeGameSessionId 필드 추가
- 게임 상태는 GameSession으로 분리됨

Note: 의존 코드 수정은 #431에서 진행

Closes #430

* refactor: GameSession 기반으로 전체 게임 로직 리팩토링

- GameService: ChatRoom 대신 GameSession 사용
- GameStatsService: GameSession 매개변수로 변경
- CommandService: GameSession 기반 점수 조회
- GameHandler: GameSession 기반 REST API
- WebSocketMessageHandler: GameSession 기반 브로드캐스트
- GameStatusResponse, ScoreboardResponse: GameSession 매개변수

Closes #431

* feat: GameSessionHandler Lambda 및 게임 세션 API 구현

- POST /rooms/{roomId}/games - 게임 세션 생성
- GET /games/{gameSessionId} - 게임 상태 조회 (재접속용)
- POST /games/{gameSessionId}/start - 게임 시작
- POST /games/{gameSessionId}/stop - 게임 종료

모든 응답에 serverTime 포함 (타이머 동기화)
출제자에게만 currentWord 포함

Closes #432, #433

* feat: 게임 시작 7분 후 자동 종료 기능 구현

- GameConfig에 gameTimeLimit() 메서드 추가 (기본값: 420초)
- GameSchedulerClient 유틸리티 클래스 생성 (EventBridge Scheduler 연동)
- GameService에 스케줄 생성/취소 로직 추가
- GameAutoCloseHandler Lambda 함수 생성
- template.yaml에 Lambda, IAM Role, Schedule Group 추가

Closes #417

* fix : 메모리 증가 및 Lambda 응답 제한 시간 Cognito 트리거 제한시간과 동일하게 수정 (#439)

* feat: 캐치마인드 게임 방 분리 기능 구현 (#455)

- Room 타입 분리 (CHAT/GAME)
  - RoomType, RoomStatus enum 추가
  - ChatRoom 모델에 type, gameType, gameSettings, status, hostId 필드 추가
  - GameSettings 모델 추가

- 방 생성/조회 API 수정
  - CreateRoomRequest에 type, gameType, gameSettings 필드 추가
  - 방 목록 조회 시 type, gameType, status 필터 지원

- 게임 시작 조건 검증
  - GAME 타입 방에서만 게임 시작 가능 (GAME_007 에러)

- 게임 재시작 API 구현 (#452)
  - POST /rooms/{roomId}/game/restart 엔드포인트 추가
  - 방장만 재시작 가능 (GAME_009 에러)
  - 게임 진행 중 재시작 불가 (GAME_008 에러)

- 방장 변경 로직 구현 (#453)
  - 방장 퇴장 시 다음 멤버에게 자동 이전
  - 모든 멤버 퇴장 시 방 자동 삭제

- WebSocket 메시지 타입 추가 (#454)
  - ROOM_STATUS_CHANGE, HOST_CHANGE 메시지 타입 추가
  - WebSocketMessageHelper에 빌더 메서드 추가

- 테스트 추가
  - RoomType, RoomStatus enum 테스트
  - GameSettings 모델 테스트
  - ChattingErrorCode 테스트 업데이트

Related: #440, #441, #442, #443, #444, #445, #446
Closes: #447, #448, #449, #450, #451, #452, #453, #454

* feat: 참가자 닉네임 및 방장 변경 WebSocket 알림 구현 (#456)

- RoomParticipant DTO 추가 (userId, nickname, isHost)
- ChatRoomQueryService에 닉네임 조회 메서드 추가
  - getParticipantsWithNicknames(): 참가자 목록 + 닉네임
  - getHostNickname(): 방장 닉네임 조회
- ChatRoomHandler.getRoom() 응답에 participants, hostNickname 추가
- ChatRoomCommandService.leaveRoom()에서 방장 변경 시 WebSocket 브로드캐스트

Related: #440

* fix: ChatRoomFunction에 UserTable DynamoDB 권한 추가

- 참가자/방장 닉네임 조회를 위한 UserTable 읽기 권한 추가
- DynamoDBReadPolicy로 UserTable 접근 허용

Fixes #457

* fix: GameSettings에 @DynamoDbBean 어노테이션 추가

- DynamoDB Enhanced Client가 중첩 객체를 직렬화/역직렬화할 수 있도록 수정
- ChatRoom 저장/조회 시 GameSettings 변환 오류 해결

Fixes #457

* fix: ChatRoomFunction에 WEBSOCKET_ENDPOINT 환경변수 및 권한 추가

- leaveRoom에서 WebSocketBroadcaster 사용을 위한 환경변수 추가
- execute-api:ManageConnections 권한 추가

* fix: WebSocket Lambda 함수들에 WEBSOCKET_ENDPOINT 환경변수 추가

- WebSocketConnectFunction에 WEBSOCKET_ENDPOINT 추가
- WebSocketDisconnectFunction에 WEBSOCKET_ENDPOINT 추가
- execute-api:ManageConnections 권한 추가

* fix: Grammar WebSocket Lambda 환경 변수 및 권한 추가

- GrammarStreamingConnectFunction에 WEBSOCKET_ENDPOINT 환경 변수 추가
- GrammarStreamingDisconnectFunction에 WEBSOCKET_ENDPOINT 환경 변수 추가
- 두 함수에 execute-api:ManageConnections 권한 추가

* feat: GSI1SK 확장성 있는 재설계 및 DB 레벨 필터링

- 기존: {level}#{createdAt}
- 신규: {type}#{gameType}#{status}#{level}#{createdAt}

- 전체 방: GSI1PK = "ROOMS"
- 게임방만: begins_with(GSI1SK, "GAME#")
- 캐치마인드만: begins_with(GSI1SK, "GAME#CATCHMIND#")
- 대기중 캐치마인드: begins_with(GSI1SK, "GAME#CATCHMIND#WAITING#")

- ChatRoomCommandService.java: 방 생성 시 새 GSI1SK 포맷 적용
- ChatRoomRepository.java: findByFilters() 메서드 추가, updateStatus() 메서드 추가
- ChatRoomQueryService.java: 메모리 필터링 제거, DB 레벨 필터링으로 변경
- GameService.java: 게임 시작/종료 시 방 상태 업데이트 (GSI1SK 포함)

- scripts/migrate-gsi1sk.sh: 기존 데이터 마이그레이션 스크립트
- 37개 기존 방 마이그레이션 완료

* fix: increase stats query limit to 100 days

- Adjust maximum allowable limit for recent stats query from 30 to 100 days to support extended data range responses.

* feat: improve game round and connection management logic

- Added handling for game round timeout (`ROUND_TIMEOUT`) in WebSocketMessageHandler.
- Enhanced game start broadcast to include `currentWord` for the drawer only.
- Updated ConnectionRepository to remove duplicate user connections in the same room.
- Added `currentWordEnglish` to GameSession for better answer verification.
- Normalized ChatRoom levels to match database storage format.
- Updated template.yaml to include DynamoDBReadPolicy for VocabTable.

* refactor: 코드 정리 및 미사용 클래스 제거 (#459)

* refactor: remove unused WebSocketResponseUtil

* refactor: add AutoCloseable to WebSocketBroadcaster

* refactor: remove unused TestService

* refactor: remove unused WordService

* refactor: remove unused DailyStudyService

* refactor: remove unused UserWordService

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* fix: resolve N+1 query in StatsService

* refactor(all): DI 패턴 및 전략 패턴 적용 (#461)

- Repository, Service, Handler에 DI 생성자 추가 (테스트 용이성)
- BadgeService에 Strategy 패턴 적용 (뱃지 조건 검증 로직 분리)

* refactor: relocate and restructure seed data files

- Moved `question-homes.json` and `words.json` from subdirectories to `seed` folder.
- Updated file paths for better organization and clarity.

* chore: seed 데이터 폴더 구조 정리

* feat: add CI/CD pipeline configuration for CodePipeline

* fix: add SNS topic policy and DependsOn for notification rule

* fix: correct paths in buildspec.yml for CodeBuild

* fix: remove hardcoded JAVA_HOME, use runtime default

* fix: add gradle wrapper for CI/CD build

* fix: use single line sam package command with hardcoded bucket

* fix: use existing stack name group2-englishstudy-chatting

* fix: add missing WEBSOCKET_ENDPOINT env var to WebSocket connect functions

* docs: update FRONTEND-API-GUIDE with new RoomType/RoomStatus structure

* feat : WebSocket Connect, Disconnect 핸들러 & SpeakingConnecion 모델 구현

* feat : WebSocket 메시지 처리 handler, service 구현

* feat : WebSocket 연결 정보 Repository 구현

* fix: update WebSocketDisconnectHandler to use GameSession model

- Remove references to deleted ChatRoom game fields
- Use GameSessionRepository to finish active game sessions
- Use ChatRoomRepository.updateStatus() for room state management

* perf: optimize CI/CD build time

- Add pip cache for SAM CLI dependencies
- Enable Gradle parallel builds and build cache
- Add SAM build cache (.aws-sam)
- Use sam build --parallel --cached
- Skip SAM CLI install if already cached
- Remove unnecessary 'clean' to leverage cache

* feat: add custom CodeBuild Docker image with pre-installed tools

- Dockerfile with Java 21 + SAM CLI + Gradle pre-installed
- build-and-push.sh script for ECR deployment
- Updated buildspec.yml for custom image (removes SAM CLI install)
- Expected build time reduction: ~30-40 seconds

* feature : AI 영어 회화 연습 기능 (#468)

* feat : WebSocket Connect, Disconnect 핸들러 & SpeakingConnecion 모델 구현

* feat : WebSocket 메시지 처리 handler, service 구현

* feat : WebSocket 연결 정보 Repository 구현

* fix: remove typo in SpeakingConnectionRepository

* fix : 오타 수정

* chore: trigger build test with custom Docker image

* chore: remove unnecessary newlines and whitespace across WebSocket handlers and related classes

* chore: remove unnecessary newlines and whitespace across WebSocket handlers and related classes

* refactor : websocket -> rest api 전환

* feat : speaking handler REST로 교체

* feat : speaking 관련 dto 생성

* refacotor : 기존 service 코드 로직 재사용 및 repository 리펙토링

* fix: add CORS headers to API Gateway error responses (#479)

API Gateway의 인증 실패 등 에러 응답에 CORS 헤더가 누락되어
CloudFront를 통한 프론트엔드 요청이 차단되는 문제 수정

- UNAUTHORIZED (401) 응답에 CORS 헤더 추가
- ACCESS_DENIED (403) 응답에 CORS 헤더 추가
- DEFAULT_4XX/5XX 응답에 CORS 헤더 추가
- EXPIRED_TOKEN 응답에 CORS 헤더 추가

* feat : speaking rest API 람다 함수 추가

---------

Co-authored-by: ddingjoo <ddingsha9@teambind.co.kr>

* refactor : speaking service 재사용

* refactor : AI 영어 회화 연습 코드 리팩토링

* feature : test 벡엔드 서버에 AI 말하기 연습 기능 배포 (#492)

* feat : WebSocket Connect, Disconnect 핸들러 & SpeakingConnecion 모델 구현

* feat : WebSocket 메시지 처리 handler, service 구현

* feat : WebSocket 연결 정보 Repository 구현

* fix : 오타 수정

* refactor : websocket -> rest api 전환

* feat : speaking handler REST로 교체

* feat : speaking 관련 dto 생성

* refacotor : 기존 service 코드 로직 재사용 및 repository 리펙토링

* feat : speaking rest API 람다 함수 추가

* refactor : speaking service 재사용

* refactor : AI 영어 회화 연습 코드 리팩토링

---------

Co-authored-by: DDING JOO <ddingsha9@teambind.co.kr>

* feat : handleChat 메서드 JsonNull 체크 푸가

* feature : handleChat 메서드 JsonNull 체크 추가 (#493)

* feat : WebSocket Connect, Disconnect 핸들러 & SpeakingConnecion 모델 구현

* feat : WebSocket 메시지 처리 handler, service 구현

* feat : WebSocket 연결 정보 Repository 구현

* fix : 오타 수정

* refactor : websocket -> rest api 전환

* feat : speaking handler REST로 교체

* feat : speaking 관련 dto 생성

* refacotor : 기존 service 코드 로직 재사용 및 repository 리펙토링

* feat : speaking rest API 람다 함수 추가

* refactor : speaking service 재사용

* refactor : AI 영어 회화 연습 코드 리팩토링

* feat : handleChat 메서드 JsonNull 체크 푸가

---------

Co-authored-by: DDING JOO <ddingsha9@teambind.co.kr>

* feat(news): 뉴스 학습 배지 시스템 구현 (#473)

- 14개 뉴스 관련 배지 추가 (읽기, 퀴즈, 단어수집, 연속학습, 마스터)
- UserStats에 뉴스 통계 필드 추가
- 6개 뉴스 배지 Strategy 클래스 생성
- 뉴스 읽기/퀴즈/단어수집 시 통계 업데이트 및 배지 체크 연동

* fix: add PATCH method to CORS AllowMethods

* test: BadgeType 개수 테스트 수정 (15 -> 29)

* fix: CORS PATCH 메서드 추가

* docs: 뉴스 기능 프론트엔드 연동 가이드 작성

* fix: NewsCollectionFunction에 Bedrock, Comprehend 권한 추가

* fix: add null check for collectWord request body

- Add INVALID_REQUEST error code to NewsErrorCode
- Check body and word field before accessing in collectWord()
- Prevents NullPointerException when request body is malformed

* feat: enhance stats API and bookmark response for frontend

- Add DAILY stats update for news read/quiz/word collection
- Add /stats/dashboard endpoint with frontend-requested format
  - today: wordsLearned, newsRead, quizzesTaken, wordsTotal
  - overall: totalWordsLearned, totalNewsRead, averageAccuracy, streaks
  - weeklyProgress: last 7 days with date/wordsLearned/newsRead
- Add news-related fields to all stats API responses
- Fix bookmark API to include full article details (title, summary, etc.)

* feat: add category classification to news AI analysis

- Add category field to AnalysisResult record
- Update Bedrock prompt to classify articles into categories
  (WORLD, POLITICS, BUSINESS, TECH, SCIENCE, HEALTH, SPORTS, ENTERTAINMENT, LIFESTYLE)
- Parse and set category from AI response
- Set GSI2 (CATEGORY#) index when category is available

* fix: add /stats/dashboard endpoint to template.yaml

* fix: filter by ARTICLE# prefix in findById to avoid returning UserNewsRecord

* docs: add News API troubleshooting guide

* feat: add Cognito authorizer to News API and enhance keyword extraction

- Set CognitoAuthorizer for all News API endpoints in template.yaml
- Update Bedrock AI to extract keywords with meanings and examples
- Add fallback to Comprehend for keyword extraction when Bedrock fails
- Modify KeywordInfo model to include example field
- Adjust AI prompt to include keyword extraction with examples
- Update AnalysisResult to store keywords and parse them from AI response

* Revert "Merge branch 'test' into prod"

This reverts commit c1a958eac6799d5838a76e4078ae304bcdb62278, reversing
changes made to a6662e0cfc46c6e12f20a89f0df285ff282160bc.

* feat: enhance bookmark and reading status tracking for News API

- Add bookmark and reading status to individual article responses
- Include bookmark status in paginated news responses
- Modify `KeywordInfo` to support Korean translations (`meaningKo`)
- Update AI prompts to extract Korean meanings for keywords

* refactor : session_id가 null 체크 추가

* feat : template 환경변수 리펙토링

* fix : sessionId NullPointerException 에러 수정  (#496)

* feat : WebSocket Connect, Disconnect 핸들러 & SpeakingConnecion 모델 구현

* feat : WebSocket 메시지 처리 handler, service 구현

* feat : WebSocket 연결 정보 Repository 구현

* fix : 오타 수정

* refactor : websocket -> rest api 전환

* feat : speaking handler REST로 교체

* feat : speaking 관련 dto 생성

* refacotor : 기존 service 코드 로직 재사용 및 repository 리펙토링

* feat : speaking rest API 람다 함수 추가

* refactor : speaking service 재사용

* refactor : AI 영어 회화 연습 코드 리팩토링

* feat : handleChat 메서드 JsonNull 체크 푸가

* refactor : session_id가 null 체크 추가

* feat : template 환경변수 리펙토링

---------

Co-authored-by: DDING JOO <ddingsha9@teambind.co.kr>

* feat: enhance bookmark and reading status tracking for News API

- Add bookmark and reading status to individual article responses
- Include bookmark status in paginated news responses
- Modify `KeywordInfo` to support Korean translations (`meaningKo`)
- Update AI prompts to extract Korean meanings for keywords

* feat: add category filtering to UserWord API with enhanced query logic

- Introduce `category` filtering to `getUserWords` API
- Update WordCategory enums to include "news" category
- Apply category filter after enrichment with word info
- Adjust query limits for bookmarked and incorrect words queries

* feat: add default value for ExistingCognitoClientId in template.yaml

- Set default to an empty string to ensure compatibility with templates using this parameter without explicitly specifying a value.

* fix: SpeakingHandler getStringOrNull 컴파일 에러 수정

* fix: SpeakingHandler getStringOrNull 컴파일 에러 수정

* fix: Bedrock 키워드(meaningKo 포함)를 article에 저장하도록 수정

* fix: Bedrock 키워드(meaningKo 포함)를 article에 저장하도록 수정

* fix: Bedrock 키워드(meaningKo 포함)를 article에 저장하도록 수정

* feat: add dashboard stats API and enhance news stats tracking

- Introduce `/stats/dashboard` API for retrieving integrated user stats (today, overall, weekly progress, and level distribution)
- Update `UserStats` model to include additional fields for news stats (newsRead, newsQuizCompleted, newsQuizPerfect, newsWordsCollected, etc.)
- Add atomic updates to track news reading, quiz, and word stats in `UserStatsRepository`
- Modify CloudFormation `template.yaml` to register the new `/stats/dashboard` endpoint

* feat: add dashboard stats API and enhance news stats tracking

- Introduce `/stats/dashboard` API for retrieving integrated user stats (today, overall, weekly progress, and level distribution)
- Update `UserStats` model to include additional fields for news stats (newsRead, newsQuizCompleted, newsQuizPerfect, newsWordsCollected, etc.)
- Add atomic updates to track news reading, quiz, and word stats in `UserStatsRepository`
- Modify CloudFormation `template.yaml` to register the new `/stats/dashboard` endpoint

* feat: add dashboard stats API and enhance news stats tracking

- Introduce `/stats/dashboard` API for retrieving integrated user stats (today, overall, weekly progress, and level distribution)
- Update `UserStats` model to include additional fields for news stats (newsRead, newsQuizCompleted, newsQuizPerfect, newsWordsCollected, etc.)
- Add atomic updates to track news reading, quiz, and word stats in `UserStatsRepository`
- Modify CloudFormation `template.yaml` to register the new `/stats/dashboard` endpoint

* refactor: format code with consistent indentation and spacing

- Apply consistent formatting to improve code readability across multiple files
- Adjust indentation, spacing, and alignment in model classes, DTOs, and repository methods

* fix: filter by ARTICLE# prefix in findById to avoid returning bookmark records

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* feat : Speaking 관련 template 람다 함수 및 테이블 추가

* feat : 말하기 기능에 polly 서비스 권한 추가

---------

Co-authored-by: DDING JOO <ddingsha9@teambind.co.kr>
Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>

* feature : transcribe API KEY 추가  (#516)

* feat: EnvConfig 유틸리티 추가 및 환경 변수 검증 적용

환경 변수 미설정 시 명확한 에러 메시지를 제공하는 EnvConfig 유틸리티를 추가하고,
기존 System.getenv 호출을 EnvConfig.getRequired/getOrDefault로 대체함.

- EnvConfig: getRequired, getOrDefault, getIntOrDefault, getLongOrDefault 메서드 제공
- Lambda Cold Start 시점에 환경 변수 누락을 조기 감지
- 기존 Config 클래스(WebSocketConfig, RoomTokenConfig) EnvConfig 사용으로 통일

Closes #403

* refactor: TestService submitTest 메서드 책임 분리

submitTest 메서드를 단일 책임 원칙에 맞게 리팩토링:
- gradeAnswers(): 답안 채점 및 결과 집계
- isAnswerCorrect(): 단일 답안 정답 여부 판단
- buildResultItem(): 결과 항목 생성
- saveTestResult(): 테스트 결과 저장
- GradingResult record: 채점 결과 캡슐화

TestService와 TestCommandService 모두 동일하게 적용

Closes #404

* refactor: 하드코딩된 설정값 환경 변수로 외부화

각 도메인별 Config 클래스를 생성하여 하드코딩된 값들을 환경 변수로 설정 가능하게 변경.
기본값이 있어 환경 변수 미설정 시에도 기존 동작 유지.

## 새로 추가된 Config 클래스
- GrammarConfig: SESSION_TTL_DAYS, MAX_HISTORY_MESSAGES, MAX_TOKENS 등
- GameConfig: TOTAL_ROUNDS, ROUND_TIME_LIMIT, QUICK_GUESS_THRESHOLD_MS
- VocabularyConfig: NEW_WORDS_COUNT, REVIEW_WORDS_COUNT, 상태 전이 임계값 등

## 지원하는 환경 변수
- GRAMMAR_SESSION_TTL_DAYS, GRAMMAR_MAX_HISTORY_MESSAGES, GRAMMAR_MAX_TOKENS
- GAME_TOTAL_ROUNDS, GAME_ROUND_TIME_LIMIT, GAME_QUICK_GUESS_THRESHOLD_MS
- VOCAB_NEW_WORDS_COUNT, VOCAB_REVIEW_WORDS_COUNT
- VOCAB_TRANSITION_TO_REVIEWING, VOCAB_TRANSITION_TO_MASTERED

Closes #406

* test: StudyLevel enum 단위 테스트 추가

* test: Difficulty enum 단위 테스트 추가

* test: StudyConfig 단위 테스트 추가

* test: EnvConfig 단위 테스트 추가

* test: PaginatedResult 단위 테스트 추가

* test: JsonUtil 단위 테스트 추가

* test: CursorUtil 단위 테스트 추가

* test: CommonErrorCode 단위 테스트 추가

* test: CommonException 단위 테스트 추가

* test: BadgeType enum 단위 테스트 추가

* test: BadgeKey 상수 단위 테스트 추가

* test: WordStatus enum 단위 테스트 추가

* test: TestType enum 단위 테스트 추가

* test: VocabularyConfig 단위 테스트 추가

* test: VocabKey 상수 단위 테스트 추가

* test: VocabularyErrorCode 단위 테스트 추가

* test: VocabularyException 단위 테스트 추가

* test: SpacedRepetitionContext 단위 테스트 추가

* test: GrammarLevel enum 단위 테스트 추가

* test: GrammarConfig 단위 테스트 추가

* test: GrammarErrorCode 단위 테스트 추가

* test: GrammarException 단위 테스트 추가

* test: GameStatus enum 단위 테스트 추가

* test: GameConfig 단위 테스트 추가

* test: ChattingErrorCode 단위 테스트 추가

* test: ChattingException 단위 테스트 추가

* fix: OPIc FeedbackResponse.java 문법 오류 수정

* style: AwsClients 코드 포맷팅

* style: EnvConfig 코드 포맷팅

* style: RoomTokenConfig 코드 포맷팅

* style: WebSocketConfig 코드 포맷팅

* style: JsonUtil 코드 포맷팅

* style: GameConfig 코드 포맷팅

* style: GrammarConfig 코드 포맷팅

* style: GrammarKey 코드 포맷팅

* style: GrammarErrorCode 코드 포맷팅

* style: GrammarException 코드 포맷팅

* style: BedrockGrammarCheckFactory 코드 포맷팅

* style: GrammarConversationService 코드 포맷팅

* style: FeedbackResponse 코드 포맷팅

* style: SessionReportResponse 코드 포맷팅

* style: SpeakingError 코드 포맷팅

* style: SpeakingErrorType 코드 포맷팅

* style: OPIcException 코드 포맷팅

* style: OPIcAnswer 코드 포맷팅

* style: OPIcQuestion 코드 포맷팅

* style: OPIcSession 코드 포맷팅

* style: OPIcRepository 코드 포맷팅

* style: FeedbackService 코드 포맷팅

* style: TranscribeProxyService 코드 포맷팅

* style: VocabularyConfig 코드 포맷팅

* style: DailyStudyCommandService 코드 포맷팅

* style: TestCommandService 코드 포맷팅

* style: TestService 코드 포맷팅

* style: CommonErrorCodeSpec 코드 포맷팅

* style: JsonUtilSpec 코드 포맷팅

* style: BadgeTypeSpec 코드 포맷팅

* style: ChattingErrorCodeSpec 코드 포맷팅

* style: GrammarLevelSpec 코드 포맷팅

* style: GrammarErrorCodeSpec 코드 포맷팅

* style: VocabularyErrorCodeSpec 코드 포맷팅

* feature : OPIc 세션관리 + 답변 처리 파이프라인 구현  (#413)

* feat : OPIc 질문 & 세션 관련 dto 생성

* refactor : @DynamoDbBean 주석 추가

* feat : 주제 + 소주제 + 레벨로 오픽 질문 조회 추가

* feat : OPIc 세션, 질문, 답변 종합 handler 구현

* feat : 오픽 주제, 소주제별 seed 데이터 추가

* refactor : Transcribe API KEY 환경변수명 수정

* refactor : Bedrock에 사용하는 클로드 모델 변경

* refactor : S3 Key 대신 Proxy에서 요청하는 Base64 값으로 변환

* feat: GAME_START, ROUND_END 메시지에 serverTime 추가

- broadcastGameStart(): serverTime, roundDuration 필드 추가
- broadcastRoundEnd(): serverTime, roundStartTime, roundDuration 필드 추가
- GameService.endRound(): data에 roundStartTime, roundDuration 포함
- 타이머 동기화 버그 수정을 위한 서버 시간 제공

* feat: WebSocketMessageHelper 유틸리티 클래스 추가

- domain 필드 포함 메시지 생성 헬퍼
- DOMAIN_CHAT, DOMAIN_GAME 상수 정의
- buildChatMessage(), buildGameMessage() 메서드

* feat: 모든 WebSocket 메시지에 domain 필드 추가

- ScoreUpdateMessage에 domain 필드 추가
- broadcastGameStart에 domain:"game" 추가
- broadcastRoundEnd에 domain:"game" 추가
- broadcastCorrectAnswerMessage에 domain:"game" 추가
- handleCommandResult 시스템 메시지에 domain:"game" 추가
- handleRegularMessage 채팅 메시지에 domain:"chat" 추가

Closes #426, #427

* feat: GameSession 모델 클래스 생성

- DynamoDB Enhanced Client 어노테이션 적용
- GSI1: roomId로 활성 게임 세션 조회 가능
- 게임 상태 관리용 헬퍼 메서드 포함

Closes #428

* feat: GameSessionRepository 구현

- 기본 CRUD (save, findById, delete)
- roomId로 활성/전체 게임 세션 조회
- 상태, 라운드, 점수 업데이트 메서드
- 정답자 추가, 힌트 사용, 게임 종료 처리

Closes #429

* refactor: ChatRoom에서 게임 필드 분리

- 게임 관련 필드 제거 (gameStatus, currentRound 등)
- activeGameSessionId 필드 추가
- 게임 상태는 GameSession으로 분리됨

Note: 의존 코드 수정은 #431에서 진행

Closes #430

* refactor: GameSession 기반으로 전체 게임 로직 리팩토링

- GameService: ChatRoom 대신 GameSession 사용
- GameStatsService: GameSession 매개변수로 변경
- CommandService: GameSession 기반 점수 조회
- GameHandler: GameSession 기반 REST API
- WebSocketMessageHandler: GameSession 기반 브로드캐스트
- GameStatusResponse, ScoreboardResponse: GameSession 매개변수

Closes #431

* feat: GameSessionHandler Lambda 및 게임 세션 API 구현

- POST /rooms/{roomId}/games - 게임 세션 생성
- GET /games/{gameSessionId} - 게임 상태 조회 (재접속용)
- POST /games/{gameSessionId}/start - 게임 시작
- POST /games/{gameSessionId}/stop - 게임 종료

모든 응답에 serverTime 포함 (타이머 동기화)
출제자에게만 currentWord 포함

Closes #432, #433

* feat: 게임 시작 7분 후 자동 종료 기능 구현

- GameConfig에 gameTimeLimit() 메서드 추가 (기본값: 420초)
- GameSchedulerClient 유틸리티 클래스 생성 (EventBridge Scheduler 연동)
- GameService에 스케줄 생성/취소 로직 추가
- GameAutoCloseHandler Lambda 함수 생성
- template.yaml에 Lambda, IAM Role, Schedule Group 추가

Closes #417

* fix : 메모리 증가 및 Lambda 응답 제한 시간 Cognito 트리거 제한시간과 동일하게 수정 (#439)

* feat: 캐치마인드 게임 방 분리 기능 구현 (#455)

- Room 타입 분리 (CHAT/GAME)
  - RoomType, RoomStatus enum 추가
  - ChatRoom 모델에 type, gameType, gameSettings, status, hostId 필드 추가
  - GameSettings 모델 추가

- 방 생성/조회 API 수정
  - CreateRoomRequest에 type, gameType, gameSettings 필드 추가
  - 방 목록 조회 시 type, gameType, status 필터 지원

- 게임 시작 조건 검증
  - GAME 타입 방에서만 게임 시작 가능 (GAME_007 에러)

- 게임 재시작 API 구현 (#452)
  - POST /rooms/{roomId}/game/restart 엔드포인트 추가
  - 방장만 재시작 가능 (GAME_009 에러)
  - 게임 진행 중 재시작 불가 (GAME_008 에러)

- 방장 변경 로직 구현 (#453)
  - 방장 퇴장 시 다음 멤버에게 자동 이전
  - 모든 멤버 퇴장 시 방 자동 삭제

- WebSocket 메시지 타입 추가 (#454)
  - ROOM_STATUS_CHANGE, HOST_CHANGE 메시지 타입 추가
  - WebSocketMessageHelper에 빌더 메서드 추가

- 테스트 추가
  - RoomType, RoomStatus enum 테스트
  - GameSettings 모델 테스트
  - ChattingErrorCode 테스트 업데이트

Related: #440, #441, #442, #443, #444, #445, #446
Closes: #447, #448, #449, #450, #451, #452, #453, #454

* feat: 참가자 닉네임 및 방장 변경 WebSocket 알림 구현 (#456)

- RoomParticipant DTO 추가 (userId, nickname, isHost)
- ChatRoomQueryService에 닉네임 조회 메서드 추가
  - getParticipantsWithNicknames(): 참가자 목록 + 닉네임
  - getHostNickname(): 방장 닉네임 조회
- ChatRoomHandler.getRoom() 응답에 participants, hostNickname 추가
- ChatRoomCommandService.leaveRoom()에서 방장 변경 시 WebSocket 브로드캐스트

Related: #440

* fix: ChatRoomFunction에 UserTable DynamoDB 권한 추가

- 참가자/방장 닉네임 조회를 위한 UserTable 읽기 권한 추가
- DynamoDBReadPolicy로 UserTable 접근 허용

Fixes #457

* fix: GameSettings에 @DynamoDbBean 어노테이션 추가

- DynamoDB Enhanced Client가 중첩 객체를 직렬화/역직렬화할 수 있도록 수정
- ChatRoom 저장/조회 시 GameSettings 변환 오류 해결

Fixes #457

* fix: ChatRoomFunction에 WEBSOCKET_ENDPOINT 환경변수 및 권한 추가

- leaveRoom에서 WebSocketBroadcaster 사용을 위한 환경변수 추가
- execute-api:ManageConnections 권한 추가

* fix: WebSocket Lambda 함수들에 WEBSOCKET_ENDPOINT 환경변수 추가

- WebSocketConnectFunction에 WEBSOCKET_ENDPOINT 추가
- WebSocketDisconnectFunction에 WEBSOCKET_ENDPOINT 추가
- execute-api:ManageConnections 권한 추가

* fix: Grammar WebSocket Lambda 환경 변수 및 권한 추가

- GrammarStreamingConnectFunction에 WEBSOCKET_ENDPOINT 환경 변수 추가
- GrammarStreamingDisconnectFunction에 WEBSOCKET_ENDPOINT 환경 변수 추가
- 두 함수에 execute-api:ManageConnections 권한 추가

* feat: GSI1SK 확장성 있는 재설계 및 DB 레벨 필터링

## 변경 사항

### GSI1SK 포맷 변경
- 기존: {level}#{createdAt}
- 신규: {type}#{gameType}#{status}#{level}#{createdAt}

### 지원 쿼리 패턴
- 전체 방: GSI1PK = "ROOMS"
- 게임방만: begins_with(GSI1SK, "GAME#")
- 캐치마인드만: begins_with(GSI1SK, "GAME#CATCHMIND#")
- 대기중 캐치마인드: begins_with(GSI1SK, "GAME#CATCHMIND#WAITING#")

### 파일 수정
- ChatRoomCommandService.java: 방 생성 시 새 GSI1SK 포맷 적용
- ChatRoomRepository.java: findByFilters() 메서드 추가, updateStatus() 메서드 추가
- ChatRoomQueryService.java: 메모리 필터링 제거, DB 레벨 필터링으로 변경
- GameService.java: 게임 시작/종료 시 방 상태 업데이트 (GSI1SK 포함)

### 마이그레이션
- scripts/migrate-gsi1sk.sh: 기존 데이터 마이그레이션 스크립트
- 37개 기존 방 마이그레이션 완료

* fix: increase stats query limit to 100 days

- Adjust maximum allowable limit for recent stats query from 30 to 100 days to support extended data range responses.

* feat: improve game round and connection management logic

- Added handling for game round timeout (`ROUND_TIMEOUT`) in WebSocketMessageHandler.
- Enhanced game start broadcast to include `currentWord` for the drawer only.
- Updated ConnectionRepository to remove duplicate user connections in the same room.
- Added `currentWordEnglish` to GameSession for better answer verification.
- Normalized ChatRoom levels to match database storage format.
- Updated template.yaml to include DynamoDBReadPolicy for VocabTable.

* refactor: 코드 정리 및 미사용 클래스 제거 (#459)

* refactor: remove unused WebSocketResponseUtil

* refactor: add AutoCloseable to WebSocketBroadcaster

* refactor: remove unused TestService

* refactor: remove unused WordService

* refactor: remove unused DailyStudyService

* refactor: remove unused UserWordService

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* fix: resolve N+1 query in StatsService

* refactor(all): DI 패턴 및 전략 패턴 적용 (#461)

- Repository, Service, Handler에 DI 생성자 추가 (테스트 용이성)
- BadgeService에 Strategy 패턴 적용 (뱃지 조건 검증 로직 분리)

* refactor: relocate and restructure seed data files

- Moved `question-homes.json` and `words.json` from subdirectories to `seed` folder.
- Updated file paths for better organization and clarity.

* chore: seed 데이터 폴더 구조 정리

* feat: add CI/CD pipeline configuration for CodePipeline

* fix: add SNS topic policy and DependsOn for notification rule

* fix: correct paths in buildspec.yml for CodeBuild

* fix: remove hardcoded JAVA_HOME, use runtime default

* fix: add gradle wrapper for CI/CD build

* fix: use single line sam package command with hardcoded bucket

* fix: use existing stack name group2-englishstudy-chatting

* fix: add missing WEBSOCKET_ENDPOINT env var to WebSocket connect functions

* docs: update FRONTEND-API-GUIDE with new RoomType/RoomStatus structure

* feat : WebSocket Connect, Disconnect 핸들러 & SpeakingConnecion 모델 구현

* feat : WebSocket 메시지 처리 handler, service 구현

* feat : WebSocket 연결 정보 Repository 구현

* fix: update WebSocketDisconnectHandler to use GameSession model

- Remove references to deleted ChatRoom game fields
- Use GameSessionRepository to finish active game sessions
- Use ChatRoomRepository.updateStatus() for room state management

* perf: optimize CI/CD build time

- Add pip cache for SAM CLI dependencies
- Enable Gradle parallel builds and build cache
- Add SAM build cache (.aws-sam)
- Use sam build --parallel --cached
- Skip SAM CLI install if already cached
- Remove unnecessary 'clean' to leverage cache

* feat: add custom CodeBuild Docker image with pre-installed tools

- Dockerfile with Java 21 + SAM CLI + Gradle pre-installed
- build-and-push.sh script for ECR deployment
- Updated buildspec.yml for custom image (removes SAM CLI install)
- Expected build time reduction: ~30-40 seconds

* feature : AI 영어 회화 연습 기능 (#468)

* feat : WebSocket Connect, Disconnect 핸들러 & SpeakingConnecion 모델 구현

* feat : WebSocket 메시지 처리 handler, service 구현

* feat : WebSocket 연결 정보 Repository 구현

* fix: remove typo in SpeakingConnectionRepository

* fix : 오타 수정

* chore: trigger build test with custom Docker image

* chore: remove unnecessary newlines and whitespace across WebSocket handlers and related classes

* chore: remove unnecessary newlines and whitespace across WebSocket handlers and related classes

* Release: 캐치마인드 게임 분리, AI 회화 연습, CI/CD 파이프라인 (#469)

* feature : OPIc 세션관리 + 답변 처리 파이프라인 구현  (#413)

* feat : OPIc 질문 & 세션 관련 dto 생성

* refactor : @DynamoDbBean 주석 추가

* feat : 주제 + 소주제 + 레벨로 오픽 질문 조회 추가

* feat : OPIc 세션, 질문, 답변 종합 handler 구현

* feat : 오픽 주제, 소주제별 seed 데이터 추가

* refactor : Transcribe API KEY 환경변수명 수정

* refactor : Bedrock에 사용하는 클로드 모델 변경

* refactor : S3 Key 대신 Proxy에서 요청하는 Base64 값으로 변환

* feat: GAME_START, ROUND_END 메시지에 serverTime 추가

- broadcastGameStart(): serverTime, roundDuration 필드 추가
- broadcastRoundEnd(): serverTime, roundStartTime, roundDuration 필드 추가
- GameService.endRound(): data에 roundStartTime, roundDuration 포함
- 타이머 동기화 버그 수정을 위한 서버 시간 제공

* feat: WebSocketMessageHelper 유틸리티 클래스 추가

- domain 필드 포함 메시지 생성 헬퍼
- DOMAIN_CHAT, DOMAIN_GAME 상수 정의
- buildChatMessage(), buildGameMessage() 메서드

* feat: 모든 WebSocket 메시지에 domain 필드 추가

- ScoreUpdateMessage에 domain 필드 추가
- broadcastGameStart에 domain:"game" 추가
- broadcastRoundEnd에 domain:"game" 추가
- broadcastCorrectAnswerMessage에 domain:"game" 추가
- handleCommandResult 시스템 메시지에 domain:"game" 추가
- handleRegularMessage 채팅 메시지에 domain:"chat" 추가

Closes #426, #427

* feat: GameSession 모델 클래스 생성

- DynamoDB Enhanced Client 어노테이션 적용
- GSI1: roomId로 활성 게임 세션 조회 가능
- 게임 상태 관리용 헬퍼 메서드 포함

Closes #428

* feat: GameSessionRepository 구현

- 기본 CRUD (save, findById, delete)
- roomId로 활성/전체 게임 세션 조회
- 상태, 라운드, 점수 업데이트 메서드
- 정답자 추가, 힌트 사용, 게임 종료 처리

Closes #429

* refactor: ChatRoom에서 게임 필드 분리

- 게임 관련 필드 제거 (gameStatus, currentRound 등)
- activeGameSessionId 필드 추가
- 게임 상태는 GameSession으로 분리됨

Note: 의존 코드 수정은 #431에서 진행

Closes #430

* refactor: GameSession 기반으로 전체 게임 로직 리팩토링

- GameService: ChatRoom 대신 GameSession 사용
- GameStatsService: GameSession 매개변수로 변경
- CommandService: GameSession 기반 점수 조회
- GameHandler: GameSession 기반 REST API
- WebSocketMessageHandler: GameSession 기반 브로드캐스트
- GameStatusResponse, ScoreboardResponse: GameSession 매개변수

Closes #431

* feat: GameSessionHandler Lambda 및 게임 세션 API 구현

- POST /rooms/{roomId}/games - 게임 세션 생성
- GET /games/{gameSessionId} - 게임 상태 조회 (재접속용)
- POST /games/{gameSessionId}/start - 게임 시작
- POST /games/{gameSessionId}/stop - 게임 종료

모든 응답에 serverTime 포함 (타이머 동기화)
출제자에게만 currentWord 포함

Closes #432, #433

* feat: 게임 시작 7분 후 자동 종료 기능 구현

- GameConfig에 gameTimeLimit() 메서드 추가 (기본값: 420초)
- GameSchedulerClient 유틸리티 클래스 생성 (EventBridge Scheduler 연동)
- GameService에 스케줄 생성/취소 로직 추가
- GameAutoCloseHandler Lambda 함수 생성
- template.yaml에 Lambda, IAM Role, Schedule Group 추가

Closes #417

* fix : 메모리 증가 및 Lambda 응답 제한 시간 Cognito 트리거 제한시간과 동일하게 수정 (#439)

* feat: 캐치마인드 게임 방 분리 기능 구현 (#455)

- Room 타입 분리 (CHAT/GAME)
  - RoomType, RoomStatus enum 추가
  - ChatRoom 모델에 type, gameType, gameSettings, status, hostId 필드 추가
  - GameSettings 모델 추가

- 방 생성/조회 API 수정
  - CreateRoomRequest에 type, gameType, gameSettings 필드 추가
  - 방 목록 조회 시 type, gameType, status 필터 지원

- 게임 시작 조건 검증
  - GAME 타입 방에서만 게임 시작 가능 (GAME_007 에러)

- 게임 재시작 API 구현 (#452)
  - POST /rooms/{roomId}/game/restart 엔드포인트 추가
  - 방장만 재시작 가능 (GAME_009 에러)
  - 게임 진행 중 재시작 불가 (GAME_008 에러)

- 방장 변경 로직 구현 (#453)
  - 방장 퇴장 시 다음 멤버에게 자동 이전
  - 모든 멤버 퇴장 시 방 자동 삭제

- WebSocket 메시지 타입 추가 (#454)
  - ROOM_STATUS_CHANGE, HOST_CHANGE 메시지 타입 추가
  - WebSocketMessageHelper에 빌더 메서드 추가

- 테스트 추가
  - RoomType, RoomStatus enum 테스트
  - GameSettings 모델 테스트
  - ChattingErrorCode 테스트 업데이트

Related: #440, #441, #442, #443, #444, #445, #446
Closes: #447, #448, #449, #450, #451, #452, #453, #454

* feat: 참가자 닉네임 및 방장 변경 WebSocket 알림 구현 (#456)

- RoomParticipant DTO 추가 (userId, nickname, isHost)
- ChatRoomQueryService에 닉네임 조회 메서드 추가
  - getParticipantsWithNicknames(): 참가자 목록 + 닉네임
  - getHostNickname(): 방장 닉네임 조회
- ChatRoomHandler.getRoom() 응답에 participants, hostNickname 추가
- ChatRoomCommandService.leaveRoom()에서 방장 변경 시 WebSocket 브로드캐스트

Related: #440

* fix: ChatRoomFunction에 UserTable DynamoDB 권한 추가

- 참가자/방장 닉네임 조회를 위한 UserTable 읽기 권한 추가
- DynamoDBReadPolicy로 UserTable 접근 허용

Fixes #457

* fix: GameSettings에 @DynamoDbBean 어노테이션 추가

- DynamoDB Enhanced Client가 중첩 객체를 직렬화/역직렬화할 수 있도록 수정
- ChatRoom 저장/조회 시 GameSettings 변환 오류 해결

Fixes #457

* fix: ChatRoomFunction에 WEBSOCKET_ENDPOINT 환경변수 및 권한 추가

- leaveRoom에서 WebSocketBroadcaster 사용을 위한 환경변수 추가
- execute-api:ManageConnections 권한 추가

* fix: WebSocket Lambda 함수들에 WEBSOCKET_ENDPOINT 환경변수 추가

- WebSocketConnectFunction에 WEBSOCKET_ENDPOINT 추가
- WebSocketDisconnectFunction에 WEBSOCKET_ENDPOINT 추가
- execute-api:ManageConnections 권한 추가

* fix: Grammar WebSocket Lambda 환경 변수 및 권한 추가

- GrammarStreamingConnectFunction에 WEBSOCKET_ENDPOINT 환경 변수 추가
- GrammarStreamingDisconnectFunction에 WEBSOCKET_ENDPOINT 환경 변수 추가
- 두 함수에 execute-api:ManageConnections 권한 추가

* feat: GSI1SK 확장성 있는 재설계 및 DB 레벨 필터링

## 변경 사항

### GSI1SK 포맷 변경
- 기존: {level}#{createdAt}
- 신규: {type}#{gameType}#{status}#{level}#{createdAt}

### 지원 쿼리 패턴
- 전체 방: GSI1PK = "ROOMS"
- 게임방만: begins_with(GSI1SK, "GAME#")
- 캐치마인드만: begins_with(GSI1SK, "GAME#CATCHMIND#")
- 대기중 캐치마인드: begins_with(GSI1SK, "GAME#CATCHMIND#WAITING#")

### 파일 수정
- ChatRoomCommandService.java: 방 생성 시 새 GSI1SK 포맷 적용
- ChatRoomRepository.java: findByFilters() 메서드 추가, updateStatus() 메서드 추가
- ChatRoomQueryService.java: 메모리 필터링 제거, DB 레벨 필터링으로 변경
- GameService.java: 게임 시작/종료 시 방 상태 업데이트 (GSI1SK 포함)

### 마이그레이션
- scripts/migrate-gsi1sk.sh: 기존 데이터 마이그레이션 스크립트
- 37개 기존 방 마이그레이션 완료

* fix: increase stats query limit to 100 days

- Adjust maximum allowable limit for recent stats query from 30 to 100 days to support extended data range responses.

* feat: improve game round and connection management logic

- Added handling for game round timeout (`ROUND_TIMEOUT`) in WebSocketMessageHandler.
- Enhanced game start broadcast to include `currentWord` for the drawer only.
- Updated ConnectionRepository to remove duplicate user connections in the same room.
- Added `currentWordEnglish` to GameSession for better answer verification.
- Normalized ChatRoom levels to match database storage format.
- Updated template.yaml to include DynamoDBReadPolicy for VocabTable.

* refactor: 코드 정리 및 미사용 클래스 제거 (#459)

* refactor: remove unused WebSocketResponseUtil

* refactor: add AutoCloseable to WebSocketBroadcaster

* refactor: remove unused TestService

* refactor: remove unused WordService

* refactor: remove unused DailyStudyService

* refactor: remove unused UserWordService

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* fix: resolve N+1 query in StatsService

* refactor(all): DI 패턴 및 전략 패턴 적용 (#461)

- Repository, Service, Handler에 DI 생성자 추가 (테스트 용이성)
- BadgeService에 Strategy 패턴 적용 (뱃지 조건 검증 로직 분리)

* refactor: relocate and restructure seed data files

- Moved `question-homes.json` and `words.json` from subdirectories to `seed` folder.
- Updated file paths for better organization and clarity.

* chore: seed 데이터 폴더 구조 정리

* feat: add CI/CD pipeline configuration for CodePipeline

* fix: add SNS topic policy and DependsOn for notification rule

* fix: correct paths in buildspec.yml for CodeBuild

* fix: remove hardcoded JAVA_HOME, use runtime default

* fix: add gradle wrapper for CI/CD build

* fix: use single line sam package command with hardcoded bucket

* fix: use existing stack name group2-englishstudy-chatting

* fix: add missing WEBSOCKET_ENDPOINT env var to WebSocket connect functions

* docs: update FRONTEND-API-GUIDE with new RoomType/RoomStatus structure

* fix: update WebSocketDisconnectHandler to use GameSession model

- Remove references to deleted ChatRoom game fields
- Use GameSessionRepository to finish active game sessions
- Use ChatRoomRepository.updateStatus() for room state management

* perf: optimize CI/CD build time

- Add pip cache for SAM CLI dependencies
- Enable Gradle parallel builds and build cache
- Add SAM build cache (.aws-sam)
- Use sam build --parallel --cached
- Skip SAM CLI install if already cached
- Remove unnecessary 'clean' to leverage cache

* feat: add custom CodeBuild Docker image with pre-installed tools

- Dockerfile with Java 21 + SAM CLI + Gradle pre-installed
- build-and-push.sh script for ECR deployment
- Updated buildspec.yml for custom image (removes SAM CLI install)
- Expected build time reduction: ~30-40 seconds

* feature : AI 영어 회화 연습 기능 (#468)

* feat : WebSocket Connect, Disconnect 핸들러 & SpeakingConnecion 모델 구현

* feat : WebSocket 메시지 처리 handler, service 구현

* feat : WebSocket 연결 정보 Repository 구현

* fix: remove typo in SpeakingConnectionRepository

* chore: trigger build test with custom Docker image

* chore: remove unnecessary newlines and whitespace across WebSocket handlers and related classes

* chore: remove unnecessary newlines and whitespace across WebSocket handlers and related classes

---------

Co-authored-by: hyein Heo <128613248+hye-inA@users.noreply.github.com>

* refactor : websocket -> rest api 전환

* feat : speaking handler REST로 교체

* feat : speaking 관련 dto 생성

* refacotor : 기존 service 코드 로직 재사용 및 repository 리펙토링

* fix: add CORS headers to API Gateway error responses (#479)

API Gateway의 인증 실패 등 에러 응답에 CORS 헤더가 누락되어
CloudFront를 통한 프론트엔드 요청이 차단되는 문제 수정

- UNAUTHORIZED (401) 응답에 CORS 헤더 추가
- ACCESS_DENIED (403) 응답에 CORS 헤더 추가
- DEFAULT_4XX/5XX 응답에 CORS 헤더 추가
- EXPIRED_TOKEN 응답에 CORS 헤더 추가

* feat(news): 뉴스 도메인 기반 구조 구축 (#385)

- NewsCategory, QuizType enum 추가
- NewsKey 상수 클래스 추가
- NewsErrorCode 예외 클래스 추가
- NewsArticle, KeywordInfo, QuizQuestion 모델 추가
- NewsArticleRepository CRUD 구현
- NewsTable DynamoDB 테이블 정의
- CORS GatewayResponses 설정 추가

* feat(news): 뉴스 수집 파이프라인 구현 (#386)

- NewsApiClient: NewsAPI 연동 서비스
- RssFeedParser: RSS 피드 파싱 (BBC, VOA, NPR)
- NewsDuplicateChecker: URL 기반 중복 필터링
- NewsCollectorService: 수집 오케스트레이션
- NewsCollectionHandler: Lambda 핸들러
- EventBridge 스케줄러: 매일 18시 KST 실행

* refactor(news): NewsAPI 제거, RSS만 사용

- NewsApiClient 삭제
- SSM Parameter 의존성 제거
- RSS 소스당 7개씩 수집 (BBC, VOA, NPR = 약 21개/일)

* feat(news): AI 뉴스 분석 시스템 구현 (#387)

- NewsAnalysisService: AI 분석 통합 서비스
  - Bedrock: CEFR 난이도 분석 (A1~C2)
  - Bedrock: 3줄 요약 + 퀴즈 3문제 생성
  - Comprehend: 핵심 키워드 추출
- NewsCollectorService: 수집 시 자동 분석 연동
- GSI1/GSI2 키 자동 설정 (레벨별, 카테고리별 조회)

* feat(news): 뉴스 학습 API 구현 (#388)

- NewsQueryService: 뉴스 조회 서비스
- NewsHandler: API 핸들러
  - GET /news - 목록 조회 (level, category 필터)
  - GET /news/today - 오늘의 뉴스
  - GET /news/recommended - 내 레벨 맞춤 추천
  - GET /news/{articleId} - 상세 조회 (조회수 증가)
- template.yaml: NewsFunction Lambda 추가

* feat(news): 뉴스 학습 부가 기능 구현 (#389)

- 읽기 완료 기록 API (POST /news/{articleId}/read)
- 북마크 토글 API (POST /news/{articleId}/bookmark)
- 북마크 목록 조회 API (GET /news/bookmarks)
- 학습 통계 조회 API (GET /news/stats)
- TTS 오디오 URL 조회 API (GET /news/{articleId}/audio)
- UserNewsRecord 모델 추가
- UserNewsRepository 추가
- NewsLearningService 추가

* feat(news): 복합 퀴즈 시스템 구현 (#471)

- 퀴즈 조회 API (GET /news/{articleId}/quiz)
- 퀴즈 제출 API (POST /news/{articleId}/quiz)
- 퀴즈 기록 조회 API (GET /news/quiz/history)
- NewsQuizResult 모델 추가
- QuizAnswerResult 모델 추가
- NewsQuizRepository 추가
- NewsQuizService 추가

* feat(news): 단어 수집 & Vocabulary 연동 구현 (#472)

- 단어 수집 API (POST /news/{articleId}/words)
- 수집 단어 목록 API (GET /news/words)
- 단어 상세 조회 API (GET /news/{articleId}/words/{word})
- 단어 삭제 API (DELETE /news/{articleId}/words/{word})
- Vocabulary 연동 API (POST /news/words/{word}/sync)
- NewsWordCollect 모델 추가
- NewsWordRepository 추가
- NewsWordService 추가

* feat: add multi-environment deployment support (dev/test/prod)

* fix: update buildspec.yml to deploy prod environment with parameter overrides

* feat(news): 뉴스 도메인 기반 구조 구축 (#385)

- NewsCategory, QuizType enum 추가
- NewsKey 상수 클래스 추가
- NewsErrorCode 예외 클래스 추가
- NewsArticle, KeywordInfo, QuizQuestion 모델 추가
- NewsArticleRepository CRUD 구현
- NewsTable DynamoDB 테이블 정의
- CORS GatewayResponses 설정 추가

* feat(news): 뉴스 수집 파이프라인 구현 (#386)

- NewsApiClient: NewsAPI 연동 서비스
- RssFeedParser: RSS 피드 파싱 (BBC, VOA, NPR)
- NewsDuplicateChecker: URL 기반 중복 필터링
- NewsCollectorService: 수집 오케스트레이션
- NewsCollectionHandler: Lambda 핸들러
- EventBridge 스케줄러: 매일 18시 KST 실행

* refactor(news): NewsAPI 제거, RSS만 사용

- NewsApiClient 삭제
- SSM Parameter 의존성 제거
- RSS 소스당 7개씩 수집 (BBC, VOA, NPR = 약 21개/일)

* feat(news): AI 뉴스 분석 시스템 구현 (#387)

- NewsAnalysisService: AI 분석 통합 서비스
  - Bedrock: CEFR 난이도 분석 (A1~C2)
  - Bedrock: 3줄 요약 + 퀴즈 3문제 생성
  - Comprehend: 핵심 키워드 추출
- NewsCollectorService: 수집 시 자동 분석 연동
- GSI1/GSI2 키 자동 설정 (레벨별, 카테고리별 조회)

* feat(news): 뉴스 학습 API 구현 (#388)

- NewsQueryService: 뉴스 조회 서비스
- NewsHandler: API 핸들러
  - GET /news - 목록 조회 (level, category 필터)
  - GET /news/today - 오늘의 뉴스
  - GET /news/recommended - 내 레벨 맞춤 추천
  - GET /news/{articleId} - 상세 조회 (조회수 증가)
- template.yaml: NewsFunction Lambda 추가

* feat(news): 뉴스 학습 부가 기능 구현 (#389)

- 읽기 완료 기록 API (POST /news/{articleId}/read)
- 북마크 토글 API (POST /news/{articleId}/bookmark)
- 북마크 목록 조회 API (GET /news/bookmarks)
- 학습 통계 조회 API (GET /news/stats)
- TTS 오디오 URL 조회 API (GET /news/{articleId}/audio)
- UserNewsRecord 모델 추가
- UserNewsRepository 추가
- NewsLearningService 추가

* feat(news): 복합 퀴즈 시스템 구현 (#471)

- 퀴즈 조회 API (GET /news/{articleId}/quiz)
- 퀴즈 제출 API (POST /news/{articleId}/quiz)
- 퀴즈 기록 조회 API (GET /news/quiz/history)
- NewsQuizResult 모델 추가
- QuizAnswerResult 모델 추가
- NewsQuizRepository 추가
- NewsQuizService 추가

* feat(news): 단어 수집 & Vocabulary 연동 구현 (#472)

- 단어 수집 API (POST /news/{articleId}/words)
- 수집 단어 목록 API (GET /news/words)
- 단어 상세 조회 API (GET /news/{articleId}/words/{word})
- 단어 삭제 API (DELETE /news/{articleId}/words/{word})
- Vocabulary 연동 API (POST /news/words/{word}/sync)
- NewsWordCollect 모델 추가
- NewsWordRepository 추가
- NewsWordService 추가

* feat: add multi-environment deployment support (dev/test/prod)

* fix: update buildspec.yml to deploy prod environment with parameter overrides

* refactor : AI 말하기 Websocket 구현 -> REST API 구현으로 리팩토링 (#490)

* feat : WebSocket Connect, Disconnect 핸들러 & SpeakingConnecion 모델 구현

* feat : WebSocket 메시지 처리 handler, service 구현

* feat : WebSocket 연결 정보 Repository 구현

* fix : 오타 수정

* refactor : websocket -> rest api 전환

* feat : speaking handler REST로 교체

* feat : speaking 관련 dto 생성

* refacotor : 기존 service 코드 로직 재사용 및 repository 리펙토링

* fix: revert buildspec.yml to build-only for CloudFormation deploy stage

* fix: revert buildspec.yml to build-only for CloudFormation deploy stage

* fix: update all API Gateway StageName to use Environment parameter

* fix: correct VocabularyTable and ContentBucket references in NewsFunction

* fix: correct VocabularyTable and ContentBucket references in NewsFunction

* fix: add stack name prefix to GameScheduleGroup and daily-stats schedule to avoid conflicts

* fix: add stack name prefix to GameScheduleGroup and daily-stats schedule to avoid conflicts

* feat: add support for existing Cognito User Pool reuse across environments

* fix: add conditional Cognito ARN reference in API Gateway Authorizer

* fix: remove Cognito resources completely, use existing Cognito only

* fix: remove Cognito resources completely, use existing Cognito only

* feat : speaking rest API 람다 함수 추가

* feat: add S3 bucket resource and fix environment-specific endpoints

- Add ContentBucket S3 resource for content storage
- Replace hardcoded /dev with ${Environment} in all WebSocket endpoints
- Update Output URLs to use dynamic environment stage

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* fix: add stack name prefix to news-collection schedule name

Prevent EventBridge rule name conflicts across environments

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* fix: add X-Requested-With and Accept headers to CORS config

Enable additional headers for CloudFront CORS compatibility

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* fix: use environment variable for S3 bucket URLs

Replace hardcoded bucket name with BUCKET_NAME env var for multi-env support:
- PreSignUpHandler: dynamic default profile URL
- PostConfirmationHandler: dynamic default profile URL
- UserService: dynamic default profile URL
- BadgeType: dynamic badge image base URL

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* fix: disable authorizer for CORS preflight requests

Add AddDefaultAuthorizerToCorsPreflight: false to prevent
Cognito Authorizer from blocking OPTIONS requests

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* feat : speaking REST API 람다 함수 추가  (#491)

* feature : OPIc 세션관리 + 답변 처리 파이프라인 구현  (#413)

* feat : OPIc 질문 & 세션 관련 dto 생성

* refactor : @DynamoDbBean 주석 추가

* feat : 주제 + 소주제 + 레벨로 오픽 질문 조회 추가

* feat : OPIc 세션, 질문, 답변 종합 handler 구현

* feat : 오픽 주제, 소주제별 seed 데이터 추가

* refactor : Transcribe API KEY 환경변수명 수정

* refactor : Bedrock에 사용하는 클로드 모델 변경

* refactor : S3 Key 대신 Proxy에서 요청하는 Base64 값으로 변환

* feat: GAME_START, ROUND_END 메시지에 serverTime 추가

- broadcastGameStart(): serverTime, roundDuration 필드 추가
- broadcastRoundEnd(): serverTime, roundStartTime, roundDuration 필드 추가
- GameService.endRound(): data에 roundStartTime, roundDuration 포함
- 타이머 동기화 버그 수정을 위한 서버 시간 제공

* feat: WebSocketMessageHelper 유틸리티 클래스 추가

- domain 필드 포함 메시지 생성 헬퍼
- DOMAIN_CHAT, DOMAIN_GAME 상수 정의
- buildChatMessage(), buildGameMessage() 메서드

* feat: 모든 WebSocket 메시지에 domain 필드 추가

- ScoreUpdateMessage에 domain 필드 추가
- broadcastGameStart에 domain:"game" 추가
- broadcastRoundEnd에 domain:"game" 추가
- broadcastCorrectAnswerMessage에 domain:"game" 추가
- handleCommandResult 시스템 메시지에 domain:"game" 추가
- handleRegularMessage 채팅 메시지에 domain:"chat" 추가

Closes #426, #427

* feat: GameSession 모델 클래스 생성

- DynamoDB Enhanced Client 어노테이션 적용
- GSI1: roomId로 활성 게임 세션 조회 가능
- 게임 상태 관리용 헬퍼 메서드 포함

Closes #428

* feat: GameSessionRepository 구현

- 기본 CRUD (save, findById, delete)
- roomId로 활성/전체 게임 세션 조회
- 상태, 라운드, 점수 업데이트 메서드
- 정답자 추가, 힌트 사용, 게임 종료 처리

Closes #429

* refactor: ChatRoom에서 게임 필드 분리

- 게임 관련 필드 제거 (gameStatus, currentRound 등)
- activeGameSessionId 필드 추가
- 게임 상태는 GameSession으로 분리됨

Note: 의존 코드 수정은 #431에서 진행

Closes #430

* refactor: GameSession 기반으로 전체 게임 로직 리팩토링

- GameService: ChatRoom 대신 GameSession 사용
- GameStatsService: GameSession 매개변수로 변경
- CommandService: GameSession 기반 점수 조회
- GameHandler: GameSession 기반 REST API
- WebSocketMessageHandler: GameSession 기반 브로드캐스트
- GameStatusResponse, ScoreboardResponse: GameSession 매개변수

Closes #431

* feat: GameSessionHandler Lambda 및 게임 세션 API 구현

- POST /rooms/{roomId}/games - 게임 세션 생성
- GET /games/{gameSessionId} - 게임 상태 조회 (재접속용)
- POST /games/{gameSessionId}/start - 게임 시작
- POST /games/{gameSessionId}/stop - 게임 종료

모든 응답에 serverTime 포함 (타이머 동기화)
출제자에게만 currentWord 포함

Closes #432, #433

* feat: 게임 시작 7분 후 자동 종료 기능 구현

- GameConfig에 gameTimeLimit() 메서드 추가 (기본값: 420초)
- GameSchedulerClient 유틸리티 클래스 생성 (EventBridge Scheduler 연동)
- GameService에 스케줄 생성/취소 로직 추가
- GameAutoCloseHandler Lambda 함수 생성
- template.yaml에 Lambda, IAM Role, Schedule Group 추가

Closes #417

* fix : 메모리 증가 및 Lambda 응답 제한 시간 Cognito 트리거 제한시간과 동일하게 수정 (#439)

* feat: 캐치마인드 게임 방 분리 기능 구현 (#455)

- Room 타입 분리 (CHAT/GAME)
  - RoomType, RoomStatus enum 추가
  - ChatRoom 모델에 type, gameType, gameSettings, status, hostId 필드 추가
  - GameSettings 모델 추가

- 방 생성/조회 API 수정
  - CreateRoomRequest에 type, gameType, gameSettings 필드 추가
  - 방 목록 조회 시 type, gameType, status 필터 지원

- 게임 시작 조건 검증
  - GAME 타입 방에서만 게임 시작 가능 (GAME_007 에러)

- 게임 재시작 API 구현 (#452)
  - POST /rooms/{roomId}/game/restart 엔드포인트 추가
  - 방장만 재시작 가능 (GAME_009 에러)
  - 게임 진행 중 재시작 불가 (GAME_008 에러)

- 방장 변경 로직 구현 (#453)
  - 방장 퇴장 시 다음 멤버에게 자동 이전
  - 모든 멤버 퇴장 시 방 자동 삭제

- WebSocket 메시지 타입 추가 (#454)
  - ROOM_STATUS_CHANGE, HOST_CHANGE 메시지 타입 추가
  - WebSocketMessageHelper에 빌더 메서드 추가

- 테스트 추가
  - RoomType, RoomStatus enum 테스트
  - GameSettings 모델 테스트
  - ChattingErrorCode 테스트 업데이트

Related: #440, #441, #442, #443, #444, #445, #446
Closes: #447, #448, #449, #450, #451, #452, #453, #454

* feat: 참가자 닉네임 및 방장 변경 WebSocket 알림 구현 (#456)

- RoomParticipant DTO 추가 (userId, nickname, isHost)
- ChatRoomQueryService에 닉네임 조회 메서드 추가
  - getParticipantsWithNicknames(): 참가자 목록 + 닉네임
  - getHostNickname(): 방장 닉네임 조회
- ChatRoomHandler.getRoom() 응답에 participants, hostNickname 추가
- ChatRoomCommandService.leaveRoom()에서 방장 변경 시 WebSocket 브로드캐스트

Related: #440

* fix: ChatRoomFunction에 UserTable DynamoDB 권한 추가

- 참가자/방장 닉네임 조회를 위한 UserTable 읽기 권한 추가
- DynamoDBReadPolicy로 UserTable 접근 허용

Fixes #457

* fix: GameSettings에 @DynamoDbBean 어노테이션 추가

- DynamoDB Enhanced Client가 중첩 객체를 직렬화/역직렬화할 수 있도록 수정
- ChatRoom 저장/조회 시 GameSettings 변환 오류 해결

Fixes #457

* fix: ChatRoomFunction에 WEBSOCKET_ENDPOINT 환경변수 및 권한 추가

- leaveRoom에서 WebSocketBroadcaster 사용을 위한 환경변수 추가
- execute-api:ManageConnections 권한 추가

* fix: WebSocket Lambda 함수들에 WEBSOCKET_ENDPOINT 환경변수 추가

- WebSocketConnectFunction에 WEBSOCKET_ENDPOINT 추가
- WebSocketDisconnectFunction에 WEBSOCKET_ENDPOINT 추가
- execute-api:ManageConnections 권한 추가

* fix: Grammar WebSocket Lambda 환경 변수 및 권한 추가

- GrammarStreamingConnectFunction에 WEBSOCKET_ENDPOINT 환경 변수 추가
- GrammarStreamingDisconnectFunction에 WEBSOCKET_ENDPOINT 환경 변수 추가
- 두 함수에 execute-api:ManageConnections 권한 추가

* feat: GSI1SK 확장성 있는 재설계 및 DB 레벨 필터링

- 기존: {level}#{createdAt}
- 신규: {type}#{gameType}#{status}#{level}#{createdAt}

- 전체 방: GSI1PK = "ROOMS"
- 게임방만: begins_with(GSI1SK, "GAME#")
- 캐치마인드만: begins_with(GSI1SK, "GAME#CATCHMIND#")
- 대기중 캐치마인드: begins_with(GSI1SK, "GAME#CATCHMIND#WAITING#")

- ChatRoomCommandService.java: 방 생성 시 새 GSI1SK 포맷 적용
- ChatRoomRepository.java: findByFilters() 메서드 추가, updateStatus() 메서드 추가
- ChatRoomQueryService.java: 메모리 필터링 제거, DB 레벨 필터링으로 변경
- GameService.java: 게임 시작/종료 시 방 상태 업데이트 (GSI1SK 포함)

- scripts/migrate-gsi1sk.sh: 기존 데이터 마이그레이션 스크립트
- 37개 기존 방 마이그레이션 완료

* fix: increase stats query limit to 100 days

- Adjust maximum allowable limit for recent stats query from 30 to 100 days to support extended data range responses.

* feat: improve game round and connection management logic

- Added handling for game round timeout (`ROUND_TIMEOUT`) in WebSocketMessageHandler.
- Enhanced game start broadcast to include `currentWord` for the drawer only.
- Updated ConnectionRepository to remove duplicate user connections in the same room.
- Added `currentWordEnglish` to GameSession for better answer verification.
- Normalized ChatRoom levels to match database storage format.
- Updated template.yaml to include DynamoDBReadPolicy for VocabTable.

* refactor: 코드 정리 및 미사용 클래스 제거 (#459)

* refactor: remove unused WebSocketResponseUtil

* refactor: add AutoCloseable to WebSocketBroadcaster

* refactor: remove unused TestService

* refactor: remove unused WordService

* refactor: remove unused DailyStudyService

* refactor: remove unused UserWordService

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* fix: resolve N+1 query in StatsService

* refactor(all): DI 패턴 및 전략 패턴 적용 (#461)

- Repository, Service, Handler에 DI 생성자 추가 (테스트 용이성)
- BadgeService에 Strategy 패턴 적용 (뱃지 조건 검증 로직 분리)

* refactor: relocate and restructure seed data files

- Moved `question-homes.json` and `words.json` from subdirectories to `seed` folder.
- Updated file paths for better organization and clarity.

* chore: seed 데이터 폴더 구조 정리

* feat: add CI/CD pipeline configuration for CodePipeline

* fix: add SNS topic policy and DependsOn for notification rule

* fix: correct paths in buildspec.yml for CodeBuild

* fix: remove hardcoded JAVA_HOME, use runtime default

* fix: add gradle wrapper for CI/CD build

* fix: use single line sam package command with hardcoded bucket

* fix: use existing stack name group2-englishstudy-chatting

* fix: add missing WEBSOCKET_ENDPOINT env var to WebSocket connect functions

* docs: update FRONTEND-API-GUIDE with new RoomType/RoomStatus structure

* feat : WebSocket Connect, Disconnect 핸들러 & SpeakingConnecion 모델 구현

* feat : WebSocket 메시지 처리 handler, service 구현

* feat : WebSocket 연결 정보 Repository 구현

* fix: update WebSocketDisconnectHandler to use GameSession model

- Remove references to deleted ChatRoom game fields
- Use GameSessionRepository to finish active game sessions
- Use ChatRoomRepository.updateStatus() for room state management

* perf: optimize CI/CD build time

- Add pip cache for SAM CLI dependencies
- Enable Gradle parallel builds and build cache
- Add SAM build cache (.aws-sam)
- Use sam build --parallel --cached
- Skip SAM CLI install if already cached
- Remove unnecessary 'clean' to leverage cache

* feat: add custom CodeBuild Docker image with pre-installed tools

- Dockerfile with Java 21 + SAM CLI + Gradle pre-installed
- build-and-push.sh script for ECR deployment
- Updated buildspec.yml for custom image (removes SAM CLI install)
- Expected build time reduction: ~30-40 seconds

* feature : AI 영어 회화 연습 기능 (#468)

* feat : WebSocket Connect, Disconnect 핸들러 & SpeakingConnecion 모델 구현

* feat : WebSocket 메시지 처리 handler, service 구현

* feat : WebSocket 연결 정보 Repository 구현

* fix: remove typo in SpeakingConnectionRepository

* fix : 오타 수정

* chore: trigger build test with custom Docker image

* chore: remove unnecessary newlines and whitespace across WebSocket handlers and related classes

* chore: remove unnecessary newlines and whitespace across WebSocket handlers and related classes

* refactor : websocket -> rest api 전환

* feat : speaking handler REST로 교체

* feat : speaking 관련 dto 생성

* refacotor : 기존 service 코드 로직 재사용 및 repository 리펙토링

* fix: add CORS headers to API Gateway error responses (#479)

API Gateway의 인증 실패 등 에러 응답에 CORS 헤더가 누락되어
CloudFront를 통한 프론트엔드 요청이 차단되는 문제 수정

- UNAUTHORIZED (401) 응답에 CORS 헤더 추가
- ACCESS_DENIED (403) 응답에 CORS 헤더 추가
- DEFAULT_4XX/5XX 응답에 CORS 헤더 추가
- EXPIRED_TOKEN 응답에 CORS 헤더 추가

* feat : speaking rest API 람다 함수 추가

---------

Co-authored-by: ddingjoo <ddingsha9@teambind.co.kr>

* refactor : speaking service 재사용

* refactor : AI 영어 회화 연습 코드 리팩토링

* feature : test 벡엔드 서버에 AI 말하기 연습 기능 배포 (#492)

* feat : WebSocket Connect, Disconnect 핸들러 & SpeakingConnecion 모델 구현

* feat : WebSocket 메시지 처리 handler, service 구현

* feat : WebSocket 연결 정보 Repository 구현

* fix : 오타 수정

* refactor : websocket -> rest api 전환

* feat : speaking handler REST로 교체

* feat : speaking 관련 dto 생성

* refacotor : 기존 service 코드 로직 재사용 및 repository 리펙토링

* feat : speaking rest API 람다 함수 추가

* refactor : speaking service 재사용

* refactor : AI 영어 회화 연습 코드 리팩토링

---------

Co-authored-by: DDING JOO <ddingsha9@teambind.co.kr>

* feat : handleChat 메서드 JsonNull 체크 푸가

* feature : handleChat 메서드 JsonNull 체크 추가 (#493)

* feat : WebSocket Connect, Disconnect 핸들러 & SpeakingConnecion 모델 구현

* feat : WebSocket 메시지 처리 handler, service 구현

* feat : WebSocket 연결 정보 Repository 구현

* fix : 오타 수정

* refactor : websocket -> rest api 전환

* feat : speaking handler REST로 교체

* feat : speaking 관련 dto 생성

* refacotor : 기존 service 코드 로직 재사용 및 repository 리펙토링

* feat : speaking rest API 람다 함수 추가

* refactor : speaking service 재사용

* refactor : AI 영어 회화 연습 코드 리팩토링

* feat : handleChat 메서드 JsonNull 체크 푸가

---------

Co-authored-by: DDING JOO <ddingsha9@teambind.co.kr>

* feat(news): 뉴스 학습 배지 시스템 구현 (#473)

- 14개 뉴스 관련 배지 추가 (읽기, 퀴즈, 단어수집, 연속학습, 마스터)
- UserStats에 뉴스 통계 필드 추가
- 6개 뉴스 배지 Strategy 클래스 생성
- 뉴스 읽기/퀴즈/단어수집 시 통계 업데이트 및 배지 체크 연동

* fix: add PATCH method to CORS AllowMethods

* test: BadgeType 개수 테스트 수정 (15 -> 29)

* fix: CORS PATCH 메서드 추가

* docs: 뉴스 기능 프론트엔드 연동 가이드 작성

* fix: NewsCollectionFunction에 Bedrock, Comprehend 권한 추가

* fix: add null check for collectWord request body

- Add INVALID_REQUEST error code to NewsErrorCode
- Check body and word field before accessing in collectWord()
- Prevents NullPointerException when request body is malformed

* feat: enhance stats API and bookmark response for frontend

- Add DAILY stats update for news read/quiz/word collection
- Add /stats/dashboard endpoint with frontend-requested format
  - today: wordsLearned, newsRead, quizzesTaken, wordsTotal
  - overall: totalWordsLearned, totalNewsRead, averageAccuracy, streaks
  - weeklyProgress: last 7 days with date/wordsLearned/newsRead
- Add news-related fields to all stats API responses
- Fix bookmark API to include full article details (title, summary, etc.)

* feat: add category classification to news AI analysis

- Add category field to AnalysisResult record
- Update Bedrock prompt to classify articles into categories
  (WORLD, POLITICS, BUSINESS, TECH, SCIENCE, HEALTH, SPORTS, ENTERTAINMENT, LIFESTYLE)
- Parse and set category from AI response
- Set GSI2 (CATEGORY#) index when category is available

* fix: add /stats/dashboard endpoint to template.yaml

* fix: filter by ARTICLE# prefix in findById to avoid returning UserNewsRecord

* docs: add News API troubleshooting guide

* feat: add Cognito authorizer to News API and enhance keyword extraction

- Set CognitoAuthorizer for all News API endpoints in template.yaml
- Update Bedrock AI to extract keywords with meanings and examples
- Add fallback to Comprehend for keyword extraction when Bedrock fails
- Modify KeywordInfo model to include example field
- Adjust AI prompt to include keyword extraction with examples
- Update AnalysisResult to store keywords and parse them from AI response

* Revert "Merge branch 'test' into prod"

This reverts commit c1a958eac6799d5838a76e4078ae304bcdb62278, reversing
changes made to a6662e0cfc46c6e12f20a89f0df285ff282160bc.

* feat: enhance bookmark and reading status tracking for News API

- Add bookmark and reading status to individual article responses
- Include bookmark status in paginated news responses
- Modify `KeywordInfo` to support Korean translations (`meaningKo`)
- Update AI prompts to extract Korean meanings for keywords

* refactor : session_id가 null 체크 추가

* feat : template 환경변수 리펙토링

* fix : sessionId NullPointerException 에러 수정  (#496)

* feat : WebSocket Connect, Disconnect 핸들러 & SpeakingConnecion 모델 구현

* feat : WebSocket 메시지 처리 handler, service 구현

* feat : WebSocket 연결 정보 Repository 구현

* fix : 오타 수정

* refactor : websocket -> rest api 전환

* feat : speaking handler REST로 교체

* feat : speaking 관련 dto 생성

* refacotor : 기존 service 코드 로직 재사용 및 repository 리펙토링

* feat : speaking rest API 람다 함수 추가

* refactor : speaking service 재사용

* refactor : AI 영어 회화 연습 코드 리팩토링

* feat : handleChat 메서드 JsonNull 체크 푸가

* refactor : session_id가 null 체크 추가

* feat : template 환경변수 리펙토링

---------

Co-authored-by: DDING JOO <ddingsha9@teambind.co.kr>

* feat: enhance bookmark and reading status tracking for News API

- Add bookmark and reading status to individual article responses
- Include bookmark status in paginated news responses
- Modify `KeywordInfo` to support Korean translations (`meaningKo`)
- Update AI prompts to extract Korean meanings for keywords

* feat: add category filtering to UserWord API with enhanced query logic

- Introduce `category` filtering to `getUserWords` API
- Update WordCategory enums to include "news" category
- Apply category filter after enrichment with word info
- Adjust query limits for bookmarked and incorrect words queries

* feat: add default value for ExistingCognitoClientId in template.yaml

- Set default to an empty string to ensure compatibility with templates using this parameter without explicitly specifying a value.

* fix: SpeakingHandler getStringOrNull 컴파일 에러 수정

* fix: SpeakingHandler getStringOrNull 컴파일 에러 수정

* fix: Bedrock 키워드(meaningKo 포함)를 article에 저장하도록 수정

* fix: Bedrock 키워드(meaningKo 포함)를 article에 저장하도록 수정

* fix: Bedrock 키워드(meaningKo 포함)를 article에 저장하도록 수정

* feat: add dashboard stats API and enhance news stats tracking

- Introduce `/stats/dashboard` API for retrieving integrated user stats (today, overall, weekly progress, and level distribution)
- Update `UserStats` model to include additional fields for news stats (newsRead, newsQuizCompleted, newsQuizPerfect, newsWordsCollected, etc.)
- Add atomic updates to track news reading, quiz, and word stats in `UserStatsRepository`
- Modify CloudFormation `template.yaml` to register the new `/stats/dashboard` endpoint

* feat: add dashboard stats API and enhance news stats tracking

- Introduce `/stats/dashboard` API for retrieving integrated user stats (today, overall, weekly progress, and level distribution)
- Update `UserStats` model to include additional fields for news stats (newsRead, newsQuizCompleted, newsQuizPerfect, newsWordsCollected, etc.)
- Add atomic updates to track news reading, quiz, and word stats in `UserStatsRepository`
- Modify CloudFormation `template.yaml` to register the new `/stats/dashboard` endpoint

* feat: add dashboard stats API and enhance news stats tracking

- Introduce `/stats/dashboard` API for retrieving integrated user stats (today, overall, weekly progress, and level distribution)
- Update `UserStats` model to include additional fields for news stats (newsRead, newsQuizCompleted, newsQuizPerfect, newsWordsCollected, etc.)
- Add atomic updates to track news reading, quiz, and word stats in `UserStatsRepository`
- Modify CloudFormation `template.yaml` to register the new `/stats/dashboard` endpoint

* refactor: format code with consistent indentation and spacing

- Apply consistent formatting to improve code readability across multiple files
- Adjust indentation, spacing, and alignment in model classes, DTOs, and repository methods

* fix: filter by ARTICLE# prefix in findById to avoid returning bookmark records

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* feat : Speaking 관련 template 람다 함수 및 테이블 추가

* feat : 말하기 기능에 polly 서비스 권한 추가

* feat : transcribe API KEY 추가

---------

Co-authored-by: DDING JOO <ddingsha9@teambind.co.kr>
Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>

* feat: 채팅 슬래시 명령어 시스템 고도화

- 게임 관련 명령어 제거 (/start, /stop, /score, /skip, /hint)
- 기본 명령어 추가: /help, /members, /leave, /clear
- 재미 명령어 추가: /dice, /coin, /random
- 투표 시스템 구현: /poll, /vote, /endpoll
- Poll 모델 및 PollRepository 추가
- MessageType에 POLL_CREATE, POLL_VOTE, POLL_END 추가

Closes #518, #519, #520

* feat: implement word chain (끝말잇기) game with dictionary API integration

- Add WordChainSession model with time limit, scoring, player management
- Add WordChainService with game logic (start, submit, timeout, stop)
- Add DictionaryService for word validation via Free Dictionary API
- Add WordChainHandler REST API endpoints (/wordchain/start, submit, etc.)
- Add WordChainFunction to SAM template
- Add WORDCHAIN_* message types for WebSocket broadcasts
- Fix command result domain (use chat domain for chat commands)
- Add unit tests for WordChainSession and DictionaryService

Closes #524, #525, #526, #527, #528

* fix: update ChattingErrorCodeSpec to include new error codes

* fix: add UserTable read permission to WebSocket Lambda

WebSocket Lambda needs DynamoDBReadPolicy for UserTable to look up
user nicknames for chat commands (/member, /dice, /coin, /hint, etc.)

* feat : 채팅 도메인 닉네임 조회용 메서드 추가

---------

Co-authored-by: ddingjoo <ddingsha9@teambind.co.kr>
Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>

From c3abb9ad953c5b9f12f57b6e6915dc9454fe1bca Mon Sep 17 00:00:00 2001
From: hyein Heo <128613248+hye-inA@users.noreply.github.com>
Date: Mon, 26 Jan 2026 10:31:43 +0900
Subject: [PATCH 2/2] =?UTF-8?q?feature=20:=20=EC=B1=84=ED=8C=85=EB=A9=94?=
 =?UTF-8?q?=EC=84=B8=EC=A7=80=EC=97=90=20nickname=20=ED=95=84=EB=93=9C=20?=
 =?UTF-8?q?=EC=B6=94=EA=B0=80=20(#545)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

* style: SessionReportResponse 코드 포맷팅

* style: SpeakingError 코드 포맷팅

* style: SpeakingErrorType 코드 포맷팅

* style: OPIcException 코드 포맷팅

* style: OPIcAnswer 코드 포맷팅

* style: OPIcQuestion 코드 포맷팅

* style: OPIcSession 코드 포맷팅

* style: OPIcRepository 코드 포맷팅

* style: FeedbackService 코드 포맷팅

* style: TranscribeProxyService 코드 포맷팅

* style: VocabularyConfig 코드 포맷팅

* style: DailyStudyCommandService 코드 포맷팅

* style: TestCommandService 코드 포맷팅

* style: TestService 코드 포맷팅

* style: CommonErrorCodeSpec 코드 포맷팅

* style: JsonUtilSpec 코드 포맷팅

* style: BadgeTypeSpec 코드 포맷팅

* style: ChattingErrorCodeSpec 코드 포맷팅

* style: GrammarLevelSpec 코드 포맷팅

* style: GrammarErrorCodeSpec 코드 포맷팅

* style: VocabularyErrorCodeSpec 코드 포맷팅

* feature : OPIc 세션관리 + 답변 처리 파이프라인 구현  (#413)

* feat : OPIc 질문 & 세션 관련 dto 생성

* refactor : @DynamoDbBean 주석 추가

* feat : 주제 + 소주제 + 레벨로 오픽 질문 조회 추가

* feat : OPIc 세션, 질문, 답변 종합 handler 구현

* feat : 오픽 주제, 소주제별 seed 데이터 추가

* refactor : Transcribe API KEY 환경변수명 수정

* refactor : Bedrock에 사용하는 클로드 모델 변경

* refactor : S3 Key 대신 Proxy에서 요청하는 Base64 값으로 변환

* feat: GAME_START, ROUND_END 메시지에 serverTime 추가

- broadcastGameStart(): serverTime, roundDuration 필드 추가
- broadcastRoundEnd(): serverTime, roundStartTime, roundDuration 필드 추가
- GameService.endRound(): data에 roundStartTime, roundDuration 포함
- 타이머 동기화 버그 수정을 위한 서버 시간 제공

* feat: WebSocketMessageHelper 유틸리티 클래스 추가

- domain 필드 포함 메시지 생성 헬퍼
- DOMAIN_CHAT, DOMAIN_GAME 상수 정의
- buildChatMessage(), buildGameMessage() 메서드

* feat: 모든 WebSocket 메시지에 domain 필드 추가

- ScoreUpdateMessage에 domain 필드 추가
- broadcastGameStart에 domain:"game" 추가
- broadcastRoundEnd에 domain:"game" 추가
- broadcastCorrectAnswerMessage에 domain:"game" 추가
- handleCommandResult 시스템 메시지에 domain:"game" 추가
- handleRegularMessage 채팅 메시지에 domain:"chat" 추가

Closes #426, #427

* feat: GameSession 모델 클래스 생성

- DynamoDB Enhanced Client 어노테이션 적용
- GSI1: roomId로 활성 게임 세션 조회 가능
- 게임 상태 관리용 헬퍼 메서드 포함

Closes #428

* feat: GameSessionRepository 구현

- 기본 CRUD (save, findById, delete)
- roomId로 활성/전체 게임 세션 조회
- 상태, 라운드, 점수 업데이트 메서드
- 정답자 추가, 힌트 사용, 게임 종료 처리

Closes #429

* refactor: ChatRoom에서 게임 필드 분리

- 게임 관련 필드 제거 (gameStatus, currentRound 등)
- activeGameSessionId 필드 추가
- 게임 상태는 GameSession으로 분리됨

Note: 의존 코드 수정은 #431에서 진행

Closes #430

* refactor: GameSession 기반으로 전체 게임 로직 리팩토링

- GameService: ChatRoom 대신 GameSession 사용
- GameStatsService: GameSession 매개변수로 변경
- CommandService: GameSession 기반 점수 조회
- GameHandler: GameSession 기반 REST API
- WebSocketMessageHandler: GameSession 기반 브로드캐스트
- GameStatusResponse, ScoreboardResponse: GameSession 매개변수

Closes #431

* feat: GameSessionHandler Lambda 및 게임 세션 API 구현

- POST /rooms/{roomId}/games - 게임 세션 생성
- GET /games/{gameSessionId} - 게임 상태 조회 (재접속용)
- POST /games/{gameSessionId}/start - 게임 시작
- POST /games/{gameSessionId}/stop - 게임 종료

모든 응답에 serverTime 포함 (타이머 동기화)
출제자에게만 currentWord 포함

Closes #432, #433

* feat: 게임 시작 7분 후 자동 종료 기능 구현

- GameConfig에 gameTimeLimit() 메서드 추가 (기본값: 420초)
- GameSchedulerClient 유틸리티 클래스 생성 (EventBridge Scheduler 연동)
- GameService에 스케줄 생성/취소 로직 추가
- GameAutoCloseHandler Lambda 함수 생성
- template.yaml에 Lambda, IAM Role, Schedule Group 추가

Closes #417

* fix : 메모리 증가 및 Lambda 응답 제한 시간 Cognito 트리거 제한시간과 동일하게 수정 (#439)

* feat: 캐치마인드 게임 방 분리 기능 구현 (#455)

- Room 타입 분리 (CHAT/GAME)
  - RoomType, RoomStatus enum 추가
  - ChatRoom 모델에 type, gameType, gameSettings, status, hostId 필드 추가
  - GameSettings 모델 추가

- 방 생성/조회 API 수정
  - CreateRoomRequest에 type, gameType, gameSettings 필드 추가
  - 방 목록 조회 시 type, gameType, status 필터 지원

- 게임 시작 조건 검증
  - GAME 타입 방에서만 게임 시작 가능 (GAME_007 에러)

- 게임 재시작 API 구현 (#452)
  - POST /rooms/{roomId}/game/restart 엔드포인트 추가
  - 방장만 재시작 가능 (GAME_009 에러)
  - 게임 진행 중 재시작 불가 (GAME_008 에러)

- 방장 변경 로직 구현 (#453)
  - 방장 퇴장 시 다음 멤버에게 자동 이전
  - 모든 멤버 퇴장 시 방 자동 삭제

- WebSocket 메시지 타입 추가 (#454)
  - ROOM_STATUS_CHANGE, HOST_CHANGE 메시지 타입 추가
  - WebSocketMessageHelper에 빌더 메서드 추가

- 테스트 추가
  - RoomType, RoomStatus enum 테스트
  - GameSettings 모델 테스트
  - ChattingErrorCode 테스트 업데이트

Related: #440, #441, #442, #443, #444, #445, #446
Closes: #447, #448, #449, #450, #451, #452, #453, #454

* feat: 참가자 닉네임 및 방장 변경 WebSocket 알림 구현 (#456)

- RoomParticipant DTO 추가 (userId, nickname, isHost)
- ChatRoomQueryService에 닉네임 조회 메서드 추가
  - getParticipantsWithNicknames(): 참가자 목록 + 닉네임
  - getHostNickname(): 방장 닉네임 조회
- ChatRoomHandler.getRoom() 응답에 participants, hostNickname 추가
- ChatRoomCommandService.leaveRoom()에서 방장 변경 시 WebSocket 브로드캐스트

Related: #440

* fix: ChatRoomFunction에 UserTable DynamoDB 권한 추가

- 참가자/방장 닉네임 조회를 위한 UserTable 읽기 권한 추가
- DynamoDBReadPolicy로 UserTable 접근 허용

Fixes #457

* fix: GameSettings에 @DynamoDbBean 어노테이션 추가

- DynamoDB Enhanced Client가 중첩 객체를 직렬화/역직렬화할 수 있도록 수정
- ChatRoom 저장/조회 시 GameSettings 변환 오류 해결

Fixes #457

* fix: ChatRoomFunction에 WEBSOCKET_ENDPOINT 환경변수 및 권한 추가

- leaveRoom에서 WebSocketBroadcaster 사용을 위한 환경변수 추가
- execute-api:ManageConnections 권한 추가

* fix: WebSocket Lambda 함수들에 WEBSOCKET_ENDPOINT 환경변수 추가

- WebSocketConnectFunction에 WEBSOCKET_ENDPOINT 추가
- WebSocketDisconnectFunction에 WEBSOCKET_ENDPOINT 추가
- execute-api:ManageConnections 권한 추가

* fix: Grammar WebSocket Lambda 환경 변수 및 권한 추가

- GrammarStreamingConnectFunction에 WEBSOCKET_ENDPOINT 환경 변수 추가
- GrammarStreamingDisconnectFunction에 WEBSOCKET_ENDPOINT 환경 변수 추가
- 두 함수에 execute-api:ManageConnections 권한 추가

* feat: GSI1SK 확장성 있는 재설계 및 DB 레벨 필터링

## 변경 사항

### GSI1SK 포맷 변경
- 기존: {level}#{createdAt}
- 신규: {type}#{gameType}#{status}#{level}#{createdAt}

### 지원 쿼리 패턴
- 전체 방: GSI1PK = "ROOMS"
- 게임방만: begins_with(GSI1SK, "GAME#")
- 캐치마인드만: begins_with(GSI1SK, "GAME#CATCHMIND#")
- 대기중 캐치마인드: begins_with(GSI1SK, "GAME#CATCHMIND#WAITING#")

### 파일 수정
- ChatRoomCommandService.java: 방 생성 시 새 GSI1SK 포맷 적용
- ChatRoomRepository.java: findByFilters() 메서드 추가, updateStatus() 메서드 추가
- ChatRoomQueryService.java: 메모리 필터링 제거, DB 레벨 필터링으로 변경
- GameService.java: 게임 시작/종료 시 방 상태 업데이트 (GSI1SK 포함)

### 마이그레이션
- scripts/migrate-gsi1sk.sh: 기존 데이터 마이그레이션 스크립트
- 37개 기존 방 마이그레이션 완료

* fix: increase stats query limit to 100 days

- Adjust maximum allowable limit for recent stats query from 30 to 100 days to support extended data range responses.

* feat: improve game round and connection management logic

- Added handling for game round timeout (`ROUND_TIMEOUT`) in WebSocketMessageHandler.
- Enhanced game start broadcast to include `currentWord` for the drawer only.
- Updated ConnectionRepository to remove duplicate user connections in the same room.
- Added `currentWordEnglish` to GameSession for better answer verification.
- Normalized ChatRoom levels to match database storage format.
- Updated template.yaml to include DynamoDBReadPolicy for VocabTable.

* refactor: 코드 정리 및 미사용 클래스 제거 (#459)

* refactor: remove unused WebSocketResponseUtil

* refactor: add AutoCloseable to WebSocketBroadcaster

* refactor: remove unused TestService

* refactor: remove unused WordService

* refactor: remove unused DailyStudyService

* refactor: remove unused UserWordService

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* fix: resolve N+1 query in StatsService

* refactor(all): DI 패턴 및 전략 패턴 적용 (#461)

- Repository, Service, Handler에 DI 생성자 추가 (테스트 용이성)
- BadgeService에 Strategy 패턴 적용 (뱃지 조건 검증 로직 분리)

* refactor: relocate and restructure seed data files

- Moved `question-homes.json` and `words.json` from subdirectories to `seed` folder.
- Updated file paths for better organization and clarity.

* chore: seed 데이터 폴더 구조 정리

* feat: add CI/CD pipeline configuration for CodePipeline

* fix: add SNS topic policy and DependsOn for notification rule

* fix: correct paths in buildspec.yml for CodeBuild

* fix: remove hardcoded JAVA_HOME, use runtime default

* fix: add gradle wrapper for CI/CD build

* fix: use single line sam package command with hardcoded bucket

* fix: use existing stack name group2-englishstudy-chatting

* fix: add missing WEBSOCKET_ENDPOINT env var to WebSocket connect functions

* docs: update FRONTEND-API-GUIDE with new RoomType/RoomStatus structure

* feat : WebSocket Connect, Disconnect 핸들러 & SpeakingConnecion 모델 구현

* feat : WebSocket 메시지 처리 handler, service 구현

* feat : WebSocket 연결 정보 Repository 구현

* fix: update WebSocketDisconnectHandler to use GameSession model

- Remove references to deleted ChatRoom game fields
- Use GameSessionRepository to finish active game sessions
- Use ChatRoomRepository.updateStatus() for room state management

* perf: optimize CI/CD build time

- Add pip cache for SAM CLI dependencies
- Enable Gradle parallel builds and build cache
- Add SAM build cache (.aws-sam)
- Use sam build --parallel --cached
- Skip SAM CLI install if already cached
- Remove unnecessary 'clean' to leverage cache

* feat: add custom CodeBuild Docker image with pre-installed tools

- Dockerfile with Java 21 + SAM CLI + Gradle pre-installed
- build-and-push.sh script for ECR deployment
- Updated buildspec.yml for custom image (removes SAM CLI install)
- Expected build time reduction: ~30-40 seconds

* feature : AI 영어 회화 연습 기능 (#468)

* feat : WebSocket Connect, Disconnect 핸들러 & SpeakingConnecion 모델 구현

* feat : WebSocket 메시지 처리 handler, service 구현

* feat : WebSocket 연결 정보 Repository 구현

* fix: remove typo in SpeakingConnectionRepository

* fix : 오타 수정

* chore: trigger build test with custom Docker image

* chore: remove unnecessary newlines and whitespace across WebSocket handlers and related classes

* chore: remove unnecessary newlines and whitespace across WebSocket handlers and related classes

* Release: 캐치마인드 게임 분리, AI 회화 연습, CI/CD 파이프라인 (#469)

* feature : OPIc 세션관리 + 답변 처리 파이프라인 구현  (#413)

* feat : OPIc 질문 & 세션 관련 dto 생성

* refactor : @DynamoDbBean 주석 추가

* feat : 주제 + 소주제 + 레벨로 오픽 질문 조회 추가

* feat : OPIc 세션, 질문, 답변 종합 handler 구현

* feat : 오픽 주제, 소주제별 seed 데이터 추가

* refactor : Transcribe API KEY 환경변수명 수정

* refactor : Bedrock에 사용하는 클로드 모델 변경

* refactor : S3 Key 대신 Proxy에서 요청하는 Base64 값으로 변환

* feat: GAME_START, ROUND_END 메시지에 serverTime 추가

- broadcastGameStart(): serverTime, roundDuration 필드 추가
- broadcastRoundEnd(): serverTime, roundStartTime, roundDuration 필드 추가
- GameService.endRound(): data에 roundStartTime, roundDuration 포함
- 타이머 동기화 버그 수정을 위한 서버 시간 제공

* feat: WebSocketMessageHelper 유틸리티 클래스 추가

- domain 필드 포함 메시지 생성 헬퍼
- DOMAIN_CHAT, DOMAIN_GAME 상수 정의
- buildChatMessage(), buildGameMessage() 메서드

* feat: 모든 WebSocket 메시지에 domain 필드 추가

- ScoreUpdateMessage에 domain 필드 추가
- broadcastGameStart에 domain:"game" 추가
- broadcastRoundEnd에 domain:"game" 추가
- broadcastCorrectAnswerMessage에 domain:"game" 추가
- handleCommandResult 시스템 메시지에 domain:"game" 추가
- handleRegularMessage 채팅 메시지에 domain:"chat" 추가

Closes #426, #427

* feat: GameSession 모델 클래스 생성

- DynamoDB Enhanced Client 어노테이션 적용
- GSI1: roomId로 활성 게임 세션 조회 가능
- 게임 상태 관리용 헬퍼 메서드 포함

Closes #428

* feat: GameSessionRepository 구현

- 기본 CRUD (save, findById, delete)
- roomId로 활성/전체 게임 세션 조회
- 상태, 라운드, 점수 업데이트 메서드
- 정답자 추가, 힌트 사용, 게임 종료 처리

Closes #429

* refactor: ChatRoom에서 게임 필드 분리

- 게임 관련 필드 제거 (gameStatus, currentRound 등)
- activeGameSessionId 필드 추가
- 게임 상태는 GameSession으로 분리됨

Note: 의존 코드 수정은 #431에서 진행

Closes #430

* refactor: GameSession 기반으로 전체 게임 로직 리팩토링

- GameService: ChatRoom 대신 GameSession 사용
- GameStatsService: GameSession 매개변수로 변경
- CommandService: GameSession 기반 점수 조회
- GameHandler: GameSession 기반 REST API
- WebSocketMessageHandler: GameSession 기반 브로드캐스트
- GameStatusResponse, ScoreboardResponse: GameSession 매개변수

Closes #431

* feat: GameSessionHandler Lambda 및 게임 세션 API 구현

- POST /rooms/{roomId}/games - 게임 세션 생성
- GET /games/{gameSessionId} - 게임 상태 조회 (재접속용)
- POST /games/{gameSessionId}/start - 게임 시작
- POST /games/{gameSessionId}/stop - 게임 종료

모든 응답에 serverTime 포함 (타이머 동기화)
출제자에게만 currentWord 포함

Closes #432, #433

* feat: 게임 시작 7분 후 자동 종료 기능 구현

- GameConfig에 gameTimeLimit() 메서드 추가 (기본값: 420초)
- GameSchedulerClient 유틸리티 클래스 생성 (EventBridge Scheduler 연동)
- GameService에 스케줄 생성/취소 로직 추가
- GameAutoCloseHandler Lambda 함수 생성
- template.yaml에 Lambda, IAM Role, Schedule Group 추가

Closes #417

* fix : 메모리 증가 및 Lambda 응답 제한 시간 Cognito 트리거 제한시간과 동일하게 수정 (#439)

* feat: 캐치마인드 게임 방 분리 기능 구현 (#455)

- Room 타입 분리 (CHAT/GAME)
  - RoomType, RoomStatus enum 추가
  - ChatRoom 모델에 type, gameType, gameSettings, status, hostId 필드 추가
  - GameSettings 모델 추가

- 방 생성/조회 API 수정
  - CreateRoomRequest에 type, gameType, gameSettings 필드 추가
  - 방 목록 조회 시 type, gameType, status 필터 지원

- 게임 시작 조건 검증
  - GAME 타입 방에서만 게임 시작 가능 (GAME_007 에러)

- 게임 재시작 API 구현 (#452)
  - POST /rooms/{roomId}/game/restart 엔드포인트 추가
  - 방장만 재시작 가능 (GAME_009 에러)
  - 게임 진행 중 재시작 불가 (GAME_008 에러)

- 방장 변경 로직 구현 (#453)
  - 방장 퇴장 시 다음 멤버에게 자동 이전
  - 모든 멤버 퇴장 시 방 자동 삭제

- WebSocket 메시지 타입 추가 (#454)
  - ROOM_STATUS_CHANGE, HOST_CHANGE 메시지 타입 추가
  - WebSocketMessageHelper에 빌더 메서드 추가

- 테스트 추가
  - RoomType, RoomStatus enum 테스트
  - GameSettings 모델 테스트
  - ChattingErrorCode 테스트 업데이트

Related: #440, #441, #442, #443, #444, #445, #446
Closes: #447, #448, #449, #450, #451, #452, #453, #454

* feat: 참가자 닉네임 및 방장 변경 WebSocket 알림 구현 (#456)

- RoomParticipant DTO 추가 (userId, nickname, isHost)
- ChatRoomQueryService에 닉네임 조회 메서드 추가
  - getParticipantsWithNicknames(): 참가자 목록 + 닉네임
  - getHostNickname(): 방장 닉네임 조회
- ChatRoomHandler.getRoom() 응답에 participants, hostNickname 추가
- ChatRoomCommandService.leaveRoom()에서 방장 변경 시 WebSocket 브로드캐스트

Related: #440

* fix: ChatRoomFunction에 UserTable DynamoDB 권한 추가

- 참가자/방장 닉네임 조회를 위한 UserTable 읽기 권한 추가
- DynamoDBReadPolicy로 UserTable 접근 허용

Fixes #457

* fix: GameSettings에 @DynamoDbBean 어노테이션 추가

- DynamoDB Enhanced Client가 중첩 객체를 직렬화/역직렬화할 수 있도록 수정
- ChatRoom 저장/조회 시 GameSettings 변환 오류 해결

Fixes #457

* fix: ChatRoomFunction에 WEBSOCKET_ENDPOINT 환경변수 및 권한 추가

- leaveRoom에서 WebSocketBroadcaster 사용을 위한 환경변수 추가
- execute-api:ManageConnections 권한 추가

* fix: WebSocket Lambda 함수들에 WEBSOCKET_ENDPOINT 환경변수 추가

- WebSocketConnectFunction에 WEBSOCKET_ENDPOINT 추가
- WebSocketDisconnectFunction에 WEBSOCKET_ENDPOINT 추가
- execute-api:ManageConnections 권한 추가

* fix: Grammar WebSocket Lambda 환경 변수 및 권한 추가

- GrammarStreamingConnectFunction에 WEBSOCKET_ENDPOINT 환경 변수 추가
- GrammarStreamingDisconnectFunction에 WEBSOCKET_ENDPOINT 환경 변수 추가
- 두 함수에 execute-api:ManageConnections 권한 추가

* feat: GSI1SK 확장성 있는 재설계 및 DB 레벨 필터링

## 변경 사항

### GSI1SK 포맷 변경
- 기존: {level}#{createdAt}
- 신규: {type}#{gameType}#{status}#{level}#{createdAt}

### 지원 쿼리 패턴
- 전체 방: GSI1PK = "ROOMS"
- 게임방만: begins_with(GSI1SK, "GAME#")
- 캐치마인드만: begins_with(GSI1SK, "GAME#CATCHMIND#")
- 대기중 캐치마인드: begins_with(GSI1SK, "GAME#CATCHMIND#WAITING#")

### 파일 수정
- ChatRoomCommandService.java: 방 생성 시 새 GSI1SK 포맷 적용
- ChatRoomRepository.java: findByFilters() 메서드 추가, updateStatus() 메서드 추가
- ChatRoomQueryService.java: 메모리 필터링 제거, DB 레벨 필터링으로 변경
- GameService.java: 게임 시작/종료 시 방 상태 업데이트 (GSI1SK 포함)

### 마이그레이션
- scripts/migrate-gsi1sk.sh: 기존 데이터 마이그레이션 스크립트
- 37개 기존 방 마이그레이션 완료

* fix: increase stats query limit to 100 days

- Adjust maximum allowable limit for recent stats query from 30 to 100 days to support extended data range responses.

* feat: improve game round and connection management logic

- Added handling for game round timeout (`ROUND_TIMEOUT`) in WebSocketMessageHandler.
- Enhanced game start broadcast to include `currentWord` for the drawer only.
- Updated ConnectionRepository to remove duplicate user connections in the same room.
- Added `currentWordEnglish` to GameSession for better answer verification.
- Normalized ChatRoom levels to match database storage format.
- Updated template.yaml to include DynamoDBReadPolicy for VocabTable.

* refactor: 코드 정리 및 미사용 클래스 제거 (#459)

* refactor: remove unused WebSocketResponseUtil

* refactor: add AutoCloseable to WebSocketBroadcaster

* refactor: remove unused TestService

* refactor: remove unused WordService

* refactor: remove unused DailyStudyService

* refactor: remove unused UserWordService

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* fix: resolve N+1 query in StatsService

* refactor(all): DI 패턴 및 전략 패턴 적용 (#461)

- Repository, Service, Handler에 DI 생성자 추가 (테스트 용이성)
- BadgeService에 Strategy 패턴 적용 (뱃지 조건 검증 로직 분리)

* refactor: relocate and restructure seed data files

- Moved `question-homes.json` and `words.json` from subdirectories to `seed` folder.
- Updated file paths for better organization and clarity.

* chore: seed 데이터 폴더 구조 정리

* feat: add CI/CD pipeline configuration for CodePipeline

* fix: add SNS topic policy and DependsOn for notification rule

* fix: correct paths in buildspec.yml for CodeBuild

* fix: remove hardcoded JAVA_HOME, use runtime default

* fix: add gradle wrapper for CI/CD build

* fix: use single line sam package command with hardcoded bucket

* fix: use existing stack name group2-englishstudy-chatting

* fix: add missing WEBSOCKET_ENDPOINT env var to WebSocket connect functions

* docs: update FRONTEND-API-GUIDE with new RoomType/RoomStatus structure

* fix: update WebSocketDisconnectHandler to use GameSession model

- Remove references to deleted ChatRoom game fields
- Use GameSessionRepository to finish active game sessions
- Use ChatRoomRepository.updateStatus() for room state management

* perf: optimize CI/CD build time

- Add pip cache for SAM CLI dependencies
- Enable Gradle parallel builds and build cache
- Add SAM build cache (.aws-sam)
- Use sam build --parallel --cached
- Skip SAM CLI install if already cached
- Remove unnecessary 'clean' to leverage cache

* feat: add custom CodeBuild Docker image with pre-installed tools

- Dockerfile with Java 21 + SAM CLI + Gradle pre-installed
- build-and-push.sh script for ECR deployment
- Updated buildspec.yml for custom image (removes SAM CLI install)
- Expected build time reduction: ~30-40 seconds

* feature : AI 영어 회화 연습 기능 (#468)

* feat : WebSocket Connect, Disconnect 핸들러 & SpeakingConnecion 모델 구현

* feat : WebSocket 메시지 처리 handler, service 구현

* feat : WebSocket 연결 정보 Repository 구현

* fix: remove typo in SpeakingConnectionRepository

* chore: trigger build test with custom Docker image

* chore: remove unnecessary newlines and whitespace across WebSocket handlers and related classes

* chore: remove unnecessary newlines and whitespace across WebSocket handlers and related classes

---------

Co-authored-by: hyein Heo <128613248+hye-inA@users.noreply.github.com>

* refactor : websocket -> rest api 전환

* feat : speaking handler REST로 교체

* feat : speaking 관련 dto 생성

* refacotor : 기존 service 코드 로직 재사용 및 repository 리펙토링

* fix: add CORS headers to API Gateway error responses (#479)

API Gateway의 인증 실패 등 에러 응답에 CORS 헤더가 누락되어
CloudFront를 통한 프론트엔드 요청이 차단되는 문제 수정

- UNAUTHORIZED (401) 응답에 CORS 헤더 추가
- ACCESS_DENIED (403) 응답에 CORS 헤더 추가
- DEFAULT_4XX/5XX 응답에 CORS 헤더 추가
- EXPIRED_TOKEN 응답에 CORS 헤더 추가

* feat(news): 뉴스 도메인 기반 구조 구축 (#385)

- NewsCategory, QuizType enum 추가
- NewsKey 상수 클래스 추가
- NewsErrorCode 예외 클래스 추가
- NewsArticle, KeywordInfo, QuizQuestion 모델 추가
- NewsArticleRepository CRUD 구현
- NewsTable DynamoDB 테이블 정의
- CORS GatewayResponses 설정 추가

* feat(news): 뉴스 수집 파이프라인 구현 (#386)

- NewsApiClient: NewsAPI 연동 서비스
- RssFeedParser: RSS 피드 파싱 (BBC, VOA, NPR)
- NewsDuplicateChecker: URL 기반 중복 필터링
- NewsCollectorService: 수집 오케스트레이션
- NewsCollectionHandler: Lambda 핸들러
- EventBridge 스케줄러: 매일 18시 KST 실행

* refactor(news): NewsAPI 제거, RSS만 사용

- NewsApiClient 삭제
- SSM Parameter 의존성 제거
- RSS 소스당 7개씩 수집 (BBC, VOA, NPR = 약 21개/일)

* feat(news): AI 뉴스 분석 시스템 구현 (#387)

- NewsAnalysisService: AI 분석 통합 서비스
  - Bedrock: CEFR 난이도 분석 (A1~C2)
  - Bedrock: 3줄 요약 + 퀴즈 3문제 생성
  - Comprehend: 핵심 키워드 추출
- NewsCollectorService: 수집 시 자동 분석 연동
- GSI1/GSI2 키 자동 설정 (레벨별, 카테고리별 조회)

* feat(news): 뉴스 학습 API 구현 (#388)

- NewsQueryService: 뉴스 조회 서비스
- NewsHandler: API 핸들러
  - GET /news - 목록 조회 (level, category 필터)
  - GET /news/today - 오늘의 뉴스
  - GET /news/recommended - 내 레벨 맞춤 추천
  - GET /news/{articleId} - 상세 조회 (조회수 증가)
- template.yaml: NewsFunction Lambda 추가

* feat(news): 뉴스 학습 부가 기능 구현 (#389)

- 읽기 완료 기록 API (POST /news/{articleId}/read)
- 북마크 토글 API (POST /news/{articleId}/bookmark)
- 북마크 목록 조회 API (GET /news/bookmarks)
- 학습 통계 조회 API (GET /news/stats)
- TTS 오디오 URL 조회 API (GET /news/{articleId}/audio)
- UserNewsRecord 모델 추가
- UserNewsRepository 추가
- NewsLearningService 추가

* feat(news): 복합 퀴즈 시스템 구현 (#471)

- 퀴즈 조회 API (GET /news/{articleId}/quiz)
- 퀴즈 제출 API (POST /news/{articleId}/quiz)
- 퀴즈 기록 조회 API (GET /news/quiz/history)
- NewsQuizResult 모델 추가
- QuizAnswerResult 모델 추가
- NewsQuizRepository 추가
- NewsQuizService 추가

* feat(news): 단어 수집 & Vocabulary 연동 구현 (#472)

- 단어 수집 API (POST /news/{articleId}/words)
- 수집 단어 목록 API (GET /news/words)
- 단어 상세 조회 API (GET /news/{articleId}/words/{word})
- 단어 삭제 API (DELETE /news/{articleId}/words/{word})
- Vocabulary 연동 API (POST /news/words/{word}/sync)
- NewsWordCollect 모델 추가
- NewsWordRepository 추가
- NewsWordService 추가

* feat: add multi-environment deployment support (dev/test/prod)

* fix: update buildspec.yml to deploy prod environment with parameter overrides

* feat(news): 뉴스 도메인 기반 구조 구축 (#385)

- NewsCategory, QuizType enum 추가
- NewsKey 상수 클래스 추가
- NewsErrorCode 예외 클래스 추가
- NewsArticle, KeywordInfo, QuizQuestion 모델 추가
- NewsArticleRepository CRUD 구현
- NewsTable DynamoDB 테이블 정의
- CORS GatewayResponses 설정 추가

* feat(news): 뉴스 수집 파이프라인 구현 (#386)

- NewsApiClient: NewsAPI 연동 서비스
- RssFeedParser: RSS 피드 파싱 (BBC, VOA, NPR)
- NewsDuplicateChecker: URL 기반 중복 필터링
- NewsCollectorService: 수집 오케스트레이션
- NewsCollectionHandler: Lambda 핸들러
- EventBridge 스케줄러: 매일 18시 KST 실행

* refactor(news): NewsAPI 제거, RSS만 사용

- NewsApiClient 삭제
- SSM Parameter 의존성 제거
- RSS 소스당 7개씩 수집 (BBC, VOA, NPR = 약 21개/일)

* feat(news): AI 뉴스 분석 시스템 구현 (#387)

- NewsAnalysisService: AI 분석 통합 서비스
  - Bedrock: CEFR 난이도 분석 (A1~C2)
  - Bedrock: 3줄 요약 + 퀴즈 3문제 생성
  - Comprehend: 핵심 키워드 추출
- NewsCollectorService: 수집 시 자동 분석 연동
- GSI1/GSI2 키 자동 설정 (레벨별, 카테고리별 조회)

* feat(news): 뉴스 학습 API 구현 (#388)

- NewsQueryService: 뉴스 조회 서비스
- NewsHandler: API 핸들러
  - GET /news - 목록 조회 (level, category 필터)
  - GET /news/today - 오늘의 뉴스
  - GET /news/recommended - 내 레벨 맞춤 추천
  - GET /news/{articleId} - 상세 조회 (조회수 증가)
- template.yaml: NewsFunction Lambda 추가

* feat(news): 뉴스 학습 부가 기능 구현 (#389)

- 읽기 완료 기록 API (POST /news/{articleId}/read)
- 북마크 토글 API (POST /news/{articleId}/bookmark)
- 북마크 목록 조회 API (GET /news/bookmarks)
- 학습 통계 조회 API (GET /news/stats)
- TTS 오디오 URL 조회 API (GET /news/{articleId}/audio)
- UserNewsRecord 모델 추가
- UserNewsRepository 추가
- NewsLearningService 추가

* feat(news): 복합 퀴즈 시스템 구현 (#471)

- 퀴즈 조회 API (GET /news/{articleId}/quiz)
- 퀴즈 제출 API (POST /news/{articleId}/quiz)
- 퀴즈 기록 조회 API (GET /news/quiz/history)
- NewsQuizResult 모델 추가
- QuizAnswerResult 모델 추가
- NewsQuizRepository 추가
- NewsQuizService 추가

* feat(news): 단어 수집 & Vocabulary 연동 구현 (#472)

- 단어 수집 API (POST /news/{articleId}/words)
- 수집 단어 목록 API (GET /news/words)
- 단어 상세 조회 API (GET /news/{articleId}/words/{word})
- 단어 삭제 API (DELETE /news/{articleId}/words/{word})
- Vocabulary 연동 API (POST /news/words/{word}/sync)
- NewsWordCollect 모델 추가
- NewsWordRepository 추가
- NewsWordService 추가

* feat: add multi-environment deployment support (dev/test/prod)

* fix: update buildspec.yml to deploy prod environment with parameter overrides

* refactor : AI 말하기 Websocket 구현 -> REST API 구현으로 리팩토링 (#490)

* feat : WebSocket Connect, Disconnect 핸들러 & SpeakingConnecion 모델 구현

* feat : WebSocket 메시지 처리 handler, service 구현

* feat : WebSocket 연결 정보 Repository 구현

* fix : 오타 수정

* refactor : websocket -> rest api 전환

* feat : speaking handler REST로 교체

* feat : speaking 관련 dto 생성

* refacotor : 기존 service 코드 로직 재사용 및 repository 리펙토링

* fix: revert buildspec.yml to build-only for CloudFormation deploy stage

* fix: revert buildspec.yml to build-only for CloudFormation deploy stage

* fix: update all API Gateway StageName to use Environment parameter

* fix: correct VocabularyTable and ContentBucket references in NewsFunction

* fix: correct VocabularyTable and ContentBucket references in NewsFunction

* fix: add stack name prefix to GameScheduleGroup and daily-stats schedule to avoid conflicts

* fix: add stack name prefix to GameScheduleGroup and daily-stats schedule to avoid conflicts

* feat: add support for existing Cognito User Pool reuse across environments

* fix: add conditional Cognito ARN reference in API Gateway Authorizer

* fix: remove Cognito resources completely, use existing Cognito only

* fix: remove Cognito resources completely, use existing Cognito only

* feat : speaking rest API 람다 함수 추가

* feat: add S3 bucket resource and fix environment-specific endpoints

- Add ContentBucket S3 resource for content storage
- Replace hardcoded /dev with ${Environment} in all WebSocket endpoints
- Update Output URLs to use dynamic environment stage

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* fix: add stack name prefix to news-collection schedule name

Prevent EventBridge rule name conflicts across environments

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* fix: add X-Requested-With and Accept headers to CORS config

Enable additional headers for CloudFront CORS compatibility

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* fix: use environment variable for S3 bucket URLs

Replace hardcoded bucket name with BUCKET_NAME env var for multi-env support:
- PreSignUpHandler: dynamic default profile URL
- PostConfirmationHandler: dynamic default profile URL
- UserService: dynamic default profile URL
- BadgeType: dynamic badge image base URL

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* fix: disable authorizer for CORS preflight requests

Add AddDefaultAuthorizerToCorsPreflight: false to prevent
Cognito Authorizer from blocking OPTIONS requests

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* feat : speaking REST API 람다 함수 추가  (#491)

* feature : OPIc 세션관리 + 답변 처리 파이프라인 구현  (#413)

* feat : OPIc 질문 & 세션 관련 dto 생성

* refactor : @DynamoDbBean 주석 추가

* feat : 주제 + 소주제 + 레벨로 오픽 질문 조회 추가

* feat : OPIc 세션, 질문, 답변 종합 handler 구현

* feat : 오픽 주제, 소주제별 seed 데이터 추가

* refactor : Transcribe API KEY 환경변수명 수정

* refactor : Bedrock에 사용하는 클로드 모델 변경

* refactor : S3 Key 대신 Proxy에서 요청하는 Base64 값으로 변환

* feat: GAME_START, ROUND_END 메시지에 serverTime 추가

- broadcastGameStart(): serverTime, roundDuration 필드 추가
- broadcastRoundEnd(): serverTime, roundStartTime, roundDuration 필드 추가
- GameService.endRound(): data에 roundStartTime, roundDuration 포함
- 타이머 동기화 버그 수정을 위한 서버 시간 제공

* feat: WebSocketMessageHelper 유틸리티 클래스 추가

- domain 필드 포함 메시지 생성 헬퍼
- DOMAIN_CHAT, DOMAIN_GAME 상수 정의
- buildChatMessage(), buildGameMessage() 메서드

* feat: 모든 WebSocket 메시지에 domain 필드 추가

- ScoreUpdateMessage에 domain 필드 추가
- broadcastGameStart에 domain:"game" 추가
- broadcastRoundEnd에 domain:"game" 추가
- broadcastCorrectAnswerMessage에 domain:"game" 추가
- handleCommandResult 시스템 메시지에 domain:"game" 추가
- handleRegularMessage 채팅 메시지에 domain:"chat" 추가

Closes #426, #427

* feat: GameSession 모델 클래스 생성

- DynamoDB Enhanced Client 어노테이션 적용
- GSI1: roomId로 활성 게임 세션 조회 가능
- 게임 상태 관리용 헬퍼 메서드 포함

Closes #428

* feat: GameSessionRepository 구현

- 기본 CRUD (save, findById, delete)
- roomId로 활성/전체 게임 세션 조회
- 상태, 라운드, 점수 업데이트 메서드
- 정답자 추가, 힌트 사용, 게임 종료 처리

Closes #429

* refactor: ChatRoom에서 게임 필드 분리

- 게임 관련 필드 제거 (gameStatus, currentRound 등)
- activeGameSessionId 필드 추가
- 게임 상태는 GameSession으로 분리됨

Note: 의존 코드 수정은 #431에서 진행

Closes #430

* refactor: GameSession 기반으로 전체 게임 로직 리팩토링

- GameService: ChatRoom 대신 GameSession 사용
- GameStatsService: GameSession 매개변수로 변경
- CommandService: GameSession 기반 점수 조회
- GameHandler: GameSession 기반 REST API
- WebSocketMessageHandler: GameSession 기반 브로드캐스트
- GameStatusResponse, ScoreboardResponse: GameSession 매개변수

Closes #431

* feat: GameSessionHandler Lambda 및 게임 세션 API 구현

- POST /rooms/{roomId}/games - 게임 세션 생성
- GET /games/{gameSessionId} - 게임 상태 조회 (재접속용)
- POST /games/{gameSessionId}/start - 게임 시작
- POST /games/{gameSessionId}/stop - 게임 종료

모든 응답에 serverTime 포함 (타이머 동기화)
출제자에게만 currentWord 포함

Closes #432, #433

* feat: 게임 시작 7분 후 자동 종료 기능 구현

- GameConfig에 gameTimeLimit() 메서드 추가 (기본값: 420초)
- GameSchedulerClient 유틸리티 클래스 생성 (EventBridge Scheduler 연동)
- GameService에 스케줄 생성/취소 로직 추가
- GameAutoCloseHandler Lambda 함수 생성
- template.yaml에 Lambda, IAM Role, Schedule Group 추가

Closes #417

* fix : 메모리 증가 및 Lambda 응답 제한 시간 Cognito 트리거 제한시간과 동일하게 수정 (#439)

* feat: 캐치마인드 게임 방 분리 기능 구현 (#455)

- Room 타입 분리 (CHAT/GAME)
  - RoomType, RoomStatus enum 추가
  - ChatRoom 모델에 type, gameType, gameSettings, status, hostId 필드 추가
  - GameSettings 모델 추가

- 방 생성/조회 API 수정
  - CreateRoomRequest에 type, gameType, gameSettings 필드 추가
  - 방 목록 조회 시 type, gameType, status 필터 지원

- 게임 시작 조건 검증
  - GAME 타입 방에서만 게임 시작 가능 (GAME_007 에러)

- 게임 재시작 API 구현 (#452)
  - POST /rooms/{roomId}/game/restart 엔드포인트 추가
  - 방장만 재시작 가능 (GAME_009 에러)
  - 게임 진행 중 재시작 불가 (GAME_008 에러)

- 방장 변경 로직 구현 (#453)
  - 방장 퇴장 시 다음 멤버에게 자동 이전
  - 모든 멤버 퇴장 시 방 자동 삭제

- WebSocket 메시지 타입 추가 (#454)
  - ROOM_STATUS_CHANGE, HOST_CHANGE 메시지 타입 추가
  - WebSocketMessageHelper에 빌더 메서드 추가

- 테스트 추가
  - RoomType, RoomStatus enum 테스트
  - GameSettings 모델 테스트
  - ChattingErrorCode 테스트 업데이트

Related: #440, #441, #442, #443, #444, #445, #446
Closes: #447, #448, #449, #450, #451, #452, #453, #454

* feat: 참가자 닉네임 및 방장 변경 WebSocket 알림 구현 (#456)

- RoomParticipant DTO 추가 (userId, nickname, isHost)
- ChatRoomQueryService에 닉네임 조회 메서드 추가
  - getParticipantsWithNicknames(): 참가자 목록 + 닉네임
  - getHostNickname(): 방장 닉네임 조회
- ChatRoomHandler.getRoom() 응답에 participants, hostNickname 추가
- ChatRoomCommandService.leaveRoom()에서 방장 변경 시 WebSocket 브로드캐스트

Related: #440

* fix: ChatRoomFunction에 UserTable DynamoDB 권한 추가

- 참가자/방장 닉네임 조회를 위한 UserTable 읽기 권한 추가
- DynamoDBReadPolicy로 UserTable 접근 허용

Fixes #457

* fix: GameSettings에 @DynamoDbBean 어노테이션 추가

- DynamoDB Enhanced Client가 중첩 객체를 직렬화/역직렬화할 수 있도록 수정
- ChatRoom 저장/조회 시 GameSettings 변환 오류 해결

Fixes #457

* fix: ChatRoomFunction에 WEBSOCKET_ENDPOINT 환경변수 및 권한 추가

- leaveRoom에서 WebSocketBroadcaster 사용을 위한 환경변수 추가
- execute-api:ManageConnections 권한 추가

* fix: WebSocket Lambda 함수들에 WEBSOCKET_ENDPOINT 환경변수 추가

- WebSocketConnectFunction에 WEBSOCKET_ENDPOINT 추가
- WebSocketDisconnectFunction에 WEBSOCKET_ENDPOINT 추가
- execute-api:ManageConnections 권한 추가

* fix: Grammar WebSocket Lambda 환경 변수 및 권한 추가

- GrammarStreamingConnectFunction에 WEBSOCKET_ENDPOINT 환경 변수 추가
- GrammarStreamingDisconnectFunction에 WEBSOCKET_ENDPOINT 환경 변수 추가
- 두 함수에 execute-api:ManageConnections 권한 추가

* feat: GSI1SK 확장성 있는 재설계 및 DB 레벨 필터링

- 기존: {level}#{createdAt}
- 신규: {type}#{gameType}#{status}#{level}#{createdAt}

- 전체 방: GSI1PK = "ROOMS"
- 게임방만: begins_with(GSI1SK, "GAME#")
- 캐치마인드만: begins_with(GSI1SK, "GAME#CATCHMIND#")
- 대기중 캐치마인드: begins_with(GSI1SK, "GAME#CATCHMIND#WAITING#")

- ChatRoomCommandService.java: 방 생성 시 새 GSI1SK 포맷 적용
- ChatRoomRepository.java: findByFilters() 메서드 추가, updateStatus() 메서드 추가
- ChatRoomQueryService.java: 메모리 필터링 제거, DB 레벨 필터링으로 변경
- GameService.java: 게임 시작/종료 시 방 상태 업데이트 (GSI1SK 포함)

- scripts/migrate-gsi1sk.sh: 기존 데이터 마이그레이션 스크립트
- 37개 기존 방 마이그레이션 완료

* fix: increase stats query limit to 100 days

- Adjust maximum allowable limit for recent stats query from 30 to 100 days to support extended data range responses.

* feat: improve game round and connection management logic

- Added handling for game round timeout (`ROUND_TIMEOUT`) in WebSocketMessageHandler.
- Enhanced game start broadcast to include `currentWord` for the drawer only.
- Updated ConnectionRepository to remove duplicate user connections in the same room.
- Added `currentWordEnglish` to GameSession for better answer verification.
- Normalized ChatRoom levels to match database storage format.
- Updated template.yaml to include DynamoDBReadPolicy for VocabTable.

* refactor: 코드 정리 및 미사용 클래스 제거 (#459)

* refactor: remove unused WebSocketResponseUtil

* refactor: add AutoCloseable to WebSocketBroadcaster

* refactor: remove unused TestService

* refactor: remove unused WordService

* refactor: remove unused DailyStudyService

* refactor: remove unused UserWordService

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* fix: resolve N+1 query in StatsService

* refactor(all): DI 패턴 및 전략 패턴 적용 (#461)

- Repository, Service, Handler에 DI 생성자 추가 (테스트 용이성)
- BadgeService에 Strategy 패턴 적용 (뱃지 조건 검증 로직 분리)

* refactor: relocate and restructure seed data files

- Moved `question-homes.json` and `words.json` from subdirectories to `seed` folder.
- Updated file paths for better organization and clarity.

* chore: seed 데이터 폴더 구조 정리

* feat: add CI/CD pipeline configuration for CodePipeline

* fix: add SNS topic policy and DependsOn for notification rule

* fix: correct paths in buildspec.yml for CodeBuild

* fix: remove hardcoded JAVA_HOME, use runtime default

* fix: add gradle wrapper for CI/CD build

* fix: use single line sam package command with hardcoded bucket

* fix: use existing stack name group2-englishstudy-chatting

* fix: add missing WEBSOCKET_ENDPOINT env var to WebSocket connect functions

* docs: update FRONTEND-API-GUIDE with new RoomType/RoomStatus structure

* feat : WebSocket Connect, Disconnect 핸들러 & SpeakingConnecion 모델 구현

* feat : WebSocket 메시지 처리 handler, service 구현

* feat : WebSocket 연결 정보 Repository 구현

* fix: update WebSocketDisconnectHandler to use GameSession model

- Remove references to deleted ChatRoom game fields
- Use GameSessionRepository to finish active game sessions
- Use ChatRoomRepository.updateStatus() for room state management

* perf: optimize CI/CD build time

- Add pip cache for SAM CLI dependencies
- Enable Gradle parallel builds and build cache
- Add SAM build cache (.aws-sam)
- Use sam build --parallel --cached
- Skip SAM CLI install if already cached
- Remove unnecessary 'clean' to leverage cache

* feat: add custom CodeBuild Docker image with pre-installed tools

- Dockerfile with Java 21 + SAM CLI + Gradle pre-installed
- build-and-push.sh script for ECR deployment
- Updated buildspec.yml for custom image (removes SAM CLI install)
- Expected build time reduction: ~30-40 seconds

* feature : AI 영어 회화 연습 기능 (#468)

* feat : WebSocket Connect, Disconnect 핸들러 & SpeakingConnecion 모델 구현

* feat : WebSocket 메시지 처리 handler, service 구현

* feat : WebSocket 연결 정보 Repository 구현

* fix: remove typo in SpeakingConnectionRepository

* fix : 오타 수정

* chore: trigger build test with custom Docker image

* chore: remove unnecessary newlines and whitespace across WebSocket handlers and related classes

* chore: remove unnecessary newlines and whitespace across WebSocket handlers and related classes

* refactor : websocket -> rest api 전환

* feat : speaking handler REST로 교체

* feat : speaking 관련 dto 생성

* refacotor : 기존 service 코드 로직 재사용 및 repository 리펙토링

* fix: add CORS headers to API Gateway error responses (#479)

API Gateway의 인증 실패 등 에러 응답에 CORS 헤더가 누락되어
CloudFront를 통한 프론트엔드 요청이 차단되는 문제 수정

- UNAUTHORIZED (401) 응답에 CORS 헤더 추가
- ACCESS_DENIED (403) 응답에 CORS 헤더 추가
- DEFAULT_4XX/5XX 응답에 CORS 헤더 추가
- EXPIRED_TOKEN 응답에 CORS 헤더 추가

* feat : speaking rest API 람다 함수 추가

---------

Co-authored-by: ddingjoo <ddingsha9@teambind.co.kr>

* refactor : speaking service 재사용

* refactor : AI 영어 회화 연습 코드 리팩토링

* feature : test 벡엔드 서버에 AI 말하기 연습 기능 배포 (#492)

* feat : WebSocket Connect, Disconnect 핸들러 & SpeakingConnecion 모델 구현

* feat : WebSocket 메시지 처리 handler, service 구현

* feat : WebSocket 연결 정보 Repository 구현

* fix : 오타 수정

* refactor : websocket -> rest api 전환

* feat : speaking handler REST로 교체

* feat : speaking 관련 dto 생성

* refacotor : 기존 service 코드 로직 재사용 및 repository 리펙토링

* feat : speaking rest API 람다 함수 추가

* refactor : speaking service 재사용

* refactor : AI 영어 회화 연습 코드 리팩토링

---------

Co-authored-by: DDING JOO <ddingsha9@teambind.co.kr>

* feat : handleChat 메서드 JsonNull 체크 푸가

* feature : handleChat 메서드 JsonNull 체크 추가 (#493)

* feat : WebSocket Connect, Disconnect 핸들러 & SpeakingConnecion 모델 구현

* feat : WebSocket 메시지 처리 handler, service 구현

* feat : WebSocket 연결 정보 Repository 구현

* fix : 오타 수정

* refactor : websocket -> rest api 전환

* feat : speaking handler REST로 교체

* feat : speaking 관련 dto 생성

* refacotor : 기존 service 코드 로직 재사용 및 repository 리펙토링

* feat : speaking rest API 람다 함수 추가

* refactor : speaking service 재사용

* refactor : AI 영어 회화 연습 코드 리팩토링

* feat : handleChat 메서드 JsonNull 체크 푸가

---------

Co-authored-by: DDING JOO <ddingsha9@teambind.co.kr>

* feat(news): 뉴스 학습 배지 시스템 구현 (#473)

- 14개 뉴스 관련 배지 추가 (읽기, 퀴즈, 단어수집, 연속학습, 마스터)
- UserStats에 뉴스 통계 필드 추가
- 6개 뉴스 배지 Strategy 클래스 생성
- 뉴스 읽기/퀴즈/단어수집 시 통계 업데이트 및 배지 체크 연동

* fix: add PATCH method to CORS AllowMethods

* test: BadgeType 개수 테스트 수정 (15 -> 29)

* fix: CORS PATCH 메서드 추가

* docs: 뉴스 기능 프론트엔드 연동 가이드 작성

* fix: NewsCollectionFunction에 Bedrock, Comprehend 권한 추가

* fix: add null check for collectWord request body

- Add INVALID_REQUEST error code to NewsErrorCode
- Check body and word field before accessing in collectWord()
- Prevents NullPointerException when request body is malformed

* feat: enhance stats API and bookmark response for frontend

- Add DAILY stats update for news read/quiz/word collection
- Add /stats/dashboard endpoint with frontend-requested format
  - today: wordsLearned, newsRead, quizzesTaken, wordsTotal
  - overall: totalWordsLearned, totalNewsRead, averageAccuracy, streaks
  - weeklyProgress: last 7 days with date/wordsLearned/newsRead
- Add news-related fields to all stats API responses
- Fix bookmark API to include full article details (title, summary, etc.)

* feat: add category classification to news AI analysis

- Add category field to AnalysisResult record
- Update Bedrock prompt to classify articles into categories
  (WORLD, POLITICS, BUSINESS, TECH, SCIENCE, HEALTH, SPORTS, ENTERTAINMENT, LIFESTYLE)
- Parse and set category from AI response
- Set GSI2 (CATEGORY#) index when category is available

* fix: add /stats/dashboard endpoint to template.yaml

* fix: filter by ARTICLE# prefix in findById to avoid returning UserNewsRecord

* docs: add News API troubleshooting guide

* feat: add Cognito authorizer to News API and enhance keyword extraction

- Set CognitoAuthorizer for all News API endpoints in template.yaml
- Update Bedrock AI to extract keywords with meanings and examples
- Add fallback to Comprehend for keyword extraction when Bedrock fails
- Modify KeywordInfo model to include example field
- Adjust AI prompt to include keyword extraction with examples
- Update AnalysisResult to store keywords and parse them from AI response

* Revert "Merge branch 'test' into prod"

This reverts commit c1a958eac6799d5838a76e4078ae304bcdb62278, reversing
changes made to a6662e0cfc46c6e12f20a89f0df285ff282160bc.

* feat: enhance bookmark and reading status tracking for News API

- Add bookmark and reading status to individual article responses
- Include bookmark status in paginated news responses
- Modify `KeywordInfo` to support Korean translations (`meaningKo`)
- Update AI prompts to extract Korean meanings for keywords

* refactor : session_id가 null 체크 추가

* fix : sessionId NullPointerException 에러 수정  (#496)

* feat : WebSocket Connect, Disconnect 핸들러 & SpeakingConnecion 모델 구현

* feat : WebSocket 메시지 처리 handler, service 구현

* feat : WebSocket 연결 정보 Repository 구현

* fix : 오타 수정

* refactor : websocket -> rest api 전환

* feat : speaking handler REST로 교체

* feat : speaking 관련 dto 생성

* refacotor : 기존 service 코드 로직 재사용 및 repository 리펙토링

* feat : speaking rest API 람다 함수 추가

* refactor : speaking service 재사용

* refactor : AI 영어 회화 연습 코드 리팩토링

* feat : handleChat 메서드 JsonNull 체크 푸가

* refactor : session_id가 null 체크 추가

* feat : template 환경변수 리펙토링

---------

Co-authored-by: DDING JOO <ddingsha9@teambind.co.kr>

* feat: enhance bookmark and reading status tracking for News API

- Add bookmark and reading status to individual article responses
- Include bookmark status in paginated news responses
- Modify `KeywordInfo` to support Korean translations (`meaningKo`)
- Update AI prompts to extract Korean meanings for keywords

* feat: add category filtering to UserWord API with enhanced query logic

- Introduce `category` filtering to `getUserWords` API
- Update WordCategory enums to include "news" category
- Apply category filter after enrichment with word info
- Adjust query limits for bookmarked and incorrect words queries

* feat: add default value for ExistingCognitoClientId in template.yaml

- Set default to an empty string to ensure compatibility with templates using this parameter without explicitly specifying a value.

* fix: SpeakingHandler getStringOrNull 컴파일 에러 수정

* fix: SpeakingHandler getStringOrNull 컴파일 에러 수정

* fix: SpeakingHandler getStringOrNull 컴파일 에러 수정

* fix: Bedrock 키워드(meaningKo 포함)를 article에 저장하도록 수정

* fix: Bedrock 키워드(meaningKo 포함)를 article에 저장하도록 수정

* fix: Bedrock 키워드(meaningKo 포함)를 article에 저장하도록 수정

* fix: Bedrock 키워드(meaningKo 포함)를 article에 저장하도록 수정

* feat: add dashboard stats API and enhance news stats tracking

- Introduce `/stats/dashboard` API for retrieving integrated user stats (today, overall, weekly progress, and level distribution)
- Update `UserStats` model to include additional fields for news stats (newsRead, newsQuizCompleted, newsQuizPerfect, newsWordsCollected, etc.)
- Add atomic updates to track news reading, quiz, and word stats in `UserStatsRepository`
- Modify CloudFormation `template.yaml` to register the new `/stats/dashboard` endpoint

* feat: add dashboard stats API and enhance news stats tracking

- Introduce `/stats/dashboard` API for retrieving integrated user stats (today, overall, weekly progress, and level distribution)
- Update `UserStats` model to include additional fields for news stats (newsRead, newsQuizCompleted, newsQuizPerfect, newsWordsCollected, etc.)
- Add atomic updates to track news reading, quiz, and word stats in `UserStatsRepository`
- Modify CloudFormation `template.yaml` to register the new `/stats/dashboard` endpoint

* feat: add dashboard stats API and enhance news stats tracking

- Introduce `/stats/dashboard` API for retrieving integrated user stats (today, overall, weekly progress, and level distribution)
- Update `UserStats` model to include additional fields for news stats (newsRead, newsQuizCompleted, newsQuizPerfect, newsWordsCollected, etc.)
- Add atomic updates to track news reading, quiz, and word stats in `UserStatsRepository`
- Modify CloudFormation `template.yaml` to register the new `/stats/dashboard` endpoint

* refactor: format code with consistent indentation and spacing

- Apply consistent formatting to improve code readability across multiple files
- Adjust indentation, spacing, and alignment in model classes, DTOs, and repository methods

* fix: filter by ARTICLE# prefix in findById to avoid returning bookmark records

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* feature : Speaking Table & Function template.yaml 파일에 추가 (#513)

* fix: BadgeRepository 클라이언트 초기화 패턴 통일

- 개별 DynamoDbEnhancedClient 생성 대신 AwsClients.dynamoDbEnhanced() 싱글톤 사용
- 다른 Repository들과 동일한 패턴 적용
- 불필요한 import 제거

Closes #396

* feat: EnvConfig 유틸리티 추가 및 환경 변수 검증 적용

환경 변수 미설정 시 명확한 에러 메시지를 제공하는 EnvConfig 유틸리티를 추가하고,
기존 System.getenv 호출을 EnvConfig.getRequired/getOrDefault로 대체함.

- EnvConfig: getRequired, getOrDefault, getIntOrDefault, getLongOrDefault 메서드 제공
- Lambda Cold Start 시점에 환경 변수 누락을 조기 감지
- 기존 Config 클래스(WebSocketConfig, RoomTokenConfig) EnvConfig 사용으로 통일

Closes #403

* refactor: TestService submitTest 메서드 책임 분리

submitTest 메서드를 단일 책임 원칙에 맞게 리팩토링:
- gradeAnswers(): 답안 채점 및 결과 집계
- isAnswerCorrect(): 단일 답안 정답 여부 판단
- buildResultItem(): 결과 항목 생성
- saveTestResult(): 테스트 결과 저장
- GradingResult record: 채점 결과 캡슐화

TestService와 TestCommandService 모두 동일하게 적용

Closes #404

* refactor: 하드코딩된 설정값 환경 변수로 외부화

각 도메인별 Config 클래스를 생성하여 하드코딩된 값들을 환경 변수로 설정 가능하게 변경.
기본값이 있어 환경 변수 미설정 시에도 기존 동작 유지.

## 새로 추가된 Config 클래스
- GrammarConfig: SESSION_TTL_DAYS, MAX_HISTORY_MESSAGES, MAX_TOKENS 등
- GameConfig: TOTAL_ROUNDS, ROUND_TIME_LIMIT, QUICK_GUESS_THRESHOLD_MS
- VocabularyConfig: NEW_WORDS_COUNT, REVIEW_WORDS_COUNT, 상태 전이 임계값 등

## 지원하는 환경 변수
- GRAMMAR_SESSION_TTL_DAYS, GRAMMAR_MAX_HISTORY_MESSAGES, GRAMMAR_MAX_TOKENS
- GAME_TOTAL_ROUNDS, GAME_ROUND_TIME_LIMIT, GAME_QUICK_GUESS_THRESHOLD_MS
- VOCAB_NEW_WORDS_COUNT, VOCAB_REVIEW_WORDS_COUNT
- VOCAB_TRANSITION_TO_REVIEWING, VOCAB_TRANSITION_TO_MASTERED

Closes #406

* test: StudyLevel enum 단위 테스트 추가

* test: Difficulty enum 단위 테스트 추가

* test: StudyConfig 단위 테스트 추가

* test: EnvConfig 단위 테스트 추가

* test: PaginatedResult 단위 테스트 추가

* test: JsonUtil 단위 테스트 추가

* test: CursorUtil 단위 테스트 추가

* test: CommonErrorCode 단위 테스트 추가

* test: CommonException 단위 테스트 추가

* test: BadgeType enum 단위 테스트 추가

* test: BadgeKey 상수 단위 테스트 추가

* test: WordStatus enum 단위 테스트 추가

* test: TestType enum 단위 테스트 추가

* test: VocabularyConfig 단위 테스트 추가

* test: VocabKey 상수 단위 테스트 추가

* test: VocabularyErrorCode 단위 테스트 추가

* test: VocabularyException 단위 테스트 추가

* test: SpacedRepetitionContext 단위 테스트 추가

* test: GrammarLevel enum 단위 테스트 추가

* test: GrammarConfig 단위 테스트 추가

* test: GrammarErrorCode 단위 테스트 추가

* test: GrammarException 단위 테스트 추가

* test: GameStatus enum 단위 테스트 추가

* test: GameConfig 단위 테스트 추가

* test: ChattingErrorCode 단위 테스트 추가

* test: ChattingException 단위 테스트 추가

* fix: OPIc FeedbackResponse.java 문법 오류 수정

* style: AwsClients 코드 포맷팅

* style: EnvConfig 코드 포맷팅

* style: RoomTokenConfig 코드 포맷팅

* style: WebSocketConfig 코드 포맷팅

* style: JsonUtil 코드 포맷팅

* style: GameConfig 코드 포맷팅

* style: GrammarConfig 코드 포맷팅

* style: GrammarKey 코드 포맷팅

* style: GrammarErrorCode 코드 포맷팅

* style: GrammarException 코드 포맷팅

* style: BedrockGrammarCheckFactory 코드 포맷팅

* style: GrammarConversationService 코드 포맷팅

* style: FeedbackResponse 코드 포맷팅

* style: SessionReportResponse 코드 포맷팅

* style: SpeakingError 코드 포맷팅

* style: SpeakingErrorType 코드 포맷팅

* style: OPIcException 코드 포맷팅

* style: OPIcAnswer 코드 포맷팅

* style: OPIcQuestion 코드 포맷팅

* style: OPIcSession 코드 포맷팅

* style: OPIcRepository 코드 포맷팅

* style: FeedbackService 코드 포맷팅

* style: TranscribeProxyService 코드 포맷팅

* style: VocabularyConfig 코드 포맷팅

* style: DailyStudyCommandService 코드 포맷팅

* style: TestCommandService 코드 포맷팅

* style: TestService 코드 포맷팅

* style: CommonErrorCodeSpec 코드 포맷팅

* style: JsonUtilSpec 코드 포맷팅

* style: BadgeTypeSpec 코드 포맷팅

* style: ChattingErrorCodeSpec 코드 포맷팅

* style: GrammarLevelSpec 코드 포맷팅

* style: GrammarErrorCodeSpec 코드 포맷팅

* style: VocabularyErrorCodeSpec 코드 포맷팅

* feature : OPIc 세션관리 + 답변 처리 파이프라인 구현  (#413)

* feat : OPIc 질문 & 세션 관련 dto 생성

* refactor : @DynamoDbBean 주석 추가

* feat : 주제 + 소주제 + 레벨로 오픽 질문 조회 추가

* feat : OPIc 세션, 질문, 답변 종합 handler 구현

* feat : 오픽 주제, 소주제별 seed 데이터 추가

* refactor : Transcribe API KEY 환경변수명 수정

* refactor : Bedrock에 사용하는 클로드 모델 변경

* refactor : S3 Key 대신 Proxy에서 요청하는 Base64 값으로 변환

* feat: GAME_START, ROUND_END 메시지에 serverTime 추가

- broadcastGameStart(): serverTime, roundDuration 필드 추가
- broadcastRoundEnd(): serverTime, roundStartTime, roundDuration 필드 추가
- GameService.endRound(): data에 roundStartTime, roundDuration 포함
- 타이머 동기화 버그 수정을 위한 서버 시간 제공

* feat: WebSocketMessageHelper 유틸리티 클래스 추가

- domain 필드 포함 메시지 생성 헬퍼
- DOMAIN_CHAT, DOMAIN_GAME 상수 정의
- buildChatMessage(), buildGameMessage() 메서드

* feat: 모든 WebSocket 메시지에 domain 필드 추가

- ScoreUpdateMessage에 domain 필드 추가
- broadcastGameStart에 domain:"game" 추가
- broadcastRoundEnd에 domain:"game" 추가
- broadcastCorrectAnswerMessage에 domain:"game" 추가
- handleCommandResult 시스템 메시지에 domain:"game" 추가
- handleRegularMessage 채팅 메시지에 domain:"chat" 추가

Closes #426, #427

* feat: GameSession 모델 클래스 생성

- DynamoDB Enhanced Client 어노테이션 적용
- GSI1: roomId로 활성 게임 세션 조회 가능
- 게임 상태 관리용 헬퍼 메서드 포함

Closes #428

* feat: GameSessionRepository 구현

- 기본 CRUD (save, findById, delete)
- roomId로 활성/전체 게임 세션 조회
- 상태, 라운드, 점수 업데이트 메서드
- 정답자 추가, 힌트 사용, 게임 종료 처리

Closes #429

* refactor: ChatRoom에서 게임 필드 분리

- 게임 관련 필드 제거 (gameStatus, currentRound 등)
- activeGameSessionId 필드 추가
- 게임 상태는 GameSession으로 분리됨

Note: 의존 코드 수정은 #431에서 진행

Closes #430

* refactor: GameSession 기반으로 전체 게임 로직 리팩토링

- GameService: ChatRoom 대신 GameSession 사용
- GameStatsService: GameSession 매개변수로 변경
- CommandService: GameSession 기반 점수 조회
- GameHandler: GameSession 기반 REST API
- WebSocketMessageHandler: GameSession 기반 브로드캐스트
- GameStatusResponse, ScoreboardResponse: GameSession 매개변수

Closes #431

* feat: GameSessionHandler Lambda 및 게임 세션 API 구현

- POST /rooms/{roomId}/games - 게임 세션 생성
- GET /games/{gameSessionId} - 게임 상태 조회 (재접속용)
- POST /games/{gameSessionId}/start - 게임 시작
- POST /games/{gameSessionId}/stop - 게임 종료

모든 응답에 serverTime 포함 (타이머 동기화)
출제자에게만 currentWord 포함

Closes #432, #433

* feat: 게임 시작 7분 후 자동 종료 기능 구현

- GameConfig에 gameTimeLimit() 메서드 추가 (기본값: 420초)
- GameSchedulerClient 유틸리티 클래스 생성 (EventBridge Scheduler 연동)
- GameService에 스케줄 생성/취소 로직 추가
- GameAutoCloseHandler Lambda 함수 생성
- template.yaml에 Lambda, IAM Role, Schedule Group 추가

Closes #417

* fix : 메모리 증가 및 Lambda 응답 제한 시간 Cognito 트리거 제한시간과 동일하게 수정 (#439)

* feat: 캐치마인드 게임 방 분리 기능 구현 (#455)

- Room 타입 분리 (CHAT/GAME)
  - RoomType, RoomStatus enum 추가
  - ChatRoom 모델에 type, gameType, gameSettings, status, hostId 필드 추가
  - GameSettings 모델 추가

- 방 생성/조회 API 수정
  - CreateRoomRequest에 type, gameType, gameSettings 필드 추가
  - 방 목록 조회 시 type, gameType, status 필터 지원

- 게임 시작 조건 검증
  - GAME 타입 방에서만 게임 시작 가능 (GAME_007 에러)

- 게임 재시작 API 구현 (#452)
  - POST /rooms/{roomId}/game/restart 엔드포인트 추가
  - 방장만 재시작 가능 (GAME_009 에러)
  - 게임 진행 중 재시작 불가 (GAME_008 에러)

- 방장 변경 로직 구현 (#453)
  - 방장 퇴장 시 다음 멤버에게 자동 이전
  - 모든 멤버 퇴장 시 방 자동 삭제

- WebSocket 메시지 타입 추가 (#454)
  - ROOM_STATUS_CHANGE, HOST_CHANGE 메시지 타입 추가
  - WebSocketMessageHelper에 빌더 메서드 추가

- 테스트 추가
  - RoomType, RoomStatus enum 테스트
  - GameSettings 모델 테스트
  - ChattingErrorCode 테스트 업데이트

Related: #440, #441, #442, #443, #444, #445, #446
Closes: #447, #448, #449, #450, #451, #452, #453, #454

* feat: 참가자 닉네임 및 방장 변경 WebSocket 알림 구현 (#456)

- RoomParticipant DTO 추가 (userId, nickname, isHost)
- ChatRoomQueryService에 닉네임 조회 메서드 추가
  - getParticipantsWithNicknames(): 참가자 목록 + 닉네임
  - getHostNickname(): 방장 닉네임 조회
- ChatRoomHandler.getRoom() 응답에 participants, hostNickname 추가
- ChatRoomCommandService.leaveRoom()에서 방장 변경 시 WebSocket 브로드캐스트

Related: #440

* fix: ChatRoomFunction에 UserTable DynamoDB 권한 추가

- 참가자/방장 닉네임 조회를 위한 UserTable 읽기 권한 추가
- DynamoDBReadPolicy로 UserTable 접근 허용

Fixes #457

* fix: GameSettings에 @DynamoDbBean 어노테이션 추가

- DynamoDB Enhanced Client가 중첩 객체를 직렬화/역직렬화할 수 있도록 수정
- ChatRoom 저장/조회 시 GameSettings 변환 오류 해결

Fixes #457

* fix: ChatRoomFunction에 WEBSOCKET_ENDPOINT 환경변수 및 권한 추가

- leaveRoom에서 WebSocketBroadcaster 사용을 위한 환경변수 추가
- execute-api:ManageConnections 권한 추가

* fix: WebSocket Lambda 함수들에 WEBSOCKET_ENDPOINT 환경변수 추가

- WebSocketConnectFunction에 WEBSOCKET_ENDPOINT 추가
- WebSocketDisconnectFunction에 WEBSOCKET_ENDPOINT 추가
- execute-api:ManageConnections 권한 추가

* fix: Grammar WebSocket Lambda 환경 변수 및 권한 추가

- GrammarStreamingConnectFunction에 WEBSOCKET_ENDPOINT 환경 변수 추가
- GrammarStreamingDisconnectFunction에 WEBSOCKET_ENDPOINT 환경 변수 추가
- 두 함수에 execute-api:ManageConnections 권한 추가

* feat: GSI1SK 확장성 있는 재설계 및 DB 레벨 필터링

## 변경 사항

### GSI1SK 포맷 변경
- 기존: {level}#{createdAt}
- 신규: {type}#{gameType}#{status}#{level}#{createdAt}

### 지원 쿼리 패턴
- 전체 방: GSI1PK = "ROOMS"
- 게임방만: begins_with(GSI1SK, "GAME#")
- 캐치마인드만: begins_with(GSI1SK, "GAME#CATCHMIND#")
- 대기중 캐치마인드: begins_with(GSI1SK, "GAME#CATCHMIND#WAITING#")

### 파일 수정
- ChatRoomCommandService.java: 방 생성 시 새 GSI1SK 포맷 적용
- ChatRoomRepository.java: findByFilters() 메서드 추가, updateStatus() 메서드 추가
- ChatRoomQueryService.java: 메모리 필터링 제거, DB 레벨 필터링으로 변경
- GameService.java: 게임 시작/종료 시 방 상태 업데이트 (GSI1SK 포함)

### 마이그레이션
- scripts/migrate-gsi1sk.sh: 기존 데이터 마이그레이션 스크립트
- 37개 기존 방 마이그레이션 완료

* fix: increase stats query limit to 100 days

- Adjust maximum allowable limit for recent stats query from 30 to 100 days to support extended data range responses.

* feat: improve game round and connection management logic

- Added handling for game round timeout (`ROUND_TIMEOUT`) in WebSocketMessageHandler.
- Enhanced game start broadcast to include `currentWord` for the drawer only.
- Updated ConnectionRepository to remove duplicate user connections in the same room.
- Added `currentWordEnglish` to GameSession for better answer verification.
- Normalized ChatRoom levels to match database storage format.
- Updated template.yaml to include DynamoDBReadPolicy for VocabTable.

* refactor: 코드 정리 및 미사용 클래스 제거 (#459)

* refactor: remove unused WebSocketResponseUtil

* refactor: add AutoCloseable to WebSocketBroadcaster

* refactor: remove unused TestService

* refactor: remove unused WordService

* refactor: remove unused DailyStudyService

* refactor: remove unused UserWordService

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* fix: resolve N+1 query in StatsService

* refactor(all): DI 패턴 및 전략 패턴 적용 (#461)

- Repository, Service, Handler에 DI 생성자 추가 (테스트 용이성)
- BadgeService에 Strategy 패턴 적용 (뱃지 조건 검증 로직 분리)

* refactor: relocate and restructure seed data files

- Moved `question-homes.json` and `words.json` from subdirectories to `seed` folder.
- Updated file paths for better organization and clarity.

* chore: seed 데이터 폴더 구조 정리

* feat: add CI/CD pipeline configuration for CodePipeline

* fix: add SNS topic policy and DependsOn for notification rule

* fix: correct paths in buildspec.yml for CodeBuild

* fix: remove hardcoded JAVA_HOME, use runtime default

* fix: add gradle wrapper for CI/CD build

* fix: use single line sam package command with hardcoded bucket

* fix: use existing stack name group2-englishstudy-chatting

* fix: add missing WEBSOCKET_ENDPOINT env var to WebSocket connect functions

* docs: update FRONTEND-API-GUIDE with new RoomType/RoomStatus structure

* feat : WebSocket Connect, Disconnect 핸들러 & SpeakingConnecion 모델 구현

* feat : WebSocket 메시지 처리 handler, service 구현

* feat : WebSocket 연결 정보 Repository 구현

* fix: update WebSocketDisconnectHandler to use GameSession model

- Remove references to deleted ChatRoom game fields
- Use GameSessionRepository to finish active game sessions
- Use ChatRoomRepository.updateStatus() for room state management

* perf: optimize CI/CD build time

- Add pip cache for SAM CLI dependencies
- Enable Gradle parallel builds and build cache
- Add SAM build cache (.aws-sam)
- Use sam build --parallel --cached
- Skip SAM CLI install if already cached
- Remove unnecessary 'clean' to leverage cache

* feat: add custom CodeBuild Docker image with pre-installed tools

- Dockerfile with Java 21 + SAM CLI + Gradle pre-installed
- build-and-push.sh script for ECR deployment
- Updated buildspec.yml for custom image (removes SAM CLI install)
- Expected build time reduction: ~30-40 seconds

* feature : AI 영어 회화 연습 기능 (#468)

* feat : WebSocket Connect, Disconnect 핸들러 & SpeakingConnecion 모델 구현

* feat : WebSocket 메시지 처리 handler, service 구현

* feat : WebSocket 연결 정보 Repository 구현

* fix: remove typo in SpeakingConnectionRepository

* fix : 오타 수정

* chore: trigger build test with custom Docker image

* chore: remove unnecessary newlines and whitespace across WebSocket handlers and related classes

* chore: remove unnecessary newlines and whitespace across WebSocket handlers and related classes

* Release: 캐치마인드 게임 분리, AI 회화 연습, CI/CD 파이프라인 (#469)

* feature : OPIc 세션관리 + 답변 처리 파이프라인 구현  (#413)

* feat : OPIc 질문 & 세션 관련 dto 생성

* refactor : @DynamoDbBean 주석 추가

* feat : 주제 + 소주제 + 레벨로 오픽 질문 조회 추가

* feat : OPIc 세션, 질문, 답변 종합 handler 구현

* feat : 오픽 주제, 소주제별 seed 데이터 추가

* refactor : Transcribe API KEY 환경변수명 수정

* refactor : Bedrock에 사용하는 클로드 모델 변경

* refactor : S3 Key 대신 Proxy에서 요청하는 Base64 값으로 변환

* feat: GAME_START, ROUND_END 메시지에 serverTime 추가

- broadcastGameStart(): serverTime, roundDuration 필드 추가
- broadcastRoundEnd(): serverTime, roundStartTime, roundDuration 필드 추가
- GameService.endRound(): data에 roundStartTime, roundDuration 포함
- 타이머 동기화 버그 수정을 위한 서버 시간 제공

* feat: WebSocketMessageHelper 유틸리티 클래스 추가

- domain 필드 포함 메시지 생성 헬퍼
- DOMAIN_CHAT, DOMAIN_GAME 상수 정의
- buildChatMessage(), buildGameMessage() 메서드

* feat: 모든 WebSocket 메시지에 domain 필드 추가

- ScoreUpdateMessage에 domain 필드 추가
- broadcastGameStart에 domain:"game" 추가
- broadcastRoundEnd에 domain:"game" 추가
- broadcastCorrectAnswerMessage에 domain:"game" 추가
- handleCommandResult 시스템 메시지에 domain:"game" 추가
- handleRegularMessage 채팅 메시지에 domain:"chat" 추가

Closes #426, #427

* feat: GameSession 모델 클래스 생성

- DynamoDB Enhanced Client 어노테이션 적용
- GSI1: roomId로 활성 게임 세션 조회 가능
- 게임 상태 관리용 헬퍼 메서드 포함

Closes #428

* feat: GameSessionRepository 구현

- 기본 CRUD (save, findById, delete)
- roomId로 활성/전체 게임 세션 조회
- 상태, 라운드, 점수 업데이트 메서드
- 정답자 추가, 힌트 사용, 게임 종료 처리

Closes #429

* refactor: ChatRoom에서 게임 필드 분리

- 게임 관련 필드 제거 (gameStatus, currentRound 등)
- activeGameSessionId 필드 추가
- 게임 상태는 GameSession으로 분리됨

Note: 의존 코드 수정은 #431에서 진행

Closes #430

* refactor: GameSession 기반으로 전체 게임 로직 리팩토링

- GameService: ChatRoom 대신 GameSession 사용
- GameStatsService: GameSession 매개변수로 변경
- CommandService: GameSession 기반 점수 조회
- GameHandler: GameSession 기반 REST API
- WebSocketMessageHandler: GameSession 기반 브로드캐스트
- GameStatusResponse, ScoreboardResponse: GameSession 매개변수

Closes #431

* feat: GameSessionHandler Lambda 및 게임 세션 API 구현

- POST /rooms/{roomId}/games - 게임 세션 생성
- GET /games/{gameSessionId} - 게임 상태 조회 (재접속용)
- POST /games/{gameSessionId}/start - 게임 시작
- POST /games/{gameSessionId}/stop - 게임 종료

모든 응답에 serverTime 포함 (타이머 동기화)
출제자에게만 currentWord 포함

Closes #432, #433

* feat: 게임 시작 7분 후 자동 종료 기능 구현

- GameConfig에 gameTimeLimit() 메서드 추가 (기본값: 420초)
- GameSchedulerClient 유틸리티 클래스 생성 (EventBridge Scheduler 연동)
- GameService에 스케줄 생성/취소 로직 추가
- GameAutoCloseHandler Lambda 함수 생성
- template.yaml에 Lambda, IAM Role, Schedule Group 추가

Closes #417

* fix : 메모리 증가 및 Lambda 응답 제한 시간 Cognito 트리거 제한시간과 동일하게 수정 (#439)

* feat: 캐치마인드 게임 방 분리 기능 구현 (#455)

- Room 타입 분리 (CHAT/GAME)
  - RoomType, RoomStatus enum 추가
  - ChatRoom 모델에 type, gameType, gameSettings, status, hostId 필드 추가
  - GameSettings 모델 추가

- 방 생성/조회 API 수정
  - CreateRoomRequest에 type, gameType, gameSettings 필드 추가
  - 방 목록 조회 시 type, gameType, status 필터 지원

- 게임 시작 조건 검증
  - GAME 타입 방에서만 게임 시작 가능 (GAME_007 에러)

- 게임 재시작 API 구현 (#452)
  - POST /rooms/{roomId}/game/restart 엔드포인트 추가
  - 방장만 재시작 가능 (GAME_009 에러)
  - 게임 진행 중 재시작 불가 (GAME_008 에러)

- 방장 변경 로직 구현 (#453)
  - 방장 퇴장 시 다음 멤버에게 자동 이전
  - 모든 멤버 퇴장 시 방 자동 삭제

- WebSocket 메시지 타입 추가 (#454)
  - ROOM_STATUS_CHANGE, HOST_CHANGE 메시지 타입 추가
  - WebSocketMessageHelper에 빌더 메서드 추가

- 테스트 추가
  - RoomType, RoomStatus enum 테스트
  - GameSettings 모델 테스트
  - ChattingErrorCode 테스트 업데이트

Related: #440, #441, #442, #443, #444, #445, #446
Closes: #447, #448, #449, #450, #451, #452, #453, #454

* feat: 참가자 닉네임 및 방장 변경 WebSocket 알림 구현 (#456)

- RoomParticipant DTO 추가 (userId, nickname, isHost)
- ChatRoomQueryService에 닉네임 조회 메서드 추가
  - getParticipantsWithNicknames(): 참가자 목록 + 닉네임
  - getHostNickname(): 방장 닉네임 조회
- ChatRoomHandler.getRoom() 응답에 participants, hostNickname 추가
- ChatRoomCommandService.leaveRoom()에서 방장 변경 시 WebSocket 브로드캐스트

Related: #440

* fix: ChatRoomFunction에 UserTable DynamoDB 권한 추가

- 참가자/방장 닉네임 조회를 위한 UserTable 읽기 권한 추가
- DynamoDBReadPolicy로 UserTable 접근 허용

Fixes #457

* fix: GameSettings에 @DynamoDbBean 어노테이션 추가

- DynamoDB Enhanced Client가 중첩 객체를 직렬화/역직렬화할 수 있도록 수정
- ChatRoom 저장/조회 시 GameSettings 변환 오류 해결

Fixes #457

* fix: ChatRoomFunction에 WEBSOCKET_ENDPOINT 환경변수 및 권한 추가

- leaveRoom에서 WebSocketBroadcaster 사용을 위한 환경변수 추가
- execute-api:ManageConnections 권한 추가

* fix: WebSocket Lambda 함수들에 WEBSOCKET_ENDPOINT 환경변수 추가

- WebSocketConnectFunction에 WEBSOCKET_ENDPOINT 추가
- WebSocketDisconnectFunction에 WEBSOCKET_ENDPOINT 추가
- execute-api:ManageConnections 권한 추가

* fix: Grammar WebSocket Lambda 환경 변수 및 권한 추가

- GrammarStreamingConnectFunction에 WEBSOCKET_ENDPOINT 환경 변수 추가
- GrammarStreamingDisconnectFunction에 WEBSOCKET_ENDPOINT 환경 변수 추가
- 두 함수에 execute-api:ManageConnections 권한 추가

* feat: GSI1SK 확장성 있는 재설계 및 DB 레벨 필터링

## 변경 사항

### GSI1SK 포맷 변경
- 기존: {level}#{createdAt}
- 신규: {type}#{gameType}#{status}#{level}#{createdAt}

### 지원 쿼리 패턴
- 전체 방: GSI1PK = "ROOMS"
- 게임방만: begins_with(GSI1SK, "GAME#")
- 캐치마인드만: begins_with(GSI1SK, "GAME#CATCHMIND#")
- 대기중 캐치마인드: begins_with(GSI1SK, "GAME#CATCHMIND#WAITING#")

### 파일 수정
- ChatRoomCommandService.java: 방 생성 시 새 GSI1SK 포맷 적용
- ChatRoomRepository.java: findByFilters() 메서드 추가, updateStatus() 메서드 추가
- ChatRoomQueryService.java: 메모리 필터링 제거, DB 레벨 필터링으로 변경
- GameService.java: 게임 시작/종료 시 방 상태 업데이트 (GSI1SK 포함)

### 마이그레이션
- scripts/migrate-gsi1sk.sh: 기존 데이터 마이그레이션 스크립트
- 37개 기존 방 마이그레이션 완료

* fix: increase stats query limit to 100 days

- Adjust maximum allowable limit for recent stats query from 30 to 100 days to support extended data range responses.

* feat: improve game round and connection management logic

- Added handling for game round timeout (`ROUND_TIMEOUT`) in WebSocketMessageHandler.
- Enhanced game start broadcast to include `currentWord` for the drawer only.
- Updated ConnectionRepository to remove duplicate user connections in the same room.
- Added `currentWordEnglish` to GameSession for better answer verification.
- Normalized ChatRoom levels to match database storage format.
- Updated template.yaml to include DynamoDBReadPolicy for VocabTable.

* refactor: 코드 정리 및 미사용 클래스 제거 (#459)

* refactor: remove unused WebSocketResponseUtil

* refactor: add AutoCloseable to WebSocketBroadcaster

* refactor: remove unused TestService

* refactor: remove unused WordService

* refactor: remove unused DailyStudyService

* refactor: remove unused UserWordService

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* fix: resolve N+1 query in StatsService

* refactor(all): DI 패턴 및 전략 패턴 적용 (#461)

- Repository, Service, Handler에 DI 생성자 추가 (테스트 용이성)
- BadgeService에 Strategy 패턴 적용 (뱃지 조건 검증 로직 분리)

* refactor: relocate and restructure seed data files

- Moved `question-homes.json` and `words.json` from subdirectories to `seed` folder.
- Updated file paths for better organization and clarity.

* chore: seed 데이터 폴더 구조 정리

* feat: add CI/CD pipeline configuration for CodePipeline

* fix: add SNS topic policy and DependsOn for notification rule

* fix: correct paths in buildspec.yml for CodeBuild

* fix: remove hardcoded JAVA_HOME, use runtime default

* fix: add gradle wrapper for CI/CD build

* fix: use single line sam package command with hardcoded bucket

* fix: use existing stack name group2-englishstudy-chatting

* fix: add missing WEBSOCKET_ENDPOINT env var to WebSocket connect functions

* docs: update FRONTEND-API-GUIDE with new RoomType/RoomStatus structure

* fix: update WebSocketDisconnectHandler to use GameSession model

- Remove references to deleted ChatRoom game fields
- Use GameSessionRepository to finish active game sessions
- Use ChatRoomRepository.updateStatus() for room state management

* perf: optimize CI/CD build time

- Add pip cache for SAM CLI dependencies
- Enable Gradle parallel builds and build cache
- Add SAM build cache (.aws-sam)
- Use sam build --parallel --cached
- Skip SAM CLI install if already cached
- Remove unnecessary 'clean' to leverage cache

* feat: add custom CodeBuild Docker image with pre-installed tools

- Dockerfile with Java 21 + SAM CLI + Gradle pre-installed
- build-and-push.sh script for ECR deployment
- Updated buildspec.yml for custom image (removes SAM CLI install)
- Expected build time reduction: ~30-40 seconds

* feature : AI 영어 회화 연습 기능 (#468)

* feat : WebSocket Connect, Disconnect 핸들러 & SpeakingConnecion 모델 구현

* feat : WebSocket 메시지 처리 handler, service 구현

* feat : WebSocket 연결 정보 Repository 구현

* fix: remove typo in SpeakingConnectionRepository

* chore: trigger build test with custom Docker image

* chore: remove unnecessary newlines and whitespace across WebSocket handlers and related classes

* chore: remove unnecessary newlines and whitespace across WebSocket handlers and related classes

---------

Co-authored-by: hyein Heo <128613248+hye-inA@users.noreply.github.com>

* refactor : websocket -> rest api 전환

* feat : speaking handler REST로 교체

* feat : speaking 관련 dto 생성

* refacotor : 기존 service 코드 로직 재사용 및 repository 리펙토링

* fix: add CORS headers to API Gateway error responses (#479)

API Gateway의 인증 실패 등 에러 응답에 CORS 헤더가 누락되어
CloudFront를 통한 프론트엔드 요청이 차단되는 문제 수정

- UNAUTHORIZED (401) 응답에 CORS 헤더 추가
- ACCESS_DENIED (403) 응답에 CORS 헤더 추가
- DEFAULT_4XX/5XX 응답에 CORS 헤더 추가
- EXPIRED_TOKEN 응답에 CORS 헤더 추가

* feat(news): 뉴스 도메인 기반 구조 구축 (#385)

- NewsCategory, QuizType enum 추가
- NewsKey 상수 클래스 추가
- NewsErrorCode 예외 클래스 추가
- NewsArticle, KeywordInfo, QuizQuestion 모델 추가
- NewsArticleRepository CRUD 구현
- NewsTable DynamoDB 테이블 정의
- CORS GatewayResponses 설정 추가

* feat(news): 뉴스 수집 파이프라인 구현 (#386)

- NewsApiClient: NewsAPI 연동 서비스
- RssFeedParser: RSS 피드 파싱 (BBC, VOA, NPR)
- NewsDuplicateChecker: URL 기반 중복 필터링
- NewsCollectorService: 수집 오케스트레이션
- NewsCollectionHandler: Lambda 핸들러
- EventBridge 스케줄러: 매일 18시 KST 실행

* refactor(news): NewsAPI 제거, RSS만 사용

- NewsApiClient 삭제
- SSM Parameter 의존성 제거
- RSS 소스당 7개씩 수집 (BBC, VOA, NPR = 약 21개/일)

* feat(news): AI 뉴스 분석 시스템 구현 (#387)

- NewsAnalysisService: AI 분석 통합 서비스
  - Bedrock: CEFR 난이도 분석 (A1~C2)
  - Bedrock: 3줄 요약 + 퀴즈 3문제 생성
  - Comprehend: 핵심 키워드 추출
- NewsCollectorService: 수집 시 자동 분석 연동
- GSI1/GSI2 키 자동 설정 (레벨별, 카테고리별 조회)

* feat(news): 뉴스 학습 API 구현 (#388)

- NewsQueryService: 뉴스 조회 서비스
- NewsHandler: API 핸들러
  - GET /news - 목록 조회 (level, category 필터)
  - GET /news/today - 오늘의 뉴스
  - GET /news/recommended - 내 레벨 맞춤 추천
  - GET /news/{articleId} - 상세 조회 (조회수 증가)
- template.yaml: NewsFunction Lambda 추가

* feat(news): 뉴스 학습 부가 기능 구현 (#389)

- 읽기 완료 기록 API (POST /news/{articleId}/read)
- 북마크 토글 API (POST /news/{articleId}/bookmark)
- 북마크 목록 조회 API (GET /news/bookmarks)
- 학습 통계 조회 API (GET /news/stats)
- TTS 오디오 URL 조회 API (GET /news/{articleId}/audio)
- UserNewsRecord 모델 추가
- UserNewsRepository 추가
- NewsLearningService 추가

* feat(news): 복합 퀴즈 시스템 구현 (#471)

- 퀴즈 조회 API (GET /news/{articleId}/quiz)
- 퀴즈 제출 API (POST /news/{articleId}/quiz)
- 퀴즈 기록 조회 API (GET /news/quiz/history)
- NewsQuizResult 모델 추가
- QuizAnswerResult 모델 추가
- NewsQuizRepository 추가
- NewsQuizService 추가

* feat(news): 단어 수집 & Vocabulary 연동 구현 (#472)

- 단어 수집 API (POST /news/{articleId}/words)
- 수집 단어 목록 API (GET /news/words)
- 단어 상세 조회 API (GET /news/{articleId}/words/{word})
- 단어 삭제 API (DELETE /news/{articleId}/words/{word})
- Vocabulary 연동 API (POST /news/words/{word}/sync)
- NewsWordCollect 모델 추가
- NewsWordRepository 추가
- NewsWordService 추가

* feat: add multi-environment deployment support (dev/test/prod)

* fix: update buildspec.yml to deploy prod environment with parameter overrides

* feat(news): 뉴스 도메인 기반 구조 구축 (#385)

- NewsCategory, QuizType enum 추가
- NewsKey 상수 클래스 추가
- NewsErrorCode 예외 클래스 추가
- NewsArticle, KeywordInfo, QuizQuestion 모델 추가
- NewsArticleRepository CRUD 구현
- NewsTable DynamoDB 테이블 정의
- CORS GatewayResponses 설정 추가

* feat(news): 뉴스 수집 파이프라인 구현 (#386)

- NewsApiClient: NewsAPI 연동 서비스
- RssFeedParser: RSS 피드 파싱 (BBC, VOA, NPR)
- NewsDuplicateChecker: URL 기반 중복 필터링
- NewsCollectorService: 수집 오케스트레이션
- NewsCollectionHandler: Lambda 핸들러
- EventBridge 스케줄러: 매일 18시 KST 실행

* refactor(news): NewsAPI 제거, RSS만 사용

- NewsApiClient 삭제
- SSM Parameter 의존성 제거
- RSS 소스당 7개씩 수집 (BBC, VOA, NPR = 약 21개/일)

* feat(news): AI 뉴스 분석 시스템 구현 (#387)

- NewsAnalysisService: AI 분석 통합 서비스
  - Bedrock: CEFR 난이도 분석 (A1~C2)
  - Bedrock: 3줄 요약 + 퀴즈 3문제 생성
  - Comprehend: 핵심 키워드 추출
- NewsCollectorService: 수집 시 자동 분석 연동
- GSI1/GSI2 키 자동 설정 (레벨별, 카테고리별 조회)

* feat(news): 뉴스 학습 API 구현 (#388)

- NewsQueryService: 뉴스 조회 서비스
- NewsHandler: API 핸들러
  - GET /news - 목록 조회 (level, category 필터)
  - GET /news/today - 오늘의 뉴스
  - GET /news/recommended - 내 레벨 맞춤 추천
  - GET /news/{articleId} - 상세 조회 (조회수 증가)
- template.yaml: NewsFunction Lambda 추가

* feat(news): 뉴스 학습 부가 기능 구현 (#389)

- 읽기 완료 기록 API (POST /news/{articleId}/read)
- 북마크 토글 API (POST /news/{articleId}/bookmark)
- 북마크 목록 조회 API (GET /news/bookmarks)
- 학습 통계 조회 API (GET /news/stats)
- TTS 오디오 URL 조회 API (GET /news/{articleId}/audio)
- UserNewsRecord 모델 추가
- UserNewsRepository 추가
- NewsLearningService 추가

* feat(news): 복합 퀴즈 시스템 구현 (#471)

- 퀴즈 조회 API (GET /news/{articleId}/quiz)
- 퀴즈 제출 API (POST /news/{articleId}/quiz)
- 퀴즈 기록 조회 API (GET /news/quiz/history)
- NewsQuizResult 모델 추가
- QuizAnswerResult 모델 추가
- NewsQuizRepository 추가
- NewsQuizService 추가

* feat(news): 단어 수집 & Vocabulary 연동 구현 (#472)

- 단어 수집 API (POST /news/{articleId}/words)
- 수집 단어 목록 API (GET /news/words)
- 단어 상세 조회 API (GET /news/{articleId}/words/{word})
- 단어 삭제 API (DELETE /news/{articleId}/words/{word})
- Vocabulary 연동 API (POST /news/words/{word}/sync)
- NewsWordCollect 모델 추가
- NewsWordRepository 추가
- NewsWordService 추가

* feat: add multi-environment deployment support (dev/test/prod)

* fix: update buildspec.yml to deploy prod environment with parameter overrides

* refactor : AI 말하기 Websocket 구현 -> REST API 구현으로 리팩토링 (#490)

* feat : WebSocket Connect, Disconnect 핸들러 & SpeakingConnecion 모델 구현

* feat : WebSocket 메시지 처리 handler, service 구현

* feat : WebSocket 연결 정보 Repository 구현

* fix : 오타 수정

* refactor : websocket -> rest api 전환

* feat : speaking handler REST로 교체

* feat : speaking 관련 dto 생성

* refacotor : 기존 service 코드 로직 재사용 및 repository 리펙토링

* fix: revert buildspec.yml to build-only for CloudFormation deploy stage

* fix: revert buildspec.yml to build-only for CloudFormation deploy stage

* fix: update all API Gateway StageName to use Environment parameter

* fix: correct VocabularyTable and ContentBucket references in NewsFunction

* fix: correct VocabularyTable and ContentBucket references in NewsFunction

* fix: add stack name prefix to GameScheduleGroup and daily-stats schedule to avoid conflicts

* fix: add stack name prefix to GameScheduleGroup and daily-stats schedule to avoid conflicts

* feat: add support for existing Cognito User Pool reuse across environments

* fix: add conditional Cognito ARN reference in API Gateway Authorizer

* fix: remove Cognito resources completely, use existing Cognito only

* fix: remove Cognito resources completely, use existing Cognito only

* feat : speaking rest API 람다 함수 추가

* feat: add S3 bucket resource and fix environment-specific endpoints

- Add ContentBucket S3 resource for content storage
- Replace hardcoded /dev with ${Environment} in all WebSocket endpoints
- Update Output URLs to use dynamic environment stage

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* fix: add stack name prefix to news-collection schedule name

Prevent EventBridge rule name conflicts across environments

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* fix: add X-Requested-With and Accept headers to CORS config

Enable additional headers for CloudFront CORS compatibility

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* fix: use environment variable for S3 bucket URLs

Replace hardcoded bucket name with BUCKET_NAME env var for multi-env support:
- PreSignUpHandler: dynamic default profile URL
- PostConfirmationHandler: dynamic default profile URL
- UserService: dynamic default profile URL
- BadgeType: dynamic badge image base URL

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* fix: disable authorizer for CORS preflight requests

Add AddDefaultAuthorizerToCorsPreflight: false to prevent
Cognito Authorizer from blocking OPTIONS requests

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* feat : speaking REST API 람다 함수 추가  (#491)

* feature : OPIc 세션관리 + 답변 처리 파이프라인 구현  (#413)

* feat : OPIc 질문 & 세션 관련 dto 생성

* refactor : @DynamoDbBean 주석 추가

* feat : 주제 + 소주제 + 레벨로 오픽 질문 조회 추가

* feat : OPIc 세션, 질문, 답변 종합 handler 구현

* feat : 오픽 주제, 소주제별 seed 데이터 추가

* refactor : Transcribe API KEY 환경변수명 수정

* refactor : Bedrock에 사용하는 클로드 모델 변경

* refactor : S3 Key 대신 Proxy에서 요청하는 Base64 값으로 변환

* feat: GAME_START, ROUND_END 메시지에 serverTime 추가

- broadcastGameStart(): serverTime, roundDuration 필드 추가
- broadcastRoundEnd(): serverTime, roundStartTime, roundDuration 필드 추가
- GameService.endRound(): data에 roundStartTime, roundDuration 포함
- 타이머 동기화 버그 수정을 위한 서버 시간 제공

* feat: WebSocketMessageHelper 유틸리티 클래스 추가

- domain 필드 포함 메시지 생성 헬퍼
- DOMAIN_CHAT, DOMAIN_GAME 상수 정의
- buildChatMessage(), buildGameMessage() 메서드

* feat: 모든 WebSocket 메시지에 domain 필드 추가

- ScoreUpdateMessage에 domain 필드 추가
- broadcastGameStart에 domain:"game" 추가
- broadcastRoundEnd에 domain:"game" 추가
- broadcastCorrectAnswerMessage에 domain:"game" 추가
- handleCommandResult 시스템 메시지에 domain:"game" 추가
- handleRegularMessage 채팅 메시지에 domain:"chat" 추가

Closes #426, #427

* feat: GameSession 모델 클래스 생성

- DynamoDB Enhanced Client 어노테이션 적용
- GSI1: roomId로 활성 게임 세션 조회 가능
- 게임 상태 관리용 헬퍼 메서드 포함

Closes #428

* feat: GameSessionRepository 구현

- 기본 CRUD (save, findById, delete)
- roomId로 활성/전체 게임 세션 조회
- 상태, 라운드, 점수 업데이트 메서드
- 정답자 추가, 힌트 사용, 게임 종료 처리

Closes #429

* refactor: ChatRoom에서 게임 필드 분리

- 게임 관련 필드 제거 (gameStatus, currentRound 등)
- activeGameSessionId 필드 추가
- 게임 상태는 GameSession으로 분리됨

Note: 의존 코드 수정은 #431에서 진행

Closes #430

* refactor: GameSession 기반으로 전체 게임 로직 리팩토링

- GameService: ChatRoom 대신 GameSession 사용
- GameStatsService: GameSession 매개변수로 변경
- CommandService: GameSession 기반 점수 조회
- GameHandler: GameSession 기반 REST API
- WebSocketMessageHandler: GameSession 기반 브로드캐스트
- GameStatusResponse, ScoreboardResponse: GameSession 매개변수

Closes #431

* feat: GameSessionHandler Lambda 및 게임 세션 API 구현

- POST /rooms/{roomId}/games - 게임 세션 생성
- GET /games/{gameSessionId} - 게임 상태 조회 (재접속용)
- POST /games/{gameSessionId}/start - 게임 시작
- POST /games/{gameSessionId}/stop - 게임 종료

모든 응답에 serverTime 포함 (타이머 동기화)
출제자에게만 currentWord 포함

Closes #432, #433

* feat: 게임 시작 7분 후 자동 종료 기능 구현

- GameConfig에 gameTimeLimit() 메서드 추가 (기본값: 420초)
- GameSchedulerClient 유틸리티 클래스 생성 (EventBridge Scheduler 연동)
- GameService에 스케줄 생성/취소 로직 추가
- GameAutoCloseHandler Lambda 함수 생성
- template.yaml에 Lambda, IAM Role, Schedule Group 추가

Closes #417

* fix : 메모리 증가 및 Lambda 응답 제한 시간 Cognito 트리거 제한시간과 동일하게 수정 (#439)

* feat: 캐치마인드 게임 방 분리 기능 구현 (#455)

- Room 타입 분리 (CHAT/GAME)
  - RoomType, RoomStatus enum 추가
  - ChatRoom 모델에 type, gameType, gameSettings, status, hostId 필드 추가
  - GameSettings 모델 추가

- 방 생성/조회 API 수정
  - CreateRoomRequest에 type, gameType, gameSettings 필드 추가
  - 방 목록 조회 시 type, gameType, status 필터 지원

- 게임 시작 조건 검증
  - GAME 타입 방에서만 게임 시작 가능 (GAME_007 에러)

- 게임 재시작 API 구현 (#452)
  - POST /rooms/{roomId}/game/restart 엔드포인트 추가
  - 방장만 재시작 가능 (GAME_009 에러)
  - 게임 진행 중 재시작 불가 (GAME_008 에러)

- 방장 변경 로직 구현 (#453)
  - 방장 퇴장 시 다음 멤버에게 자동 이전
  - 모든 멤버 퇴장 시 방 자동 삭제

- WebSocket 메시지 타입 추가 (#454)
  - ROOM_STATUS_CHANGE, HOST_CHANGE 메시지 타입 추가
  - WebSocketMessageHelper에 빌더 메서드 추가

- 테스트 추가
  - RoomType, RoomStatus enum 테스트
  - GameSettings 모델 테스트
  - ChattingErrorCode 테스트 업데이트

Related: #440, #441, #442, #443, #444, #445, #446
Closes: #447, #448, #449, #450, #451, #452, #453, #454

* feat: 참가자 닉네임 및 방장 변경 WebSocket 알림 구현 (#456)

- RoomParticipant DTO 추가 (userId, nickname, isHost)
- ChatRoomQueryService에 닉네임 조회 메서드 추가
  - getParticipantsWithNicknames(): 참가자 목록 + 닉네임
  - getHostNickname(): 방장 닉네임 조회
- ChatRoomHandler.getRoom() 응답에 participants, hostNickname 추가
- ChatRoomCommandService.leaveRoom()에서 방장 변경 시 WebSocket 브로드캐스트

Related: #440

* fix: ChatRoomFunction에 UserTable DynamoDB 권한 추가

- 참가자/방장 닉네임 조회를 위한 UserTable 읽기 권한 추가
- DynamoDBReadPolicy로 UserTable 접근 허용

Fixes #457

* fix: GameSettings에 @DynamoDbBean 어노테이션 추가

- DynamoDB Enhanced Client가 중첩 객체를 직렬화/역직렬화할 수 있도록 수정
- ChatRoom 저장/조회 시 GameSettings 변환 오류 해결

Fixes #457

* fix: ChatRoomFunction에 WEBSOCKET_ENDPOINT 환경변수 및 권한 추가

- leaveRoom에서 WebSocketBroadcaster 사용을 위한 환경변수 추가
- execute-api:ManageConnections 권한 추가

* fix: WebSocket Lambda 함수들에 WEBSOCKET_ENDPOINT 환경변수 추가

- WebSocketConnectFunction에 WEBSOCKET_ENDPOINT 추가
- WebSocketDisconnectFunction에 WEBSOCKET_ENDPOINT 추가
- execute-api:ManageConnections 권한 추가

* fix: Grammar WebSocket Lambda 환경 변수 및 권한 추가

- GrammarStreamingConnectFunction에 WEBSOCKET_ENDPOINT 환경 변수 추가
- GrammarStreamingDisconnectFunction에 WEBSOCKET_ENDPOINT 환경 변수 추가
- 두 함수에 execute-api:ManageConnections 권한 추가

* feat: GSI1SK 확장성 있는 재설계 및 DB 레벨 필터링

- 기존: {level}#{createdAt}
- 신규: {type}#{gameType}#{status}#{level}#{createdAt}

- 전체 방: GSI1PK = "ROOMS"
- 게임방만: begins_with(GSI1SK, "GAME#")
- 캐치마인드만: begins_with(GSI1SK, "GAME#CATCHMIND#")
- 대기중 캐치마인드: begins_with(GSI1SK, "GAME#CATCHMIND#WAITING#")

- ChatRoomCommandService.java: 방 생성 시 새 GSI1SK 포맷 적용
- ChatRoomRepository.java: findByFilters() 메서드 추가, updateStatus() 메서드 추가
- ChatRoomQueryService.java: 메모리 필터링 제거, DB 레벨 필터링으로 변경
- GameService.java: 게임 시작/종료 시 방 상태 업데이트 (GSI1SK 포함)

- scripts/migrate-gsi1sk.sh: 기존 데이터 마이그레이션 스크립트
- 37개 기존 방 마이그레이션 완료

* fix: increase stats query limit to 100 days

- Adjust maximum allowable limit for recent stats query from 30 to 100 days to support extended data range responses.

* feat: improve game round and connection management logic

- Added handling for game round timeout (`ROUND_TIMEOUT`) in WebSocketMessageHandler.
- Enhanced game start broadcast to include `currentWord` for the drawer only.
- Updated ConnectionRepository to remove duplicate user connections in the same room.
- Added `currentWordEnglish` to GameSession for better answer verification.
- Normalized ChatRoom levels to match database storage format.
- Updated template.yaml to include DynamoDBReadPolicy for VocabTable.

* refactor: 코드 정리 및 미사용 클래스 제거 (#459)

* refactor: remove unused WebSocketResponseUtil

* refactor: add AutoCloseable to WebSocketBroadcaster

* refactor: remove unused TestService

* refactor: remove unused WordService

* refactor: remove unused DailyStudyService

* refactor: remove unused UserWordService

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* fix: resolve N+1 query in StatsService

* refactor(all): DI 패턴 및 전략 패턴 적용 (#461)

- Repository, Service, Handler에 DI 생성자 추가 (테스트 용이성)
- BadgeService에 Strategy 패턴 적용 (뱃지 조건 검증 로직 분리)

* refactor: relocate and restructure seed data files

- Moved `question-homes.json` and `words.json` from subdirectories to `seed` folder.
- Updated file paths for better organization and clarity.

* chore: seed 데이터 폴더 구조 정리

* feat: add CI/CD pipeline configuration for CodePipeline

* fix: add SNS topic policy and DependsOn for notification rule

* fix: correct paths in buildspec.yml for CodeBuild

* fix: remove hardcoded JAVA_HOME, use runtime default

* fix: add gradle wrapper for CI/CD build

* fix: use single line sam package command with hardcoded bucket

* fix: use existing stack name group2-englishstudy-chatting

* fix: add missing WEBSOCKET_ENDPOINT env var to WebSocket connect functions

* docs: update FRONTEND-API-GUIDE with new RoomType/RoomStatus structure

* feat : WebSocket Connect, Disconnect 핸들러 & SpeakingConnecion 모델 구현

* feat : WebSocket 메시지 처리 handler, service 구현

* feat : WebSocket 연결 정보 Repository 구현

* fix: update WebSocketDisconnectHandler to use GameSession model

- Remove references to deleted ChatRoom game fields
- Use GameSessionRepository to finish active game sessions
- Use ChatRoomRepository.updateStatus() for room state management

* perf: optimize CI/CD build time

- Add pip cache for SAM CLI dependencies
- Enable Gradle parallel builds and build cache
- Add SAM build cache (.aws-sam)
- Use sam build --parallel --cached
- Skip SAM CLI install if already cached
- Remove unnecessary 'clean' to leverage cache

* feat: add custom CodeBuild Docker image with pre-installed tools

- Dockerfile with Java 21 + SAM CLI + Gradle pre-installed
- build-and-push.sh script for ECR deployment
- Updated buildspec.yml for custom image (removes SAM CLI install)
- Expected build time reduction: ~30-40 seconds

* feature : AI 영어 회화 연습 기능 (#468)

* feat : WebSocket Connect, Disconnect 핸들러 & SpeakingConnecion 모델 구현

* feat : WebSocket 메시지 처리 handler, service 구현

* feat : WebSocket 연결 정보 Repository 구현

* fix: remove typo in SpeakingConnectionRepository

* fix : 오타 수정

* chore: trigger build test with custom Docker image

* chore: remove unnecessary newlines and whitespace across WebSocket handlers and related classes

* chore: remove unnecessary newlines and whitespace across WebSocket handlers and related classes

* refactor : websocket -> rest api 전환

* feat : speaking handler REST로 교체

* feat : speaking 관련 dto 생성

* refacotor : 기존 service 코드 로직 재사용 및 repository 리펙토링

* fix: add CORS headers to API Gateway error responses (#479)

API Gateway의 인증 실패 등 에러 응답에 CORS 헤더가 누락되어
CloudFront를 통한 프론트엔드 요청이 차단되는 문제 수정

- UNAUTHORIZED (401) 응답에 CORS 헤더 추가
- ACCESS_DENIED (403) 응답에 CORS 헤더 추가
- DEFAULT_4XX/5XX 응답에 CORS 헤더 추가
- EXPIRED_TOKEN 응답에 CORS 헤더 추가

* feat : speaking rest API 람다 함수 추가

---------

Co-authored-by: ddingjoo <ddingsha9@teambind.co.kr>

* refactor : speaking service 재사용

* refactor : AI 영어 회화 연습 코드 리팩토링

* feature : test 벡엔드 서버에 AI 말하기 연습 기능 배포 (#492)

* feat : WebSocket Connect, Disconnect 핸들러 & SpeakingConnecion 모델 구현

* feat : WebSocket 메시지 처리 handler, service 구현

* feat : WebSocket 연결 정보 Repository 구현

* fix : 오타 수정

* refactor : websocket -> rest api 전환

* feat : speaking handler REST로 교체

* feat : speaking 관련 dto 생성

* refacotor : 기존 service 코드 로직 재사용 및 repository 리펙토링

* feat : speaking rest API 람다 함수 추가

* refactor : speaking service 재사용

* refactor : AI 영어 회화 연습 코드 리팩토링

---------

Co-authored-by: DDING JOO <ddingsha9@teambind.co.kr>

* feat : handleChat 메서드 JsonNull 체크 푸가

* feature : handleChat 메서드 JsonNull 체크 추가 (#493)

* feat : WebSocket Connect, Disconnect 핸들러 & SpeakingConnecion 모델 구현

* feat : WebSocket 메시지 처리 handler, service 구현

* feat : WebSocket 연결 정보 Repository 구현

* fix : 오타 수정

* refactor : websocket -> rest api 전환

* feat : speaking handler REST로 교체

* feat : speaking 관련 dto 생성

* refacotor : 기존 service 코드 로직 재사용 및 repository 리펙토링

* feat : speaking rest API 람다 함수 추가

* refactor : speaking service 재사용

* refactor : AI 영어 회화 연습 코드 리팩토링

* feat : handleChat 메서드 JsonNull 체크 푸가

---------

Co-authored-by: DDING JOO <ddingsha9@teambind.co.kr>

* feat(news): 뉴스 학습 배지 시스템 구현 (#473)

- 14개 뉴스 관련 배지 추가 (읽기, 퀴즈, 단어수집, 연속학습, 마스터)
- UserStats에 뉴스 통계 필드 추가
- 6개 뉴스 배지 Strategy 클래스 생성
- 뉴스 읽기/퀴즈/단어수집 시 통계 업데이트 및 배지 체크 연동

* fix: add PATCH method to CORS AllowMethods

* test: BadgeType 개수 테스트 수정 (15 -> 29)

* fix: CORS PATCH 메서드 추가

* docs: 뉴스 기능 프론트엔드 연동 가이드 작성

* fix: NewsCollectionFunction에 Bedrock, Comprehend 권한 추가

* fix: add null check for collectWord request body

- Add INVALID_REQUEST error code to NewsErrorCode
- Check body and word field before accessing in collectWord()
- Prevents NullPointerException when request body is malformed

* feat: enhance stats API and bookmark response for frontend

- Add DAILY stats update for news read/quiz/word collection
- Add /stats/dashboard endpoint with frontend-requested format
  - today: wordsLearned, newsRead, quizzesTaken, wordsTotal
  - overall: totalWordsLearned, totalNewsRead, averageAccuracy, streaks
  - weeklyProgress: last 7 days with date/wordsLearned/newsRead
- Add news-related fields to all stats API responses
- Fix bookmark API to include full article details (title, summary, etc.)

* feat: add category classification to news AI analysis

- Add category field to AnalysisResult record
- Update Bedrock prompt to classify articles into categories
  (WORLD, POLITICS, BUSINESS, TECH, SCIENCE, HEALTH, SPORTS, ENTERTAINMENT, LIFESTYLE)
- Parse and set category from AI response
- Set GSI2 (CATEGORY#) index when category is available

* fix: add /stats/dashboard endpoint to template.yaml

* fix: filter by ARTICLE# prefix in findById to avoid returning UserNewsRecord

* docs: add News API troubleshooting guide

* feat: add Cognito authorizer to News API and enhance keyword extraction

- Set CognitoAuthorizer for all News API endpoints in template.yaml
- Update Bedrock AI to extract keywords with meanings and examples
- Add fallback to Comprehend for keyword extraction when Bedrock fails
- Modify KeywordInfo model to include example field
- Adjust AI prompt to include keyword extraction with examples
- Update AnalysisResult to store keywords and parse them from AI response

* Revert "Merge branch 'test' into prod"

This reverts commit c1a958eac6799d5838a76e4078ae304bcdb62278, reversing
changes made to a6662e0cfc46c6e12f20a89f0df285ff282160bc.

* feat: enhance bookmark and reading status tracking for News API

- Add bookmark and reading status to individual article responses
- Include bookmark status in paginated news responses
- Modify `KeywordInfo` to support Korean translations (`meaningKo`)
- Update AI prompts to extract Korean meanings for keywords

* refactor : session_id가 null 체크 추가

* feat : template 환경변수 리펙토링

* fix : sessionId NullPointerException 에러 수정  (#496)

* feat : WebSocket Connect, Disconnect 핸들러 & SpeakingConnecion 모델 구현

* feat : WebSocket 메시지 처리 handler, service 구현

* feat : WebSocket 연결 정보 Repository 구현

* fix : 오타 수정

* refactor : websocket -> rest api 전환

* feat : speaking handler REST로 교체

* feat : speaking 관련 dto 생성

* refacotor : 기존 service 코드 로직 재사용 및 repository 리펙토링

* feat : speaking rest API 람다 함수 추가

* refactor : speaking service 재사용

* refactor : AI 영어 회화 연습 코드 리팩토링

* feat : handleChat 메서드 JsonNull 체크 푸가

* refactor : session_id가 null 체크 추가

* feat : template 환경변수 리펙토링

---------

Co-authored-by: DDING JOO <ddingsha9@teambind.co.kr>

* feat: enhance bookmark and reading status tracking for News API

- Add bookmark and reading status to individual article responses
- Include bookmark status in paginated news responses
- Modify `KeywordInfo` to support Korean translations (`meaningKo`)
- Update AI prompts to extract Korean meanings for keywords

* feat: add category filtering to UserWord API with enhanced query logic

- Introduce `category` filtering to `getUserWords` API
- Update WordCategory enums to include "news" category
- Apply category filter after enrichment with word info
- Adjust query limits for bookmarked and incorrect words queries

* feat: add default value for ExistingCognitoClientId in template.yaml

- Set default to an empty string to ensure compatibility with templates using this parameter without explicitly specifying a value.

* fix: SpeakingHandler getStringOrNull 컴파일 에러 수정

* fix: SpeakingHandler getStringOrNull 컴파일 에러 수정

* fix: Bedrock 키워드(meaningKo 포함)를 article에 저장하도록 수정

* fix: Bedrock 키워드(meaningKo 포함)를 article에 저장하도록 수정

* fix: Bedrock 키워드(meaningKo 포함)를 article에 저장하도록 수정

* feat: add dashboard stats API and enhance news stats tracking

- Introduce `/stats/dashboard` API for retrieving integrated user stats (today, overall, weekly progress, and level distribution)
- Update `UserStats` model to include additional fields for news stats (newsRead, newsQuizCompleted, newsQuizPerfect, newsWordsCollected, etc.)
- Add atomic updates to track news reading, quiz, and word stats in `UserStatsRepository`
- Modify CloudFormation `template.yaml` to register the new `/stats/dashboard` endpoint

* feat: add dashboard stats API and enhance news stats tracking

- Introduce `/stats/dashboard` API for retrieving integrated user stats (today, overall, weekly progress, and level distribution)
- Update `UserStats` model to include additional fields for news stats (newsRead, newsQuizCompleted, newsQuizPerfect, newsWordsCollected, etc.)
- Add atomic updates to track news reading, quiz, and word stats in `UserStatsRepository`
- Modify CloudFormation `template.yaml` to register the new `/stats/dashboard` endpoint

* feat: add dashboard stats API and enhance news stats tracking

- Introduce `/stats/dashboard` API for retrieving integrated user stats (today, overall, weekly progress, and level distribution)
- Update `UserStats` model to include additional fields for news stats (newsRead, newsQuizCompleted, newsQuizPerfect, newsWordsCollected, etc.)
- Add atomic updates to track news reading, quiz, and word stats in `UserStatsRepository`
- Modify CloudFormation `template.yaml` to register the new `/stats/dashboard` endpoint

* refactor: format code with consistent indentation and spacing

- Apply consistent formatting to improve code readability across multiple files
- Adjust indentation, spacing, and alignment in model classes, DTOs, and repository methods

* fix: filter by ARTICLE# prefix in findById to avoid returning bookmark records

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* feat : Speaking 관련 template 람다 함수 및 테이블 추가

---------

Co-authored-by: DDING JOO <ddingsha9@teambind.co.kr>
Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>

* feature : Speaking Table & Function template.yaml 파일에 추가 (#513)

* fix: BadgeRepository 클라이언트 초기화 패턴 통일

- 개별 DynamoDbEnhancedClient 생성 대신 AwsClients.dynamoDbEnhanced() 싱글톤 사용
- 다른 Repository들과 동일한 패턴 적용
- 불필요한 import 제거

Closes #396

* feat: EnvConfig 유틸리티 추가 및 환경 변수 검증 적용

환경 변수 미설정 시 명확한 에러 메시지를 제공하는 EnvConfig 유틸리티를 추가하고,
기존 System.getenv 호출을 EnvConfig.getRequired/getOrDefault로 대체함.

- EnvConfig: getRequired, getOrDefault, getIntOrDefault, getLongOrDefault 메서드 제공
- Lambda Cold Start 시점에 환경 변수 누락을 조기 감지
- 기존 Config 클래스(WebSocketConfig, RoomTokenConfig) EnvConfig 사용으로 통일

Closes #403

* refactor: TestService submitTest 메서드 책임 분리

submitTest 메서드를 단일 책임 원칙에 맞게 리팩토링:
- gradeAnswers(): 답안 채점 및 결과 집계
- isAnswerCorrect(): 단일 답안 정답 여부 판단
- buildResultItem(): 결과 항목 생성
- saveTestResult(): 테스트 결과 저장
- GradingResult record: 채점 결과 캡슐화

TestService와 TestCommandService 모두 동일하게 적용

Closes #404

* refactor: 하드코딩된 설정값 환경 변수로 외부화

각 도메인별 Config 클래스를 생성하여 하드코딩된 값들을 환경 변수로 설정 가능하게 변경.
기본값이 있어 환경 변수 미설정 시에도 기존 동작 유지.

## 새로 추가된 Config 클래스
- GrammarConfig: SESSION_TTL_DAYS, MAX_HISTORY_MESSAGES, MAX_TOKENS 등
- GameConfig: TOTAL_ROUNDS, ROUND_TIME_LIMIT, QUICK_GUESS_THRESHOLD_MS
- VocabularyConfig: NEW_WORDS_COUNT, REVIEW_WORDS_COUNT, 상태 전이 임계값 등

## 지원하는 환경 변수
- GRAMMAR_SESSION_TTL_DAYS, GRAMMAR_MAX_HISTORY_MESSAGES, GRAMMAR_MAX_TOKENS
- GAME_TOTAL_ROUNDS, GAME_ROUND_TIME_LIMIT, GAME_QUICK_GUESS_THRESHOLD_MS
- VOCAB_NEW_WORDS_COUNT, VOCAB_REVIEW_WORDS_COUNT
- VOCAB_TRANSITION_TO_REVIEWING, VOCAB_TRANSITION_TO_MASTERED

Closes #406

* test: StudyLevel enum 단위 테스트 추가

* test: Difficulty enum 단위 테스트 추가

* test: StudyConfig 단위 테스트 추가

* test: EnvConfig 단위 테스트 추가

* test: PaginatedResult 단위 테스트 추가

* test: JsonUtil 단위 테스트 추가

* test: CursorUtil 단위 테스트 추가

* test: CommonErrorCode 단위 테스트 추가

* test: CommonException 단위 테스트 추가

* test: BadgeType enum 단위 테스트 추가

* test: BadgeKey 상수 단위 테스트 추가

* test: WordStatus enum 단위 테스트 추가

* test: TestType enum 단위 테스트 추가

* test: VocabularyConfig 단위 테스트 추가

* test: VocabKey 상수 단위 테스트 추가

* test: VocabularyErrorCode 단위 테스트 추가

* test: VocabularyException 단위 테스트 추가

* test: SpacedRepetitionContext 단위 테스트 추가

* test: GrammarLevel enum 단위 테스트 추가

* test: GrammarConfig 단위 테스트 추가

* test: GrammarErrorCode 단위 테스트 추가

* test: GrammarException 단위 테스트 추가

* test: GameStatus enum 단위 테스트 추가

* test: GameConfig 단위 테스트 추가

* test: ChattingErrorCode 단위 테스트 추가

* test: ChattingException 단위 테스트 추가

* fix: OPIc FeedbackResponse.java 문법 오류 수정

* style: AwsClients 코드 포맷팅

* style: EnvConfig 코드 포맷팅

* style: RoomTokenConfig 코드 포맷팅

* style: WebSocketConfig 코드 포맷팅

* style: JsonUtil 코드 포맷팅

* style: GameConfig 코드 포맷팅

* style: GrammarConfig 코드 포맷팅

* style: GrammarKey 코드 포맷팅

* style: GrammarErrorCode 코드 포맷팅

* style: GrammarException 코드 포맷팅

* style: BedrockGrammarCheckFactory 코드 포맷팅

* style: GrammarConversationService 코드 포맷팅

* style: FeedbackResponse 코드 포맷팅

* style: SessionReportResponse 코드 포맷팅

* style: SpeakingError 코드 포맷팅

* style: SpeakingErrorType 코드 포맷팅

* style: OPIcException 코드 포맷팅

* style: OPIcAnswer 코드 포맷팅

* style: OPIcQuestion 코드 포맷팅

* style: OPIcSession 코드 포맷팅

* style: OPIcRepository 코드 포맷팅

* style: FeedbackService 코드 포맷팅

* style: TranscribeProxyService 코드 포맷팅

* style: VocabularyConfig 코드 포맷팅

* style: DailyStudyCommandService 코드 포맷팅

* style: TestCommandService 코드 포맷팅

* style: TestService 코드 포맷팅

* style: CommonErrorCodeSpec 코드 포맷팅

* style: JsonUtilSpec 코드 포맷팅

* style: BadgeTypeSpec 코드 포맷팅

* style: ChattingErrorCodeSpec 코드 포맷팅

* style: GrammarLevelSpec 코드 포맷팅

* style: GrammarErrorCodeSpec 코드 포맷팅

* style: VocabularyErrorCodeSpec 코드 포맷팅

* feature : OPIc 세션관리 + 답변 처리 파이프라인 구현  (#413)

* feat : OPIc 질문 & 세션 관련 dto 생성

* refactor : @DynamoDbBean 주석 추가

* feat : 주제 + 소주제 + 레벨로 오픽 질문 조회 추가

* feat : OPIc 세션, 질문, 답변 종합 handler 구현

* feat : 오픽 주제, 소주제별 seed 데이터 추가

* refactor : Transcribe API KEY 환경변수명 수정

* refactor : Bedrock에 사용하는 클로드 모델 변경

* refactor : S3 Key 대신 Proxy에서 요청하는 Base64 값으로 변환

* feat: GAME_START, ROUND_END 메시지에 serverTime 추가

- broadcastGameStart(): serverTime, roundDuration 필드 추가
- broadcastRoundEnd(): serverTime, roundStartTime, roundDuration 필드 추가
- GameService.endRound(): data에 roundStartTime, roundDuration 포함
- 타이머 동기화 버그 수정을 위한 서버 시간 제공

* feat: WebSocketMessageHelper 유틸리티 클래스 추가

- domain 필드 포함 메시지 생성 헬퍼
- DOMAIN_CHAT, DOMAIN_GAME 상수 정의
- buildChatMessage(), buildGameMessage() 메서드

* feat: 모든 WebSocket 메시지에 domain 필드 추가

- ScoreUpdateMessage에 domain 필드 추가
- broadcastGameStart에 domain:"game" 추가
- broadcastRoundEnd에 domain:"game" 추가
- broadcastCorrectAnswerMessage에 domain:"game" 추가
- handleCommandResult 시스템 메시지에 domain:"game" 추가
- handleRegularMessage 채팅 메시지에 domain:"chat" 추가

Closes #426, #427

* feat: GameSession 모델 클래스 생성

- DynamoDB Enhanced Client 어노테이션 적용
- GSI1: roomId로 활성 게임 세션 조회 가능
- 게임 상태 관리용 헬퍼 메서드 포함

Closes #428

* feat: GameSessionRepository 구현

- 기본 CRUD (save, findById, delete)
- roomId로 활성/전체 게임 세션 조회
- 상태, 라운드, 점수 업데이트 메서드
- 정답자 추가, 힌트 사용, 게임 종료 처리

Closes #429

* refactor: ChatRoom에서 게임 필드 분리

- 게임 관련 필드 제거 (gameStatus, currentRound 등)
- activeGameSessionId 필드 추가
- 게임 상태는 GameSession으로 분리됨

Note: 의존 코드 수정은 #431에서 진행

Closes #430

* refactor: GameSession 기반으로 전체 게임 로직 리팩토링

- GameService: ChatRoom 대신 GameSession 사용
- GameStatsService: GameSession 매개변수로 변경
- CommandService: GameSession 기반 점수 조회
- GameHandler: GameSession 기반 REST API
- WebSocketMessageHandler: GameSession 기반 브로드캐스트
- GameStatusResponse, ScoreboardResponse: GameSession 매개변수

Closes #431

* feat: GameSessionHandler Lambda 및 게임 세션 API 구현

- POST /rooms/{roomId}/games - 게임 세션 생성
- GET /games/{gameSessionId} - 게임 상태 조회 (재접속용)
- POST /games/{gameSessionId}/start - 게임 시작
- POST /games/{gameSessionId}/stop - 게임 종료

모든 응답에 serverTime 포함 (타이머 동기화)
출제자에게만 currentWord 포함

Closes #432, #433

* feat: 게임 시작 7분 후 자동 종료 기능 구현

- GameConfig에 gameTimeLimit() 메서드 추가 (기본값: 420초)
- GameSchedulerClient 유틸리티 클래스 생성 (EventBridge Scheduler 연동)
- GameService에 스케줄 생성/취소 로직 추가
- GameAutoCloseHandler Lambda 함수 생성
- template.yaml에 Lambda, IAM Role, Schedule Group 추가

Closes #417

* fix : 메모리 증가 및 Lambda 응답 제한 시간 Cognito 트리거 제한시간과 동일하게 수정 (#439)

* feat: 캐치마인드 게임 방 분리 기능 구현 (#455)

- Room 타입 분리 (CHAT/GAME)
  - RoomType, RoomStatus enum 추가
  - ChatRoom 모델에 type, gameType, gameSettings, status, hostId 필드 추가
  - GameSettings 모델 추가

- 방 생성/조회 API 수정
  - CreateRoomRequest에 type, gameType, gameSettings 필드 추가
  - 방 목록 조회 시 type, gameType, status 필터 지원

- 게임 시작 조건 검증
  - GAME 타입 방에서만 게임 시작 가능 (GAME_007 에러)

- 게임 재시작 API 구현 (#452)
  - POST /rooms/{roomId}/game/restart 엔드포인트 추가
  - 방장만 재시작 가능 (GAME_009 에러)
  - 게임 진행 중 재시작 불가 (GAME_008 에러)

- 방장 변경 로직 구현 (#453)
  - 방장 퇴장 시 다음 멤버에게 자동 이전
  - 모든 멤버 퇴장 시 방 자동 삭제

- WebSocket 메시지 타입 추가 (#454)
  - ROOM_STATUS_CHANGE, HOST_CHANGE 메시지 타입 추가
  - WebSocketMessageHelper에 빌더 메서드 추가

- 테스트 추가
  - RoomType, RoomStatus enum 테스트
  - GameSettings 모델 테스트
  - ChattingErrorCode 테스트 업데이트

Related: #440, #441, #442, #443, #444, #445, #446
Closes: #447, #448, #449, #450, #451, #452, #453, #454

* feat: 참가자 닉네임 및 방장 변경 WebSocket 알림 구현 (#456)

- RoomParticipant DTO 추가 (userId, nickname, isHost)
- ChatRoomQueryService에 닉네임 조회 메서드 추가
  - getParticipantsWithNicknames(): 참가자 목록 + 닉네임
  - getHostNickname(): 방장 닉네임 조회
- ChatRoomHandler.getRoom() 응답에 participants, hostNickname 추가
- ChatRoomCommandService.leaveRoom()에서 방장 변경 시 WebSocket 브로드캐스트

Related: #440

* fix: ChatRoomFunction에 UserTable DynamoDB 권한 추가

- 참가자/방장 닉네임 조회를 위한 UserTable 읽기 권한 추가
- DynamoDBReadPolicy로 UserTable 접근 허용

Fixes #457

* fix: GameSettings에 @DynamoDbBean 어노테이션 추가

- DynamoDB Enhanced Client가 중첩 객체를 직렬화/역직렬화할 수 있도록 수정
- ChatRoom 저장/조회 시 GameSettings 변환 오류 해결

Fixes #457

* fix: ChatRoomFunction에 WEBSOCKET_ENDPOINT 환경변수 및 권한 추가

- leaveRoom에서 WebSocketBroadcaster 사용을 위한 환경변수 추가
- execute-api:ManageConnections 권한 추가

* fix: WebSocket Lambda 함수들에 WEBSOCKET_ENDPOINT 환경변수 추가

- WebSocketConnectFunction에 WEBSOCKET_ENDPOINT 추가
- WebSocketDisconnectFunction에 WEBSOCKET_ENDPOINT 추가
- execute-api:ManageConnections 권한 추가

* fix: Grammar WebSocket Lambda 환경 변수 및 권한 추가

- GrammarStreamingConnectFunction에 WEBSOCKET_ENDPOINT 환경 변수 추가
- GrammarStreamingDisconnectFunction에 WEBSOCKET_ENDPOINT 환경 변수 추가
- 두 함수에 execute-api:ManageConnections 권한 추가

* feat: GSI1SK 확장성 있는 재설계 및 DB 레벨 필터링

## 변경 사항

### GSI1SK 포맷 변경
- 기존: {level}#{createdAt}
- 신규: {type}#{gameType}#{status}#{level}#{createdAt}

### 지원 쿼리 패턴
- 전체 방: GSI1PK = "ROOMS"
- 게임방만: begins_with(GSI1SK, "GAME#")
- 캐치마인드만: begins_with(GSI1SK, "GAME#CATCHMIND#")
- 대기중 캐치마인드: begins_with(GSI1SK, "GAME#CATCHMIND#WAITING#")

### 파일 수정
- ChatRoomCommandService.java: 방 생성 시 새 GSI1SK 포맷 적용
- ChatRoomRepository.java: findByFilters() 메서드 추가, updateStatus() 메서드 추가
- ChatRoomQueryService.java: 메모리 필터링 제거, DB 레벨 필터링으로 변경
- GameService.java: 게임 시작/종료 시 방 상태 업데이트 (GSI1SK 포함)

### 마이그레이션
- scripts/migrate-gsi1sk.sh: 기존 데이터 마이그레이션 스크립트
- 37개 기존 방 마이그레이션 완료

* fix: increase stats query limit to 100 days

- Adjust maximum allowable limit for recent stats query from 30 to 100 days to support extended data range responses.

* feat: improve game round and connection management logic

- Added handling for game round timeout (`ROUND_TIMEOUT`) in WebSocketMessageHandler.
- Enhanced game start broadcast to include `currentWord` for the drawer only.
- Updated ConnectionRepository to remove duplicate user connections in the same room.
- Added `currentWordEnglish` to GameSession for better answer verification.
- Normalized ChatRoom levels to match database storage format.
- Updated template.yaml to include DynamoDBReadPolicy for VocabTable.

* refactor: 코드 정리 및 미사용 클래스 제거 (#459)

* refactor: remove unused WebSocketResponseUtil

* refactor: add AutoCloseable to WebSocketBroadcaster

* refactor: remove unused TestService

* refactor: remove unused WordService

* refactor: remove unused DailyStudyService

* refactor: remove unused UserWordService

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* fix: resolve N+1 query in StatsService

* refactor(all): DI 패턴 및 전략 패턴 적용 (#461)

- Repository, Service, Handler에 DI 생성자 추가 (테스트 용이성)
- BadgeService에 Strategy 패턴 적용 (뱃지 조건 검증 로직 분리)

* refactor: relocate and restructure seed data files

- Moved `question-homes.json` and `words.json` from subdirectories to `seed` folder.
- Updated file paths for better organization and clarity.

* chore: seed 데이터 폴더 구조 정리

* feat: add CI/CD pipeline configuration for CodePipeline

* fix: add SNS topic policy and DependsOn for notification rule

* fix: correct paths in buildspec.yml for CodeBuild

* fix: remove hardcoded JAVA_HOME, use runtime default

* fix: add gradle wrapper for CI/CD build

* fix: use single line sam package command with hardcoded bucket

* fix: use existing stack name group2-englishstudy-chatting

* fix: add missing WEBSOCKET_ENDPOINT env var to WebSocket connect functions

* docs: update FRONTEND-API-GUIDE with new RoomType/RoomStatus structure

* feat : WebSocket Connect, Disconnect 핸들러 & SpeakingConnecion 모델 구현

* feat : WebSocket 메시지 처리 handler, service 구현

* feat : WebSocket 연결 정보 Repository 구현

* fix: update WebSocketDisconnectHandler to use GameSession model

- Remove references to deleted ChatRoom game fields
- Use GameSessionRepository to finish active game sessions
- Use ChatRoomRepository.updateStatus() for room state management

* perf: optimize CI/CD build time

- Add pip cache for SAM CLI dependencies
- Enable Gradle parallel builds and build cache
- Add SAM build cache (.aws-sam)
- Use sam build --parallel --cached
- Skip SAM CLI install if already cached
- Remove unnecessary 'clean' to leverage cache

* feat: add custom CodeBuild Docker image with pre-installed tools

- Dockerfile with Java 21 + SAM CLI + Gradle pre-installed
- build-and-push.sh script for ECR deployment
- Updated buildspec.yml for custom image (removes SAM CLI install)
- Expected build time reduction: ~30-40 seconds

* feature : AI 영어 회화 연습 기능 (#468)

* feat : WebSocket Connect, Disconnect 핸들러 & SpeakingConnecion 모델 구현

* feat : WebSocket 메시지 처리 handler, service 구현

* feat : WebSocket 연결 정보 Repository 구현

* fix: remove typo in SpeakingConnectionRepository

* fix : 오타 수정

* chore: trigger build test with custom Docker image

* chore: remove unnecessary newlines and whitespace across WebSocket handlers and related classes

* chore: remove unnecessary newlines and whitespace across WebSocket handlers and related classes

* Release: 캐치마인드 게임 분리, AI 회화 연습, CI/CD 파이프라인 (#469)

* feature : OPIc 세션관리 + 답변 처리 파이프라인 구현  (#413)

* feat : OPIc 질문 & 세션 관련 dto 생성

* refactor : @DynamoDbBean 주석 추가

* feat : 주제 + 소주제 + 레벨로 오픽 질문 조회 추가

* feat : OPIc 세션, 질문, 답변 종합 handler 구현

* feat : 오픽 주제, 소주제별 seed 데이터 추가

* refactor : Transcribe API KEY 환경변수명 수정

* refactor : Bedrock에 사용하는 클로드 모델 변경

* refactor : S3 Key 대신 Proxy에서 요청하는 Base64 값으로 변환

* feat: GAME_START, ROUND_END 메시지에 serverTime 추가

- broadcastGameStart(): serverTime, roundDuration 필드 추가
- broadcastRoundEnd(): serverTime, roundStartTime, roundDuration 필드 추가
- GameService.endRound(): data에 roundStartTime, roundDuration 포함
- 타이머 동기화 버그 수정을 위한 서버 시간 제공

* feat: WebSocketMessageHelper 유틸리티 클래스 추가

- domain 필드 포함 메시지 생성 헬퍼
- DOMAIN_CHAT, DOMAIN_GAME 상수 정의
- buildChatMessage(), buildGameMessage() 메서드

* feat: 모든 WebSocket 메시지에 domain 필드 추가

- ScoreUpdateMessage에 domain 필드 추가
- broadcastGameStart에 domain:"game" 추가
- broadcastRoundEnd에 domain:"game" 추가
- broadcastCorrectAnswerMessage에 domain:"game" 추가
- handleCommandResult 시스템 메시지에 domain:"game" 추가
- handleRegularMessage 채팅 메시지에 domain:"chat" 추가

Closes #426, #427

* feat: GameSession 모델 클래스 생성

- DynamoDB Enhanced Client 어노테이션 적용
- GSI1: roomId로 활성 게임 세션 조회 가능
- 게임 상태 관리용 헬퍼 메서드 포함

Closes #428

* feat: GameSessionRepository 구현

- 기본 CRUD (save, findById, delete)
- roomId로 활성/전체 게임 세션 조회
- 상태, 라운드, 점수 업데이트 메서드
- 정답자 추가, 힌트 사용, 게임 종료 처리

Closes #429

* refactor: ChatRoom에서 게임 필드 분리

- 게임 관련 필드 제거 (gameStatus, currentRound 등)
- activeGameSessionId 필드 추가
- 게임 상태는 GameSession으로 분리됨

Note: 의존 코드 수정은 #431에서 진행

Closes #430

* refactor: GameSession 기반으로 전체 게임 로직 리팩토링

- GameService: ChatRoom 대신 GameSession 사용
- GameStatsService: GameSession 매개변수로 변경
- CommandService: GameSession 기반 점수 조회
- GameHandler: GameSession 기반 REST API
- WebSocketMessageHandler: GameSession 기반 브로드캐스트
- GameStatusResponse, ScoreboardResponse: GameSession 매개변수

Closes #431

* feat: GameSessionHandler Lambda 및 게임 세션 API 구현

- POST /rooms/{roomId}/games - 게임 세션 생성
- GET /games/{gameSessionId} - 게임 상태 조회 (재접속용)
- POST /games/{gameSessionId}/start - 게임 시작
- POST /games/{gameSessionId}/stop - 게임 종료

모든 응답에 serverTime 포함 (타이머 동기화)
출제자에게만 currentWord 포함

Closes #432, #433

* feat: 게임 시작 7분 후 자동 종료 기능 구현

- GameConfig에 gameTimeLimit() 메서드 추가 (기본값: 420초)
- GameSchedulerClient 유틸리티 클래스 생성 (EventBridge Scheduler 연동)
- GameService에 스케줄 생성/취소 로직 추가
- GameAutoCloseHandler Lambda 함수 생성
- template.yaml에 Lambda, IAM Role, Schedule Group 추가

Closes #417

* fix : 메모리 증가 및 Lambda 응답 제한 시간 Cognito 트리거 제한시간과 동일하게 수정 (#439)

* feat: 캐치마인드 게임 방 분리 기능 구현 (#455)

- Room 타입 분리 (CHAT/GAME)
  - RoomType, RoomStatus enum 추가
  - ChatRoom 모델에 type, gameType, gameSettings, status, hostId 필드 추가
  - GameSettings 모델 추가

- 방 생성/조회 API 수정
  - CreateRoomRequest에 type, gameType, gameSettings 필드 추가
  - 방 목록 조회 시 type, gameType, status 필터 지원

- 게임 시작 조건 검증
  - GAME 타입 방에서만 게임 시작 가능 (GAME_007 에러)

- 게임 재시작 API 구현 (#452)
  - POST /rooms/{roomId}/game/restart 엔드포인트 추가
  - 방장만 재시작 가능 (GAME_009 에러)
  - 게임 진행 중 재시작 불가 (GAME_008 에러)

- 방장 변경 로직 구현 (#453)
  - 방장 퇴장 시 다음 멤버에게 자동 이전
  - 모든 멤버 퇴장 시 방 자동 삭제

- WebSocket 메시지 타입 추가 (#454)
  - ROOM_STATUS_CHANGE, HOST_CHANGE 메시지 타입 추가
  - WebSocketMessageHelper에 빌더 메서드 추가

- 테스트 추가
  - RoomType, RoomStatus enum 테스트
  - GameSettings 모델 테스트
  - ChattingErrorCode 테스트 업데이트

Related: #440, #441, #442, #443, #444, #445, #446
Closes: #447, #448, #449, #450, #451, #452, #453, #454

* feat: 참가자 닉네임 및 방장 변경 WebSocket 알림 구현 (#456)

- RoomParticipant DTO 추가 (userId, nickname, isHost)
- ChatRoomQueryService에 닉네임 조회 메서드 추가
  - getParticipantsWithNicknames(): 참가자 목록 + 닉네임
  - getHostNickname(): 방장 닉네임 조회
- ChatRoomHandler.getRoom() 응답에 participants, hostNickname 추가
- ChatRoomCommandService.leaveRoom()에서 방장 변경 시 WebSocket 브로드캐스트

Related: #440

* fix: ChatRoomFunction에 UserTable DynamoDB 권한 추가

- 참가자/방장 닉네임 조회를 위한 UserTable 읽기 권한 추가
- DynamoDBReadPolicy로 UserTable 접근 허용

Fixes #457

* fix: GameSettings에 @DynamoDbBean 어노테이션 추가

- DynamoDB Enhanced Client가 중첩 객체를 직렬화/역직렬화할 수 있도록 수정
- ChatRoom 저장/조회 시 GameSettings 변환 오류 해결

Fixes #457

* fix: ChatRoomFunction에 WEBSOCKET_ENDPOINT 환경변수 및 권한 추가

- leaveRoom에서 WebSocketBroadcaster 사용을 위한 환경변수 추가
- execute-api:ManageConnections 권한 추가

* fix: WebSocket Lambda 함수들에 WEBSOCKET_ENDPOINT 환경변수 추가

- WebSocketConnectFunction에 WEBSOCKET_ENDPOINT 추가
- WebSocketDisconnectFunction에 WEBSOCKET_ENDPOINT 추가
- execute-api:ManageConnections 권한 추가

* fix: Grammar WebSocket Lambda 환경 변수 및 권한 추가

- GrammarStreamingConnectFunction에 WEBSOCKET_ENDPOINT 환경 변수 추가
- GrammarStreamingDisconnectFunction에 WEBSOCKET_ENDPOINT 환경 변수 추가
- 두 함수에 execute-api:ManageConnections 권한 추가

* feat: GSI1SK 확장성 있는 재설계 및 DB 레벨 필터링

## 변경 사항

### GSI1SK 포맷 변경
- 기존: {level}#{createdAt}
- 신규: {type}#{gameType}#{status}#{level}#{createdAt}

### 지원 쿼리 패턴
- 전체 방: GSI1PK = "ROOMS"
- 게임방만: begins_with(GSI1SK, "GAME#")
- 캐치마인드만: begins_with(GSI1SK, "GAME#CATCHMIND#")
- 대기중 캐치마인드: begins_with(GSI1SK, "GAME#CATCHMIND#WAITING#")

### 파일 수정
- ChatRoomCommandService.java: 방 생성 시 새 GSI1SK 포맷 적용
- ChatRoomRepository.java: findByFilters() 메서드 추가, updateStatus() 메서드 추가
- ChatRoomQueryService.java: 메모리 필터링 제거, DB 레벨 필터링으로 변경
- GameService.java: 게임 시작/종료 시 방 상태 업데이트 (GSI1SK 포함)

### 마이그레이션
- scripts/migrate-gsi1sk.sh: 기존 데이터 마이그레이션 스크립트
- 37개 기존 방 마이그레이션 완료

* fix: increase stats query limit to 100 days

- Adjust maximum allowable limit for recent stats query from 30 to 100 days to support extended data range responses.

* feat: improve game round and connection management logic

- Added handling for game round timeout (`ROUND_TIMEOUT`) in WebSocketMessageHandler.
- Enhanced game start broadcast to include `currentWord` for the drawer only.
- Updated ConnectionRepository to remove duplicate user connections in the same room.
- Added `currentWordEnglish` to GameSession for better answer verification.
- Normalized ChatRoom levels to match database storage format.
- Updated template.yaml to include DynamoDBReadPolicy for VocabTable.

* refactor: 코드 정리 및 미사용 클래스 제거 (#459)

* refactor: remove unused WebSocketResponseUtil

* refactor: add AutoCloseable to WebSocketBroadcaster

* refactor: remove unused TestService

* refactor: remove unused WordService

* refactor: remove unused DailyStudyService

* refactor: remove unused UserWordService

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* fix: resolve N+1 query in StatsService

* refactor(all): DI 패턴 및 전략 패턴 적용 (#461)

- Repository, Service, Handler에 DI 생성자 추가 (테스트 용이성)
- BadgeService에 Strategy 패턴 적용 (뱃지 조건 검증 로직 분리)

* refactor: relocate and restructure seed data files

- Moved `question-homes.json` and `words.json` from subdirectories to `seed` folder.
- Updated file paths for better organization and clarity.

* chore: seed 데이터 폴더 구조 정리

* feat: add CI/CD pipeline configuration for CodePipeline

* fix: add SNS topic policy and DependsOn for notification rule

* fix: correct paths in buildspec.yml for CodeBuild

* fix: remove hardcoded JAVA_HOME, use runtime default

* fix: add gradle wrapper for CI/CD build

* fix: use single line sam package command with hardcoded bucket

* fix: use existing stack name group2-englishstudy-chatting

* fix: add missing WEBSOCKET_ENDPOINT env var to WebSocket connect functions

* docs: update FRONTEND-API-GUIDE with new RoomType/RoomStatus structure

* fix: update WebSocketDisconnectHandler to use GameSession model

- Remove references to deleted ChatRoom game fields
- Use GameSessionRepository to finish active game sessions
- Use ChatRoomRepository.updateStatus() for room state management

* perf: optimize CI/CD build time

- Add pip cache for SAM CLI dependencies
- Enable Gradle parallel builds and build cache
- Add SAM build cache (.aws-sam)
- Use sam build --parallel --cached
- Skip SAM CLI install if already cached
- Remove unnecessary 'clean' to leverage cache

* feat: add custom CodeBuild Docker image with pre-installed tools

- Dockerfile with Java 21 + SAM CLI + Gradle pre-installed
- build-and-push.sh script for ECR deployment
- Updated buildspec.yml for custom image (removes SAM CLI install)
- Expected build time reduction: ~30-40 seconds

* feature : AI 영어 회화 연습 기능 (#468)

* feat : WebSocket Connect, Disconnect 핸들러 & SpeakingConnecion 모델 구현

* feat : WebSocket 메시지 처리 handler, service 구현

* feat : WebSocket 연결 정보 Repository 구현

* fix: remove typo in SpeakingConnectionRepository

* chore: trigger build test with custom Docker image

* chore: remove unnecessary newlines and whitespace across WebSocket handlers and related classes

* chore: remove unnecessary newlines and whitespace across WebSocket handlers and related classes

---------

Co-authored-by: hyein Heo <128613248+hye-inA@users.noreply.github.com>

* refactor : websocket -> rest api 전환

* feat : speaking handler REST로 교체

* feat : speaking 관련 dto 생성

* refacotor : 기존 service 코드 로직 재사용 및 repository 리펙토링

* fix: add CORS headers to API Gateway error responses (#479)

API Gateway의 인증 실패 등 에러 응답에 CORS 헤더가 누락되어
CloudFront를 통한 프론트엔드 요청이 차단되는 문제 수정

- UNAUTHORIZED (401) 응답에 CORS 헤더 추가
- ACCESS_DENIED (403) 응답에 CORS 헤더 추가
- DEFAULT_4XX/5XX 응답에 CORS 헤더 추가
- EXPIRED_TOKEN 응답에 CORS 헤더 추가

* feat(news): 뉴스 도메인 기반 구조 구축 (#385)

- NewsCategory, QuizType enum 추가
- NewsKey 상수 클래스 추가
- NewsErrorCode 예외 클래스 추가
- NewsArticle, KeywordInfo, QuizQuestion 모델 추가
- NewsArticleRepository CRUD 구현
- NewsTable DynamoDB 테이블 정의
- CORS GatewayResponses 설정 추가

* feat(news): 뉴스 수집 파이프라인 구현 (#386)

- NewsApiClient: NewsAPI 연동 서비스
- RssFeedParser: RSS 피드 파싱 (BBC, VOA, NPR)
- NewsDuplicateChecker: URL 기반 중복 필터링
- NewsCollectorService: 수집 오케스트레이션
- NewsCollectionHandler: Lambda 핸들러
- EventBridge 스케줄러: 매일 18시 KST 실행

* refactor(news): NewsAPI 제거, RSS만 사용

- NewsApiClient 삭제
- SSM Parameter 의존성 제거
- RSS 소스당 7개씩 수집 (BBC, VOA, NPR = 약 21개/일)

* feat(news): AI 뉴스 분석 시스템 구현 (#387)

- NewsAnalysisService: AI 분석 통합 서비스
  - Bedrock: CEFR 난이도 분석 (A1~C2)
  - Bedrock: 3줄 요약 + 퀴즈 3문제 생성
  - Comprehend: 핵심 키워드 추출
- NewsCollectorService: 수집 시 자동 분석 연동
- GSI1/GSI2 키 자동 설정 (레벨별, 카테고리별 조회)

* feat(news): 뉴스 학습 API 구현 (#388)

- NewsQueryService: 뉴스 조회 서비스
- NewsHandler: API 핸들러
  - GET /news - 목록 조회 (level, category 필터)
  - GET /news/today - 오늘의 뉴스
  - GET /news/recommended - 내 레벨 맞춤 추천
  - GET /news/{articleId} - 상세 조회 (조회수 증가)
- template.yaml: NewsFunction Lambda 추가

* feat(news): 뉴스 학습 부가 기능 구현 (#389)

- 읽기 완료 기록 API (POST /news/{articleId}/read)
- 북마크 토글 API (POST /news/{articleId}/bookmark)
- 북마크 목록 조회 API (GET /news/bookmarks)
- 학습 통계 조회 API (GET /news/stats)
- TTS 오디오 URL 조회 API (GET /news/{articleId}/audio)
- UserNewsRecord 모델 추가
- UserNewsRepository 추가
- NewsLearningService 추가

* feat(news): 복합 퀴즈 시스템 구현 (#471)

- 퀴즈 조회 API (GET /news/{articleId}/quiz)
- 퀴즈 제출 API (POST /news/{articleId}/quiz)
- 퀴즈 기록 조회 API (GET /news/quiz/history)
- NewsQuizResult 모델 추가
- QuizAnswerResult 모델 추가
- NewsQuizRepository 추가
- NewsQuizService 추가

* feat(news): 단어 수집 & Vocabulary 연동 구현 (#472)

- 단어 수집 API (POST /news/{articleId}/words)
- 수집 단어 목록 API (GET /news/words)
- 단어 상세 조회 API (GET /news/{articleId}/words/{word})
- 단어 삭제 API (DELETE /news/{articleId}/words/{word})
- Vocabulary 연동 API (POST /news/words/{word}/sync)
- NewsWordCollect 모델 추가
- NewsWordRepository 추가
- NewsWordService 추가

* feat: add multi-environment deployment support (dev/test/prod)

* fix: update buildspec.yml to deploy prod environment with parameter overrides

* feat(news): 뉴스 도메인 기반 구조 구축 (#385)

- NewsCategory, QuizType enum 추가
- NewsKey 상수 클래스 추가
- NewsErrorCode 예외 클래스 추가
- NewsArticle, KeywordInfo, QuizQuestion 모델 추가
- NewsArticleRepository CRUD 구현
- NewsTable DynamoDB 테이블 정의
- CORS GatewayResponses 설정 추가

* feat(news): 뉴스 수집 파이프라인 구현 (#386)

- NewsApiClient: NewsAPI 연동 서비스
- RssFeedParser: RSS 피드 파싱 (BBC, VOA, NPR)
- NewsDuplicateChecker: URL 기반 중복 필터링
- NewsCollectorService: 수집 오케스트레이션
- NewsCollectionHandler: Lambda 핸들러
- EventBridge 스케줄러: 매일 18시 KST 실행

* refactor(news): NewsAPI 제거, RSS만 사용

- NewsApiClient 삭제
- SSM Parameter 의존성 제거
- RSS 소스당 7개씩 수집 (BBC, VOA, NPR = 약 21개/일)

* feat(news): AI 뉴스 분석 시스템 구현 (#387)

- NewsAnalysisService: AI 분석 통합 서비스
  - Bedrock: CEFR 난이도 분석 (A1~C2)
  - Bedrock: 3줄 요약 + 퀴즈 3문제 생성
  - Comprehend: 핵심 키워드 추출
- NewsCollectorService: 수집 시 자동 분석 연동
- GSI1/GSI2 키 자동 설정 (레벨별, 카테고리별 조회)

* feat(news): 뉴스 학습 API 구현 (#388)

- NewsQueryService: 뉴스 조회 서비스
- NewsHandler: API 핸들러
  - GET /news - 목록 조회 (level, category 필터)
  - GET /news/today - 오늘의 뉴스
  - GET /news/recommended - 내 레벨 맞춤 추천
  - GET /news/{articleId} - 상세 조회 (조회수 증가)
- template.yaml: NewsFunction Lambda 추가

* feat(news): 뉴스 학습 부가 기능 구현 (#389)

- 읽기 완료 기록 API (POST /news/{articleId}/read)
- 북마크 토글 API (POST /news/{articleId}/bookmark)
- 북마크 목록 조회 API (GET /news/bookmarks)
- 학습 통계 조회 API (GET /news/stats)
- TTS 오디오 URL 조회 API (GET /news/{articleId}/audio)
- UserNewsRecord 모델 추가
- UserNewsRepository 추가
- NewsLearningService 추가

* feat(news): 복합 퀴즈 시스템 구현 (#471)

- 퀴즈 조회 API (GET /news/{articleId}/quiz)
- 퀴즈 제출 API (POST /news/{articleId}/quiz)
- 퀴즈 기록 조회 API (GET /news/quiz/history)
- NewsQuizResult 모델 추가
- QuizAnswerResult 모델 추가
- NewsQuizRepository 추가
- NewsQuizService 추가

* feat(news): 단어 수집 & Vocabulary 연동 구현 (#472)

- 단어 수집 API (POST /news/{articleId}/words)
- 수집 단어 목록 API (GET /news/words)
- 단어 상세 조회 API (GET /news/{articleId}/words/{word})
- 단어 삭제 API (DELETE /news/{articleId}/words/{word})
- Vocabulary 연동 API (POST /news/words/{word}/sync)
- NewsWordCollect 모델 추가
- NewsWordRepository 추가
- NewsWordService 추가

* feat: add multi-environment deployment support (dev/test/prod)

* fix: update buildspec.yml to deploy prod environment with parameter overrides

* refactor : AI 말하기 Websocket 구현 -> REST API 구현으로 리팩토링 (#490)

* feat : WebSocket Connect, Disconnect 핸들러 & SpeakingConnecion 모델 구현

* feat : WebSocket 메시지 처리 handler, service 구현

* feat : WebSocket 연결 정보 Repository 구현

* fix : 오타 수정

* refactor : websocket -> rest api 전환

* feat : speaking handler REST로 교체

* feat : speaking 관련 dto 생성

* refacotor : 기존 service 코드 로직 재사용 및 repository 리펙토링

* fix: revert buildspec.yml to build-only for CloudFormation deploy stage

* fix: revert buildspec.yml to build-only for CloudFormation deploy stage

* fix: update all API Gateway StageName to use Environment parameter

* fix: correct VocabularyTable and ContentBucket references in NewsFunction

* fix: correct VocabularyTable and ContentBucket references in NewsFunction

* fix: add stack name prefix to GameScheduleGroup and daily-stats schedule to avoid conflicts

* fix: add stack name prefix to GameScheduleGroup and daily-stats schedule to avoid conflicts

* feat: add support for existing Cognito User Pool reuse across environments

* fix: add conditional Cognito ARN reference in API Gateway Authorizer

* fix: remove Cognito resources completely, use existing Cognito only

* fix: remove Cognito resources completely, use existing Cognito only

* feat : speaking rest API 람다 함수 추가

* feat: add S3 bucket resource and fix environment-specific endpoints

- Add ContentBucket S3 resource for content storage
- Replace hardcoded /dev with ${Environment} in all WebSocket endpoints
- Update Output URLs to use dynamic environment stage


* fix: add stack name prefix to news-collection schedule name

Prevent EventBridge rule name conflicts across environments


* fix: add X-Requested-With and Accept headers to CORS config

Enable additional headers for CloudFront CORS compatibility


* fix: use environment variable for S3 bucket URLs

Replace hardcoded bucket name with BUCKET_NAME env var for multi-env support:
- PreSignUpHandler: dynamic default profile URL
- PostConfirmationHandler: dynamic default profile URL
- UserService: dynamic default profile URL
- BadgeType: dynamic badge image base URL


* fix: disable authorizer for CORS preflight requests

Add AddDefaultAuthorizerToCorsPreflight: false to prevent
Cognito Authorizer from blocking OPTIONS requests


* feat : speaking REST API 람다 함수 추가  (#491)

* feature : OPIc 세션관리 + 답변 처리 파이프라인 구현  (#413)

* feat : OPIc 질문 & 세션 관련 dto 생성

* refactor : @DynamoDbBean 주석 추가

* feat : 주제 + 소주제 + 레벨로 오픽 질문 조회 추가

* feat : OPIc 세션, 질문, 답변 종합 handler 구현

* feat : 오픽 주제, 소주제별 seed 데이터 추가

* refactor : Transcribe API KEY 환경변수명 수정

* refactor : Bedrock에 사용하는 클로드 모델 변경

* refactor : S3 Key 대신 Proxy에서 요청하는 Base64 값으로 변환

* feat: GAME_START, ROUND_END 메시지에 serverTime 추가

- broadcastGameStart(): serverTime, roundDuration 필드 추가
- broadcastRoundEnd(): serverTime, roundStartTime, roundDuration 필드 추가
- GameService.endRound(): data에 roundStartTime, roundDuration 포함
- 타이머 동기화 버그 수정을 위한 서버 시간 제공

* feat: WebSocketMessageHelper 유틸리티 클래스 추가

- domain 필드 포함 메시지 생성 헬퍼
- DOMAIN_CHAT, DOMAIN_GAME 상수 정의
- buildChatMessage(), buildGameMessage() 메서드

* feat: 모든 WebSocket 메시지에 domain 필드 추가

- ScoreUpdateMessage에 domain 필드 추가
- broadcastGameStart에 domain:"game" 추가
- broadcastRoundEnd에 domain:"game" 추가
- broadcastCorrectAnswerMessage에 domain:"game" 추가
- handleCommandResult 시스템 메시지에 domain:"game" 추가
- handleRegularMessage 채팅 메시지에 domain:"chat" 추가

Closes #426, #427

* feat: GameSession 모델 클래스 생성

- DynamoDB Enhanced Client 어노테이션 적용
- GSI1: roomId로 활성 게임 세션 조회 가능
- 게임 상태 관리용 헬퍼 메서드 포함

Closes #428

* feat: GameSessionRepository 구현

- 기본 CRUD (save, findById, delete)
- roomId로 활성/전체 게임 세션 조회
- 상태, 라운드, 점수 업데이트 메서드
- 정답자 추가, 힌트 사용, 게임 종료 처리

Closes #429

* refactor: ChatRoom에서 게임 필드 분리

- 게임 관련 필드 제거 (gameStatus, currentRound 등)
- activeGameSessionId 필드 추가
- 게임 상태는 GameSession으로 분리됨

Note: 의존 코드 수정은 #431에서 진행

Closes #430

* refactor: GameSession 기반으로 전체 게임 로직 리팩토링

- GameService: ChatRoom 대신 GameSession 사용
- GameStatsService: GameSession 매개변수로 변경
- CommandService: GameSession 기반 점수 조회
- GameHandler: GameSession 기반 REST API
- WebSocketMessageHandler: GameSession 기반 브로드캐스트
- GameStatusResponse, ScoreboardResponse: GameSession 매개변수

Closes #431

* feat: GameSessionHandler Lambda 및 게임 세션 API 구현

- POST /rooms/{roomId}/games - 게임 세션 생성
- GET /games/{gameSessionId} - 게임 상태 조회 (재접속용)
- POST /games/{gameSessionId}/start - 게임 시작
- POST /games/{gameSessionId}/stop - 게임 종료

모든 응답에 serverTime 포함 (타이머 동기화)
출제자에게만 currentWord 포함

Closes #432, #433

* feat: 게임 시작 7분 후 자동 종료 기능 구현

- GameConfig에 gameTimeLimit() 메서드 추가 (기본값: 420초)
- GameSchedulerClient 유틸리티 클래스 생성 (EventBridge Scheduler 연동)
- GameService에 스케줄 생성/취소 로직 추가
- GameAutoCloseHandler Lambda 함수 생성
- template.yaml에 Lambda, IAM Role, Schedule Group 추가

Closes #417

* fix : 메모리 증가 및 Lambda 응답 제한 시간 Cognito 트리거 제한시간과 동일하게 수정 (#439)

* feat: 캐치마인드 게임 방 분리 기능 구현 (#455)

- Room 타입 분리 (CHAT/GAME)
  - RoomType, RoomStatus enum 추가
  - ChatRoom 모델에 type, gameType, gameSettings, status, hostId 필드 추가
  - GameSettings 모델 추가

- 방 생성/조회 API 수정
  - CreateRoomRequest에 type, gameType, gameSettings 필드 추가
  - 방 목록 조회 시 type, gameType, status 필터 지원

- 게임 시작 조건 검증
  - GAME 타입 방에서만 게임 시작 가능 (GAME_007 에러)

- 게임 재시작 API 구현 (#452)
  - POST /rooms/{roomId}/game/restart 엔드포인트 추가
  - 방장만 재시작 가능 (GAME_009 에러)
  - 게임 진행 중 재시작 불가 (GAME_008 에러)

- 방장 변경 로직 구현 (#453)
  - 방장 퇴장 시 다음 멤버에게 자동 이전
  - 모든 멤버 퇴장 시 방 자동 삭제

- WebSocket 메시지 타입 추가 (#454)
  - ROOM_STATUS_CHANGE, HOST_CHANGE 메시지 타입 추가
  - WebSocketMessageHelper에 빌더 메서드 추가

- 테스트 추가
  - RoomType, RoomStatus enum 테스트
  - GameSettings 모델 테스트
  - ChattingErrorCode 테스트 업데이트

Related: #440, #441, #442, #443, #444, #445, #446
Closes: #447, #448, #449, #450, #451, #452, #453, #454

* feat: 참가자 닉네임 및 방장 변경 WebSocket 알림 구현 (#456)

- RoomParticipant DTO 추가 (userId, nickname, isHost)
- ChatRoomQueryService에 닉네임 조회 메서드 추가
  - getParticipantsWithNicknames(): 참가자 목록 + 닉네임
  - getHostNickname(): 방장 닉네임 조회
- ChatRoomHandler.getRoom() 응답에 participants, hostNickname 추가
- ChatRoomCommandService.leaveRoom()에서 방장 변경 시 WebSocket 브로드캐스트

Related: #440

* fix: ChatRoomFunction에 UserTable DynamoDB 권한 추가

- 참가자/방장 닉네임 조회를 위한 UserTable 읽기 권한 추가
- DynamoDBReadPolicy로 UserTable 접근 허용

Fixes #457

* fix: GameSettings에 @DynamoDbBean 어노테이션 추가

- DynamoDB Enhanced Client가 중첩 객체를 직렬화/역직렬화할 수 있도록 수정
- ChatRoom 저장/조회 시 GameSettings 변환 오류 해결

Fixes #457

* fix: ChatRoomFunction에 WEBSOCKET_ENDPOINT 환경변수 및 권한 추가

- leaveRoom에서 WebSocketBroadcaster 사용을 위한 환경변수 추가
- execute-api:ManageConnections 권한 추가

* fix: WebSocket Lambda 함수들에 WEBSOCKET_ENDPOINT 환경변수 추가

- WebSocketConnectFunction에 WEBSOCKET_ENDPOINT 추가
- WebSocketDisconnectFunction에 WEBSOCKET_ENDPOINT 추가
- execute-api:ManageConnections 권한 추가

* fix: Grammar WebSocket Lambda 환경 변수 및 권한 추가

- GrammarStreamingConnectFunction에 WEBSOCKET_ENDPOINT 환경 변수 추가
- GrammarStreamingDisconnectFunction에 WEBSOCKET_ENDPOINT 환경 변수 추가
- 두 함수에 execute-api:ManageConnections 권한 추가

* feat: GSI1SK 확장성 있는 재설계 및 DB 레벨 필터링

- 기존: {level}#{createdAt}
- 신규: {type}#{gameType}#{status}#{level}#{createdAt}

- 전체 방: GSI1PK = "ROOMS"
- 게임방만: begins_with(GSI1SK, "GAME#")
- 캐치마인드만: begins_with(GSI1SK, "GAME#CATCHMIND#")
- 대기중 캐치마인드: begins_with(GSI1SK, "GAME#CATCHMIND#WAITING#")

- ChatRoomCommandService.java: 방 생성 시 새 GSI1SK 포맷 적용
- ChatRoomRepository.java: findByFilters() 메서드 추가, updateStatus() 메서드 추가
- ChatRoomQueryService.java: 메모리 필터링 제거, DB 레벨 필터링으로 변경
- GameService.java: 게임 시작/종료 시 방 상태 업데이트 (GSI1SK 포함)

- scripts/migrate-gsi1sk.sh: 기존 데이터 마이그레이션 스크립트
- 37개 기존 방 마이그레이션 완료

* fix: increase stats query limit to 100 days

- Adjust maximum allowable limit for recent stats query from 30 to 100 days to support extended data range responses.

* feat: improve game round and connection management logic

- Added handling for game round timeout (`ROUND_TIMEOUT`) in WebSocketMessageHandler.
- Enhanced game start broadcast to include `currentWord` for the drawer only.
- Updated ConnectionRepository to remove duplicate user connections in the same room.
- Added `currentWordEnglish` to GameSession for better answer verification.
- Normalized ChatRoom levels to match database storage format.
- Updated template.yaml to include DynamoDBReadPolicy for VocabTable.

* refactor: 코드 정리 및 미사용 클래스 제거 (#459)

* refactor: remove unused WebSocketResponseUtil

* refactor: add AutoCloseable to WebSocketBroadcaster

* refactor: remove unused TestService

* refactor: remove unused WordService

* refactor: remove unused DailyStudyService

* refactor: remove unused UserWordService

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* fix: resolve N+1 query in StatsService

* refactor(all): DI 패턴 및 전략 패턴 적용 (#461)

- Repository, Service, Handler에 DI 생성자 추가 (테스트 용이성)
- BadgeService에 Strategy 패턴 적용 (뱃지 조건 검증 로직 분리)

* refactor: relocate and restructure seed data files

- Moved `question-homes.json` and `words.json` from subdirectories to `seed` folder.
- Updated file paths for better organization and clarity.

* chore: seed 데이터 폴더 구조 정리

* feat: add CI/CD pipeline configuration for CodePipeline

* fix: add SNS topic policy and DependsOn for notification rule

* fix: correct paths in buildspec.yml for CodeBuild

* fix: remove hardcoded JAVA_HOME, use runtime default

* fix: add gradle wrapper for CI/CD build

* fix: use single line sam package command with hardcoded bucket

* fix: use existing stack name group2-englishstudy-chatting

* fix: add missing WEBSOCKET_ENDPOINT env var to WebSocket connect functions

* docs: update FRONTEND-API-GUIDE with new RoomType/RoomStatus structure

* feat : WebSocket Connect, Disconnect 핸들러 & SpeakingConnecion 모델 구현

* feat : WebSocket 메시지 처리 handler, service 구현

* feat : WebSocket 연결 정보 Repository 구현

* fix: update WebSocketDisconnectHandler to use GameSession model

- Remove references to deleted ChatRoom game fields
- Use GameSessionRepository to finish active game sessions
- Use ChatRoomRepository.updateStatus() for room state management

* perf: optimize CI/CD build time

- Add pip cache for SAM CLI dependencies
- Enable Gradle parallel builds and build cache
- Add SAM build cache (.aws-sam)
- Use sam build --parallel --cached
- Skip SAM CLI install if already cached
- Remove unnecessary 'clean' to leverage cache

* feat: add custom CodeBuild Docker image with pre-installed tools

- Dockerfile with Java 21 + SAM CLI + Gradle pre-installed
- build-and-push.sh script for ECR deployment
- Updated buildspec.yml for custom image (removes SAM CLI install)
- Expected build time reduction: ~30-40 seconds

* feature : AI 영어 회화 연습 기능 (#468)

* feat : WebSocket Connect, Disconnect 핸들러 & SpeakingConnecion 모델 구현

* feat : WebSocket 메시지 처리 handler, service 구현

* feat : WebSocket 연결 정보 Repository 구현

* fix: remove typo in SpeakingConnectionRepository

* fix : 오타 수정

* chore: trigger build test with custom Docker image

* chore: remove unnecessary newlines and whitespace across WebSocket handlers and related classes

* chore: remove unnecessary newlines and whitespace across WebSocket handlers and related classes

* refactor : websocket -> rest api 전환

* feat : speaking handler REST로 교체

* feat : speaking 관련 dto 생성

* refacotor : 기존 service 코드 로직 재사용 및 repository 리펙토링

* fix: add CORS headers to API Gateway error responses (#479)

API Gateway의 인증 실패 등 에러 응답에 CORS 헤더가 누락되어
CloudFront를 통한 프론트엔드 요청이 차단되는 문제 수정

- UNAUTHORIZED (401) 응답에 CORS 헤더 추가
- ACCESS_DENIED (403) 응답에 CORS 헤더 추가
- DEFAULT_4XX/5XX 응답에 CORS 헤더 추가
- EXPIRED_TOKEN 응답에 CORS 헤더 추가

* feat : speaking rest API 람다 함수 추가

---------

Co-authored-by: ddingjoo <ddingsha9@teambind.co.kr>

* refactor : speaking service 재사용

* refactor : AI 영어 회화 연습 코드 리팩토링

* feature : test 벡엔드 서버에 AI 말하기 연습 기능 배포 (#492)

* feat : WebSocket Connect, Disconnect 핸들러 & SpeakingConnecion 모델 구현

* feat : WebSocket 메시지 처리 handler, service 구현

* feat : WebSocket 연결 정보 Repository 구현

* fix : 오타 수정

* refactor : websocket -> rest api 전환

* feat : speaking handler REST로 교체

* feat : speaking 관련 dto 생성

* refacotor : 기존 service 코드 로직 재사용 및 repository 리펙토링

* feat : speaking rest API 람다 함수 추가

* refactor : speaking service 재사용

* refactor : AI 영어 회화 연습 코드 리팩토링

---------

Co-authored-by: DDING JOO <ddingsha9@teambind.co.kr>

* feat : handleChat 메서드 JsonNull 체크 푸가

* feature : handleChat 메서드 JsonNull 체크 추가 (#493)

* feat : WebSocket Connect, Disconnect 핸들러 & SpeakingConnecion 모델 구현

* feat : WebSocket 메시지 처리 handler, service 구현

* feat : WebSocket 연결 정보 Repository 구현

* fix : 오타 수정

* refactor : websocket -> rest api 전환

* feat : speaking handler REST로 교체

* feat : speaking 관련 dto 생성

* refacotor : 기존 service 코드 로직 재사용 및 repository 리펙토링

* feat : speaking rest API 람다 함수 추가

* refactor : speaking service 재사용

* refactor : AI 영어 회화 연습 코드 리팩토링

* feat : handleChat 메서드 JsonNull 체크 푸가

---------

Co-authored-by: DDING JOO <ddingsha9@teambind.co.kr>

* feat(news): 뉴스 학습 배지 시스템 구현 (#473)

- 14개 뉴스 관련 배지 추가 (읽기, 퀴즈, 단어수집, 연속학습, 마스터)
- UserStats에 뉴스 통계 필드 추가
- 6개 뉴스 배지 Strategy 클래스 생성
- 뉴스 읽기/퀴즈/단어수집 시 통계 업데이트 및 배지 체크 연동

* fix: add PATCH method to CORS AllowMethods

* test: BadgeType 개수 테스트 수정 (15 -> 29)

* fix: CORS PATCH 메서드 추가

* docs: 뉴스 기능 프론트엔드 연동 가이드 작성

* fix: NewsCollectionFunction에 Bedrock, Comprehend 권한 추가

* fix: add null check for collectWord request body

- Add INVALID_REQUEST error code to NewsErrorCode
- Check body and word field before accessing in collectWord()
- Prevents NullPointerException when request body is malformed

* feat: enhance stats API and bookmark response for frontend

- Add DAILY stats update for news read/quiz/word collection
- Add /stats/dashboard endpoint with frontend-requested format
  - today: wordsLearned, newsRead, quizzesTaken, wordsTotal
  - overall: totalWordsLearned, totalNewsRead, averageAccuracy, streaks
  - weeklyProgress: last 7 days with date/wordsLearned/newsRead
- Add news-related fields to all stats API responses
- Fix bookmark API to include full article details (title, summary, etc.)

* feat: add category classification to news AI analysis

- Add category field to AnalysisResult record
- Update Bedrock prompt to classify articles into categories
  (WORLD, POLITICS, BUSINESS, TECH, SCIENCE, HEALTH, SPORTS, ENTERTAINMENT, LIFESTYLE)
- Parse and set category from AI response
- Set GSI2 (CATEGORY#) index when category is available

* fix: add /stats/dashboard endpoint to template.yaml

* fix: filter by ARTICLE# prefix in findById to avoid returning UserNewsRecord

* docs: add News API troubleshooting guide

* feat: add Cognito authorizer to News API and enhance keyword extraction

- Set CognitoAuthorizer for all News API endpoints in template.yaml
- Update Bedrock AI to extract keywords with meanings and examples
- Add fallback to Comprehend for keyword extraction when Bedrock fails
- Modify KeywordInfo model to include example field
- Adjust AI prompt to include keyword extraction with examples
- Update AnalysisResult to store keywords and parse them from AI response

* Revert "Merge branch 'test' into prod"

This reverts commit c1a958eac6799d5838a76e4078ae304bcdb62278, reversing
changes made to a6662e0cfc46c6e12f20a89f0df285ff282160bc.

* feat: enhance bookmark and reading status tracking for News API

- Add bookmark and reading status to individual article responses
- Include bookmark status in paginated news responses
- Modify `KeywordInfo` to support Korean translations (`meaningKo`)
- Update AI prompts to extract Korean meanings for keywords

* refactor : session_id가 null 체크 추가

* feat : template 환경변수 리펙토링

* fix : sessionId NullPointerException 에러 수정  (#496)

* feat : WebSocket Connect, Disconnect 핸들러 & SpeakingConnecion 모델 구현

* feat : WebSocket 메시지 처리 handler, service 구현

* feat : WebSocket 연결 정보 Repository 구현

* fix : 오타 수정

* refactor : websocket -> rest api 전환

* feat : speaking handler REST로 교체

* feat : speaking 관련 dto 생성

* refacotor : 기존 service 코드 로직 재사용 및 repository 리펙토링

* feat : speaking rest API 람다 함수 추가

* refactor : speaking service 재사용

* refactor : AI 영어 회화 연습 코드 리팩토링

* feat : handleChat 메서드 JsonNull 체크 푸가

* refactor : session_id가 null 체크 추가

* feat : template 환경변수 리펙토링

---------

Co-authored-by: DDING JOO <ddingsha9@teambind.co.kr>

* feat: enhance bookmark and reading status tracking for News API

- Add bookmark and reading status to individual article responses
- Include bookmark status in paginated news responses
- Modify `KeywordInfo` to support Korean translations (`meaningKo`)
- Update AI prompts to extract Korean meanings for keywords

* feat: add category filtering to UserWord API with enhanced query logic

- Introduce `category` filtering to `getUserWords` API
- Update WordCategory enums to include "news" category
- Apply category filter after enrichment with word info
- Adjust query limits for bookmarked and incorrect words queries

* feat: add default value for ExistingCognitoClientId in template.yaml

- Set default to an empty string to ensure compatibility with templates using this parameter without explicitly specifying a value.

* fix: SpeakingHandler getStringOrNull 컴파일 에러 수정

* fix: SpeakingHandler getStringOrNull 컴파일 에러 수정

* fix: Bedrock 키워드(meaningKo 포함)를 article에 저장하도록 수정

* fix: Bedrock 키워드(meaningKo 포함)를 article에 저장하도록 수정

* fix: Bedrock 키워드(meaningKo 포함)를 article에 저장하도록 수정

* feat: add dashboard stats API and enhance news stats tracking

- Introduce `/stats/dashboard` API for retrieving integrated user stats (today, overall, weekly progress, and level distribution)
- Update `UserStats` model to include additional fields for news stats (newsRead, newsQuizCompleted, newsQuizPerfect, newsWordsCollected, etc.)
- Add atomic updates to track news reading, quiz, and word stats in `UserStatsRepository`
- Modify CloudFormation `template.yaml` to register the new `/stats/dashboard` endpoint

* feat: add dashboard stats API and enhance news stats tracking

- Introduce `/stats/dashboard` API for retrieving integrated user stats (today, overall, weekly progress, and level distribution)
- Update `UserStats` model to include additional fields for news stats (newsRead, newsQuizCompleted, newsQuizPerfect, newsWordsCollected, etc.)
- Add atomic updates to track news reading, quiz, and word stats in `UserStatsRepository`
- Modify CloudFormation `template.yaml` to register the new `/stats/dashboard` endpoint

* feat: add dashboard stats API and enhance news stats tracking

- Introduce `/stats/dashboard` API for retrieving integrated user stats (today, overall, weekly progress, and level distribution)
- Update `UserStats` model to include additional fields for news stats (newsRead, newsQuizCompleted, newsQuizPerfect, newsWordsCollected, etc.)
- Add atomic updates to track news reading, quiz, and word stats in `UserStatsRepository`
- Modify CloudFormation `template.yaml` to register the new `/stats/dashboard` endpoint

* refactor: format code with consistent indentation and spacing

- Apply consistent formatting to improve code readability across multiple files
- Adjust indentation, spacing, and alignment in model classes, DTOs, and repository methods

* fix: filter by ARTICLE# prefix in findById to avoid returning bookmark records


* feat : Speaking 관련 template 람다 함수 및 테이블 추가

---------

Co-authored-by: DDING JOO <ddingsha9@teambind.co.kr>

* feature : 말하기 연습 기능 polly 서비스 권한 추가 (#514)

* feat: EnvConfig 유틸리티 추가 및 환경 변수 검증 적용

환경 변수 미설정 시 명확한 에러 메시지를 제공하는 EnvConfig 유틸리티를 추가하고,
기존 System.getenv 호출을 EnvConfig.getRequired/getOrDefault로 대체함.

- EnvConfig: getRequired, getOrDefault, getIntOrDefault, getLongOrDefault 메서드 제공
- Lambda Cold Start 시점에 환경 변수 누락을 조기 감지
- 기존 Config 클래스(WebSocketConfig, RoomTokenConfig) EnvConfig 사용으로 통일

Closes #403

* refactor: TestService submitTest 메서드 책임 분리

submitTest 메서드를 단일 책임 원칙에 맞게 리팩토링:
- gradeAnswers(): 답안 채점 및 결과 집계
- isAnswerCorrect(): 단일 답안 정답 여부 판단
- buildResultItem(): 결과 항목 생성
- saveTestResult(): 테스트 결과 저장
- GradingResult record: 채점 결과 캡슐화

TestService와 TestCommandService 모두 동일하게 적용

Closes #404

* refactor: 하드코딩된 설정값 환경 변수로 외부화

각 도메인별 Config 클래스를 생성하여 하드코딩된 값들을 환경 변수로 설정 가능하게 변경.
기본값이 있어 환경 변수 미설정 시에도 기존 동작 유지.

## 새로 추가된 Config 클래스
- GrammarConfig: SESSION_TTL_DAYS, MAX_HISTORY_MESSAGES, MAX_TOKENS 등
- GameConfig: TOTAL_ROUNDS, ROUND_TIME_LIMIT, QUICK_GUESS_THRESHOLD_MS
- VocabularyConfig: NEW_WORDS_COUNT, REVIEW_WORDS_COUNT, 상태 전이 임계값 등

## 지원하는 환경 변수
- GRAMMAR_SESSION_TTL_DAYS, GRAMMAR_MAX_HISTORY_MESSAGES, GRAMMAR_MAX_TOKENS
- GAME_TOTAL_ROUNDS, GAME_ROUND_TIME_LIMIT, GAME_QUICK_GUESS_THRESHOLD_MS
- VOCAB_NEW_WORDS_COUNT, VOCAB_REVIEW_WORDS_COUNT
- VOCAB_TRANSITION_TO_REVIEWING, VOCAB_TRANSITION_TO_MASTERED

Closes #406

* test: StudyLevel enum 단위 테스트 추가

* test: Difficulty enum 단위 테스트 추가

* test: StudyConfig 단위 테스트 추가

* test: EnvConfig 단위 테스트 추가

* test: PaginatedResult 단위 테스트 추가

* test: JsonUtil 단위 테스트 추가

* test: CursorUtil 단위 테스트 추가

* test: CommonErrorCode 단위 테스트 추가

* test: CommonException 단위 테스트 추가

* test: BadgeType enum 단위 테스트 추가

* test: BadgeKey 상수 단위 테스트 추가

* test: WordStatus enum 단위 테스트 추가

* test: TestType enum 단위 테스트 추가

* test: VocabularyConfig 단위 테스트 추가

* test: VocabKey 상수 단위 테스트 추가

* test: VocabularyErrorCode 단위 테스트 추가

* test: VocabularyException 단위 테스트 추가

* test: SpacedRepetitionContext 단위 테스트 추가

* test: GrammarLevel enum 단위 테스트 추가

* test: GrammarConfig 단위 테스트 추가

* test: GrammarErrorCode 단위 테스트 추가

* test: GrammarException 단위 테스트 추가

* test: GameStatus enum 단위 테스트 추가

* test: GameConfig 단위 테스트 추가

* test: ChattingErrorCode 단위 테스트 추가

* test: ChattingException 단위 테스트 추가

* fix: OPIc FeedbackResponse.java 문법 오류 수정

* style: AwsClients 코드 포맷팅

* style: EnvConfig 코드 포맷팅

* style: RoomTokenConfig 코드 포맷팅

* style: WebSocketConfig 코드 포맷팅

* style: JsonUtil 코드 포맷팅

* style: GameConfig 코드 포맷팅

* style: GrammarConfig 코드 포맷팅

* style: GrammarKey 코드 포맷팅

* style: GrammarErrorCode 코드 포맷팅

* style: GrammarException 코드 포맷팅

* style: BedrockGrammarCheckFactory 코드 포맷팅

* style: GrammarConversationService 코드 포맷팅

* style: FeedbackResponse 코드 포맷팅

* style: SessionReportResponse 코드 포맷팅

* style: SpeakingError 코드 포맷팅

* style: SpeakingErrorType 코드 포맷팅

* style: OPIcException 코드 포맷팅

* style: OPIcAnswer 코드 포맷팅

* style: OPIcQuestion 코드 포맷팅

* style: OPIcSession 코드 포맷팅

* style: OPIcRepository 코드 포맷팅

* style: FeedbackService 코드 포맷팅

* style: TranscribeProxyService 코드 포맷팅

* style: VocabularyConfig 코드 포맷팅

* style: DailyStudyCommandService 코드 포맷팅

* style: TestCommandService 코드 포맷팅

* style: TestService 코드 포맷팅

* style: CommonErrorCodeSpec 코드 포맷팅

* style: JsonUtilSpec 코드 포맷팅

* style: BadgeTypeSpec 코드 포맷팅

* style: ChattingErrorCodeSpec 코드 포맷팅

* style: GrammarLevelSpec 코드 포맷팅

* style: GrammarErrorCodeSpec 코드 포맷팅

* style: VocabularyErrorCodeSpec 코드 포맷팅

* feature : OPIc 세션관리 + 답변 처리 파이프라인 구현  (#413)

* feat : OPIc 질문 & 세션 관련 dto 생성

* refactor : @DynamoDbBean 주석 추가

* feat : 주제 + 소주제 + 레벨로 오픽 질문 조회 추가

* feat : OPIc 세션, 질문, 답변 종합 handler 구현

* feat : 오픽 주제, 소주제별 seed 데이터 추가

* refactor : Transcribe API KEY 환경변수명 수정

* refactor : Bedrock에 사용하는 클로드 모델 변경

* refactor : S3 Key 대신 Proxy에서 요청하는 Base64 값으로 변환

* feat: GAME_START, ROUND_END 메시지에 serverTime 추가

- broadcastGameStart(): serverTime, roundDuration 필드 추가
- broadcastRoundEnd(): serverTime, roundStartTime, roundDuration 필드 추가
- GameService.endRound(): data에 roundStartTime, roundDuration 포함
- 타이머 동기화 버그 수정을 위한 서버 시간 제공

* feat: WebSocketMessageHelper 유틸리티 클래스 추가

- domain 필드 포함 메시지 생성 헬퍼
- DOMAIN_CHAT, DOMAIN_GAME 상수 정의
- buildChatMessage(), buildGameMessage() 메서드

* feat: 모든 WebSocket 메시지에 domain 필드 추가

- ScoreUpdateMessage에 domain 필드 추가
- broadcastGameStart에 domain:"game" 추가
- broadcastRoundEnd에 domain:"game" 추가
- broadcastCorrectAnswerMessage에 domain:"game" 추가
- handleCommandResult 시스템 메시지에 domain:"game" 추가
- handleRegularMessage 채팅 메시지에 domain:"chat" 추가

Closes #426, #427

* feat: GameSession 모델 클래스 생성

- DynamoDB Enhanced Client 어노테이션 적용
- GSI1: roomId로 활성 게임 세션 조회 가능
- 게임 상태 관리용 헬퍼 메서드 포함

Closes #428

* feat: GameSessionRepository 구현

- 기본 CRUD (save, findById, delete)
- roomId로 활성/전체 게임 세션 조회
- 상태, 라운드, 점수 업데이트 메서드
- 정답자 추가, 힌트 사용, 게임 종료 처리

Closes #429

* refactor: ChatRoom에서 게임 필드 분리

- 게임 관련 필드 제거 (gameStatus, currentRound 등)
- activeGameSessionId 필드 추가
- 게임 상태는 GameSession으로 분리됨

Note: 의존 코드 수정은 #431에서 진행

Closes #430

* refactor: GameSession 기반으로 전체 게임 로직 리팩토링

- GameService: ChatRoom 대신 GameSession 사용
- GameStatsService: GameSession 매개변수로 변경
- CommandService: GameSession 기반 점수 조회
- GameHandler: GameSession 기반 REST API
- WebSocketMessageHandler: GameSession 기반 브로드캐스트
- GameStatusResponse, ScoreboardResponse: GameSession 매개변수

Closes #431

* feat: GameSessionHandler Lambda 및 게임 세션 API 구현

- POST /rooms/{roomId}/games - 게임 세션 생성
- GET /games/{gameSessionId} - 게임 상태 조회 (재접속용)
- POST /games/{gameSessionId}/start - 게임 시작
- POST /games/{gameSessionId}/stop - 게임 종료

모든 응답에 serverTime 포함 (타이머 동기화)
출제자에게만 currentWord 포함

Closes #432, #433

* feat: 게임 시작 7분 후 자동 종료 기능 구현

- GameConfig에 gameTimeLimit() 메서드 추가 (기본값: 420초)
- GameSchedulerClient 유틸리티 클래스 생성 (EventBridge Scheduler 연동)
- GameService에 스케줄 생성/취소 로직 추가
- GameAutoCloseHandler Lambda 함수 생성
- template.yaml에 Lambda, IAM Role, Schedule Group 추가

Closes #417

* fix : 메모리 증가 및 Lambda 응답 제한 시간 Cognito 트리거 제한시간과 동일하게 수정 (#439)

* feat: 캐치마인드 게임 방 분리 기능 구현 (#455)

- Room 타입 분리 (CHAT/GAME)
  - RoomType, RoomStatus enum 추가
  - ChatRoom 모델에 type, gameType, gameSettings, status, hostId 필드 추가
  - GameSettings 모델 추가

- 방 생성/조회 API 수정
  - CreateRoomRequest에 type, gameType, gameSettings 필드 추가
  - 방 목록 조회 시 type, gameType, status 필터 지원

- 게임 시작 조건 검증
  - GAME 타입 방에서만 게임 시작 가능 (GAME_007 에러)

- 게임 재시작 API 구현 (#452)
  - POST /rooms/{roomId}/game/restart 엔드포인트 추가
  - 방장만 재시작 가능 (GAME_009 에러)
  - 게임 진행 중 재시작 불가 (GAME_008 에러)

- 방장 변경 로직 구현 (#453)
  - 방장 퇴장 시 다음 멤버에게 자동 이전
  - 모든 멤버 퇴장 시 방 자동 삭제

- WebSocket 메시지 타입 추가 (#454)
  - ROOM_STATUS_CHANGE, HOST_CHANGE 메시지 타입 추가
  - WebSocketMessageHelper에 빌더 메서드 추가

- 테스트 추가
  - RoomType, RoomStatus enum 테스트
  - GameSettings 모델 테스트
  - ChattingErrorCode 테스트 업데이트

Related: #440, #441, #442, #443, #444, #445, #446
Closes: #447, #448, #449, #450, #451, #452, #453, #454

* feat: 참가자 닉네임 및 방장 변경 WebSocket 알림 구현 (#456)

- RoomParticipant DTO 추가 (userId, nickname, isHost)
- ChatRoomQueryService에 닉네임 조회 메서드 추가
  - getParticipantsWithNicknames(): 참가자 목록 + 닉네임
  - getHostNickname(): 방장 닉네임 조회
- ChatRoomHandler.getRoom() 응답에 participants, hostNickname 추가
- ChatRoomCommandService.leaveRoom()에서 방장 변경 시 WebSocket 브로드캐스트

Related: #440

* fix: ChatRoomFunction에 UserTable DynamoDB 권한 추가

- 참가자/방장 닉네임 조회를 위한 UserTable 읽기 권한 추가
- DynamoDBReadPolicy로 UserTable 접근 허용

Fixes #457

* fix: GameSettings에 @DynamoDbBean 어노테이션 추가

- DynamoDB Enhanced Client가 중첩 객체를 직렬화/역직렬화할 수 있도록 수정
- ChatRoom 저장/조회 시 GameSettings 변환 오류 해결

Fixes #457

* fix: ChatRoomFunction에 WEBSOCKET_ENDPOINT 환경변수 및 권한 추가

- leaveRoom에서 WebSocketBroadcaster 사용을 위한 환경변수 추가
- execute-api:ManageConnections 권한 추가

* fix: WebSocket Lambda 함수들에 WEBSOCKET_ENDPOINT 환경변수 추가

- WebSocketConnectFunction에 WEBSOCKET_ENDPOINT 추가
- WebSocketDisconnectFunction에 WEBSOCKET_ENDPOINT 추가
- execute-api:ManageConnections 권한 추가

* fix: Grammar WebSocket Lambda 환경 변수 및 권한 추가

- GrammarStreamingConnectFunction에 WEBSOCKET_ENDPOINT 환경 변수 추가
- GrammarStreamingDisconnectFunction에 WEBSOCKET_ENDPOINT 환경 변수 추가
- 두 함수에 execute-api:ManageConnections 권한 추가

* feat: GSI1SK 확장성 있는 재설계 및 DB 레벨 필터링

## 변경 사항

### GSI1SK 포맷 변경
- 기존: {level}#{createdAt}
- 신규: {type}#{gameType}#{status}#{level}#{createdAt}

### 지원 쿼리 패턴
- 전체 방: GSI1PK = "ROOMS"
- 게임방만: begins_with(GSI1SK, "GAME#")
- 캐치마인드만: begins_with(GSI1SK, "GAME#CATCHMIND#")
- 대기중 캐치마인드: begins_with(GSI1SK, "GAME#CATCHMIND#WAITING#")

### 파일 수정
- ChatRoomCommandService.java: 방 생성 시 새 GSI1SK 포맷 적용
- ChatRoomRepository.java: findByFilters() 메서드 추가, updateStatus() 메서드 추가
- ChatRoomQueryService.java: 메모리 필터링 제거, DB 레벨 필터링으로 변경
- GameService.java: 게임 시작/종료 시 방 상태 업데이트 (GSI1SK 포함)

### 마이그레이션
- scripts/migrate-gsi1sk.sh: 기존 데이터 마이그레이션 스크립트
- 37개 기존 방 마이그레이션 완료

* fix: increase stats query limit to 100 days

- Adjust maximum allowable limit for recent stats query from 30 to 100 days to support extended data range responses.

* feat: improve game round and connection management logic

- Added handling for game round timeout (`ROUND_TIMEOUT`) in WebSocketMessageHandler.
- Enhanced game start broadcast to include `currentWord` for the drawer only.
- Updated ConnectionRepository to remove duplicate user connections in the same room.
- Added `currentWordEnglish` to GameSession for better answer verification.
- Normalized ChatRoom levels to match database storage format.
- Updated template.yaml to include DynamoDBReadPolicy for VocabTable.

* refactor: 코드 정리 및 미사용 클래스 제거 (#459)

* refactor: remove unused WebSocketResponseUtil

* refactor: add AutoCloseable to WebSocketBroadcaster

* refactor: remove unused TestService

* refactor: remove unused WordService

* refactor: remove unused DailyStudyService

* refactor: remove unused UserWordService

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* fix: resolve N+1 query in StatsService

* refactor(all): DI 패턴 및 전략 패턴 적용 (#461)

- Repository, Service, Handler에 DI 생성자 추가 (테스트 용이성)
- BadgeService에 Strategy 패턴 적용 (뱃지 조건 검증 로직 분리)

* refactor: relocate and restructure seed data files

- Moved `question-homes.json` and `words.json` from subdirectories to `seed` folder.
- Updated file paths for better organization and clarity.

* chore: seed 데이터 폴더 구조 정리

* feat: add CI/CD pipeline configuration for CodePipeline

* fix: add SNS topic policy and DependsOn for notification rule

* fix: correct paths in buildspec.yml for CodeBuild

* fix: remove hardcoded JAVA_HOME, use runtime default

* fix: add gradle wrapper for CI/CD build

* fix: use single line sam package command with hardcoded bucket

* fix: use existing stack name group2-englishstudy-chatting

* fix: add missing WEBSOCKET_ENDPOINT env var to WebSocket connect functions

* docs: update FRONTEND-API-GUIDE with new RoomType/RoomStatus structure

* feat : WebSocket Connect, Disconnect 핸들러 & SpeakingConnecion 모델 구현

* feat : WebSocket 메시지 처리 handler, service 구현

* feat : WebSocket 연결 정보 Repository 구현

* fix: update WebSocketDisconnectHandler to use GameSession model

- Remove references to deleted ChatRoom game fields
- Use GameSessionRepository to finish active game sessions
- Use ChatRoomRepository.updateStatus() for room state management

* perf: optimize CI/CD build time

- Add pip cache for SAM CLI dependencies
- Enable Gradle parallel builds and build cache
- Add SAM build cache (.aws-sam)
- Use sam build --parallel --cached
- Skip SAM CLI install if already cached
- Remove unnecessary 'clean' to leverage cache

* feat: add custom CodeBuild Docker image with pre-installed tools

- Dockerfile with Java 21 + SAM CLI + Gradle pre-installed
- build-and-push.sh script for ECR deployment
- Updated buildspec.yml for custom image (removes SAM CLI install)
- Expected build time reduction: ~30-40 seconds

* feature : AI 영어 회화 연습 기능 (#468)

* feat : WebSocket Connect, Disconnect 핸들러 & SpeakingConnecion 모델 구현

* feat : WebSocket 메시지 처리 handler, service 구현

* feat : WebSocket 연결 정보 Repository 구현

* fix: remove typo in SpeakingConnectionRepository

* fix : 오타 수정

* chore: trigger build test with custom Docker image

* chore: remove unnecessary newlines and whitespace across WebSocket handlers and related classes

* chore: remove unnecessary newlines and whitespace across WebSocket handlers and related classes

* Release: 캐치마인드 게임 분리, AI 회화 연습, CI/CD 파이프라인 (#469)

* feature : OPIc 세션관리 + 답변 처리 파이프라인 구현  (#413)

* feat : OPIc 질문 & 세션 관련 dto 생성

* refactor : @DynamoDbBean 주석 추가

* feat : 주제 + 소주제 + 레벨로 오픽 질문 조회 추가

* feat : OPIc 세션, 질문, 답변 종합 handler 구현

* feat : 오픽 주제, 소주제별 seed 데이터 추가

* refactor : Transcribe API KEY 환경변수명 수정

* refactor : Bedrock에 사용하는 클로드 모델 변경

* refactor : S3 Key 대신 Proxy에서 요청하는 Base64 값으로 변환

* feat: GAME_START, ROUND_END 메시지에 serverTime 추가

- broadcastGameStart(): serverTime, roundDuration 필드 추가
- broadcastRoundEnd(): serverTime, roundStartTime, roundDuration 필드 추가
- GameService.endRound(): data에 roundStartTime, roundDuration 포함
- 타이머 동기화 버그 수정을 위한 서버 시간 제공

* feat: WebSocketMessageHelper 유틸리티 클래스 추가

- domain 필드 포함 메시지 생성 헬퍼
- DOMAIN_CHAT, DOMAIN_GAME 상수 정의
- buildChatMessage(), buildGameMessage() 메서드

* feat: 모든 WebSocket 메시지에 domain 필드 추가

- ScoreUpdateMessage에 domain 필드 추가
- broadcastGameStart에 domain:"game" 추가
- broadcastRoundEnd에 domain:"game" 추가
- broadcastCorrectAnswerMessage에 domain:"game" 추가
- handleCommandResult 시스템 메시지에 domain:"game" 추가
- handleRegularMessage 채팅 메시지에 domain:"chat" 추가

Closes #426, #427

* feat: GameSession 모델 클래스 생성

- DynamoDB Enhanced Client 어노테이션 적용
- GSI1: roomId로 활성 게임 세션 조회 가능
- 게임 상태 관리용 헬퍼 메서드 포함

Closes #428

* feat: GameSessionRepository 구현

- 기본 CRUD (save, findById, delete)
- roomId로 활성/전체 게임 세션 조회
- 상태, 라운드, 점수 업데이트 메서드
- 정답자 추가, 힌트 사용, 게임 종료 처리

Closes #429

* refactor: ChatRoom에서 게임 필드 분리

- 게임 관련 필드 제거 (gameStatus, currentRound 등)
- activeGameSessionId 필드 추가
- 게임 상태는 GameSession으로 분리됨

Note: 의존 코드 수정은 #431에서 진행

Closes #430

* refactor: GameSession 기반으로 전체 게임 로직 리팩토링

- GameService: ChatRoom 대신 GameSession 사용
- GameStatsService: GameSession 매개변수로 변경
- CommandService: GameSession 기반 점수 조회
- GameHandler: GameSession 기반 REST API
- WebSocketMessageHandler: GameSession 기반 브로드캐스트
- GameStatusResponse, ScoreboardResponse: GameSession 매개변수

Closes #431

* feat: GameSessionHandler Lambda 및 게임 세션 API 구현

- POST /rooms/{roomId}/games - 게임 세션 생성
- GET /games/{gameSessionId} - 게임 상태 조회 (재접속용)
- POST /games/{gameSessionId}/start - 게임 시작
- POST /games/{gameSessionId}/stop - 게임 종료

모든 응답에 serverTime 포함 (타이머 동기화)
출제자에게만 currentWord 포함

Closes #432, #433

* feat: 게임 시작 7분 후 자동 종료 기능 구현

- GameConfig에 gameTimeLimit() 메서드 추가 (기본값: 420초)
- GameSchedulerClient 유틸리티 클래스 생성 (EventBridge Scheduler 연동)
- GameService에 스케줄 생성/취소 로직 추가
- GameAutoCloseHandler Lambda 함수 생성
- template.yaml에 Lambda, IAM Role, Schedule Group 추가

Closes #417

* fix : 메모리 증가 및 Lambda 응답 제한 시간 Cognito 트리거 제한시간과 동일하게 수정 (#439)

* feat: 캐치마인드 게임 방 분리 기능 구현 (#455)

- Room 타입 분리 (CHAT/GAME)
  - RoomType, RoomStatus enum 추가
  - ChatRoom 모델에 type, gameType, gameSettings, status, hostId 필드 추가
  - GameSettings 모델 추가

- 방 생성/조회 API 수정
  - CreateRoomRequest에 type, gameType, gameSettings 필드 추가
  - 방 목록 조회 시 type, gameType, status 필터 지원

- 게임 시작 조건 검증
  - GAME 타입 방에서만 게임 시작 가능 (GAME_007 에러)

- 게임 재시작 API 구현 (#452)
  - POST /rooms/{roomId}/game/restart 엔드포인트 추가
  - 방장만 재시작 가능 (GAME_009 에러)
  - 게임 진행 중 재시작 불가 (GAME_008 에러)

- 방장 변경 로직 구현 (#453)
  - 방장 퇴장 시 다음 멤버에게 자동 이전
  - 모든 멤버 퇴장 시 방 자동 삭제

- WebSocket 메시지 타입 추가 (#454)
  - ROOM_STATUS_CHANGE, HOST_CHANGE 메시지 타입 추가
  - WebSocketMessageHelper에 빌더 메서드 추가

- 테스트 추가
  - RoomType, RoomStatus enum 테스트
  - GameSettings 모델 테스트
  - ChattingErrorCode 테스트 업데이트

Related: #440, #441, #442, #443, #444, #445, #446
Closes: #447, #448, #449, #450, #451, #452, #453, #454

* feat: 참가자 닉네임 및 방장 변경 WebSocket 알림 구현 (#456)

- RoomParticipant DTO 추가 (userId, nickname, isHost)
- ChatRoomQueryService에 닉네임 조회 메서드 추가
  - getParticipantsWithNicknames(): 참가자 목록 + 닉네임
  - getHostNickname(): 방장 닉네임 조회
- ChatRoomHandler.getRoom() 응답에 participants, hostNickname 추가
- ChatRoomCommandService.leaveRoom()에서 방장 변경 시 WebSocket 브로드캐스트

Related: #440

* fix: ChatRoomFunction에 UserTable DynamoDB 권한 추가

- 참가자/방장 닉네임 조회를 위한 UserTable 읽기 권한 추가
- DynamoDBReadPolicy로 UserTable 접근 허용

Fixes #457

* fix: GameSettings에 @DynamoDbBean 어노테이션 추가

- DynamoDB Enhanced Client가 중첩 객체를 직렬화/역직렬화할 수 있도록 수정
- ChatRoom 저장/조회 시 GameSettings 변환 오류 해결

Fixes #457

* fix: ChatRoomFunction에 WEBSOCKET_ENDPOINT 환경변수 및 권한 추가

- leaveRoom에서 WebSocketBroadcaster 사용을 위한 환경변수 추가
- execute-api:ManageConnections 권한 추가

* fix: WebSocket Lambda 함수들에 WEBSOCKET_ENDPOINT 환경변수 추가

- WebSocketConnectFunction에 WEBSOCKET_ENDPOINT 추가
- WebSocketDisconnectFunction에 WEBSOCKET_ENDPOINT 추가
- execute-api:ManageConnections 권한 추가

* fix: Grammar WebSocket Lambda 환경 변수 및 권한 추가

- GrammarStreamingConnectFunction에 WEBSOCKET_ENDPOINT 환경 변수 추가
- GrammarStreamingDisconnectFunction에 WEBSOCKET_ENDPOINT 환경 변수 추가
- 두 함수에 execute-api:ManageConnections 권한 추가

* feat: GSI1SK 확장성 있는 재설계 및 DB 레벨 필터링

## 변경 사항

### GSI1SK 포맷 변경
- 기존: {level}#{createdAt}
- 신규: {type}#{gameType}#{status}#{level}#{createdAt}

### 지원 쿼리 패턴
- 전체 방: GSI1PK = "ROOMS"
- 게임방만: begins_with(GSI1SK, "GAME#")
- 캐치마인드만: begins_with(GSI1SK, "GAME#CATCHMIND#")
- 대기중 캐치마인드: begins_with(GSI1SK, "GAME#CATCHMIND#WAITING#")

### 파일 수정
- ChatRoomCommandService.java: 방 생성 시 새 GSI1SK 포맷 적용
- ChatRoomRepository.java: findByFilters() 메서드 추가, updateStatus() 메서드 추가
- ChatRoomQueryService.java: 메모리 필터링 제거, DB 레벨 필터링으로 변경
- GameService.java: 게임 시작/종료 시 방 상태 업데이트 (GSI1SK 포함)

### 마이그레이션
- scripts/migrate-gsi1sk.sh: 기존 데이터 마이그레이션 스크립트
- 37개 기존 방 마이그레이션 완료

* fix: increase stats query limit to 100 days

- Adjust maximum allowable limit for recent stats query from 30 to 100 days to support extended data range responses.

* feat: improve game round and connection management logic

- Added handling for game round timeout (`ROUND_TIMEOUT`) in WebSocketMessageHandler.
- Enhanced game start broadcast to include `currentWord` for the drawer only.
- Updated ConnectionRepository to remove duplicate user connections in the same room.
- Added `currentWordEnglish` to GameSession for better answer verification.
- Normalized ChatRoom levels to match database storage format.
- Updated template.yaml to include DynamoDBReadPolicy for VocabTable.

* refactor: 코드 정리 및 미사용 클래스 제거 (#459)

* refactor: remove unused WebSocketResponseUtil

* refactor: add AutoCloseable to WebSocketBroadcaster

* refactor: remove unused TestService

* refactor: remove unused WordService

* refactor: remove unused DailyStudyService

* refactor: remove unused UserWordService

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* fix: resolve N+1 query in StatsService

* refactor(all): DI 패턴 및 전략 패턴 적용 (#461)

- Repository, Service, Handler에 DI 생성자 추가 (테스트 용이성)
- BadgeService에 Strategy 패턴 적용 (뱃지 조건 검증 로직 분리)

* refactor: relocate and restructure seed data files

- Moved `question-homes.json` and `words.json` from subdirectories to `seed` folder.
- Updated file paths for better organization and clarity.

* chore: seed 데이터 폴더 구조 정리

* feat: add CI/CD pipeline configuration for CodePipeline

* fix: add SNS topic policy and DependsOn for notification rule

* fix: correct paths in buildspec.yml for CodeBuild

* fix: remove hardcoded JAVA_HOME, use runtime default

* fix: add gradle wrapper for CI/CD build

* fix: use single line sam package command with hardcoded bucket

* fix: use existing stack name group2-englishstudy-chatting

* fix: add missing WEBSOCKET_ENDPOINT env var to WebSocket connect functions

* docs: update FRONTEND-API-GUIDE with new RoomType/RoomStatus structure

* fix: update WebSocketDisconnectHandler to use GameSession model

- Remove references to deleted ChatRoom game fields
- Use GameSessionRepository to finish active game sessions
- Use ChatRoomRepository.updateStatus() for room state management

* perf: optimize CI/CD build time

- Add pip cache for SAM CLI dependencies
- Enable Gradle parallel builds and build cache
- Add SAM build cache (.aws-sam)
- Use sam build --parallel --cached
- Skip SAM CLI install if already cached
- Remove unnecessary 'clean' to leverage cache

* feat: add custom CodeBuild Docker image with pre-installed tools

- Dockerfile with Java 21 + SAM CLI + Gradle pre-installed
- build-and-push.sh script for ECR deployment
- Updated buildspec.yml for custom image (removes SAM CLI install)
- Expected build time reduction: ~30-40 seconds

* feature : AI 영어 회화 연습 기능 (#468)

* feat : WebSocket Connect, Disconnect 핸들러 & SpeakingConnecion 모델 구현

* feat : WebSocket 메시지 처리 handler, service 구현

* feat : WebSocket 연결 정보 Repository 구현

* fix: remove typo in SpeakingConnectionRepository

* chore: trigger build test with custom Docker image

* chore: remove unnecessary newlines and whitespace across WebSocket handlers and related classes

* chore: remove unnecessary newlines and whitespace across WebSocket handlers and related classes

---------

Co-authored-by: hyein Heo <128613248+hye-inA@users.noreply.github.com>

* refactor : websocket -> rest api 전환

* feat : speaking handler REST로 교체

* feat : speaking 관련 dto 생성

* refacotor : 기존 service 코드 로직 재사용 및 repository 리펙토링

* fix: add CORS headers to API Gateway error responses (#479)

API Gateway의 인증 실패 등 에러 응답에 CORS 헤더가 누락되어
CloudFront를 통한 프론트엔드 요청이 차단되는 문제 수정

- UNAUTHORIZED (401) 응답에 CORS 헤더 추가
- ACCESS_DENIED (403) 응답에 CORS 헤더 추가
- DEFAULT_4XX/5XX 응답에 CORS 헤더 추가
- EXPIRED_TOKEN 응답에 CORS 헤더 추가

* feat(news): 뉴스 도메인 기반 구조 구축 (#385)

- NewsCategory, QuizType enum 추가
- NewsKey 상수 클래스 추가
- NewsErrorCode 예외 클래스 추가
- NewsArticle, KeywordInfo, QuizQuestion 모델 추가
- NewsArticleRepository CRUD 구현
- NewsTable DynamoDB 테이블 정의
- CORS GatewayResponses 설정 추가

* feat(news): 뉴스 수집 파이프라인 구현 (#386)

- NewsApiClient: NewsAPI 연동 서비스
- RssFeedParser: RSS 피드 파싱 (BBC, VOA, NPR)
- NewsDuplicateChecker: URL 기반 중복 필터링
- NewsCollectorService: 수집 오케스트레이션
- NewsCollectionHandler: Lambda 핸들러
- EventBridge 스케줄러: 매일 18시 KST 실행

* refactor(news): NewsAPI 제거, RSS만 사용

- NewsApiClient 삭제
- SSM Parameter 의존성 제거
- RSS 소스당 7개씩 수집 (BBC, VOA, NPR = 약 21개/일)

* feat(news): AI 뉴스 분석 시스템 구현 (#387)

- NewsAnalysisService: AI 분석 통합 서비스
  - Bedrock: CEFR 난이도 분석 (A1~C2)
  - Bedrock: 3줄 요약 + 퀴즈 3문제 생성
  - Comprehend: 핵심 키워드 추출
- NewsCollectorService: 수집 시 자동 분석 연동
- GSI1/GSI2 키 자동 설정 (레벨별, 카테고리별 조회)

* feat(news): 뉴스 학습 API 구현 (#388)

- NewsQueryService: 뉴스 조회 서비스
- NewsHandler: API 핸들러
  - GET /news - 목록 조회 (level, category 필터)
  - GET /news/today - 오늘의 뉴스
  - GET /news/recommended - 내 레벨 맞춤 추천
  - GET /news/{articleId} - 상세 조회 (조회수 증가)
- template.yaml: NewsFunction Lambda 추가

* feat(news): 뉴스 학습 부가 기능 구현 (#389)

- 읽기 완료 기록 API (POST /news/{articleId}/read)
- 북마크 토글 API (POST /news/{articleId}/bookmark)
- 북마크 목록 조회 API (GET /news/bookmarks)
- 학습 통계 조회 API (GET /news/stats)
- TTS 오디오 URL 조회 API (GET /news/{articleId}/audio)
- UserNewsRecord 모델 추가
- UserNewsRepository 추가
- NewsLearningService 추가

* feat(news): 복합 퀴즈 시스템 구현 (#471)

- 퀴즈 조회 API (GET /news/{articleId}/quiz)
- 퀴즈 제출 API (POST /news/{articleId}/quiz)
- 퀴즈 기록 조회 API (GET /news/quiz/history)
- NewsQuizResult 모델 추가
- QuizAnswerResult 모델 추가
- NewsQuizRepository 추가
- NewsQuizService 추가

* feat(news): 단어 수집 & Vocabulary 연동 구현 (#472)

- 단어 수집 API (POST /news/{articleId}/words)
- 수집 단어 목록 API (GET /news/words)
- 단어 상세 조회 API (GET /news/{articleId}/words/{word})
- 단어 삭제 API (DELETE /news/{articleId}/words/{word})
- Vocabulary 연동 API (POST /news/words/{word}/sync)
- NewsWordCollect 모델 추가
- NewsWordRepository 추가
- NewsWordService 추가

* feat: add multi-environment deployment support (dev/test/prod)

* fix: update buildspec.yml to deploy prod environment with parameter overrides

* feat(news): 뉴스 도메인 기반 구조 구축 (#385)

- NewsCategory, QuizType enum 추가
- NewsKey 상수 클래스 추가
- NewsErrorCode 예외 클래스 추가
- NewsArticle, KeywordInfo, QuizQuestion 모델 추가
- NewsArticleRepository CRUD 구현
- NewsTable DynamoDB 테이블 정의
- CORS GatewayResponses 설정 추가

* feat(news): 뉴스 수집 파이프라인 구현 (#386)

- NewsApiClient: NewsAPI 연동 서비스
- RssFeedParser: RSS 피드 파싱 (BBC, VOA, NPR)
- NewsDuplicateChecker: URL 기반 중복 필터링
- NewsCollectorService: 수집 오케스트레이션
- NewsCollectionHandler: Lambda 핸들러
- EventBridge 스케줄러: 매일 18시 KST 실행

* refactor(news): NewsAPI 제거, RSS만 사용

- NewsApiClient 삭제
- SSM Parameter 의존성 제거
- RSS 소스당 7개씩 수집 (BBC, VOA, NPR = 약 21개/일)

* feat(news): AI 뉴스 분석 시스템 구현 (#387)

- NewsAnalysisService: AI 분석 통합 서비스
  - Bedrock: CEFR 난이도 분석 (A1~C2)
  - Bedrock: 3줄 요약 + 퀴즈 3문제 생성
  - Comprehend: 핵심 키워드 추출
- NewsCollectorService: 수집 시 자동 분석 연동
- GSI1/GSI2 키 자동 설정 (레벨별, 카테고리별 조회)

* feat(news): 뉴스 학습 API 구현 (#388)

- NewsQueryService: 뉴스 조회 서비스
- NewsHandler: API 핸들러
  - GET /news - 목록 조회 (level, category 필터)
  - GET /news/today - 오늘의 뉴스
  - GET /news/recommended - 내 레벨 맞춤 추천
  - GET /news/{articleId} - 상세 조회 (조회수 증가)
- template.yaml: NewsFunction Lambda 추가

* feat(news): 뉴스 학습 부가 기능 구현 (#389)

- 읽기 완료 기록 API (POST /news/{articleId}/read)
- 북마크 토글 API (POST /news/{articleId}/bookmark)
- 북마크 목록 조회 API (GET /news/bookmarks)
- 학습 통계 조회 API (GET /news/stats)
- TTS 오디오 URL 조회 API (GET /news/{articleId}/audio)
- UserNewsRecord 모델 추가
- UserNewsRepository 추가
- NewsLearningService 추가

* feat(news): 복합 퀴즈 시스템 구현 (#471)

- 퀴즈 조회 API (GET /news/{articleId}/quiz)
- 퀴즈 제출 API (POST /news/{articleId}/quiz)
- 퀴즈 기록 조회 API (GET /news/quiz/history)
- NewsQuizResult 모델 추가
- QuizAnswerResult 모델 추가
- NewsQuizRepository 추가
- NewsQuizService 추가

* feat(news): 단어 수집 & Vocabulary 연동 구현 (#472)

- 단어 수집 API (POST /news/{articleId}/words)
- 수집 단어 목록 API (GET /news/words)
- 단어 상세 조회 API (GET /news/{articleId}/words/{word})
- 단어 삭제 API (DELETE /news/{articleId}/words/{word})
- Vocabulary 연동 API (POST /news/words/{word}/sync)
- NewsWordCollect 모델 추가
- NewsWordRepository 추가
- NewsWordService 추가

* feat: add multi-environment deployment support (dev/test/prod)

* fix: update buildspec.yml to deploy prod environment with parameter overrides

* refactor : AI 말하기 Websocket 구현 -> REST API 구현으로 리팩토링 (#490)

* feat : WebSocket Connect, Disconnect 핸들러 & SpeakingConnecion 모델 구현

* feat : WebSocket 메시지 처리 handler, service 구현

* feat : WebSocket 연결 정보 Repository 구현

* fix : 오타 수정

* refactor : websocket -> rest api 전환

* feat : speaking handler REST로 교체

* feat : speaking 관련 dto 생성

* refacotor : 기존 service 코드 로직 재사용 및 repository 리펙토링

* fix: revert buildspec.yml to build-only for CloudFormation deploy stage

* fix: revert buildspec.yml to build-only for CloudFormation deploy stage

* fix: update all API Gateway StageName to use Environment parameter

* fix: correct VocabularyTable and ContentBucket references in NewsFunction

* fix: correct VocabularyTable and ContentBucket references in NewsFunction

* fix: add stack name prefix to GameScheduleGroup and daily-stats schedule to avoid conflicts

* fix: add stack name prefix to GameScheduleGroup and daily-stats schedule to avoid conflicts

* feat: add support for existing Cognito User Pool reuse across environments

* fix: add conditional Cognito ARN reference in API Gateway Authorizer

* fix: remove Cognito resources completely, use existing Cognito only

* fix: remove Cognito resources completely, use existing Cognito only

* feat : speaking rest API 람다 함수 추가

* feat: add S3 bucket resource and fix environment-specific endpoints

- Add ContentBucket S3 resource for content storage
- Replace hardcoded /dev with ${Environment} in all WebSocket endpoints
- Update Output URLs to use dynamic environment stage

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* fix: add stack name prefix to news-collection schedule name

Prevent EventBridge rule name conflicts across environments

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* fix: add X-Requested-With and Accept headers to CORS config

Enable additional headers for CloudFront CORS compatibility

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* fix: use environment variable for S3 bucket URLs

Replace hardcoded bucket name with BUCKET_NAME env var for multi-env support:
- PreSignUpHandler: dynamic default profile URL
- PostConfirmationHandler: dynamic default profile URL
- UserService: dynamic default profile URL
- BadgeType: dynamic badge image base URL

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* fix: disable authorizer for CORS preflight requests

Add AddDefaultAuthorizerToCorsPreflight: false to prevent
Cognito Authorizer from blocking OPTIONS requests

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* feat : speaking REST API 람다 함수 추가  (#491)

* feature : OPIc 세션관리 + 답변 처리 파이프라인 구현  (#413)

* feat : OPIc 질문 & 세션 관련 dto 생성

* refactor : @DynamoDbBean 주석 추가

* feat : 주제 + 소주제 + 레벨로 오픽 질문 조회 추가

* feat : OPIc 세션, 질문, 답변 종합 handler 구현

* feat : 오픽 주제, 소주제별 seed 데이터 추가

* refactor : Transcribe API KEY 환경변수명 수정

* refactor : Bedrock에 사용하는 클로드 모델 변경

* refactor : S3 Key 대신 Proxy에서 요청하는 Base64 값으로 변환

* feat: GAME_START, ROUND_END 메시지에 serverTime 추가

- broadcastGameStart(): serverTime, roundDuration 필드 추가
- broadcastRoundEnd(): serverTime, roundStartTime, roundDuration 필드 추가
- GameService.endRound(): data에 roundStartTime, roundDuration 포함
- 타이머 동기화 버그 수정을 위한 서버 시간 제공

* feat: WebSocketMessageHelper 유틸리티 클래스 추가

- domain 필드 포함 메시지 생성 헬퍼
- DOMAIN_CHAT, DOMAIN_GAME 상수 정의
- buildChatMessage(), buildGameMessage() 메서드

* feat: 모든 WebSocket 메시지에 domain 필드 추가

- ScoreUpdateMessage에 domain 필드 추가
- broadcastGameStart에 domain:"game" 추가
- broadcastRoundEnd에 domain:"game" 추가
- broadcastCorrectAnswerMessage에 domain:"game" 추가
- handleCommandResult 시스템 메시지에 domain:"game" 추가
- handleRegularMessage 채팅 메시지에 domain:"chat" 추가

Closes #426, #427

* feat: GameSession 모델 클래스 생성

- DynamoDB Enhanced Client 어노테이션 적용
- GSI1: roomId로 활성 게임 세션 조회 가능
- 게임 상태 관리용 헬퍼 메서드 포함

Closes #428

* feat: GameSessionRepository 구현

- 기본 CRUD (save, findById, delete)
- roomId로 활성/전체 게임 세션 조회
- 상태, 라운드, 점수 업데이트 메서드
- 정답자 추가, 힌트 사용, 게임 종료 처리

Closes #429

* refactor: ChatRoom에서 게임 필드 분리

- 게임 관련 필드 제거 (gameStatus, currentRound 등)
- activeGameSessionId 필드 추가
- 게임 상태는 GameSession으로 분리됨

Note: 의존 코드 수정은 #431에서 진행

Closes #430

* refactor: GameSession 기반으로 전체 게임 로직 리팩토링

- GameService: ChatRoom 대신 GameSession 사용
- GameStatsService: GameSession 매개변수로 변경
- CommandService: GameSession 기반 점수 조회
- GameHandler: GameSession 기반 REST API
- WebSocketMessageHandler: GameSession 기반 브로드캐스트
- GameStatusResponse, ScoreboardResponse: GameSession 매개변수

Closes #431

* feat: GameSessionHandler Lambda 및 게임 세션 API 구현

- POST /rooms/{roomId}/games - 게임 세션 생성
- GET /games/{gameSessionId} - 게임 상태 조회 (재접속용)
- POST /games/{gameSessionId}/start - 게임 시작
- POST /games/{gameSessionId}/stop - 게임 종료

모든 응답에 serverTime 포함 (타이머 동기화)
출제자에게만 currentWord 포함

Closes #432, #433

* feat: 게임 시작 7분 후 자동 종료 기능 구현

- GameConfig에 gameTimeLimit() 메서드 추가 (기본값: 420초)
- GameSchedulerClient 유틸리티 클래스 생성 (EventBridge Scheduler 연동)
- GameService에 스케줄 생성/취소 로직 추가
- GameAutoCloseHandler Lambda 함수 생성
- template.yaml에 Lambda, IAM Role, Schedule Group 추가

Closes #417

* fix : 메모리 증가 및 Lambda 응답 제한 시간 Cognito 트리거 제한시간과 동일하게 수정 (#439)

* feat: 캐치마인드 게임 방 분리 기능 구현 (#455)

- Room 타입 분리 (CHAT/GAME)
  - RoomType, RoomStatus enum 추가
  - ChatRoom 모델에 type, gameType, gameSettings, status, hostId 필드 추가
  - GameSettings 모델 추가

- 방 생성/조회 API 수정
  - CreateRoomRequest에 type, gameType, gameSettings 필드 추가
  - 방 목록 조회 시 type, gameType, status 필터 지원

- 게임 시작 조건 검증
  - GAME 타입 방에서만 게임 시작 가능 (GAME_007 에러)

- 게임 재시작 API 구현 (#452)
  - POST /rooms/{roomId}/game/restart 엔드포인트 추가
  - 방장만 재시작 가능 (GAME_009 에러)
  - 게임 진행 중 재시작 불가 (GAME_008 에러)

- 방장 변경 로직 구현 (#453)
  - 방장 퇴장 시 다음 멤버에게 자동 이전
  - 모든 멤버 퇴장 시 방 자동 삭제

- WebSocket 메시지 타입 추가 (#454)
  - ROOM_STATUS_CHANGE, HOST_CHANGE 메시지 타입 추가
  - WebSocketMessageHelper에 빌더 메서드 추가

- 테스트 추가
  - RoomType, RoomStatus enum 테스트
  - GameSettings 모델 테스트
  - ChattingErrorCode 테스트 업데이트

Related: #440, #441, #442, #443, #444, #445, #446
Closes: #447, #448, #449, #450, #451, #452, #453, #454

* feat: 참가자 닉네임 및 방장 변경 WebSocket 알림 구현 (#456)

- RoomParticipant DTO 추가 (userId, nickname, isHost)
- ChatRoomQueryService에 닉네임 조회 메서드 추가
  - getParticipantsWithNicknames(): 참가자 목록 + 닉네임
  - getHostNickname(): 방장 닉네임 조회
- ChatRoomHandler.getRoom() 응답에 participants, hostNickname 추가
- ChatRoomCommandService.leaveRoom()에서 방장 변경 시 WebSocket 브로드캐스트

Related: #440

* fix: ChatRoomFunction에 UserTable DynamoDB 권한 추가

- 참가자/방장 닉네임 조회를 위한 UserTable 읽기 권한 추가
- DynamoDBReadPolicy로 UserTable 접근 허용

Fixes #457

* fix: GameSettings에 @DynamoDbBean 어노테이션 추가

- DynamoDB Enhanced Client가 중첩 객체를 직렬화/역직렬화할 수 있도록 수정
- ChatRoom 저장/조회 시 GameSettings 변환 오류 해결

Fixes #457

* fix: ChatRoomFunction에 WEBSOCKET_ENDPOINT 환경변수 및 권한 추가

- leaveRoom에서 WebSocketBroadcaster 사용을 위한 환경변수 추가
- execute-api:ManageConnections 권한 추가

* fix: WebSocket Lambda 함수들에 WEBSOCKET_ENDPOINT 환경변수 추가

- WebSocketConnectFunction에 WEBSOCKET_ENDPOINT 추가
- WebSocketDisconnectFunction에 WEBSOCKET_ENDPOINT 추가
- execute-api:ManageConnections 권한 추가

* fix: Grammar WebSocket Lambda 환경 변수 및 권한 추가

- GrammarStreamingConnectFunction에 WEBSOCKET_ENDPOINT 환경 변수 추가
- GrammarStreamingDisconnectFunction에 WEBSOCKET_ENDPOINT 환경 변수 추가
- 두 함수에 execute-api:ManageConnections 권한 추가

* feat: GSI1SK 확장성 있는 재설계 및 DB 레벨 필터링

- 기존: {level}#{createdAt}
- 신규: {type}#{gameType}#{status}#{level}#{createdAt}

- 전체 방: GSI1PK = "ROOMS"
- 게임방만: begins_with(GSI1SK, "GAME#")
- 캐치마인드만: begins_with(GSI1SK, "GAME#CATCHMIND#")
- 대기중 캐치마인드: begins_with(GSI1SK, "GAME#CATCHMIND#WAITING#")

- ChatRoomCommandService.java: 방 생성 시 새 GSI1SK 포맷 적용
- ChatRoomRepository.java: findByFilters() 메서드 추가, updateStatus() 메서드 추가
- ChatRoomQueryService.java: 메모리 필터링 제거, DB 레벨 필터링으로 변경
- GameService.java: 게임 시작/종료 시 방 상태 업데이트 (GSI1SK 포함)

- scripts/migrate-gsi1sk.sh: 기존 데이터 마이그레이션 스크립트
- 37개 기존 방 마이그레이션 완료

* fix: increase stats query limit to 100 days

- Adjust maximum allowable limit for recent stats query from 30 to 100 days to support extended data range responses.

* feat: improve game round and connection management logic

- Added handling for game round timeout (`ROUND_TIMEOUT`) in WebSocketMessageHandler.
- Enhanced game start broadcast to include `currentWord` for the drawer only.
- Updated ConnectionRepository to remove duplicate user connections in the same room.
- Added `currentWordEnglish` to GameSession for better answer verification.
- Normalized ChatRoom levels to match database storage format.
- Updated template.yaml to include DynamoDBReadPolicy for VocabTable.

* refactor: 코드 정리 및 미사용 클래스 제거 (#459)

* refactor: remove unused WebSocketResponseUtil

* refactor: add AutoCloseable to WebSocketBroadcaster

* refactor: remove unused TestService

* refactor: remove unused WordService

* refactor: remove unused DailyStudyService

* refactor: remove unused UserWordService

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* fix: resolve N+1 query in StatsService

* refactor(all): DI 패턴 및 전략 패턴 적용 (#461)

- Repository, Service, Handler에 DI 생성자 추가 (테스트 용이성)
- BadgeService에 Strategy 패턴 적용 (뱃지 조건 검증 로직 분리)

* refactor: relocate and restructure seed data files

- Moved `question-homes.json` and `words.json` from subdirectories to `seed` folder.
- Updated file paths for better organization and clarity.

* chore: seed 데이터 폴더 구조 정리

* feat: add CI/CD pipeline configuration for CodePipeline

* fix: add SNS topic policy and DependsOn for notification rule

* fix: correct paths in buildspec.yml for CodeBuild

* fix: remove hardcoded JAVA_HOME, use runtime default

* fix: add gradle wrapper for CI/CD build

* fix: use single line sam package command with hardcoded bucket

* fix: use existing stack name group2-englishstudy-chatting

* fix: add missing WEBSOCKET_ENDPOINT env var to WebSocket connect functions

* docs: update FRONTEND-API-GUIDE with new RoomType/RoomStatus structure

* feat : WebSocket Connect, Disconnect 핸들러 & SpeakingConnecion 모델 구현

* feat : WebSocket 메시지 처리 handler, service 구현

* feat : WebSocket 연결 정보 Repository 구현

* fix: update WebSocketDisconnectHandler to use GameSession model

- Remove references to deleted ChatRoom game fields
- Use GameSessionRepository to finish active game sessions
- Use ChatRoomRepository.updateStatus() for room state management

* perf: optimize CI/CD build time

- Add pip cache for SAM CLI dependencies
- Enable Gradle parallel builds and build cache
- Add SAM build cache (.aws-sam)
- Use sam build --parallel --cached
- Skip SAM CLI install if already cached
- Remove unnecessary 'clean' to leverage cache

* feat: add custom CodeBuild Docker image with pre-installed tools

- Dockerfile with Java 21 + SAM CLI + Gradle pre-installed
- build-and-push.sh script for ECR deployment
- Updated buildspec.yml for custom image (removes SAM CLI install)
- Expected build time reduction: ~30-40 seconds

* feature : AI 영어 회화 연습 기능 (#468)

* feat : WebSocket Connect, Disconnect 핸들러 & SpeakingConnecion 모델 구현

* feat : WebSocket 메시지 처리 handler, service 구현

* feat : WebSocket 연결 정보 Repository 구현

* fix: remove typo in SpeakingConnectionRepository

* fix : 오타 수정

* chore: trigger build test with custom Docker image

* chore: remove unnecessary newlines and whitespace across WebSocket handlers and related classes

* chore: remove unnecessary newlines and whitespace across WebSocket handlers and related classes

* refactor : websocket -> rest api 전환

* feat : speaking handler REST로 교체

* feat : speaking 관련 dto 생성

* refacotor : 기존 service 코드 로직 재사용 및 repository 리펙토링

* fix: add CORS headers to API Gateway error responses (#479)

API Gateway의 인증 실패 등 에러 응답에 CORS 헤더가 누락되어
CloudFront를 통한 프론트엔드 요청이 차단되는 문제 수정

- UNAUTHORIZED (401) 응답에 CORS 헤더 추가
- ACCESS_DENIED (403) 응답에 CORS 헤더 추가
- DEFAULT_4XX/5XX 응답에 CORS 헤더 추가
- EXPIRED_TOKEN 응답에 CORS 헤더 추가

* feat : speaking rest API 람다 함수 추가

---------

Co-authored-by: ddingjoo <ddingsha9@teambind.co.kr>

* refactor : speaking service 재사용

* refactor : AI 영어 회화 연습 코드 리팩토링

* feature : test 벡엔드 서버에 AI 말하기 연습 기능 배포 (#492)

* feat : WebSocket Connect, Disconnect 핸들러 & SpeakingConnecion 모델 구현

* feat : WebSocket 메시지 처리 handler, service 구현

* feat : WebSocket 연결 정보 Repository 구현

* fix : 오타 수정

* refactor : websocket -> rest api 전환

* feat : speaking handler REST로 교체

* feat : speaking 관련 dto 생성

* refacotor : 기존 service 코드 로직 재사용 및 repository 리펙토링

* feat : speaking rest API 람다 함수 추가

* refactor : speaking service 재사용

* refactor : AI 영어 회화 연습 코드 리팩토링

---------

Co-authored-by: DDING JOO <ddingsha9@teambind.co.kr>

* feat : handleChat 메서드 JsonNull 체크 푸가

* feature : handleChat 메서드 JsonNull 체크 추가 (#493)

* feat : WebSocket Connect, Disconnect 핸들러 & SpeakingConnecion 모델 구현

* feat : WebSocket 메시지 처리 handler, service 구현

* feat : WebSocket 연결 정보 Repository 구현

* fix : 오타 수정

* refactor : websocket -> rest api 전환

* feat : speaking handler REST로 교체

* feat : speaking 관련 dto 생성

* refacotor : 기존 service 코드 로직 재사용 및 repository 리펙토링

* feat : speaking rest API 람다 함수 추가

* refactor : speaking service 재사용

* refactor : AI 영어 회화 연습 코드 리팩토링

* feat : handleChat 메서드 JsonNull 체크 푸가

---------

Co-authored-by: DDING JOO <ddingsha9@teambind.co.kr>

* feat(news): 뉴스 학습 배지 시스템 구현 (#473)

- 14개 뉴스 관련 배지 추가 (읽기, 퀴즈, 단어수집, 연속학습, 마스터)
- UserStats에 뉴스 통계 필드 추가
- 6개 뉴스 배지 Strategy 클래스 생성
- 뉴스 읽기/퀴즈/단어수집 시 통계 업데이트 및 배지 체크 연동

* fix: add PATCH method to CORS AllowMethods

* test: BadgeType 개수 테스트 수정 (15 -> 29)

* fix: CORS PATCH 메서드 추가

* docs: 뉴스 기능 프론트엔드 연동 가이드 작성

* fix: NewsCollectionFunction에 Bedrock, Comprehend 권한 추가

* fix: add null check for collectWord request body

- Add INVALID_REQUEST error code to NewsErrorCode
- Check body and word field before accessing in collectWord()
- Prevents NullPointerException when request body is malformed

* feat: enhance stats API and bookmark response for frontend

- Add DAILY stats update for news read/quiz/word collection
- Add /stats/dashboard endpoint with frontend-requested format
  - today: wordsLearned, newsRead, quizzesTaken, wordsTotal
  - overall: totalWordsLearned, totalNewsRead, averageAccuracy, streaks
  - weeklyProgress: last 7 days with date/wordsLearned/newsRead
- Add news-related fields to all stats API responses
- Fix bookmark API to include full article details (title, summary, etc.)

* feat: add category classification to news AI analysis

- Add category field to AnalysisResult record
- Update Bedrock prompt to classify articles into categories
  (WORLD, POLITICS, BUSINESS, TECH, SCIENCE, HEALTH, SPORTS, ENTERTAINMENT, LIFESTYLE)
- Parse and set category from AI response
- Set GSI2 (CATEGORY#) index when category is available

* fix: add /stats/dashboard endpoint to template.yaml

* fix: filter by ARTICLE# prefix in findById to avoid returning UserNewsRecord

* docs: add News API troubleshooting guide

* feat: add Cognito authorizer to News API and enhance keyword extraction

- Set CognitoAuthorizer for all News API endpoints in template.yaml
- Update Bedrock AI to extract keywords with meanings and examples
- Add fallback to Comprehend for keyword extraction when Bedrock fails
- Modify KeywordInfo model to include example field
- Adjust AI prompt to include keyword extraction with examples
- Update AnalysisResult to store keywords and parse them from AI response

* Revert "Merge branch 'test' into prod"

This reverts commit c1a958eac6799d5838a76e4078ae304bcdb62278, reversing
changes made to a6662e0cfc46c6e12f20a89f0df285ff282160bc.

* feat: enhance bookmark and reading status tracking for News API

- Add bookmark and reading status to individual article responses
- Include bookmark status in paginated news responses
- Modify `KeywordInfo` to support Korean translations (`meaningKo`)
- Update AI prompts to extract Korean meanings for keywords

* refactor : session_id가 null 체크 추가

* feat : template 환경변수 리펙토링

* fix : sessionId NullPointerException 에러 수정  (#496)

* feat : WebSocket Connect, Disconnect 핸들러 & SpeakingConnecion 모델 구현

* feat : WebSocket 메시지 처리 handler, service 구현

* feat : WebSocket 연결 정보 Repository 구현

* fix : 오타 수정

* refactor : websocket -> rest api 전환

* feat : speaking handler REST로 교체

* feat : speaking 관련 dto 생성

* refacotor : 기존 service 코드 로직 재사용 및 repository 리펙토링

* feat : speaking rest API 람다 함수 추가

* refactor : speaking service 재사용

* refactor : AI 영어 회화 연습 코드 리팩토링

* feat : handleChat 메서드 JsonNull 체크 푸가

* refactor : session_id가 null 체크 추가

* feat : template 환경변수 리펙토링

---------

Co-authored-by: DDING JOO <ddingsha9@teambind.co.kr>

* feat: enhance bookmark and reading status tracking for News API

- Add bookmark and reading status to individual article responses
- Include bookmark status in paginated news responses
- Modify `KeywordInfo` to support Korean translations (`meaningKo`)
- Update AI prompts to extract Korean meanings for keywords

* feat: add category filtering to UserWord API with enhanced query logic

- Introduce `category` filtering to `getUserWords` API
- Update WordCategory enums to include "news" category
- Apply category filter after enrichment with word info
- Adjust query limits for bookmarked and incorrect words queries

* feat: add default value for ExistingCognitoClientId in template.yaml

- Set default to an empty string to ensure compatibility with templates using this parameter without explicitly specifying a value.

* fix: SpeakingHandler getStringOrNull 컴파일 에러 수정

* fix: SpeakingHandler getStringOrNull 컴파일 에러 수정

* fix: Bedrock 키워드(meaningKo 포함)를 article에 저장하도록 수정

* fix: Bedrock 키워드(meaningKo 포함)를 article에 저장하도록 수정

* fix: Bedrock 키워드(meaningKo 포함)를 article에 저장하도록 수정

* feat: add dashboard stats API and enhance news stats tracking

- Introduce `/stats/dashboard` API for retrieving integrated user stats (today, overall, weekly progress, and level distribution)
- Update `UserStats` model to include additional fields for news stats (newsRead, newsQuizCompleted, newsQuizPerfect, newsWordsCollected, etc.)
- Add atomic updates to track news reading, quiz, and word stats in `UserStatsRepository`
- Modify CloudFormation `template.yaml` to register the new `/stats/dashboard` endpoint

* feat: add dashboard stats API and enhance news stats tracking

- Introduce `/stats/dashboard` API for retrieving integrated user stats (today, overall, weekly progress, and level distribution)
- Update `UserStats` model to include additional fields for news stats (newsRead, newsQuizCompleted, newsQuizPerfect, newsWordsCollected, etc.)
- Add atomic updates to track news reading, quiz, and word stats in `UserStatsRepository`
- Modify CloudFormation `template.yaml` to register the new `/stats/dashboard` endpoint

* feat: add dashboard stats API and enhance news stats tracking

- Introduce `/stats/dashboard` API for retrieving integrated user stats (today, overall, weekly progress, and level distribution)
- Update `UserStats` model to include additional fields for news stats (newsRead, newsQuizCompleted, newsQuizPerfect, newsWordsCollected, etc.)
- Add atomic updates to track news reading, quiz, and word stats in `UserStatsRepository`
- Modify CloudFormation `template.yaml` to register the new `/stats/dashboard` endpoint

* refactor: format code with consistent indentation and spacing

- Apply consistent formatting to improve code readability across multiple files
- Adjust indentation, spacing, and alignment in model classes, DTOs, and repository methods

* fix: filter by ARTICLE# prefix in findById to avoid returning bookmark records

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* feat : Speaking 관련 template 람다 함수 및 테이블 추가

* feat : 말하기 기능에 polly 서비스 권한 추가

---------

Co-authored-by: DDING JOO <ddingsha9@teambind.co.kr>
Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>

* feature : 말하기 연습 기능 polly 서비스 권한 추가 (#514)

* feat: EnvConfig 유틸리티 추가 및 환경 변수 검증 적용

환경 변수 미설정 시 명확한 에러 메시지를 제공하는 EnvConfig 유틸리티를 추가하고,
기존 System.getenv 호출을 EnvConfig.getRequired/getOrDefault로 대체함.

- EnvConfig: getRequired, getOrDefault, getIntOrDefault, getLongOrDefault 메서드 제공
- Lambda Cold Start 시점에 환경 변수 누락을 조기 감지
- 기존 Config 클래스(WebSocketConfig, RoomTokenConfig) EnvConfig 사용으로 통일

Closes #403

* refactor: TestService submitTest 메서드 책임 분리

submitTest 메서드를 단일 책임 원칙에 맞게 리팩토링:
- gradeAnswers(): 답안 채점 및 결과 집계
- isAnswerCorrect(): 단일 답안 정답 여부 판단
- buildResultItem(): 결과 항목 생성
- saveTestResult(): 테스트 결과 저장
- GradingResult record: 채점 결과 캡슐화

TestService와 TestCommandService 모두 동일하게 적용

Closes #404

* refactor: 하드코딩된 설정값 환경 변수로 외부화

각 도메인별 Config 클래스를 생성하여 하드코딩된 값들을 환경 변수로 설정 가능하게 변경.
기본값이 있어 환경 변수 미설정 시에도 기존 동작 유지.

## 새로 추가된 Config 클래스
- GrammarConfig: SESSION_TTL_DAYS, MAX_HISTORY_MESSAGES, MAX_TOKENS 등
- GameConfig: TOTAL_ROUNDS, ROUND_TIME_LIMIT, QUICK_GUESS_THRESHOLD_MS
- VocabularyConfig: NEW_WORDS_COUNT, REVIEW_WORDS_COUNT, 상태 전이 임계값 등

## 지원하는 환경 변수
- GRAMMAR_SESSION_TTL_DAYS, GRAMMAR_MAX_HISTORY_MESSAGES, GRAMMAR_MAX_TOKENS
- GAME_TOTAL_ROUNDS, GAME_ROUND_TIME_LIMIT, GAME_QUICK_GUESS_THRESHOLD_MS
- VOCAB_NEW_WORDS_COUNT, VOCAB_REVIEW_WORDS_COUNT
- VOCAB_TRANSITION_TO_REVIEWING, VOCAB_TRANSITION_TO_MASTERED

Closes #406

* test: StudyLevel enum 단위 테스트 추가

* test: Difficulty enum 단위 테스트 추가

* test: StudyConfig 단위 테스트 추가

* test: EnvConfig 단위 테스트 추가

* test: PaginatedResult 단위 테스트 추가

* test: JsonUtil 단위 테스트 추가

* test: CursorUtil 단위 테스트 추가

* test: CommonErrorCode 단위 테스트 추가

* test: CommonException 단위 테스트 추가

* test: BadgeType enum 단위 테스트 추가

* test: BadgeKey 상수 단위 테스트 추가

* test: WordStatus enum 단위 테스트 추가

* test: TestType enum 단위 테스트 추가

* test: VocabularyConfig 단위 테스트 추가

* test: VocabKey 상수 단위 테스트 추가

* test: VocabularyErrorCode 단위 테스트 추가

* test: VocabularyException 단위 테스트 추가

* test: SpacedRepetitionContext 단위 테스트 추가

* test: GrammarLevel enum 단위 테스트 추가

* test: GrammarConfig 단위 테스트 추가

* test: GrammarErrorCode 단위 테스트 추가

* test: GrammarException 단위 테스트 추가

* test: GameStatus enum 단위 테스트 추가

* test: GameConfig 단위 테스트 추가

* test: ChattingErrorCode 단위 테스트 추가

* test: ChattingException 단위 테스트 추가

* fix: OPIc FeedbackResponse.java 문법 오류 수정

* style: AwsClients 코드 포맷팅

* style: EnvConfig 코드 포맷팅

* style: RoomTokenConfig 코드 포맷팅

* style: WebSocketConfig 코드 포맷팅

* style: JsonUtil 코드 포맷팅

* style: GameConfig 코드 포맷팅

* style: GrammarConfig 코드 포맷팅

* style: GrammarKey 코드 포맷팅

* style: GrammarErrorCode 코드 포맷팅

* style: GrammarException 코드 포맷팅

* style: BedrockGrammarCheckFactory 코드 포맷팅

* style: GrammarConversationService 코드 포맷팅

* style: FeedbackResponse 코드 포맷팅

* style: SessionReportResponse 코드 포맷팅

* style: SpeakingError 코드 포맷팅

* style: SpeakingErrorType 코드 포맷팅

* style: OPIcException 코드 포맷팅

* style: OPIcAnswer 코드 포맷팅

* style: OPIcQuestion 코드 포맷팅

* style: OPIcSession 코드 포맷팅

* style: OPIcRepository 코드 포맷팅

* style: FeedbackService 코드 포맷팅

* style: TranscribeProxyService 코드 포맷팅

* style: VocabularyConfig 코드 포맷팅

* style: DailyStudyCommandService 코드 포맷팅

* style: TestCommandService 코드 포맷팅

* style: TestService 코드 포맷팅

* style: CommonErrorCodeSpec 코드 포맷팅

* style: JsonUtilSpec 코드 포맷팅

* style: BadgeTypeSpec 코드 포맷팅

* style: ChattingErrorCodeSpec 코드 포맷팅

* style: GrammarLevelSpec 코드 포맷팅

* style: GrammarErrorCodeSpec 코드 포맷팅

* style: VocabularyErrorCodeSpec 코드 포맷팅

* feature : OPIc 세션관리 + 답변 처리 파이프라인 구현  (#413)

* feat : OPIc 질문 & 세션 관련 dto 생성

* refactor : @DynamoDbBean 주석 추가

* feat : 주제 + 소주제 + 레벨로 오픽 질문 조회 추가

* feat : OPIc 세션, 질문, 답변 종합 handler 구현

* feat : 오픽 주제, 소주제별 seed 데이터 추가

* refactor : Transcribe API KEY 환경변수명 수정

* refactor : Bedrock에 사용하는 클로드 모델 변경

* refactor : S3 Key 대신 Proxy에서 요청하는 Base64 값으로 변환

* feat: GAME_START, ROUND_END 메시지에 serverTime 추가

- broadcastGameStart(): serverTime, roundDuration 필드 추가
- broadcastRoundEnd(): serverTime, roundStartTime, roundDuration 필드 추가
- GameService.endRound(): data에 roundStartTime, roundDuration 포함
- 타이머 동기화 버그 수정을 위한 서버 시간 제공

* feat: WebSocketMessageHelper 유틸리티 클래스 추가

- domain 필드 포함 메시지 생성 헬퍼
- DOMAIN_CHAT, DOMAIN_GAME 상수 정의
- buildChatMessage(), buildGameMessage() 메서드

* feat: 모든 WebSocket 메시지에 domain 필드 추가

- ScoreUpdateMessage에 domain 필드 추가
- broadcastGameStart에 domain:"game" 추가
- broadcastRoundEnd에 domain:"game" 추가
- broadcastCorrectAnswerMessage에 domain:"game" 추가
- handleCommandResult 시스템 메시지에 domain:"game" 추가
- handleRegularMessage 채팅 메시지에 domain:"chat" 추가

Closes #426, #427

* feat: GameSession 모델 클래스 생성

- DynamoDB Enhanced Client 어노테이션 적용
- GSI1: roomId로 활성 게임 세션 조회 가능
- 게임 상태 관리용 헬퍼 메서드 포함

Closes #428

* feat: GameSessionRepository 구현

- 기본 CRUD (save, findById, delete)
- roomId로 활성/전체 게임 세션 조회
- 상태, 라운드, 점수 업데이트 메서드
- 정답자 추가, 힌트 사용, 게임 종료 처리

Closes #429

* refactor: ChatRoom에서 게임 필드 분리

- 게임 관련 필드 제거 (gameStatus, currentRound 등)
- activeGameSessionId 필드 추가
- 게임 상태는 GameSession으로 분리됨

Note: 의존 코드 수정은 #431에서 진행

Closes #430

* refactor: GameSession 기반으로 전체 게임 로직 리팩토링

- GameService: ChatRoom 대신 GameSession 사용
- GameStatsService: GameSession 매개변수로 변경
- CommandService: GameSession 기반 점수 조회
- GameHandler: GameSession 기반 REST API
- WebSocketMessageHandler: GameSession 기반 브로드캐스트
- GameStatusResponse, ScoreboardResponse: GameSession 매개변수

Closes #431

* feat: GameSessionHandler Lambda 및 게임 세션 API 구현

- POST /rooms/{roomId}/games - 게임 세션 생성
- GET /games/{gameSessionId} - 게임 상태 조회 (재접속용)
- POST /games/{gameSessionId}/start - 게임 시작
- POST /games/{gameSessionId}/stop - 게임 종료

모든 응답에 serverTime 포함 (타이머 동기화)
출제자에게만 currentWord 포함

Closes #432, #433

* feat: 게임 시작 7분 후 자동 종료 기능 구현

- GameConfig에 gameTimeLimit() 메서드 추가 (기본값: 420초)
- GameSchedulerClient 유틸리티 클래스 생성 (EventBridge Scheduler 연동)
- GameService에 스케줄 생성/취소 로직 추가
- GameAutoCloseHandler Lambda 함수 생성
- template.yaml에 Lambda, IAM Role, Schedule Group 추가

Closes #417

* fix : 메모리 증가 및 Lambda 응답 제한 시간 Cognito 트리거 제한시간과 동일하게 수정 (#439)

* feat: 캐치마인드 게임 방 분리 기능 구현 (#455)

- Room 타입 분리 (CHAT/GAME)
  - RoomType, RoomStatus enum 추가
  - ChatRoom 모델에 type, gameType, gameSettings, status, hostId 필드 추가
  - GameSettings 모델 추가

- 방 생성/조회 API 수정
  - CreateRoomRequest에 type, gameType, gameSettings 필드 추가
  - 방 목록 조회 시 type, gameType, status 필터 지원

- 게임 시작 조건 검증
  - GAME 타입 방에서만 게임 시작 가능 (GAME_007 에러)

- 게임 재시작 API 구현 (#452)
  - POST /rooms/{roomId}/game/restart 엔드포인트 추가
  - 방장만 재시작 가능 (GAME_009 에러)
  - 게임 진행 중 재시작 불가 (GAME_008 에러)

- 방장 변경 로직 구현 (#453)
  - 방장 퇴장 시 다음 멤버에게 자동 이전
  - 모든 멤버 퇴장 시 방 자동 삭제

- WebSocket 메시지 타입 추가 (#454)
  - ROOM_STATUS_CHANGE, HOST_CHANGE 메시지 타입 추가
  - WebSocketMessageHelper에 빌더 메서드 추가

- 테스트 추가
  - RoomType, RoomStatus enum 테스트
  - GameSettings 모델 테스트
  - ChattingErrorCode 테스트 업데이트

Related: #440, #441, #442, #443, #444, #445, #446
Closes: #447, #448, #449, #450, #451, #452, #453, #454

* feat: 참가자 닉네임 및 방장 변경 WebSocket 알림 구현 (#456)

- RoomParticipant DTO 추가 (userId, nickname, isHost)
- ChatRoomQueryService에 닉네임 조회 메서드 추가
  - getParticipantsWithNicknames(): 참가자 목록 + 닉네임
  - getHostNickname(): 방장 닉네임 조회
- ChatRoomHandler.getRoom() 응답에 participants, hostNickname 추가
- ChatRoomCommandService.leaveRoom()에서 방장 변경 시 WebSocket 브로드캐스트

Related: #440

* fix: ChatRoomFunction에 UserTable DynamoDB 권한 추가

- 참가자/방장 닉네임 조회를 위한 UserTable 읽기 권한 추가
- DynamoDBReadPolicy로 UserTable 접근 허용

Fixes #457

* fix: GameSettings에 @DynamoDbBean 어노테이션 추가

- DynamoDB Enhanced Client가 중첩 객체를 직렬화/역직렬화할 수 있도록 수정
- ChatRoom 저장/조회 시 GameSettings 변환 오류 해결

Fixes #457

* fix: ChatRoomFunction에 WEBSOCKET_ENDPOINT 환경변수 및 권한 추가

- leaveRoom에서 WebSocketBroadcaster 사용을 위한 환경변수 추가
- execute-api:ManageConnections 권한 추가

* fix: WebSocket Lambda 함수들에 WEBSOCKET_ENDPOINT 환경변수 추가

- WebSocketConnectFunction에 WEBSOCKET_ENDPOINT 추가
- WebSocketDisconnectFunction에 WEBSOCKET_ENDPOINT 추가
- execute-api:ManageConnections 권한 추가

* fix: Grammar WebSocket Lambda 환경 변수 및 권한 추가

- GrammarStreamingConnectFunction에 WEBSOCKET_ENDPOINT 환경 변수 추가
- GrammarStreamingDisconnectFunction에 WEBSOCKET_ENDPOINT 환경 변수 추가
- 두 함수에 execute-api:ManageConnections 권한 추가

* feat: GSI1SK 확장성 있는 재설계 및 DB 레벨 필터링

## 변경 사항

### GSI1SK 포맷 변경
- 기존: {level}#{createdAt}
- 신규: {type}#{gameType}#{status}#{level}#{createdAt}

### 지원 쿼리 패턴
- 전체 방: GSI1PK = "ROOMS"
- 게임방만: begins_with(GSI1SK, "GAME#")
- 캐치마인드만: begins_with(GSI1SK, "GAME#CATCHMIND#")
- 대기중 캐치마인드: begins_with(GSI1SK, "GAME#CATCHMIND#WAITING#")

### 파일 수정
- ChatRoomCommandService.java: 방 생성 시 새 GSI1SK 포맷 적용
- ChatRoomRepository.java: findByFilters() 메서드 추가, updateStatus() 메서드 추가
- ChatRoomQueryService.java: 메모리 필터링 제거, DB 레벨 필터링으로 변경
- GameService.java: 게임 시작/종료 시 방 상태 업데이트 (GSI1SK 포함)

### 마이그레이션
- scripts/migrate-gsi1sk.sh: 기존 데이터 마이그레이션 스크립트
- 37개 기존 방 마이그레이션 완료

* fix: increase stats query limit to 100 days

- Adjust maximum allowable limit for recent stats query from 30 to 100 days to support extended data range responses.

* feat: improve game round and connection management logic

- Added handling for game round timeout (`ROUND_TIMEOUT`) in WebSocketMessageHandler.
- Enhanced game start broadcast to include `currentWord` for the drawer only.
- Updated ConnectionRepository to remove duplicate user connections in the same room.
- Added `currentWordEnglish` to GameSession for better answer verification.
- Normalized ChatRoom levels to match database storage format.
- Updated template.yaml to include DynamoDBReadPolicy for VocabTable.

* refactor: 코드 정리 및 미사용 클래스 제거 (#459)

* refactor: remove unused WebSocketResponseUtil

* refactor: add AutoCloseable to WebSocketBroadcaster

* refactor: remove unused TestService

* refactor: remove unused WordService

* refactor: remove unused DailyStudyService

* refactor: remove unused UserWordService

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* fix: resolve N+1 query in StatsService

* refactor(all): DI 패턴 및 전략 패턴 적용 (#461)

- Repository, Service, Handler에 DI 생성자 추가 (테스트 용이성)
- BadgeService에 Strategy 패턴 적용 (뱃지 조건 검증 로직 분리)

* refactor: relocate and restructure seed data files

- Moved `question-homes.json` and `words.json` from subdirectories to `seed` folder.
- Updated file paths for better organization and clarity.

* chore: seed 데이터 폴더 구조 정리

* feat: add CI/CD pipeline configuration for CodePipeline

* fix: add SNS topic policy and DependsOn for notification rule

* fix: correct paths in buildspec.yml for CodeBuild

* fix: remove hardcoded JAVA_HOME, use runtime default

* fix: add gradle wrapper for CI/CD build

* fix: use single line sam package command with hardcoded bucket

* fix: use existing stack name group2-englishstudy-chatting

* fix: add missing WEBSOCKET_ENDPOINT env var to WebSocket connect functions

* docs: update FRONTEND-API-GUIDE with new RoomType/RoomStatus structure

* feat : WebSocket Connect, Disconnect 핸들러 & SpeakingConnecion 모델 구현

* feat : WebSocket 메시지 처리 handler, service 구현

* feat : WebSocket 연결 정보 Repository 구현

* fix: update WebSocketDisconnectHandler to use GameSession model

- Remove references to deleted ChatRoom game fields
- Use GameSessionRepository to finish active game sessions
- Use ChatRoomRepository.updateStatus() for room state management

* perf: optimize CI/CD build time

- Add pip cache for SAM CLI dependencies
- Enable Gradle parallel builds and build cache
- Add SAM build cache (.aws-sam)
- Use sam build --parallel --cached
- Skip SAM CLI install if already cached
- Remove unnecessary 'clean' to leverage cache

* feat: add custom CodeBuild Docker image with pre-installed tools

- Dockerfile with Java 21 + SAM CLI + Gradle pre-installed
- build-and-push.sh script for ECR deployment
- Updated buildspec.yml for custom image (removes SAM CLI install)
- Expected build time reduction: ~30-40 seconds

* feature : AI 영어 회화 연습 기능 (#468)

* feat : WebSocket Connect, Disconnect 핸들러 & SpeakingConnecion 모델 구현

* feat : WebSocket 메시지 처리 handler, service 구현

* feat : WebSocket 연결 정보 Repository 구현

* fix: remove typo in SpeakingConnectionRepository

* fix : 오타 수정

* chore: trigger build test with custom Docker image

* chore: remove unnecessary newlines and whitespace across WebSocket handlers and related classes

* chore: remove unnecessary newlines and whitespace across WebSocket handlers and related classes

* Release: 캐치마인드 게임 분리, AI 회화 연습, CI/CD 파이프라인 (#469)

* feature : OPIc 세션관리 + 답변 처리 파이프라인 구현  (#413)

* feat : OPIc 질문 & 세션 관련 dto 생성

* refactor : @DynamoDbBean 주석 추가

* feat : 주제 + 소주제 + 레벨로 오픽 질문 조회 추가

* feat : OPIc 세션, 질문, 답변 종합 handler 구현

* feat : 오픽 주제, 소주제별 seed 데이터 추가

* refactor : Transcribe API KEY 환경변수명 수정

* refactor : Bedrock에 사용하는 클로드 모델 변경

* refactor : S3 Key 대신 Proxy에서 요청하는 Base64 값으로 변환

* feat: GAME_START, ROUND_END 메시지에 serverTime 추가

- broadcastGameStart(): serverTime, roundDuration 필드 추가
- broadcastRoundEnd(): serverTime, roundStartTime, roundDuration 필드 추가
- GameService.endRound(): data에 roundStartTime, roundDuration 포함
- 타이머 동기화 버그 수정을 위한 서버 시간 제공

* feat: WebSocketMessageHelper 유틸리티 클래스 추가

- domain 필드 포함 메시지 생성 헬퍼
- DOMAIN_CHAT, DOMAIN_GAME 상수 정의
- buildChatMessage(), buildGameMessage() 메서드

* feat: 모든 WebSocket 메시지에 domain 필드 추가

- ScoreUpdateMessage에 domain 필드 추가
- broadcastGameStart에 domain:"game" 추가
- broadcastRoundEnd에 domain:"game" 추가
- broadcastCorrectAnswerMessage에 domain:"game" 추가
- handleCommandResult 시스템 메시지에 domain:"game" 추가
- handleRegularMessage 채팅 메시지에 domain:"chat" 추가

Closes #426, #427

* feat: GameSession 모델 클래스 생성

- DynamoDB Enhanced Client 어노테이션 적용
- GSI1: roomId로 활성 게임 세션 조회 가능
- 게임 상태 관리용 헬퍼 메서드 포함

Closes #428

* feat: GameSessionRepository 구현

- 기본 CRUD (save, findById, delete)
- roomId로 활성/전체 게임 세션 조회
- 상태, 라운드, 점수 업데이트 메서드
- 정답자 추가, 힌트 사용, 게임 종료 처리

Closes #429

* refactor: ChatRoom에서 게임 필드 분리

- 게임 관련 필드 제거 (gameStatus, currentRound 등)
- activeGameSessionId 필드 추가
- 게임 상태는 GameSession으로 분리됨

Note: 의존 코드 수정은 #431에서 진행

Closes #430

* refactor: GameSession 기반으로 전체 게임 로직 리팩토링

- GameService: ChatRoom 대신 GameSession 사용
- GameStatsService: GameSession 매개변수로 변경
- CommandService: GameSession 기반 점수 조회
- GameHandler: GameSession 기반 REST API
- WebSocketMessageHandler: GameSession 기반 브로드캐스트
- GameStatusResponse, ScoreboardResponse: GameSession 매개변수

Closes #431

* feat: GameSessionHandler Lambda 및 게임 세션 API 구현

- POST /rooms/{roomId}/games - 게임 세션 생성
- GET /games/{gameSessionId} - 게임 상태 조회 (재접속용)
- POST /games/{gameSessionId}/start - 게임 시작
- POST /games/{gameSessionId}/stop - 게임 종료

모든 응답에 serverTime 포함 (타이머 동기화)
출제자에게만 currentWord 포함

Closes #432, #433

* feat: 게임 시작 7분 후 자동 종료 기능 구현

- GameConfig에 gameTimeLimit() 메서드 추가 (기본값: 420초)
- GameSchedulerClient 유틸리티 클래스 생성 (EventBridge Scheduler 연동)
- GameService에 스케줄 생성/취소 로직 추가
- GameAutoCloseHandler Lambda 함수 생성
- template.yaml에 Lambda, IAM Role, Schedule Group 추가

Closes #417

* fix : 메모리 증가 및 Lambda 응답 제한 시간 Cognito 트리거 제한시간과 동일하게 수정 (#439)

* feat: 캐치마인드 게임 방 분리 기능 구현 (#455)

- Room 타입 분리 (CHAT/GAME)
  - RoomType, RoomStatus enum 추가
  - ChatRoom 모델에 type, gameType, gameSettings, status, hostId 필드 추가
  - GameSettings 모델 추가

- 방 생성/조회 API 수정
  - CreateRoomRequest에 type, gameType, gameSettings 필드 추가
  - 방 목록 조회 시 type, gameType, status 필터 지원

- 게임 시작 조건 검증
  - GAME 타입 방에서만 게임 시작 가능 (GAME_007 에러)

- 게임 재시작 API 구현 (#452)
  - POST /rooms/{roomId}/game/restart 엔드포인트 추가
  - 방장만 재시작 가능 (GAME_009 에러)
  - 게임 진행 중 재시작 불가 (GAME_008 에러)

- 방장 변경 로직 구현 (#453)
  - 방장 퇴장 시 다음 멤버에게 자동 이전
  - 모든 멤버 퇴장 시 방 자동 삭제

- WebSocket 메시지 타입 추가 (#454)
  - ROOM_STATUS_CHANGE, HOST_CHANGE 메시지 타입 추가
  - WebSocketMessageHelper에 빌더 메서드 추가

- 테스트 추가
  - RoomType, RoomStatus enum 테스트
  - GameSettings 모델 테스트
  - ChattingErrorCode 테스트 업데이트

Related: #440, #441, #442, #443, #444, #445, #446
Closes: #447, #448, #449, #450, #451, #452, #453, #454

* feat: 참가자 닉네임 및 방장 변경 WebSocket 알림 구현 (#456)

- RoomParticipant DTO 추가 (userId, nickname, isHost)
- ChatRoomQueryService에 닉네임 조회 메서드 추가
  - getParticipantsWithNicknames(): 참가자 목록 + 닉네임
  - getHostNickname(): 방장 닉네임 조회
- ChatRoomHandler.getRoom() 응답에 participants, hostNickname 추가
- ChatRoomCommandService.leaveRoom()에서 방장 변경 시 WebSocket 브로드캐스트

Related: #440

* fix: ChatRoomFunction에 UserTable DynamoDB 권한 추가

- 참가자/방장 닉네임 조회를 위한 UserTable 읽기 권한 추가
- DynamoDBReadPolicy로 UserTable 접근 허용

Fixes #457

* fix: GameSettings에 @DynamoDbBean 어노테이션 추가

- DynamoDB Enhanced Client가 중첩 객체를 직렬화/역직렬화할 수 있도록 수정
- ChatRoom 저장/조회 시 GameSettings 변환 오류 해결

Fixes #457

* fix: ChatRoomFunction에 WEBSOCKET_ENDPOINT 환경변수 및 권한 추가

- leaveRoom에서 WebSocketBroadcaster 사용을 위한 환경변수 추가
- execute-api:ManageConnections 권한 추가

* fix: WebSocket Lambda 함수들에 WEBSOCKET_ENDPOINT 환경변수 추가

- WebSocketConnectFunction에 WEBSOCKET_ENDPOINT 추가
- WebSocketDisconnectFunction에 WEBSOCKET_ENDPOINT 추가
- execute-api:ManageConnections 권한 추가

* fix: Grammar WebSocket Lambda 환경 변수 및 권한 추가

- GrammarStreamingConnectFunction에 WEBSOCKET_ENDPOINT 환경 변수 추가
- GrammarStreamingDisconnectFunction에 WEBSOCKET_ENDPOINT 환경 변수 추가
- 두 함수에 execute-api:ManageConnections 권한 추가

* feat: GSI1SK 확장성 있는 재설계 및 DB 레벨 필터링

## 변경 사항

### GSI1SK 포맷 변경
- 기존: {level}#{createdAt}
- 신규: {type}#{gameType}#{status}#{level}#{createdAt}

### 지원 쿼리 패턴
- 전체 방: GSI1PK = "ROOMS"
- 게임방만: begins_with(GSI1SK, "GAME#")
- 캐치마인드만: begins_with(GSI1SK, "GAME#CATCHMIND#")
- 대기중 캐치마인드: begins_with(GSI1SK, "GAME#CATCHMIND#WAITING#")

### 파일 수정
- ChatRoomCommandService.java: 방 생성 시 새 GSI1SK 포맷 적용
- ChatRoomRepository.java: findByFilters() 메서드 추가, updateStatus() 메서드 추가
- ChatRoomQueryService.java: 메모리 필터링 제거, DB 레벨 필터링으로 변경
- GameService.java: 게임 시작/종료 시 방 상태 업데이트 (GSI1SK 포함)

### 마이그레이션
- scripts/migrate-gsi1sk.sh: 기존 데이터 마이그레이션 스크립트
- 37개 기존 방 마이그레이션 완료

* fix: increase stats query limit to 100 days

- Adjust maximum allowable limit for recent stats query from 30 to 100 days to support extended data range responses.

* feat: improve game round and connection management logic

- Added handling for game round timeout (`ROUND_TIMEOUT`) in WebSocketMessageHandler.
- Enhanced game start broadcast to include `currentWord` for the drawer only.
- Updated ConnectionRepository to remove duplicate user connections in the same room.
- Added `currentWordEnglish` to GameSession for better answer verification.
- Normalized ChatRoom levels to match database storage format.
- Updated template.yaml to include DynamoDBReadPolicy for VocabTable.

* refactor: 코드 정리 및 미사용 클래스 제거 (#459)

* refactor: remove unused WebSocketResponseUtil

* refactor: add AutoCloseable to WebSocketBroadcaster

* refactor: remove unused TestService

* refactor: remove unused WordService

* refactor: remove unused DailyStudyService

* refactor: remove unused UserWordService

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* fix: resolve N+1 query in StatsService

* refactor(all): DI 패턴 및 전략 패턴 적용 (#461)

- Repository, Service, Handler에 DI 생성자 추가 (테스트 용이성)
- BadgeService에 Strategy 패턴 적용 (뱃지 조건 검증 로직 분리)

* refactor: relocate and restructure seed data files

- Moved `question-homes.json` and `words.json` from subdirectories to `seed` folder.
- Updated file paths for better organization and clarity.

* chore: seed 데이터 폴더 구조 정리

* feat: add CI/CD pipeline configuration for CodePipeline

* fix: add SNS topic policy and DependsOn for notification rule

* fix: correct paths in buildspec.yml for CodeBuild

* fix: remove hardcoded JAVA_HOME, use runtime default

* fix: add gradle wrapper for CI/CD build

* fix: use single line sam package command with hardcoded bucket

* fix: use existing stack name group2-englishstudy-chatting

* fix: add missing WEBSOCKET_ENDPOINT env var to WebSocket connect functions

* docs: update FRONTEND-API-GUIDE with new RoomType/RoomStatus structure

* fix: update WebSocketDisconnectHandler to use GameSession model

- Remove references to deleted ChatRoom game fields
- Use GameSessionRepository to finish active game sessions
- Use ChatRoomRepository.updateStatus() for room state management

* perf: optimize CI/CD build time

- Add pip cache for SAM CLI dependencies
- Enable Gradle parallel builds and build cache
- Add SAM build cache (.aws-sam)
- Use sam build --parallel --cached
- Skip SAM CLI install if already cached
- Remove unnecessary 'clean' to leverage cache

* feat: add custom CodeBuild Docker image with pre-installed tools

- Dockerfile with Java 21 + SAM CLI + Gradle pre-installed
- build-and-push.sh script for ECR deployment
- Updated buildspec.yml for custom image (removes SAM CLI install)
- Expected build time reduction: ~30-40 seconds

* feature : AI 영어 회화 연습 기능 (#468)

* feat : WebSocket Connect, Disconnect 핸들러 & SpeakingConnecion 모델 구현

* feat : WebSocket 메시지 처리 handler, service 구현

* feat : WebSocket 연결 정보 Repository 구현

* fix: remove typo in SpeakingConnectionRepository

* chore: trigger build test with custom Docker image

* chore: remove unnecessary newlines and whitespace across WebSocket handlers and related classes

* chore: remove unnecessary newlines and whitespace across WebSocket handlers and related classes

---------

Co-authored-by: hyein Heo <128613248+hye-inA@users.noreply.github.com>

* refactor : websocket -> rest api 전환

* feat : speaking handler REST로 교체

* feat : speaking 관련 dto 생성

* refacotor : 기존 service 코드 로직 재사용 및 repository 리펙토링

* fix: add CORS headers to API Gateway error responses (#479)

API Gateway의 인증 실패 등 에러 응답에 CORS 헤더가 누락되어
CloudFront를 통한 프론트엔드 요청이 차단되는 문제 수정

- UNAUTHORIZED (401) 응답에 CORS 헤더 추가
- ACCESS_DENIED (403) 응답에 CORS 헤더 추가
- DEFAULT_4XX/5XX 응답에 CORS 헤더 추가
- EXPIRED_TOKEN 응답에 CORS 헤더 추가

* feat(news): 뉴스 도메인 기반 구조 구축 (#385)

- NewsCategory, QuizType enum 추가
- NewsKey 상수 클래스 추가
- NewsErrorCode 예외 클래스 추가
- NewsArticle, KeywordInfo, QuizQuestion 모델 추가
- NewsArticleRepository CRUD 구현
- NewsTable DynamoDB 테이블 정의
- CORS GatewayResponses 설정 추가

* feat(news): 뉴스 수집 파이프라인 구현 (#386)

- NewsApiClient: NewsAPI 연동 서비스
- RssFeedParser: RSS 피드 파싱 (BBC, VOA, NPR)
- NewsDuplicateChecker: URL 기반 중복 필터링
- NewsCollectorService: 수집 오케스트레이션
- NewsCollectionHandler: Lambda 핸들러
- EventBridge 스케줄러: 매일 18시 KST 실행

* refactor(news): NewsAPI 제거, RSS만 사용

- NewsApiClient 삭제
- SSM Parameter 의존성 제거
- RSS 소스당 7개씩 수집 (BBC, VOA, NPR = 약 21개/일)

* feat(news): AI 뉴스 분석 시스템 구현 (#387)

- NewsAnalysisService: AI 분석 통합 서비스
  - Bedrock: CEFR 난이도 분석 (A1~C2)
  - Bedrock: 3줄 요약 + 퀴즈 3문제 생성
  - Comprehend: 핵심 키워드 추출
- NewsCollectorService: 수집 시 자동 분석 연동
- GSI1/GSI2 키 자동 설정 (레벨별, 카테고리별 조회)

* feat(news): 뉴스 학습 API 구현 (#388)

- NewsQueryService: 뉴스 조회 서비스
- NewsHandler: API 핸들러
  - GET /news - 목록 조회 (level, category 필터)
  - GET /news/today - 오늘의 뉴스
  - GET /news/recommended - 내 레벨 맞춤 추천
  - GET /news/{articleId} - 상세 조회 (조회수 증가)
- template.yaml: NewsFunction Lambda 추가

* feat(news): 뉴스 학습 부가 기능 구현 (#389)

- 읽기 완료 기록 API (POST /news/{articleId}/read)
- 북마크 토글 API (POST /news/{articleId}/bookmark)
- 북마크 목록 조회 API (GET /news/bookmarks)
- 학습 통계 조회 API (GET /news/stats)
- TTS 오디오 URL 조회 API (GET /news/{articleId}/audio)
- UserNewsRecord 모델 추가
- UserNewsRepository 추가
- NewsLearningService 추가

* feat(news): 복합 퀴즈 시스템 구현 (#471)

- 퀴즈 조회 API (GET /news/{articleId}/quiz)
- 퀴즈 제출 API (POST /news/{articleId}/quiz)
- 퀴즈 기록 조회 API (GET /news/quiz/history)
- NewsQuizResult 모델 추가
- QuizAnswerResult 모델 추가
- NewsQuizRepository 추가
- NewsQuizService 추가

* feat(news): 단어 수집 & Vocabulary 연동 구현 (#472)

- 단어 수집 API (POST /news/{articleId}/words)
- 수집 단어 목록 API (GET /news/words)
- 단어 상세 조회 API (GET /news/{articleId}/words/{word})
- 단어 삭제 API (DELETE /news/{articleId}/words/{word})
- Vocabulary 연동 API (POST /news/words/{word}/sync)
- NewsWordCollect 모델 추가
- NewsWordRepository 추가
- NewsWordService 추가

* feat: add multi-environment deployment support (dev/test/prod)

* fix: update buildspec.yml to deploy prod environment with parameter overrides

* feat(news): 뉴스 도메인 기반 구조 구축 (#385)

- NewsCategory, QuizType enum 추가
- NewsKey 상수 클래스 추가
- NewsErrorCode 예외 클래스 추가
- NewsArticle, KeywordInfo, QuizQuestion 모델 추가
- NewsArticleRepository CRUD 구현
- NewsTable DynamoDB 테이블 정의
- CORS GatewayResponses 설정 추가

* feat(news): 뉴스 수집 파이프라인 구현 (#386)

- NewsApiClient: NewsAPI 연동 서비스
- RssFeedParser: RSS 피드 파싱 (BBC, VOA, NPR)
- NewsDuplicateChecker: URL 기반 중복 필터링
- NewsCollectorService: 수집 오케스트레이션
- NewsCollectionHandler: Lambda 핸들러
- EventBridge 스케줄러: 매일 18시 KST 실행

* refactor(news): NewsAPI 제거, RSS만 사용

- NewsApiClient 삭제
- SSM Parameter 의존성 제거
- RSS 소스당 7개씩 수집 (BBC, VOA, NPR = 약 21개/일)

* feat(news): AI 뉴스 분석 시스템 구현 (#387)

- NewsAnalysisService: AI 분석 통합 서비스
  - Bedrock: CEFR 난이도 분석 (A1~C2)
  - Bedrock: 3줄 요약 + 퀴즈 3문제 생성
  - Comprehend: 핵심 키워드 추출
- NewsCollectorService: 수집 시 자동 분석 연동
- GSI1/GSI2 키 자동 설정 (레벨별, 카테고리별 조회)

* feat(news): 뉴스 학습 API 구현 (#388)

- NewsQueryService: 뉴스 조회 서비스
- NewsHandler: API 핸들러
  - GET /news - 목록 조회 (level, category 필터)
  - GET /news/today - 오늘의 뉴스
  - GET /news/recommended - 내 레벨 맞춤 추천
  - GET /news/{articleId} - 상세 조회 (조회수 증가)
- template.yaml: NewsFunction Lambda 추가

* feat(news): 뉴스 학습 부가 기능 구현 (#389)

- 읽기 완료 기록 API (POST /news/{articleId}/read)
- 북마크 토글 API (POST /news/{articleId}/bookmark)
- 북마크 목록 조회 API (GET /news/bookmarks)
- 학습 통계 조회 API (GET /news/stats)
- TTS 오디오 URL 조회 API (GET /news/{articleId}/audio)
- UserNewsRecord 모델 추가
- UserNewsRepository 추가
- NewsLearningService 추가

* feat(news): 복합 퀴즈 시스템 구현 (#471)

- 퀴즈 조회 API (GET /news/{articleId}/quiz)
- 퀴즈 제출 API (POST /news/{articleId}/quiz)
- 퀴즈 기록 조회 API (GET /news/quiz/history)
- NewsQuizResult 모델 추가
- QuizAnswerResult 모델 추가
- NewsQuizRepository 추가
- NewsQuizService 추가

* feat(news): 단어 수집 & Vocabulary 연동 구현 (#472)

- 단어 수집 API (POST /news/{articleId}/words)
- 수집 단어 목록 API (GET /news/words)
- 단어 상세 조회 API (GET /news/{articleId}/words/{word})
- 단어 삭제 API (DELETE /news/{articleId}/words/{word})
- Vocabulary 연동 API (POST /news/words/{word}/sync)
- NewsWordCollect 모델 추가
- NewsWordRepository 추가
- NewsWordService 추가

* feat: add multi-environment deployment support (dev/test/prod)

* fix: update buildspec.yml to deploy prod environment with parameter overrides

* refactor : AI 말하기 Websocket 구현 -> REST API 구현으로 리팩토링 (#490)

* feat : WebSocket Connect, Disconnect 핸들러 & SpeakingConnecion 모델 구현

* feat : WebSocket 메시지 처리 handler, service 구현

* feat : WebSocket 연결 정보 Repository 구현

* fix : 오타 수정

* refactor : websocket -> rest api 전환

* feat : speaking handler REST로 교체

* feat : speaking 관련 dto 생성

* refacotor : 기존 service 코드 로직 재사용 및 repository 리펙토링

* fix: revert buildspec.yml to build-only for CloudFormation deploy stage

* fix: revert buildspec.yml to build-only for CloudFormation deploy stage

* fix: update all API Gateway StageName to use Environment parameter

* fix: correct VocabularyTable and ContentBucket references in NewsFunction

* fix: correct VocabularyTable and ContentBucket references in NewsFunction

* fix: add stack name prefix to GameScheduleGroup and daily-stats schedule to avoid conflicts

* fix: add stack name prefix to GameScheduleGroup and daily-stats schedule to avoid conflicts

* feat: add support for existing Cognito User Pool reuse across environments

* fix: add conditional Cognito ARN reference in API Gateway Authorizer

* fix: remove Cognito resources completely, use existing Cognito only

* fix: remove Cognito resources completely, use existing Cognito only

* feat : speaking rest API 람다 함수 추가

* feat: add S3 bucket resource and fix environment-specific endpoints

- Add ContentBucket S3 resource for content storage
- Replace hardcoded /dev with ${Environment} in all WebSocket endpoints
- Update Output URLs to use dynamic environment stage


* fix: add stack name prefix to news-collection schedule name

Prevent EventBridge rule name conflicts across environments


* fix: add X-Requested-With and Accept headers to CORS config

Enable additional headers for CloudFront CORS compatibility


* fix: use environment variable for S3 bucket URLs

Replace hardcoded bucket name with BUCKET_NAME env var for multi-env support:
- PreSignUpHandler: dynamic default profile URL
- PostConfirmationHandler: dynamic default profile URL
- UserService: dynamic default profile URL
- BadgeType: dynamic badge image base URL


* fix: disable authorizer for CORS preflight requests

Add AddDefaultAuthorizerToCorsPreflight: false to prevent
Cognito Authorizer from blocking OPTIONS requests


* feat : speaking REST API 람다 함수 추가  (#491)

* feature : OPIc 세션관리 + 답변 처리 파이프라인 구현  (#413)

* feat : OPIc 질문 & 세션 관련 dto 생성

* refactor : @DynamoDbBean 주석 추가

* feat : 주제 + 소주제 + 레벨로 오픽 질문 조회 추가

* feat : OPIc 세션, 질문, 답변 종합 handler 구현

* feat : 오픽 주제, 소주제별 seed 데이터 추가

* refactor : Transcribe API KEY 환경변수명 수정

* refactor : Bedrock에 사용하는 클로드 모델 변경

* refactor : S3 Key 대신 Proxy에서 요청하는 Base64 값으로 변환

* feat: GAME_START, ROUND_END 메시지에 serverTime 추가

- broadcastGameStart(): serverTime, roundDuration 필드 추가
- broadcastRoundEnd(): serverTime, roundStartTime, roundDuration 필드 추가
- GameService.endRound(): data에 roundStartTime, roundDuration 포함
- 타이머 동기화 버그 수정을 위한 서버 시간 제공

* feat: WebSocketMessageHelper 유틸리티 클래스 추가

- domain 필드 포함 메시지 생성 헬퍼
- DOMAIN_CHAT, DOMAIN_GAME 상수 정의
- buildChatMessage(), buildGameMessage() 메서드

* feat: 모든 WebSocket 메시지에 domain 필드 추가

- ScoreUpdateMessage에 domain 필드 추가
- broadcastGameStart에 domain:"game" 추가
- broadcastRoundEnd에 domain:"game" 추가
- broadcastCorrectAnswerMessage에 domain:"game" 추가
- handleCommandResult 시스템 메시지에 domain:"game" 추가
- handleRegularMessage 채팅 메시지에 domain:"chat" 추가

Closes #426, #427

* feat: GameSession 모델 클래스 생성

- DynamoDB Enhanced Client 어노테이션 적용
- GSI1: roomId로 활성 게임 세션 조회 가능
- 게임 상태 관리용 헬퍼 메서드 포함

Closes #428

* feat: GameSessionRepository 구현

- 기본 CRUD (save, findById, delete)
- roomId로 활성/전체 게임 세션 조회
- 상태, 라운드, 점수 업데이트 메서드
- 정답자 추가, 힌트 사용, 게임 종료 처리

Closes #429

* refactor: ChatRoom에서 게임 필드 분리

- 게임 관련 필드 제거 (gameStatus, currentRound 등)
- activeGameSessionId 필드 추가
- 게임 상태는 GameSession으로 분리됨

Note: 의존 코드 수정은 #431에서 진행

Closes #430

* refactor: GameSession 기반으로 전체 게임 로직 리팩토링

- GameService: ChatRoom 대신 GameSession 사용
- GameStatsService: GameSession 매개변수로 변경
- CommandService: GameSession 기반 점수 조회
- GameHandler: GameSession 기반 REST API
- WebSocketMessageHandler: GameSession 기반 브로드캐스트
- GameStatusResponse, ScoreboardResponse: GameSession 매개변수

Closes #431

* feat: GameSessionHandler Lambda 및 게임 세션 API 구현

- POST /rooms/{roomId}/games - 게임 세션 생성
- GET /games/{gameSessionId} - 게임 상태 조회 (재접속용)
- POST /games/{gameSessionId}/start - 게임 시작
- POST /games/{gameSessionId}/stop - 게임 종료

모든 응답에 serverTime 포함 (타이머 동기화)
출제자에게만 currentWord 포함

Closes #432, #433

* feat: 게임 시작 7분 후 자동 종료 기능 구현

- GameConfig에 gameTimeLimit() 메서드 추가 (기본값: 420초)
- GameSchedulerClient 유틸리티 클래스 생성 (EventBridge Scheduler 연동)
- GameService에 스케줄 생성/취소 로직 추가
- GameAutoCloseHandler Lambda 함수 생성
- template.yaml에 Lambda, IAM Role, Schedule Group 추가

Closes #417

* fix : 메모리 증가 및 Lambda 응답 제한 시간 Cognito 트리거 제한시간과 동일하게 수정 (#439)

* feat: 캐치마인드 게임 방 분리 기능 구현 (#455)

- Room 타입 분리 (CHAT/GAME)
  - RoomType, RoomStatus enum 추가
  - ChatRoom 모델에 type, gameType, gameSettings, status, hostId 필드 추가
  - GameSettings 모델 추가

- 방 생성/조회 API 수정
  - CreateRoomRequest에 type, gameType, gameSettings 필드 추가
  - 방 목록 조회 시 type, gameType, status 필터 지원

- 게임 시작 조건 검증
  - GAME 타입 방에서만 게임 시작 가능 (GAME_007 에러)

- 게임 재시작 API 구현 (#452)
  - POST /rooms/{roomId}/game/restart 엔드포인트 추가
  - 방장만 재시작 가능 (GAME_009 에러)
  - 게임 진행 중 재시작 불가 (GAME_008 에러)

- 방장 변경 로직 구현 (#453)
  - 방장 퇴장 시 다음 멤버에게 자동 이전
  - 모든 멤버 퇴장 시 방 자동 삭제

- WebSocket 메시지 타입 추가 (#454)
  - ROOM_STATUS_CHANGE, HOST_CHANGE 메시지 타입 추가
  - WebSocketMessageHelper에 빌더 메서드 추가

- 테스트 추가
  - RoomType, RoomStatus enum 테스트
  - GameSettings 모델 테스트
  - ChattingErrorCode 테스트 업데이트

Related: #440, #441, #442, #443, #444, #445, #446
Closes: #447, #448, #449, #450, #451, #452, #453, #454

* feat: 참가자 닉네임 및 방장 변경 WebSocket 알림 구현 (#456)

- RoomParticipant DTO 추가 (userId, nickname, isHost)
- ChatRoomQueryService에 닉네임 조회 메서드 추가
  - getParticipantsWithNicknames(): 참가자 목록 + 닉네임
  - getHostNickname(): 방장 닉네임 조회
- ChatRoomHandler.getRoom() 응답에 participants, hostNickname 추가
- ChatRoomCommandService.leaveRoom()에서 방장 변경 시 WebSocket 브로드캐스트

Related: #440

* fix: ChatRoomFunction에 UserTable DynamoDB 권한 추가

- 참가자/방장 닉네임 조회를 위한 UserTable 읽기 권한 추가
- DynamoDBReadPolicy로 UserTable 접근 허용

Fixes #457

* fix: GameSettings에 @DynamoDbBean 어노테이션 추가

- DynamoDB Enhanced Client가 중첩 객체를 직렬화/역직렬화할 수 있도록 수정
- ChatRoom 저장/조회 시 GameSettings 변환 오류 해결

Fixes #457

* fix: ChatRoomFunction에 WEBSOCKET_ENDPOINT 환경변수 및 권한 추가

- leaveRoom에서 WebSocketBroadcaster 사용을 위한 환경변수 추가
- execute-api:ManageConnections 권한 추가

* fix: WebSocket Lambda 함수들에 WEBSOCKET_ENDPOINT 환경변수 추가

- WebSocketConnectFunction에 WEBSOCKET_ENDPOINT 추가
- WebSocketDisconnectFunction에 WEBSOCKET_ENDPOINT 추가
- execute-api:ManageConnections 권한 추가

* fix: Grammar WebSocket Lambda 환경 변수 및 권한 추가

- GrammarStreamingConnectFunction에 WEBSOCKET_ENDPOINT 환경 변수 추가
- GrammarStreamingDisconnectFunction에 WEBSOCKET_ENDPOINT 환경 변수 추가
- 두 함수에 execute-api:ManageConnections 권한 추가

* feat: GSI1SK 확장성 있는 재설계 및 DB 레벨 필터링

- 기존: {level}#{createdAt}
- 신규: {type}#{gameType}#{status}#{level}#{createdAt}

- 전체 방: GSI1PK = "ROOMS"
- 게임방만: begins_with(GSI1SK, "GAME#")
- 캐치마인드만: begins_with(GSI1SK, "GAME#CATCHMIND#")
- 대기중 캐치마인드: begins_with(GSI1SK, "GAME#CATCHMIND#WAITING#")

- ChatRoomCommandService.java: 방 생성 시 새 GSI1SK 포맷 적용
- ChatRoomRepository.java: findByFilters() 메서드 추가, updateStatus() 메서드 추가
- ChatRoomQueryService.java: 메모리 필터링 제거, DB 레벨 필터링으로 변경
- GameService.java: 게임 시작/종료 시 방 상태 업데이트 (GSI1SK 포함)

- scripts/migrate-gsi1sk.sh: 기존 데이터 마이그레이션 스크립트
- 37개 기존 방 마이그레이션 완료

* fix: increase stats query limit to 100 days

- Adjust maximum allowable limit for recent stats query from 30 to 100 days to support extended data range responses.

* feat: improve game round and connection management logic

- Added handling for game round timeout (`ROUND_TIMEOUT`) in WebSocketMessageHandler.
- Enhanced game start broadcast to include `currentWord` for the drawer only.
- Updated ConnectionRepository to remove duplicate user connections in the same room.
- Added `currentWordEnglish` to GameSession for better answer verification.
- Normalized ChatRoom levels to match database storage format.
- Updated template.yaml to include DynamoDBReadPolicy for VocabTable.

* refactor: 코드 정리 및 미사용 클래스 제거 (#459)

* refactor: remove unused WebSocketResponseUtil

* refactor: add AutoCloseable to WebSocketBroadcaster

* refactor: remove unused TestService

* refactor: remove unused WordService

* refactor: remove unused DailyStudyService

* refactor: remove unused UserWordService

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* fix: resolve N+1 query in StatsService

* refactor(all): DI 패턴 및 전략 패턴 적용 (#461)

- Repository, Service, Handler에 DI 생성자 추가 (테스트 용이성)
- BadgeService에 Strategy 패턴 적용 (뱃지 조건 검증 로직 분리)

* refactor: relocate and restructure seed data files

- Moved `question-homes.json` and `words.json` from subdirectories to `seed` folder.
- Updated file paths for better organization and clarity.

* chore: seed 데이터 폴더 구조 정리

* feat: add CI/CD pipeline configuration for CodePipeline

* fix: add SNS topic policy and DependsOn for notification rule

* fix: correct paths in buildspec.yml for CodeBuild

* fix: remove hardcoded JAVA_HOME, use runtime default

* fix: add gradle wrapper for CI/CD build

* fix: use single line sam package command with hardcoded bucket

* fix: use existing stack name group2-englishstudy-chatting

* fix: add missing WEBSOCKET_ENDPOINT env var to WebSocket connect functions

* docs: update FRONTEND-API-GUIDE with new RoomType/RoomStatus structure

* feat : WebSocket Connect, Disconnect 핸들러 & SpeakingConnecion 모델 구현

* feat : WebSocket 메시지 처리 handler, service 구현

* feat : WebSocket 연결 정보 Repository 구현

* fix: update WebSocketDisconnectHandler to use GameSession model

- Remove references to deleted ChatRoom game fields
- Use GameSessionRepository to finish active game sessions
- Use ChatRoomRepository.updateStatus() for room state management

* perf: optimize CI/CD build time

- Add pip cache for SAM CLI dependencies
- Enable Gradle parallel builds and build cache
- Add SAM build cache (.aws-sam)
- Use sam build --parallel --cached
- Skip SAM CLI install if already cached
- Remove unnecessary 'clean' to leverage cache

* feat: add custom CodeBuild Docker image with pre-installed tools

- Dockerfile with Java 21 + SAM CLI + Gradle pre-installed
- build-and-push.sh script for ECR deployment
- Updated buildspec.yml for custom image (removes SAM CLI install)
- Expected build time reduction: ~30-40 seconds

* feature : AI 영어 회화 연습 기능 (#468)

* feat : WebSocket Connect, Disconnect 핸들러 & SpeakingConnecion 모델 구현

* feat : WebSocket 메시지 처리 handler, service 구현

* feat : WebSocket 연결 정보 Repository 구현

* fix: remove typo in SpeakingConnectionRepository

* fix : 오타 수정

* chore: trigger build test with custom Docker image

* chore: remove unnecessary newlines and whitespace across WebSocket handlers and related classes

* chore: remove unnecessary newlines and whitespace across WebSocket handlers and related classes

* refactor : websocket -> rest api 전환

* feat : speaking handler REST로 교체

* feat : speaking 관련 dto 생성

* refacotor : 기존 service 코드 로직 재사용 및 repository 리펙토링

* fix: add CORS headers to API Gateway error responses (#479)

API Gateway의 인증 실패 등 에러 응답에 CORS 헤더가 누락되어
CloudFront를 통한 프론트엔드 요청이 차단되는 문제 수정

- UNAUTHORIZED (401) 응답에 CORS 헤더 추가
- ACCESS_DENIED (403) 응답에 CORS 헤더 추가
- DEFAULT_4XX/5XX 응답에 CORS 헤더 추가
- EXPIRED_TOKEN 응답에 CORS 헤더 추가

* feat : speaking rest API 람다 함수 추가

---------

Co-authored-by: ddingjoo <ddingsha9@teambind.co.kr>

* refactor : speaking service 재사용

* refactor : AI 영어 회화 연습 코드 리팩토링

* feature : test 벡엔드 서버에 AI 말하기 연습 기능 배포 (#492)

* feat : WebSocket Connect, Disconnect 핸들러 & SpeakingConnecion 모델 구현

* feat : WebSocket 메시지 처리 handler, service 구현

* feat : WebSocket 연결 정보 Repository 구현

* fix : 오타 수정

* refactor : websocket -> rest api 전환

* feat : speaking handler REST로 교체

* feat : speaking 관련 dto 생성

* refacotor : 기존 service 코드 로직 재사용 및 repository 리펙토링

* feat : speaking rest API 람다 함수 추가

* refactor : speaking service 재사용

* refactor : AI 영어 회화 연습 코드 리팩토링

---------

Co-authored-by: DDING JOO <ddingsha9@teambind.co.kr>

* feat : handleChat 메서드 JsonNull 체크 푸가

* feature : handleChat 메서드 JsonNull 체크 추가 (#493)

* feat : WebSocket Connect, Disconnect 핸들러 & SpeakingConnecion 모델 구현

* feat : WebSocket 메시지 처리 handler, service 구현

* feat : WebSocket 연결 정보 Repository 구현

* fix : 오타 수정

* refactor : websocket -> rest api 전환

* feat : speaking handler REST로 교체

* feat : speaking 관련 dto 생성

* refacotor : 기존 service 코드 로직 재사용 및 repository 리펙토링

* feat : speaking rest API 람다 함수 추가

* refactor : speaking service 재사용

* refactor : AI 영어 회화 연습 코드 리팩토링

* feat : handleChat 메서드 JsonNull 체크 푸가

---------

Co-authored-by: DDING JOO <ddingsha9@teambind.co.kr>

* feat(news): 뉴스 학습 배지 시스템 구현 (#473)

- 14개 뉴스 관련 배지 추가 (읽기, 퀴즈, 단어수집, 연속학습, 마스터)
- UserStats에 뉴스 통계 필드 추가
- 6개 뉴스 배지 Strategy 클래스 생성
- 뉴스 읽기/퀴즈/단어수집 시 통계 업데이트 및 배지 체크 연동

* fix: add PATCH method to CORS AllowMethods

* test: BadgeType 개수 테스트 수정 (15 -> 29)

* fix: CORS PATCH 메서드 추가

* docs: 뉴스 기능 프론트엔드 연동 가이드 작성

* fix: NewsCollectionFunction에 Bedrock, Comprehend 권한 추가

* fix: add null check for collectWord request body

- Add INVALID_REQUEST error code to NewsErrorCode
- Check body and word field before accessing in collectWord()
- Prevents NullPointerException when request body is malformed

* feat: enhance stats API and bookmark response for frontend

- Add DAILY stats update for news read/quiz/word collection
- Add /stats/dashboard endpoint with frontend-requested format
  - today: wordsLearned, newsRead, quizzesTaken, wordsTotal
  - overall: totalWordsLearned, totalNewsRead, averageAccuracy, streaks
  - weeklyProgress: last 7 days with date/wordsLearned/newsRead
- Add news-related fields to all stats API responses
- Fix bookmark API to include full article details (title, summary, etc.)

* feat: add category classification to news AI analysis

- Add category field to AnalysisResult record
- Update Bedrock prompt to classify articles into categories
  (WORLD, POLITICS, BUSINESS, TECH, SCIENCE, HEALTH, SPORTS, ENTERTAINMENT, LIFESTYLE)
- Parse and set category from AI response
- Set GSI2 (CATEGORY#) index when category is available

* fix: add /stats/dashboard endpoint to template.yaml

* fix: filter by ARTICLE# prefix in findById to avoid returning UserNewsRecord

* docs: add News API troubleshooting guide

* feat: add Cognito authorizer to News API and enhance keyword extraction

- Set CognitoAuthorizer for all News API endpoints in template.yaml
- Update Bedrock AI to extract keywords with meanings and examples
- Add fallback to Comprehend for keyword extraction when Bedrock fails
- Modify KeywordInfo model to include example field
- Adjust AI prompt to include keyword extraction with examples
- Update AnalysisResult to store keywords and parse them from AI response

* Revert "Merge branch 'test' into prod"

This reverts commit c1a958eac6799d5838a76e4078ae304bcdb62278, reversing
changes made to a6662e0cfc46c6e12f20a89f0df285ff282160bc.

* feat: enhance bookmark and reading status tracking for News API

- Add bookmark and reading status to individual article responses
- Include bookmark status in paginated news responses
- Modify `KeywordInfo` to support Korean translations (`meaningKo`)
- Update AI prompts to extract Korean meanings for keywords

* refactor : session_id가 null 체크 추가

* feat : template 환경변수 리펙토링

* fix : sessionId NullPointerException 에러 수정  (#496)

* feat : WebSocket Connect, Disconnect 핸들러 & SpeakingConnecion 모델 구현

* feat : WebSocket 메시지 처리 handler, service 구현

* feat : WebSocket 연결 정보 Repository 구현

* fix : 오타 수정

* refactor : websocket -> rest api 전환

* feat : speaking handler REST로 교체

* feat : speaking 관련 dto 생성

* refacotor : 기존 service 코드 로직 재사용 및 repository 리펙토링

* feat : speaking rest API 람다 함수 추가

* refactor : speaking service 재사용

* refactor : AI 영어 회화 연습 코드 리팩토링

* feat : handleChat 메서드 JsonNull 체크 푸가

* refactor : session_id가 null 체크 추가

* feat : template 환경변수 리펙토링

---------

Co-authored-by: DDING JOO <ddingsha9@teambind.co.kr>

* feat: enhance bookmark and reading status tracking for News API

- Add bookmark and reading status to individual article responses
- Include bookmark status in paginated news responses
- Modify `KeywordInfo` to support Korean translations (`meaningKo`)
- Update AI prompts to extract Korean meanings for keywords

* feat: add category filtering to UserWord API with enhanced query logic

- Introduce `category` filtering to `getUserWords` API
- Update WordCategory enums to include "news" category
- Apply category filter after enrichment with word info
- Adjust query limits for bookmarked and incorrect words queries

* feat: add default value for ExistingCognitoClientId in template.yaml

- Set default to an empty string to ensure compatibility with templates using this parameter without explicitly specifying a value.

* fix: SpeakingHandler getStringOrNull 컴파일 에러 수정

* fix: SpeakingHandler getStringOrNull 컴파일 에러 수정

* fix: Bedrock 키워드(meaningKo 포함)를 article에 저장하도록 수정

* fix: Bedrock 키워드(meaningKo 포함)를 article에 저장하도록 수정

* fix: Bedrock 키워드(meaningKo 포함)를 article에 저장하도록 수정

* feat: add dashboard stats API and enhance news stats tracking

- Introduce `/stats/dashboard` API for retrieving integrated user stats (today, overall, weekly progress, and level distribution)
- Update `UserStats` model to include additional fields for news stats (newsRead, newsQuizCompleted, newsQuizPerfect, newsWordsCollected, etc.)
- Add atomic updates to track news reading, quiz, and word stats in `UserStatsRepository`
- Modify CloudFormation `template.yaml` to register the new `/stats/dashboard` endpoint

* feat: add dashboard stats API and enhance news stats tracking

- Introduce `/stats/dashboard` API for retrieving integrated user stats (today, overall, weekly progress, and level distribution)
- Update `UserStats` model to include additional fields for news stats (newsRead, newsQuizCompleted, newsQuizPerfect, newsWordsCollected, etc.)
- Add atomic updates to track news reading, quiz, and word stats in `UserStatsRepository`
- Modify CloudFormation `template.yaml` to register the new `/stats/dashboard` endpoint

* feat: add dashboard stats API and enhance news stats tracking

- Introduce `/stats/dashboard` API for retrieving integrated user stats (today, overall, weekly progress, and level distribution)
- Update `UserStats` model to include additional fields for news stats (newsRead, newsQuizCompleted, newsQuizPerfect, newsWordsCollected, etc.)
- Add atomic updates to track news reading, quiz, and word stats in `UserStatsRepository`
- Modify CloudFormation `template.yaml` to register the new `/stats/dashboard` endpoint

* refactor: format code with consistent indentation and spacing

- Apply consistent formatting to improve code readability across multiple files
- Adjust indentation, spacing, and alignment in model classes, DTOs, and repository methods

* fix: filter by ARTICLE# prefix in findById to avoid returning bookmark records


* feat : Speaking 관련 template 람다 함수 및 테이블 추가

* feat : 말하기 기능에 polly 서비스 권한 추가

---------

Co-authored-by: DDING JOO <ddingsha9@teambind.co.kr>

* feature : transcribe API KEY 추가  (#516)

* feat: EnvConfig 유틸리티 추가 및 환경 변수 검증 적용

환경 변수 미설정 시 명확한 에러 메시지를 제공하는 EnvConfig 유틸리티를 추가하고,
기존 System.getenv 호출을 EnvConfig.getRequired/getOrDefault로 대체함.

- EnvConfig: getRequired, getOrDefault, getIntOrDefault, getLongOrDefault 메서드 제공
- Lambda Cold Start 시점에 환경 변수 누락을 조기 감지
- 기존 Config 클래스(WebSocketConfig, RoomTokenConfig) EnvConfig 사용으로 통일

Closes #403

* refactor: TestService submitTest 메서드 책임 분리

submitTest 메서드를 단일 책임 원칙에 맞게 리팩토링:
- gradeAnswers(): 답안 채점 및 결과 집계
- isAnswerCorrect(): 단일 답안 정답 여부 판단
- buildResultItem(): 결과 항목 생성
- saveTestResult(): 테스트 결과 저장
- GradingResult record: 채점 결과 캡슐화

TestService와 TestCommandService 모두 동일하게 적용

Closes #404

* refactor: 하드코딩된 설정값 환경 변수로 외부화

각 도메인별 Config 클래스를 생성하여 하드코딩된 값들을 환경 변수로 설정 가능하게 변경.
기본값이 있어 환경 변수 미설정 시에도 기존 동작 유지.

## 새로 추가된 Config 클래스
- GrammarConfig: SESSION_TTL_DAYS, MAX_HISTORY_MESSAGES, MAX_TOKENS 등
- GameConfig: TOTAL_ROUNDS, ROUND_TIME_LIMIT, QUICK_GUESS_THRESHOLD_MS
- VocabularyConfig: NEW_WORDS_COUNT, REVIEW_WORDS_COUNT, 상태 전이 임계값 등

## 지원하는 환경 변수
- GRAMMAR_SESSION_TTL_DAYS, GRAMMAR_MAX_HISTORY_MESSAGES, GRAMMAR_MAX_TOKENS
- GAME_TOTAL_ROUNDS, GAME_ROUND_TIME_LIMIT, GAME_QUICK_GUESS_THRESHOLD_MS
- VOCAB_NEW_WORDS_COUNT, VOCAB_REVIEW_WORDS_COUNT
- VOCAB_TRANSITION_TO_REVIEWING, VOCAB_TRANSITION_TO_MASTERED

Closes #406

* test: StudyLevel enum 단위 테스트 추가

* test: Difficulty enum 단위 테스트 추가

* test: StudyConfig 단위 테스트 추가

* test: EnvConfig 단위 테스트 추가

* test: PaginatedResult 단위 테스트 추가

* test: JsonUtil 단위 테스트 추가

* test: CursorUtil 단위 테스트 추가

* test: CommonErrorCode 단위 테스트 추가

* test: CommonException 단위 테스트 추가

* test: BadgeType enum 단위 테스트 추가

* test: BadgeKey 상수 단위 테스트 추가

* test: WordStatus enum 단위 테스트 추가

* test: TestType enum 단위 테스트 추가

* test: VocabularyConfig 단위 테스트 추가

* test: VocabKey 상수 단위 테스트 추가

* test: VocabularyErrorCode 단위 테스트 추가

* test: VocabularyException 단위 테스트 추가

* test: SpacedRepetitionContext 단위 테스트 추가

* test: GrammarLevel enum 단위 테스트 추가

* test: GrammarConfig 단위 테스트 추가

* test: GrammarErrorCode 단위 테스트 추가

* test: GrammarException 단위 테스트 추가

* test: GameStatus enum 단위 테스트 추가

* test: GameConfig 단위 테스트 추가

* test: ChattingErrorCode 단위 테스트 추가

* test: ChattingException 단위 테스트 추가

* fix: OPIc FeedbackResponse.java 문법 오류 수정

* style: AwsClients 코드 포맷팅

* style: EnvConfig 코드 포맷팅

* style: RoomTokenConfig 코드 포맷팅

* style: WebSocketConfig 코드 포맷팅

* style: JsonUtil 코드 포맷팅

* style: GameConfig 코드 포맷팅

* style: GrammarConfig 코드 포맷팅

* style: GrammarKey 코드 포맷팅

* style: GrammarErrorCode 코드 포맷팅

* style: GrammarException 코드 포맷팅

* style: BedrockGrammarCheckFactory 코드 포맷팅

* style: GrammarConversationService 코드 포맷팅

* style: FeedbackResponse 코드 포맷팅

* style: SessionReportResponse 코드 포맷팅

* style: SpeakingError 코드 포맷팅

* style: SpeakingErrorType 코드 포맷팅

* style: OPIcException 코드 포맷팅

* style: OPIcAnswer 코드 포맷팅

* style: OPIcQuestion 코드 포맷팅

* style: OPIcSession 코드 포맷팅

* style: OPIcRepository 코드 포맷팅

* style: FeedbackService 코드 포맷팅

* style: TranscribeProxyService 코드 포맷팅

* style: VocabularyConfig 코드 포맷팅

* style: DailyStudyCommandService 코드 포맷팅

* style: TestCommandService 코드 포맷팅

* style: TestService 코드 포맷팅

* style: CommonErrorCodeSpec 코드 포맷팅

* style: JsonUtilSpec 코드 포맷팅

* style: BadgeTypeSpec 코드 포맷팅

* style: ChattingErrorCodeSpec 코드 포맷팅

* style: GrammarLevelSpec 코드 포맷팅

* style: GrammarErrorCodeSpec 코드 포맷팅

* style: VocabularyErrorCodeSpec 코드 포맷팅

* feature : OPIc 세션관리 + 답변 처리 파이프라인 구현  (#413)

* feat : OPIc 질문 & 세션 관련 dto 생성

* refactor : @DynamoDbBean 주석 추가

* feat : 주제 + 소주제 + 레벨로 오픽 질문 조회 추가

* feat : OPIc 세션, 질문, 답변 종합 handler 구현

* feat : 오픽 주제, 소주제별 seed 데이터 추가

* refactor : Transcribe API KEY 환경변수명 수정

* refactor : Bedrock에 사용하는 클로드 모델 변경

* refactor : S3 Key 대신 Proxy에서 요청하는 Base64 값으로 변환

* feat: GAME_START, ROUND_END 메시지에 serverTime 추가

- broadcastGameStart(): serverTime, roundDuration 필드 추가
- broadcastRoundEnd(): serverTime, roundStartTime, roundDuration 필드 추가
- GameService.endRound(): data에 roundStartTime, roundDuration 포함
- 타이머 동기화 버그 수정을 위한 서버 시간 제공

* feat: WebSocketMessageHelper 유틸리티 클래스 추가

- domain 필드 포함 메시지 생성 헬퍼
- DOMAIN_CHAT, DOMAIN_GAME 상수 정의
- buildChatMessage(), buildGameMessage() 메서드

* feat: 모든 WebSocket 메시지에 domain 필드 추가

- ScoreUpdateMessage에 domain 필드 추가
- broadcastGameStart에 domain:"game" 추가
- broadcastRoundEnd에 domain:"game" 추가
- broadcastCorrectAnswerMessage에 domain:"game" 추가
- handleCommandResult 시스템 메시지에 domain:"game" 추가
- handleRegularMessage 채팅 메시지에 domain:"chat" 추가

Closes #426, #427

* feat: GameSession 모델 클래스 생성

- DynamoDB Enhanced Client 어노테이션 적용
- GSI1: roomId로 활성 게임 세션 조회 가능
- 게임 상태 관리용 헬퍼 메서드 포함

Closes #428

* feat: GameSessionRepository 구현

- 기본 CRUD (save, findById, delete)
- roomId로 활성/전체 게임 세션 조회
- 상태, 라운드, 점수 업데이트 메서드
- 정답자 추가, 힌트 사용, 게임 종료 처리

Closes #429

* refactor: ChatRoom에서 게임 필드 분리

- 게임 관련 필드 제거 (gameStatus, currentRound 등)
- activeGameSessionId 필드 추가
- 게임 상태는 GameSession으로 분리됨

Note: 의존 코드 수정은 #431에서 진행

Closes #430

* refactor: GameSession 기반으로 전체 게임 로직 리팩토링

- GameService: ChatRoom 대신 GameSession 사용
- GameStatsService: GameSession 매개변수로 변경
- CommandService: GameSession 기반 점수 조회
- GameHandler: GameSession 기반 REST API
- WebSocketMessageHandler: GameSession 기반 브로드캐스트
- GameStatusResponse, ScoreboardResponse: GameSession 매개변수

Closes #431

* feat: GameSessionHandler Lambda 및 게임 세션 API 구현

- POST /rooms/{roomId}/games - 게임 세션 생성
- GET /games/{gameSessionId} - 게임 상태 조회 (재접속용)
- POST /games/{gameSessionId}/start - 게임 시작
- POST /games/{gameSessionId}/stop - 게임 종료

모든 응답에 serverTime 포함 (타이머 동기화)
출제자에게만 currentWord 포함

Closes #432, #433

* feat: 게임 시작 7분 후 자동 종료 기능 구현

- GameConfig에 gameTimeLimit() 메서드 추가 (기본값: 420초)
- GameSchedulerClient 유틸리티 클래스 생성 (EventBridge Scheduler 연동)
- GameService에 스케줄 생성/취소 로직 추가
- GameAutoCloseHandler Lambda 함수 생성
- template.yaml에 Lambda, IAM Role, Schedule Group 추가

Closes #417

* fix : 메모리 증가 및 Lambda 응답 제한 시간 Cognito 트리거 제한시간과 동일하게 수정 (#439)

* feat: 캐치마인드 게임 방 분리 기능 구현 (#455)

- Room 타입 분리 (CHAT/GAME)
  - RoomType, RoomStatus enum 추가
  - ChatRoom 모델에 type, gameType, gameSettings, status, hostId 필드 추가
  - GameSettings 모델 추가

- 방 생성/조회 API 수정
  - CreateRoomRequest에 type, gameType, gameSettings 필드 추가
  - 방 목록 조회 시 type, gameType, status 필터 지원

- 게임 시작 조건 검증
  - GAME 타입 방에서만 게임 시작 가능 (GAME_007 에러)

- 게임 재시작 API 구현 (#452)
  - POST /rooms/{roomId}/game/restart 엔드포인트 추가
  - 방장만 재시작 가능 (GAME_009 에러)
  - 게임 진행 중 재시작 불가 (GAME_008 에러)

- 방장 변경 로직 구현 (#453)
  - 방장 퇴장 시 다음 멤버에게 자동 이전
  - 모든 멤버 퇴장 시 방 자동 삭제

- WebSocket 메시지 타입 추가 (#454)
  - ROOM_STATUS_CHANGE, HOST_CHANGE 메시지 타입 추가
  - WebSocketMessageHelper에 빌더 메서드 추가

- 테스트 추가
  - RoomType, RoomStatus enum 테스트
  - GameSettings 모델 테스트
  - ChattingErrorCode 테스트 업데이트

Related: #440, #441, #442, #443, #444, #445, #446
Closes: #447, #448, #449, #450, #451, #452, #453, #454

* feat: 참가자 닉네임 및 방장 변경 WebSocket 알림 구현 (#456)

- RoomParticipant DTO 추가 (userId, nickname, isHost)
- ChatRoomQueryService에 닉네임 조회 메서드 추가
  - getParticipantsWithNicknames(): 참가자 목록 + 닉네임
  - getHostNickname(): 방장 닉네임 조회
- ChatRoomHandler.getRoom() 응답에 participants, hostNickname 추가
- ChatRoomCommandService.leaveRoom()에서 방장 변경 시 WebSocket 브로드캐스트

Related: #440

* fix: ChatRoomFunction에 UserTable DynamoDB 권한 추가

- 참가자/방장 닉네임 조회를 위한 UserTable 읽기 권한 추가
- DynamoDBReadPolicy로 UserTable 접근 허용

Fixes #457

* fix: GameSettings에 @DynamoDbBean 어노테이션 추가

- DynamoDB Enhanced Client가 중첩 객체를 직렬화/역직렬화할 수 있도록 수정
- ChatRoom 저장/조회 시 GameSettings 변환 오류 해결

Fixes #457

* fix: ChatRoomFunction에 WEBSOCKET_ENDPOINT 환경변수 및 권한 추가

- leaveRoom에서 WebSocketBroadcaster 사용을 위한 환경변수 추가
- execute-api:ManageConnections 권한 추가

* fix: WebSocket Lambda 함수들에 WEBSOCKET_ENDPOINT 환경변수 추가

- WebSocketConnectFunction에 WEBSOCKET_ENDPOINT 추가
- WebSocketDisconnectFunction에 WEBSOCKET_ENDPOINT 추가
- execute-api:ManageConnections 권한 추가

* fix: Grammar WebSocket Lambda 환경 변수 및 권한 추가

- GrammarStreamingConnectFunction에 WEBSOCKET_ENDPOINT 환경 변수 추가
- GrammarStreamingDisconnectFunction에 WEBSOCKET_ENDPOINT 환경 변수 추가
- 두 함수에 execute-api:ManageConnections 권한 추가

* feat: GSI1SK 확장성 있는 재설계 및 DB 레벨 필터링

## 변경 사항

### GSI1SK 포맷 변경
- 기존: {level}#{createdAt}
- 신규: {type}#{gameType}#{status}#{level}#{createdAt}

### 지원 쿼리 패턴
- 전체 방: GSI1PK = "ROOMS"
- 게임방만: begins_with(GSI1SK, "GAME#")
- 캐치마인드만: begins_with(GSI1SK, "GAME#CATCHMIND#")
- 대기중 캐치마인드: begins_with(GSI1SK, "GAME#CATCHMIND#WAITING#")

### 파일 수정
- ChatRoomCommandService.java: 방 생성 시 새 GSI1SK 포맷 적용
- ChatRoomRepository.java: findByFilters() 메서드 추가, updateStatus() 메서드 추가
- ChatRoomQueryService.java: 메모리 필터링 제거, DB 레벨 필터링으로 변경
- GameService.java: 게임 시작/종료 시 방 상태 업데이트 (GSI1SK 포함)

### 마이그레이션
- scripts/migrate-gsi1sk.sh: 기존 데이터 마이그레이션 스크립트
- 37개 기존 방 마이그레이션 완료

* fix: increase stats query limit to 100 days

- Adjust maximum allowable limit for recent stats query from 30 to 100 days to support extended data range responses.

* feat: improve game round and connection management logic

- Added handling for game round timeout (`ROUND_TIMEOUT`) in WebSocketMessageHandler.
- Enhanced game start broadcast to include `currentWord` for the drawer only.
- Updated ConnectionRepository to remove duplicate user connections in the same room.
- Added `currentWordEnglish` to GameSession for better answer verification.
- Normalized ChatRoom levels to match database storage format.
- Updated template.yaml to include DynamoDBReadPolicy for VocabTable.

* refactor: 코드 정리 및 미사용 클래스 제거 (#459)

* refactor: remove unused WebSocketResponseUtil

* refactor: add AutoCloseable to WebSocketBroadcaster

* refactor: remove unused TestService

* refactor: remove unused WordService

* refactor: remove unused DailyStudyService

* refactor: remove unused UserWordService

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* fix: resolve N+1 query in StatsService

* refactor(all): DI 패턴 및 전략 패턴 적용 (#461)

- Repository, Service, Handler에 DI 생성자 추가 (테스트 용이성)
- BadgeService에 Strategy 패턴 적용 (뱃지 조건 검증 로직 분리)

* refactor: relocate and restructure seed data files

- Moved `question-homes.json` and `words.json` from subdirectories to `seed` folder.
- Updated file paths for better organization and clarity.

* chore: seed 데이터 폴더 구조 정리

* feat: add CI/CD pipeline configuration for CodePipeline

* fix: add SNS topic policy and DependsOn for notification rule

* fix: correct paths in buildspec.yml for CodeBuild

* fix: remove hardcoded JAVA_HOME, use runtime default

* fix: add gradle wrapper for CI/CD build

* fix: use single line sam package command with hardcoded bucket

* fix: use existing stack name group2-englishstudy-chatting

* fix: add missing WEBSOCKET_ENDPOINT env var to WebSocket connect functions

* docs: update FRONTEND-API-GUIDE with new RoomType/RoomStatus structure

* feat : WebSocket Connect, Disconnect 핸들러 & SpeakingConnecion 모델 구현

* feat : WebSocket 메시지 처리 handler, service 구현

* feat : WebSocket 연결 정보 Repository 구현

* fix: update WebSocketDisconnectHandler to use GameSession model

- Remove references to deleted ChatRoom game fields
- Use GameSessionRepository to finish active game sessions
- Use ChatRoomRepository.updateStatus() for room state management

* perf: optimize CI/CD build time

- Add pip cache for SAM CLI dependencies
- Enable Gradle parallel builds and build cache
- Add SAM build cache (.aws-sam)
- Use sam build --parallel --cached
- Skip SAM CLI install if already cached
- Remove unnecessary 'clean' to leverage cache

* feat: add custom CodeBuild Docker image with pre-installed tools

- Dockerfile with Java 21 + SAM CLI + Gradle pre-installed
- build-and-push.sh script for ECR deployment
- Updated buildspec.yml for custom image (removes SAM CLI install)
- Expected build time reduction: ~30-40 seconds

* feature : AI 영어 회화 연습 기능 (#468)

* feat : WebSocket Connect, Disconnect 핸들러 & SpeakingConnecion 모델 구현

* feat : WebSocket 메시지 처리 handler, service 구현

* feat : WebSocket 연결 정보 Repository 구현

* fix: remove typo in SpeakingConnectionRepository

* fix : 오타 수정

* chore: trigger build test with custom Docker image

* chore: remove unnecessary newlines and whitespace across WebSocket handlers and related classes

* chore: remove unnecessary newlines and whitespace across WebSocket handlers and related classes

* Release: 캐치마인드 게임 분리, AI 회화 연습, CI/CD 파이프라인 (#469)

* feature : OPIc 세션관리 + 답변 처리 파이프라인 구현  (#413)

* feat : OPIc 질문 & 세션 관련 dto 생성

* refactor : @DynamoDbBean 주석 추가

* feat : 주제 + 소주제 + 레벨로 오픽 질문 조회 추가

* feat : OPIc 세션, 질문, 답변 종합 handler 구현

* feat : 오픽 주제, 소주제별 seed 데이터 추가

* refactor : Transcribe API KEY 환경변수명 수정

* refactor : Bedrock에 사용하는 클로드 모델 변경

* refactor : S3 Key 대신 Proxy에서 요청하는 Base64 값으로 변환

* feat: GAME_START, ROUND_END 메시지에 serverTime 추가

- broadcastGameStart(): serverTime, roundDuration 필드 추가
- broadcastRoundEnd(): serverTime, roundStartTime, roundDuration 필드 추가
- GameService.endRound(): data에 roundStartTime, roundDuration 포함
- 타이머 동기화 버그 수정을 위한 서버 시간 제공

* feat: WebSocketMessageHelper 유틸리티 클래스 추가

- domain 필드 포함 메시지 생성 헬퍼
- DOMAIN_CHAT, DOMAIN_GAME 상수 정의
- buildChatMessage(), buildGameMessage() 메서드

* feat: 모든 WebSocket 메시지에 domain 필드 추가

- ScoreUpdateMessage에 domain 필드 추가
- broadcastGameStart에 domain:"game" 추가
- broadcastRoundEnd에 domain:"game" 추가
- broadcastCorrectAnswerMessage에 domain:"game" 추가
- handleCommandResult 시스템 메시지에 domain:"game" 추가
- handleRegularMessage 채팅 메시지에 domain:"chat" 추가

Closes #426, #427

* feat: GameSession 모델 클래스 생성

- DynamoDB Enhanced Client 어노테이션 적용
- GSI1: roomId로 활성 게임 세션 조회 가능
- 게임 상태 관리용 헬퍼 메서드 포함

Closes #428

* feat: GameSessionRepository 구현

- 기본 CRUD (save, findById, delete)
- roomId로 활성/전체 게임 세션 조회
- 상태, 라운드, 점수 업데이트 메서드
- 정답자 추가, 힌트 사용, 게임 종료 처리

Closes #429

* refactor: ChatRoom에서 게임 필드 분리

- 게임 관련 필드 제거 (gameStatus, currentRound 등)
- activeGameSessionId 필드 추가
- 게임 상태는 GameSession으로 분리됨

Note: 의존 코드 수정은 #431에서 진행

Closes #430

* refactor: GameSession 기반으로 전체 게임 로직 리팩토링

- GameService: ChatRoom 대신 GameSession 사용
- GameStatsService: GameSession 매개변수로 변경
- CommandService: GameSession 기반 점수 조회
- GameHandler: GameSession 기반 REST API
- WebSocketMessageHandler: GameSession 기반 브로드캐스트
- GameStatusResponse, ScoreboardResponse: GameSession 매개변수

Closes #431

* feat: GameSessionHandler Lambda 및 게임 세션 API 구현

- POST /rooms/{roomId}/games - 게임 세션 생성
- GET /games/{gameSessionId} - 게임 상태 조회 (재접속용)
- POST /games/{gameSessionId}/start - 게임 시작
- POST /games/{gameSessionId}/stop - 게임 종료

모든 응답에 serverTime 포함 (타이머 동기화)
출제자에게만 currentWord 포함

Closes #432, #433

* feat: 게임 시작 7분 후 자동 종료 기능 구현

- GameConfig에 gameTimeLimit() 메서드 추가 (기본값: 420초)
- GameSchedulerClient 유틸리티 클래스 생성 (EventBridge Scheduler 연동)
- GameService에 스케줄 생성/취소 로직 추가
- GameAutoCloseHandler Lambda 함수 생성
- template.yaml에 Lambda, IAM Role, Schedule Group 추가

Closes #417

* fix : 메모리 증가 및 Lambda 응답 제한 시간 Cognito 트리거 제한시간과 동일하게 수정 (#439)

* feat: 캐치마인드 게임 방 분리 기능 구현 (#455)

- Room 타입 분리 (CHAT/GAME)
  - RoomType, RoomStatus enum 추가
  - ChatRoom 모델에 type, gameType, gameSettings, status, hostId 필드 추가
  - GameSettings 모델 추가

- 방 생성/조회 API 수정
  - CreateRoomRequest에 type, gameType, gameSettings 필드 추가
  - 방 목록 조회 시 type, gameType, status 필터 지원

- 게임 시작 조건 검증
  - GAME 타입 방에서만 게임 시작 가능 (GAME_007 에러)

- 게임 재시작 API 구현 (#452)
  - POST /rooms/{roomId}/game/restart 엔드포인트 추가
  - 방장만 재시작 가능 (GAME_009 에러)
  - 게임 진행 중 재시작 불가 (GAME_008 에러)

- 방장 변경 로직 구현 (#453)
  - 방장 퇴장 시 다음 멤버에게 자동 이전
  - 모든 멤버 퇴장 시 방 자동 삭제

- WebSocket 메시지 타입 추가 (#454)
  - ROOM_STATUS_CHANGE, HOST_CHANGE 메시지 타입 추가
  - WebSocketMessageHelper에 빌더 메서드 추가

- 테스트 추가
  - RoomType, RoomStatus enum 테스트
  - GameSettings 모델 테스트
  - ChattingErrorCode 테스트 업데이트

Related: #440, #441, #442, #443, #444, #445, #446
Closes: #447, #448, #449, #450, #451, #452, #453, #454

* feat: 참가자 닉네임 및 방장 변경 WebSocket 알림 구현 (#456)

- RoomParticipant DTO 추가 (userId, nickname, isHost)
- ChatRoomQueryService에 닉네임 조회 메서드 추가
  - getParticipantsWithNicknames(): 참가자 목록 + 닉네임
  - getHostNickname(): 방장 닉네임 조회
- ChatRoomHandler.getRoom() 응답에 participants, hostNickname 추가
- ChatRoomCommandService.leaveRoom()에서 방장 변경 시 WebSocket 브로드캐스트

Related: #440

* fix: ChatRoomFunction에 UserTable DynamoDB 권한 추가

- 참가자/방장 닉네임 조회를 위한 UserTable 읽기 권한 추가
- DynamoDBReadPolicy로 UserTable 접근 허용

Fixes #457

* fix: GameSettings에 @DynamoDbBean 어노테이션 추가

- DynamoDB Enhanced Client가 중첩 객체를 직렬화/역직렬화할 수 있도록 수정
- ChatRoom 저장/조회 시 GameSettings 변환 오류 해결

Fixes #457

* fix: ChatRoomFunction에 WEBSOCKET_ENDPOINT 환경변수 및 권한 추가

- leaveRoom에서 WebSocketBroadcaster 사용을 위한 환경변수 추가
- execute-api:ManageConnections 권한 추가

* fix: WebSocket Lambda 함수들에 WEBSOCKET_ENDPOINT 환경변수 추가

- WebSocketConnectFunction에 WEBSOCKET_ENDPOINT 추가
- WebSocketDisconnectFunction에 WEBSOCKET_ENDPOINT 추가
- execute-api:ManageConnections 권한 추가

* fix: Grammar WebSocket Lambda 환경 변수 및 권한 추가

- GrammarStreamingConnectFunction에 WEBSOCKET_ENDPOINT 환경 변수 추가
- GrammarStreamingDisconnectFunction에 WEBSOCKET_ENDPOINT 환경 변수 추가
- 두 함수에 execute-api:ManageConnections 권한 추가

* feat: GSI1SK 확장성 있는 재설계 및 DB 레벨 필터링

## 변경 사항

### GSI1SK 포맷 변경
- 기존: {level}#{createdAt}
- 신규: {type}#{gameType}#{status}#{level}#{createdAt}

### 지원 쿼리 패턴
- 전체 방: GSI1PK = "ROOMS"
- 게임방만: begins_with(GSI1SK, "GAME#")
- 캐치마인드만: begins_with(GSI1SK, "GAME#CATCHMIND#")
- 대기중 캐치마인드: begins_with(GSI1SK, "GAME#CATCHMIND#WAITING#")

### 파일 수정
- ChatRoomCommandService.java: 방 생성 시 새 GSI1SK 포맷 적용
- ChatRoomRepository.java: findByFilters() 메서드 추가, updateStatus() 메서드 추가
- ChatRoomQueryService.java: 메모리 필터링 제거, DB 레벨 필터링으로 변경
- GameService.java: 게임 시작/종료 시 방 상태 업데이트 (GSI1SK 포함)

### 마이그레이션
- scripts/migrate-gsi1sk.sh: 기존 데이터 마이그레이션 스크립트
- 37개 기존 방 마이그레이션 완료

* fix: increase stats query limit to 100 days

- Adjust maximum allowable limit for recent stats query from 30 to 100 days to support extended data range responses.

* feat: improve game round and connection management logic

- Added handling for game round timeout (`ROUND_TIMEOUT`) in WebSocketMessageHandler.
- Enhanced game start broadcast to include `currentWord` for the drawer only.
- Updated ConnectionRepository to remove duplicate user connections in the same room.
- Added `currentWordEnglish` to GameSession for better answer verification.
- Normalized ChatRoom levels to match database storage format.
- Updated template.yaml to include DynamoDBReadPolicy for VocabTable.

* refactor: 코드 정리 및 미사용 클래스 제거 (#459)

* refactor: remove unused WebSocketResponseUtil

* refactor: add AutoCloseable to WebSocketBroadcaster

* refactor: remove unused TestService

* refactor: remove unused WordService

* refactor: remove unused DailyStudyService

* refactor: remove unused UserWordService

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* fix: resolve N+1 query in StatsService

* refactor(all): DI 패턴 및 전략 패턴 적용 (#461)

- Repository, Service, Handler에 DI 생성자 추가 (테스트 용이성)
- BadgeService에 Strategy 패턴 적용 (뱃지 조건 검증 로직 분리)

* refactor: relocate and restructure seed data files

- Moved `question-homes.json` and `words.json` from subdirectories to `seed` folder.
- Updated file paths for better organization and clarity.

* chore: seed 데이터 폴더 구조 정리

* feat: add CI/CD pipeline configuration for CodePipeline

* fix: add SNS topic policy and DependsOn for notification rule

* fix: correct paths in buildspec.yml for CodeBuild

* fix: remove hardcoded JAVA_HOME, use runtime default

* fix: add gradle wrapper for CI/CD build

* fix: use single line sam package command with hardcoded bucket

* fix: use existing stack name group2-englishstudy-chatting

* fix: add missing WEBSOCKET_ENDPOINT env var to WebSocket connect functions

* docs: update FRONTEND-API-GUIDE with new RoomType/RoomStatus structure

* fix: update WebSocketDisconnectHandler to use GameSession model

- Remove references to deleted ChatRoom game fields
- Use GameSessionRepository to finish active game sessions
- Use ChatRoomRepository.updateStatus() for room state management

* perf: optimize CI/CD build time

- Add pip cache for SAM CLI dependencies
- Enable Gradle parallel builds and build cache
- Add SAM build cache (.aws-sam)
- Use sam build --parallel --cached
- Skip SAM CLI install if already cached
- Remove unnecessary 'clean' to leverage cache

* feat: add custom CodeBuild Docker image with pre-installed tools

- Dockerfile with Java 21 + SAM CLI + Gradle pre-installed
- build-and-push.sh script for ECR deployment
- Updated buildspec.yml for custom image (removes SAM CLI install)
- Expected build time reduction: ~30-40 seconds

* feature : AI 영어 회화 연습 기능 (#468)

* feat : WebSocket Connect, Disconnect 핸들러 & SpeakingConnecion 모델 구현

* feat : WebSocket 메시지 처리 handler, service 구현

* feat : WebSocket 연결 정보 Repository 구현

* fix: remove typo in SpeakingConnectionRepository

* chore: trigger build test with custom Docker image

* chore: remove unnecessary newlines and whitespace across WebSocket handlers and related classes

* chore: remove unnecessary newlines and whitespace across WebSocket handlers and related classes

---------

Co-authored-by: hyein Heo <128613248+hye-inA@users.noreply.github.com>

* refactor : websocket -> rest api 전환

* feat : speaking handler REST로 교체

* feat : speaking 관련 dto 생성

* refacotor : 기존 service 코드 로직 재사용 및 repository 리펙토링

* fix: add CORS headers to API Gateway error responses (#479)

API Gateway의 인증 실패 등 에러 응답에 CORS 헤더가 누락되어
CloudFront를 통한 프론트엔드 요청이 차단되는 문제 수정

- UNAUTHORIZED (401) 응답에 CORS 헤더 추가
- ACCESS_DENIED (403) 응답에 CORS 헤더 추가
- DEFAULT_4XX/5XX 응답에 CORS 헤더 추가
- EXPIRED_TOKEN 응답에 CORS 헤더 추가

* feat(news): 뉴스 도메인 기반 구조 구축 (#385)

- NewsCategory, QuizType enum 추가
- NewsKey 상수 클래스 추가
- NewsErrorCode 예외 클래스 추가
- NewsArticle, KeywordInfo, QuizQuestion 모델 추가
- NewsArticleRepository CRUD 구현
- NewsTable DynamoDB 테이블 정의
- CORS GatewayResponses 설정 추가

* feat(news): 뉴스 수집 파이프라인 구현 (#386)

- NewsApiClient: NewsAPI 연동 서비스
- RssFeedParser: RSS 피드 파싱 (BBC, VOA, NPR)
- NewsDuplicateChecker: URL 기반 중복 필터링
- NewsCollectorService: 수집 오케스트레이션
- NewsCollectionHandler: Lambda 핸들러
- EventBridge 스케줄러: 매일 18시 KST 실행

* refactor(news): NewsAPI 제거, RSS만 사용

- NewsApiClient 삭제
- SSM Parameter 의존성 제거
- RSS 소스당 7개씩 수집 (BBC, VOA, NPR = 약 21개/일)

* feat(news): AI 뉴스 분석 시스템 구현 (#387)

- NewsAnalysisService: AI 분석 통합 서비스
  - Bedrock: CEFR 난이도 분석 (A1~C2)
  - Bedrock: 3줄 요약 + 퀴즈 3문제 생성
  - Comprehend: 핵심 키워드 추출
- NewsCollectorService: 수집 시 자동 분석 연동
- GSI1/GSI2 키 자동 설정 (레벨별, 카테고리별 조회)

* feat(news): 뉴스 학습 API 구현 (#388)

- NewsQueryService: 뉴스 조회 서비스
- NewsHandler: API 핸들러
  - GET /news - 목록 조회 (level, category 필터)
  - GET /news/today - 오늘의 뉴스
  - GET /news/recommended - 내 레벨 맞춤 추천
  - GET /news/{articleId} - 상세 조회 (조회수 증가)
- template.yaml: NewsFunction Lambda 추가

* feat(news): 뉴스 학습 부가 기능 구현 (#389)

- 읽기 완료 기록 API (POST /news/{articleId}/read)
- 북마크 토글 API (POST /news/{articleId}/bookmark)
- 북마크 목록 조회 API (GET /news/bookmarks)
- 학습 통계 조회 API (GET /news/stats)
- TTS 오디오 URL 조회 API (GET /news/{articleId}/audio)
- UserNewsRecord 모델 추가
- UserNewsRepository 추가
- NewsLearningService 추가

* feat(news): 복합 퀴즈 시스템 구현 (#471)

- 퀴즈 조회 API (GET /news/{articleId}/quiz)
- 퀴즈 제출 API (POST /news/{articleId}/quiz)
- 퀴즈 기록 조회 API (GET /news/quiz/history)
- NewsQuizResult 모델 추가
- QuizAnswerResult 모델 추가
- NewsQuizRepository 추가
- NewsQuizService 추가

* feat(news): 단어 수집 & Vocabulary 연동 구현 (#472)

- 단어 수집 API (POST /news/{articleId}/words)
- 수집 단어 목록 API (GET /news/words)
- 단어 상세 조회 API (GET /news/{articleId}/words/{word})
- 단어 삭제 API (DELETE /news/{articleId}/words/{word})
- Vocabulary 연동 API (POST /news/words/{word}/sync)
- NewsWordCollect 모델 추가
- NewsWordRepository 추가
- NewsWordService 추가

* feat: add multi-environment deployment support (dev/test/prod)

* fix: update buildspec.yml to deploy prod environment with parameter overrides

* feat(news): 뉴스 도메인 기반 구조 구축 (#385)

- NewsCategory, QuizType enum 추가
- NewsKey 상수 클래스 추가
- NewsErrorCode 예외 클래스 추가
- NewsArticle, KeywordInfo, QuizQuestion 모델 추가
- NewsArticleRepository CRUD 구현
- NewsTable DynamoDB 테이블 정의
- CORS GatewayResponses 설정 추가

* feat(news): 뉴스 수집 파이프라인 구현 (#386)

- NewsApiClient: NewsAPI 연동 서비스
- RssFeedParser: RSS 피드 파싱 (BBC, VOA, NPR)
- NewsDuplicateChecker: URL 기반 중복 필터링
- NewsCollectorService: 수집 오케스트레이션
- NewsCollectionHandler: Lambda 핸들러
- EventBridge 스케줄러: 매일 18시 KST 실행

* refactor(news): NewsAPI 제거, RSS만 사용

- NewsApiClient 삭제
- SSM Parameter 의존성 제거
- RSS 소스당 7개씩 수집 (BBC, VOA, NPR = 약 21개/일)

* feat(news): AI 뉴스 분석 시스템 구현 (#387)

- NewsAnalysisService: AI 분석 통합 서비스
  - Bedrock: CEFR 난이도 분석 (A1~C2)
  - Bedrock: 3줄 요약 + 퀴즈 3문제 생성
  - Comprehend: 핵심 키워드 추출
- NewsCollectorService: 수집 시 자동 분석 연동
- GSI1/GSI2 키 자동 설정 (레벨별, 카테고리별 조회)

* feat(news): 뉴스 학습 API 구현 (#388)

- NewsQueryService: 뉴스 조회 서비스
- NewsHandler: API 핸들러
  - GET /news - 목록 조회 (level, category 필터)
  - GET /news/today - 오늘의 뉴스
  - GET /news/recommended - 내 레벨 맞춤 추천
  - GET /news/{articleId} - 상세 조회 (조회수 증가)
- template.yaml: NewsFunction Lambda 추가

* feat(news): 뉴스 학습 부가 기능 구현 (#389)

- 읽기 완료 기록 API (POST /news/{articleId}/read)
- 북마크 토글 API (POST /news/{articleId}/bookmark)
- 북마크 목록 조회 API (GET /news/bookmarks)
- 학습 통계 조회 API (GET /news/stats)
- TTS 오디오 URL 조회 API (GET /news/{articleId}/audio)
- UserNewsRecord 모델 추가
- UserNewsRepository 추가
- NewsLearningService 추가

* feat(news): 복합 퀴즈 시스템 구현 (#471)

- 퀴즈 조회 API (GET /news/{articleId}/quiz)
- 퀴즈 제출 API (POST /news/{articleId}/quiz)
- 퀴즈 기록 조회 API (GET /news/quiz/history)
- NewsQuizResult 모델 추가
- QuizAnswerResult 모델 추가
- NewsQuizRepository 추가
- NewsQuizService 추가

* feat(news): 단어 수집 & Vocabulary 연동 구현 (#472)

- 단어 수집 API (POST /news/{articleId}/words)
- 수집 단어 목록 API (GET /news/words)
- 단어 상세 조회 API (GET /news/{articleId}/words/{word})
- 단어 삭제 API (DELETE /news/{articleId}/words/{word})
- Vocabulary 연동 API (POST /news/words/{word}/sync)
- NewsWordCollect 모델 추가
- NewsWordRepository 추가
- NewsWordService 추가

* feat: add multi-environment deployment support (dev/test/prod)

* fix: update buildspec.yml to deploy prod environment with parameter overrides

* refactor : AI 말하기 Websocket 구현 -> REST API 구현으로 리팩토링 (#490)

* feat : WebSocket Connect, Disconnect 핸들러 & SpeakingConnecion 모델 구현

* feat : WebSocket 메시지 처리 handler, service 구현

* feat : WebSocket 연결 정보 Repository 구현

* fix : 오타 수정

* refactor : websocket -> rest api 전환

* feat : speaking handler REST로 교체

* feat : speaking 관련 dto 생성

* refacotor : 기존 service 코드 로직 재사용 및 repository 리펙토링

* fix: revert buildspec.yml to build-only for CloudFormation deploy stage

* fix: revert buildspec.yml to build-only for CloudFormation deploy stage

* fix: update all API Gateway StageName to use Environment parameter

* fix: correct VocabularyTable and ContentBucket references in NewsFunction

* fix: correct VocabularyTable and ContentBucket references in NewsFunction

* fix: add stack name prefix to GameScheduleGroup and daily-stats schedule to avoid conflicts

* fix: add stack name prefix to GameScheduleGroup and daily-stats schedule to avoid conflicts

* feat: add support for existing Cognito User Pool reuse across environments

* fix: add conditional Cognito ARN reference in API Gateway Authorizer

* fix: remove Cognito resources completely, use existing Cognito only

* fix: remove Cognito resources completely, use existing Cognito only

* feat : speaking rest API 람다 함수 추가

* feat: add S3 bucket resource and fix environment-specific endpoints

- Add ContentBucket S3 resource for content storage
- Replace hardcoded /dev with ${Environment} in all WebSocket endpoints
- Update Output URLs to use dynamic environment stage

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* fix: add stack name prefix to news-collection schedule name

Prevent EventBridge rule name conflicts across environments

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* fix: add X-Requested-With and Accept headers to CORS config

Enable additional headers for CloudFront CORS compatibility

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* fix: use environment variable for S3 bucket URLs

Replace hardcoded bucket name with BUCKET_NAME env var for multi-env support:
- PreSignUpHandler: dynamic default profile URL
- PostConfirmationHandler: dynamic default profile URL
- UserService: dynamic default profile URL
- BadgeType: dynamic badge image base URL

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* fix: disable authorizer for CORS preflight requests

Add AddDefaultAuthorizerToCorsPreflight: false to prevent
Cognito Authorizer from blocking OPTIONS requests

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* feat : speaking REST API 람다 함수 추가  (#491)

* feature : OPIc 세션관리 + 답변 처리 파이프라인 구현  (#413)

* feat : OPIc 질문 & 세션 관련 dto 생성

* refactor : @DynamoDbBean 주석 추가

* feat : 주제 + 소주제 + 레벨로 오픽 질문 조회 추가

* feat : OPIc 세션, 질문, 답변 종합 handler 구현

* feat : 오픽 주제, 소주제별 seed 데이터 추가

* refactor : Transcribe API KEY 환경변수명 수정

* refactor : Bedrock에 사용하는 클로드 모델 변경

* refactor : S3 Key 대신 Proxy에서 요청하는 Base64 값으로 변환

* feat: GAME_START, ROUND_END 메시지에 serverTime 추가

- broadcastGameStart(): serverTime, roundDuration 필드 추가
- broadcastRoundEnd(): serverTime, roundStartTime, roundDuration 필드 추가
- GameService.endRound(): data에 roundStartTime, roundDuration 포함
- 타이머 동기화 버그 수정을 위한 서버 시간 제공

* feat: WebSocketMessageHelper 유틸리티 클래스 추가

- domain 필드 포함 메시지 생성 헬퍼
- DOMAIN_CHAT, DOMAIN_GAME 상수 정의
- buildChatMessage(), buildGameMessage() 메서드

* feat: 모든 WebSocket 메시지에 domain 필드 추가

- ScoreUpdateMessage에 domain 필드 추가
- broadcastGameStart에 domain:"game" 추가
- broadcastRoundEnd에 domain:"game" 추가
- broadcastCorrectAnswerMessage에 domain:"game" 추가
- handleCommandResult 시스템 메시지에 domain:"game" 추가
- handleRegularMessage 채팅 메시지에 domain:"chat" 추가

Closes #426, #427

* feat: GameSession 모델 클래스 생성

- DynamoDB Enhanced Client 어노테이션 적용
- GSI1: roomId로 활성 게임 세션 조회 가능
- 게임 상태 관리용 헬퍼 메서드 포함

Closes #428

* feat: GameSessionRepository 구현

- 기본 CRUD (save, findById, delete)
- roomId로 활성/전체 게임 세션 조회
- 상태, 라운드, 점수 업데이트 메서드
- 정답자 추가, 힌트 사용, 게임 종료 처리

Closes #429

* refactor: ChatRoom에서 게임 필드 분리

- 게임 관련 필드 제거 (gameStatus, currentRound 등)
- activeGameSessionId 필드 추가
- 게임 상태는 GameSession으로 분리됨

Note: 의존 코드 수정은 #431에서 진행

Closes #430

* refactor: GameSession 기반으로 전체 게임 로직 리팩토링

- GameService: ChatRoom 대신 GameSession 사용
- GameStatsService: GameSession 매개변수로 변경
- CommandService: GameSession 기반 점수 조회
- GameHandler: GameSession 기반 REST API
- WebSocketMessageHandler: GameSession 기반 브로드캐스트
- GameStatusResponse, ScoreboardResponse: GameSession 매개변수

Closes #431

* feat: GameSessionHandler Lambda 및 게임 세션 API 구현

- POST /rooms/{roomId}/games - 게임 세션 생성
- GET /games/{gameSessionId} - 게임 상태 조회 (재접속용)
- POST /games/{gameSessionId}/start - 게임 시작
- POST /games/{gameSessionId}/stop - 게임 종료

모든 응답에 serverTime 포함 (타이머 동기화)
출제자에게만 currentWord 포함

Closes #432, #433

* feat: 게임 시작 7분 후 자동 종료 기능 구현

- GameConfig에 gameTimeLimit() 메서드 추가 (기본값: 420초)
- GameSchedulerClient 유틸리티 클래스 생성 (EventBridge Scheduler 연동)
- GameService에 스케줄 생성/취소 로직 추가
- GameAutoCloseHandler Lambda 함수 생성
- template.yaml에 Lambda, IAM Role, Schedule Group 추가

Closes #417

* fix : 메모리 증가 및 Lambda 응답 제한 시간 Cognito 트리거 제한시간과 동일하게 수정 (#439)

* feat: 캐치마인드 게임 방 분리 기능 구현 (#455)

- Room 타입 분리 (CHAT/GAME)
  - RoomType, RoomStatus enum 추가
  - ChatRoom 모델에 type, gameType, gameSettings, status, hostId 필드 추가
  - GameSettings 모델 추가

- 방 생성/조회 API 수정
  - CreateRoomRequest에 type, gameType, gameSettings 필드 추가
  - 방 목록 조회 시 type, gameType, status 필터 지원

- 게임 시작 조건 검증
  - GAME 타입 방에서만 게임 시작 가능 (GAME_007 에러)

- 게임 재시작 API 구현 (#452)
  - POST /rooms/{roomId}/game/restart 엔드포인트 추가
  - 방장만 재시작 가능 (GAME_009 에러)
  - 게임 진행 중 재시작 불가 (GAME_008 에러)

- 방장 변경 로직 구현 (#453)
  - 방장 퇴장 시 다음 멤버에게 자동 이전
  - 모든 멤버 퇴장 시 방 자동 삭제

- WebSocket 메시지 타입 추가 (#454)
  - ROOM_STATUS_CHANGE, HOST_CHANGE 메시지 타입 추가
  - WebSocketMessageHelper에 빌더 메서드 추가

- 테스트 추가
  - RoomType, RoomStatus enum 테스트
  - GameSettings 모델 테스트
  - ChattingErrorCode 테스트 업데이트

Related: #440, #441, #442, #443, #444, #445, #446
Closes: #447, #448, #449, #450, #451, #452, #453, #454

* feat: 참가자 닉네임 및 방장 변경 WebSocket 알림 구현 (#456)

- RoomParticipant DTO 추가 (userId, nickname, isHost)
- ChatRoomQueryService에 닉네임 조회 메서드 추가
  - getParticipantsWithNicknames(): 참가자 목록 + 닉네임
  - getHostNickname(): 방장 닉네임 조회
- ChatRoomHandler.getRoom() 응답에 participants, hostNickname 추가
- ChatRoomCommandService.leaveRoom()에서 방장 변경 시 WebSocket 브로드캐스트

Related: #440

* fix: ChatRoomFunction에 UserTable DynamoDB 권한 추가

- 참가자/방장 닉네임 조회를 위한 UserTable 읽기 권한 추가
- DynamoDBReadPolicy로 UserTable 접근 허용

Fixes #457

* fix: GameSettings에 @DynamoDbBean 어노테이션 추가

- DynamoDB Enhanced Client가 중첩 객체를 직렬화/역직렬화할 수 있도록 수정
- ChatRoom 저장/조회 시 GameSettings 변환 오류 해결

Fixes #457

* fix: ChatRoomFunction에 WEBSOCKET_ENDPOINT 환경변수 및 권한 추가

- leaveRoom에서 WebSocketBroadcaster 사용을 위한 환경변수 추가
- execute-api:ManageConnections 권한 추가

* fix: WebSocket Lambda 함수들에 WEBSOCKET_ENDPOINT 환경변수 추가

- WebSocketConnectFunction에 WEBSOCKET_ENDPOINT 추가
- WebSocketDisconnectFunction에 WEBSOCKET_ENDPOINT 추가
- execute-api:ManageConnections 권한 추가

* fix: Grammar WebSocket Lambda 환경 변수 및 권한 추가

- GrammarStreamingConnectFunction에 WEBSOCKET_ENDPOINT 환경 변수 추가
- GrammarStreamingDisconnectFunction에 WEBSOCKET_ENDPOINT 환경 변수 추가
- 두 함수에 execute-api:ManageConnections 권한 추가

* feat: GSI1SK 확장성 있는 재설계 및 DB 레벨 필터링

- 기존: {level}#{createdAt}
- 신규: {type}#{gameType}#{status}#{level}#{createdAt}

- 전체 방: GSI1PK = "ROOMS"
- 게임방만: begins_with(GSI1SK, "GAME#")
- 캐치마인드만: begins_with(GSI1SK, "GAME#CATCHMIND#")
- 대기중 캐치마인드: begins_with(GSI1SK, "GAME#CATCHMIND#WAITING#")

- ChatRoomCommandService.java: 방 생성 시 새 GSI1SK 포맷 적용
- ChatRoomRepository.java: findByFilters() 메서드 추가, updateStatus() 메서드 추가
- ChatRoomQueryService.java: 메모리 필터링 제거, DB 레벨 필터링으로 변경
- GameService.java: 게임 시작/종료 시 방 상태 업데이트 (GSI1SK 포함)

- scripts/migrate-gsi1sk.sh: 기존 데이터 마이그레이션 스크립트
- 37개 기존 방 마이그레이션 완료

* fix: increase stats query limit to 100 days

- Adjust maximum allowable limit for recent stats query from 30 to 100 days to support extended data range responses.

* feat: improve game round and connection management logic

- Added handling for game round timeout (`ROUND_TIMEOUT`) in WebSocketMessageHandler.
- Enhanced game start broadcast to include `currentWord` for the drawer only.
- Updated ConnectionRepository to remove duplicate user connections in the same room.
- Added `currentWordEnglish` to GameSession for better answer verification.
- Normalized ChatRoom levels to match database storage format.
- Updated template.yaml to include DynamoDBReadPolicy for VocabTable.

* refactor: 코드 정리 및 미사용 클래스 제거 (#459)

* refactor: remove unused WebSocketResponseUtil

* refactor: add AutoCloseable to WebSocketBroadcaster

* refactor: remove unused TestService

* refactor: remove unused WordService

* refactor: remove unused DailyStudyService

* refactor: remove unused UserWordService

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* fix: resolve N+1 query in StatsService

* refactor(all): DI 패턴 및 전략 패턴 적용 (#461)

- Repository, Service, Handler에 DI 생성자 추가 (테스트 용이성)
- BadgeService에 Strategy 패턴 적용 (뱃지 조건 검증 로직 분리)

* refactor: relocate and restructure seed data files

- Moved `question-homes.json` and `words.json` from subdirectories to `seed` folder.
- Updated file paths for better organization and clarity.

* chore: seed 데이터 폴더 구조 정리

* feat: add CI/CD pipeline configuration for CodePipeline

* fix: add SNS topic policy and DependsOn for notification rule

* fix: correct paths in buildspec.yml for CodeBuild

* fix: remove hardcoded JAVA_HOME, use runtime default

* fix: add gradle wrapper for CI/CD build

* fix: use single line sam package command with hardcoded bucket

* fix: use existing stack name group2-englishstudy-chatting

* fix: add missing WEBSOCKET_ENDPOINT env var to WebSocket connect functions

* docs: update FRONTEND-API-GUIDE with new RoomType/RoomStatus structure

* feat : WebSocket Connect, Disconnect 핸들러 & SpeakingConnecion 모델 구현

* feat : WebSocket 메시지 처리 handler, service 구현

* feat : WebSocket 연결 정보 Repository 구현

* fix: update WebSocketDisconnectHandler to use GameSession model

- Remove references to deleted ChatRoom game fields
- Use GameSessionRepository to finish active game sessions
- Use ChatRoomRepository.updateStatus() for room state management

* perf: optimize CI/CD build time

- Add pip cache for SAM CLI dependencies
- Enable Gradle parallel builds and build cache
- Add SAM build cache (.aws-sam)
- Use sam build --parallel --cached
- Skip SAM CLI install if already cached
- Remove unnecessary 'clean' to leverage cache

* feat: add custom CodeBuild Docker image with pre-installed tools

- Dockerfile with Java 21 + SAM CLI + Gradle pre-installed
- build-and-push.sh script for ECR deployment
- Updated buildspec.yml for custom image (removes SAM CLI install)
- Expected build time reduction: ~30-40 seconds

* feature : AI 영어 회화 연습 기능 (#468)

* feat : WebSocket Connect, Disconnect 핸들러 & SpeakingConnecion 모델 구현

* feat : WebSocket 메시지 처리 handler, service 구현

* feat : WebSocket 연결 정보 Repository 구현

* fix: remove typo in SpeakingConnectionRepository

* fix : 오타 수정

* chore: trigger build test with custom Docker image

* chore: remove unnecessary newlines and whitespace across WebSocket handlers and related classes

* chore: remove unnecessary newlines and whitespace across WebSocket handlers and related classes

* refactor : websocket -> rest api 전환

* feat : speaking handler REST로 교체

* feat : speaking 관련 dto 생성

* refacotor : 기존 service 코드 로직 재사용 및 repository 리펙토링

* fix: add CORS headers to API Gateway error responses (#479)

API Gateway의 인증 실패 등 에러 응답에 CORS 헤더가 누락되어
CloudFront를 통한 프론트엔드 요청이 차단되는 문제 수정

- UNAUTHORIZED (401) 응답에 CORS 헤더 추가
- ACCESS_DENIED (403) 응답에 CORS 헤더 추가
- DEFAULT_4XX/5XX 응답에 CORS 헤더 추가
- EXPIRED_TOKEN 응답에 CORS 헤더 추가

* feat : speaking rest API 람다 함수 추가

---------

Co-authored-by: ddingjoo <ddingsha9@teambind.co.kr>

* refactor : speaking service 재사용

* refactor : AI 영어 회화 연습 코드 리팩토링

* feature : test 벡엔드 서버에 AI 말하기 연습 기능 배포 (#492)

* feat : WebSocket Connect, Disconnect 핸들러 & SpeakingConnecion 모델 구현

* feat : WebSocket 메시지 처리 handler, service 구현

* feat : WebSocket 연결 정보 Repository 구현

* fix : 오타 수정

* refactor : websocket -> rest api 전환

* feat : speaking handler REST로 교체

* feat : speaking 관련 dto 생성

* refacotor : 기존 service 코드 로직 재사용 및 repository 리펙토링

* feat : speaking rest API 람다 함수 추가

* refactor : speaking service 재사용

* refactor : AI 영어 회화 연습 코드 리팩토링

---------

Co-authored-by: DDING JOO <ddingsha9@teambind.co.kr>

* feat : handleChat 메서드 JsonNull 체크 푸가

* feature : handleChat 메서드 JsonNull 체크 추가 (#493)

* feat : WebSocket Connect, Disconnect 핸들러 & SpeakingConnecion 모델 구현

* feat : WebSocket 메시지 처리 handler, service 구현

* feat : WebSocket 연결 정보 Repository 구현

* fix : 오타 수정

* refactor : websocket -> rest api 전환

* feat : speaking handler REST로 교체

* feat : speaking 관련 dto 생성

* refacotor : 기존 service 코드 로직 재사용 및 repository 리펙토링

* feat : speaking rest API 람다 함수 추가

* refactor : speaking service 재사용

* refactor : AI 영어 회화 연습 코드 리팩토링

* feat : handleChat 메서드 JsonNull 체크 푸가

---------

Co-authored-by: DDING JOO <ddingsha9@teambind.co.kr>

* feat(news): 뉴스 학습 배지 시스템 구현 (#473)

- 14개 뉴스 관련 배지 추가 (읽기, 퀴즈, 단어수집, 연속학습, 마스터)
- UserStats에 뉴스 통계 필드 추가
- 6개 뉴스 배지 Strategy 클래스 생성
- 뉴스 읽기/퀴즈/단어수집 시 통계 업데이트 및 배지 체크 연동

* fix: add PATCH method to CORS AllowMethods

* test: BadgeType 개수 테스트 수정 (15 -> 29)

* fix: CORS PATCH 메서드 추가

* docs: 뉴스 기능 프론트엔드 연동 가이드 작성

* fix: NewsCollectionFunction에 Bedrock, Comprehend 권한 추가

* fix: add null check for collectWord request body

- Add INVALID_REQUEST error code to NewsErrorCode
- Check body and word field before accessing in collectWord()
- Prevents NullPointerException when request body is malformed

* feat: enhance stats API and bookmark response for frontend

- Add DAILY stats update for news read/quiz/word collection
- Add /stats/dashboard endpoint with frontend-requested format
  - today: wordsLearned, newsRead, quizzesTaken, wordsTotal
  - overall: totalWordsLearned, totalNewsRead, averageAccuracy, streaks
  - weeklyProgress: last 7 days with date/wordsLearned/newsRead
- Add news-related fields to all stats API responses
- Fix bookmark API to include full article details (title, summary, etc.)

* feat: add category classification to news AI analysis

- Add category field to AnalysisResult record
- Update Bedrock prompt to classify articles into categories
  (WORLD, POLITICS, BUSINESS, TECH, SCIENCE, HEALTH, SPORTS, ENTERTAINMENT, LIFESTYLE)
- Parse and set category from AI response
- Set GSI2 (CATEGORY#) index when category is available

* fix: add /stats/dashboard endpoint to template.yaml

* fix: filter by ARTICLE# prefix in findById to avoid returning UserNewsRecord

* docs: add News API troubleshooting guide

* feat: add Cognito authorizer to News API and enhance keyword extraction

- Set CognitoAuthorizer for all News API endpoints in template.yaml
- Update Bedrock AI to extract keywords with meanings and examples
- Add fallback to Comprehend for keyword extraction when Bedrock fails
- Modify KeywordInfo model to include example field
- Adjust AI prompt to include keyword extraction with examples
- Update AnalysisResult to store keywords and parse them from AI response

* Revert "Merge branch 'test' into prod"

This reverts commit c1a958eac6799d5838a76e4078ae304bcdb62278, reversing
changes made to a6662e0cfc46c6e12f20a89f0df285ff282160bc.

* feat: enhance bookmark and reading status tracking for News API

- Add bookmark and reading status to individual article responses
- Include bookmark status in paginated news responses
- Modify `KeywordInfo` to support Korean translations (`meaningKo`)
- Update AI prompts to extract Korean meanings for keywords

* refactor : session_id가 null 체크 추가

* feat : template 환경변수 리펙토링

* fix : sessionId NullPointerException 에러 수정  (#496)

* feat : WebSocket Connect, Disconnect 핸들러 & SpeakingConnecion 모델 구현

* feat : WebSocket 메시지 처리 handler, service 구현

* feat : WebSocket 연결 정보 Repository 구현

* fix : 오타 수정

* refactor : websocket -> rest api 전환

* feat : speaking handler REST로 교체

* feat : speaking 관련 dto 생성

* refacotor : 기존 service 코드 로직 재사용 및 repository 리펙토링

* feat : speaking rest API 람다 함수 추가

* refactor : speaking service 재사용

* refactor : AI 영어 회화 연습 코드 리팩토링

* feat : handleChat 메서드 JsonNull 체크 푸가

* refactor : session_id가 null 체크 추가

* feat : template 환경변수 리펙토링

---------

Co-authored-by: DDING JOO <ddingsha9@teambind.co.kr>

* feat: enhance bookmark and reading status tracking for News API

- Add bookmark and reading status to individual article responses
- Include bookmark status in paginated news responses
- Modify `KeywordInfo` to support Korean translations (`meaningKo`)
- Update AI prompts to extract Korean meanings for keywords

* feat: add category filtering to UserWord API with enhanced query logic

- Introduce `category` filtering to `getUserWords` API
- Update WordCategory enums to include "news" category
- Apply category filter after enrichment with word info
- Adjust query limits for bookmarked and incorrect words queries

* feat: add default value for ExistingCognitoClientId in template.yaml

- Set default to an empty string to ensure compatibility with templates using this parameter without explicitly specifying a value.

* fix: SpeakingHandler getStringOrNull 컴파일 에러 수정

* fix: SpeakingHandler getStringOrNull 컴파일 에러 수정

* fix: Bedrock 키워드(meaningKo 포함)를 article에 저장하도록 수정

* fix: Bedrock 키워드(meaningKo 포함)를 article에 저장하도록 수정

* fix: Bedrock 키워드(meaningKo 포함)를 article에 저장하도록 수정

* feat: add dashboard stats API and enhance news stats tracking

- Introduce `/stats/dashboard` API for retrieving integrated user stats (today, overall, weekly progress, and level distribution)
- Update `UserStats` model to include additional fields for news stats (newsRead, newsQuizCompleted, newsQuizPerfect, newsWordsCollected, etc.)
- Add atomic updates to track news reading, quiz, and word stats in `UserStatsRepository`
- Modify CloudFormation `template.yaml` to register the new `/stats/dashboard` endpoint

* feat: add dashboard stats API and enhance news stats tracking

- Introduce `/stats/dashboard` API for retrieving integrated user stats (today, overall, weekly progress, and level distribution)
- Update `UserStats` model to include additional fields for news stats (newsRead, newsQuizCompleted, newsQuizPerfect, newsWordsCollected, etc.)
- Add atomic updates to track news reading, quiz, and word stats in `UserStatsRepository`
- Modify CloudFormation `template.yaml` to register the new `/stats/dashboard` endpoint

* feat: add dashboard stats API and enhance news stats tracking

- Introduce `/stats/dashboard` API for retrieving integrated user stats (today, overall, weekly progress, and level distribution)
- Update `UserStats` model to include additional fields for news stats (newsRead, newsQuizCompleted, newsQuizPerfect, newsWordsCollected, etc.)
- Add atomic updates to track news reading, quiz, and word stats in `UserStatsRepository`
- Modify CloudFormation `template.yaml` to register the new `/stats/dashboard` endpoint

* refactor: format code with consistent indentation and spacing

- Apply consistent formatting to improve code readability across multiple files
- Adjust indentation, spacing, and alignment in model classes, DTOs, and repository methods

* fix: filter by ARTICLE# prefix in findById to avoid returning bookmark records

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* feat : Speaking 관련 template 람다 함수 및 테이블 추가

* feat : 말하기 기능에 polly 서비스 권한 추가

* feat : transcribe API KEY 추가

---------

Co-authored-by: DDING JOO <ddingsha9@teambind.co.kr>
Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>

* feature : transcribe API KEY 추가  (#516)

* feat: EnvConfig 유틸리티 추가 및 환경 변수 검증 적용

환경 변수 미설정 시 명확한 에러 메시지를 제공하는 EnvConfig 유틸리티를 추가하고,
기존 System.getenv 호출을 EnvConfig.getRequired/getOrDefault로 대체함.

- EnvConfig: getRequired, getOrDefault, getIntOrDefault, getLongOrDefault 메서드 제공
- Lambda Cold Start 시점에 환경 변수 누락을 조기 감지
- 기존 Config 클래스(WebSocketConfig, RoomTokenConfig) EnvConfig 사용으로 통일

Closes #403

* refactor: TestService submitTest 메서드 책임 분리

submitTest 메서드를 단일 책임 원칙에 맞게 리팩토링:
- gradeAnswers(): 답안 채점 및 결과 집계
- isAnswerCorrect(): 단일 답안 정답 여부 판단
- buildResultItem(): 결과 항목 생성
- saveTestResult(): 테스트 결과 저장
- GradingResult record: 채점 결과 캡슐화

TestService와 TestCommandService 모두 동일하게 적용

Closes #404

* refactor: 하드코딩된 설정값 환경 변수로 외부화

각 도메인별 Config 클래스를 생성하여 하드코딩된 값들을 환경 변수로 설정 가능하게 변경.
기본값이 있어 환경 변수 미설정 시에도 기존 동작 유지.

## 새로 추가된 Config 클래스
- GrammarConfig: SESSION_TTL_DAYS, MAX_HISTORY_MESSAGES, MAX_TOKENS 등
- GameConfig: TOTAL_ROUNDS, ROUND_TIME_LIMIT, QUICK_GUESS_THRESHOLD_MS
- VocabularyConfig: NEW_WORDS_COUNT, REVIEW_WORDS_COUNT, 상태 전이 임계값 등

## 지원하는 환경 변수
- GRAMMAR_SESSION_TTL_DAYS, GRAMMAR_MAX_HISTORY_MESSAGES, GRAMMAR_MAX_TOKENS
- GAME_TOTAL_ROUNDS, GAME_ROUND_TIME_LIMIT, GAME_QUICK_GUESS_THRESHOLD_MS
- VOCAB_NEW_WORDS_COUNT, VOCAB_REVIEW_WORDS_COUNT
- VOCAB_TRANSITION_TO_REVIEWING, VOCAB_TRANSITION_TO_MASTERED

Closes #406

* test: StudyLevel enum 단위 테스트 추가

* test: Difficulty enum 단위 테스트 추가

* test: StudyConfig 단위 테스트 추가

* test: EnvConfig 단위 테스트 추가

* test: PaginatedResult 단위 테스트 추가

* test: JsonUtil 단위 테스트 추가

* test: CursorUtil 단위 테스트 추가

* test: CommonErrorCode 단위 테스트 추가

* test: CommonException 단위 테스트 추가

* test: BadgeType enum 단위 테스트 추가

* test: BadgeKey 상수 단위 테스트 추가

* test: WordStatus enum 단위 테스트 추가

* test: TestType enum 단위 테스트 추가

* test: VocabularyConfig 단위 테스트 추가

* test: VocabKey 상수 단위 테스트 추가

* test: VocabularyErrorCode 단위 테스트 추가

* test: VocabularyException 단위 테스트 추가

* test: SpacedRepetitionContext 단위 테스트 추가

* test: GrammarLevel enum 단위 테스트 추가

* test: GrammarConfig 단위 테스트 추가

* test: GrammarErrorCode 단위 테스트 추가

* test: GrammarException 단위 테스트 추가

* test: GameStatus enum 단위 테스트 추가

* test: GameConfig 단위 테스트 추가

* test: ChattingErrorCode 단위 테스트 추가

* test: ChattingException 단위 테스트 추가

* fix: OPIc FeedbackResponse.java 문법 오류 수정

* style: AwsClients 코드 포맷팅

* style: EnvConfig 코드 포맷팅

* style: RoomTokenConfig 코드 포맷팅

* style: WebSocketConfig 코드 포맷팅

* style: JsonUtil 코드 포맷팅

* style: GameConfig 코드 포맷팅

* style: GrammarConfig 코드 포맷팅

* style: GrammarKey 코드 포맷팅

* style: GrammarErrorCode 코드 포맷팅

* style: GrammarException 코드 포맷팅

* style: BedrockGrammarCheckFactory 코드 포맷팅

* style: GrammarConversationService 코드 포맷팅

* style: FeedbackResponse 코드 포맷팅

* style: SessionReportResponse 코드 포맷팅

* style: SpeakingError 코드 포맷팅

* style: SpeakingErrorType 코드 포맷팅

* style: OPIcException 코드 포맷팅

* style: OPIcAnswer 코드 포맷팅

* style: OPIcQuestion 코드 포맷팅

* style: OPIcSession 코드 포맷팅

* style: OPIcRepository 코드 포맷팅

* style: FeedbackService 코드 포맷팅

* style: TranscribeProxyService 코드 포맷팅

* style: VocabularyConfig 코드 포맷팅

* style: DailyStudyCommandService 코드 포맷팅

* style: TestCommandService 코드 포맷팅

* style: TestService 코드 포맷팅

* style: CommonErrorCodeSpec 코드 포맷팅

* style: JsonUtilSpec 코드 포맷팅

* style: BadgeTypeSpec 코드 포맷팅

* style: ChattingErrorCodeSpec 코드 포맷팅

* style: GrammarLevelSpec 코드 포맷팅

* style: GrammarErrorCodeSpec 코드 포맷팅

* style: VocabularyErrorCodeSpec 코드 포맷팅

* feature : OPIc 세션관리 + 답변 처리 파이프라인 구현  (#413)

* feat : OPIc 질문 & 세션 관련 dto 생성

* refactor : @DynamoDbBean 주석 추가

* feat : 주제 + 소주제 + 레벨로 오픽 질문 조회 추가

* feat : OPIc 세션, 질문, 답변 종합 handler 구현

* feat : 오픽 주제, 소주제별 seed 데이터 추가

* refactor : Transcribe API KEY 환경변수명 수정

* refactor : Bedrock에 사용하는 클로드 모델 변경

* refactor : S3 Key 대신 Proxy에서 요청하는 Base64 값으로 변환

* feat: GAME_START, ROUND_END 메시지에 serverTime 추가

- broadcastGameStart(): serverTime, roundDuration 필드 추가
- broadcastRoundEnd(): serverTime, roundStartTime, roundDuration 필드 추가
- GameService.endRound(): data에 roundStartTime, roundDuration 포함
- 타이머 동기화 버그 수정을 위한 서버 시간 제공

* feat: WebSocketMessageHelper 유틸리티 클래스 추가

- domain 필드 포함 메시지 생성 헬퍼
- DOMAIN_CHAT, DOMAIN_GAME 상수 정의
- buildChatMessage(), buildGameMessage() 메서드

* feat: 모든 WebSocket 메시지에 domain 필드 추가

- ScoreUpdateMessage에 domain 필드 추가
- broadcastGameStart에 domain:"game" 추가
- broadcastRoundEnd에 domain:"game" 추가
- broadcastCorrectAnswerMessage에 domain:"game" 추가
- handleCommandResult 시스템 메시지에 domain:"game" 추가
- handleRegularMessage 채팅 메시지에 domain:"chat" 추가

Closes #426, #427

* feat: GameSession 모델 클래스 생성

- DynamoDB Enhanced Client 어노테이션 적용
- GSI1: roomId로 활성 게임 세션 조회 가능
- 게임 상태 관리용 헬퍼 메서드 포함

Closes #428

* feat: GameSessionRepository 구현

- 기본 CRUD (save, findById, delete)
- roomId로 활성/전체 게임 세션 조회
- 상태, 라운드, 점수 업데이트 메서드
- 정답자 추가, 힌트 사용, 게임 종료 처리

Closes #429

* refactor: ChatRoom에서 게임 필드 분리

- 게임 관련 필드 제거 (gameStatus, currentRound 등)
- activeGameSessionId 필드 추가
- 게임 상태는 GameSession으로 분리됨

Note: 의존 코드 수정은 #431에서 진행

Closes #430

* refactor: GameSession 기반으로 전체 게임 로직 리팩토링

- GameService: ChatRoom 대신 GameSession 사용
- GameStatsService: GameSession 매개변수로 변경
- CommandService: GameSession 기반 점수 조회
- GameHandler: GameSession 기반 REST API
- WebSocketMessageHandler: GameSession 기반 브로드캐스트
- GameStatusResponse, ScoreboardResponse: GameSession 매개변수

Closes #431

* feat: GameSessionHandler Lambda 및 게임 세션 API 구현

- POST /rooms/{roomId}/games - 게임 세션 생성
- GET /games/{gameSessionId} - 게임 상태 조회 (재접속용)
- POST /games/{gameSessionId}/start - 게임 시작
- POST /games/{gameSessionId}/stop - 게임 종료

모든 응답에 serverTime 포함 (타이머 동기화)
출제자에게만 currentWord 포함

Closes #432, #433

* feat: 게임 시작 7분 후 자동 종료 기능 구현

- GameConfig에 gameTimeLimit() 메서드 추가 (기본값: 420초)
- GameSchedulerClient 유틸리티 클래스 생성 (EventBridge Scheduler 연동)
- GameService에 스케줄 생성/취소 로직 추가
- GameAutoCloseHandler Lambda 함수 생성
- template.yaml에 Lambda, IAM Role, Schedule Group 추가

Closes #417

* fix : 메모리 증가 및 Lambda 응답 제한 시간 Cognito 트리거 제한시간과 동일하게 수정 (#439)

* feat: 캐치마인드 게임 방 분리 기능 구현 (#455)

- Room 타입 분리 (CHAT/GAME)
  - RoomType, RoomStatus enum 추가
  - ChatRoom 모델에 type, gameType, gameSettings, status, hostId 필드 추가
  - GameSettings 모델 추가

- 방 생성/조회 API 수정
  - CreateRoomRequest에 type, gameType, gameSettings 필드 추가
  - 방 목록 조회 시 type, gameType, status 필터 지원

- 게임 시작 조건 검증
  - GAME 타입 방에서만 게임 시작 가능 (GAME_007 에러)

- 게임 재시작 API 구현 (#452)
  - POST /rooms/{roomId}/game/restart 엔드포인트 추가
  - 방장만 재시작 가능 (GAME_009 에러)
  - 게임 진행 중 재시작 불가 (GAME_008 에러)

- 방장 변경 로직 구현 (#453)
  - 방장 퇴장 시 다음 멤버에게 자동 이전
  - 모든 멤버 퇴장 시 방 자동 삭제

- WebSocket 메시지 타입 추가 (#454)
  - ROOM_STATUS_CHANGE, HOST_CHANGE 메시지 타입 추가
  - WebSocketMessageHelper에 빌더 메서드 추가

- 테스트 추가
  - RoomType, RoomStatus enum 테스트
  - GameSettings 모델 테스트
  - ChattingErrorCode 테스트 업데이트

Related: #440, #441, #442, #443, #444, #445, #446
Closes: #447, #448, #449, #450, #451, #452, #453, #454

* feat: 참가자 닉네임 및 방장 변경 WebSocket 알림 구현 (#456)

- RoomParticipant DTO 추가 (userId, nickname, isHost)
- ChatRoomQueryService에 닉네임 조회 메서드 추가
  - getParticipantsWithNicknames(): 참가자 목록 + 닉네임
  - getHostNickname(): 방장 닉네임 조회
- ChatRoomHandler.getRoom() 응답에 participants, hostNickname 추가
- ChatRoomCommandService.leaveRoom()에서 방장 변경 시 WebSocket 브로드캐스트

Related: #440

* fix: ChatRoomFunction에 UserTable DynamoDB 권한 추가

- 참가자/방장 닉네임 조회를 위한 UserTable 읽기 권한 추가
- DynamoDBReadPolicy로 UserTable 접근 허용

Fixes #457

* fix: GameSettings에 @DynamoDbBean 어노테이션 추가

- DynamoDB Enhanced Client가 중첩 객체를 직렬화/역직렬화할 수 있도록 수정
- ChatRoom 저장/조회 시 GameSettings 변환 오류 해결

Fixes #457

* fix: ChatRoomFunction에 WEBSOCKET_ENDPOINT 환경변수 및 권한 추가

- leaveRoom에서 WebSocketBroadcaster 사용을 위한 환경변수 추가
- execute-api:ManageConnections 권한 추가

* fix: WebSocket Lambda 함수들에 WEBSOCKET_ENDPOINT 환경변수 추가

- WebSocketConnectFunction에 WEBSOCKET_ENDPOINT 추가
- WebSocketDisconnectFunction에 WEBSOCKET_ENDPOINT 추가
- execute-api:ManageConnections 권한 추가

* fix: Grammar WebSocket Lambda 환경 변수 및 권한 추가

- GrammarStreamingConnectFunction에 WEBSOCKET_ENDPOINT 환경 변수 추가
- GrammarStreamingDisconnectFunction에 WEBSOCKET_ENDPOINT 환경 변수 추가
- 두 함수에 execute-api:ManageConnections 권한 추가

* feat: GSI1SK 확장성 있는 재설계 및 DB 레벨 필터링

## 변경 사항

### GSI1SK 포맷 변경
- 기존: {level}#{createdAt}
- 신규: {type}#{gameType}#{status}#{level}#{createdAt}

### 지원 쿼리 패턴
- 전체 방: GSI1PK = "ROOMS"
- 게임방만: begins_with(GSI1SK, "GAME#")
- 캐치마인드만: begins_with(GSI1SK, "GAME#CATCHMIND#")
- 대기중 캐치마인드: begins_with(GSI1SK, "GAME#CATCHMIND#WAITING#")

### 파일 수정
- ChatRoomCommandService.java: 방 생성 시 새 GSI1SK 포맷 적용
- ChatRoomRepository.java: findByFilters() 메서드 추가, updateStatus() 메서드 추가
- ChatRoomQueryService.java: 메모리 필터링 제거, DB 레벨 필터링으로 변경
- GameService.java: 게임 시작/종료 시 방 상태 업데이트 (GSI1SK 포함)

### 마이그레이션
- scripts/migrate-gsi1sk.sh: 기존 데이터 마이그레이션 스크립트
- 37개 기존 방 마이그레이션 완료

* fix: increase stats query limit to 100 days

- Adjust maximum allowable limit for recent stats query from 30 to 100 days to support extended data range responses.

* feat: improve game round and connection management logic

- Added handling for game round timeout (`ROUND_TIMEOUT`) in WebSocketMessageHandler.
- Enhanced game start broadcast to include `currentWord` for the drawer only.
- Updated ConnectionRepository to remove duplicate user connections in the same room.
- Added `currentWordEnglish` to GameSession for better answer verification.
- Normalized ChatRoom levels to match database storage format.
- Updated template.yaml to include DynamoDBReadPolicy for VocabTable.

* refactor: 코드 정리 및 미사용 클래스 제거 (#459)

* refactor: remove unused WebSocketResponseUtil

* refactor: add AutoCloseable to WebSocketBroadcaster

* refactor: remove unused TestService

* refactor: remove unused WordService

* refactor: remove unused DailyStudyService

* refactor: remove unused UserWordService

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* fix: resolve N+1 query in StatsService

* refactor(all): DI 패턴 및 전략 패턴 적용 (#461)

- Repository, Service, Handler에 DI 생성자 추가 (테스트 용이성)
- BadgeService에 Strategy 패턴 적용 (뱃지 조건 검증 로직 분리)

* refactor: relocate and restructure seed data files

- Moved `question-homes.json` and `words.json` from subdirectories to `seed` folder.
- Updated file paths for better organization and clarity.

* chore: seed 데이터 폴더 구조 정리

* feat: add CI/CD pipeline configuration for CodePipeline

* fix: add SNS topic policy and DependsOn for notification rule

* fix: correct paths in buildspec.yml for CodeBuild

* fix: remove hardcoded JAVA_HOME, use runtime default

* fix: add gradle wrapper for CI/CD build

* fix: use single line sam package command with hardcoded bucket

* fix: use existing stack name group2-englishstudy-chatting

* fix: add missing WEBSOCKET_ENDPOINT env var to WebSocket connect functions

* docs: update FRONTEND-API-GUIDE with new RoomType/RoomStatus structure

* feat : WebSocket Connect, Disconnect 핸들러 & SpeakingConnecion 모델 구현

* feat : WebSocket 메시지 처리 handler, service 구현

* feat : WebSocket 연결 정보 Repository 구현

* fix: update WebSocketDisconnectHandler to use GameSession model

- Remove references to deleted ChatRoom game fields
- Use GameSessionRepository to finish active game sessions
- Use ChatRoomRepository.updateStatus() for room state management

* perf: optimize CI/CD build time

- Add pip cache for SAM CLI dependencies
- Enable Gradle parallel builds and build cache
- Add SAM build cache (.aws-sam)
- Use sam build --parallel --cached
- Skip SAM CLI install if already cached
- Remove unnecessary 'clean' to leverage cache

* feat: add custom CodeBuild Docker image with pre-installed tools

- Dockerfile with Java 21 + SAM CLI + Gradle pre-installed
- build-and-push.sh script for ECR deployment
- Updated buildspec.yml for custom image (removes SAM CLI install)
- Expected build time reduction: ~30-40 seconds

* feature : AI 영어 회화 연습 기능 (#468)

* feat : WebSocket Connect, Disconnect 핸들러 & SpeakingConnecion 모델 구현

* feat : WebSocket 메시지 처리 handler, service 구현

* feat : WebSocket 연결 정보 Repository 구현

* fix: remove typo in SpeakingConnectionRepository

* fix : 오타 수정

* chore: trigger build test with custom Docker image

* chore: remove unnecessary newlines and whitespace across WebSocket handlers and related classes

* chore: remove unnecessary newlines and whitespace across WebSocket handlers and related classes

* Release: 캐치마인드 게임 분리, AI 회화 연습, CI/CD 파이프라인 (#469)

* feature : OPIc 세션관리 + 답변 처리 파이프라인 구현  (#413)

* feat : OPIc 질문 & 세션 관련 dto 생성

* refactor : @DynamoDbBean 주석 추가

* feat : 주제 + 소주제 + 레벨로 오픽 질문 조회 추가

* feat : OPIc 세션, 질문, 답변 종합 handler 구현

* feat : 오픽 주제, 소주제별 seed 데이터 추가

* refactor : Transcribe API KEY 환경변수명 수정

* refactor : Bedrock에 사용하는 클로드 모델 변경

* refactor : S3 Key 대신 Proxy에서 요청하는 Base64 값으로 변환

* feat: GAME_START, ROUND_END 메시지에 serverTime 추가

- broadcastGameStart(): serverTime, roundDuration 필드 추가
- broadcastRoundEnd(): serverTime, roundStartTime, roundDuration 필드 추가
- GameService.endRound(): data에 roundStartTime, roundDuration 포함
- 타이머 동기화 버그 수정을 위한 서버 시간 제공

* feat: WebSocketMessageHelper 유틸리티 클래스 추가

- domain 필드 포함 메시지 생성 헬퍼
- DOMAIN_CHAT, DOMAIN_GAME 상수 정의
- buildChatMessage(), buildGameMessage() 메서드

* feat: 모든 WebSocket 메시지에 domain 필드 추가

- ScoreUpdateMessage에 domain 필드 추가
- broadcastGameStart에 domain:"game" 추가
- broadcastRoundEnd에 domain:"game" 추가
- broadcastCorrectAnswerMessage에 domain:"game" 추가
- handleCommandResult 시스템 메시지에 domain:"game" 추가
- handleRegularMessage 채팅 메시지에 domain:"chat" 추가

Closes #426, #427

* feat: GameSession 모델 클래스 생성

- DynamoDB Enhanced Client 어노테이션 적용
- GSI1: roomId로 활성 게임 세션 조회 가능
- 게임 상태 관리용 헬퍼 메서드 포함

Closes #428

* feat: GameSessionRepository 구현

- 기본 CRUD (save, findById, delete)
- roomId로 활성/전체 게임 세션 조회
- 상태, 라운드, 점수 업데이트 메서드
- 정답자 추가, 힌트 사용, 게임 종료 처리

Closes #429

* refactor: ChatRoom에서 게임 필드 분리

- 게임 관련 필드 제거 (gameStatus, currentRound 등)
- activeGameSessionId 필드 추가
- 게임 상태는 GameSession으로 분리됨

Note: 의존 코드 수정은 #431에서 진행

Closes #430

* refactor: GameSession 기반으로 전체 게임 로직 리팩토링

- GameService: ChatRoom 대신 GameSession 사용
- GameStatsService: GameSession 매개변수로 변경
- CommandService: GameSession 기반 점수 조회
- GameHandler: GameSession 기반 REST API
- WebSocketMessageHandler: GameSession 기반 브로드캐스트
- GameStatusResponse, ScoreboardResponse: GameSession 매개변수

Closes #431

* feat: GameSessionHandler Lambda 및 게임 세션 API 구현

- POST /rooms/{roomId}/games - 게임 세션 생성
- GET /games/{gameSessionId} - 게임 상태 조회 (재접속용)
- POST /games/{gameSessionId}/start - 게임 시작
- POST /games/{gameSessionId}/stop - 게임 종료

모든 응답에 serverTime 포함 (타이머 동기화)
출제자에게만 currentWord 포함

Closes #432, #433

* feat: 게임 시작 7분 후 자동 종료 기능 구현

- GameConfig에 gameTimeLimit() 메서드 추가 (기본값: 420초)
- GameSchedulerClient 유틸리티 클래스 생성 (EventBridge Scheduler 연동)
- GameService에 스케줄 생성/취소 로직 추가
- GameAutoCloseHandler Lambda 함수 생성
- template.yaml에 Lambda, IAM Role, Schedule Group 추가

Closes #417

* fix : 메모리 증가 및 Lambda 응답 제한 시간 Cognito 트리거 제한시간과 동일하게 수정 (#439)

* feat: 캐치마인드 게임 방 분리 기능 구현 (#455)

- Room 타입 분리 (CHAT/GAME)
  - RoomType, RoomStatus enum 추가
  - ChatRoom 모델에 type, gameType, gameSettings, status, hostId 필드 추가
  - GameSettings 모델 추가

- 방 생성/조회 API 수정
  - CreateRoomRequest에 type, gameType, gameSettings 필드 추가
  - 방 목록 조회 시 type, gameType, status 필터 지원

- 게임 시작 조건 검증
  - GAME 타입 방에서만 게임 시작 가능 (GAME_007 에러)

- 게임 재시작 API 구현 (#452)
  - POST /rooms/{roomId}/game/restart 엔드포인트 추가
  - 방장만 재시작 가능 (GAME_009 에러)
  - 게임 진행 중 재시작 불가 (GAME_008 에러)

- 방장 변경 로직 구현 (#453)
  - 방장 퇴장 시 다음 멤버에게 자동 이전
  - 모든 멤버 퇴장 시 방 자동 삭제

- WebSocket 메시지 타입 추가 (#454)
  - ROOM_STATUS_CHANGE, HOST_CHANGE 메시지 타입 추가
  - WebSocketMessageHelper에 빌더 메서드 추가

- 테스트 추가
  - RoomType, RoomStatus enum 테스트
  - GameSettings 모델 테스트
  - ChattingErrorCode 테스트 업데이트

Related: #440, #441, #442, #443, #444, #445, #446
Closes: #447, #448, #449, #450, #451, #452, #453, #454

* feat: 참가자 닉네임 및 방장 변경 WebSocket 알림 구현 (#456)

- RoomParticipant DTO 추가 (userId, nickname, isHost)
- ChatRoomQueryService에 닉네임 조회 메서드 추가
  - getParticipantsWithNicknames(): 참가자 목록 + 닉네임
  - getHostNickname(): 방장 닉네임 조회
- ChatRoomHandler.getRoom() 응답에 participants, hostNickname 추가
- ChatRoomCommandService.leaveRoom()에서 방장 변경 시 WebSocket 브로드캐스트

Related: #440

* fix: ChatRoomFunction에 UserTable DynamoDB 권한 추가

- 참가자/방장 닉네임 조회를 위한 UserTable 읽기 권한 추가
- DynamoDBReadPolicy로 UserTable 접근 허용

Fixes #457

* fix: GameSettings에 @DynamoDbBean 어노테이션 추가

- DynamoDB Enhanced Client가 중첩 객체를 직렬화/역직렬화할 수 있도록 수정
- ChatRoom 저장/조회 시 GameSettings 변환 오류 해결

Fixes #457

* fix: ChatRoomFunction에 WEBSOCKET_ENDPOINT 환경변수 및 권한 추가

- leaveRoom에서 WebSocketBroadcaster 사용을 위한 환경변수 추가
- execute-api:ManageConnections 권한 추가

* fix: WebSocket Lambda 함수들에 WEBSOCKET_ENDPOINT 환경변수 추가

- WebSocketConnectFunction에 WEBSOCKET_ENDPOINT 추가
- WebSocketDisconnectFunction에 WEBSOCKET_ENDPOINT 추가
- execute-api:ManageConnections 권한 추가

* fix: Grammar WebSocket Lambda 환경 변수 및 권한 추가

- GrammarStreamingConnectFunction에 WEBSOCKET_ENDPOINT 환경 변수 추가
- GrammarStreamingDisconnectFunction에 WEBSOCKET_ENDPOINT 환경 변수 추가
- 두 함수에 execute-api:ManageConnections 권한 추가

* feat: GSI1SK 확장성 있는 재설계 및 DB 레벨 필터링

## 변경 사항

### GSI1SK 포맷 변경
- 기존: {level}#{createdAt}
- 신규: {type}#{gameType}#{status}#{level}#{createdAt}

### 지원 쿼리 패턴
- 전체 방: GSI1PK = "ROOMS"
- 게임방만: begins_with(GSI1SK, "GAME#")
- 캐치마인드만: begins_with(GSI1SK, "GAME#CATCHMIND#")
- 대기중 캐치마인드: begins_with(GSI1SK, "GAME#CATCHMIND#WAITING#")

### 파일 수정
- ChatRoomCommandService.java: 방 생성 시 새 GSI1SK 포맷 적용
- ChatRoomRepository.java: findByFilters() 메서드 추가, updateStatus() 메서드 추가
- ChatRoomQueryService.java: 메모리 필터링 제거, DB 레벨 필터링으로 변경
- GameService.java: 게임 시작/종료 시 방 상태 업데이트 (GSI1SK 포함)

### 마이그레이션
- scripts/migrate-gsi1sk.sh: 기존 데이터 마이그레이션 스크립트
- 37개 기존 방 마이그레이션 완료

* fix: increase stats query limit to 100 days

- Adjust maximum allowable limit for recent stats query from 30 to 100 days to support extended data range responses.

* feat: improve game round and connection management logic

- Added handling for game round timeout (`ROUND_TIMEOUT`) in WebSocketMessageHandler.
- Enhanced game start broadcast to include `currentWord` for the drawer only.
- Updated ConnectionRepository to remove duplicate user connections in the same room.
- Added `currentWordEnglish` to GameSession for better answer verification.
- Normalized ChatRoom levels to match database storage format.
- Updated template.yaml to include DynamoDBReadPolicy for VocabTable.

* refactor: 코드 정리 및 미사용 클래스 제거 (#459)

* refactor: remove unused WebSocketResponseUtil

* refactor: add AutoCloseable to WebSocketBroadcaster

* refactor: remove unused TestService

* refactor: remove unused WordService

* refactor: remove unused DailyStudyService

* refactor: remove unused UserWordService

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* fix: resolve N+1 query in StatsService

* refactor(all): DI 패턴 및 전략 패턴 적용 (#461)

- Repository, Service, Handler에 DI 생성자 추가 (테스트 용이성)
- BadgeService에 Strategy 패턴 적용 (뱃지 조건 검증 로직 분리)

* refactor: relocate and restructure seed data files

- Moved `question-homes.json` and `words.json` from subdirectories to `seed` folder.
- Updated file paths for better organization and clarity.

* chore: seed 데이터 폴더 구조 정리

* feat: add CI/CD pipeline configuration for CodePipeline

* fix: add SNS topic policy and DependsOn for notification rule

* fix: correct paths in buildspec.yml for CodeBuild

* fix: remove hardcoded JAVA_HOME, use runtime default

* fix: add gradle wrapper for CI/CD build

* fix: use single line sam package command with hardcoded bucket

* fix: use existing stack name group2-englishstudy-chatting

* fix: add missing WEBSOCKET_ENDPOINT env var to WebSocket connect functions

* docs: update FRONTEND-API-GUIDE with new RoomType/RoomStatus structure

* fix: update WebSocketDisconnectHandler to use GameSession model

- Remove references to deleted ChatRoom game fields
- Use GameSessionRepository to finish active game sessions
- Use ChatRoomRepository.updateStatus() for room state management

* perf: optimize CI/CD build time

- Add pip cache for SAM CLI dependencies
- Enable Gradle parallel builds and build cache
- Add SAM build cache (.aws-sam)
- Use sam build --parallel --cached
- Skip SAM CLI install if already cached
- Remove unnecessary 'clean' to leverage cache

* feat: add custom CodeBuild Docker image with pre-installed tools

- Dockerfile with Java 21 + SAM CLI + Gradle pre-installed
- build-and-push.sh script for ECR deployment
- Updated buildspec.yml for custom image (removes SAM CLI install)
- Expected build time reduction: ~30-40 seconds

* feature : AI 영어 회화 연습 기능 (#468)

* feat : WebSocket Connect, Disconnect 핸들러 & SpeakingConnecion 모델 구현

* feat : WebSocket 메시지 처리 handler, service 구현

* feat : WebSocket 연결 정보 Repository 구현

* fix: remove typo in SpeakingConnectionRepository

* chore: trigger build test with custom Docker image

* chore: remove unnecessary newlines and whitespace across WebSocket handlers and related classes

* chore: remove unnecessary newlines and whitespace across WebSocket handlers and related classes

---------

Co-authored-by: hyein Heo <128613248+hye-inA@users.noreply.github.com>

* refactor : websocket -> rest api 전환

* feat : speaking handler REST로 교체

* feat : speaking 관련 dto 생성

* refacotor : 기존 service 코드 로직 재사용 및 repository 리펙토링

* fix: add CORS headers to API Gateway error responses (#479)

API Gateway의 인증 실패 등 에러 응답에 CORS 헤더가 누락되어
CloudFront를 통한 프론트엔드 요청이 차단되는 문제 수정

- UNAUTHORIZED (401) 응답에 CORS 헤더 추가
- ACCESS_DENIED (403) 응답에 CORS 헤더 추가
- DEFAULT_4XX/5XX 응답에 CORS 헤더 추가
- EXPIRED_TOKEN 응답에 CORS 헤더 추가

* feat(news): 뉴스 도메인 기반 구조 구축 (#385)

- NewsCategory, QuizType enum 추가
- NewsKey 상수 클래스 추가
- NewsErrorCode 예외 클래스 추가
- NewsArticle, KeywordInfo, QuizQuestion 모델 추가
- NewsArticleRepository CRUD 구현
- NewsTable DynamoDB 테이블 정의
- CORS GatewayResponses 설정 추가

* feat(news): 뉴스 수집 파이프라인 구현 (#386)

- NewsApiClient: NewsAPI 연동 서비스
- RssFeedParser: RSS 피드 파싱 (BBC, VOA, NPR)
- NewsDuplicateChecker: URL 기반 중복 필터링
- NewsCollectorService: 수집 오케스트레이션
- NewsCollectionHandler: Lambda 핸들러
- EventBridge 스케줄러: 매일 18시 KST 실행

* refactor(news): NewsAPI 제거, RSS만 사용

- NewsApiClient 삭제
- SSM Parameter 의존성 제거
- RSS 소스당 7개씩 수집 (BBC, VOA, NPR = 약 21개/일)

* feat(news): AI 뉴스 분석 시스템 구현 (#387)

- NewsAnalysisService: AI 분석 통합 서비스
  - Bedrock: CEFR 난이도 분석 (A1~C2)
  - Bedrock: 3줄 요약 + 퀴즈 3문제 생성
  - Comprehend: 핵심 키워드 추출
- NewsCollectorService: 수집 시 자동 분석 연동
- GSI1/GSI2 키 자동 설정 (레벨별, 카테고리별 조회)

* feat(news): 뉴스 학습 API 구현 (#388)

- NewsQueryService: 뉴스 조회 서비스
- NewsHandler: API 핸들러
  - GET /news - 목록 조회 (level, category 필터)
  - GET /news/today - 오늘의 뉴스
  - GET /news/recommended - 내 레벨 맞춤 추천
  - GET /news/{articleId} - 상세 조회 (조회수 증가)
- template.yaml: NewsFunction Lambda 추가

* feat(news): 뉴스 학습 부가 기능 구현 (#389)

- 읽기 완료 기록 API (POST /news/{articleId}/read)
- 북마크 토글 API (POST /news/{articleId}/bookmark)
- 북마크 목록 조회 API (GET /news/bookmarks)
- 학습 통계 조회 API (GET /news/stats)
- TTS 오디오 URL 조회 API (GET /news/{articleId}/audio)
- UserNewsRecord 모델 추가
- UserNewsRepository 추가
- NewsLearningService 추가

* feat(news): 복합 퀴즈 시스템 구현 (#471)

- 퀴즈 조회 API (GET /news/{articleId}/quiz)
- 퀴즈 제출 API (POST /news/{articleId}/quiz)
- 퀴즈 기록 조회 API (GET /news/quiz/history)
- NewsQuizResult 모델 추가
- QuizAnswerResult 모델 추가
- NewsQuizRepository 추가
- NewsQuizService 추가

* feat(news): 단어 수집 & Vocabulary 연동 구현 (#472)

- 단어 수집 API (POST /news/{articleId}/words)
- 수집 단어 목록 API (GET /news/words)
- 단어 상세 조회 API (GET /news/{articleId}/words/{word})
- 단어 삭제 API (DELETE /news/{articleId}/words/{word})
- Vocabulary 연동 API (POST /news/words/{word}/sync)
- NewsWordCollect 모델 추가
- NewsWordRepository 추가
- NewsWordService 추가

* feat: add multi-environment deployment support (dev/test/prod)

* fix: update buildspec.yml to deploy prod environment with parameter overrides

* feat(news): 뉴스 도메인 기반 구조 구축 (#385)

- NewsCategory, QuizType enum 추가
- NewsKey 상수 클래스 추가
- NewsErrorCode 예외 클래스 추가
- NewsArticle, KeywordInfo, QuizQuestion 모델 추가
- NewsArticleRepository CRUD 구현
- NewsTable DynamoDB 테이블 정의
- CORS GatewayResponses 설정 추가

* feat(news): 뉴스 수집 파이프라인 구현 (#386)

- NewsApiClient: NewsAPI 연동 서비스
- RssFeedParser: RSS 피드 파싱 (BBC, VOA, NPR)
- NewsDuplicateChecker: URL 기반 중복 필터링
- NewsCollectorService: 수집 오케스트레이션
- NewsCollectionHandler: Lambda 핸들러
- EventBridge 스케줄러: 매일 18시 KST 실행

* refactor(news): NewsAPI 제거, RSS만 사용

- NewsApiClient 삭제
- SSM Parameter 의존성 제거
- RSS 소스당 7개씩 수집 (BBC, VOA, NPR = 약 21개/일)

* feat(news): AI 뉴스 분석 시스템 구현 (#387)

- NewsAnalysisService: AI 분석 통합 서비스
  - Bedrock: CEFR 난이도 분석 (A1~C2)
  - Bedrock: 3줄 요약 + 퀴즈 3문제 생성
  - Comprehend: 핵심 키워드 추출
- NewsCollectorService: 수집 시 자동 분석 연동
- GSI1/GSI2 키 자동 설정 (레벨별, 카테고리별 조회)

* feat(news): 뉴스 학습 API 구현 (#388)

- NewsQueryService: 뉴스 조회 서비스
- NewsHandler: API 핸들러
  - GET /news - 목록 조회 (level, category 필터)
  - GET /news/today - 오늘의 뉴스
  - GET /news/recommended - 내 레벨 맞춤 추천
  - GET /news/{articleId} - 상세 조회 (조회수 증가)
- template.yaml: NewsFunction Lambda 추가

* feat(news): 뉴스 학습 부가 기능 구현 (#389)

- 읽기 완료 기록 API (POST /news/{articleId}/read)
- 북마크 토글 API (POST /news/{articleId}/bookmark)
- 북마크 목록 조회 API (GET /news/bookmarks)
- 학습 통계 조회 API (GET /news/stats)
- TTS 오디오 URL 조회 API (GET /news/{articleId}/audio)
- UserNewsRecord 모델 추가
- UserNewsRepository 추가
- NewsLearningService 추가

* feat(news): 복합 퀴즈 시스템 구현 (#471)

- 퀴즈 조회 API (GET /news/{articleId}/quiz)
- 퀴즈 제출 API (POST /news/{articleId}/quiz)
- 퀴즈 기록 조회 API (GET /news/quiz/history)
- NewsQuizResult 모델 추가
- QuizAnswerResult 모델 추가
- NewsQuizRepository 추가
- NewsQuizService 추가

* feat(news): 단어 수집 & Vocabulary 연동 구현 (#472)

- 단어 수집 API (POST /news/{articleId}/words)
- 수집 단어 목록 API (GET /news/words)
- 단어 상세 조회 API (GET /news/{articleId}/words/{word})
- 단어 삭제 API (DELETE /news/{articleId}/words/{word})
- Vocabulary 연동 API (POST /news/words/{word}/sync)
- NewsWordCollect 모델 추가
- NewsWordRepository 추가
- NewsWordService 추가

* feat: add multi-environment deployment support (dev/test/prod)

* fix: update buildspec.yml to deploy prod environment with parameter overrides

* refactor : AI 말하기 Websocket 구현 -> REST API 구현으로 리팩토링 (#490)

* feat : WebSocket Connect, Disconnect 핸들러 & SpeakingConnecion 모델 구현

* feat : WebSocket 메시지 처리 handler, service 구현

* feat : WebSocket 연결 정보 Repository 구현

* fix : 오타 수정

* refactor : websocket -> rest api 전환

* feat : speaking handler REST로 교체

* feat : speaking 관련 dto 생성

* refacotor : 기존 service 코드 로직 재사용 및 repository 리펙토링

* fix: revert buildspec.yml to build-only for CloudFormation deploy stage

* fix: revert buildspec.yml to build-only for CloudFormation deploy stage

* fix: update all API Gateway StageName to use Environment parameter

* fix: correct VocabularyTable and ContentBucket references in NewsFunction

* fix: correct VocabularyTable and ContentBucket references in NewsFunction

* fix: add stack name prefix to GameScheduleGroup and daily-stats schedule to avoid conflicts

* fix: add stack name prefix to GameScheduleGroup and daily-stats schedule to avoid conflicts

* feat: add support for existing Cognito User Pool reuse across environments

* fix: add conditional Cognito ARN reference in API Gateway Authorizer

* fix: remove Cognito resources completely, use existing Cognito only

* fix: remove Cognito resources completely, use existing Cognito only

* feat : speaking rest API 람다 함수 추가

* feat: add S3 bucket resource and fix environment-specific endpoints

- Add ContentBucket S3 resource for content storage
- Replace hardcoded /dev with ${Environment} in all WebSocket endpoints
- Update Output URLs to use dynamic environment stage


* fix: add stack name prefix to news-collection schedule name

Prevent EventBridge rule name conflicts across environments


* fix: add X-Requested-With and Accept headers to CORS config

Enable additional headers for CloudFront CORS compatibility


* fix: use environment variable for S3 bucket URLs

Replace hardcoded bucket name with BUCKET_NAME env var for multi-env support:
- PreSignUpHandler: dynamic default profile URL
- PostConfirmationHandler: dynamic default profile URL
- UserService: dynamic default profile URL
- BadgeType: dynamic badge image base URL


* fix: disable authorizer for CORS preflight requests

Add AddDefaultAuthorizerToCorsPreflight: false to prevent
Cognito Authorizer from blocking OPTIONS requests


* feat : speaking REST API 람다 함수 추가  (#491)

* feature : OPIc 세션관리 + 답변 처리 파이프라인 구현  (#413)

* feat : OPIc 질문 & 세션 관련 dto 생성

* refactor : @DynamoDbBean 주석 추가

* feat : 주제 + 소주제 + 레벨로 오픽 질문 조회 추가

* feat : OPIc 세션, 질문, 답변 종합 handler 구현

* feat : 오픽 주제, 소주제별 seed 데이터 추가

* refactor : Transcribe API KEY 환경변수명 수정

* refactor : Bedrock에 사용하는 클로드 모델 변경

* refactor : S3 Key 대신 Proxy에서 요청하는 Base64 값으로 변환

* feat: GAME_START, ROUND_END 메시지에 serverTime 추가

- broadcastGameStart(): serverTime, roundDuration 필드 추가
- broadcastRoundEnd(): serverTime, roundStartTime, roundDuration 필드 추가
- GameService.endRound(): data에 roundStartTime, roundDuration 포함
- 타이머 동기화 버그 수정을 위한 서버 시간 제공

* feat: WebSocketMessageHelper 유틸리티 클래스 추가

- domain 필드 포함 메시지 생성 헬퍼
- DOMAIN_CHAT, DOMAIN_GAME 상수 정의
- buildChatMessage(), buildGameMessage() 메서드

* feat: 모든 WebSocket 메시지에 domain 필드 추가

- ScoreUpdateMessage에 domain 필드 추가
- broadcastGameStart에 domain:"game" 추가
- broadcastRoundEnd에 domain:"game" 추가
- broadcastCorrectAnswerMessage에 domain:"game" 추가
- handleCommandResult 시스템 메시지에 domain:"game" 추가
- handleRegularMessage 채팅 메시지에 domain:"chat" 추가

Closes #426, #427

* feat: GameSession 모델 클래스 생성

- DynamoDB Enhanced Client 어노테이션 적용
- GSI1: roomId로 활성 게임 세션 조회 가능
- 게임 상태 관리용 헬퍼 메서드 포함

Closes #428

* feat: GameSessionRepository 구현

- 기본 CRUD (save, findById, delete)
- roomId로 활성/전체 게임 세션 조회
- 상태, 라운드, 점수 업데이트 메서드
- 정답자 추가, 힌트 사용, 게임 종료 처리

Closes #429

* refactor: ChatRoom에서 게임 필드 분리

- 게임 관련 필드 제거 (gameStatus, currentRound 등)
- activeGameSessionId 필드 추가
- 게임 상태는 GameSession으로 분리됨

Note: 의존 코드 수정은 #431에서 진행

Closes #430

* refactor: GameSession 기반으로 전체 게임 로직 리팩토링

- GameService: ChatRoom 대신 GameSession 사용
- GameStatsService: GameSession 매개변수로 변경
- CommandService: GameSession 기반 점수 조회
- GameHandler: GameSession 기반 REST API
- WebSocketMessageHandler: GameSession 기반 브로드캐스트
- GameStatusResponse, ScoreboardResponse: GameSession 매개변수

Closes #431

* feat: GameSessionHandler Lambda 및 게임 세션 API 구현

- POST /rooms/{roomId}/games - 게임 세션 생성
- GET /games/{gameSessionId} - 게임 상태 조회 (재접속용)
- POST /games/{gameSessionId}/start - 게임 시작
- POST /games/{gameSessionId}/stop - 게임 종료

모든 응답에 serverTime 포함 (타이머 동기화)
출제자에게만 currentWord 포함

Closes #432, #433

* feat: 게임 시작 7분 후 자동 종료 기능 구현

- GameConfig에 gameTimeLimit() 메서드 추가 (기본값: 420초)
- GameSchedulerClient 유틸리티 클래스 생성 (EventBridge Scheduler 연동)
- GameService에 스케줄 생성/취소 로직 추가
- GameAutoCloseHandler Lambda 함수 생성
- template.yaml에 Lambda, IAM Role, Schedule Group 추가

Closes #417

* fix : 메모리 증가 및 Lambda 응답 제한 시간 Cognito 트리거 제한시간과 동일하게 수정 (#439)

* feat: 캐치마인드 게임 방 분리 기능 구현 (#455)

- Room 타입 분리 (CHAT/GAME)
  - RoomType, RoomStatus enum 추가
  - ChatRoom 모델에 type, gameType, gameSettings, status, hostId 필드 추가
  - GameSettings 모델 추가

- 방 생성/조회 API 수정
  - CreateRoomRequest에 type, gameType, gameSettings 필드 추가
  - 방 목록 조회 시 type, gameType, status 필터 지원

- 게임 시작 조건 검증
  - GAME 타입 방에서만 게임 시작 가능 (GAME_007 에러)

- 게임 재시작 API 구현 (#452)
  - POST /rooms/{roomId}/game/restart 엔드포인트 추가
  - 방장만 재시작 가능 (GAME_009 에러)
  - 게임 진행 중 재시작 불가 (GAME_008 에러)

- 방장 변경 로직 구현 (#453)
  - 방장 퇴장 시 다음 멤버에게 자동 이전
  - 모든 멤버 퇴장 시 방 자동 삭제

- WebSocket 메시지 타입 추가 (#454)
  - ROOM_STATUS_CHANGE, HOST_CHANGE 메시지 타입 추가
  - WebSocketMessageHelper에 빌더 메서드 추가

- 테스트 추가
  - RoomType, RoomStatus enum 테스트
  - GameSettings 모델 테스트
  - ChattingErrorCode 테스트 업데이트

Related: #440, #441, #442, #443, #444, #445, #446
Closes: #447, #448, #449, #450, #451, #452, #453, #454

* feat: 참가자 닉네임 및 방장 변경 WebSocket 알림 구현 (#456)

- RoomParticipant DTO 추가 (userId, nickname, isHost)
- ChatRoomQueryService에 닉네임 조회 메서드 추가
  - getParticipantsWithNicknames(): 참가자 목록 + 닉네임
  - getHostNickname(): 방장 닉네임 조회
- ChatRoomHandler.getRoom() 응답에 participants, hostNickname 추가
- ChatRoomCommandService.leaveRoom()에서 방장 변경 시 WebSocket 브로드캐스트

Related: #440

* fix: ChatRoomFunction에 UserTable DynamoDB 권한 추가

- 참가자/방장 닉네임 조회를 위한 UserTable 읽기 권한 추가
- DynamoDBReadPolicy로 UserTable 접근 허용

Fixes #457

* fix: GameSettings에 @DynamoDbBean 어노테이션 추가

- DynamoDB Enhanced Client가 중첩 객체를 직렬화/역직렬화할 수 있도록 수정
- ChatRoom 저장/조회 시 GameSettings 변환 오류 해결

Fixes #457

* fix: ChatRoomFunction에 WEBSOCKET_ENDPOINT 환경변수 및 권한 추가

- leaveRoom에서 WebSocketBroadcaster 사용을 위한 환경변수 추가
- execute-api:ManageConnections 권한 추가

* fix: WebSocket Lambda 함수들에 WEBSOCKET_ENDPOINT 환경변수 추가

- WebSocketConnectFunction에 WEBSOCKET_ENDPOINT 추가
- WebSocketDisconnectFunction에 WEBSOCKET_ENDPOINT 추가
- execute-api:ManageConnections 권한 추가

* fix: Grammar WebSocket Lambda 환경 변수 및 권한 추가

- GrammarStreamingConnectFunction에 WEBSOCKET_ENDPOINT 환경 변수 추가
- GrammarStreamingDisconnectFunction에 WEBSOCKET_ENDPOINT 환경 변수 추가
- 두 함수에 execute-api:ManageConnections 권한 추가

* feat: GSI1SK 확장성 있는 재설계 및 DB 레벨 필터링

- 기존: {level}#{createdAt}
- 신규: {type}#{gameType}#{status}#{level}#{createdAt}

- 전체 방: GSI1PK = "ROOMS"
- 게임방만: begins_with(GSI1SK, "GAME#")
- 캐치마인드만: begins_with(GSI1SK, "GAME#CATCHMIND#")
- 대기중 캐치마인드: begins_with(GSI1SK, "GAME#CATCHMIND#WAITING#")

- ChatRoomCommandService.java: 방 생성 시 새 GSI1SK 포맷 적용
- ChatRoomRepository.java: findByFilters() 메서드 추가, updateStatus() 메서드 추가
- ChatRoomQueryService.java: 메모리 필터링 제거, DB 레벨 필터링으로 변경
- GameService.java: 게임 시작/종료 시 방 상태 업데이트 (GSI1SK 포함)

- scripts/migrate-gsi1sk.sh: 기존 데이터 마이그레이션 스크립트
- 37개 기존 방 마이그레이션 완료

* fix: increase stats query limit to 100 days

- Adjust maximum allowable limit for recent stats query from 30 to 100 days to support extended data range responses.

* feat: improve game round and connection management logic

- Added handling for game round timeout (`ROUND_TIMEOUT`) in WebSocketMessageHandler.
- Enhanced game start broadcast to include `currentWord` for the drawer only.
- Updated ConnectionRepository to remove duplicate user connections in the same room.
- Added `currentWordEnglish` to GameSession for better answer verification.
- Normalized ChatRoom levels to match database storage format.
- Updated template.yaml to include DynamoDBReadPolicy for VocabTable.

* refactor: 코드 정리 및 미사용 클래스 제거 (#459)

* refactor: remove unused WebSocketResponseUtil

* refactor: add AutoCloseable to WebSocketBroadcaster

* refactor: remove unused TestService

* refactor: remove unused WordService

* refactor: remove unused DailyStudyService

* refactor: remove unused UserWordService

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* fix: resolve N+1 query in StatsService

* refactor(all): DI 패턴 및 전략 패턴 적용 (#461)

- Repository, Service, Handler에 DI 생성자 추가 (테스트 용이성)
- BadgeService에 Strategy 패턴 적용 (뱃지 조건 검증 로직 분리)

* refactor: relocate and restructure seed data files

- Moved `question-homes.json` and `words.json` from subdirectories to `seed` folder.
- Updated file paths for better organization and clarity.

* chore: seed 데이터 폴더 구조 정리

* feat: add CI/CD pipeline configuration for CodePipeline

* fix: add SNS topic policy and DependsOn for notification rule

* fix: correct paths in buildspec.yml for CodeBuild

* fix: remove hardcoded JAVA_HOME, use runtime default

* fix: add gradle wrapper for CI/CD build

* fix: use single line sam package command with hardcoded bucket

* fix: use existing stack name group2-englishstudy-chatting

* fix: add missing WEBSOCKET_ENDPOINT env var to WebSocket connect functions

* docs: update FRONTEND-API-GUIDE with new RoomType/RoomStatus structure

* feat : WebSocket Connect, Disconnect 핸들러 & SpeakingConnecion 모델 구현

* feat : WebSocket 메시지 처리 handler, service 구현

* feat : WebSocket 연결 정보 Repository 구현

* fix: update WebSocketDisconnectHandler to use GameSession model

- Remove references to deleted ChatRoom game fields
- Use GameSessionRepository to finish active game sessions
- Use ChatRoomRepository.updateStatus() for room state management

* perf: optimize CI/CD build time

- Add pip cache for SAM CLI dependencies
- Enable Gradle parallel builds and build cache
- Add SAM build cache (.aws-sam)
- Use sam build --parallel --cached
- Skip SAM CLI install if already cached
- Remove unnecessary 'clean' to leverage cache

* feat: add custom CodeBuild Docker image with pre-installed tools

- Dockerfile with Java 21 + SAM CLI + Gradle pre-installed
- build-and-push.sh script for ECR deployment
- Updated buildspec.yml for custom image (removes SAM CLI install)
- Expected build time reduction: ~30-40 seconds

* feature : AI 영어 회화 연습 기능 (#468)

* feat : WebSocket Connect, Disconnect 핸들러 & SpeakingConnecion 모델 구현

* feat : WebSocket 메시지 처리 handler, service 구현

* feat : WebSocket 연결 정보 Repository 구현

* fix: remove typo in SpeakingConnectionRepository

* fix : 오타 수정

* chore: trigger build test with custom Docker image

* chore: remove unnecessary newlines and whitespace across WebSocket handlers and related classes

* chore: remove unnecessary newlines and whitespace across WebSocket handlers and related classes

* refactor : websocket -> rest api 전환

* feat : speaking handler REST로 교체

* feat : speaking 관련 dto 생성

* refacotor : 기존 service 코드 로직 재사용 및 repository 리펙토링

* fix: add CORS headers to API Gateway error responses (#479)

API Gateway의 인증 실패 등 에러 응답에 CORS 헤더가 누락되어
CloudFront를 통한 프론트엔드 요청이 차단되는 문제 수정

- UNAUTHORIZED (401) 응답에 CORS 헤더 추가
- ACCESS_DENIED (403) 응답에 CORS 헤더 추가
- DEFAULT_4XX/5XX 응답에 CORS 헤더 추가
- EXPIRED_TOKEN 응답에 CORS 헤더 추가

* feat : speaking rest API 람다 함수 추가

---------

Co-authored-by: ddingjoo <ddingsha9@teambind.co.kr>

* refactor : speaking service 재사용

* refactor : AI 영어 회화 연습 코드 리팩토링

* feature : test 벡엔드 서버에 AI 말하기 연습 기능 배포 (#492)

* feat : WebSocket Connect, Disconnect 핸들러 & SpeakingConnecion 모델 구현

* feat : WebSocket 메시지 처리 handler, service 구현

* feat : WebSocket 연결 정보 Repository 구현

* fix : 오타 수정

* refactor : websocket -> rest api 전환

* feat : speaking handler REST로 교체

* feat : speaking 관련 dto 생성

* refacotor : 기존 service 코드 로직 재사용 및 repository 리펙토링

* feat : speaking rest API 람다 함수 추가

* refactor : speaking service 재사용

* refactor : AI 영어 회화 연습 코드 리팩토링

---------

Co-authored-by: DDING JOO <ddingsha9@teambind.co.kr>

* feat : handleChat 메서드 JsonNull 체크 푸가

* feature : handleChat 메서드 JsonNull 체크 추가 (#493)

* feat : WebSocket Connect, Disconnect 핸들러 & SpeakingConnecion 모델 구현

* feat : WebSocket 메시지 처리 handler, service 구현

* feat : WebSocket 연결 정보 Repository 구현

* fix : 오타 수정

* refactor : websocket -> rest api 전환

* feat : speaking handler REST로 교체

* feat : speaking 관련 dto 생성

* refacotor : 기존 service 코드 로직 재사용 및 repository 리펙토링

* feat : speaking rest API 람다 함수 추가

* refactor : speaking service 재사용

* refactor : AI 영어 회화 연습 코드 리팩토링

* feat : handleChat 메서드 JsonNull 체크 푸가

---------

Co-authored-by: DDING JOO <ddingsha9@teambind.co.kr>

* feat(news): 뉴스 학습 배지 시스템 구현 (#473)

- 14개 뉴스 관련 배지 추가 (읽기, 퀴즈, 단어수집, 연속학습, 마스터)
- UserStats에 뉴스 통계 필드 추가
- 6개 뉴스 배지 Strategy 클래스 생성
- 뉴스 읽기/퀴즈/단어수집 시 통계 업데이트 및 배지 체크 연동

* fix: add PATCH method to CORS AllowMethods

* test: BadgeType 개수 테스트 수정 (15 -> 29)

* fix: CORS PATCH 메서드 추가

* docs: 뉴스 기능 프론트엔드 연동 가이드 작성

* fix: NewsCollectionFunction에 Bedrock, Comprehend 권한 추가

* fix: add null check for collectWord request body

- Add INVALID_REQUEST error code to NewsErrorCode
- Check body and word field before accessing in collectWord()
- Prevents NullPointerException when request body is malformed

* feat: enhance stats API and bookmark response for frontend

- Add DAILY stats update for news read/quiz/word collection
- Add /stats/dashboard endpoint with frontend-requested format
  - today: wordsLearned, newsRead, quizzesTaken, wordsTotal
  - overall: totalWordsLearned, totalNewsRead, averageAccuracy, streaks
  - weeklyProgress: last 7 days with date/wordsLearned/newsRead
- Add news-related fields to all stats API responses
- Fix bookmark API to include full article details (title, summary, etc.)

* feat: add category classification to news AI analysis

- Add category field to AnalysisResult record
- Update Bedrock prompt to classify articles into categories
  (WORLD, POLITICS, BUSINESS, TECH, SCIENCE, HEALTH, SPORTS, ENTERTAINMENT, LIFESTYLE)
- Parse and set category from AI response
- Set GSI2 (CATEGORY#) index when category is available

* fix: add /stats/dashboard endpoint to template.yaml

* fix: filter by ARTICLE# prefix in findById to avoid returning UserNewsRecord

* docs: add News API troubleshooting guide

* feat: add Cognito authorizer to News API and enhance keyword extraction

- Set CognitoAuthorizer for all News API endpoints in template.yaml
- Update Bedrock AI to extract keywords with meanings and examples
- Add fallback to Comprehend for keyword extraction when Bedrock fails
- Modify KeywordInfo model to include example field
- Adjust AI prompt to include keyword extraction with examples
- Update AnalysisResult to store keywords and parse them from AI response

* Revert "Merge branch 'test' into prod"

This reverts commit c1a958eac6799d5838a76e4078ae304bcdb62278, reversing
changes made to a6662e0cfc46c6e12f20a89f0df285ff282160bc.

* feat: enhance bookmark and reading status tracking for News API

- Add bookmark and reading status to individual article responses
- Include bookmark status in paginated news responses
- Modify `KeywordInfo` to support Korean translations (`meaningKo`)
- Update AI prompts to extract Korean meanings for keywords

* refactor : session_id가 null 체크 추가

* feat : template 환경변수 리펙토링

* fix : sessionId NullPointerException 에러 수정  (#496)

* feat : WebSocket Connect, Disconnect 핸들러 & SpeakingConnecion 모델 구현

* feat : WebSocket 메시지 처리 handler, service 구현

* feat : WebSocket 연결 정보 Repository 구현

* fix : 오타 수정

* refactor : websocket -> rest api 전환

* feat : speaking handler REST로 교체

* feat : speaking 관련 dto 생성

* refacotor : 기존 service 코드 로직 재사용 및 repository 리펙토링

* feat : speaking rest API 람다 함수 추가

* refactor : speaking service 재사용

* refactor : AI 영어 회화 연습 코드 리팩토링

* feat : handleChat 메서드 JsonNull 체크 푸가

* refactor : session_id가 null 체크 추가

* feat : template 환경변수 리펙토링

---------

Co-authored-by: DDING JOO <ddingsha9@teambind.co.kr>

* feat: enhance bookmark and reading status tracking for News API

- Add bookmark and reading status to individual article responses
- Include bookmark status in paginated news responses
- Modify `KeywordInfo` to support Korean translations (`meaningKo`)
- Update AI prompts to extract Korean meanings for keywords

* feat: add category filtering to UserWord API with enhanced query logic

- Introduce `category` filtering to `getUserWords` API
- Update WordCategory enums to include "news" category
- Apply category filter after enrichment with word info
- Adjust query limits for bookmarked and incorrect words queries

* feat: add default value for ExistingCognitoClientId in template.yaml

- Set default to an empty string to ensure compatibility with templates using this parameter without explicitly specifying a value.

* fix: SpeakingHandler getStringOrNull 컴파일 에러 수정

* fix: SpeakingHandler getStringOrNull 컴파일 에러 수정

* fix: Bedrock 키워드(meaningKo 포함)를 article에 저장하도록 수정

* fix: Bedrock 키워드(meaningKo 포함)를 article에 저장하도록 수정

* fix: Bedrock 키워드(meaningKo 포함)를 article에 저장하도록 수정

* feat: add dashboard stats API and enhance news stats tracking

- Introduce `/stats/dashboard` API for retrieving integrated user stats (today, overall, weekly progress, and level distribution)
- Update `UserStats` model to include additional fields for news stats (newsRead, newsQuizCompleted, newsQuizPerfect, newsWordsCollected, etc.)
- Add atomic updates to track news reading, quiz, and word stats in `UserStatsRepository`
- Modify CloudFormation `template.yaml` to register the new `/stats/dashboard` endpoint

* feat: add dashboard stats API and enhance news stats tracking

- Introduce `/stats/dashboard` API for retrieving integrated user stats (today, overall, weekly progress, and level distribution)
- Update `UserStats` model to include additional fields for news stats (newsRead, newsQuizCompleted, newsQuizPerfect, newsWordsCollected, etc.)
- Add atomic updates to track news reading, quiz, and word stats in `UserStatsRepository`
- Modify CloudFormation `template.yaml` to register the new `/stats/dashboard` endpoint

* feat: add dashboard stats API and enhance news stats tracking

- Introduce `/stats/dashboard` API for retrieving integrated user stats (today, overall, weekly progress, and level distribution)
- Update `UserStats` model to include additional fields for news stats (newsRead, newsQuizCompleted, newsQuizPerfect, newsWordsCollected, etc.)
- Add atomic updates to track news reading, quiz, and word stats in `UserStatsRepository`
- Modify CloudFormation `template.yaml` to register the new `/stats/dashboard` endpoint

* refactor: format code with consistent indentation and spacing

- Apply consistent formatting to improve code readability across multiple files
- Adjust indentation, spacing, and alignment in model classes, DTOs, and repository methods

* fix: filter by ARTICLE# prefix in findById to avoid returning bookmark records


* feat : Speaking 관련 template 람다 함수 및 테이블 추가

* feat : 말하기 기능에 polly 서비스 권한 추가

* feat : transcribe API KEY 추가

---------

Co-authored-by: DDING JOO <ddingsha9@teambind.co.kr>

* feat: 채팅 슬래시 명령어 시스템 고도화

- 게임 관련 명령어 제거 (/start, /stop, /score, /skip, /hint)
- 기본 명령어 추가: /help, /members, /leave, /clear
- 재미 명령어 추가: /dice, /coin, /random
- 투표 시스템 구현: /poll, /vote, /endpoll
- Poll 모델 및 PollRepository 추가
- MessageType에 POLL_CREATE, POLL_VOTE, POLL_END 추가

Closes #518, #519, #520

* feature : Test 브랜치 코드 Prod 브랜치 병합  (#529)

* fix: SpeakingHandler getStringOrNull 컴파일 에러 수정

* fix: Bedrock 키워드(meaningKo 포함)를 article에 저장하도록 수정

* feat: add real-time notification system with SNS/SQS and Lambda Streaming

- Add NotificationTopic and NotificationQueue SNS/SQS infrastructure
- Implement NotificationPublisher service for publishing notifications
- Create NotificationStreamHandler for SSE via Lambda Function URL
- Integrate badge earned notifications in BadgeService
- Add daily study completion notifications in DailyStudyCommandService
- Add test/quiz result notifications in TestCommandService and NewsQuizService
- Add SQS client to AwsClients and JsonUtil helper methods

Closes #500, #501, #502, #505, #506

* feat: add streak reminder and game end notifications

* refactor: extract config classes and apply DRY principle to news/notification domains

* test: add Spock specs for notification and news domain configs

* feature : Speaking Table & Function template.yaml 파일에 추가 (#513)

* fix: BadgeRepository 클라이언트 초기화 패턴 통일

- 개별 DynamoDbEnhancedClient 생성 대신 AwsClients.dynamoDbEnhanced() 싱글톤 사용
- 다른 Repository들과 동일한 패턴 적용
- 불필요한 import 제거

Closes #396

* feat: EnvConfig 유틸리티 추가 및 환경 변수 검증 적용

환경 변수 미설정 시 명확한 에러 메시지를 제공하는 EnvConfig 유틸리티를 추가하고,
기존 System.getenv 호출을 EnvConfig.getRequired/getOrDefault로 대체함.

- EnvConfig: getRequired, getOrDefault, getIntOrDefault, getLongOrDefault 메서드 제공
- Lambda Cold Start 시점에 환경 변수 누락을 조기 감지
- 기존 Config 클래스(WebSocketConfig, RoomTokenConfig) EnvConfig 사용으로 통일

Closes #403

* refactor: TestService submitTest 메서드 책임 분리

submitTest 메서드를 단일 책임 원칙에 맞게 리팩토링:
- gradeAnswers(): 답안 채점 및 결과 집계
- isAnswerCorrect(): 단일 답안 정답 여부 판단
- buildResultItem(): 결과 항목 생성
- saveTestResult(): 테스트 결과 저장
- GradingResult record: 채점 결과 캡슐화

TestService와 TestCommandService 모두 동일하게 적용

Closes #404

* refactor: 하드코딩된 설정값 환경 변수로 외부화

각 도메인별 Config 클래스를 생성하여 하드코딩된 값들을 환경 변수로 설정 가능하게 변경.
기본값이 있어 환경 변수 미설정 시에도 기존 동작 유지.

## 새로 추가된 Config 클래스
- GrammarConfig: SESSION_TTL_DAYS, MAX_HISTORY_MESSAGES, MAX_TOKENS 등
- GameConfig: TOTAL_ROUNDS, ROUND_TIME_LIMIT, QUICK_GUESS_THRESHOLD_MS
- VocabularyConfig: NEW_WORDS_COUNT, REVIEW_WORDS_COUNT, 상태 전이 임계값 등

## 지원하는 환경 변수
- GRAMMAR_SESSION_TTL_DAYS, GRAMMAR_MAX_HISTORY_MESSAGES, GRAMMAR_MAX_TOKENS
- GAME_TOTAL_ROUNDS, GAME_ROUND_TIME_LIMIT, GAME_QUICK_GUESS_THRESHOLD_MS
- VOCAB_NEW_WORDS_COUNT, VOCAB_REVIEW_WORDS_COUNT
- VOCAB_TRANSITION_TO_REVIEWING, VOCAB_TRANSITION_TO_MASTERED

Closes #406

* test: StudyLevel enum 단위 테스트 추가

* test: Difficulty enum 단위 테스트 추가

* test: StudyConfig 단위 테스트 추가

* test: EnvConfig 단위 테스트 추가

* test: PaginatedResult 단위 테스트 추가

* test: JsonUtil 단위 테스트 추가

* test: CursorUtil 단위 테스트 추가

* test: CommonErrorCode 단위 테스트 추가

* test: CommonException 단위 테스트 추가

* test: BadgeType enum 단위 테스트 추가

* test: BadgeKey 상수 단위 테스트 추가

* test: WordStatus enum 단위 테스트 추가

* test: TestType enum 단위 테스트 추가

* test: VocabularyConfig 단위 테스트 추가

* test: VocabKey 상수 단위 테스트 추가

* test: VocabularyErrorCode 단위 테스트 추가

* test: VocabularyException 단위 테스트 추가

* test: SpacedRepetitionContext 단위 테스트 추가

* test: GrammarLevel enum 단위 테스트 추가

* test: GrammarConfig 단위 테스트 추가

* test: GrammarErrorCode 단위 테스트 추가

* test: GrammarException 단위 테스트 추가

* test: GameStatus enum 단위 테스트 추가

* test: GameConfig 단위 테스트 추가

* test: ChattingErrorCode 단위 테스트 추가

* test: ChattingException 단위 테스트 추가

* fix: OPIc FeedbackResponse.java 문법 오류 수정

* style: AwsClients 코드 포맷팅

* style: EnvConfig 코드 포맷팅

* style: RoomTokenConfig 코드 포맷팅

* style: WebSocketConfig 코드 포맷팅

* style: JsonUtil 코드 포맷팅

* style: GameConfig 코드 포맷팅

* style: GrammarConfig 코드 포맷팅

* style: GrammarKey 코드 포맷팅

* style: GrammarErrorCode 코드 포맷팅

* style: GrammarException 코드 포맷팅

* style: BedrockGrammarCheckFactory 코드 포맷팅

* style: GrammarConversationService 코드 포맷팅

* style: FeedbackResponse 코드 포맷팅

* style: SessionReportResponse 코드 포맷팅

* style: SpeakingError 코드 포맷팅

* style: SpeakingErrorType 코드 포맷팅

* style: OPIcException 코드 포맷팅

* style: OPIcAnswer 코드 포맷팅

* style: OPIcQuestion 코드 포맷팅

* style: OPIcSession 코드 포맷팅

* style: OPIcRepository 코드 포맷팅

* style: FeedbackService 코드 포맷팅

* style: TranscribeProxyService 코드 포맷팅

* style: VocabularyConfig 코드 포맷팅

* style: DailyStudyCommandService 코드 포맷팅

* style: TestCommandService 코드 포맷팅

* style: TestService 코드 포맷팅

* style: CommonErrorCodeSpec 코드 포맷팅

* style: JsonUtilSpec 코드 포맷팅

* style: BadgeTypeSpec 코드 포맷팅

* style: ChattingErrorCodeSpec 코드 포맷팅

* style: GrammarLevelSpec 코드 포맷팅

* style: GrammarErrorCodeSpec 코드 포맷팅

* style: VocabularyErrorCodeSpec 코드 포맷팅

* feature : OPIc 세션관리 + 답변 처리 파이프라인 구현  (#413)

* feat : OPIc 질문 & 세션 관련 dto 생성

* refactor : @DynamoDbBean 주석 추가

* feat : 주제 + 소주제 + 레벨로 오픽 질문 조회 추가

* feat : OPIc 세션, 질문, 답변 종합 handler 구현

* feat : 오픽 주제, 소주제별 seed 데이터 추가

* refactor : Transcribe API KEY 환경변수명 수정

* refactor : Bedrock에 사용하는 클로드 모델 변경

* refactor : S3 Key 대신 Proxy에서 요청하는 Base64 값으로 변환

* feat: GAME_START, ROUND_END 메시지에 serverTime 추가

- broadcastGameStart(): serverTime, roundDuration 필드 추가
- broadcastRoundEnd(): serverTime, roundStartTime, roundDuration 필드 추가
- GameService.endRound(): data에 roundStartTime, roundDuration 포함
- 타이머 동기화 버그 수정을 위한 서버 시간 제공

* feat: WebSocketMessageHelper 유틸리티 클래스 추가

- domain 필드 포함 메시지 생성 헬퍼
- DOMAIN_CHAT, DOMAIN_GAME 상수 정의
- buildChatMessage(), buildGameMessage() 메서드

* feat: 모든 WebSocket 메시지에 domain 필드 추가

- ScoreUpdateMessage에 domain 필드 추가
- broadcastGameStart에 domain:"game" 추가
- broadcastRoundEnd에 domain:"game" 추가
- broadcastCorrectAnswerMessage에 domain:"game" 추가
- handleCommandResult 시스템 메시지에 domain:"game" 추가
- handleRegularMessage 채팅 메시지에 domain:"chat" 추가

Closes #426, #427

* feat: GameSession 모델 클래스 생성

- DynamoDB Enhanced Client 어노테이션 적용
- GSI1: roomId로 활성 게임 세션 조회 가능
- 게임 상태 관리용 헬퍼 메서드 포함

Closes #428

* feat: GameSessionRepository 구현

- 기본 CRUD (save, findById, delete)
- roomId로 활성/전체 게임 세션 조회
- 상태, 라운드, 점수 업데이트 메서드
- 정답자 추가, 힌트 사용, 게임 종료 처리

Closes #429

* refactor: ChatRoom에서 게임 필드 분리

- 게임 관련 필드 제거 (gameStatus, currentRound 등)
- activeGameSessionId 필드 추가
- 게임 상태는 GameSession으로 분리됨

Note: 의존 코드 수정은 #431에서 진행

Closes #430

* refactor: GameSession 기반으로 전체 게임 로직 리팩토링

- GameService: ChatRoom 대신 GameSession 사용
- GameStatsService: GameSession 매개변수로 변경
- CommandService: GameSession 기반 점수 조회
- GameHandler: GameSession 기반 REST API
- WebSocketMessageHandler: GameSession 기반 브로드캐스트
- GameStatusResponse, ScoreboardResponse: GameSession 매개변수

Closes #431

* feat: GameSessionHandler Lambda 및 게임 세션 API 구현

- POST /rooms/{roomId}/games - 게임 세션 생성
- GET /games/{gameSessionId} - 게임 상태 조회 (재접속용)
- POST /games/{gameSessionId}/start - 게임 시작
- POST /games/{gameSessionId}/stop - 게임 종료

모든 응답에 serverTime 포함 (타이머 동기화)
출제자에게만 currentWord 포함

Closes #432, #433

* feat: 게임 시작 7분 후 자동 종료 기능 구현

- GameConfig에 gameTimeLimit() 메서드 추가 (기본값: 420초)
- GameSchedulerClient 유틸리티 클래스 생성 (EventBridge Scheduler 연동)
- GameService에 스케줄 생성/취소 로직 추가
- GameAutoCloseHandler Lambda 함수 생성
- template.yaml에 Lambda, IAM Role, Schedule Group 추가

Closes #417

* fix : 메모리 증가 및 Lambda 응답 제한 시간 Cognito 트리거 제한시간과 동일하게 수정 (#439)

* feat: 캐치마인드 게임 방 분리 기능 구현 (#455)

- Room 타입 분리 (CHAT/GAME)
  - RoomType, RoomStatus enum 추가
  - ChatRoom 모델에 type, gameType, gameSettings, status, hostId 필드 추가
  - GameSettings 모델 추가

- 방 생성/조회 API 수정
  - CreateRoomRequest에 type, gameType, gameSettings 필드 추가
  - 방 목록 조회 시 type, gameType, status 필터 지원

- 게임 시작 조건 검증
  - GAME 타입 방에서만 게임 시작 가능 (GAME_007 에러)

- 게임 재시작 API 구현 (#452)
  - POST /rooms/{roomId}/game/restart 엔드포인트 추가
  - 방장만 재시작 가능 (GAME_009 에러)
  - 게임 진행 중 재시작 불가 (GAME_008 에러)

- 방장 변경 로직 구현 (#453)
  - 방장 퇴장 시 다음 멤버에게 자동 이전
  - 모든 멤버 퇴장 시 방 자동 삭제

- WebSocket 메시지 타입 추가 (#454)
  - ROOM_STATUS_CHANGE, HOST_CHANGE 메시지 타입 추가
  - WebSocketMessageHelper에 빌더 메서드 추가

- 테스트 추가
  - RoomType, RoomStatus enum 테스트
  - GameSettings 모델 테스트
  - ChattingErrorCode 테스트 업데이트

Related: #440, #441, #442, #443, #444, #445, #446
Closes: #447, #448, #449, #450, #451, #452, #453, #454

* feat: 참가자 닉네임 및 방장 변경 WebSocket 알림 구현 (#456)

- RoomParticipant DTO 추가 (userId, nickname, isHost)
- ChatRoomQueryService에 닉네임 조회 메서드 추가
  - getParticipantsWithNicknames(): 참가자 목록 + 닉네임
  - getHostNickname(): 방장 닉네임 조회
- ChatRoomHandler.getRoom() 응답에 participants, hostNickname 추가
- ChatRoomCommandService.leaveRoom()에서 방장 변경 시 WebSocket 브로드캐스트

Related: #440

* fix: ChatRoomFunction에 UserTable DynamoDB 권한 추가

- 참가자/방장 닉네임 조회를 위한 UserTable 읽기 권한 추가
- DynamoDBReadPolicy로 UserTable 접근 허용

Fixes #457

* fix: GameSettings에 @DynamoDbBean 어노테이션 추가

- DynamoDB Enhanced Client가 중첩 객체를 직렬화/역직렬화할 수 있도록 수정
- ChatRoom 저장/조회 시 GameSettings 변환 오류 해결

Fixes #457

* fix: ChatRoomFunction에 WEBSOCKET_ENDPOINT 환경변수 및 권한 추가

- leaveRoom에서 WebSocketBroadcaster 사용을 위한 환경변수 추가
- execute-api:ManageConnections 권한 추가

* fix: WebSocket Lambda 함수들에 WEBSOCKET_ENDPOINT 환경변수 추가

- WebSocketConnectFunction에 WEBSOCKET_ENDPOINT 추가
- WebSocketDisconnectFunction에 WEBSOCKET_ENDPOINT 추가
- execute-api:ManageConnections 권한 추가

* fix: Grammar WebSocket Lambda 환경 변수 및 권한 추가

- GrammarStreamingConnectFunction에 WEBSOCKET_ENDPOINT 환경 변수 추가
- GrammarStreamingDisconnectFunction에 WEBSOCKET_ENDPOINT 환경 변수 추가
- 두 함수에 execute-api:ManageConnections 권한 추가

* feat: GSI1SK 확장성 있는 재설계 및 DB 레벨 필터링

## 변경 사항

### GSI1SK 포맷 변경
- 기존: {level}#{createdAt}
- 신규: {type}#{gameType}#{status}#{level}#{createdAt}

### 지원 쿼리 패턴
- 전체 방: GSI1PK = "ROOMS"
- 게임방만: begins_with(GSI1SK, "GAME#")
- 캐치마인드만: begins_with(GSI1SK, "GAME#CATCHMIND#")
- 대기중 캐치마인드: begins_with(GSI1SK, "GAME#CATCHMIND#WAITING#")

### 파일 수정
- ChatRoomCommandService.java: 방 생성 시 새 GSI1SK 포맷 적용
- ChatRoomRepository.java: findByFilters() 메서드 추가, updateStatus() 메서드 추가
- ChatRoomQueryService.java: 메모리 필터링 제거, DB 레벨 필터링으로 변경
- GameService.java: 게임 시작/종료 시 방 상태 업데이트 (GSI1SK 포함)

### 마이그레이션
- scripts/migrate-gsi1sk.sh: 기존 데이터 마이그레이션 스크립트
- 37개 기존 방 마이그레이션 완료

* fix: increase stats query limit to 100 days

- Adjust maximum allowable limit for recent stats query from 30 to 100 days to support extended data range responses.

* feat: improve game round and connection management logic

- Added handling for game round timeout (`ROUND_TIMEOUT`) in WebSocketMessageHandler.
- Enhanced game start broadcast to include `currentWord` for the drawer only.
- Updated ConnectionRepository to remove duplicate user connections in the same room.
- Added `currentWordEnglish` to GameSession for better answer verification.
- Normalized ChatRoom levels to match database storage format.
- Updated template.yaml to include DynamoDBReadPolicy for VocabTable.

* refactor: 코드 정리 및 미사용 클래스 제거 (#459)

* refactor: remove unused WebSocketResponseUtil

* refactor: add AutoCloseable to WebSocketBroadcaster

* refactor: remove unused TestService

* refactor: remove unused WordService

* refactor: remove unused DailyStudyService

* refactor: remove unused UserWordService

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* fix: resolve N+1 query in StatsService

* refactor(all): DI 패턴 및 전략 패턴 적용 (#461)

- Repository, Service, Handler에 DI 생성자 추가 (테스트 용이성)
- BadgeService에 Strategy 패턴 적용 (뱃지 조건 검증 로직 분리)

* refactor: relocate and restructure seed data files

- Moved `question-homes.json` and `words.json` from subdirectories to `seed` folder.
- Updated file paths for better organization and clarity.

* chore: seed 데이터 폴더 구조 정리

* feat: add CI/CD pipeline configuration for CodePipeline

* fix: add SNS topic policy and DependsOn for notification rule

* fix: correct paths in buildspec.yml for CodeBuild

* fix: remove hardcoded JAVA_HOME, use runtime default

* fix: add gradle wrapper for CI/CD build

* fix: use single line sam package command with hardcoded bucket

* fix: use existing stack name group2-englishstudy-chatting

* fix: add missing WEBSOCKET_ENDPOINT env var to WebSocket connect functions

* docs: update FRONTEND-API-GUIDE with new RoomType/RoomStatus structure

* feat : WebSocket Connect, Disconnect 핸들러 & SpeakingConnecion 모델 구현

* feat : WebSocket 메시지 처리 handler, service 구현

* feat : WebSocket 연결 정보 Repository 구현

* fix: update WebSocketDisconnectHandler to use GameSession model

- Remove references to deleted ChatRoom game fields
- Use GameSessionRepository to finish active game sessions
- Use ChatRoomRepository.updateStatus() for room state management

* perf: optimize CI/CD build time

- Add pip cache for SAM CLI dependencies
- Enable Gradle parallel builds and build cache
- Add SAM build cache (.aws-sam)
- Use sam build --parallel --cached
- Skip SAM CLI install if already cached
- Remove unnecessary 'clean' to leverage cache

* feat: add custom CodeBuild Docker image with pre-installed tools

- Dockerfile with Java 21 + SAM CLI + Gradle pre-installed
- build-and-push.sh script for ECR deployment
- Updated buildspec.yml for custom image (removes SAM CLI install)
- Expected build time reduction: ~30-40 seconds

* feature : AI 영어 회화 연습 기능 (#468)

* feat : WebSocket Connect, Disconnect 핸들러 & SpeakingConnecion 모델 구현

* feat : WebSocket 메시지 처리 handler, service 구현

* feat : WebSocket 연결 정보 Repository 구현

* fix: remove typo in SpeakingConnectionRepository

* fix : 오타 수정

* chore: trigger build test with custom Docker image

* chore: remove unnecessary newlines and whitespace across WebSocket handlers and related classes

* chore: remove unnecessary newlines and whitespace across WebSocket handlers and related classes

* Release: 캐치마인드 게임 분리, AI 회화 연습, CI/CD 파이프라인 (#469)

* feature : OPIc 세션관리 + 답변 처리 파이프라인 구현  (#413)

* feat : OPIc 질문 & 세션 관련 dto 생성

* refactor : @DynamoDbBean 주석 추가

* feat : 주제 + 소주제 + 레벨로 오픽 질문 조회 추가

* feat : OPIc 세션, 질문, 답변 종합 handler 구현

* feat : 오픽 주제, 소주제별 seed 데이터 추가

* refactor : Transcribe API KEY 환경변수명 수정

* refactor : Bedrock에 사용하는 클로드 모델 변경

* refactor : S3 Key 대신 Proxy에서 요청하는 Base64 값으로 변환

* feat: GAME_START, ROUND_END 메시지에 serverTime 추가

- broadcastGameStart(): serverTime, roundDuration 필드 추가
- broadcastRoundEnd(): serverTime, roundStartTime, roundDuration 필드 추가
- GameService.endRound(): data에 roundStartTime, roundDuration 포함
- 타이머 동기화 버그 수정을 위한 서버 시간 제공

* feat: WebSocketMessageHelper 유틸리티 클래스 추가

- domain 필드 포함 메시지 생성 헬퍼
- DOMAIN_CHAT, DOMAIN_GAME 상수 정의
- buildChatMessage(), buildGameMessage() 메서드

* feat: 모든 WebSocket 메시지에 domain 필드 추가

- ScoreUpdateMessage에 domain 필드 추가
- broadcastGameStart에 domain:"game" 추가
- broadcastRoundEnd에 domain:"game" 추가
- broadcastCorrectAnswerMessage에 domain:"game" 추가
- handleCommandResult 시스템 메시지에 domain:"game" 추가
- handleRegularMessage 채팅 메시지에 domain:"chat" 추가

Closes #426, #427

* feat: GameSession 모델 클래스 생성

- DynamoDB Enhanced Client 어노테이션 적용
- GSI1: roomId로 활성 게임 세션 조회 가능
- 게임 상태 관리용 헬퍼 메서드 포함

Closes #428

* feat: GameSessionRepository 구현

- 기본 CRUD (save, findById, delete)
- roomId로 활성/전체 게임 세션 조회
- 상태, 라운드, 점수 업데이트 메서드
- 정답자 추가, 힌트 사용, 게임 종료 처리

Closes #429

* refactor: ChatRoom에서 게임 필드 분리

- 게임 관련 필드 제거 (gameStatus, currentRound 등)
- activeGameSessionId 필드 추가
- 게임 상태는 GameSession으로 분리됨

Note: 의존 코드 수정은 #431에서 진행

Closes #430

* refactor: GameSession 기반으로 전체 게임 로직 리팩토링

- GameService: ChatRoom 대신 GameSession 사용
- GameStatsService: GameSession 매개변수로 변경
- CommandService: GameSession 기반 점수 조회
- GameHandler: GameSession 기반 REST API
- WebSocketMessageHandler: GameSession 기반 브로드캐스트
- GameStatusResponse, ScoreboardResponse: GameSession 매개변수

Closes #431

* feat: GameSessionHandler Lambda 및 게임 세션 API 구현

- POST /rooms/{roomId}/games - 게임 세션 생성
- GET /games/{gameSessionId} - 게임 상태 조회 (재접속용)
- POST /games/{gameSessionId}/start - 게임 시작
- POST /games/{gameSessionId}/stop - 게임 종료

모든 응답에 serverTime 포함 (타이머 동기화)
출제자에게만 currentWord 포함

Closes #432, #433

* feat: 게임 시작 7분 후 자동 종료 기능 구현

- GameConfig에 gameTimeLimit() 메서드 추가 (기본값: 420초)
- GameSchedulerClient 유틸리티 클래스 생성 (EventBridge Scheduler 연동)
- GameService에 스케줄 생성/취소 로직 추가
- GameAutoCloseHandler Lambda 함수 생성
- template.yaml에 Lambda, IAM Role, Schedule Group 추가

Closes #417

* fix : 메모리 증가 및 Lambda 응답 제한 시간 Cognito 트리거 제한시간과 동일하게 수정 (#439)

* feat: 캐치마인드 게임 방 분리 기능 구현 (#455)

- Room 타입 분리 (CHAT/GAME)
  - RoomType, RoomStatus enum 추가
  - ChatRoom 모델에 type, gameType, gameSettings, status, hostId 필드 추가
  - GameSettings 모델 추가

- 방 생성/조회 API 수정
  - CreateRoomRequest에 type, gameType, gameSettings 필드 추가
  - 방 목록 조회 시 type, gameType, status 필터 지원

- 게임 시작 조건 검증
  - GAME 타입 방에서만 게임 시작 가능 (GAME_007 에러)

- 게임 재시작 API 구현 (#452)
  - POST /rooms/{roomId}/game/restart 엔드포인트 추가
  - 방장만 재시작 가능 (GAME_009 에러)
  - 게임 진행 중 재시작 불가 (GAME_008 에러)

- 방장 변경 로직 구현 (#453)
  - 방장 퇴장 시 다음 멤버에게 자동 이전
  - 모든 멤버 퇴장 시 방 자동 삭제

- WebSocket 메시지 타입 추가 (#454)
  - ROOM_STATUS_CHANGE, HOST_CHANGE 메시지 타입 추가
  - WebSocketMessageHelper에 빌더 메서드 추가

- 테스트 추가
  - RoomType, RoomStatus enum 테스트
  - GameSettings 모델 테스트
  - ChattingErrorCode 테스트 업데이트

Related: #440, #441, #442, #443, #444, #445, #446
Closes: #447, #448, #449, #450, #451, #452, #453, #454

* feat: 참가자 닉네임 및 방장 변경 WebSocket 알림 구현 (#456)

- RoomParticipant DTO 추가 (userId, nickname, isHost)
- ChatRoomQueryService에 닉네임 조회 메서드 추가
  - getParticipantsWithNicknames(): 참가자 목록 + 닉네임
  - getHostNickname(): 방장 닉네임 조회
- ChatRoomHandler.getRoom() 응답에 participants, hostNickname 추가
- ChatRoomCommandService.leaveRoom()에서 방장 변경 시 WebSocket 브로드캐스트

Related: #440

* fix: ChatRoomFunction에 UserTable DynamoDB 권한 추가

- 참가자/방장 닉네임 조회를 위한 UserTable 읽기 권한 추가
- DynamoDBReadPolicy로 UserTable 접근 허용

Fixes #457

* fix: GameSettings에 @DynamoDbBean 어노테이션 추가

- DynamoDB Enhanced Client가 중첩 객체를 직렬화/역직렬화할 수 있도록 수정
- ChatRoom 저장/조회 시 GameSettings 변환 오류 해결

Fixes #457

* fix: ChatRoomFunction에 WEBSOCKET_ENDPOINT 환경변수 및 권한 추가

- leaveRoom에서 WebSocketBroadcaster 사용을 위한 환경변수 추가
- execute-api:ManageConnections 권한 추가

* fix: WebSocket Lambda 함수들에 WEBSOCKET_ENDPOINT 환경변수 추가

- WebSocketConnectFunction에 WEBSOCKET_ENDPOINT 추가
- WebSocketDisconnectFunction에 WEBSOCKET_ENDPOINT 추가
- execute-api:ManageConnections 권한 추가

* fix: Grammar WebSocket Lambda 환경 변수 및 권한 추가

- GrammarStreamingConnectFunction에 WEBSOCKET_ENDPOINT 환경 변수 추가
- GrammarStreamingDisconnectFunction에 WEBSOCKET_ENDPOINT 환경 변수 추가
- 두 함수에 execute-api:ManageConnections 권한 추가

* feat: GSI1SK 확장성 있는 재설계 및 DB 레벨 필터링

## 변경 사항

### GSI1SK 포맷 변경
- 기존: {level}#{createdAt}
- 신규: {type}#{gameType}#{status}#{level}#{createdAt}

### 지원 쿼리 패턴
- 전체 방: GSI1PK = "ROOMS"
- 게임방만: begins_with(GSI1SK, "GAME#")
- 캐치마인드만: begins_with(GSI1SK, "GAME#CATCHMIND#")
- 대기중 캐치마인드: begins_with(GSI1SK, "GAME#CATCHMIND#WAITING#")

### 파일 수정
- ChatRoomCommandService.java: 방 생성 시 새 GSI1SK 포맷 적용
- ChatRoomRepository.java: findByFilters() 메서드 추가, updateStatus() 메서드 추가
- ChatRoomQueryService.java: 메모리 필터링 제거, DB 레벨 필터링으로 변경
- GameService.java: 게임 시작/종료 시 방 상태 업데이트 (GSI1SK 포함)

### 마이그레이션
- scripts/migrate-gsi1sk.sh: 기존 데이터 마이그레이션 스크립트
- 37개 기존 방 마이그레이션 완료

* fix: increase stats query limit to 100 days

- Adjust maximum allowable limit for recent stats query from 30 to 100 days to support extended data range responses.

* feat: improve game round and connection management logic

- Added handling for game round timeout (`ROUND_TIMEOUT`) in WebSocketMessageHandler.
- Enhanced game start broadcast to include `currentWord` for the drawer only.
- Updated ConnectionRepository to remove duplicate user connections in the same room.
- Added `currentWordEnglish` to GameSession for better answer verification.
- Normalized ChatRoom levels to match database storage format.
- Updated template.yaml to include DynamoDBReadPolicy for VocabTable.

* refactor: 코드 정리 및 미사용 클래스 제거 (#459)

* refactor: remove unused WebSocketResponseUtil

* refactor: add AutoCloseable to WebSocketBroadcaster

* refactor: remove unused TestService

* refactor: remove unused WordService

* refactor: remove unused DailyStudyService

* refactor: remove unused UserWordService

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* fix: resolve N+1 query in StatsService

* refactor(all): DI 패턴 및 전략 패턴 적용 (#461)

- Repository, Service, Handler에 DI 생성자 추가 (테스트 용이성)
- BadgeService에 Strategy 패턴 적용 (뱃지 조건 검증 로직 분리)

* refactor: relocate and restructure seed data files

- Moved `question-homes.json` and `words.json` from subdirectories to `seed` folder.
- Updated file paths for better organization and clarity.

* chore: seed 데이터 폴더 구조 정리

* feat: add CI/CD pipeline configuration for CodePipeline

* fix: add SNS topic policy and DependsOn for notification rule

* fix: correct paths in buildspec.yml for CodeBuild

* fix: remove hardcoded JAVA_HOME, use runtime default

* fix: add gradle wrapper for CI/CD build

* fix: use single line sam package command with hardcoded bucket

* fix: use existing stack name group2-englishstudy-chatting

* fix: add missing WEBSOCKET_ENDPOINT env var to WebSocket connect functions

* docs: update FRONTEND-API-GUIDE with new RoomType/RoomStatus structure

* fix: update WebSocketDisconnectHandler to use GameSession model

- Remove references to deleted ChatRoom game fields
- Use GameSessionRepository to finish active game sessions
- Use ChatRoomRepository.updateStatus() for room state management

* perf: optimize CI/CD build time

- Add pip cache for SAM CLI dependencies
- Enable Gradle parallel builds and build cache
- Add SAM build cache (.aws-sam)
- Use sam build --parallel --cached
- Skip SAM CLI install if already cached
- Remove unnecessary 'clean' to leverage cache

* feat: add custom CodeBuild Docker image with pre-installed tools

- Dockerfile with Java 21 + SAM CLI + Gradle pre-installed
- build-and-push.sh script for ECR deployment
- Updated buildspec.yml for custom image (removes SAM CLI install)
- Expected build time reduction: ~30-40 seconds

* feature : AI 영어 회화 연습 기능 (#468)

* feat : WebSocket Connect, Disconnect 핸들러 & SpeakingConnecion 모델 구현

* feat : WebSocket 메시지 처리 handler, service 구현

* feat : WebSocket 연결 정보 Repository 구현

* fix: remove typo in SpeakingConnectionRepository

* chore: trigger build test with custom Docker image

* chore: remove unnecessary newlines and whitespace across WebSocket handlers and related classes

* chore: remove unnecessary newlines and whitespace across WebSocket handlers and related classes

---------

Co-authored-by: hyein Heo <128613248+hye-inA@users.noreply.github.com>

* refactor : websocket -> rest api 전환

* feat : speaking handler REST로 교체

* feat : speaking 관련 dto 생성

* refacotor : 기존 service 코드 로직 재사용 및 repository 리펙토링

* fix: add CORS headers to API Gateway error responses (#479)

API Gateway의 인증 실패 등 에러 응답에 CORS 헤더가 누락되어
CloudFront를 통한 프론트엔드 요청이 차단되는 문제 수정

- UNAUTHORIZED (401) 응답에 CORS 헤더 추가
- ACCESS_DENIED (403) 응답에 CORS 헤더 추가
- DEFAULT_4XX/5XX 응답에 CORS 헤더 추가
- EXPIRED_TOKEN 응답에 CORS 헤더 추가

* feat(news): 뉴스 도메인 기반 구조 구축 (#385)

- NewsCategory, QuizType enum 추가
- NewsKey 상수 클래스 추가
- NewsErrorCode 예외 클래스 추가
- NewsArticle, KeywordInfo, QuizQuestion 모델 추가
- NewsArticleRepository CRUD 구현
- NewsTable DynamoDB 테이블 정의
- CORS GatewayResponses 설정 추가

* feat(news): 뉴스 수집 파이프라인 구현 (#386)

- NewsApiClient: NewsAPI 연동 서비스
- RssFeedParser: RSS 피드 파싱 (BBC, VOA, NPR)
- NewsDuplicateChecker: URL 기반 중복 필터링
- NewsCollectorService: 수집 오케스트레이션
- NewsCollectionHandler: Lambda 핸들러
- EventBridge 스케줄러: 매일 18시 KST 실행

* refactor(news): NewsAPI 제거, RSS만 사용

- NewsApiClient 삭제
- SSM Parameter 의존성 제거
- RSS 소스당 7개씩 수집 (BBC, VOA, NPR = 약 21개/일)

* feat(news): AI 뉴스 분석 시스템 구현 (#387)

- NewsAnalysisService: AI 분석 통합 서비스
  - Bedrock: CEFR 난이도 분석 (A1~C2)
  - Bedrock: 3줄 요약 + 퀴즈 3문제 생성
  - Comprehend: 핵심 키워드 추출
- NewsCollectorService: 수집 시 자동 분석 연동
- GSI1/GSI2 키 자동 설정 (레벨별, 카테고리별 조회)

* feat(news): 뉴스 학습 API 구현 (#388)

- NewsQueryService: 뉴스 조회 서비스
- NewsHandler: API 핸들러
  - GET /news - 목록 조회 (level, category 필터)
  - GET /news/today - 오늘의 뉴스
  - GET /news/recommended - 내 레벨 맞춤 추천
  - GET /news/{articleId} - 상세 조회 (조회수 증가)
- template.yaml: NewsFunction Lambda 추가

* feat(news): 뉴스 학습 부가 기능 구현 (#389)

- 읽기 완료 기록 API (POST /news/{articleId}/read)
- 북마크 토글 API (POST /news/{articleId}/bookmark)
- 북마크 목록 조회 API (GET /news/bookmarks)
- 학습 통계 조회 API (GET /news/stats)
- TTS 오디오 URL 조회 API (GET /news/{articleId}/audio)
- UserNewsRecord 모델 추가
- UserNewsRepository 추가
- NewsLearningService 추가

* feat(news): 복합 퀴즈 시스템 구현 (#471)

- 퀴즈 조회 API (GET /news/{articleId}/quiz)
- 퀴즈 제출 API (POST /news/{articleId}/quiz)
- 퀴즈 기록 조회 API (GET /news/quiz/history)
- NewsQuizResult 모델 추가
- QuizAnswerResult 모델 추가
- NewsQuizRepository 추가
- NewsQuizService 추가

* feat(news): 단어 수집 & Vocabulary 연동 구현 (#472)

- 단어 수집 API (POST /news/{articleId}/words)
- 수집 단어 목록 API (GET /news/words)
- 단어 상세 조회 API (GET /news/{articleId}/words/{word})
- 단어 삭제 API (DELETE /news/{articleId}/words/{word})
- Vocabulary 연동 API (POST /news/words/{word}/sync)
- NewsWordCollect 모델 추가
- NewsWordRepository 추가
- NewsWordService 추가

* feat: add multi-environment deployment support (dev/test/prod)

* fix: update buildspec.yml to deploy prod environment with parameter overrides

* feat(news): 뉴스 도메인 기반 구조 구축 (#385)

- NewsCategory, QuizType enum 추가
- NewsKey 상수 클래스 추가
- NewsErrorCode 예외 클래스 추가
- NewsArticle, KeywordInfo, QuizQuestion 모델 추가
- NewsArticleRepository CRUD 구현
- NewsTable DynamoDB 테이블 정의
- CORS GatewayResponses 설정 추가

* feat(news): 뉴스 수집 파이프라인 구현 (#386)

- NewsApiClient: NewsAPI 연동 서비스
- RssFeedParser: RSS 피드 파싱 (BBC, VOA, NPR)
- NewsDuplicateChecker: URL 기반 중복 필터링
- NewsCollectorService: 수집 오케스트레이션
- NewsCollectionHandler: Lambda 핸들러
- EventBridge 스케줄러: 매일 18시 KST 실행

* refactor(news): NewsAPI 제거, RSS만 사용

- NewsApiClient 삭제
- SSM Parameter 의존성 제거
- RSS 소스당 7개씩 수집 (BBC, VOA, NPR = 약 21개/일)

* feat(news): AI 뉴스 분석 시스템 구현 (#387)

- NewsAnalysisService: AI 분석 통합 서비스
  - Bedrock: CEFR 난이도 분석 (A1~C2)
  - Bedrock: 3줄 요약 + 퀴즈 3문제 생성
  - Comprehend: 핵심 키워드 추출
- NewsCollectorService: 수집 시 자동 분석 연동
- GSI1/GSI2 키 자동 설정 (레벨별, 카테고리별 조회)

* feat(news): 뉴스 학습 API 구현 (#388)

- NewsQueryService: 뉴스 조회 서비스
- NewsHandler: API 핸들러
  - GET /news - 목록 조회 (level, category 필터)
  - GET /news/today - 오늘의 뉴스
  - GET /news/recommended - 내 레벨 맞춤 추천
  - GET /news/{articleId} - 상세 조회 (조회수 증가)
- template.yaml: NewsFunction Lambda 추가

* feat(news): 뉴스 학습 부가 기능 구현 (#389)

- 읽기 완료 기록 API (POST /news/{articleId}/read)
- 북마크 토글 API (POST /news/{articleId}/bookmark)
- 북마크 목록 조회 API (GET /news/bookmarks)
- 학습 통계 조회 API (GET /news/stats)
- TTS 오디오 URL 조회 API (GET /news/{articleId}/audio)
- UserNewsRecord 모델 추가
- UserNewsRepository 추가
- NewsLearningService 추가

* feat(news): 복합 퀴즈 시스템 구현 (#471)

- 퀴즈 조회 API (GET /news/{articleId}/quiz)
- 퀴즈 제출 API (POST /news/{articleId}/quiz)
- 퀴즈 기록 조회 API (GET /news/quiz/history)
- NewsQuizResult 모델 추가
- QuizAnswerResult 모델 추가
- NewsQuizRepository 추가
- NewsQuizService 추가

* feat(news): 단어 수집 & Vocabulary 연동 구현 (#472)

- 단어 수집 API (POST /news/{articleId}/words)
- 수집 단어 목록 API (GET /news/words)
- 단어 상세 조회 API (GET /news/{articleId}/words/{word})
- 단어 삭제 API (DELETE /news/{articleId}/words/{word})
- Vocabulary 연동 API (POST /news/words/{word}/sync)
- NewsWordCollect 모델 추가
- NewsWordRepository 추가
- NewsWordService 추가

* feat: add multi-environment deployment support (dev/test/prod)

* fix: update buildspec.yml to deploy prod environment with parameter overrides

* refactor : AI 말하기 Websocket 구현 -> REST API 구현으로 리팩토링 (#490)

* feat : WebSocket Connect, Disconnect 핸들러 & SpeakingConnecion 모델 구현

* feat : WebSocket 메시지 처리 handler, service 구현

* feat : WebSocket 연결 정보 Repository 구현

* fix : 오타 수정

* refactor : websocket -> rest api 전환

* feat : speaking handler REST로 교체

* feat : speaking 관련 dto 생성

* refacotor : 기존 service 코드 로직 재사용 및 repository 리펙토링

* fix: revert buildspec.yml to build-only for CloudFormation deploy stage

* fix: revert buildspec.yml to build-only for CloudFormation deploy stage

* fix: update all API Gateway StageName to use Environment parameter

* fix: correct VocabularyTable and ContentBucket references in NewsFunction

* fix: correct VocabularyTable and ContentBucket references in NewsFunction

* fix: add stack name prefix to GameScheduleGroup and daily-stats schedule to avoid conflicts

* fix: add stack name prefix to GameScheduleGroup and daily-stats schedule to avoid conflicts

* feat: add support for existing Cognito User Pool reuse across environments

* fix: add conditional Cognito ARN reference in API Gateway Authorizer

* fix: remove Cognito resources completely, use existing Cognito only

* fix: remove Cognito resources completely, use existing Cognito only

* feat : speaking rest API 람다 함수 추가

* feat: add S3 bucket resource and fix environment-specific endpoints

- Add ContentBucket S3 resource for content storage
- Replace hardcoded /dev with ${Environment} in all WebSocket endpoints
- Update Output URLs to use dynamic environment stage


* fix: add stack name prefix to news-collection schedule name

Prevent EventBridge rule name conflicts across environments


* fix: add X-Requested-With and Accept headers to CORS config

Enable additional headers for CloudFront CORS compatibility


* fix: use environment variable for S3 bucket URLs

Replace hardcoded bucket name with BUCKET_NAME env var for multi-env support:
- PreSignUpHandler: dynamic default profile URL
- PostConfirmationHandler: dynamic default profile URL
- UserService: dynamic default profile URL
- BadgeType: dynamic badge image base URL


* fix: disable authorizer for CORS preflight requests

Add AddDefaultAuthorizerToCorsPreflight: false to prevent
Cognito Authorizer from blocking OPTIONS requests


* feat : speaking REST API 람다 함수 추가  (#491)

* feature : OPIc 세션관리 + 답변 처리 파이프라인 구현  (#413)

* feat : OPIc 질문 & 세션 관련 dto 생성

* refactor : @DynamoDbBean 주석 추가

* feat : 주제 + 소주제 + 레벨로 오픽 질문 조회 추가

* feat : OPIc 세션, 질문, 답변 종합 handler 구현

* feat : 오픽 주제, 소주제별 seed 데이터 추가

* refactor : Transcribe API KEY 환경변수명 수정

* refactor : Bedrock에 사용하는 클로드 모델 변경

* refactor : S3 Key 대신 Proxy에서 요청하는 Base64 값으로 변환

* feat: GAME_START, ROUND_END 메시지에 serverTime 추가

- broadcastGameStart(): serverTime, roundDuration 필드 추가
- broadcastRoundEnd(): serverTime, roundStartTime, roundDuration 필드 추가
- GameService.endRound(): data에 roundStartTime, roundDuration 포함
- 타이머 동기화 버그 수정을 위한 서버 시간 제공

* feat: WebSocketMessageHelper 유틸리티 클래스 추가

- domain 필드 포함 메시지 생성 헬퍼
- DOMAIN_CHAT, DOMAIN_GAME 상수 정의
- buildChatMessage(), buildGameMessage() 메서드

* feat: 모든 WebSocket 메시지에 domain 필드 추가

- ScoreUpdateMessage에 domain 필드 추가
- broadcastGameStart에 domain:"game" 추가
- broadcastRoundEnd에 domain:"game" 추가
- broadcastCorrectAnswerMessage에 domain:"game" 추가
- handleCommandResult 시스템 메시지에 domain:"game" 추가
- handleRegularMessage 채팅 메시지에 domain:"chat" 추가

Closes #426, #427

* feat: GameSession 모델 클래스 생성

- DynamoDB Enhanced Client 어노테이션 적용
- GSI1: roomId로 활성 게임 세션 조회 가능
- 게임 상태 관리용 헬퍼 메서드 포함

Closes #428

* feat: GameSessionRepository 구현

- 기본 CRUD (save, findById, delete)
- roomId로 활성/전체 게임 세션 조회
- 상태, 라운드, 점수 업데이트 메서드
- 정답자 추가, 힌트 사용, 게임 종료 처리

Closes #429

* refactor: ChatRoom에서 게임 필드 분리

- 게임 관련 필드 제거 (gameStatus, currentRound 등)
- activeGameSessionId 필드 추가
- 게임 상태는 GameSession으로 분리됨

Note: 의존 코드 수정은 #431에서 진행

Closes #430

* refactor: GameSession 기반으로 전체 게임 로직 리팩토링

- GameService: ChatRoom 대신 GameSession 사용
- GameStatsService: GameSession 매개변수로 변경
- CommandService: GameSession 기반 점수 조회
- GameHandler: GameSession 기반 REST API
- WebSocketMessageHandler: GameSession 기반 브로드캐스트
- GameStatusResponse, ScoreboardResponse: GameSession 매개변수

Closes #431

* feat: GameSessionHandler Lambda 및 게임 세션 API 구현

- POST /rooms/{roomId}/games - 게임 세션 생성
- GET /games/{gameSessionId} - 게임 상태 조회 (재접속용)
- POST /games/{gameSessionId}/start - 게임 시작
- POST /games/{gameSessionId}/stop - 게임 종료

모든 응답에 serverTime 포함 (타이머 동기화)
출제자에게만 currentWord 포함

Closes #432, #433

* feat: 게임 시작 7분 후 자동 종료 기능 구현

- GameConfig에 gameTimeLimit() 메서드 추가 (기본값: 420초)
- GameSchedulerClient 유틸리티 클래스 생성 (EventBridge Scheduler 연동)
- GameService에 스케줄 생성/취소 로직 추가
- GameAutoCloseHandler Lambda 함수 생성
- template.yaml에 Lambda, IAM Role, Schedule Group 추가

Closes #417

* fix : 메모리 증가 및 Lambda 응답 제한 시간 Cognito 트리거 제한시간과 동일하게 수정 (#439)

* feat: 캐치마인드 게임 방 분리 기능 구현 (#455)

- Room 타입 분리 (CHAT/GAME)
  - RoomType, RoomStatus enum 추가
  - ChatRoom 모델에 type, gameType, gameSettings, status, hostId 필드 추가
  - GameSettings 모델 추가

- 방 생성/조회 API 수정
  - CreateRoomRequest에 type, gameType, gameSettings 필드 추가
  - 방 목록 조회 시 type, gameType, status 필터 지원

- 게임 시작 조건 검증
  - GAME 타입 방에서만 게임 시작 가능 (GAME_007 에러)

- 게임 재시작 API 구현 (#452)
  - POST /rooms/{roomId}/game/restart 엔드포인트 추가
  - 방장만 재시작 가능 (GAME_009 에러)
  - 게임 진행 중 재시작 불가 (GAME_008 에러)

- 방장 변경 로직 구현 (#453)
  - 방장 퇴장 시 다음 멤버에게 자동 이전
  - 모든 멤버 퇴장 시 방 자동 삭제

- WebSocket 메시지 타입 추가 (#454)
  - ROOM_STATUS_CHANGE, HOST_CHANGE 메시지 타입 추가
  - WebSocketMessageHelper에 빌더 메서드 추가

- 테스트 추가
  - RoomType, RoomStatus enum 테스트
  - GameSettings 모델 테스트
  - ChattingErrorCode 테스트 업데이트

Related: #440, #441, #442, #443, #444, #445, #446
Closes: #447, #448, #449, #450, #451, #452, #453, #454

* feat: 참가자 닉네임 및 방장 변경 WebSocket 알림 구현 (#456)

- RoomParticipant DTO 추가 (userId, nickname, isHost)
- ChatRoomQueryService에 닉네임 조회 메서드 추가
  - getParticipantsWithNicknames(): 참가자 목록 + 닉네임
  - getHostNickname(): 방장 닉네임 조회
- ChatRoomHandler.getRoom() 응답에 participants, hostNickname 추가
- ChatRoomCommandService.leaveRoom()에서 방장 변경 시 WebSocket 브로드캐스트

Related: #440

* fix: ChatRoomFunction에 UserTable DynamoDB 권한 추가

- 참가자/방장 닉네임 조회를 위한 UserTable 읽기 권한 추가
- DynamoDBReadPolicy로 UserTable 접근 허용

Fixes #457

* fix: GameSettings에 @DynamoDbBean 어노테이션 추가

- DynamoDB Enhanced Client가 중첩 객체를 직렬화/역직렬화할 수 있도록 수정
- ChatRoom 저장/조회 시 GameSettings 변환 오류 해결

Fixes #457

* fix: ChatRoomFunction에 WEBSOCKET_ENDPOINT 환경변수 및 권한 추가

- leaveRoom에서 WebSocketBroadcaster 사용을 위한 환경변수 추가
- execute-api:ManageConnections 권한 추가

* fix: WebSocket Lambda 함수들에 WEBSOCKET_ENDPOINT 환경변수 추가

- WebSocketConnectFunction에 WEBSOCKET_ENDPOINT 추가
- WebSocketDisconnectFunction에 WEBSOCKET_ENDPOINT 추가
- execute-api:ManageConnections 권한 추가

* fix: Grammar WebSocket Lambda 환경 변수 및 권한 추가

- GrammarStreamingConnectFunction에 WEBSOCKET_ENDPOINT 환경 변수 추가
- GrammarStreamingDisconnectFunction에 WEBSOCKET_ENDPOINT 환경 변수 추가
- 두 함수에 execute-api:ManageConnections 권한 추가

* feat: GSI1SK 확장성 있는 재설계 및 DB 레벨 필터링

- 기존: {level}#{createdAt}
- 신규: {type}#{gameType}#{status}#{level}#{createdAt}

- 전체 방: GSI1PK = "ROOMS"
- 게임방만: begins_with(GSI1SK, "GAME#")
- 캐치마인드만: begins_with(GSI1SK, "GAME#CATCHMIND#")
- 대기중 캐치마인드: begins_with(GSI1SK, "GAME#CATCHMIND#WAITING#")

- ChatRoomCommandService.java: 방 생성 시 새 GSI1SK 포맷 적용
- ChatRoomRepository.java: findByFilters() 메서드 추가, updateStatus() 메서드 추가
- ChatRoomQueryService.java: 메모리 필터링 제거, DB 레벨 필터링으로 변경
- GameService.java: 게임 시작/종료 시 방 상태 업데이트 (GSI1SK 포함)

- scripts/migrate-gsi1sk.sh: 기존 데이터 마이그레이션 스크립트
- 37개 기존 방 마이그레이션 완료

* fix: increase stats query limit to 100 days

- Adjust maximum allowable limit for recent stats query from 30 to 100 days to support extended data range responses.

* feat: improve game round and connection management logic

- Added handling for game round timeout (`ROUND_TIMEOUT`) in WebSocketMessageHandler.
- Enhanced game start broadcast to include `currentWord` for the drawer only.
- Updated ConnectionRepository to remove duplicate user connections in the same room.
- Added `currentWordEnglish` to GameSession for better answer verification.
- Normalized ChatRoom levels to match database storage format.
- Updated template.yaml to include DynamoDBReadPolicy for VocabTable.

* refactor: 코드 정리 및 미사용 클래스 제거 (#459)

* refactor: remove unused WebSocketResponseUtil

* refactor: add AutoCloseable to WebSocketBroadcaster

* refactor: remove unused TestService

* refactor: remove unused WordService

* refactor: remove unused DailyStudyService

* refactor: remove unused UserWordService

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* fix: resolve N+1 query in StatsService

* refactor(all): DI 패턴 및 전략 패턴 적용 (#461)

- Repository, Service, Handler에 DI 생성자 추가 (테스트 용이성)
- BadgeService에 Strategy 패턴 적용 (뱃지 조건 검증 로직 분리)

* refactor: relocate and restructure seed data files

- Moved `question-homes.json` and `words.json` from subdirectories to `seed` folder.
- Updated file paths for better organization and clarity.

* chore: seed 데이터 폴더 구조 정리

* feat: add CI/CD pipeline configuration for CodePipeline

* fix: add SNS topic policy and DependsOn for notification rule

* fix: correct paths in buildspec.yml for CodeBuild

* fix: remove hardcoded JAVA_HOME, use runtime default

* fix: add gradle wrapper for CI/CD build

* fix: use single line sam package command with hardcoded bucket

* fix: use existing stack name group2-englishstudy-chatting

* fix: add missing WEBSOCKET_ENDPOINT env var to WebSocket connect functions

* docs: update FRONTEND-API-GUIDE with new RoomType/RoomStatus structure

* feat : WebSocket Connect, Disconnect 핸들러 & SpeakingConnecion 모델 구현

* feat : WebSocket 메시지 처리 handler, service 구현

* feat : WebSocket 연결 정보 Repository 구현

* fix: update WebSocketDisconnectHandler to use GameSession model

- Remove references to deleted ChatRoom game fields
- Use GameSessionRepository to finish active game sessions
- Use ChatRoomRepository.updateStatus() for room state management

* perf: optimize CI/CD build time

- Add pip cache for SAM CLI dependencies
- Enable Gradle parallel builds and build cache
- Add SAM build cache (.aws-sam)
- Use sam build --parallel --cached
- Skip SAM CLI install if already cached
- Remove unnecessary 'clean' to leverage cache

* feat: add custom CodeBuild Docker image with pre-installed tools

- Dockerfile with Java 21 + SAM CLI + Gradle pre-installed
- build-and-push.sh script for ECR deployment
- Updated buildspec.yml for custom image (removes SAM CLI install)
- Expected build time reduction: ~30-40 seconds

* feature : AI 영어 회화 연습 기능 (#468)

* feat : WebSocket Connect, Disconnect 핸들러 & SpeakingConnecion 모델 구현

* feat : WebSocket 메시지 처리 handler, service 구현

* feat : WebSocket 연결 정보 Repository 구현

* fix: remove typo in SpeakingConnectionRepository

* fix : 오타 수정

* chore: trigger build test with custom Docker image

* chore: remove unnecessary newlines and whitespace across WebSocket handlers and related classes

* chore: remove unnecessary newlines and whitespace across WebSocket handlers and related classes

* refactor : websocket -> rest api 전환

* feat : speaking handler REST로 교체

* feat : speaking 관련 dto 생성

* refacotor : 기존 service 코드 로직 재사용 및 repository 리펙토링

* fix: add CORS headers to API Gateway error responses (#479)

API Gateway의 인증 실패 등 에러 응답에 CORS 헤더가 누락되어
CloudFront를 통한 프론트엔드 요청이 차단되는 문제 수정

- UNAUTHORIZED (401) 응답에 CORS 헤더 추가
- ACCESS_DENIED (403) 응답에 CORS 헤더 추가
- DEFAULT_4XX/5XX 응답에 CORS 헤더 추가
- EXPIRED_TOKEN 응답에 CORS 헤더 추가

* feat : speaking rest API 람다 함수 추가

---------

Co-authored-by: ddingjoo <ddingsha9@teambind.co.kr>

* refactor : speaking service 재사용

* refactor : AI 영어 회화 연습 코드 리팩토링

* feature : test 벡엔드 서버에 AI 말하기 연습 기능 배포 (#492)

* feat : WebSocket Connect, Disconnect 핸들러 & SpeakingConnecion 모델 구현

* feat : WebSocket 메시지 처리 handler, service 구현

* feat : WebSocket 연결 정보 Repository 구현

* fix : 오타 수정

* refactor : websocket -> rest api 전환

* feat : speaking handler REST로 교체

* feat : speaking 관련 dto 생성

* refacotor : 기존 service 코드 로직 재사용 및 repository 리펙토링

* feat : speaking rest API 람다 함수 추가

* refactor : speaking service 재사용

* refactor : AI 영어 회화 연습 코드 리팩토링

---------

Co-authored-by: DDING JOO <ddingsha9@teambind.co.kr>

* feat : handleChat 메서드 JsonNull 체크 푸가

* feature : handleChat 메서드 JsonNull 체크 추가 (#493)

* feat : WebSocket Connect, Disconnect 핸들러 & SpeakingConnecion 모델 구현

* feat : WebSocket 메시지 처리 handler, service 구현

* feat : WebSocket 연결 정보 Repository 구현

* fix : 오타 수정

* refactor : websocket -> rest api 전환

* feat : speaking handler REST로 교체

* feat : speaking 관련 dto 생성

* refacotor : 기존 service 코드 로직 재사용 및 repository 리펙토링

* feat : speaking rest API 람다 함수 추가

* refactor : speaking service 재사용

* refactor : AI 영어 회화 연습 코드 리팩토링

* feat : handleChat 메서드 JsonNull 체크 푸가

---------

Co-authored-by: DDING JOO <ddingsha9@teambind.co.kr>

* feat(news): 뉴스 학습 배지 시스템 구현 (#473)

- 14개 뉴스 관련 배지 추가 (읽기, 퀴즈, 단어수집, 연속학습, 마스터)
- UserStats에 뉴스 통계 필드 추가
- 6개 뉴스 배지 Strategy 클래스 생성
- 뉴스 읽기/퀴즈/단어수집 시 통계 업데이트 및 배지 체크 연동

* fix: add PATCH method to CORS AllowMethods

* test: BadgeType 개수 테스트 수정 (15 -> 29)

* fix: CORS PATCH 메서드 추가

* docs: 뉴스 기능 프론트엔드 연동 가이드 작성

* fix: NewsCollectionFunction에 Bedrock, Comprehend 권한 추가

* fix: add null check for collectWord request body

- Add INVALID_REQUEST error code to NewsErrorCode
- Check body and word field before accessing in collectWord()
- Prevents NullPointerException when request body is malformed

* feat: enhance stats API and bookmark response for frontend

- Add DAILY stats update for news read/quiz/word collection
- Add /stats/dashboard endpoint with frontend-requested format
  - today: wordsLearned, newsRead, quizzesTaken, wordsTotal
  - overall: totalWordsLearned, totalNewsRead, averageAccuracy, streaks
  - weeklyProgress: last 7 days with date/wordsLearned/newsRead
- Add news-related fields to all stats API responses
- Fix bookmark API to include full article details (title, summary, etc.)

* feat: add category classification to news AI analysis

- Add category field to AnalysisResult record
- Update Bedrock prompt to classify articles into categories
  (WORLD, POLITICS, BUSINESS, TECH, SCIENCE, HEALTH, SPORTS, ENTERTAINMENT, LIFESTYLE)
- Parse and set category from AI response
- Set GSI2 (CATEGORY#) index when category is available

* fix: add /stats/dashboard endpoint to template.yaml

* fix: filter by ARTICLE# prefix in findById to avoid returning UserNewsRecord

* docs: add News API troubleshooting guide

* feat: add Cognito authorizer to News API and enhance keyword extraction

- Set CognitoAuthorizer for all News API endpoints in template.yaml
- Update Bedrock AI to extract keywords with meanings and examples
- Add fallback to Comprehend for keyword extraction when Bedrock fails
- Modify KeywordInfo model to include example field
- Adjust AI prompt to include keyword extraction with examples
- Update AnalysisResult to store keywords and parse them from AI response

* Revert "Merge branch 'test' into prod"

This reverts commit c1a958eac6799d5838a76e4078ae304bcdb62278, reversing
changes made to a6662e0cfc46c6e12f20a89f0df285ff282160bc.

* feat: enhance bookmark and reading status tracking for News API

- Add bookmark and reading status to individual article responses
- Include bookmark status in paginated news responses
- Modify `KeywordInfo` to support Korean translations (`meaningKo`)
- Update AI prompts to extract Korean meanings for keywords

* refactor : session_id가 null 체크 추가

* feat : template 환경변수 리펙토링

* fix : sessionId NullPointerException 에러 수정  (#496)

* feat : WebSocket Connect, Disconnect 핸들러 & SpeakingConnecion 모델 구현

* feat : WebSocket 메시지 처리 handler, service 구현

* feat : WebSocket 연결 정보 Repository 구현

* fix : 오타 수정

* refactor : websocket -> rest api 전환

* feat : speaking handler REST로 교체

* feat : speaking 관련 dto 생성

* refacotor : 기존 service 코드 로직 재사용 및 repository 리펙토링

* feat : speaking rest API 람다 함수 추가

* refactor : speaking service 재사용

* refactor : AI 영어 회화 연습 코드 리팩토링

* feat : handleChat 메서드 JsonNull 체크 푸가

* refactor : session_id가 null 체크 추가

* feat : template 환경변수 리펙토링

---------

Co-authored-by: DDING JOO <ddingsha9@teambind.co.kr>

* feat: enhance bookmark and reading status tracking for News API

- Add bookmark and reading status to individual article responses
- Include bookmark status in paginated news responses
- Modify `KeywordInfo` to support Korean translations (`meaningKo`)
- Update AI prompts to extract Korean meanings for keywords

* feat: add category filtering to UserWord API with enhanced query logic

- Introduce `category` filtering to `getUserWords` API
- Update WordCategory enums to include "news" category
- Apply category filter after enrichment with word info
- Adjust query limits for bookmarked and incorrect words queries

* feat: add default value for ExistingCognitoClientId in template.yaml

- Set default to an empty string to ensure compatibility with templates using this parameter without explicitly specifying a value.

* fix: SpeakingHandler getStringOrNull 컴파일 에러 수정

* fix: SpeakingHandler getStringOrNull 컴파일 에러 수정

* fix: Bedrock 키워드(meaningKo 포함)를 article에 저장하도록 수정

* fix: Bedrock 키워드(meaningKo 포함)를 article에 저장하도록 수정

* fix: Bedrock 키워드(meaningKo 포함)를 article에 저장하도록 수정

* feat: add dashboard stats API and enhance news stats tracking

- Introduce `/stats/dashboard` API for retrieving integrated user stats (today, overall, weekly progress, and level distribution)
- Update `UserStats` model to include additional fields for news stats (newsRead, newsQuizCompleted, newsQuizPerfect, newsWordsCollected, etc.)
- Add atomic updates to track news reading, quiz, and word stats in `UserStatsRepository`
- Modify CloudFormation `template.yaml` to register the new `/stats/dashboard` endpoint

* feat: add dashboard stats API and enhance news stats tracking

- Introduce `/stats/dashboard` API for retrieving integrated user stats (today, overall, weekly progress, and level distribution)
- Update `UserStats` model to include additional fields for news stats (newsRead, newsQuizCompleted, newsQuizPerfect, newsWordsCollected, etc.)
- Add atomic updates to track news reading, quiz, and word stats in `UserStatsRepository`
- Modify CloudFormation `template.yaml` to register the new `/stats/dashboard` endpoint

* feat: add dashboard stats API and enhance news stats tracking

- Introduce `/stats/dashboard` API for retrieving integrated user stats (today, overall, weekly progress, and level distribution)
- Update `UserStats` model to include additional fields for news stats (newsRead, newsQuizCompleted, newsQuizPerfect, newsWordsCollected, etc.)
- Add atomic updates to track news reading, quiz, and word stats in `UserStatsRepository`
- Modify CloudFormation `template.yaml` to register the new `/stats/dashboard` endpoint

* refactor: format code with consistent indentation and spacing

- Apply consistent formatting to improve code readability across multiple files
- Adjust indentation, spacing, and alignment in model classes, DTOs, and repository methods

* fix: filter by ARTICLE# prefix in findById to avoid returning bookmark records


* feat : Speaking 관련 template 람다 함수 및 테이블 추가

---------

Co-authored-by: DDING JOO <ddingsha9@teambind.co.kr>

* feature : 말하기 연습 기능 polly 서비스 권한 추가 (#514)

* feat: EnvConfig 유틸리티 추가 및 환경 변수 검증 적용

환경 변수 미설정 시 명확한 에러 메시지를 제공하는 EnvConfig 유틸리티를 추가하고,
기존 System.getenv 호출을 EnvConfig.getRequired/getOrDefault로 대체함.

- EnvConfig: getRequired, getOrDefault, getIntOrDefault, getLongOrDefault 메서드 제공
- Lambda Cold Start 시점에 환경 변수 누락을 조기 감지
- 기존 Config 클래스(WebSocketConfig, RoomTokenConfig) EnvConfig 사용으로 통일

Closes #403

* refactor: TestService submitTest 메서드 책임 분리

submitTest 메서드를 단일 책임 원칙에 맞게 리팩토링:
- gradeAnswers(): 답안 채점 및 결과 집계
- isAnswerCorrect(): 단일 답안 정답 여부 판단
- buildResultItem(): 결과 항목 생성
- saveTestResult(): 테스트 결과 저장
- GradingResult record: 채점 결과 캡슐화

TestService와 TestCommandService 모두 동일하게 적용

Closes #404

* refactor: 하드코딩된 설정값 환경 변수로 외부화

각 도메인별 Config 클래스를 생성하여 하드코딩된 값들을 환경 변수로 설정 가능하게 변경.
기본값이 있어 환경 변수 미설정 시에도 기존 동작 유지.

## 새로 추가된 Config 클래스
- GrammarConfig: SESSION_TTL_DAYS, MAX_HISTORY_MESSAGES, MAX_TOKENS 등
- GameConfig: TOTAL_ROUNDS, ROUND_TIME_LIMIT, QUICK_GUESS_THRESHOLD_MS
- VocabularyConfig: NEW_WORDS_COUNT, REVIEW_WORDS_COUNT, 상태 전이 임계값 등

## 지원하는 환경 변수
- GRAMMAR_SESSION_TTL_DAYS, GRAMMAR_MAX_HISTORY_MESSAGES, GRAMMAR_MAX_TOKENS
- GAME_TOTAL_ROUNDS, GAME_ROUND_TIME_LIMIT, GAME_QUICK_GUESS_THRESHOLD_MS
- VOCAB_NEW_WORDS_COUNT, VOCAB_REVIEW_WORDS_COUNT
- VOCAB_TRANSITION_TO_REVIEWING, VOCAB_TRANSITION_TO_MASTERED

Closes #406

* test: StudyLevel enum 단위 테스트 추가

* test: Difficulty enum 단위 테스트 추가

* test: StudyConfig 단위 테스트 추가

* test: EnvConfig 단위 테스트 추가

* test: PaginatedResult 단위 테스트 추가

* test: JsonUtil 단위 테스트 추가

* test: CursorUtil 단위 테스트 추가

* test: CommonErrorCode 단위 테스트 추가

* test: CommonException 단위 테스트 추가

* test: BadgeType enum 단위 테스트 추가

* test: BadgeKey 상수 단위 테스트 추가

* test: WordStatus enum 단위 테스트 추가

* test: TestType enum 단위 테스트 추가

* test: VocabularyConfig 단위 테스트 추가

* test: VocabKey 상수 단위 테스트 추가

* test: VocabularyErrorCode 단위 테스트 추가

* test: VocabularyException 단위 테스트 추가

* test: SpacedRepetitionContext 단위 테스트 추가

* test: GrammarLevel enum 단위 테스트 추가

* test: GrammarConfig 단위 테스트 추가

* test: GrammarErrorCode 단위 테스트 추가

* test: GrammarException 단위 테스트 추가

* test: GameStatus enum 단위 테스트 추가

* test: GameConfig 단위 테스트 추가

* test: ChattingErrorCode 단위 테스트 추가

* test: ChattingException 단위 테스트 추가

* fix: OPIc FeedbackResponse.java 문법 오류 수정

* style: AwsClients 코드 포맷팅

* style: EnvConfig 코드 포맷팅

* style: RoomTokenConfig 코드 포맷팅

* style: WebSocketConfig 코드 포맷팅

* style: JsonUtil 코드 포맷팅

* style: GameConfig 코드 포맷팅

* style: GrammarConfig 코드 포맷팅

* style: GrammarKey 코드 포맷팅

* style: GrammarErrorCode 코드 포맷팅

* style: GrammarException 코드 포맷팅

* style: BedrockGrammarCheckFactory 코드 포맷팅

* style: GrammarConversationService 코드 포맷팅

* style: FeedbackResponse 코드 포맷팅

* style: SessionReportResponse 코드 포맷팅

* style: SpeakingError 코드 포맷팅

* style: SpeakingErrorType 코드 포맷팅

* style: OPIcException 코드 포맷팅

* style: OPIcAnswer 코드 포맷팅

* style: OPIcQuestion 코드 포맷팅

* style: OPIcSession 코드 포맷팅

* style: OPIcRepository 코드 포맷팅

* style: FeedbackService 코드 포맷팅

* style: TranscribeProxyService 코드 포맷팅

* style: VocabularyConfig 코드 포맷팅

* style: DailyStudyCommandService 코드 포맷팅

* style: TestCommandService 코드 포맷팅

* style: TestService 코드 포맷팅

* style: CommonErrorCodeSpec 코드 포맷팅

* style: JsonUtilSpec 코드 포맷팅

* style: BadgeTypeSpec 코드 포맷팅

* style: ChattingErrorCodeSpec 코드 포맷팅

* style: GrammarLevelSpec 코드 포맷팅

* style: GrammarErrorCodeSpec 코드 포맷팅

* style: VocabularyErrorCodeSpec 코드 포맷팅

* feature : OPIc 세션관리 + 답변 처리 파이프라인 구현  (#413)

* feat : OPIc 질문 & 세션 관련 dto 생성

* refactor : @DynamoDbBean 주석 추가

* feat : 주제 + 소주제 + 레벨로 오픽 질문 조회 추가

* feat : OPIc 세션, 질문, 답변 종합 handler 구현

* feat : 오픽 주제, 소주제별 seed 데이터 추가

* refactor : Transcribe API KEY 환경변수명 수정

* refactor : Bedrock에 사용하는 클로드 모델 변경

* refactor : S3 Key 대신 Proxy에서 요청하는 Base64 값으로 변환

* feat: GAME_START, ROUND_END 메시지에 serverTime 추가

- broadcastGameStart(): serverTime, roundDuration 필드 추가
- broadcastRoundEnd(): serverTime, roundStartTime, roundDuration 필드 추가
- GameService.endRound(): data에 roundStartTime, roundDuration 포함
- 타이머 동기화 버그 수정을 위한 서버 시간 제공

* feat: WebSocketMessageHelper 유틸리티 클래스 추가

- domain 필드 포함 메시지 생성 헬퍼
- DOMAIN_CHAT, DOMAIN_GAME 상수 정의
- buildChatMessage(), buildGameMessage() 메서드

* feat: 모든 WebSocket 메시지에 domain 필드 추가

- ScoreUpdateMessage에 domain 필드 추가
- broadcastGameStart에 domain:"game" 추가
- broadcastRoundEnd에 domain:"game" 추가
- broadcastCorrectAnswerMessage에 domain:"game" 추가
- handleCommandResult 시스템 메시지에 domain:"game" 추가
- handleRegularMessage 채팅 메시지에 domain:"chat" 추가

Closes #426, #427

* feat: GameSession 모델 클래스 생성

- DynamoDB Enhanced Client 어노테이션 적용
- GSI1: roomId로 활성 게임 세션 조회 가능
- 게임 상태 관리용 헬퍼 메서드 …

* feat: implement word chain (끝말잇기) game with dictionary API integration

- Add WordChainSession model with time limit, scoring, player management
- Add WordChainService with game logic (start, submit, timeout, stop)
- Add DictionaryService for word validation via Free Dictionary API
- Add WordChainHandler REST API endpoints (/wordchain/start, submit, etc.)
- Add WordChainFunction to SAM template
- Add WORDCHAIN_* message types for WebSocket broadcasts
- Fix command result domain (use chat domain for chat commands)
- Add unit tests for WordChainSession and DictionaryService

Closes #524, #525, #526, #527, #528

* fix: update ChattingErrorCodeSpec to include new error codes

* fix: add UserTable read permission to WebSocket Lambda

WebSocket Lambda needs DynamoDBReadPolicy for UserTable to look up
user nicknames for chat commands (/member, /dice, /coin, /hint, etc.)

* fix: add Bedrock permission to NewsCollectionFunction

NewsCollectionFunction needs bedrock:InvokeModel permission to analyze
news difficulty using Claude.

* fix: fallback to yesterday's news when today's news is empty

GET /news now returns yesterday's articles if no articles exist for today.
This prevents empty results before the daily 18:00 KST news collection runs.

* feat : 채팅 도메인 닉네임 조회용 메서드 추가

* feature : 채팅 메뉴에서 닉네임 조회 테스트 배포 (#535)

* fix: add Bedrock permission to NewsCollectionFunction

NewsCollectionFunction needs bedrock:InvokeModel permission to analyze
news difficulty using AI.

* fix: fallback to yesterday's news when today's news is empty

GET /news now returns yesterday's articles if no articles exist for today.
This prevents empty results before the daily 18:00 KST news collection runs.

* feature  : 채팅 도메인 닉네임 조회용 메서드 추가 (#534)

* test: Difficulty enum 단위 테스트 추가

* test: StudyConfig 단위 테스트 추가

* test: EnvConfig 단위 테스트 추가

* test: PaginatedResult 단위 테스트 추가

* test: JsonUtil 단위 테스트 추가

* test: CursorUtil 단위 테스트 추가

* test: CommonErrorCode 단위 테스트 추가

* test: CommonException 단위 테스트 추가

* test: BadgeType enum 단위 테스트 추가

* test: BadgeKey 상수 단위 테스트 추가

* test: WordStatus enum 단위 테스트 추가

* test: TestType enum 단위 테스트 추가

* test: VocabularyConfig 단위 테스트 추가

* test: VocabKey 상수 단위 테스트 추가

* test: VocabularyErrorCode 단위 테스트 추가

* test: VocabularyException 단위 테스트 추가

* test: SpacedRepetitionContext 단위 테스트 추가

* test: GrammarLevel enum 단위 테스트 추가

* test: GrammarConfig 단위 테스트 추가

* test: GrammarErrorCode 단위 테스트 추가

* test: GrammarException 단위 테스트 추가

* test: GameStatus enum 단위 테스트 추가

* test: GameConfig 단위 테스트 추가

* test: ChattingErrorCode 단위 테스트 추가

* test: ChattingException 단위 테스트 추가

* fix: OPIc FeedbackResponse.java 문법 오류 수정

* style: AwsClients 코드 포맷팅

* style: EnvConfig 코드 포맷팅

* style: RoomTokenConfig 코드 포맷팅

* style: WebSocketConfig 코드 포맷팅

* style: JsonUtil 코드 포맷팅

* style: GameConfig 코드 포맷팅

* style: GrammarConfig 코드 포맷팅

* style: GrammarKey 코드 포맷팅

* style: GrammarErrorCode 코드 포맷팅

* style: GrammarException 코드 포맷팅

* style: BedrockGrammarCheckFactory 코드 포맷팅

* style: GrammarConversationService 코드 포맷팅

* style: FeedbackResponse 코드 포맷팅

* style: SessionReportResponse 코드 포맷팅

* style: SpeakingError 코드 포맷팅

* style: SpeakingErrorType 코드 포맷팅

* style: OPIcException 코드 포맷팅

* style: OPIcAnswer 코드 포맷팅

* style: OPIcQuestion 코드 포맷팅

* style: OPIcSession 코드 포맷팅

* style: OPIcRepository 코드 포맷팅

* style: FeedbackService 코드 포맷팅

* style: TranscribeProxyService 코드 포맷팅

* style: VocabularyConfig 코드 포맷팅

* style: DailyStudyCommandService 코드 포맷팅

* style: TestCommandService 코드 포맷팅

* style: TestService 코드 포맷팅

* style: CommonErrorCodeSpec 코드 포맷팅

* style: JsonUtilSpec 코드 포맷팅

* style: BadgeTypeSpec 코드 포맷팅

* style: ChattingErrorCodeSpec 코드 포맷팅

* style: GrammarLevelSpec 코드 포맷팅

* style: GrammarErrorCodeSpec 코드 포맷팅

* style: VocabularyErrorCodeSpec 코드 포맷팅

* feature : OPIc 세션관리 + 답변 처리 파이프라인 구현  (#413)

* feat : OPIc 질문 & 세션 관련 dto 생성

* refactor : @DynamoDbBean 주석 추가

* feat : 주제 + 소주제 + 레벨로 오픽 질문 조회 추가

* feat : OPIc 세션, 질문, 답변 종합 handler 구현

* feat : 오픽 주제, 소주제별 seed 데이터 추가

* refactor : Transcribe API KEY 환경변수명 수정

* refactor : Bedrock에 사용하는 클로드 모델 변경

* refactor : S3 Key 대신 Proxy에서 요청하는 Base64 값으로 변환

* feat: GAME_START, ROUND_END 메시지에 serverTime 추가

- broadcastGameStart(): serverTime, roundDuration 필드 추가
- broadcastRoundEnd(): serverTime, roundStartTime, roundDuration 필드 추가
- GameService.endRound(): data에 roundStartTime, roundDuration 포함
- 타이머 동기화 버그 수정을 위한 서버 시간 제공

* feat: WebSocketMessageHelper 유틸리티 클래스 추가

- domain 필드 포함 메시지 생성 헬퍼
- DOMAIN_CHAT, DOMAIN_GAME 상수 정의
- buildChatMessage(), buildGameMessage() 메서드

* feat: 모든 WebSocket 메시지에 domain 필드 추가

- ScoreUpdateMessage에 domain 필드 추가
- broadcastGameStart에 domain:"game" 추가
- broadcastRoundEnd에 domain:"game" 추가
- broadcastCorrectAnswerMessage에 domain:"game" 추가
- handleCommandResult 시스템 메시지에 domain:"game" 추가
- handleRegularMessage 채팅 메시지에 domain:"chat" 추가

Closes #426, #427

* feat: GameSession 모델 클래스 생성

- DynamoDB Enhanced Client 어노테이션 적용
- GSI1: roomId로 활성 게임 세션 조회 가능
- 게임 상태 관리용 헬퍼 메서드 포함

Closes #428

* feat: GameSessionRepository 구현

- 기본 CRUD (save, findById, delete)
- roomId로 활성/전체 게임 세션 조회
- 상태, 라운드, 점수 업데이트 메서드
- 정답자 추가, 힌트 사용, 게임 종료 처리

Closes #429

* refactor: ChatRoom에서 게임 필드 분리

- 게임 관련 필드 제거 (gameStatus, currentRound 등)
- activeGameSessionId 필드 추가
- 게임 상태는 GameSession으로 분리됨

Note: 의존 코드 수정은 #431에서 진행

Closes #430

* refactor: GameSession 기반으로 전체 게임 로직 리팩토링

- GameService: ChatRoom 대신 GameSession 사용
- GameStatsService: GameSession 매개변수로 변경
- CommandService: GameSession 기반 점수 조회
- GameHandler: GameSession 기반 REST API
- WebSocketMessageHandler: GameSession 기반 브로드캐스트
- GameStatusResponse, ScoreboardResponse: GameSession 매개변수

Closes #431

* feat: GameSessionHandler Lambda 및 게임 세션 API 구현

- POST /rooms/{roomId}/games - 게임 세션 생성
- GET /games/{gameSessionId} - 게임 상태 조회 (재접속용)
- POST /games/{gameSessionId}/start - 게임 시작
- POST /games/{gameSessionId}/stop - 게임 종료

모든 응답에 serverTime 포함 (타이머 동기화)
출제자에게만 currentWord 포함

Closes #432, #433

* feat: 게임 시작 7분 후 자동 종료 기능 구현

- GameConfig에 gameTimeLimit() 메서드 추가 (기본값: 420초)
- GameSchedulerClient 유틸리티 클래스 생성 (EventBridge Scheduler 연동)
- GameService에 스케줄 생성/취소 로직 추가
- GameAutoCloseHandler Lambda 함수 생성
- template.yaml에 Lambda, IAM Role, Schedule Group 추가

Closes #417

* fix : 메모리 증가 및 Lambda 응답 제한 시간 Cognito 트리거 제한시간과 동일하게 수정 (#439)

* feat: 캐치마인드 게임 방 분리 기능 구현 (#455)

- Room 타입 분리 (CHAT/GAME)
  - RoomType, RoomStatus enum 추가
  - ChatRoom 모델에 type, gameType, gameSettings, status, hostId 필드 추가
  - GameSettings 모델 추가

- 방 생성/조회 API 수정
  - CreateRoomRequest에 type, gameType, gameSettings 필드 추가
  - 방 목록 조회 시 type, gameType, status 필터 지원

- 게임 시작 조건 검증
  - GAME 타입 방에서만 게임 시작 가능 (GAME_007 에러)

- 게임 재시작 API 구현 (#452)
  - POST /rooms/{roomId}/game/restart 엔드포인트 추가
  - 방장만 재시작 가능 (GAME_009 에러)
  - 게임 진행 중 재시작 불가 (GAME_008 에러)

- 방장 변경 로직 구현 (#453)
  - 방장 퇴장 시 다음 멤버에게 자동 이전
  - 모든 멤버 퇴장 시 방 자동 삭제

- WebSocket 메시지 타입 추가 (#454)
  - ROOM_STATUS_CHANGE, HOST_CHANGE 메시지 타입 추가
  - WebSocketMessageHelper에 빌더 메서드 추가

- 테스트 추가
  - RoomType, RoomStatus enum 테스트
  - GameSettings 모델 테스트
  - ChattingErrorCode 테스트 업데이트

Related: #440, #441, #442, #443, #444, #445, #446
Closes: #447, #448, #449, #450, #451, #452, #453, #454

* feat: 참가자 닉네임 및 방장 변경 WebSocket 알림 구현 (#456)

- RoomParticipant DTO 추가 (userId, nickname, isHost)
- ChatRoomQueryService에 닉네임 조회 메서드 추가
  - getParticipantsWithNicknames(): 참가자 목록 + 닉네임
  - getHostNickname(): 방장 닉네임 조회
- ChatRoomHandler.getRoom() 응답에 participants, hostNickname 추가
- ChatRoomCommandService.leaveRoom()에서 방장 변경 시 WebSocket 브로드캐스트

Related: #440

* fix: ChatRoomFunction에 UserTable DynamoDB 권한 추가

- 참가자/방장 닉네임 조회를 위한 UserTable 읽기 권한 추가
- DynamoDBReadPolicy로 UserTable 접근 허용

Fixes #457

* fix: GameSettings에 @DynamoDbBean 어노테이션 추가

- DynamoDB Enhanced Client가 중첩 객체를 직렬화/역직렬화할 수 있도록 수정
- ChatRoom 저장/조회 시 GameSettings 변환 오류 해결

Fixes #457

* fix: ChatRoomFunction에 WEBSOCKET_ENDPOINT 환경변수 및 권한 추가

- leaveRoom에서 WebSocketBroadcaster 사용을 위한 환경변수 추가
- execute-api:ManageConnections 권한 추가

* fix: WebSocket Lambda 함수들에 WEBSOCKET_ENDPOINT 환경변수 추가

- WebSocketConnectFunction에 WEBSOCKET_ENDPOINT 추가
- WebSocketDisconnectFunction에 WEBSOCKET_ENDPOINT 추가
- execute-api:ManageConnections 권한 추가

* fix: Grammar WebSocket Lambda 환경 변수 및 권한 추가

- GrammarStreamingConnectFunction에 WEBSOCKET_ENDPOINT 환경 변수 추가
- GrammarStreamingDisconnectFunction에 WEBSOCKET_ENDPOINT 환경 변수 추가
- 두 함수에 execute-api:ManageConnections 권한 추가

* feat: GSI1SK 확장성 있는 재설계 및 DB 레벨 필터링

## 변경 사항

### GSI1SK 포맷 변경
- 기존: {level}#{createdAt}
- 신규: {type}#{gameType}#{status}#{level}#{createdAt}

### 지원 쿼리 패턴
- 전체 방: GSI1PK = "ROOMS"
- 게임방만: begins_with(GSI1SK, "GAME#")
- 캐치마인드만: begins_with(GSI1SK, "GAME#CATCHMIND#")
- 대기중 캐치마인드: begins_with(GSI1SK, "GAME#CATCHMIND#WAITING#")

### 파일 수정
- ChatRoomCommandService.java: 방 생성 시 새 GSI1SK 포맷 적용
- ChatRoomRepository.java: findByFilters() 메서드 추가, updateStatus() 메서드 추가
- ChatRoomQueryService.java: 메모리 필터링 제거, DB 레벨 필터링으로 변경
- GameService.java: 게임 시작/종료 시 방 상태 업데이트 (GSI1SK 포함)

### 마이그레이션
- scripts/migrate-gsi1sk.sh: 기존 데이터 마이그레이션 스크립트
- 37개 기존 방 마이그레이션 완료

* fix: increase stats query limit to 100 days

- Adjust maximum allowable limit for recent stats query from 30 to 100 days to support extended data range responses.

* feat: improve game round and connection management logic

- Added handling for game round timeout (`ROUND_TIMEOUT`) in WebSocketMessageHandler.
- Enhanced game start broadcast to include `currentWord` for the drawer only.
- Updated ConnectionRepository to remove duplicate user connections in the same room.
- Added `currentWordEnglish` to GameSession for better answer verification.
- Normalized ChatRoom levels to match database storage format.
- Updated template.yaml to include DynamoDBReadPolicy for VocabTable.

* refactor: 코드 정리 및 미사용 클래스 제거 (#459)

* refactor: remove unused WebSocketResponseUtil

* refactor: add AutoCloseable to WebSocketBroadcaster

* refactor: remove unused TestService

* refactor: remove unused WordService

* refactor: remove unused DailyStudyService

* refactor: remove unused UserWordService

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* fix: resolve N+1 query in StatsService

* refactor(all): DI 패턴 및 전략 패턴 적용 (#461)

- Repository, Service, Handler에 DI 생성자 추가 (테스트 용이성)
- BadgeService에 Strategy 패턴 적용 (뱃지 조건 검증 로직 분리)

* refactor: relocate and restructure seed data files

- Moved `question-homes.json` and `words.json` from subdirectories to `seed` folder.
- Updated file paths for better organization and clarity.

* chore: seed 데이터 폴더 구조 정리

* feat: add CI/CD pipeline configuration for CodePipeline

* fix: add SNS topic policy and DependsOn for notification rule

* fix: correct paths in buildspec.yml for CodeBuild

* fix: remove hardcoded JAVA_HOME, use runtime default

* fix: add gradle wrapper for CI/CD build

* fix: use single line sam package command with hardcoded bucket

* fix: use existing stack name group2-englishstudy-chatting

* fix: add missing WEBSOCKET_ENDPOINT env var to WebSocket connect functions

* docs: update FRONTEND-API-GUIDE with new RoomType/RoomStatus structure

* feat : WebSocket Connect, Disconnect 핸들러 & SpeakingConnecion 모델 구현

* feat : WebSocket 메시지 처리 handler, service 구현

* feat : WebSocket 연결 정보 Repository 구현

* fix: update WebSocketDisconnectHandler to use GameSession model

- Remove references to deleted ChatRoom game fields
- Use GameSessionRepository to finish active game sessions
- Use ChatRoomRepository.updateStatus() for room state management

* perf: optimize CI/CD build time

- Add pip cache for SAM CLI dependencies
- Enable Gradle parallel builds and build cache
- Add SAM build cache (.aws-sam)
- Use sam build --parallel --cached
- Skip SAM CLI install if already cached
- Remove unnecessary 'clean' to leverage cache

* feat: add custom CodeBuild Docker image with pre-installed tools

- Dockerfile with Java 21 + SAM CLI + Gradle pre-installed
- build-and-push.sh script for ECR deployment
- Updated buildspec.yml for custom image (removes SAM CLI install)
- Expected build time reduction: ~30-40 seconds

* feature : AI 영어 회화 연습 기능 (#468)

* feat : WebSocket Connect, Disconnect 핸들러 & SpeakingConnecion 모델 구현

* feat : WebSocket 메시지 처리 handler, service 구현

* feat : WebSocket 연결 정보 Repository 구현

* fix: remove typo in SpeakingConnectionRepository

* fix : 오타 수정

* chore: trigger build test with custom Docker image

* chore: remove unnecessary newlines and whitespace across WebSocket handlers and related classes

* chore: remove unnecessary newlines and whitespace across WebSocket handlers and related classes

* Release: 캐치마인드 게임 분리, AI 회화 연습, CI/CD 파이프라인 (#469)

* feature : OPIc 세션관리 + 답변 처리 파이프라인 구현  (#413)

* feat : OPIc 질문 & 세션 관련 dto 생성

* refactor : @DynamoDbBean 주석 추가

* feat : 주제 + 소주제 + 레벨로 오픽 질문 조회 추가

* feat : OPIc 세션, 질문, 답변 종합 handler 구현

* feat : 오픽 주제, 소주제별 seed 데이터 추가

* refactor : Transcribe API KEY 환경변수명 수정

* refactor : Bedrock에 사용하는 클로드 모델 변경

* refactor : S3 Key 대신 Proxy에서 요청하는 Base64 값으로 변환

* feat: GAME_START, ROUND_END 메시지에 serverTime 추가

- broadcastGameStart(): serverTime, roundDuration 필드 추가
- broadcastRoundEnd(): serverTime, roundStartTime, roundDuration 필드 추가
- GameService.endRound(): data에 roundStartTime, roundDuration 포함
- 타이머 동기화 버그 수정을 위한 서버 시간 제공

* feat: WebSocketMessageHelper 유틸리티 클래스 추가

- domain 필드 포함 메시지 생성 헬퍼
- DOMAIN_CHAT, DOMAIN_GAME 상수 정의
- buildChatMessage(), buildGameMessage() 메서드

* feat: 모든 WebSocket 메시지에 domain 필드 추가

- ScoreUpdateMessage에 domain 필드 추가
- broadcastGameStart에 domain:"game" 추가
- broadcastRoundEnd에 domain:"game" 추가
- broadcastCorrectAnswerMessage에 domain:"game" 추가
- handleCommandResult 시스템 메시지에 domain:"game" 추가
- handleRegularMessage 채팅 메시지에 domain:"chat" 추가

Closes #426, #427

* feat: GameSession 모델 클래스 생성

- DynamoDB Enhanced Client 어노테이션 적용
- GSI1: roomId로 활성 게임 세션 조회 가능
- 게임 상태 관리용 헬퍼 메서드 포함

Closes #428

* feat: GameSessionRepository 구현

- 기본 CRUD (save, findById, delete)
- roomId로 활성/전체 게임 세션 조회
- 상태, 라운드, 점수 업데이트 메서드
- 정답자 추가, 힌트 사용, 게임 종료 처리

Closes #429

* refactor: ChatRoom에서 게임 필드 분리

- 게임 관련 필드 제거 (gameStatus, currentRound 등)
- activeGameSessionId 필드 추가
- 게임 상태는 GameSession으로 분리됨

Note: 의존 코드 수정은 #431에서 진행

Closes #430

* refactor: GameSession 기반으로 전체 게임 로직 리팩토링

- GameService: ChatRoom 대신 GameSession 사용
- GameStatsService: GameSession 매개변수로 변경
- CommandService: GameSession 기반 점수 조회
- GameHandler: GameSession 기반 REST API
- WebSocketMessageHandler: GameSession 기반 브로드캐스트
- GameStatusResponse, ScoreboardResponse: GameSession 매개변수

Closes #431

* feat: GameSessionHandler Lambda 및 게임 세션 API 구현

- POST /rooms/{roomId}/games - 게임 세션 생성
- GET /games/{gameSessionId} - 게임 상태 조회 (재접속용)
- POST /games/{gameSessionId}/start - 게임 시작
- POST /games/{gameSessionId}/stop - 게임 종료

모든 응답에 serverTime 포함 (타이머 동기화)
출제자에게만 currentWord 포함

Closes #432, #433

* feat: 게임 시작 7분 후 자동 종료 기능 구현

- GameConfig에 gameTimeLimit() 메서드 추가 (기본값: 420초)
- GameSchedulerClient 유틸리티 클래스 생성 (EventBridge Scheduler 연동)
- GameService에 스케줄 생성/취소 로직 추가
- GameAutoCloseHandler Lambda 함수 생성
- template.yaml에 Lambda, IAM Role, Schedule Group 추가

Closes #417

* fix : 메모리 증가 및 Lambda 응답 제한 시간 Cognito 트리거 제한시간과 동일하게 수정 (#439)

* feat: 캐치마인드 게임 방 분리 기능 구현 (#455)

- Room 타입 분리 (CHAT/GAME)
  - RoomType, RoomStatus enum 추가
  - ChatRoom 모델에 type, gameType, gameSettings, status, hostId 필드 추가
  - GameSettings 모델 추가

- 방 생성/조회 API 수정
  - CreateRoomRequest에 type, gameType, gameSettings 필드 추가
  - 방 목록 조회 시 type, gameType, status 필터 지원

- 게임 시작 조건 검증
  - GAME 타입 방에서만 게임 시작 가능 (GAME_007 에러)

- 게임 재시작 API 구현 (#452)
  - POST /rooms/{roomId}/game/restart 엔드포인트 추가
  - 방장만 재시작 가능 (GAME_009 에러)
  - 게임 진행 중 재시작 불가 (GAME_008 에러)

- 방장 변경 로직 구현 (#453)
  - 방장 퇴장 시 다음 멤버에게 자동 이전
  - 모든 멤버 퇴장 시 방 자동 삭제

- WebSocket 메시지 타입 추가 (#454)
  - ROOM_STATUS_CHANGE, HOST_CHANGE 메시지 타입 추가
  - WebSocketMessageHelper에 빌더 메서드 추가

- 테스트 추가
  - RoomType, RoomStatus enum 테스트
  - GameSettings 모델 테스트
  - ChattingErrorCode 테스트 업데이트

Related: #440, #441, #442, #443, #444, #445, #446
Closes: #447, #448, #449, #450, #451, #452, #453, #454

* feat: 참가자 닉네임 및 방장 변경 WebSocket 알림 구현 (#456)

- RoomParticipant DTO 추가 (userId, nickname, isHost)
- ChatRoomQueryService에 닉네임 조회 메서드 추가
  - getParticipantsWithNicknames(): 참가자 목록 + 닉네임
  - getHostNickname(): 방장 닉네임 조회
- ChatRoomHandler.getRoom() 응답에 participants, hostNickname 추가
- ChatRoomCommandService.leaveRoom()에서 방장 변경 시 WebSocket 브로드캐스트

Related: #440

* fix: ChatRoomFunction에 UserTable DynamoDB 권한 추가

- 참가자/방장 닉네임 조회를 위한 UserTable 읽기 권한 추가
- DynamoDBReadPolicy로 UserTable 접근 허용

Fixes #457

* fix: GameSettings에 @DynamoDbBean 어노테이션 추가

- DynamoDB Enhanced Client가 중첩 객체를 직렬화/역직렬화할 수 있도록 수정
- ChatRoom 저장/조회 시 GameSettings 변환 오류 해결

Fixes #457

* fix: ChatRoomFunction에 WEBSOCKET_ENDPOINT 환경변수 및 권한 추가

- leaveRoom에서 WebSocketBroadcaster 사용을 위한 환경변수 추가
- execute-api:ManageConnections 권한 추가

* fix: WebSocket Lambda 함수들에 WEBSOCKET_ENDPOINT 환경변수 추가

- WebSocketConnectFunction에 WEBSOCKET_ENDPOINT 추가
- WebSocketDisconnectFunction에 WEBSOCKET_ENDPOINT 추가
- execute-api:ManageConnections 권한 추가

* fix: Grammar WebSocket Lambda 환경 변수 및 권한 추가

- GrammarStreamingConnectFunction에 WEBSOCKET_ENDPOINT 환경 변수 추가
- GrammarStreamingDisconnectFunction에 WEBSOCKET_ENDPOINT 환경 변수 추가
- 두 함수에 execute-api:ManageConnections 권한 추가

* feat: GSI1SK 확장성 있는 재설계 및 DB 레벨 필터링

## 변경 사항

### GSI1SK 포맷 변경
- 기존: {level}#{createdAt}
- 신규: {type}#{gameType}#{status}#{level}#{createdAt}

### 지원 쿼리 패턴
- 전체 방: GSI1PK = "ROOMS"
- 게임방만: begins_with(GSI1SK, "GAME#")
- 캐치마인드만: begins_with(GSI1SK, "GAME#CATCHMIND#")
- 대기중 캐치마인드: begins_with(GSI1SK, "GAME#CATCHMIND#WAITING#")

### 파일 수정
- ChatRoomCommandService.java: 방 생성 시 새 GSI1SK 포맷 적용
- ChatRoomRepository.java: findByFilters() 메서드 추가, updateStatus() 메서드 추가
- ChatRoomQueryService.java: 메모리 필터링 제거, DB 레벨 필터링으로 변경
- GameService.java: 게임 시작/종료 시 방 상태 업데이트 (GSI1SK 포함)

### 마이그레이션
- scripts/migrate-gsi1sk.sh: 기존 데이터 마이그레이션 스크립트
- 37개 기존 방 마이그레이션 완료

* fix: increase stats query limit to 100 days

- Adjust maximum allowable limit for recent stats query from 30 to 100 days to support extended data range responses.

* feat: improve game round and connection management logic

- Added handling for game round timeout (`ROUND_TIMEOUT`) in WebSocketMessageHandler.
- Enhanced game start broadcast to include `currentWord` for the drawer only.
- Updated ConnectionRepository to remove duplicate user connections in the same room.
- Added `currentWordEnglish` to GameSession for better answer verification.
- Normalized ChatRoom levels to match database storage format.
- Updated template.yaml to include DynamoDBReadPolicy for VocabTable.

* refactor: 코드 정리 및 미사용 클래스 제거 (#459)

* refactor: remove unused WebSocketResponseUtil

* refactor: add AutoCloseable to WebSocketBroadcaster

* refactor: remove unused TestService

* refactor: remove unused WordService

* refactor: remove unused DailyStudyService

* refactor: remove unused UserWordService

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* fix: resolve N+1 query in StatsService

* refactor(all): DI 패턴 및 전략 패턴 적용 (#461)

- Repository, Service, Handler에 DI 생성자 추가 (테스트 용이성)
- BadgeService에 Strategy 패턴 적용 (뱃지 조건 검증 로직 분리)

* refactor: relocate and restructure seed data files

- Moved `question-homes.json` and `words.json` from subdirectories to `seed` folder.
- Updated file paths for better organization and clarity.

* chore: seed 데이터 폴더 구조 정리

* feat: add CI/CD pipeline configuration for CodePipeline

* fix: add SNS topic policy and DependsOn for notification rule

* fix: correct paths in buildspec.yml for CodeBuild

* fix: remove hardcoded JAVA_HOME, use runtime default

* fix: add gradle wrapper for CI/CD build

* fix: use single line sam package command with hardcoded bucket

* fix: use existing stack name group2-englishstudy-chatting

* fix: add missing WEBSOCKET_ENDPOINT env var to WebSocket connect functions

* docs: update FRONTEND-API-GUIDE with new RoomType/RoomStatus structure

* fix: update WebSocketDisconnectHandler to use GameSession model

- Remove references to deleted ChatRoom game fields
- Use GameSessionRepository to finish active game sessions
- Use ChatRoomRepository.updateStatus() for room state management

* perf: optimize CI/CD build time

- Add pip cache for SAM CLI dependencies
- Enable Gradle parallel builds and build cache
- Add SAM build cache (.aws-sam)
- Use sam build --parallel --cached
- Skip SAM CLI install if already cached
- Remove unnecessary 'clean' to leverage cache

* feat: add custom CodeBuild Docker image with pre-installed tools

- Dockerfile with Java 21 + SAM CLI + Gradle pre-installed
- build-and-push.sh script for ECR deployment
- Updated buildspec.yml for custom image (removes SAM CLI install)
- Expected build time reduction: ~30-40 seconds

* feature : AI 영어 회화 연습 기능 (#468)

* feat : WebSocket Connect, Disconnect 핸들러 & SpeakingConnecion 모델 구현

* feat : WebSocket 메시지 처리 handler, service 구현

* feat : WebSocket 연결 정보 Repository 구현

* fix: remove typo in SpeakingConnectionRepository

* chore: trigger build test with custom Docker image

* chore: remove unnecessary newlines and whitespace across WebSocket handlers and related classes

* chore: remove unnecessary newlines and whitespace across WebSocket handlers and related classes

---------

Co-authored-by: hyein Heo <128613248+hye-inA@users.noreply.github.com>

* refactor : websocket -> rest api 전환

* feat : speaking handler REST로 교체

* feat : speaking 관련 dto 생성

* refacotor : 기존 service 코드 로직 재사용 및 repository 리펙토링

* fix: add CORS headers to API Gateway error responses (#479)

API Gateway의 인증 실패 등 에러 응답에 CORS 헤더가 누락되어
CloudFront를 통한 프론트엔드 요청이 차단되는 문제 수정

- UNAUTHORIZED (401) 응답에 CORS 헤더 추가
- ACCESS_DENIED (403) 응답에 CORS 헤더 추가
- DEFAULT_4XX/5XX 응답에 CORS 헤더 추가
- EXPIRED_TOKEN 응답에 CORS 헤더 추가

* feat(news): 뉴스 도메인 기반 구조 구축 (#385)

- NewsCategory, QuizType enum 추가
- NewsKey 상수 클래스 추가
- NewsErrorCode 예외 클래스 추가
- NewsArticle, KeywordInfo, QuizQuestion 모델 추가
- NewsArticleRepository CRUD 구현
- NewsTable DynamoDB 테이블 정의
- CORS GatewayResponses 설정 추가

* feat(news): 뉴스 수집 파이프라인 구현 (#386)

- NewsApiClient: NewsAPI 연동 서비스
- RssFeedParser: RSS 피드 파싱 (BBC, VOA, NPR)
- NewsDuplicateChecker: URL 기반 중복 필터링
- NewsCollectorService: 수집 오케스트레이션
- NewsCollectionHandler: Lambda 핸들러
- EventBridge 스케줄러: 매일 18시 KST 실행

* refactor(news): NewsAPI 제거, RSS만 사용

- NewsApiClient 삭제
- SSM Parameter 의존성 제거
- RSS 소스당 7개씩 수집 (BBC, VOA, NPR = 약 21개/일)

* feat(news): AI 뉴스 분석 시스템 구현 (#387)

- NewsAnalysisService: AI 분석 통합 서비스
  - Bedrock: CEFR 난이도 분석 (A1~C2)
  - Bedrock: 3줄 요약 + 퀴즈 3문제 생성
  - Comprehend: 핵심 키워드 추출
- NewsCollectorService: 수집 시 자동 분석 연동
- GSI1/GSI2 키 자동 설정 (레벨별, 카테고리별 조회)

* feat(news): 뉴스 학습 API 구현 (#388)

- NewsQueryService: 뉴스 조회 서비스
- NewsHandler: API 핸들러
  - GET /news - 목록 조회 (level, category 필터)
  - GET /news/today - 오늘의 뉴스
  - GET /news/recommended - 내 레벨 맞춤 추천
  - GET /news/{articleId} - 상세 조회 (조회수 증가)
- template.yaml: NewsFunction Lambda 추가

* feat(news): 뉴스 학습 부가 기능 구현 (#389)

- 읽기 완료 기록 API (POST /news/{articleId}/read)
- 북마크 토글 API (POST /news/{articleId}/bookmark)
- 북마크 목록 조회 API (GET /news/bookmarks)
- 학습 통계 조회 API (GET /news/stats)
- TTS 오디오 URL 조회 API (GET /news/{articleId}/audio)
- UserNewsRecord 모델 추가
- UserNewsRepository 추가
- NewsLearningService 추가

* feat(news): 복합 퀴즈 시스템 구현 (#471)

- 퀴즈 조회 API (GET /news/{articleId}/quiz)
- 퀴즈 제출 API (POST /news/{articleId}/quiz)
- 퀴즈 기록 조회 API (GET /news/quiz/history)
- NewsQuizResult 모델 추가
- QuizAnswerResult 모델 추가
- NewsQuizRepository 추가
- NewsQuizService 추가

* feat(news): 단어 수집 & Vocabulary 연동 구현 (#472)

- 단어 수집 API (POST /news/{articleId}/words)
- 수집 단어 목록 API (GET /news/words)
- 단어 상세 조회 API (GET /news/{articleId}/words/{word})
- 단어 삭제 API (DELETE /news/{articleId}/words/{word})
- Vocabulary 연동 API (POST /news/words/{word}/sync)
- NewsWordCollect 모델 추가
- NewsWordRepository 추가
- NewsWordService 추가

* feat: add multi-environment deployment support (dev/test/prod)

* fix: update buildspec.yml to deploy prod environment with parameter overrides

* feat(news): 뉴스 도메인 기반 구조 구축 (#385)

- NewsCategory, QuizType enum 추가
- NewsKey 상수 클래스 추가
- NewsErrorCode 예외 클래스 추가
- NewsArticle, KeywordInfo, QuizQuestion 모델 추가
- NewsArticleRepository CRUD 구현
- NewsTable DynamoDB 테이블 정의
- CORS GatewayResponses 설정 추가

* feat(news): 뉴스 수집 파이프라인 구현 (#386)

- NewsApiClient: NewsAPI 연동 서비스
- RssFeedParser: RSS 피드 파싱 (BBC, VOA, NPR)
- NewsDuplicateChecker: URL 기반 중복 필터링
- NewsCollectorService: 수집 오케스트레이션
- NewsCollectionHandler: Lambda 핸들러
- EventBridge 스케줄러: 매일 18시 KST 실행

* refactor(news): NewsAPI 제거, RSS만 사용

- NewsApiClient 삭제
- SSM Parameter 의존성 제거
- RSS 소스당 7개씩 수집 (BBC, VOA, NPR = 약 21개/일)

* feat(news): AI 뉴스 분석 시스템 구현 (#387)

- NewsAnalysisService: AI 분석 통합 서비스
  - Bedrock: CEFR 난이도 분석 (A1~C2)
  - Bedrock: 3줄 요약 + 퀴즈 3문제 생성
  - Comprehend: 핵심 키워드 추출
- NewsCollectorService: 수집 시 자동 분석 연동
- GSI1/GSI2 키 자동 설정 (레벨별, 카테고리별 조회)

* feat(news): 뉴스 학습 API 구현 (#388)

- NewsQueryService: 뉴스 조회 서비스
- NewsHandler: API 핸들러
  - GET /news - 목록 조회 (level, category 필터)
  - GET /news/today - 오늘의 뉴스
  - GET /news/recommended - 내 레벨 맞춤 추천
  - GET /news/{articleId} - 상세 조회 (조회수 증가)
- template.yaml: NewsFunction Lambda 추가

* feat(news): 뉴스 학습 부가 기능 구현 (#389)

- 읽기 완료 기록 API (POST /news/{articleId}/read)
- 북마크 토글 API (POST /news/{articleId}/bookmark)
- 북마크 목록 조회 API (GET /news/bookmarks)
- 학습 통계 조회 API (GET /news/stats)
- TTS 오디오 URL 조회 API (GET /news/{articleId}/audio)
- UserNewsRecord 모델 추가
- UserNewsRepository 추가
- NewsLearningService 추가

* feat(news): 복합 퀴즈 시스템 구현 (#471)

- 퀴즈 조회 API (GET /news/{articleId}/quiz)
- 퀴즈 제출 API (POST /news/{articleId}/quiz)
- 퀴즈 기록 조회 API (GET /news/quiz/history)
- NewsQuizResult 모델 추가
- QuizAnswerResult 모델 추가
- NewsQuizRepository 추가
- NewsQuizService 추가

* feat(news): 단어 수집 & Vocabulary 연동 구현 (#472)

- 단어 수집 API (POST /news/{articleId}/words)
- 수집 단어 목록 API (GET /news/words)
- 단어 상세 조회 API (GET /news/{articleId}/words/{word})
- 단어 삭제 API (DELETE /news/{articleId}/words/{word})
- Vocabulary 연동 API (POST /news/words/{word}/sync)
- NewsWordCollect 모델 추가
- NewsWordRepository 추가
- NewsWordService 추가

* feat: add multi-environment deployment support (dev/test/prod)

* fix: update buildspec.yml to deploy prod environment with parameter overrides

* refactor : AI 말하기 Websocket 구현 -> REST API 구현으로 리팩토링 (#490)

* feat : WebSocket Connect, Disconnect 핸들러 & SpeakingConnecion 모델 구현

* feat : WebSocket 메시지 처리 handler, service 구현

* feat : WebSocket 연결 정보 Repository 구현

* fix : 오타 수정

* refactor : websocket -> rest api 전환

* feat : speaking handler REST로 교체

* feat : speaking 관련 dto 생성

* refacotor : 기존 service 코드 로직 재사용 및 repository 리펙토링

* fix: revert buildspec.yml to build-only for CloudFormation deploy stage

* fix: revert buildspec.yml to build-only for CloudFormation deploy stage

* fix: update all API Gateway StageName to use Environment parameter

* fix: correct VocabularyTable and ContentBucket references in NewsFunction

* fix: correct VocabularyTable and ContentBucket references in NewsFunction

* fix: add stack name prefix to GameScheduleGroup and daily-stats schedule to avoid conflicts

* fix: add stack name prefix to GameScheduleGroup and daily-stats schedule to avoid conflicts

* feat: add support for existing Cognito User Pool reuse across environments

* fix: add conditional Cognito ARN reference in API Gateway Authorizer

* fix: remove Cognito resources completely, use existing Cognito only

* fix: remove Cognito resources completely, use existing Cognito only

* feat : speaking rest API 람다 함수 추가

* feat: add S3 bucket resource and fix environment-specific endpoints

- Add ContentBucket S3 resource for content storage
- Replace hardcoded /dev with ${Environment} in all WebSocket endpoints
- Update Output URLs to use dynamic environment stage


* fix: add stack name prefix to news-collection schedule name

Prevent EventBridge rule name conflicts across environments


* fix: add X-Requested-With and Accept headers to CORS config

Enable additional headers for CloudFront CORS compatibility


* fix: use environment variable for S3 bucket URLs

Replace hardcoded bucket name with BUCKET_NAME env var for multi-env support:
- PreSignUpHandler: dynamic default profile URL
- PostConfirmationHandler: dynamic default profile URL
- UserService: dynamic default profile URL
- BadgeType: dynamic badge image base URL


* fix: disable authorizer for CORS preflight requests

Add AddDefaultAuthorizerToCorsPreflight: false to prevent
Cognito Authorizer from blocking OPTIONS requests


* feat : speaking REST API 람다 함수 추가  (#491)

* feature : OPIc 세션관리 + 답변 처리 파이프라인 구현  (#413)

* feat : OPIc 질문 & 세션 관련 dto 생성

* refactor : @DynamoDbBean 주석 추가

* feat : 주제 + 소주제 + 레벨로 오픽 질문 조회 추가

* feat : OPIc 세션, 질문, 답변 종합 handler 구현

* feat : 오픽 주제, 소주제별 seed 데이터 추가

* refactor : Transcribe API KEY 환경변수명 수정

* refactor : Bedrock에 사용하는 클로드 모델 변경

* refactor : S3 Key 대신 Proxy에서 요청하는 Base64 값으로 변환

* feat: GAME_START, ROUND_END 메시지에 serverTime 추가

- broadcastGameStart(): serverTime, roundDuration 필드 추가
- broadcastRoundEnd(): serverTime, roundStartTime, roundDuration 필드 추가
- GameService.endRound(): data에 roundStartTime, roundDuration 포함
- 타이머 동기화 버그 수정을 위한 서버 시간 제공

* feat: WebSocketMessageHelper 유틸리티 클래스 추가

- domain 필드 포함 메시지 생성 헬퍼
- DOMAIN_CHAT, DOMAIN_GAME 상수 정의
- buildChatMessage(), buildGameMessage() 메서드

* feat: 모든 WebSocket 메시지에 domain 필드 추가

- ScoreUpdateMessage에 domain 필드 추가
- broadcastGameStart에 domain:"game" 추가
- broadcastRoundEnd에 domain:"game" 추가
- broadcastCorrectAnswerMessage에 domain:"game" 추가
- handleCommandResult 시스템 메시지에 domain:"game" 추가
- handleRegularMessage 채팅 메시지에 domain:"chat" 추가

Closes #426, #427

* feat: GameSession 모델 클래스 생성

- DynamoDB Enhanced Client 어노테이션 적용
- GSI1: roomId로 활성 게임 세션 조회 가능
- 게임 상태 관리용 헬퍼 메서드 포함

Closes #428

* feat: GameSessionRepository 구현

- 기본 CRUD (save, findById, delete)
- roomId로 활성/전체 게임 세션 조회
- 상태, 라운드, 점수 업데이트 메서드
- 정답자 추가, 힌트 사용, 게임 종료 처리

Closes #429

* refactor: ChatRoom에서 게임 필드 분리

- 게임 관련 필드 제거 (gameStatus, currentRound 등)
- activeGameSessionId 필드 추가
- 게임 상태는 GameSession으로 분리됨

Note: 의존 코드 수정은 #431에서 진행

Closes #430

* refactor: GameSession 기반으로 전체 게임 로직 리팩토링

- GameService: ChatRoom 대신 GameSession 사용
- GameStatsService: GameSession 매개변수로 변경
- CommandService: GameSession 기반 점수 조회
- GameHandler: GameSession 기반 REST API
- WebSocketMessageHandler: GameSession 기반 브로드캐스트
- GameStatusResponse, ScoreboardResponse: GameSession 매개변수

Closes #431

* feat: GameSessionHandler Lambda 및 게임 세션 API 구현

- POST /rooms/{roomId}/games - 게임 세션 생성
- GET /games/{gameSessionId} - 게임 상태 조회 (재접속용)
- POST /games/{gameSessionId}/start - 게임 시작
- POST /games/{gameSessionId}/stop - 게임 종료

모든 응답에 serverTime 포함 (타이머 동기화)
출제자에게만 currentWord 포함

Closes #432, #433

* feat: 게임 시작 7분 후 자동 종료 기능 구현

- GameConfig에 gameTimeLimit() 메서드 추가 (기본값: 420초)
- GameSchedulerClient 유틸리티 클래스 생성 (EventBridge Scheduler 연동)
- GameService에 스케줄 생성/취소 로직 추가
- GameAutoCloseHandler Lambda 함수 생성
- template.yaml에 Lambda, IAM Role, Schedule Group 추가

Closes #417

* fix : 메모리 증가 및 Lambda 응답 제한 시간 Cognito 트리거 제한시간과 동일하게 수정 (#439)

* feat: 캐치마인드 게임 방 분리 기능 구현 (#455)

- Room 타입 분리 (CHAT/GAME)
  - RoomType, RoomStatus enum 추가
  - ChatRoom 모델에 type, gameType, gameSettings, status, hostId 필드 추가
  - GameSettings 모델 추가

- 방 생성/조회 API 수정
  - CreateRoomRequest에 type, gameType, gameSettings 필드 추가
  - 방 목록 조회 시 type, gameType, status 필터 지원

- 게임 시작 조건 검증
  - GAME 타입 방에서만 게임 시작 가능 (GAME_007 에러)

- 게임 재시작 API 구현 (#452)
  - POST /rooms/{roomId}/game/restart 엔드포인트 추가
  - 방장만 재시작 가능 (GAME_009 에러)
  - 게임 진행 중 재시작 불가 (GAME_008 에러)

- 방장 변경 로직 구현 (#453)
  - 방장 퇴장 시 다음 멤버에게 자동 이전
  - 모든 멤버 퇴장 시 방 자동 삭제

- WebSocket 메시지 타입 추가 (#454)
  - ROOM_STATUS_CHANGE, HOST_CHANGE 메시지 타입 추가
  - WebSocketMessageHelper에 빌더 메서드 추가

- 테스트 추가
  - RoomType, RoomStatus enum 테스트
  - GameSettings 모델 테스트
  - ChattingErrorCode 테스트 업데이트

Related: #440, #441, #442, #443, #444, #445, #446
Closes: #447, #448, #449, #450, #451, #452, #453, #454

* feat: 참가자 닉네임 및 방장 변경 WebSocket 알림 구현 (#456)

- RoomParticipant DTO 추가 (userId, nickname, isHost)
- ChatRoomQueryService에 닉네임 조회 메서드 추가
  - getParticipantsWithNicknames(): 참가자 목록 + 닉네임
  - getHostNickname(): 방장 닉네임 조회
- ChatRoomHandler.getRoom() 응답에 participants, hostNickname 추가
- ChatRoomCommandService.leaveRoom()에서 방장 변경 시 WebSocket 브로드캐스트

Related: #440

* fix: ChatRoomFunction에 UserTable DynamoDB 권한 추가

- 참가자/방장 닉네임 조회를 위한 UserTable 읽기 권한 추가
- DynamoDBReadPolicy로 UserTable 접근 허용

Fixes #457

* fix: GameSettings에 @DynamoDbBean 어노테이션 추가

- DynamoDB Enhanced Client가 중첩 객체를 직렬화/역직렬화할 수 있도록 수정
- ChatRoom 저장/조회 시 GameSettings 변환 오류 해결

Fixes #457

* fix: ChatRoomFunction에 WEBSOCKET_ENDPOINT 환경변수 및 권한 추가

- leaveRoom에서 WebSocketBroadcaster 사용을 위한 환경변수 추가
- execute-api:ManageConnections 권한 추가

* fix: WebSocket Lambda 함수들에 WEBSOCKET_ENDPOINT 환경변수 추가

- WebSocketConnectFunction에 WEBSOCKET_ENDPOINT 추가
- WebSocketDisconnectFunction에 WEBSOCKET_ENDPOINT 추가
- execute-api:ManageConnections 권한 추가

* fix: Grammar WebSocket Lambda 환경 변수 및 권한 추가

- GrammarStreamingConnectFunction에 WEBSOCKET_ENDPOINT 환경 변수 추가
- GrammarStreamingDisconnectFunction에 WEBSOCKET_ENDPOINT 환경 변수 추가
- 두 함수에 execute-api:ManageConnections 권한 추가

* feat: GSI1SK 확장성 있는 재설계 및 DB 레벨 필터링

- 기존: {level}#{createdAt}
- 신규: {type}#{gameType}#{status}#{level}#{createdAt}

- 전체 방: GSI1PK = "ROOMS"
- 게임방만: begins_with(GSI1SK, "GAME#")
- 캐치마인드만: begins_with(GSI1SK, "GAME#CATCHMIND#")
- 대기중 캐치마인드: begins_with(GSI1SK, "GAME#CATCHMIND#WAITING#")

- ChatRoomCommandService.java: 방 생성 시 새 GSI1SK 포맷 적용
- ChatRoomRepository.java: findByFilters() 메서드 추가, updateStatus() 메서드 추가
- ChatRoomQueryService.java: 메모리 필터링 제거, DB 레벨 필터링으로 변경
- GameService.java: 게임 시작/종료 시 방 상태 업데이트 (GSI1SK 포함)

- scripts/migrate-gsi1sk.sh: 기존 데이터 마이그레이션 스크립트
- 37개 기존 방 마이그레이션 완료

* fix: increase stats query limit to 100 days

- Adjust maximum allowable limit for recent stats query from 30 to 100 days to support extended data range responses.

* feat: improve game round and connection management logic

- Added handling for game round timeout (`ROUND_TIMEOUT`) in WebSocketMessageHandler.
- Enhanced game start broadcast to include `currentWord` for the drawer only.
- Updated ConnectionRepository to remove duplicate user connections in the same room.
- Added `currentWordEnglish` to GameSession for better answer verification.
- Normalized ChatRoom levels to match database storage format.
- Updated template.yaml to include DynamoDBReadPolicy for VocabTable.

* refactor: 코드 정리 및 미사용 클래스 제거 (#459)

* refactor: remove unused WebSocketResponseUtil

* refactor: add AutoCloseable to WebSocketBroadcaster

* refactor: remove unused TestService

* refactor: remove unused WordService

* refactor: remove unused DailyStudyService

* refactor: remove unused UserWordService

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* style: remove p tag from javadoc

* fix: resolve N+1 query in StatsService

* refactor(all): DI 패턴 및 전략 패턴 적용 (#461)

- Repository, Service, Handler에 DI 생성자 추가 (테스트 용이성)
- BadgeService에 Strategy 패턴 적용 (뱃지 조건 검증 로직 분리)

* refactor: relocate and restructure seed data files

- Moved `question-homes.json` and `words.json` from subdirectories to `seed` folder.
- Updated file paths for better organization and clarity.

* chore: seed 데이터 폴더 구조 정리

* feat: add CI/CD pipeline configuration for CodePipeline

* fix: add SNS topic policy and DependsOn for notification rule

* fix: correct paths in buildspec.yml for CodeBuild

* fix: remove hardcoded JAVA_HOME, use runtime default

* fix: add gradle wrapper for CI/CD build

* fix: use single line sam package command with hardcoded bucket

* fix: use existing stack name group2-englishstudy-chatting

* fix: add missing WEBSOCKET_ENDPOINT env var to WebSocket connect functions

* docs: update FRONTEND-API-GUIDE with new RoomType/RoomStatus structure

* feat : WebSocket Connect, Disconnect 핸들러 & SpeakingConnecion 모델 구현

* feat : WebSocket 메시지 처리 handler, service 구현

* feat : WebSocket 연결 정보 Repository 구현

* fix: update WebSocketDisconnectHandler to use GameSession model

- Remove references to deleted ChatRoom game fields
- Use GameSessionRepository to finish active game sessions
- Use ChatRoomRepository.updateStatus() for room state management

* perf: optimize CI/CD build time

- Add pip cache for SAM CLI dependencies
- Enable Gradle parallel builds and build cache
- Add SAM build cache (.aws-sam)
- Use sam build --parallel --cached
- Skip SAM CLI install if already cached
- Remove unnecessary 'clean' to leverage cache

* feat: add custom CodeBuild Docker image with pre-installed tools

- Dockerfile with Java 21 + SAM CLI + Gradle pre-installed
- build-and-push.sh script for ECR deployment
- Updated buildspec.yml for custom image (removes SAM CLI install)
- Expected build time reduction: ~30-40 seconds

* feature : AI 영어 회화 연습 기능 (#468)

* feat : WebSocket Connect, Disconnect 핸들러 & SpeakingConnecion 모델 구현

* feat : WebSocket 메시지 처리 handler, service 구현

* feat : WebSocket 연결 정보 Repository 구현

* fix: remove typo in SpeakingConnectionRepository

* fix : 오타 수정

* chore: trigger build test with custom Docker image

* chore: remove unnecessary newlines and whitespace across WebSocket handlers and related classes

* chore: remove unnecessary newlines and whitespace across WebSocket handlers and related classes

* refactor : websocket -> rest api 전환

* feat : speaking handler REST로 교체

* feat : speaking 관련 dto 생성

* refacotor : 기존 service 코드 로직 재사용 및 repository 리펙토링

* fix: add CORS headers to API Gateway error responses (#479)

API Gateway의 인증 실패 등 에러 응답에 CORS 헤더가 누락되어
CloudFront를 통한 프론트엔드 요청이 차단되는 문제 수정

- UNAUTHORIZED (401) 응답에 CORS 헤더 추가
- ACCESS_DENIED (403) 응답에 CORS 헤더 추가
- DEFAULT_4XX/5XX 응답에 CORS 헤더 추가
- EXPIRED_TOKEN 응답에 CORS 헤더 추가

* feat : speaking rest API 람다 함수 추가

---------

Co-authored-by: ddingjoo <ddingsha9@teambind.co.kr>

* refactor : speaking service 재사용

* refactor : AI 영어 회화 연습 코드 리팩토링

* feature : test 벡엔드 서버에 AI 말하기 연습 기능 배포 (#492)

* feat : WebSocket Connect, Disconnect 핸들러 & SpeakingConnecion 모델 구현

* feat : WebSocket 메시지 처리 handler, service 구현

* feat : WebSocket 연결 정보 Repository 구현

* fix : 오타 수정

* refactor : websocket -> rest api 전환

* feat : speaking handler REST로 교체

* feat : speaking 관련 dto 생성

* refacotor : 기존 service 코드 로직 재사용 및 repository 리펙토링

* feat : speaking rest API 람다 함수 추가

* refactor : speaking service 재사용

* refactor : AI 영어 회화 연습 코드 리팩토링

---------

Co-authored-by: DDING JOO <ddingsha9@teambind.co.kr>

* feat : handleChat 메서드 JsonNull 체크 푸가

* feature : handleChat 메서드 JsonNull 체크 추가 (#493)

* feat : WebSocket Connect, Disconnect 핸들러 & SpeakingConnecion 모델 구현

* feat : WebSocket 메시지 처리 handler, service 구현

* feat : WebSocket 연결 정보 Repository 구현

* fix : 오타 수정

* refactor : websocket -> rest api 전환

* feat : speaking handler REST로 교체

* feat : speaking 관련 dto 생성

* refacotor : 기존 service 코드 로직 재사용 및 repository 리펙토링

* feat : speaking rest API 람다 함수 추가

* refactor : speaking service 재사용

* refactor : AI 영어 회화 연습 코드 리팩토링

* feat : handleChat 메서드 JsonNull 체크 푸가

---------

Co-authored-by: DDING JOO <ddingsha9@teambind.co.kr>

* feat(news): 뉴스 학습 배지 시스템 구현 (#473)

- 14개 뉴스 관련 배지 추가 (읽기, 퀴즈, 단어수집, 연속학습, 마스터)
- UserStats에 뉴스 통계 필드 추가
- 6개 뉴스 배지 Strategy 클래스 생성
- 뉴스 읽기/퀴즈/단어수집 시 통계 업데이트 및 배지 체크 연동

* fix: add PATCH method to CORS AllowMethods

* test: BadgeType 개수 테스트 수정 (15 -> 29)

* fix: CORS PATCH 메서드 추가

* docs: 뉴스 기능 프론트엔드 연동 가이드 작성

* fix: NewsCollectionFunction에 Bedrock, Comprehend 권한 추가

* fix: add null check for collectWord request body

- Add INVALID_REQUEST error code to NewsErrorCode
- Check body and word field before accessing in collectWord()
- Prevents NullPointerException when request body is malformed

* feat: enhance stats API and bookmark response for frontend

- Add DAILY stats update for news read/quiz/word collection
- Add /stats/dashboard endpoint with frontend-requested format
  - today: wordsLearned, newsRead, quizzesTaken, wordsTotal
  - overall: totalWordsLearned, totalNewsRead, averageAccuracy, streaks
  - weeklyProgress: last 7 days with date/wordsLearned/newsRead
- Add news-related fields to all stats API responses
- Fix bookmark API to include full article details (title, summary, etc.)

* feat: add category classification to news AI analysis

- Add category field to AnalysisResult record
- Update Bedrock prompt to classify articles into categories
  (WORLD, POLITICS, BUSINESS, TECH, SCIENCE, HEALTH, SPORTS, ENTERTAINMENT, LIFESTYLE)
- Parse and set category from AI response
- Set GSI2 (CATEGORY#) index when category is available

* fix: add /stats/dashboard endpoint to template.yaml

* fix: filter by ARTICLE# prefix in findById to avoid returning UserNewsRecord

* docs: add News API troubleshooting guide

* feat: add Cognito authorizer to News API and enhance keyword extraction

- Set CognitoAuthorizer for all News API endpoints in template.yaml
- Update Bedrock AI to extract keywords with meanings and examples
- Add fallback to Comprehend for keyword extraction when Bedrock fails
- Modify KeywordInfo model to include example field
- Adjust AI prompt to include keyword extraction with examples
- Update AnalysisResult to store keywords and parse them from AI response

* Revert "Merge branch 'test' into prod"

This reverts commit c1a958eac6799d5838a76e4078ae304bcdb62278, reversing
changes made to a6662e0cfc46c6e12f20a89f0df285ff282160bc.

* feat: enhance bookmark and reading status tracking for News API

- Add bookmark and reading status to individual article responses
- Include bookmark status in paginated news responses
- Modify `KeywordInfo` to support Korean translations (`meaningKo`)
- Update AI prompts to extract Korean meanings for keywords

* refactor : session_id가 null 체크 추가

* fix : sessionId NullPointerException 에러 수정  (#496)

* feat : WebSocket Connect, Disconnect 핸들러 & SpeakingConnecion 모델 구현

* feat : WebSocket 메시지 처리 handler, service 구현

* feat : WebSocket 연결 정보 Repository 구현

* fix : 오타 수정

* refactor : websocket -> rest api 전환

* feat : speaking handler REST로 교체

* feat : speaking 관련 dto 생성

* refacotor : 기존 service 코드 로직 재사용 및 repository 리펙토링

* feat : speaking rest API 람다 함수 추가

* refactor : speaking service 재사용

* refactor : AI 영어 회화 연습 코드 리팩토링

* feat : handleChat 메서드 JsonNull 체크 푸가

* refactor : session_id가 null 체크 추가

* feat : template 환경변수 리펙토링

---------

Co-authored-by: DDING JOO <ddingsha9@teambind.co.kr>

* feat: enhance bookmark and reading status tracking for News API

- Add bookmark and reading status to individual article responses
- Include bookmark status in paginated news responses
- Modify `KeywordInfo` to support Korean translations (`meaningKo`)
- Update AI prompts to extract Korean meanings for keywords

* feat: add category filtering to UserWord API with enhanced query logic

- Introduce `category` filtering to `getUserWords` API
- Update WordCategory enums to include "news" category
- Apply category filter after enrichment with word info
- Adjust query limits for bookmarked and incorrect words queries

* feat: add default value for ExistingCognitoClientId in template.yaml

- Set default to an empty string to ensure compatibility with templates using this parameter without explicitly specifying a value.

* fix: SpeakingHandler getStringOrNull 컴파일 에러 수정

* fix: SpeakingHandler getStringOrNull 컴파일 에러 수정

* fix: SpeakingHandler getStringOrNull 컴파일 에러 수정

* fix: Bedrock 키워드(meaningKo 포함)를 article에 저장하도록 수정

* fix: Bedrock 키워드(meaningKo 포함)를 article에 저장하도록 수정

* fix: Bedrock 키워드(meaningKo 포함)를 article에 저장하도록 수정

* fix: Bedrock 키워드(meaningKo 포함)를 article에 저장하도록 수정

* feat: add dashboard stats API and enhance news stats tracking

- Introduce `/stats/dashboard` API for retrieving integrated user stats (today, overall, weekly progress, and level distribution)
- Update `UserStats` model to include additional fields for news stats (newsRead, newsQuizCompleted, newsQuizPerfect, newsWordsCollected, etc.)
- Add atomic updates to track news reading, quiz, and word stats in `UserStatsRepository`
- Modify CloudFormation `template.yaml` to register the new `/stats/dashboard` endpoint

* feat: add dashboard stats API and enhance news stats tracking

- Introduce `/stats/dashboard` API for retrieving integrated user stats (today, overall, weekly progress, and level distribution)
- Update `UserStats` model to include additional fields for news stats (newsRead, newsQuizCompleted, newsQuizPerfect, newsWordsCollected, etc.)
- Add atomic updates to track news reading, quiz, and word stats in `UserStatsRepository`
- Modify CloudFormation `template.yaml` to register the new `/stats/dashboard` endpoint

* feat: add dashboard stats API and enhance news stats tracking

- Introduce `/stats/dashboard` API for retrieving integrated user stats (today, overall, weekly progress, and level distribution)
- Update `UserStats` model to include additional fields for news stats (newsRead, newsQuizCompleted, newsQuizPerfect, newsWordsCollected, etc.)
- Add atomic updates to track news reading, quiz, and word stats in `UserStatsRepository`
- Modify CloudFormation `template.yaml` to register the new `/stats/dashboard` endpoint

* refactor: format code with consistent indentation and spacing

- Apply consistent formatting to improve code readability across multiple files
- Adjust indentation, spacing, and alignment in model classes, DTOs, and repository methods

* fix: filter by ARTICLE# prefix in findById to avoid returning bookmark records


* feature : Speaking Table & Function template.yaml 파일에 추가 (#513)

* fix: BadgeRepository 클라이언트 초기화 패턴 통일

- 개별 DynamoDbEnhancedClient 생성 대신 AwsClients.dynamoDbEnhanced() 싱글톤 사용
- 다른 Repository들과 동일한 패턴 적용
- 불필요한 import 제거

Closes #396

* feat: EnvConfig 유틸리티 추가 및 환경 변수 검증 적용

환경 변수 미설정 시 명확한 에러 메시지를 제공하는 EnvConfig 유틸리티를 추가하고,
기존 System.getenv 호출을 EnvConfig.getRequired/getOrDefault로 대체함.

- EnvConfig: getRequired, getOrDefault, getIntOrDefault, getLongOrDefault 메서드 제공
- Lambda Cold Start 시점에 환경 변수 누락을 조기 감지
- 기존 Config 클래스(WebSocketConfig, RoomTokenConfig) EnvConfig 사용으로 통일

Closes #403

* refactor: TestService submitTest 메서드 책임 분리

submitTest 메서드를 단일 책임 원칙에 맞게 리팩토링:
- gradeAnswers(): 답안 채점 및 결과 집계
- isAnswerCorrect(): 단일 답안 정답 여부 판단
- buildResultItem(): 결과 항목 생성
- saveTestResult(): 테스트 결과 저장
- GradingResult record: 채점 결과 캡슐화

TestService와 TestCommandService 모두 동일하게 적용

Closes #404

* refactor: 하드코딩된 설정값 환경 변수로 외부화

각 도메인별 Config 클래스를 생성하여 하드코딩된 값들을 환경 변수로 설정 가능하게 변경.
기본값이 있어 환경 변수 미설정 시에도 기존 동작 유지.

## 새로 추가된 Config 클래스
- GrammarConfig: SESSION_TTL_DAYS, MAX_HISTORY_MESSAGES, MAX_TOKENS 등
- GameConfig: TOTAL_ROUNDS, ROUND_TIME_LIMIT, QUICK_GUESS_THRESHOLD_MS
- VocabularyConfig: NEW_WORDS_COUNT, REVIEW_WORDS_COUNT, 상태 전이 임계값 등

## 지원하는 환경 변수
- GRAMMAR_SESSION_TTL_DAYS, GRAMMAR_MAX_HISTORY_MESSAGES, GRAMMAR_MAX_TOKENS
- GAME_TOTAL_ROUNDS, GAME_ROUND_TIME_LIMIT, GAME_QUICK_GUESS_THRESHOLD_MS
- VOCAB_NEW_WORDS_COUNT, VOCAB_REVIEW_WORDS_COUNT
- VOCAB_TRANSITION_TO_REVIEWING, VOCAB_TRANSITION_TO_MASTERED

Closes #406

* test: StudyLevel enum 단위 테스트 추가

* test: Difficulty enum 단위 테스트 추가

* test: StudyConfig 단위 테스트 추가

* test: EnvConfig 단위 테스트 추가

* test: PaginatedResult 단위 테스트 추가

* test: JsonUtil 단위 테스트 추가

* test: CursorUtil 단위 테스트 추가

* test: CommonErrorCode 단위 테스트 추가

* test: CommonException 단위 테스트 추가

* test: BadgeType enum 단위 테스트 추가

* test: BadgeKey 상수 단위 테스트 추가

* test: WordStatus enum 단위 테스트 추가

* test: TestType enum 단위 테스트 추가

* test: VocabularyConfig 단위 테스트 추가

* test: VocabKey 상수 단위 테스트 추가

* test: VocabularyErrorCode 단위 테스트 추가

* test: VocabularyException 단위 테스트 추가

* test: SpacedRepetitionContext 단위 테스트 추가

* test: GrammarLevel enum 단위 테스트 추가

* test: GrammarConfig 단위 테스트 추가

* test: GrammarErrorCode 단위 테스트 추가

* test: GrammarException 단위 테스트 추가

* test: GameStatus enum 단위 테스트 추가

* test: GameConfig 단위 테스트 추가

* test: ChattingErrorCode 단위 테스트 추가

* test: ChattingException 단위 테스트 추가

* fix: OPIc FeedbackResponse.java 문법 오류 수정

* style: AwsClients 코드 포맷팅

* style: EnvConfig 코드 포맷팅

* style: RoomTokenConfig 코드 포맷팅

* style: WebSocketConfig 코드 포맷팅

* style: JsonUtil 코드 포맷팅

* style: GameConfig 코드 포맷팅

* style: GrammarConfig 코드 포맷팅

* style: GrammarKey 코드 포맷팅

* style: GrammarErrorCode 코드 포맷팅

* style: GrammarException 코드 포맷팅

* style: BedrockGrammarCheckFactory 코드 포맷팅

* style: GrammarConversationService 코드 포맷팅

* style: FeedbackResponse 코드 포맷팅

* style: SessionReportResponse 코드 포맷팅

* style: SpeakingError 코드 포맷팅

* style: SpeakingErrorType 코드 포맷팅

* style: OPIcException 코드 포맷팅

* style: OPIcAnswer 코드 포맷팅

* style: OPIcQuestion 코드 포맷팅

* style: OPIcSession 코드 포맷팅

* style: OPIcRepository 코드 포맷팅

* style: FeedbackService 코드 포맷팅

* style: TranscribeProxyService 코드 포맷팅

* style: VocabularyConfig 코드 포맷팅

* style: DailyStudyCommandService 코드 포맷팅

* style: TestCommandService 코드 포맷팅

* style: TestService 코드 포맷팅

* style: CommonErrorCodeSpec 코드 포맷팅

* style: JsonUtilSpec 코드 포맷팅

* style: BadgeTypeSpec 코드 포맷팅

* style: ChattingErrorCodeSpec 코드 포맷팅

* style: GrammarLevelSpec 코드 포맷팅

* style: GrammarErrorCodeSpec 코드 포맷팅

* style: VocabularyErrorCodeSpec 코드 포맷팅

* feature : OPIc 세션관리 + 답변 처리 파이프라인 구현  (#413)

* feat : OPIc 질문 & 세션 관련 dto 생성

* refactor : @DynamoDbBean 주석 추가

* feat : 주제 + 소주제 + 레벨로 오픽 질문 조회 추가

* feat : OPIc 세션, 질문, 답변 종합 handler 구현

* feat : 오픽 주제, 소주제별 seed 데이터 추가

* refactor : Transcribe API KEY 환경변수명 수정

* refactor : Bedrock에 사용하는 클로드 모델 변경

* refactor : S3 Key 대신 Proxy에서 요청하는 Base64 값으로 변환

* feat: GAME_START, ROUND_END 메시지에 serverTime 추가

- broadcastGameStart(): serverTime, roundDuration 필드 추가
- broadcastRoundEnd(): serverTime, roundStartTime, roundDuration 필드 추가
- GameService.endRound(): data에 roundStartTime, roundDuration 포함
- 타이머 동기화 버그 수정을 위한 서버 시간 제공

* feat: WebSocketMessageHelper 유틸리티 클래스 추가

- domain 필드 포함 메시지 생성 헬퍼
- DOMAIN_CHAT, DOMAIN_GAME 상수 정의
- buildChatMessage(), buildGameMessage() 메서드

* feat: 모든 WebSocket 메시지에 domain 필드 추가

- ScoreUpdateMessage에 domain 필드 추가
- broadcastGameStart에 domain:"game" 추가
- broadcastRoundEnd에 domain:"game" 추가
- broadcastCorrectAnswerMessage에 domain:"game" 추가
- handleCommandResult 시스템 메시지에 domain:"game" 추가
- handleRegularMessage 채팅 메시지에 domain:"chat" 추가

Closes #426, #427

* feat: GameSession 모델 클래스 생성

- DynamoDB Enhanced Client 어노테이션 적용
- GSI1: roomId로 활성 게임 세션 조회 가능
- 게임 상태 관리용 헬퍼 메서드 포함

Closes #428

* feat: GameSessionRepository 구현

- 기본 CRUD (save, findById, delete)
- roomId로 활성/전체 게임 세션 조회
- 상태, 라운드, 점수 업데이트 메서드
- 정답자 추가, 힌트 사용, 게임 종료 처리

Closes #429

* refactor: ChatRoom에서 게임 필드 분리

- 게임 관련 필드 제거 (gameStatus, currentRound 등)
- activeGameSessionId 필드 추가
- 게임 상태는 GameSession으로 분리됨

Note: 의존 코드 수정은 #431에서 진행

Closes #430

* refactor: GameSession 기반으로 전체 게임 로직 리팩토링

- GameService: ChatRoom 대신 GameSession 사용
- GameStatsService: GameSession 매개변수로 변경
- CommandService: GameSession 기반 점수 조회
- GameHandler: GameSession 기반 REST API
- WebSocketMessageHandler: GameSession 기반 브로드캐스트
- GameStatusResponse, ScoreboardResponse: GameSession 매개변수

Closes #431

* feat: GameSessionHandler Lambda 및 게임 세션 API 구현

- POST /rooms/{roomId}/games - 게임 세션 생성
- GET /games/{gameSessionId} - 게임 상태 조회 (재접속용)
- POST /games/{gameSessionId}/start - 게임 시작
- POST /games/{gameSessionId}/stop - 게임 종료

모든 응답에 serverTime 포함 (타이머 동기화)
출제자에게만 currentWord 포함

Closes #432, #433

* feat: 게임 시작 7분 후 자동 종료 기능 구현

- GameConfig에 gameTimeLimit() 메서드 추가 (기본값: 420초)
- GameSchedulerClient 유틸리티 클래스 생성 (EventBridge Scheduler 연동)
- GameService에 스케줄 생성/취소 로직 추가
- GameAutoCloseHandler Lambda 함수 생성
- template.yaml에 Lambda, IAM Role, Schedule Group 추가

Closes #417

* fix : 메모리 증가 및 Lambda 응답 제한 시간 Cognito 트리거 제한시간과 동일하게 수정 (#439)

* feat: 캐치마인드 게임 방 분리 기능 구현 (#455)

- Room 타입 분리 (CHAT/GAME)
  - RoomType, RoomStatus enum 추가
  - ChatRoom 모델에 type, gameType, gameSettings, status, hostId 필드 추가
  - GameSettings 모델 추가

- 방 생성/조회 API 수정
  - CreateRoomRequest에 type, gameType, gameSettings 필드 추가
  - 방 목록 조회 시 type, gameType, status 필터 지원

- 게임 시작 조건 검증
  - GAME 타입 방에서만 게임 시작 가능 (GAME_007 에러)

- 게임 재시작 API 구현 (#452)
  - POST /rooms/{roomId}/game/restart 엔드포인트 추가
  …

* fix: revert buildspec to build+package only, let Deploy stage handle deployment

- Remove sam deploy from buildspec-test.yml and buildspec-prod.yml
- CodeBuild only does sam build + sam package
- Deploy stage handles CloudFormation deployment with Cognito parameters

* fix: force Authorizer recreation to update Cognito User Pool

* fix: rename Authorizer to CognitoAuthV2 to force recreation with correct User Pool

* fix: use GSI1 index for WordChainSession roomId queries

findActiveByRoomId was querying main table with ROOM#roomId partition key,
but the main table PK is WORDCHAIN#sessionId. Fixed to use GSI1 index
which has ROOM#roomId as partition key.

* feat : Cognito Authorizer(토큰)에서 닉네임을 추출 & DB 저장 로직 구현

* feat : 채팅 메세지 저장시 nickname 추가

---------

Co-authored-by: ddingjoo <ddingsha9@teambind.co.kr>
Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>
---
 ServerlessFunction/buildspec-prod.yml         |  26 ++--
 ServerlessFunction/buildspec-test.yml         |  23 ++-
 .../chatting/handler/ChatMessageHandler.java  |  22 ++-
 .../websocket/WebSocketConnectHandler.java    |  38 ++++-
 .../domain/chatting/model/Connection.java     |   1 +
 .../WordChainSessionRepository.java           |  11 +-
 ServerlessFunction/template.yaml              | 132 +++++++++---------
 7 files changed, 148 insertions(+), 105 deletions(-)

diff --git a/ServerlessFunction/buildspec-prod.yml b/ServerlessFunction/buildspec-prod.yml
index 6b8ed3e3..25d01611 100644
--- a/ServerlessFunction/buildspec-prod.yml
+++ b/ServerlessFunction/buildspec-prod.yml
@@ -5,7 +5,6 @@ env:
     SAM_CLI_TELEMETRY: 0
     GRADLE_OPTS: "-Dorg.gradle.daemon=false -Dorg.gradle.parallel=true -Dorg.gradle.caching=true"
     ENVIRONMENT: prod
-    STACK_NAME: group2-englishstudy-prod
 
 phases:
   install:
@@ -28,26 +27,17 @@ phases:
       - echo "Building SAM application for $ENVIRONMENT..."
       - cd $CODEBUILD_SRC_DIR/ServerlessFunction
       - sam build --parallel --cached
-      - echo "Build completed"
+      - echo "Packaging SAM application..."
+      - sam package --s3-bucket group2-englishstudy-pipeline-artifacts --s3-prefix sam-packages/$ENVIRONMENT --output-template-file packaged-template.yaml
 
   post_build:
     commands:
-      - echo "Deploying to $ENVIRONMENT environment..."
-      - cd $CODEBUILD_SRC_DIR/ServerlessFunction
-      - |
-        sam deploy \
-          --stack-name $STACK_NAME \
-          --s3-bucket group2-englishstudy-pipeline-artifacts \
-          --s3-prefix sam-deploy/prod \
-          --region ap-northeast-2 \
-          --capabilities CAPABILITY_IAM CAPABILITY_AUTO_EXPAND \
-          --no-confirm-changeset \
-          --no-fail-on-empty-changeset \
-          --parameter-overrides \
-            Environment=$ENVIRONMENT \
-            ExistingCognitoUserPoolId=ap-northeast-2_ezDwzFCzR \
-            ExistingCognitoClientId=4ns077jcr1pkue2vvisr6qdpu5
-      - echo "Deployment completed on $(date)"
+      - echo "Build completed on $(date)"
+
+artifacts:
+  files:
+    - packaged-template.yaml
+  base-directory: ServerlessFunction
 
 cache:
   paths:
diff --git a/ServerlessFunction/buildspec-test.yml b/ServerlessFunction/buildspec-test.yml
index e00db1d6..6d75e4f0 100644
--- a/ServerlessFunction/buildspec-test.yml
+++ b/ServerlessFunction/buildspec-test.yml
@@ -5,7 +5,6 @@ env:
     SAM_CLI_TELEMETRY: 0
     GRADLE_OPTS: "-Dorg.gradle.daemon=false -Dorg.gradle.parallel=true -Dorg.gradle.caching=true"
     ENVIRONMENT: test
-    STACK_NAME: group2-englishstudy-test
 
 phases:
   install:
@@ -28,23 +27,17 @@ phases:
       - echo "Building SAM application for $ENVIRONMENT..."
       - cd $CODEBUILD_SRC_DIR/ServerlessFunction
       - sam build --parallel --cached
-      - echo "Build completed"
+      - echo "Packaging SAM application..."
+      - sam package --s3-bucket group2-englishstudy-pipeline-artifacts --s3-prefix sam-packages/$ENVIRONMENT --output-template-file packaged-template.yaml
 
   post_build:
     commands:
-      - echo "Deploying to $ENVIRONMENT environment..."
-      - cd $CODEBUILD_SRC_DIR/ServerlessFunction
-      - |
-        sam deploy \
-          --stack-name $STACK_NAME \
-          --resolve-s3 \
-          --s3-prefix $STACK_NAME \
-          --region ap-northeast-2 \
-          --capabilities CAPABILITY_IAM CAPABILITY_AUTO_EXPAND \
-          --no-confirm-changeset \
-          --no-fail-on-empty-changeset \
-          --parameter-overrides Environment=$ENVIRONMENT ExistingCognitoUserPoolId=ap-northeast-2_ezDwzFCzR ExistingCognitoClientId=4ns077jcr1pkue2vvisr6qdpu5
-      - echo "Deployment completed on $(date)"
+      - echo "Build completed on $(date)"
+
+artifacts:
+  files:
+    - packaged-template.yaml
+  base-directory: ServerlessFunction
 
 cache:
   paths:
diff --git a/ServerlessFunction/src/main/java/com/mzc/secondproject/serverless/domain/chatting/handler/ChatMessageHandler.java b/ServerlessFunction/src/main/java/com/mzc/secondproject/serverless/domain/chatting/handler/ChatMessageHandler.java
index b156feba..07ef6ac9 100644
--- a/ServerlessFunction/src/main/java/com/mzc/secondproject/serverless/domain/chatting/handler/ChatMessageHandler.java
+++ b/ServerlessFunction/src/main/java/com/mzc/secondproject/serverless/domain/chatting/handler/ChatMessageHandler.java
@@ -14,6 +14,8 @@
 import com.mzc.secondproject.serverless.domain.chatting.model.ChatMessage;
 import com.mzc.secondproject.serverless.domain.chatting.repository.ChatRoomRepository;
 import com.mzc.secondproject.serverless.domain.chatting.service.ChatMessageService;
+import com.mzc.secondproject.serverless.domain.user.model.User;
+import com.mzc.secondproject.serverless.domain.user.service.UserService;
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
 
@@ -29,21 +31,23 @@ public class ChatMessageHandler implements RequestHandler<APIGatewayProxyRequest
 	
 	private final ChatMessageService chatMessageService;
 	private final ChatRoomRepository chatRoomRepository;
+	private final UserService userService;
 	private final HandlerRouter router;
 	
 	/**
 	 * 기본 생성자 (Lambda에서 사용)
 	 */
 	public ChatMessageHandler() {
-		this(new ChatMessageService(), new ChatRoomRepository());
+		this(new ChatMessageService(), new ChatRoomRepository(), new UserService());
 	}
 	
 	/**
 	 * 의존성 주입 생성자 (테스트 용이성)
 	 */
-	public ChatMessageHandler(ChatMessageService chatMessageService, ChatRoomRepository chatRoomRepository) {
+	public ChatMessageHandler(ChatMessageService chatMessageService, ChatRoomRepository chatRoomRepository, UserService userService) {
 		this.chatMessageService = chatMessageService;
 		this.chatRoomRepository = chatRoomRepository;
+		this.userService = userService;
 		this.router = initRouter();
 	}
 	
@@ -69,6 +73,19 @@ private APIGatewayProxyResponseEvent sendMessage(APIGatewayProxyRequestEvent req
 			String messageType = dto.getMessageType() != null ? dto.getMessageType() : "TEXT";
 			String messageId = UUID.randomUUID().toString();
 			String now = Instant.now().toString();
+
+			String nickname = "Unknown";
+			try {
+				User user = userService.getUserProfile(userId);
+				if (user != null && user.getNickname() != null) {
+					nickname = user.getNickname();
+				} else {
+					nickname = "User-" + userId.substring(0, 5);
+				}
+			} catch (Exception e) {
+				logger.warn("닉네임 조회 실패: {}", e.getMessage());
+				nickname = "User-" + userId.substring(0, 5);
+			}
 			
 			ChatMessage message = ChatMessage.builder()
 					.pk("ROOM#" + roomId)
@@ -80,6 +97,7 @@ private APIGatewayProxyResponseEvent sendMessage(APIGatewayProxyRequestEvent req
 					.messageId(messageId)
 					.roomId(roomId)
 					.userId(userId)
+					.nickname(nickname)
 					.content(dto.getContent())
 					.messageType(messageType)
 					.createdAt(now)
diff --git a/ServerlessFunction/src/main/java/com/mzc/secondproject/serverless/domain/chatting/handler/websocket/WebSocketConnectHandler.java b/ServerlessFunction/src/main/java/com/mzc/secondproject/serverless/domain/chatting/handler/websocket/WebSocketConnectHandler.java
index 7b674a45..67950d53 100644
--- a/ServerlessFunction/src/main/java/com/mzc/secondproject/serverless/domain/chatting/handler/websocket/WebSocketConnectHandler.java
+++ b/ServerlessFunction/src/main/java/com/mzc/secondproject/serverless/domain/chatting/handler/websocket/WebSocketConnectHandler.java
@@ -56,7 +56,42 @@ public Map<String, Object> handleRequest(Map<String, Object> event, Context cont
 			RoomToken token = optToken.get();
 			String userId = token.getUserId();
 			String roomId = token.getRoomId();
-			
+			String nickname = "Unknown";
+
+			// Cognito Authorizer에서 닉네임 추출
+			try {
+				if (event.containsKey("requestContext")) {
+					Map<String, Object> reqCtx = (Map<String, Object>) event.get("requestContext");
+
+					if (reqCtx.containsKey("authorizer")) {
+						Map<String, Object> auth = (Map<String, Object>) reqCtx.get("authorizer");
+
+						Map<String, Object> claims = auth;
+						if (auth.containsKey("claims")) {
+							claims = (Map<String, Object>) auth.get("claims");
+						} else if (auth.containsKey("principalId")) {
+							claims = auth;
+						}
+
+						if (claims != null) {
+							if (claims.get("nickname") != null) {
+								nickname = (String) claims.get("nickname");
+							} else if (claims.get("custom:nickname") != null) {
+								nickname = (String) claims.get("custom:nickname");
+							} else if (claims.get("name") != null) {
+								nickname = (String) claims.get("name");
+							}
+						}
+					}
+				}
+				// 닉네임 못찾았으면 UserId 앞부분 표시
+				if ("Unknown".equals(nickname) && userId != null && userId.length() > 5) {
+					nickname = "User-" + userId.substring(0, 5);
+				}
+			} catch (Exception ex) {
+				logger.warn("닉네임 표시 실패: {}", ex.getMessage());
+			}
+
 			// 같은 방에서 기존 연결 삭제 (새로고침 시 중복 연결 방지)
 			connectionRepository.deleteUserConnectionsInRoom(userId, roomId);
 			
@@ -72,6 +107,7 @@ public Map<String, Object> handleRequest(Map<String, Object> event, Context cont
 					.gsi2sk("CONN#" + connectionId)
 					.connectionId(connectionId)
 					.userId(userId)
+					.nickname(nickname)
 					.roomId(roomId)
 					.connectedAt(now)
 					.ttl(ttl)
diff --git a/ServerlessFunction/src/main/java/com/mzc/secondproject/serverless/domain/chatting/model/Connection.java b/ServerlessFunction/src/main/java/com/mzc/secondproject/serverless/domain/chatting/model/Connection.java
index 7c130390..5aa02e20 100644
--- a/ServerlessFunction/src/main/java/com/mzc/secondproject/serverless/domain/chatting/model/Connection.java
+++ b/ServerlessFunction/src/main/java/com/mzc/secondproject/serverless/domain/chatting/model/Connection.java
@@ -22,6 +22,7 @@ public class Connection {
 	
 	private String connectionId;
 	private String userId;
+	private String nickname;
 	private String roomId;
 	private String connectedAt;
 	private Long ttl;           // 10분 후 자동 삭제
diff --git a/ServerlessFunction/src/main/java/com/mzc/secondproject/serverless/domain/chatting/repository/WordChainSessionRepository.java b/ServerlessFunction/src/main/java/com/mzc/secondproject/serverless/domain/chatting/repository/WordChainSessionRepository.java
index ca39ddf7..b871987f 100644
--- a/ServerlessFunction/src/main/java/com/mzc/secondproject/serverless/domain/chatting/repository/WordChainSessionRepository.java
+++ b/ServerlessFunction/src/main/java/com/mzc/secondproject/serverless/domain/chatting/repository/WordChainSessionRepository.java
@@ -5,6 +5,7 @@
 import com.mzc.secondproject.serverless.domain.chatting.model.WordChainSession;
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
+import software.amazon.awssdk.enhanced.dynamodb.DynamoDbIndex;
 import software.amazon.awssdk.enhanced.dynamodb.DynamoDbTable;
 import software.amazon.awssdk.enhanced.dynamodb.Key;
 import software.amazon.awssdk.enhanced.dynamodb.TableSchema;
@@ -19,16 +20,20 @@ public class WordChainSessionRepository {
 
 	private static final Logger logger = LoggerFactory.getLogger(WordChainSessionRepository.class);
 	private static final String TABLE_NAME = EnvConfig.getRequired("CHAT_TABLE_NAME");
+	private static final String GSI1_INDEX_NAME = "GSI1";
 
 	private final DynamoDbTable<WordChainSession> table;
+	private final DynamoDbIndex<WordChainSession> gsi1Index;
 
 	public WordChainSessionRepository() {
 		this.table = AwsClients.dynamoDbEnhanced()
 				.table(TABLE_NAME, TableSchema.fromBean(WordChainSession.class));
+		this.gsi1Index = table.index(GSI1_INDEX_NAME);
 	}
 
 	public WordChainSessionRepository(DynamoDbTable<WordChainSession> table) {
 		this.table = table;
+		this.gsi1Index = table.index(GSI1_INDEX_NAME);
 	}
 
 	/**
@@ -52,16 +57,16 @@ public Optional<WordChainSession> findById(String sessionId) {
 	}
 
 	/**
-	 * 방의 활성 세션 조회
+	 * 방의 활성 세션 조회 (GSI1 인덱스 사용)
 	 */
 	public Optional<WordChainSession> findActiveByRoomId(String roomId) {
-		return table.query(QueryConditional.sortBeginsWith(
+		return gsi1Index.query(QueryConditional.sortBeginsWith(
 						Key.builder()
 								.partitionValue("ROOM#" + roomId)
 								.sortValue("WORDCHAIN#")
 								.build()))
-				.items()
 				.stream()
+				.flatMap(page -> page.items().stream())
 				.filter(WordChainSession::isActive)
 				.findFirst();
 	}
diff --git a/ServerlessFunction/template.yaml b/ServerlessFunction/template.yaml
index 225dc206..ed741aeb 100644
--- a/ServerlessFunction/template.yaml
+++ b/ServerlessFunction/template.yaml
@@ -142,10 +142,10 @@ Resources:
           ResponseTemplates:
             application/json: '{"message": "Token expired", "statusCode": 401}'
       Auth:
-        DefaultAuthorizer: CognitoAuthorizer
+        DefaultAuthorizer: CognitoAuthV2
         AddDefaultAuthorizerToCorsPreflight: false
         Authorizers:
-          CognitoAuthorizer:
+          CognitoAuthV2:
             UserPoolArn: !Sub "arn:aws:cognito-idp:${AWS::Region}:${AWS::AccountId}:userpool/${ExistingCognitoUserPoolId}"
             Identity:
               Header: Authorization
@@ -402,7 +402,7 @@ Resources:
             Path: /chat/rooms
             Method: POST
             Auth:
-              Authorizer: CognitoAuthorizer
+              Authorizer: CognitoAuthV2
         GetRooms:
           Type: Api
           Properties:
@@ -410,7 +410,7 @@ Resources:
             Path: /chat/rooms
             Method: GET
             Auth:
-              Authorizer: CognitoAuthorizer
+              Authorizer: CognitoAuthV2
         GetRoom:
           Type: Api
           Properties:
@@ -418,7 +418,7 @@ Resources:
             Path: /chat/rooms/{roomId}
             Method: GET
             Auth:
-              Authorizer: CognitoAuthorizer
+              Authorizer: CognitoAuthV2
         DeleteRoom:
           Type: Api
           Properties:
@@ -426,7 +426,7 @@ Resources:
             Path: /chat/rooms/{roomId}
             Method: DELETE
             Auth:
-              Authorizer: CognitoAuthorizer
+              Authorizer: CognitoAuthV2
         JoinRoom:
           Type: Api
           Properties:
@@ -434,7 +434,7 @@ Resources:
             Path: /chat/rooms/{roomId}/join
             Method: POST
             Auth:
-              Authorizer: CognitoAuthorizer
+              Authorizer: CognitoAuthV2
         LeaveRoom:
           Type: Api
           Properties:
@@ -442,7 +442,7 @@ Resources:
             Path: /chat/rooms/{roomId}/leave
             Method: POST
             Auth:
-              Authorizer: CognitoAuthorizer
+              Authorizer: CognitoAuthV2
 
   GameFunction:
     Type: AWS::Serverless::Function
@@ -489,7 +489,7 @@ Resources:
             Path: /chat/rooms/{roomId}/game/start
             Method: POST
             Auth:
-              Authorizer: CognitoAuthorizer
+              Authorizer: CognitoAuthV2
         StopGame:
           Type: Api
           Properties:
@@ -497,7 +497,7 @@ Resources:
             Path: /chat/rooms/{roomId}/game/stop
             Method: POST
             Auth:
-              Authorizer: CognitoAuthorizer
+              Authorizer: CognitoAuthV2
         GetGameStatus:
           Type: Api
           Properties:
@@ -505,7 +505,7 @@ Resources:
             Path: /chat/rooms/{roomId}/game/status
             Method: GET
             Auth:
-              Authorizer: CognitoAuthorizer
+              Authorizer: CognitoAuthV2
         GetScores:
           Type: Api
           Properties:
@@ -513,7 +513,7 @@ Resources:
             Path: /chat/rooms/{roomId}/game/scores
             Method: GET
             Auth:
-              Authorizer: CognitoAuthorizer
+              Authorizer: CognitoAuthV2
 
   # 끝말잇기(Word Chain) 게임 핸들러
   WordChainFunction:
@@ -546,7 +546,7 @@ Resources:
             Path: /chat/rooms/{roomId}/wordchain/start
             Method: POST
             Auth:
-              Authorizer: CognitoAuthorizer
+              Authorizer: CognitoAuthV2
         SubmitWord:
           Type: Api
           Properties:
@@ -554,7 +554,7 @@ Resources:
             Path: /chat/rooms/{roomId}/wordchain/submit
             Method: POST
             Auth:
-              Authorizer: CognitoAuthorizer
+              Authorizer: CognitoAuthV2
         HandleTimeout:
           Type: Api
           Properties:
@@ -562,7 +562,7 @@ Resources:
             Path: /chat/rooms/{roomId}/wordchain/timeout
             Method: POST
             Auth:
-              Authorizer: CognitoAuthorizer
+              Authorizer: CognitoAuthV2
         StopWordChain:
           Type: Api
           Properties:
@@ -570,7 +570,7 @@ Resources:
             Path: /chat/rooms/{roomId}/wordchain/stop
             Method: POST
             Auth:
-              Authorizer: CognitoAuthorizer
+              Authorizer: CognitoAuthV2
         GetWordChainStatus:
           Type: Api
           Properties:
@@ -578,7 +578,7 @@ Resources:
             Path: /chat/rooms/{roomId}/wordchain/status
             Method: GET
             Auth:
-              Authorizer: CognitoAuthorizer
+              Authorizer: CognitoAuthV2
 
   # 게임 자동 종료 Lambda (EventBridge Scheduler에 의해 호출)
   GameAutoCloseFunction:
@@ -666,7 +666,7 @@ Resources:
             Path: /chat/rooms/{roomId}/messages
             Method: POST
             Auth:
-              Authorizer: CognitoAuthorizer
+              Authorizer: CognitoAuthV2
         GetMessages:
           Type: Api
           Properties:
@@ -674,7 +674,7 @@ Resources:
             Path: /chat/rooms/{roomId}/messages
             Method: GET
             Auth:
-              Authorizer: CognitoAuthorizer
+              Authorizer: CognitoAuthV2
         GetMessage:
           Type: Api
           Properties:
@@ -682,7 +682,7 @@ Resources:
             Path: /chat/rooms/{roomId}/messages/{messageId}
             Method: GET
             Auth:
-              Authorizer: CognitoAuthorizer
+              Authorizer: CognitoAuthV2
 
   ChatVoiceFunction:
     Type: AWS::Serverless::Function
@@ -712,7 +712,7 @@ Resources:
             Path: /chat/voice/synthesize
             Method: POST
             Auth:
-              Authorizer: CognitoAuthorizer
+              Authorizer: CognitoAuthV2
 
   #############################################
   # Vocabulary Lambda Functions
@@ -816,7 +816,7 @@ Resources:
             Path: /vocab/wrong-answers
             Method: GET
             Auth:
-              Authorizer: CognitoAuthorizer
+              Authorizer: CognitoAuthV2
         GetUserWords:
           Type: Api
           Properties:
@@ -824,7 +824,7 @@ Resources:
             Path: /vocab/user-words
             Method: GET
             Auth:
-              Authorizer: CognitoAuthorizer
+              Authorizer: CognitoAuthV2
         GetUserWord:
           Type: Api
           Properties:
@@ -832,7 +832,7 @@ Resources:
             Path: /vocab/user-words/{wordId}
             Method: GET
             Auth:
-              Authorizer: CognitoAuthorizer
+              Authorizer: CognitoAuthV2
         UpdateUserWord:
           Type: Api
           Properties:
@@ -840,7 +840,7 @@ Resources:
             Path: /vocab/user-words/{wordId}
             Method: PUT
             Auth:
-              Authorizer: CognitoAuthorizer
+              Authorizer: CognitoAuthV2
         UpdateUserWordTag:
           Type: Api
           Properties:
@@ -848,7 +848,7 @@ Resources:
             Path: /vocab/user-words/{wordId}/tag
             Method: PATCH
             Auth:
-              Authorizer: CognitoAuthorizer
+              Authorizer: CognitoAuthV2
         UpdateUserWordStatus:
           Type: Api
           Properties:
@@ -856,7 +856,7 @@ Resources:
             Path: /vocab/user-words/{wordId}/status
             Method: PATCH
             Auth:
-              Authorizer: CognitoAuthorizer
+              Authorizer: CognitoAuthV2
 
   WordGroupFunction:
     Type: AWS::Serverless::Function
@@ -878,7 +878,7 @@ Resources:
             Path: /vocab/groups
             Method: POST
             Auth:
-              Authorizer: CognitoAuthorizer
+              Authorizer: CognitoAuthV2
         GetGroups:
           Type: Api
           Properties:
@@ -886,7 +886,7 @@ Resources:
             Path: /vocab/groups
             Method: GET
             Auth:
-              Authorizer: CognitoAuthorizer
+              Authorizer: CognitoAuthV2
         GetGroupDetail:
           Type: Api
           Properties:
@@ -894,7 +894,7 @@ Resources:
             Path: /vocab/groups/{groupId}
             Method: GET
             Auth:
-              Authorizer: CognitoAuthorizer
+              Authorizer: CognitoAuthV2
         UpdateGroup:
           Type: Api
           Properties:
@@ -902,7 +902,7 @@ Resources:
             Path: /vocab/groups/{groupId}
             Method: PUT
             Auth:
-              Authorizer: CognitoAuthorizer
+              Authorizer: CognitoAuthV2
         DeleteGroup:
           Type: Api
           Properties:
@@ -910,7 +910,7 @@ Resources:
             Path: /vocab/groups/{groupId}
             Method: DELETE
             Auth:
-              Authorizer: CognitoAuthorizer
+              Authorizer: CognitoAuthV2
         AddWordToGroup:
           Type: Api
           Properties:
@@ -918,7 +918,7 @@ Resources:
             Path: /vocab/groups/{groupId}/words/{wordId}
             Method: POST
             Auth:
-              Authorizer: CognitoAuthorizer
+              Authorizer: CognitoAuthV2
         RemoveWordFromGroup:
           Type: Api
           Properties:
@@ -926,7 +926,7 @@ Resources:
             Path: /vocab/groups/{groupId}/words/{wordId}
             Method: DELETE
             Auth:
-              Authorizer: CognitoAuthorizer
+              Authorizer: CognitoAuthV2
 
   DailyStudyFunction:
     Type: AWS::Serverless::Function
@@ -953,7 +953,7 @@ Resources:
             Path: /vocab/daily
             Method: GET
             Auth:
-              Authorizer: CognitoAuthorizer
+              Authorizer: CognitoAuthV2
         MarkWordLearned:
           Type: Api
           Properties:
@@ -961,7 +961,7 @@ Resources:
             Path: /vocab/daily/words/{wordId}/learned
             Method: POST
             Auth:
-              Authorizer: CognitoAuthorizer
+              Authorizer: CognitoAuthV2
 
   TestFunction:
     Type: AWS::Serverless::Function
@@ -991,7 +991,7 @@ Resources:
             Path: /vocab/test/start
             Method: POST
             Auth:
-              Authorizer: CognitoAuthorizer
+              Authorizer: CognitoAuthV2
         SubmitAnswer:
           Type: Api
           Properties:
@@ -999,7 +999,7 @@ Resources:
             Path: /vocab/test/submit
             Method: POST
             Auth:
-              Authorizer: CognitoAuthorizer
+              Authorizer: CognitoAuthV2
         GetTestResults:
           Type: Api
           Properties:
@@ -1007,7 +1007,7 @@ Resources:
             Path: /vocab/test/results
             Method: GET
             Auth:
-              Authorizer: CognitoAuthorizer
+              Authorizer: CognitoAuthV2
         GetTestResultDetail:
           Type: Api
           Properties:
@@ -1015,7 +1015,7 @@ Resources:
             Path: /vocab/test/results/{testId}
             Method: GET
             Auth:
-              Authorizer: CognitoAuthorizer
+              Authorizer: CognitoAuthV2
         GetTestedWords:
           Type: Api
           Properties:
@@ -1023,7 +1023,7 @@ Resources:
             Path: /vocab/test/tested-words
             Method: GET
             Auth:
-              Authorizer: CognitoAuthorizer
+              Authorizer: CognitoAuthV2
 
   StatsFunction:
     Type: AWS::Serverless::Function
@@ -1045,7 +1045,7 @@ Resources:
             Path: /vocab/stats
             Method: GET
             Auth:
-              Authorizer: CognitoAuthorizer
+              Authorizer: CognitoAuthV2
         GetDailyStats:
           Type: Api
           Properties:
@@ -1053,7 +1053,7 @@ Resources:
             Path: /vocab/stats/daily
             Method: GET
             Auth:
-              Authorizer: CognitoAuthorizer
+              Authorizer: CognitoAuthV2
         GetWeaknessAnalysis:
           Type: Api
           Properties:
@@ -1061,7 +1061,7 @@ Resources:
             Path: /vocab/stats/weakness
             Method: GET
             Auth:
-              Authorizer: CognitoAuthorizer
+              Authorizer: CognitoAuthV2
 
   VocabVoiceFunction:
     Type: AWS::Serverless::Function
@@ -1143,7 +1143,7 @@ Resources:
             Path: /stats/daily
             Method: GET
             Auth:
-              Authorizer: CognitoAuthorizer
+              Authorizer: CognitoAuthV2
         GetWeeklyStats:
           Type: Api
           Properties:
@@ -1151,7 +1151,7 @@ Resources:
             Path: /stats/weekly
             Method: GET
             Auth:
-              Authorizer: CognitoAuthorizer
+              Authorizer: CognitoAuthV2
         GetMonthlyStats:
           Type: Api
           Properties:
@@ -1159,7 +1159,7 @@ Resources:
             Path: /stats/monthly
             Method: GET
             Auth:
-              Authorizer: CognitoAuthorizer
+              Authorizer: CognitoAuthV2
         GetTotalStats:
           Type: Api
           Properties:
@@ -1167,7 +1167,7 @@ Resources:
             Path: /stats/total
             Method: GET
             Auth:
-              Authorizer: CognitoAuthorizer
+              Authorizer: CognitoAuthV2
         GetDashboard:
           Type: Api
           Properties:
@@ -1175,7 +1175,7 @@ Resources:
             Path: /stats/dashboard
             Method: GET
             Auth:
-              Authorizer: CognitoAuthorizer
+              Authorizer: CognitoAuthV2
         GetStatsHistory:
           Type: Api
           Properties:
@@ -1183,7 +1183,7 @@ Resources:
             Path: /stats/history
             Method: GET
             Auth:
-              Authorizer: CognitoAuthorizer
+              Authorizer: CognitoAuthV2
 
   # Badge Lambda Function
   BadgeFunction:
@@ -1213,7 +1213,7 @@ Resources:
             Path: /badges
             Method: GET
             Auth:
-              Authorizer: CognitoAuthorizer
+              Authorizer: CognitoAuthV2
         GetEarnedBadges:
           Type: Api
           Properties:
@@ -1221,7 +1221,7 @@ Resources:
             Path: /badges/earned
             Method: GET
             Auth:
-              Authorizer: CognitoAuthorizer
+              Authorizer: CognitoAuthV2
 
   #############################################
   # Grammar Lambda Functions
@@ -1268,7 +1268,7 @@ Resources:
             Path: /grammar/check
             Method: POST
             Auth:
-              Authorizer: CognitoAuthorizer
+              Authorizer: CognitoAuthV2
         GrammarConversation:
           Type: Api
           Properties:
@@ -1276,7 +1276,7 @@ Resources:
             Path: /grammar/conversation
             Method: POST
             Auth:
-              Authorizer: CognitoAuthorizer
+              Authorizer: CognitoAuthV2
         GetSessions:
           Type: Api
           Properties:
@@ -1284,7 +1284,7 @@ Resources:
             Path: /grammar/sessions
             Method: GET
             Auth:
-              Authorizer: CognitoAuthorizer
+              Authorizer: CognitoAuthV2
         GetSessionDetail:
           Type: Api
           Properties:
@@ -1292,7 +1292,7 @@ Resources:
             Path: /grammar/sessions/{sessionId}
             Method: GET
             Auth:
-              Authorizer: CognitoAuthorizer
+              Authorizer: CognitoAuthV2
         DeleteSession:
           Type: Api
           Properties:
@@ -1300,7 +1300,7 @@ Resources:
             Path: /grammar/sessions/{sessionId}
             Method: DELETE
             Auth:
-              Authorizer: CognitoAuthorizer
+              Authorizer: CognitoAuthV2
 
   #############################################
   # Grammar WebSocket API (Streaming)
@@ -1564,7 +1564,7 @@ Resources:
             Path: /opic/sessions
             Method: POST
             Auth:
-              Authorizer: CognitoAuthorizer
+              Authorizer: CognitoAuthV2
         # 세션 조회
         GetSession:
           Type: Api
@@ -1573,7 +1573,7 @@ Resources:
             Path: /opic/sessions/{sessionId}
             Method: GET
             Auth:
-              Authorizer: CognitoAuthorizer
+              Authorizer: CognitoAuthV2
         # 세션 목록 조회
         GetSessions:
           Type: Api
@@ -1582,7 +1582,7 @@ Resources:
             Path: /opic/sessions
             Method: GET
             Auth:
-              Authorizer: CognitoAuthorizer
+              Authorizer: CognitoAuthV2
         # 다음 질문 조회
         GetNextQuestion:
           Type: Api
@@ -1591,7 +1591,7 @@ Resources:
             Path: /opic/sessions/{sessionId}/questions/next
             Method: GET
             Auth:
-              Authorizer: CognitoAuthorizer
+              Authorizer: CognitoAuthV2
         # 답변 제출
         SubmitAnswer:
           Type: Api
@@ -1600,7 +1600,7 @@ Resources:
             Path: /opic/sessions/{sessionId}/answers
             Method: POST
             Auth:
-              Authorizer: CognitoAuthorizer
+              Authorizer: CognitoAuthV2
         # 세션 완료
         CompleteSession:
           Type: Api
@@ -1609,7 +1609,7 @@ Resources:
             Path: /opic/sessions/{sessionId}/complete
             Method: POST
             Auth:
-              Authorizer: CognitoAuthorizer
+              Authorizer: CognitoAuthV2
         # 음성 업로드 Presigned URL
         GetUploadUrl:
           Type: Api
@@ -1618,7 +1618,7 @@ Resources:
             Path: /opic/sessions/{sessionId}/upload-url
             Method: GET
             Auth:
-              Authorizer: CognitoAuthorizer
+              Authorizer: CognitoAuthV2
 
   #############################################
   # Speaking Lambda Functions
@@ -1660,7 +1660,7 @@ Resources:
             Path: /speaking/chat
             Method: POST
             Auth:
-              Authorizer: CognitoAuthorizer
+              Authorizer: CognitoAuthV2
         SpeakingReset:
           Type: Api
           Properties:
@@ -1668,7 +1668,7 @@ Resources:
             Path: /speaking/reset
             Method: POST
             Auth:
-              Authorizer: CognitoAuthorizer
+              Authorizer: CognitoAuthV2
 
   #############################################
   # DynamoDB Tables