[FEAT] 작가가 program을 만드는 api 개발 (#281)

reservation/build.gradle

@@ -65,6 +65,12 @@ dependencies {
     // === Kafka 의존성 ===
     implementation 'org.springframework.kafka:spring-kafka'
     testImplementation 'org.springframework.kafka:spring-kafka-test'
+
+    // === Spring Validation 의존성 ===
+    implementation 'org.springframework.boot:spring-boot-starter-validation'
+
+    // === ArchUnit 아키텍처 테스트 의존성 ===
+    testImplementation 'com.tngtech.archunit:archunit-junit5:1.4.1'
 }
 
 tasks.named('test') {

reservation/src/main/java/net/catsnap/CatsnapReservation/program/application/ProgramService.java

@@ -0,0 +1,47 @@
+package net.catsnap.CatsnapReservation.program.application;
+
+import net.catsnap.CatsnapReservation.program.domain.Program;
+import net.catsnap.CatsnapReservation.program.application.dto.request.ProgramCreateRequest;
+import net.catsnap.CatsnapReservation.program.application.dto.response.ProgramResponse;
+import net.catsnap.CatsnapReservation.program.infrastructure.repository.ProgramRepository;
+import org.springframework.stereotype.Service;
+import org.springframework.transaction.annotation.Transactional;
+
+/**
+ * Program 애그리거트의 Application Service
+ *
+ * <p>도메인 계층의 객체들을 오케스트레이션하여 비즈니스 유스케이스를 구현합니다.
+ */
+@Service
+public class ProgramService {
+
+    private final ProgramRepository programRepository;
+
+    public ProgramService(ProgramRepository programRepository) {
+        this.programRepository = programRepository;
+    }
+
+    /**
+     * 프로그램 생성 유스케이스
+     * <p>
+     * 원시 타입을 도메인 엔티티에 전달하고, 도메인 엔티티가 VO 생성 및 검증을 담당합니다.
+     *
+     * @param photographerId 작가 ID
+     * @param request        프로그램 생성 요청 정보
+     * @return 생성된 프로그램 응답
+     */
+    @Transactional
+    public ProgramResponse createProgram(Long photographerId, ProgramCreateRequest request) {
+        Program program = Program.create(
+            photographerId,
+            request.title(),
+            request.description(),
+            request.price(),
+            request.durationMinutes()
+        );
+
+        Program savedProgram = programRepository.save(program);
+
+        return new ProgramResponse(savedProgram.getId());
+    }
+}

reservation/src/main/java/net/catsnap/CatsnapReservation/program/application/dto/request/ProgramCreateRequest.java

@@ -0,0 +1,25 @@
+package net.catsnap.CatsnapReservation.program.application.dto.request;
+
+import jakarta.validation.constraints.Min;
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.NotNull;
+
+/**
+ * 프로그램 생성 요청 DTO
+ */
+public record ProgramCreateRequest(
+    @NotBlank(message = "프로그램 제목은 필수입니다")
+    String title,
+
+    String description,
+
+    @NotNull(message = "가격은 필수입니다")
+    @Min(value = 0, message = "가격은 0원 이상이어야 합니다")
+    Long price,
+
+    @NotNull(message = "소요 시간은 필수입니다")
+    @Min(value = 1, message = "소요 시간은 1분 이상이어야 합니다")
+    Integer durationMinutes
+) {
+
+}

reservation/src/main/java/net/catsnap/CatsnapReservation/program/application/dto/response/ProgramResponse.java

@@ -0,0 +1,9 @@
+package net.catsnap.CatsnapReservation.program.application.dto.response;
+
+/**
+ * 프로그램 생성 응답 DTO
+ */
+public record ProgramResponse(
+    Long id
+) {
+}

reservation/src/main/java/net/catsnap/CatsnapReservation/program/domain/Program.java

@@ -0,0 +1,186 @@
+package net.catsnap.CatsnapReservation.program.domain;
+
+import jakarta.persistence.Column;
+import jakarta.persistence.Convert;
+import jakarta.persistence.Entity;
+import jakarta.persistence.EntityListeners;
+import jakarta.persistence.GeneratedValue;
+import jakarta.persistence.GenerationType;
+import jakarta.persistence.Id;
+import java.time.LocalDateTime;
+import java.util.Objects;
+import lombok.AccessLevel;
+import lombok.Getter;
+import lombok.NoArgsConstructor;
+import net.catsnap.CatsnapReservation.program.domain.vo.Description;
+import net.catsnap.CatsnapReservation.program.domain.vo.Duration;
+import net.catsnap.CatsnapReservation.program.domain.vo.Price;
+import net.catsnap.CatsnapReservation.program.domain.vo.Title;
+import net.catsnap.CatsnapReservation.program.infrastructure.converter.DescriptionConverter;
+import net.catsnap.CatsnapReservation.program.infrastructure.converter.DurationConverter;
+import net.catsnap.CatsnapReservation.program.infrastructure.converter.PriceConverter;
+import net.catsnap.CatsnapReservation.program.infrastructure.converter.TitleConverter;
+import org.springframework.data.annotation.CreatedDate;
+import org.springframework.data.annotation.LastModifiedDate;
+import org.springframework.data.jpa.domain.support.AuditingEntityListener;
+
+/**
+ * 작가 프로그램 엔티티 (Aggregate Root)
+ * <p>
+ * 작가가 제공하는 촬영 프로그램을 표현하는 도메인 엔티티입니다.
+ * 프로그램 제목, 설명, 가격, 소요 시간 정보를 관리합니다.
+ */
+@Entity
+@Getter
+@NoArgsConstructor(access = AccessLevel.PROTECTED)
+@EntityListeners(AuditingEntityListener.class)
+public class Program {
+
+    @Id
+    @GeneratedValue(strategy = GenerationType.IDENTITY)
+    private Long id;
+
+    @Column(nullable = false)
+    private Long photographerId;
+
+    @Column(nullable = false, length = 100)
+    @Convert(converter = TitleConverter.class)
+    private Title title;
+
+    @Column(length = 500)
+    @Convert(converter = DescriptionConverter.class)
+    private Description description;
+
+    @Column(nullable = false)
+    @Convert(converter = PriceConverter.class)
+    private Price price;
+
+    @Column(nullable = false)
+    @Convert(converter = DurationConverter.class)
+    private Duration duration;
+
+    private LocalDateTime deletedAt;
+
+    @CreatedDate
+    @Column(nullable = false, updatable = false)
+    private LocalDateTime createdAt;
+
+    @LastModifiedDate
+    @Column(nullable = false)
+    private LocalDateTime updatedAt;
+
+    private Program(
+        Long photographerId,
+        Title title,
+        Description description,
+        Price price,
+        Duration duration
+    ) {
+        validatePhotographerId(photographerId);
+        this.photographerId = photographerId;
+        this.title = title;
+        this.description = description;
+        this.price = price;
+        this.duration = duration;
+    }
+
+    /**
+     * 새로운 프로그램 생성
+     * <p>
+     * 원시 타입을 받아 내부에서 VO를 생성하고 검증합니다.
+     * 도메인 엔티티가 자신의 불변식(invariant)을 보장합니다.
+     *
+     * @param photographerId   작가 ID
+     * @param titleValue       프로그램 제목
+     * @param descriptionValue 프로그램 설명 (nullable)
+     * @param priceValue       가격
+     * @param durationMinutes  소요 시간 (분)
+     * @return 생성된 Program
+     */
+    public static Program create(
+        Long photographerId,
+        String titleValue,
+        String descriptionValue,
+        Long priceValue,
+        Integer durationMinutes
+    ) {
+        Title title = new Title(titleValue);
+        Description description = new Description(descriptionValue);
+        Price price = new Price(priceValue);
+        Duration duration = new Duration(durationMinutes);
+
+        return new Program(photographerId, title, description, price, duration);
+    }
+
+    /**
+     * 프로그램 정보 수정
+     * <p>
+     * 원시 타입을 받아 내부에서 VO를 생성하고 검증합니다.
+     *
+     * @param titleValue       프로그램 제목
+     * @param descriptionValue 프로그램 설명 (nullable)
+     * @param priceValue       가격
+     * @param durationMinutes  소요 시간 (분)
+     */
+    public void update(
+        String titleValue,
+        String descriptionValue,
+        Long priceValue,
+        Integer durationMinutes
+    ) {
+        this.title = new Title(titleValue);
+        this.description = new Description(descriptionValue);
+        this.price = new Price(priceValue);
+        this.duration = new Duration(durationMinutes);
+    }
+
+    /**
+     * 프로그램 소프트 삭제
+     */
+    public void delete() {
+        this.deletedAt = LocalDateTime.now();
+    }
+
+    /**
+     * 삭제 여부 확인
+     */
+    public boolean isDeleted() {
+        return deletedAt != null;
+    }
+
+    /**
+     * 작가 소유권 확인
+     */
+    public boolean isOwnedBy(Long photographerId) {
+        return this.photographerId.equals(photographerId);
+    }
+
+    private void validatePhotographerId(Long photographerId) {
+        if (photographerId == null) {
+            throw new IllegalArgumentException("작가 ID는 필수입니다.");
+        }
+    }
+
+    @Override
+    public boolean equals(Object o) {
+        if (this == o) {
+            return true;
+        }
+        if (o == null || getClass() != o.getClass()) {
+            return false;
+        }
+        Program program = (Program) o;
+        return Objects.equals(id, program.id);
+    }
+
+    @Override
+    public int hashCode() {
+        return Objects.hash(id);
+    }
+
+    @Override
+    public String toString() {
+        return String.format("Program{id=%d, photographerId=%d, title=%s}",
+            id, photographerId, title);
+    }
+}

reservation/src/main/java/net/catsnap/CatsnapReservation/program/domain/vo/Description.java

@@ -0,0 +1,59 @@
+package net.catsnap.CatsnapReservation.program.domain.vo;
+
+import java.util.Objects;
+import lombok.Getter;
+import net.catsnap.CatsnapReservation.shared.domain.error.DomainErrorCode;
+import net.catsnap.CatsnapReservation.shared.domain.error.DomainException;
+
+/**
+ * 프로그램 설명 값 객체 (Value Object)
+ *
+ * <p>프로그램의 간단 설명을 표현하는 불변 객체입니다.
+ * null을 허용하며, 값이 있는 경우 최대 500자까지 허용합니다.
+ */
+@Getter
+public class Description {
+
+    private static final int MAX_LENGTH = 500;
+
+    private final String value;
+
+    public Description(String value) {
+        validate(value);
+        this.value = value;
+    }
+
+    private void validate(String value) {
+        if (value != null && value.length() > MAX_LENGTH) {
+            String message = String.format("프로그램 설명은 %d자 이하여야 합니다. 현재: %d자",
+                MAX_LENGTH, value.length());
+            throw new DomainException(DomainErrorCode.DOMAIN_CONSTRAINT_VIOLATION, message);
+        }
+    }
+
+    public boolean isEmpty() {
+        return value == null || value.isBlank();
+    }
+
+    @Override
+    public boolean equals(Object o) {
+        if (this == o) {
+            return true;
+        }
+        if (o == null || getClass() != o.getClass()) {
+            return false;
+        }
+        Description that = (Description) o;
+        return Objects.equals(value, that.value);
+    }
+
+    @Override
+    public int hashCode() {
+        return Objects.hash(value);
+    }
+
+    @Override
+    public String toString() {
+        return value == null ? "" : value;
+    }
+}