Skip to content

refactor : OPIc 답변 처리 비동기화(SNS+Polling) 및 리포트 이메일 발송 구현#555

Merged
hye-inA merged 704 commits into
developfrom
feature/283/414/opic-report-ses-service
Jan 27, 2026
Merged

refactor : OPIc 답변 처리 비동기화(SNS+Polling) 및 리포트 이메일 발송 구현#555
hye-inA merged 704 commits into
developfrom
feature/283/414/opic-report-ses-service

Conversation

@hye-inA

@hye-inA hye-inA commented Jan 27, 2026

Copy link
Copy Markdown
Member

개요

OPIc 답변 제출 시 발생하는 API Gateway 타임아웃(504 Error)을 해결하기 위해, 핵심 로직을 비동기 아키텍처로 전환했습니다. 또한, 세션 완료 시 사용자에게 상세 리포트를 이메일로 자동 발송하는 기능을 추가했습니다.

작업 내용

  1. 답변 처리 프로세스 비동기화 (SNS 기반)

  • 기존 로직: 제출 -> STT -> AI 피드백 -> 응답 (평균 20초 이상 소요로 인한 504 에러 발생)

  • 변경 로직:

    • 답변 상태를 PROCESSING으로 저장하고 SNS 토픽 발행 후 즉시 응답
    • SNS를 트리거로 백그라운드에서 STT(Transcribe) 및 AI 피드백(Bedrock) 수행 후 DB 업데이트
    • 프론트엔드에서 결과 완료 여부를 확인할 수 있는 폴링(Polling) 엔드포인트 구현

DDINGJOO and others added 30 commits January 20, 2026 15:26
@DDINGJOO
style: SessionReportResponse 코드 포맷팅
862d792
@DDINGJOO
style: SpeakingError 코드 포맷팅
4154935
@DDINGJOO
style: SpeakingErrorType 코드 포맷팅
1bf6de1
@DDINGJOO
style: OPIcException 코드 포맷팅
ee0e8f8
@DDINGJOO
style: OPIcAnswer 코드 포맷팅
438c0c0
@DDINGJOO
style: OPIcQuestion 코드 포맷팅
558a205
@DDINGJOO
style: OPIcSession 코드 포맷팅
d44360c
@DDINGJOO
style: OPIcRepository 코드 포맷팅
d67b463
@DDINGJOO
style: FeedbackService 코드 포맷팅
7b0d9e2
@DDINGJOO
style: TranscribeProxyService 코드 포맷팅
d06ca16
@DDINGJOO
style: VocabularyConfig 코드 포맷팅
2ce8f1a
@DDINGJOO
style: DailyStudyCommandService 코드 포맷팅
002e708
@DDINGJOO
style: TestCommandService 코드 포맷팅
57a0408
@DDINGJOO
style: TestService 코드 포맷팅
8af9280
@DDINGJOO
style: CommonErrorCodeSpec 코드 포맷팅
a425f7a
@DDINGJOO
style: JsonUtilSpec 코드 포맷팅
bf87d00
@DDINGJOO
style: BadgeTypeSpec 코드 포맷팅
c1dea55
@DDINGJOO
style: ChattingErrorCodeSpec 코드 포맷팅
95a662c
@DDINGJOO
style: GrammarLevelSpec 코드 포맷팅
4f55e65
@DDINGJOO
style: GrammarErrorCodeSpec 코드 포맷팅
5c6aff1
@DDINGJOO
style: VocabularyErrorCodeSpec 코드 포맷팅
c116134
@DDINGJOO
merge: main 브랜치 병합 충돌 해결
f7e80bd
@DDINGJOO
Merge pull request #412 from Language-Study-Prooject/lint
22e0c2d 
style: 코드 포맷팅 적용
@hye-inA
feature : OPIc 세션관리 + 답변 처리 파이프라인 구현 (#413)
ad155d3 
* feat : OPIc 질문 & 세션 관련 dto 생성

* refactor : @DynamoDbBean 주석 추가

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

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

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

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

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

* refactor : S3 Key 대신 Proxy에서 요청하는 Base64 값으로 변환
@DDINGJOO
feat: GAME_START, ROUND_END 메시지에 serverTime 추가
b30ea0a 
- broadcastGameStart(): serverTime, roundDuration 필드 추가
- broadcastRoundEnd(): serverTime, roundStartTime, roundDuration 필드 추가
- GameService.endRound(): data에 roundStartTime, roundDuration 포함
- 타이머 동기화 버그 수정을 위한 서버 시간 제공
@DDINGJOO
Merge pull request #434 from Language-Study-Prooject/feature/418/419/…
90d1272 
…servertime-fix

[MESP-174] feat: 타이머 동기화 버그 수정 (serverTime)
@DDINGJOO
feat: WebSocketMessageHelper 유틸리티 클래스 추가
6474f76 
- domain 필드 포함 메시지 생성 헬퍼
- DOMAIN_CHAT, DOMAIN_GAME 상수 정의
- buildChatMessage(), buildGameMessage() 메서드
@DDINGJOO
feat: 모든 WebSocket 메시지에 domain 필드 추가
1107a59 
- ScoreUpdateMessage에 domain 필드 추가
- broadcastGameStart에 domain:"game" 추가
- broadcastRoundEnd에 domain:"game" 추가
- broadcastCorrectAnswerMessage에 domain:"game" 추가
- handleCommandResult 시스템 메시지에 domain:"game" 추가
- handleRegularMessage 채팅 메시지에 domain:"chat" 추가

Closes #426, #427
@DDINGJOO
Merge pull request #435 from Language-Study-Prooject/feature/418/420/…
f1236b0 
…domain-field

feat: WebSocket 메시지 구조 개선 - domain 필드 추가
@DDINGJOO
feat: GameSession 모델 클래스 생성
9c61115 
- DynamoDB Enhanced Client 어노테이션 적용
- GSI1: roomId로 활성 게임 세션 조회 가능
- 게임 상태 관리용 헬퍼 메서드 포함

Closes #428
DDINGJOO and others added 19 commits January 25, 2026 18:14
@DDINGJOO
fix: revert buildspec to build+package only, let Deploy stage handle …
0a87543 
…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
@DDINGJOO
Merge test into prod - resolve conflict with test version
0d25309
@DDINGJOO
fix: force Authorizer recreation to update Cognito User Pool
cfc4175
@DDINGJOO
fix: rename Authorizer to CognitoAuthV2 to force recreation with corr…
81ab3cb 
…ect User Pool
@DDINGJOO
fix: use GSI1 index for WordChainSession roomId queries
c03c3c9 
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.
@hye-inA
feat : develop 브랜치 동기화
1b73359
@hye-inA
feat : prod 브랜치 동기화
b2ad5d8
@hye-inA
feat : test 브랜치 동기화
257fabe
@DDINGJOO
Merge pull request #541 from Language-Study-Prooject/test
f957fb9 
fix: WordChain GSI1 index and Authorizer fixes
@hye-inA
feat : main 브랜치 동기화
039448e
@hye-inA
Merge branch 'prod' of https://github.com/Language-Study-Prooject/BE_…
529a180 
…Repository into prod
@hye-inA
feat : prod 브랜치 동기화
feb53e7
@hye-inA
feat : test 브랜치 동기화
0607fc1
@hye-inA
feat : main 브랜치 동기화
359b1f8
@hye-inA
Merge branch 'develop' of https://github.com/Language-Study-Prooject/…
5c8deb6 
…BE_Repository into develop
@hye-inA
feat : SES 클라이언트 의존성 추가
3f85739
@hye-inA
feat : OPIc 람다에 SES 권한 추가
ccd2304
@hye-inA
feat : OPIc 세션 리포트 이메일 발송 서비스 추가
77fdf11
@hye-inA
refactor : 오픽 답변 비동기 처리
aa0cb10
@github-actions github-actions Bot added backend Backend code changes layer:entity Entity/Domain layer layer:service Service layer layer:util Utility/Helper layer layer:config Configuration layer labels Jan 27, 2026
@github-actions

github-actions Bot commented Jan 27, 2026 •
edited by atlassian Bot
Loading

Copy link
Copy Markdown

Jira: MESP-327

@github-actions github-actions Bot removed layer:service Service layer layer:util Utility/Helper layer layer:config Configuration layer labels Jan 27, 2026
@hye-inA hye-inA merged commit 4e0dfad into develop Jan 27, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

No reviews

Assignees

No one assigned

Labels

backend Backend code changes layer:entity Entity/Domain layer

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

2 participants

@hye-inA @DDINGJOO