🔀 :: [#719] - 마운트 해제 API 추가 #720

dolong2 · 2025-09-14T12:04:47Z

개요

마운트 해제 API를 추가합니다.

작업내용

볼륨 마운트시 이미 마운트됐을때 에러를 발생시키는 로직 추가
마운트 삭제, 마운트 조회 메서드 추가
VolumeMountNotFoundException 추가
볼륨 마운트 해제 유스케이스 추가
볼륨 마운트 해제 엔드포인트 추가

체크리스트

탬플릿외에 필요한 항목이 있으면 추가해주세요.

로컬에서 빌드가 성공하나요?
추가(수정)한 코드가 정상적으로 동작하나요?
pr 타켓 브랜치가 맞게 설정되어 있나요?
pr에서 작업할 내용만 작업됐나요?
기존 API와 호환되지 않는 사항이 있나요?

Summary by CodeRabbit

New Features
- 볼륨 언마운트 기능 추가: DELETE /{workspaceId}/volume/{volumeId}/mount (applicationId 필요), 성공 시 200 반환.
- 중복 마운트 방지 로직 추가(이미 마운트된 경우 오류 발생).
- 언마운트 엔드포인트에 인증 요구 추가.
- 신규 오류 코드: 볼륨 마운트 미존재(404) 및 관련 예외 추가.
Tests
- 마운트/언마운트 유스케이스 및 웹 어댑터 테스트 추가, 정상·오류·경계 시나리오 검증.

coderabbitai · 2025-09-14T12:04:53Z

Warning

Rate limit exceeded

@dolong2 has exceeded the limit for the number of commits or files that can be reviewed per hour. Please wait 1 minutes and 6 seconds before requesting another review.

⌛ How to resolve this issue?

After the wait time has elapsed, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans have higher rate limits than the trial, open-source and free plans. In all cases, we re-allow further reviews after a brief timeout.

Please see our FAQ for further information.

📥 Commits

Reviewing files that changed from the base of the PR and between c75eeb6 and 45b06e6.

📒 Files selected for processing (2)

src/main/kotlin/com/dcd/server/persistence/volume/entity/VolumeMountJpaEntity.kt (1 hunks)
src/test/resources/data.sql (1 hunks)

Walkthrough

볼륨 마운트 관련: 단건 마운트 조회/삭제 포트·퍼시스턴스·리포지토리 및 웹 엔드포인트(DELETE) 추가, 중복 마운트 검사·예외 추가, VolumeMount 식별자 모델을 UUID 단일키에서 애플리케이션+볼륨 복합키로 변경, 관련 에러 코드·예외·테스트 추가.

Changes

Cohort / File(s)	Summary
Errors & Exceptions `src/main/kotlin/.../common/error/ErrorCode.kt`, `src/main/kotlin/.../domain/volume/exception/VolumeMountNotFoundException.kt`	`VOLUME_MOUNT_NOT_FOUND("해당 볼륨 마운트를 찾을 수 없음", 404)` 에러 코드 추가 및 `VolumeMountNotFoundException` 신설.
Ports (Volume) `src/main/kotlin/.../domain/volume/spi/CommandVolumePort.kt`, `src/main/kotlin/.../domain/volume/spi/QueryVolumePort.kt`	`deleteMount(volumeMount: VolumeMount)` 및 `findMountByApplicationAndVolume(application: Application, volume: Volume): VolumeMount?` 메서드 추가.
Use cases (Volume) `src/main/kotlin/.../domain/volume/usecase/MountVolumeUseCase.kt`, `src/main/kotlin/.../domain/volume/usecase/UnMountVolumeUseCase.kt`	마운트 시 애플리케이션-볼륨 중복 검사(AlreadyExistsVolumeMountException) 추가. 신규 `UnMountVolumeUseCase.execute(volumeId, applicationId)` 추가(워크스페이스/존재 검증 → 단건 조회 → 삭제 → Deploy 이벤트 발행).
Web & Security `src/main/kotlin/.../presentation/domain/volume/VolumeWebAdapter.kt`, `src/main/kotlin/.../infrastructure/global/config/SecurityConfig.kt`	DELETE `/{workspaceId}/volume/{volumeId}/mount?applicationId=...` 엔드포인트 및 인증 규칙 추가; `VolumeWebAdapter`에 `UnMountVolumeUseCase` 주입.
Persistence & DB model `src/main/kotlin/.../persistence/volume/VolumePersistenceAdapter.kt`, `src/main/kotlin/.../persistence/volume/repository/VolumeMountRepository.kt`, `src/main/kotlin/.../persistence/volume/entity/VolumeMountJpaEntity.kt`, `src/main/kotlin/.../persistence/volume/adapter/VolumeAdapter.kt`, `src/test/resources/data.sql`	VolumeMount JPA 엔티티를 UUID 단일 PK → (application_id, volume_id) 복합키(EmbeddedId)로 변경. 리포지토리 제네릭 ID 타입 변경 및 `findByVolumeAndApplication(...)` 추가. 어댑터에서 id 매핑 제거, 어댑터에 `findMountByApplicationAndVolume`·`deleteMount` 구현 추가. 테스트 DDL을 복합키로 변경 및 FK 제약 추가.
Domain model `src/main/kotlin/.../core/domain/volume/model/VolumeMount.kt`	`VolumeMount` 생성자에서 `id: UUID` 제거(도메인 API 변경).
Tests `src/test/kotlin/.../core/domain/volume/usecase/MountVolumeUseCaseTest.kt`, `src/test/kotlin/.../core/domain/volume/usecase/UnMountVolumeUseCaseTest.kt`, `src/test/kotlin/.../presentation/domain/volume/VolumeWebAdapterTest.kt`, `src/test/resources/data.sql`	중복 마운트 예외 테스트 추가, `UnMountVolumeUseCase` 테스트(성공·여러 오류 경로) 추가, 웹 어댑터 DELETE 엔드포인트 테스트 추가 및 테스트 시그니처/DI·데이터DDL 업데이트.

Sequence Diagram(s)

sequenceDiagram
  autonumber
  actor Client
  participant Web as VolumeWebAdapter
  participant MUC as MountVolumeUseCase
  participant QV as QueryVolumePort
  participant QA as QueryApplicationPort
  participant EV as ApplicationEventPublisher

  Client->>Web: POST /{ws}/volume/{vid}/mount?applicationId=...
  Web->>MUC: execute(volumeId, applicationId)
  MUC->>QV: findById(volumeId)
  MUC->>QA: findById(applicationId)
  MUC->>QV: findMountByApplicationAndVolume(app, vol)
  alt Mount exists
    MUC-->>Web: throw AlreadyExistsVolumeMountException
    Web-->>Client: 4xx
  else Not exists
    MUC->>QV: save mount
    MUC->>EV: publish DeployApplicationEvent
    Web-->>Client: 200 OK
  end

sequenceDiagram
  autonumber
  actor Client
  participant Web as VolumeWebAdapter
  participant UUC as UnMountVolumeUseCase
  participant QV as QueryVolumePort
  participant QA as QueryApplicationPort
  participant CV as CommandVolumePort
  participant EV as ApplicationEventPublisher

  Client->>Web: DELETE /{ws}/volume/{vid}/mount?applicationId=...
  Web->>UUC: execute(volumeId, applicationId)
  UUC->>QV: findById(volumeId)
  UUC->>QA: findById(applicationId)
  UUC->>QV: findMountByApplicationAndVolume(app, vol)
  alt Mount not found
    UUC-->>Web: throw VolumeMountNotFoundException
    Web-->>Client: 404
  else Found
    UUC->>CV: deleteMount(volumeMount)
    UUC->>EV: publish DeployApplicationEvent
    Web-->>Client: 200 OK
  end

Estimated code review effort

🎯 4 (Complex) | ⏱️ ~45 minutes

Possibly related PRs

🔀 :: [#717] - 볼륨 마운트 API 추가 #718: 동일 서브시스템(볼륨-마운트)에서 포트·퍼시스턴스·웹 어댑터 확장을 다룸 — 마운트/언마운트 변경과 코드 레벨 연관.
🔀 :: [#702] - 볼륨 엔티티 추가 #703: VolumeMount 도메인·퍼시스턴스 구조 변경(식별자/매핑) 관련 PR — 복합키 전환 및 어댑터/리포지토리 변경과 직접 연결.
🔀 :: [#709] - 볼륨 삭제 API 추가 #710: 중복 마운트 검사·예외 및 관련 흐름 변경과 연관된 PR — 이미 존재하는 마운트 처리와 직접 연결.

Poem

토끼가 말하네, "마운트 날개 펴!" 🥕
중복이면 멈추고, 없으면 조용히 지워요.
두 키가 손잡아 아이덴티티를 지키고,
이벤트 한 줌 뿌려 배포 길을 여니,
당근 한 조각에 기쁜 깡충 깡충.

Pre-merge checks and finishing touches

✅ Passed checks (3 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title Check	✅ Passed	제목 "🔀 :: [#719] - 마운트 해제 API 추가"는 PR의 핵심 변경사항인 '마운트 해제 API 추가'를 직접적으로 요약하고 있어 변경내용과 부합합니다. 다만 이모지, 이슈 번호 및 '::' 같은 메타문자는 히스토리 탐색 시 불필요한 노이즈가 될 수 있습니다. 전반적으로 동료가 히스토리를 훑을 때 주요 의도를 이해하기에 충분하므로 본 체크는 통과로 판단합니다.
Docstring Coverage	✅ Passed	No functions found in the changes. Docstring coverage check skipped.

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

coderabbitai

Actionable comments posted: 3

🧹 Nitpick comments (10)

src/main/kotlin/com/dcd/server/core/domain/volume/spi/CommandVolumePort.kt (1)

13-13: 삭제 연산 계약 명확화 제안

deleteMount의 결과 계약(존재하지 않아도 성공으로 볼지, 예외를 던질지)을 KDoc에 명시하면 호출부 처리 일관성이 좋아집니다.

src/main/kotlin/com/dcd/server/core/domain/volume/spi/QueryVolumePort.kt (1)

20-20: 단건 조회 메서드 추가 적절 — 네이밍/계약 명시 제안

단건 반환은 “유일성 보장” 전제가 필요합니다. 메서드 KDoc에 유일성 전제와 NotFound/중복 시 동작을 명시하거나, 이름을 findMountByVolumeAndApplication로 맞추면 저장소 메서드와 일관성이 좋아집니다.

src/main/kotlin/com/dcd/server/persistence/volume/VolumePersistenceAdapter.kt (1)

61-63: 조인 키 기반 조회 구현 OK — 읽기 전용 트랜잭션 권장

읽기 메서드는 @Transactional(readOnly = true) 적용 시 성능 이점이 있습니다(2차 캐시/플러시 방지).
src/test/kotlin/com/dcd/server/presentation/domain/volume/VolumeWebAdapterTest.kt (1)
155-170: 언마운트 API 호출 검증 강화 제안

정확한 상호작용을 보장하기 위해 호출 횟수 및 불필요 상호작용 부재를 검증하면 좋습니다.
-            then("볼륨 마운트 해제 유스케이스가 실행되어야함") {
-                verify { unMountVolumeUseCase.execute(testVolumeId, testApplicationId) }
-            }
+            then("볼륨 마운트 해제 유스케이스가 1회 실행되어야함") {
+                verify(exactly = 1) { unMountVolumeUseCase.execute(testVolumeId, testApplicationId) }
+                confirmVerified(unMountVolumeUseCase)
+            }
src/test/kotlin/com/dcd/server/core/domain/volume/usecase/MountVolumeUseCaseTest.kt (1)
117-136: 중복 마운트 시나리오: 테스트 간 상태 격리 보강

같은 컨테이너 내 선행 테스트에서 이미 마운트가 생성되었을 수 있어, 이 블록의 beforeContainer에서 또 저장하면 테스트 순서에 따라 중복 데이터로 인한 불안정이 생길 수 있습니다. 블록 진입 전에 리포지토리를 정리하거나 beforeTest로 전환해 케이스 간 상태를 격리해 주세요.
-        `when`("이미 볼륨에 마운트 됐을때") {
-            beforeContainer {
+        `when`("이미 볼륨에 마운트 됐을때") {
+            beforeTest {
+                volumeMountRepository.deleteAll()
                 val application = queryApplicationPort.findById(targetApplicationId)!!
                 val volume = volumeRepository.findByIdOrNull(targetVolumeId)!!.toDomain()
                 val volumeMount = VolumeMount(
                     id = UUID.randomUUID(),
                     application = application,
                     volume = volume,
                     mountPath = "/test/volume",
                     readOnly = false
                 )
                 volumeMountRepository.save(volumeMount.toEntity())
             }
src/main/kotlin/com/dcd/server/presentation/domain/volume/VolumeWebAdapter.kt (2)
37-39: 생성자 의존성 확장 OK — REST 시맨틱스와 응답 코드 재검토 권장

언마운트는 리소스 제거 성격이므로 200보다 204(No Content)가 자연스럽습니다. 아래 엔드포인트에서 반영 제안드립니다.

94-103: DELETE 응답 코드를 204(No Content)로 변경 제안

REST 관례상 삭제 성공 시 204가 적절합니다. 테스트도 함께 업데이트해 주세요.
-    @DeleteMapping("/{volumeId}/mount")
+    @DeleteMapping("/{volumeId}/mount")
     @WorkspaceOwnerVerification("#workspaceId")
     fun unMountVolume(
         @PathVariable workspaceId: String,
         @PathVariable volumeId: UUID,
         @RequestParam applicationId: String,
     ): ResponseEntity<Void> =
-        unMountVolumeUseCase.execute(volumeId, applicationId)
-            .run { ResponseEntity.ok().build() }
+        unMountVolumeUseCase.execute(volumeId, applicationId)
+            .run { ResponseEntity.noContent().build() }
src/test/kotlin/com/dcd/server/core/domain/volume/usecase/UnMountVolumeUseCaseTest.kt (1)

45-64: 시드 데이터 생성 위치 점검

beforeSpec에서 생성된 엔티티는 케이스 간 공유됩니다. 이후 케이스에서 삭제/수정 시 다른 케이스에 영향 줄 수 있으니, 가능하면 케이스별 beforeTest로 격리하거나 각 케이스 시작 시 리포지토리 정리를 권장합니다.
src/main/kotlin/com/dcd/server/core/domain/volume/usecase/UnMountVolumeUseCase.kt (2)
24-43: 트랜잭션 경계와 이벤트 발행 순서 재검토

삭제 후 즉시 ApplicationEventPublisher로 동기 이벤트를 발행하면 롤백 시 정합성 문제가 생길 수 있습니다. 트랜잭션 경계 내에서 삭제를 보장하고, 커밋 이후에 이벤트가 처리되도록 설계하는 것을 권장합니다.

권장사항:

@Transactional(서비스 계층) 추가로 삭제 원자성 보장.

TransactionalEventPublisher 또는 @TransactionalEventListener(phase = AFTER_COMMIT)/아웃박스 패턴 도입.

예시:
+import org.springframework.transaction.annotation.Transactional
@@
-@UseCase
-class UnMountVolumeUseCase(
+@UseCase
+@Transactional
+class UnMountVolumeUseCase(
38-41: 언마운트의 멱등성(idempotency) 고려(선택)

실무 운영에서는 이미 해제된 상태에 대한 반복 요청을 성공(204) 처리하는 것도 UX/운영상 이점이 있습니다. 현재는 VolumeMountNotFoundException을 던지므로, API 계약에 따라 유지하되 필요 시 옵션화(쿼리 파라미터 또는 별도 엔드포인트 정책) 검토를 제안합니다.

기존 API 가이드에 DELETE 멱등성 요구가 있는지 확인 부탁드립니다.

📜 Review details

Configuration used: CodeRabbit UI

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between aa35205 and 1af84eb.

📒 Files selected for processing (13)

src/main/kotlin/com/dcd/server/core/common/error/ErrorCode.kt (1 hunks)
src/main/kotlin/com/dcd/server/core/domain/volume/exception/VolumeMountNotFoundException.kt (1 hunks)
src/main/kotlin/com/dcd/server/core/domain/volume/spi/CommandVolumePort.kt (1 hunks)
src/main/kotlin/com/dcd/server/core/domain/volume/spi/QueryVolumePort.kt (1 hunks)
src/main/kotlin/com/dcd/server/core/domain/volume/usecase/MountVolumeUseCase.kt (2 hunks)
src/main/kotlin/com/dcd/server/core/domain/volume/usecase/UnMountVolumeUseCase.kt (1 hunks)
src/main/kotlin/com/dcd/server/infrastructure/global/config/SecurityConfig.kt (1 hunks)
src/main/kotlin/com/dcd/server/persistence/volume/VolumePersistenceAdapter.kt (2 hunks)
src/main/kotlin/com/dcd/server/persistence/volume/repository/VolumeMountRepository.kt (1 hunks)
src/main/kotlin/com/dcd/server/presentation/domain/volume/VolumeWebAdapter.kt (3 hunks)
src/test/kotlin/com/dcd/server/core/domain/volume/usecase/MountVolumeUseCaseTest.kt (4 hunks)
src/test/kotlin/com/dcd/server/core/domain/volume/usecase/UnMountVolumeUseCaseTest.kt (1 hunks)
src/test/kotlin/com/dcd/server/presentation/domain/volume/VolumeWebAdapterTest.kt (3 hunks)

🧰 Additional context used

🧠 Learnings (3)

📓 Common learnings

Learnt from: dolong2
PR: dolong2/dcd#703
File: src/main/kotlin/com/dcd/server/core/domain/volume/model/Volume.kt:1-12
Timestamp: 2025-09-01T14:52:42.625Z
Learning: dolong2 prefers to implement validation logic (such as path validation for Volume.physicalPath) in the business logic layer rather than in domain model init blocks, keeping domain models as simple data containers.

📚 Learning: 2025-09-04T14:59:15.319Z

Learnt from: dolong2
PR: dolong2/dcd#710
File: src/main/kotlin/com/dcd/server/core/domain/volume/service/impl/DeleteDockerVolumeServiceImpl.kt:13-18
Timestamp: 2025-09-04T14:59:15.319Z
Learning: dolong2 addressed command injection vulnerability in volume deletion by adding validation in the volume creation service (CreateDockerVolumeServiceImpl) using NAME_SAFE_REGEX pattern, preferring to validate at the source rather than in the deletion service for better security and fail-fast behavior.

Applied to files:

src/main/kotlin/com/dcd/server/infrastructure/global/config/SecurityConfig.kt

📚 Learning: 2024-12-17T14:26:50.307Z

Learnt from: dolong2
PR: dolong2/dcd#411
File: src/test/kotlin/com/dcd/server/core/domain/auth/usecase/SignOutUseCaseTest.kt:32-40
Timestamp: 2024-12-17T14:26:50.307Z
Learning: `SignOutUseCaseTest.kt`의 `afterContainer`에서 테스트 데이터 정리를 할 때 예외 처리를 하지 않아도 괜찮다.

Applied to files:

src/test/kotlin/com/dcd/server/core/domain/volume/usecase/MountVolumeUseCaseTest.kt

⏰ Context from checks skipped due to timeout of 90000ms. You can increase the timeout in your CodeRabbit configuration to a maximum of 15 minutes (900000ms). (1)

GitHub Check: Build and Test

🔇 Additional comments (13)

src/main/kotlin/com/dcd/server/core/common/error/ErrorCode.kt (1)

50-50: 새 에러 코드 추가 적절 — Web/예외 매핑 동기화만 확인해주세요

도메인·웹 레이어에서 VOLUME_MOUNT_NOT_FOUND로 직렬화/매핑되는지, 에러 스펙 문서도 함께 갱신됐는지 확인 부탁드립니다.

src/main/kotlin/com/dcd/server/core/domain/volume/usecase/MountVolumeUseCase.kt (1)

9-9: 예외 import 추가 적절

중복 마운트 방지 플로우에 필요한 의존성 정합합니다.

src/main/kotlin/com/dcd/server/core/domain/volume/exception/VolumeMountNotFoundException.kt (1)

1-6: 도메인 예외 정의 적절

404 코드와 의미가 일치합니다. 메시지/i18n 리소스 동기화만 확인하면 됩니다.

src/main/kotlin/com/dcd/server/persistence/volume/VolumePersistenceAdapter.kt (1)

35-37: 삭제 위임 구현 OK

상위 레이어에서 존재 검증을 수행하므로 deleteById로 충분합니다. 트랜잭션 경계에서 동작하는지만 확인해주세요.

src/main/kotlin/com/dcd/server/infrastructure/global/config/SecurityConfig.kt (1)

108-108: 검증 완료 — DELETE 매처 변경 불필요

VolumeWebAdapter는 @WebAdapter("/{workspaceId}/volume") + @DeleteMapping("/{volumeId}/mount")이고 applicationId는 @RequestParam으로 전달됩니다. 따라서 SecurityConfig의 it.requestMatchers(HttpMethod.DELETE, "/{workspaceId}/volume/{volumeId}/mount").authenticated() 매처는 정확합니다.

Likely an incorrect or invalid review comment.

src/test/kotlin/com/dcd/server/presentation/domain/volume/VolumeWebAdapterTest.kt (3)

14-14: 신규 유스케이스 의존성 임포트 추가 OK

웹 어댑터/테스트 간 시그니처 정합성에 맞게 UnMountVolumeUseCase 임포트 추가된 점 확인했습니다.

35-35: 언마운트 유스케이스 목 추가 OK

relaxUnitFun = true 설정으로 불필요한 스텁 없이 호출 검증이 가능해 보입니다.

43-45: 확인 완료 — 생성자 인자 순서/주입 일치
src/main/kotlin/com/dcd/server/presentation/domain/volume/VolumeWebAdapter.kt(31–38)의 생성자와 src/test/kotlin/com/dcd/server/presentation/domain/volume/VolumeWebAdapterTest.kt(37–45)의 인스턴스화 인자 순서가 일치하며, 저장소 내 다른 생성자 호출/Bean 팩토리 참조는 검색되지 않았습니다.

src/main/kotlin/com/dcd/server/presentation/domain/volume/VolumeWebAdapter.kt (2)

9-9: 언마운트 유스케이스 의존성 추가 OK

컨트롤러 책임 분리가 명확합니다.

94-103: 확인: DELETE /{workspaceId}/volume/{volumeId}/mount 보안 규칙이 등록되어 있습니다

src/main/kotlin/com/dcd/server/infrastructure/global/config/SecurityConfig.kt:108 — it.requestMatchers(HttpMethod.DELETE, "/{workspaceId}/volume/{volumeId}/mount").authenticated() 확인.

src/test/kotlin/com/dcd/server/core/domain/volume/usecase/UnMountVolumeUseCaseTest.kt (2)

72-78: 핵심 성공 경로 검증 LGTM

언마운트 후 퍼시스턴스가 비어있는지 확인하는 단정이 명확합니다.

100-110: 언마운트 비존재 케이스 테스트 LGTM

상태 정리 후 VolumeMountNotFoundException 검증이 적절합니다.

src/main/kotlin/com/dcd/server/core/domain/volume/usecase/UnMountVolumeUseCase.kt (1)

30-37: 확인: Workspace.equals()가 id 기반으로 오버라이드되어 객체 동등성 비교는 안전합니다.
확인 위치: src/main/kotlin/com/dcd/server/core/domain/workspace/model/Workspace.kt (equals → this.id == other.id)

src/main/kotlin/com/dcd/server/core/domain/volume/usecase/MountVolumeUseCase.kt

src/main/kotlin/com/dcd/server/persistence/volume/repository/VolumeMountRepository.kt

src/test/kotlin/com/dcd/server/core/domain/volume/usecase/UnMountVolumeUseCaseTest.kt

coderabbitai

Actionable comments posted: 6

♻️ Duplicate comments (2)

src/main/kotlin/com/dcd/server/core/domain/volume/usecase/MountVolumeUseCase.kt (1)
41-43: 중복 마운트 경쟁 조건: DB 예외 매핑까지 보완 필요

복합 PK로 유니크는 보장되지만, 동시 요청 시 저장 단계에서 DB 예외가 날 수 있습니다. saveMount 경로에서 DataIntegrityViolationException을 AlreadyExistsVolumeMountException으로 매핑해 일관 응답을 보장하세요.

예시(퍼시스턴스 어댑터 쪽 권장):
 try {
     commandVolumePort.saveMount(volumeMount)
-} 
+} catch (e: DataIntegrityViolationException) {
+    throw AlreadyExistsVolumeMountException()
+}
src/main/kotlin/com/dcd/server/persistence/volume/repository/VolumeMountRepository.kt (1)
9-13: 존재 여부 전용 메서드 추가로 불필요한 로딩 방지

중복 체크 용도에는 existsByVolumeAndApplication(...)가 더 경량입니다. 도입 후 UseCase에서 해당 경로 사용을 권장합니다.
 interface VolumeMountRepository : JpaRepository<VolumeMountJpaEntity, VolumeMountJpaEntity.VolumeMountId> {
     fun findAllByVolume(volume: VolumeJpaEntity): List<VolumeMountJpaEntity>
     fun findAllByApplication(application: ApplicationJpaEntity): List<VolumeMountJpaEntity>
     fun findByVolumeAndApplication(volume: VolumeJpaEntity, application: ApplicationJpaEntity): VolumeMountJpaEntity?
+    fun existsByVolumeAndApplication(volume: VolumeJpaEntity, application: ApplicationJpaEntity): Boolean
 }

🧹 Nitpick comments (2)

src/main/kotlin/com/dcd/server/core/domain/volume/usecase/MountVolumeUseCase.kt (1)

50-54: 이벤트 발행의 트랜잭션 경계 확인

저장 실패/롤백 시 재배포 이벤트가 나가지 않도록 after‑commit 기반(TransactionSynchronizationManager/@TransactionalEventListener)인지 확인 바랍니다.
src/test/resources/data.sql (1)
29-30: 삭제 정책 재확인: CASCADE가 비즈니스 검증을 우회할 수 있음

러닝상(검증은 비즈니스 레이어) CASCADE는 의도와 상충할 수 있습니다. 최소한 volume_id 쪽 CASCADE 제거를 고려하거나, 관련 테스트로 앱 레이어 검증이 반드시 실행됨을 보장하세요.
-alter table if exists volume_mount_entity add constraint FKr5bb2ev813ioxtylyobgdphel foreign key (application_id) references application_entity (id) on delete cascade;
-alter table if exists volume_mount_entity add constraint FKq6dppr5p20mvgjditmpypicey foreign key (volume_id) references volume_entity (id) on delete cascade;
+alter table if exists volume_mount_entity add constraint FKr5bb2ev813ioxtylyobgdphel foreign key (application_id) references application_entity (id);
+alter table if exists volume_mount_entity add constraint FKq6dppr5p20mvgjditmpypicey foreign key (volume_id) references volume_entity (id);

📜 Review details

Configuration used: CodeRabbit UI

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between cbb8c6b and bb36242.

📒 Files selected for processing (7)

src/main/kotlin/com/dcd/server/core/domain/volume/model/VolumeMount.kt (0 hunks)
src/main/kotlin/com/dcd/server/core/domain/volume/usecase/MountVolumeUseCase.kt (2 hunks)
src/main/kotlin/com/dcd/server/persistence/volume/VolumePersistenceAdapter.kt (2 hunks)
src/main/kotlin/com/dcd/server/persistence/volume/adapter/VolumeAdapter.kt (0 hunks)
src/main/kotlin/com/dcd/server/persistence/volume/entity/VolumeMountJpaEntity.kt (1 hunks)
src/main/kotlin/com/dcd/server/persistence/volume/repository/VolumeMountRepository.kt (1 hunks)
src/test/resources/data.sql (1 hunks)

💤 Files with no reviewable changes (2)

src/main/kotlin/com/dcd/server/core/domain/volume/model/VolumeMount.kt
src/main/kotlin/com/dcd/server/persistence/volume/adapter/VolumeAdapter.kt

🚧 Files skipped from review as they are similar to previous changes (1)

src/main/kotlin/com/dcd/server/persistence/volume/VolumePersistenceAdapter.kt

🧰 Additional context used

🧠 Learnings (3)

📓 Common learnings

Learnt from: dolong2
PR: dolong2/dcd#703
File: src/main/kotlin/com/dcd/server/core/domain/volume/model/Volume.kt:1-12
Timestamp: 2025-09-01T14:52:42.625Z
Learning: dolong2 prefers to implement validation logic (such as path validation for Volume.physicalPath) in the business logic layer rather than in domain model init blocks, keeping domain models as simple data containers.

📚 Learning: 2025-09-01T14:52:42.625Z

Learnt from: dolong2
PR: dolong2/dcd#703
File: src/main/kotlin/com/dcd/server/core/domain/volume/model/Volume.kt:1-12
Timestamp: 2025-09-01T14:52:42.625Z
Learning: dolong2 prefers to implement validation logic (such as path validation for Volume.physicalPath) in the business logic layer rather than in domain model init blocks, keeping domain models as simple data containers.

Applied to files:

src/main/kotlin/com/dcd/server/core/domain/volume/usecase/MountVolumeUseCase.kt

📚 Learning: 2025-09-01T14:57:07.656Z

Learnt from: dolong2
PR: dolong2/dcd#703
File: src/test/resources/data.sql:28-30
Timestamp: 2025-09-01T14:57:07.656Z
Learning: dolong2 prefers to implement deletion validation in business logic rather than using database CASCADE constraints. For volume deletion, they want to validate if any mounts exist before allowing deletion, preventing accidental data loss while maintaining explicit control over the deletion process.

Applied to files:

src/main/kotlin/com/dcd/server/core/domain/volume/usecase/MountVolumeUseCase.kt

🔇 Additional comments (2)

src/main/kotlin/com/dcd/server/core/domain/volume/usecase/MountVolumeUseCase.kt (1)
44-49: mountPath 입력 검증 추가 권장

비즈니스 계층에서 mountPath에 대해 빈값/공백, 절대경로(/로 시작), 상위 디렉토리 참조("..") 등 검증을 추가하세요.
파일: src/main/kotlin/com/dcd/server/core/domain/volume/usecase/MountVolumeUseCase.kt (라인 44-49)
     val volumeMount = VolumeMount(
         application = application,
         volume = volume,
-        mountPath = mountVolumeReqDto.mountPath,
+        mountPath = mountVolumeReqDto.mountPath.trim().also {
+            require(it.isNotEmpty()) { "mountPath must not be blank" }
+            require(it.startsWith("/")) { "mountPath must be absolute" }
+            require(!it.contains("..")) { "mountPath must not contain '..'" }
+        },
         readOnly = mountVolumeReqDto.readOnly
     )
src/main/kotlin/com/dcd/server/persistence/volume/entity/VolumeMountJpaEntity.kt (1)

1-37: kotlin-jpa 플러그인·Jakarta 어노테이션 적용 확인 (build.gradle.kts)

build.gradle.kts에 kotlin("plugin.jpa") version "1.8.22" 적용되어 있음.

엔티티가 jakarta.persistence를 사용하므로 kotlin-jpa가 jakarta 어노테이션을 대상으로 no-arg/all-open을 적용하는지 확인하거나, 명시적으로 noArg/allOpen에 jakarta.persistence 어노테이션을 추가하거나 Hibernate bytecode enhancer를 사용해야 함. (kotlinlang.org)

저장소 검색에서 Hibernate bytecode enhancer 설정은 발견되지 않음 — 빌드/테스트로 no-arg 생성(기본 생성자)과 프록시 동작을 반드시 확인할 것.

src/main/kotlin/com/dcd/server/persistence/volume/entity/VolumeMountJpaEntity.kt

src/test/resources/data.sql

dolong2 added 5 commits September 14, 2025 20:27

[feat] 볼륨 마운트시 이미 마운트됐을때 에러를 발생시키는 로직 추가

42b1345

[feat] 마운트 삭제 메서드, 마운트 조회 메서드 추가

b172d1b

[feat] VolumeMountNotFoundException 추가

ca1896d

[feat] 볼륨 마운트 해제 유스케이스 추가

9a8fa1b

[feat] 볼륨 마운트 해제 엔드포인트 추가

1af84eb

dolong2 added this to the 볼륨 추가 milestone Sep 14, 2025

dolong2 self-assigned this Sep 14, 2025

dolong2 added 1️⃣ Priority: 상 우선순위 상 ✨ Feature 기능 개발 labels Sep 14, 2025

dolong2 linked an issue Sep 14, 2025 that may be closed by this pull request

마운트 해제 API 추가 #719

Closed

coderabbitai bot reviewed Sep 14, 2025

View reviewed changes

dolong2 added 3 commits September 14, 2025 21:26

[test] 테스트 케이스 오타 수정

cbb8c6b

[fix] 볼륨 마운트의 기본키를 복합 외래키로 수정

bb36242

[fix] 볼륨 마운트 변경에따른 테스트 객체 생성 부분 수정

c75eeb6

coderabbitai bot reviewed Sep 14, 2025

View reviewed changes

[fix] ddl및 엔티티가 일치하도록 수정

45b06e6

dolong2 merged commit aa06f2a into develop Sep 14, 2025
2 checks passed

dolong2 deleted the feature/un-mount-volume-api branch September 14, 2025 13:05

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

🔀 :: [#719] - 마운트 해제 API 추가 #720

🔀 :: [#719] - 마운트 해제 API 추가 #720

Uh oh!

dolong2 commented Sep 14, 2025 •

edited by coderabbitai bot

Loading

Uh oh!

coderabbitai bot commented Sep 14, 2025 •

edited

Loading

Rate limit exceeded

Uh oh!

coderabbitai bot left a comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

coderabbitai bot left a comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

🔀 :: [#719] - 마운트 해제 API 추가 #720

🔀 :: [#719] - 마운트 해제 API 추가 #720

Uh oh!

Conversation

dolong2 commented Sep 14, 2025 • edited by coderabbitai bot Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

개요

작업내용

체크리스트

Summary by CodeRabbit

Uh oh!

coderabbitai bot commented Sep 14, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Rate limit exceeded

Walkthrough

Changes

Sequence Diagram(s)

Estimated code review effort

Possibly related PRs

Poem

Pre-merge checks and finishing touches

Uh oh!

coderabbitai bot left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

coderabbitai bot left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

dolong2 commented Sep 14, 2025 •

edited by coderabbitai bot

Loading

coderabbitai bot commented Sep 14, 2025 •

edited

Loading