🔀 develop -> main 병합 by zzuhannn · Pull Request #52 · R-Goodday/Back

zzuhannn · 2026-05-14T08:11:13Z

개발 브랜치 main에 병합

BaseEntity의 @CreatedDate/@LastModifiedDate가 실제로 동작하도록 @EnableJpaAuditing 활성화

vocab 도메인 service 패키지가 web/message/kafka에 의존하지 않는지 ArchUnit으로 자동 검증하기 위한 testImplementation 추가

동화 페이지의 어려운 단어 + 풀이 저장. UNIQUE(fairytale_id, word) 제약으로 first-occurrence-wins 보장.

- existsByFairytaleIdAndWord: 중복 단어 pre-check - findByFairytaleIdOrderByPageNoAsc: 누적 단어장 페이지 순 조회

- VocabErrorCode enum (PARAGRAPH_NOT_FOUND_FOR_VOCAB, VOCAB_FORBIDDEN, VOCAB_EXTRACT_FAILED) - ParagraphNotFoundForVocabException - VocabForbiddenException

5-state Status enum (SAVED/DUPLICATE/NO_DIFFICULT_WORD/EXTRACTION_FAILED/RACE_SKIPPED) service 패키지가 web/message에 의존하지 않도록 자체 DTO 사용.

단어장 추출 시 특정 페이지의 문장만 조회하기 위한 메서드. 기존 findByFairytaleIdOrderByPageAsc는 그대로 유지.

단어장 추출용 별도 RestTemplate 분리 (connect 1s / read 4s). 기존 restTemplate은 그래프 추출용으로 그대로 유지.

@PostConstruct

- VocabExtractRequest/Response DTO - timeout/5xx 시 1회 retry, 4xx는 즉시 실패 - @PostConstruct warmup으로 cold-start 비용 사전 흡수 - 호출자에 예외 전파하지 않고 Optional.empty()로 fail-open

- processSentences: 3문장 → LLM 단어/풀이 추출 → DB 저장 (5-state 결과) - getVocab: 본인 동화 누적 단어장 페이지 순 조회 - DataIntegrityViolationException catch로 race condition 처리 - carrier-agnostic: web/dto, kafka/message에 의존하지 않음

- WordEntryRes DTO (record + from/listOf 정적 팩토리) - GET /api/fairytales/{fairytaleId}/vocab — 인증된 본인 동화만 조회 가능

@Profile

/internal/** 경로를 인증 없이 통과시키는 별도 SecurityFilterChain. @Profile("dev") + @order(HIGHEST_PRECEDENCE)로 운영 환경엔 영향 없음.

@Profile

POST /internal/vocab/process - 카프카 없이 단어장 추출 비즈니스 로직 단독 호출 가능 - @Profile("dev")로 운영 환경엔 미등록 - @PostConstruct에서 등록 사실 INFO 로그로 노출

vocab.service 패키지가 web/message/kafka/servlet에 의존하지 않음을 ArchUnit으로 빌드 시점에 자동 검증. Phase 2 카프카 어댑터 추가 시에도 service 변경 없음을 강제 보장.

dev 프로필 활성화 시 동작과 운영 환경에서 활성화 금지 안내.

…fkaTemplate로 메세지 부분을 MessageInterface로 런타임에 타입을 추론하게 하여 동적 다형성 설계

…객체 선언

…게하여 Kafka 통신 주소 주입

feat: JpaAuditingConfig 추가

…e로 변경

…O에 fairytaleId 필드 추가

…, 생성된 fairytaleId를 반환하도록 EventService 수정

…드에 주입

Feat: image&done kafka Consumer 추가

Feat/#43

@Profile

- KafkaConsumerConfig: develop의 String 컨슈머 + 우리 vocab JSON 컨슈머 두 개 모두 등록 (@EnableKafka 추가) - EventService: develop의 Fairytale 미리 INSERT + fairytaleId 포함 메시지 그대로 수용 (우리 @Profile("!dev")만 추가) - FairytaleCheckServiceImpl: develop의 markTotalPages/SENT_KEY/TOTAL_KEY 진행률 추적 + 우리 forceVocabIfStale image-side fallback 둘 다 보존

feat : vocab 도메인 Kafka Consumer 연동 (#40)

feat : 지식 그래프 게임 통신 수단 변경

zzuhannn and others added 30 commits April 30, 2026 22:48

feat: JpaAuditingConfig 추가

d32ea05

BaseEntity의 @CreatedDate/@LastModifiedDate가 실제로 동작하도록 @EnableJpaAuditing 활성화

chore: ArchUnit 의존성 추가

4602f09

vocab 도메인 service 패키지가 web/message/kafka에 의존하지 않는지 ArchUnit으로 자동 검증하기 위한 testImplementation 추가

feat: WordEntry 엔티티 추가

78384b7

동화 페이지의 어려운 단어 + 풀이 저장. UNIQUE(fairytale_id, word) 제약으로 first-occurrence-wins 보장.

feat: WordEntryRepository 추가

9532216

- existsByFairytaleIdAndWord: 중복 단어 pre-check - findByFairytaleIdOrderByPageNoAsc: 누적 단어장 페이지 순 조회

feat: VocabErrorCode 및 예외 클래스 추가

da8b575

- VocabErrorCode enum (PARAGRAPH_NOT_FOUND_FOR_VOCAB, VOCAB_FORBIDDEN, VOCAB_EXTRACT_FAILED) - ParagraphNotFoundForVocabException - VocabForbiddenException

feat: VocabExtractionResult 서비스 DTO 추가

89baf44

5-state Status enum (SAVED/DUPLICATE/NO_DIFFICULT_WORD/EXTRACTION_FAILED/RACE_SKIPPED) service 패키지가 web/message에 의존하지 않도록 자체 DTO 사용.

refactor: ParagraphRepository에 findByFairytaleIdAndPage 추가

84c0e66

단어장 추출 시 특정 페이지의 문장만 조회하기 위한 메서드. 기존 findByFairytaleIdOrderByPageAsc는 그대로 유지.

refactor: RestTemplateConfig에 vocabRestTemplate 빈 추가

8aae78c

단어장 추출용 별도 RestTemplate 분리 (connect 1s / read 4s). 기존 restTemplate은 그래프 추출용으로 그대로 유지.

feat: VocabExtractClient 추가 (FastAPI /vocab/extract 호출)

719be99

- VocabExtractRequest/Response DTO - timeout/5xx 시 1회 retry, 4xx는 즉시 실패 - @PostConstruct warmup으로 cold-start 비용 사전 흡수 - 호출자에 예외 전파하지 않고 Optional.empty()로 fail-open

feat: VocabController 추가 (단어장 조회 API)

1ffe403

- WordEntryRes DTO (record + from/listOf 정적 팩토리) - GET /api/fairytales/{fairytaleId}/vocab — 인증된 본인 동화만 조회 가능

feat: InternalApiSecurityConfig 추가 (dev 프로필 한정)

b5f0559

/internal/** 경로를 인증 없이 통과시키는 별도 SecurityFilterChain. @Profile("dev") + @order(HIGHEST_PRECEDENCE)로 운영 환경엔 영향 없음.

feat: InternalVocabController 추가 (dev 프로필 시연용 API)

a5d5477

POST /internal/vocab/process - 카프카 없이 단어장 추출 비즈니스 로직 단독 호출 가능 - @Profile("dev")로 운영 환경엔 미등록 - @PostConstruct에서 등록 사실 INFO 로그로 노출

test: VocabServiceArchTest 추가 (carrier-agnostic 검증)

8fd9fa3

vocab.service 패키지가 web/message/kafka/servlet에 의존하지 않음을 ArchUnit으로 빌드 시점에 자동 검증. Phase 2 카프카 어댑터 추가 시에도 service 변경 없음을 강제 보장.

chore: application-dev.properties 추가 (dev 프로필 안내 주석)

f3b3a8a

dev 프로필 활성화 시 동작과 운영 환경에서 활성화 금지 안내.

Docs: Spring Kafka 의존성 추가

34d4c42

Feat: 동화 생성 요청이 들어올 때, 해당 요청을 DTO로 관리할 수 있게끔 객체 선언

773b1b4

Feat: Kafka Producer 설정, key - String, value - Json으로 파싱하도록 함. 또한, Ka…

fc45113

…fkaTemplate로 메세지 부분을 MessageInterface로 런타임에 타입을 추론하게 하여 동적 다형성 설계

Feat: KafkaTemplate의 메세지 객체를 동적 다형성으로 설계하기 위해 MessageInterface 인터페이스 …

0c56107

…객체 선언

Feat: 동화 생성 요청을 로컬 FastAPI로 전파하기 위해 필요한 값을 메세지로 전파하도록 메세지 객체 설계

838f4ba

Feat: Kafka에 메세지를 등록하도록 하는 서비스 객체와 동화 생성 이벤트를 전파하도록 하는 메소드 작성

1fcde03

Docs: Kafka 테스트를 위해 .env에 Kafka 실제 통신 서버 주소 기록 및 라이브러리를 통해 .env를 직접 읽…

df6059c

…게하여 Kafka 통신 주소 주입

Test: Kafka 통신 테스트 클래스, 메소드 작성

d228a43

Fix: kakfa 템플릿 제네릭을 선언한 Bean 타입과 일치하도록 수정

383bcc3

feat: JpaAuditingConfig 추가

60de216

feat: JpaAuditingConfig 추가

Docs: Kafka 테스트를 위해 .env 내의 Kafka 경로를 직접 주입받게 하는 의존성 라이브러리를 등록

2a477d3

Fix: DI받던 kafkaTemplate의 매개변수를 FairytaleGenerateReq에서 MessageInterfac…

5002fd1

…e로 변경

Feat: 동화 생성 요청이 들어올 시, Kafka에 동화 생성 메세지 등록하는 컨트롤러 메소드를 구현

8bab140

Docs: 사용하지 않는 import문 최적화

603562e

feat: redis 연결 설정

848d193

LgE02 and others added 28 commits May 10, 2026 16:19

feat: Consumer 이미지 저장

a44d138

feat: Consumer done 로직

cb29b39

Feat: 동화 전문을 저장하는 content 필드를 추가

c2fde46

Feat: Fairytale을 생성하는 로직을 FastAPI 서버로 보낼 때, 생성된 fairytaleId를 전달하도록 DT…

9764a53

…O에 fairytaleId 필드 추가

Feat: not null 필드에 쓰레기값을 채워 DB에 저장하고, ID값을 DTO에 담아 Kafka 메시지로 작성하게 하며…

6bf5b8a

…, 생성된 fairytaleId를 반환하도록 EventService 수정

Feat: 동화 생성 요청의 응답 중, FE가 동화 생성 SSE를 연결할 수 있도록 fairytaleId를 응답 data 필…

b9f6202

…드에 주입

Feat: image&done kafka Consumer 추가

dc0362c

Feat: image&done kafka Consumer 추가

Merge pull request #44 from R-Goodday/feat/#43

ab35361

Feat/#43

Merge pull request #45 from R-Goodday/feat/#40

913cba5

feat : vocab 도메인 Kafka Consumer 연동 (#40)

fix: snail_case consumer형식 수정

c4ce34a

fix: dev 설정 삭제

c91eeac

fix: log 및 내용 수정

b099a4f

feat: 기본 RestTemplate에 connect/read timeout 설정

5bd7824

refactor: GraphPersister 빈 분리로 트랜잭션 경계와 외부 I/O 격리

e75a55a

fix: startGame 동기 그래프 추출 폴백 제거

2ea4919

feat: 그래프 추출 전용 Async Executor 빈 등록

2e76b75

feat: fairytale_done 수신 시 비동기로 그래프 추출 트리거

cfaa01e

feat: 게임 완료 여부 조회 API 추가

c42f7d3

feat: GameForbiddenException 및 GAME_403_1 에러코드 추가

6c0d320

refactor: 게임 완료 검증 helper 를 소유권용/그래프용 두 갈래로 분리

3cb1265

fix: game_results 동시 INSERT race 흡수

3cbe7b5

refactor: GameSession 캡슐화 및 SessionEdge description 캐싱

6335a1c

refactor: answerQuiz 정답 분기에서 세션 캐시 사용 및 import 정리

98b1440

refactor: 그래프 추출 RuntimeException 을 커스텀 예외로 교체

5b092ce

refactor: GameSession wildcard import 명시적 import 로 교체

9f23e2d

refactor: GameServiceImpl 메서드 javadoc 슬림화 및 정답 분기 단일화

2479d88

Merge pull request #51 from R-Goodday/feat/#49

777d8ff

feat : 지식 그래프 게임 통신 수단 변경

zzuhannn changed the title ~~develop -> main 병합~~ 🔀 develop -> main 병합 May 14, 2026

zzuhannn merged commit c9f44e1 into main May 14, 2026
2 checks passed

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

🔀 develop -> main 병합#52

🔀 develop -> main 병합#52
zzuhannn merged 87 commits into
mainfrom
develop

zzuhannn commented May 14, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Conversation

zzuhannn commented May 14, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants