From c5dec33e2346f4817fcb17e3d12f2c9281324c7c Mon Sep 17 00:00:00 2001
From: rivkode <jonghuncu@gmail.com>
Date: Sat, 25 Apr 2026 20:49:05 +0900
Subject: [PATCH] fix(diarychat): move base path to /api/v1/diary-chatrooms to
 avoid persona-chat collision
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

PR #41 wired the diary chatroom controllers under /api/v1/chatrooms
but that prefix was already owned by ChatRoomApiController (persona
chat domain), so Spring failed to start with:

  Ambiguous mapping. Cannot map 'diaryChatRoomController' method
  ... to {POST [/api/v1/chatrooms]}: There is already
  'chatRoomApiController' bean method ...

- DiaryChatRoom/Message/Polling controllers now mount under
  /api/v1/diary-chatrooms (and .../{roomId}/messages, .../poll)
- API shape and request/response bodies are unchanged; only the base
  path moves
- PRD §7.0.1 records the rename as a documented spec deviation so the
  frontend updates the contract base accordingly

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
---
 docs/prd/backend_api_request.md                                 | 1 +
 .../language/interfaces/diarychat/DiaryChatMessageController.kt | 2 +-
 .../language/interfaces/diarychat/DiaryChatPollingController.kt | 2 +-
 .../language/interfaces/diarychat/DiaryChatRoomController.kt    | 2 +-
 4 files changed, 4 insertions(+), 3 deletions(-)

diff --git a/docs/prd/backend_api_request.md b/docs/prd/backend_api_request.md
index fa01a01..be4fd20 100644
--- a/docs/prd/backend_api_request.md
+++ b/docs/prd/backend_api_request.md
@@ -594,6 +594,7 @@ Screen 3은 **"각자 녹음 → STT → 텍스트로 합류하는 음성 기반
 
 ### 7.0.1 구현 메모 / spec 대비 diff
 
+- **베이스 path 변경 (필수)** — spec 의 `/chatrooms` 는 기존 페르소나 채팅 도메인(`ChatRoomApiController`, `/api/v1/chatrooms`)이 이미 사용 중이라 충돌. **본 도메인은 `/api/v1/diary-chatrooms`** 로 마운트한다. 즉 `POST /api/v1/diary-chatrooms`, `GET /api/v1/diary-chatrooms/{roomId}`, `.../messages`, `.../messages/poll` 등 spec 의 모든 `/chatrooms/...` 를 `/diary-chatrooms/...` 로 치환.
 - **events 저장 모델 (구현 변경)** — spec은 events 를 별도 데이터로 다루지만, 단일 `after={messageId}` cursor 정합성을 위해 백엔드 내부에서는 `diary_chat_message` 테이블에 `source='system' + event_type` 형태로 함께 저장한다. 폴링 응답 시 `source` 로 분리해서 `items` / `events` 두 필드로 변환. **응답 shape 은 spec 그대로**.
 - **AI 토글 기본값** — spec은 `aiAssistantEnabled` 기본 false. 사용자(=PRD owner) 결정으로 **default true** 로 변경 (방 생성 시 자동 ON). 방장이 끌 수 있음.
 - **AI 식별자** — `author.userId = -1`, `username = "Jamo AI"` 합성 author 로 응답 (별도 필드 없이 author 객체에 담김).
diff --git a/src/main/kotlin/com/learner/language/interfaces/diarychat/DiaryChatMessageController.kt b/src/main/kotlin/com/learner/language/interfaces/diarychat/DiaryChatMessageController.kt
index ba53aca..7dddd84 100644
--- a/src/main/kotlin/com/learner/language/interfaces/diarychat/DiaryChatMessageController.kt
+++ b/src/main/kotlin/com/learner/language/interfaces/diarychat/DiaryChatMessageController.kt
@@ -15,7 +15,7 @@ import org.springframework.web.bind.annotation.RequestParam
 import org.springframework.web.bind.annotation.RestController
 
 @RestController
-@RequestMapping("/api/v1/chatrooms/{roomId}/messages")
+@RequestMapping("/api/v1/diary-chatrooms/{roomId}/messages")
 class DiaryChatMessageController(
     private val facade: DiaryChatMessageFacade,
 ) {
diff --git a/src/main/kotlin/com/learner/language/interfaces/diarychat/DiaryChatPollingController.kt b/src/main/kotlin/com/learner/language/interfaces/diarychat/DiaryChatPollingController.kt
index 7959266..b6da690 100644
--- a/src/main/kotlin/com/learner/language/interfaces/diarychat/DiaryChatPollingController.kt
+++ b/src/main/kotlin/com/learner/language/interfaces/diarychat/DiaryChatPollingController.kt
@@ -11,7 +11,7 @@ import org.springframework.web.bind.annotation.RestController
 import org.springframework.web.context.request.async.DeferredResult
 
 @RestController
-@RequestMapping("/api/v1/chatrooms/{roomId}/messages")
+@RequestMapping("/api/v1/diary-chatrooms/{roomId}/messages")
 class DiaryChatPollingController(
     private val facade: DiaryChatPollingFacade,
 ) {
diff --git a/src/main/kotlin/com/learner/language/interfaces/diarychat/DiaryChatRoomController.kt b/src/main/kotlin/com/learner/language/interfaces/diarychat/DiaryChatRoomController.kt
index cc55d97..6181285 100644
--- a/src/main/kotlin/com/learner/language/interfaces/diarychat/DiaryChatRoomController.kt
+++ b/src/main/kotlin/com/learner/language/interfaces/diarychat/DiaryChatRoomController.kt
@@ -13,7 +13,7 @@ import org.springframework.web.bind.annotation.RequestMapping
 import org.springframework.web.bind.annotation.RestController
 
 @RestController
-@RequestMapping("/api/v1/chatrooms")
+@RequestMapping("/api/v1/diary-chatrooms")
 class DiaryChatRoomController(
     private val facade: DiaryChatRoomFacade,
 ) {