🔀 :: [#731] - 초기화 스크립트 엔티티 추가

[dolong2]

개요

• 초기화 스크립트에 관련된 엔티티를 추가합니다.

작업내용

• ApplicationInitialScriptJpaEntity 추가
• ApplicationInitialScript 도메인 추가
• 초기화 스크립트 영속성관련 port및 adapter 추가
• 테스트 sql에 초기화 스크립트 테이블 관련 DDL 추가

체크리스트

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

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

Summary by CodeRabbit

• 새로운 기능
  • 애플리케이션별 초기 스크립트 관리 기능 추가 — 초기 스크립트 저장, 일괄 저장, 조회(ID 또는 애플리케이션별), 삭제(단건/일괄/애플리케이션별) 가능해졌습니다.
• 테스트
  • 테스트 데이터베이스 스키마에 초기 스크립트 테이블이 추가되었습니다.

[coderabbitai]

Walkthrough

응용프로그램의 초기 스크립트 도메인 모델과 해당 CRUD 포트, JPA 엔티티·저장소, 영속성 어댑터 및 도메인↔엔티티 매퍼와 테스트용 DB 스키마를 추가합니다.

Changes

Cohort / File(s)	변경 요약
도메인 모델 src/main/kotlin/com/dcd/server/core/domain/application/model/ApplicationInitialScript.kt	ApplicationInitialScript 도메인 데이터 클래스 추가 (id: UUID, script: String, application: Application)
포트 인터페이스 src/main/kotlin/com/dcd/server/core/domain/application/spi/CommandApplicationInitialScriptPort.kt, src/main/kotlin/com/dcd/server/core/domain/application/spi/QueryApplicationInitialScriptPort.kt, src/main/kotlin/com/dcd/server/core/domain/application/spi/ApplicationInitialScriptPort.kt	명령형 포트(save, saveAll, delete, deleteAll, deleteByApplication) 및 조회 포트(findById, findAllByApplication) 추가, 두 포트를 합친 통합 포트 인터페이스 생성
JPA 엔티티 src/main/kotlin/com/dcd/server/persistence/application/entity/ApplicationInitialScriptJpaEntity.kt	ApplicationInitialScriptJpaEntity JPA 엔티티 추가 (테이블 application_initial_script_entity, id, script, 다대일 application 관계)
저장소 src/main/kotlin/com/dcd/server/persistence/application/repository/ApplicationInitialScriptRepository.kt	Spring Data JPA 리포지토리 추가 (JpaRepository<ApplicationInitialScriptJpaEntity, UUID>), findAllByApplication, deleteAllByApplication 메서드 선언
영속성 어댑터 및 매퍼 src/main/kotlin/com/dcd/server/persistence/application/ApplicationInitialScriptPersistenceAdapter.kt, src/main/kotlin/com/dcd/server/persistence/application/adapter/ApplicationAdapter.kt	ApplicationInitialScriptPort 구현체(영속성 어댑터) 추가 및 도메인↔엔티티 변환 확장 함수(toEntity, toDomain) 추가; 저장/조회/삭제 매핑 구현
테스트 DB 스키마 src/test/resources/data.sql	application_initial_script_entity 테이블 추가(컬럼: id, script, application_id), 외래키 제약조건 추가

Sequence Diagram(s)

sequenceDiagram
    participant Client
    participant Adapter as PersistenceAdapter
    participant Repo as ApplicationInitialScriptRepository
    participant DB as Database

    Client->>Adapter: save(ApplicationInitialScript)
    Adapter->>Adapter: ApplicationInitialScript.toEntity()
    Adapter->>Repo: save(ApplicationInitialScriptJpaEntity)
    Repo->>DB: INSERT
    DB-->>Repo: OK
    Repo-->>Adapter: saved entity
    Adapter->>Client: saved domain

    Client->>Adapter: findAllByApplication(Application)
    Adapter->>Repo: findAllByApplication(ApplicationJpaEntity)
    Repo->>DB: SELECT
    DB-->>Repo: entities[]
    Adapter->>Adapter: toDomain() for each
    Adapter-->>Client: ApplicationInitialScript[]

    Client->>Adapter: deleteByApplication(Application)
    Adapter->>Repo: deleteAllByApplication(ApplicationJpaEntity)
    Repo->>DB: DELETE
    DB-->>Repo: OK
    Repo-->>Adapter: result
    Adapter-->>Client: ack

Loading

Estimated code review effort

🎯 4 (Complex) | ⏱️ ~40 분

주의 검토 대상:

• ApplicationInitialScriptPersistenceAdapter.kt의 null 안전성, 트랜잭션 경계 및 매퍼 호출 흐름
• ApplicationAdapter.kt의 도메인↔엔티티 매핑에서 순환 참조/무한 재귀 여부
• JPA 엔티티의 매핑(테이블명·컬럼 정의, fetch 전략)과 리포지토리 메서드 명명 규칙 일치 여부
• data.sql의 외래키 제약 및 테스트 데이터 초기화가 현재 스키마와 일치하는지

Poem

🐰 초기 글자, 흙에 뿌려요
포트로 길을 내고 엔티티로 뿌리 내려
어댑터가 물대면 데이터가 춤춰
작은 스크립트, 큰 정원 가꿔요 🌱✨

Pre-merge checks and finishing touches

✅ Passed checks (2 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	PR 제목은 이모지와 브랜치 접두사를 포함하고 있으며, 번역 문제로 인해 정확한 의미 파악이 어렵습니다. 다만 '#731'과 '초기화 스크립트 엔티티 추가'라는 부분에서 핵심 변경 사항인 ApplicationInitialScript 관련 엔티티 추가를 다루고 있음을 알 수 있습니다. 제목이 변경 사항의 주요 내용을 부분적으로 반영하고 있지만, 이모지와 브랜치 스타일 접두사는 팀 규칙을 따르는 것으로 보이며 구체적인 변경 내용을 명확히 전달하기에는 다소 제한적입니다.

✨ Finishing touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment
• Commit unit tests in branch feature/initial-script-entity

---

📜 Recent review details

Configuration used: CodeRabbit UI

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between cc2e43d and 19a9685.

📒 Files selected for processing (1)

• src/test/resources/data.sql (3 hunks)

🧰 Additional context used

🧠 Learnings (1)

📓 Common learnings

Learnt from: dolong2
Repo: dolong2/dcd PR: 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.

Learnt from: dolong2
Repo: dolong2/dcd PR: 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.

Learnt from: dolong2
Repo: dolong2/dcd PR: 655
File: src/main/kotlin/com/dcd/server/persistence/workspace/entity/WorkspaceJpaEntity.kt:12-14
Timestamp: 2025-07-12T14:05:23.333Z
Learning: dolong2는 JPA의 GeneratedValue(strategy = GenerationType.UUID) 대신 생성자에서 UUID.randomUUID()로 직접 초기화하는 방식을 선호한다. 더 간단하고 예측 가능한 동작을 위해서다.

Learnt from: dolong2
Repo: dolong2/dcd PR: 659
File: src/main/kotlin/com/dcd/server/core/domain/domain/usecase/ConnectDomainUseCase.kt:40-41
Timestamp: 2025-07-14T15:01:47.531Z
Learning: dolong2는 기능적으로 문제가 없는 코드 개선사항의 경우, 실제로 필요할 때까지 수정을 미루는 실용적인 접근법을 선호한다. 예를 들어 의미론적 정확성을 위한 변경은 해당 기능이 실제로 필요할 때 수정하는 방식을 택한다.

⏰ 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 (1)

src/test/resources/data.sql (1)

6-6: ✅ 이전 리뷰의 FK 컬럼 오타 문제 해결됨

이전 리뷰에서 지적한 appliccation_id 오타가 application_id로 정정되었습니다. 현재 코드는 다음이 모두 일치합니다:

• 테이블 생성 시 컬럼명: application_id (line 19)
• 외래 키 제약 조건에서 참조: application_id (line 40)

스키마 구조도 적절합니다. application_id에 not null 제약이 있어 모든 초기화 스크립트가 반드시 애플리케이션과 연결되도록 강제하고, 외래 키 제약에 ON DELETE CASCADE가 없어 비즈니스 로직에서 명시적 삭제 검증을 가능하게 합니다.

Also applies to: 19-19, 40-40

---

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

• X
• Mastodon
• Reddit
• LinkedIn

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

[coderabbitai]

Actionable comments posted: 1

📜 Review details

Configuration used: CodeRabbit UI

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between b322211 and cc2e43d.

📒 Files selected for processing (9)

• src/main/kotlin/com/dcd/server/core/domain/application/model/ApplicationInitialScript.kt (1 hunks)
• src/main/kotlin/com/dcd/server/core/domain/application/spi/ApplicationInitialScriptPort.kt (1 hunks)
• src/main/kotlin/com/dcd/server/core/domain/application/spi/CommandApplicationInitialScriptPort.kt (1 hunks)
• src/main/kotlin/com/dcd/server/core/domain/application/spi/QueryApplicationInitialScriptPort.kt (1 hunks)
• src/main/kotlin/com/dcd/server/persistence/application/ApplicationInitialScriptPersistenceAdapter.kt (1 hunks)
• src/main/kotlin/com/dcd/server/persistence/application/adapter/ApplicationAdapter.kt (2 hunks)
• src/main/kotlin/com/dcd/server/persistence/application/entity/ApplicationInitialScriptJpaEntity.kt (1 hunks)
• src/main/kotlin/com/dcd/server/persistence/application/repository/ApplicationInitialScriptRepository.kt (1 hunks)
• src/test/resources/data.sql (3 hunks)

🧰 Additional context used

🧠 Learnings (1)

📓 Common learnings

Learnt from: dolong2
Repo: dolong2/dcd PR: 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.

Learnt from: dolong2
Repo: dolong2/dcd PR: 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.

Learnt from: dolong2
Repo: dolong2/dcd PR: 655
File: src/main/kotlin/com/dcd/server/persistence/workspace/entity/WorkspaceJpaEntity.kt:12-14
Timestamp: 2025-07-12T14:05:23.333Z
Learning: dolong2는 JPA의 GeneratedValue(strategy = GenerationType.UUID) 대신 생성자에서 UUID.randomUUID()로 직접 초기화하는 방식을 선호한다. 더 간단하고 예측 가능한 동작을 위해서다.

Learnt from: dolong2
Repo: dolong2/dcd PR: 659
File: src/main/kotlin/com/dcd/server/core/domain/domain/usecase/ConnectDomainUseCase.kt:40-41
Timestamp: 2025-07-14T15:01:47.531Z
Learning: dolong2는 기능적으로 문제가 없는 코드 개선사항의 경우, 실제로 필요할 때까지 수정을 미루는 실용적인 접근법을 선호한다. 예를 들어 의미론적 정확성을 위한 변경은 해당 기능이 실제로 필요할 때 수정하는 방식을 택한다.

🪛 detekt (1.23.8)

src/main/kotlin/com/dcd/server/core/domain/application/spi/ApplicationInitialScriptPort.kt

[warning] 3-4: The class or object ApplicationInitialScriptPort is empty.

(detekt.empty-blocks.EmptyClassBlock)

src/main/kotlin/com/dcd/server/core/domain/application/model/ApplicationInitialScript.kt

[warning] 9-10: The class or object ApplicationInitialScript is empty.

(detekt.empty-blocks.EmptyClassBlock)

src/main/kotlin/com/dcd/server/persistence/application/entity/ApplicationInitialScriptJpaEntity.kt

[warning] 22-23: The class or object ApplicationInitialScriptJpaEntity is empty.

(detekt.empty-blocks.EmptyClassBlock)

⏰ 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 (4)

src/main/kotlin/com/dcd/server/core/domain/application/spi/QueryApplicationInitialScriptPort.kt (1)

7-10: LGTM!

쿼리 포트 인터페이스가 깔끔하게 정의되어 있습니다. nullable 반환 타입과 리스트 반환이 적절하게 사용되었습니다.

src/main/kotlin/com/dcd/server/persistence/application/repository/ApplicationInitialScriptRepository.kt (1)

10-10: 트랜잭션 컨텍스트 확인 권장

deleteAllByApplication는 Spring Data JPA의 derived delete 쿼리입니다. 이 메서드를 호출하는 곳에서 @Transactional 컨텍스트 내에서 실행되는지 확인하세요. 또한, 학습된 선호사항에 따르면 삭제 전 비즈니스 로직에서 명시적인 유효성 검증을 수행하는 것이 좋습니다.

Based on learnings

src/main/kotlin/com/dcd/server/core/domain/application/spi/CommandApplicationInitialScriptPort.kt (1)

6-12: LGTM!

커맨드 포트 인터페이스가 명확하게 정의되어 있습니다. CRUD 작업과 애플리케이션 기반 삭제 작업이 적절하게 포함되어 있습니다.

src/main/kotlin/com/dcd/server/persistence/application/adapter/ApplicationAdapter.kt (1)

43-55: 현재 코드는 순환 참조 위험이 없습니다

검증 결과, Application 도메인 모델과 ApplicationJpaEntity 모두 ApplicationInitialScript 컬렉션 필드를 포함하지 않습니다. ApplicationInitialScript는 Application을 참조하지만 Application은 역참조를 하지 않으므로 무한 재귀 위험이 없습니다. ApplicationInitialScript 목록은 별도의 포트(QueryApplicationInitialScriptPort)를 통해 관리됩니다.