feat: [ALT-258] 업장 대표이미지 관리 기능 추가 (최대 5개)

src/main/java/com/dreamteam/alter/adapter/inbound/common/dto/WorkspaceImageRequestDto.java

@@ -0,0 +1,43 @@
+package com.dreamteam.alter.adapter.inbound.common.dto;
+
+import java.util.Collection;
+import java.util.Comparator;
+import java.util.List;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotBlank;
+import lombok.AllArgsConstructor;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+
+@Data
+@NoArgsConstructor
+@AllArgsConstructor
+@EqualsAndHashCode(of = "fileId")
+@Schema(description = "업장 대표이미지 요청 항목 DTO")
+public class WorkspaceImageRequestDto {
+
+    @NotBlank
+    @Schema(description = "대표이미지 파일 ID", example = "01959b4e-4e5f-7c3a-8d9e-0f1a2b3c4d5e")
+    private String fileId;
+
+    @Schema(description = "노출 순서 (작을수록 먼저, 미지정 시 마지막)", example = "0")
+    private Integer sortOrder;
+
+    /**
+     * sortOrder 오름차순(미지정은 후순위)으로 정렬한 파일 ID 목록을 반환한다.
+     * fileId 기준 equals/hashCode 로 Set 단계에서 이미 중복이 제거된다.
+     */
+    public static List<String> toOrderedFileIds(Collection<WorkspaceImageRequestDto> images) {
+        if (images == null || images.isEmpty()) {
+            return List.of();
+        }
+        return images.stream()
+            .sorted(Comparator
+                .comparing(WorkspaceImageRequestDto::getSortOrder, Comparator.nullsLast(Comparator.naturalOrder()))
+                .thenComparing(WorkspaceImageRequestDto::getFileId))
+            .map(WorkspaceImageRequestDto::getFileId)
+            .toList();
+    }
+}

src/main/java/com/dreamteam/alter/adapter/inbound/general/workspace/dto/CreateWorkspaceRequestDto.java

@@ -1,10 +1,16 @@
 package com.dreamteam.alter.adapter.inbound.general.workspace.dto;
 
 import java.math.BigDecimal;
+import java.util.List;
+import java.util.Set;
+
+import com.dreamteam.alter.adapter.inbound.common.dto.WorkspaceImageRequestDto;
 
 import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.Valid;
 import jakarta.validation.constraints.NotBlank;
 import jakarta.validation.constraints.NotNull;
+import jakarta.validation.constraints.Size;
 import lombok.AllArgsConstructor;
 import lombok.Data;
 import lombok.NoArgsConstructor;
@@ -65,4 +71,12 @@ public class CreateWorkspaceRequestDto {
 
 	@Schema(description = "위임 확인서 파일 ID", example = "01959b4e-4e5f-7c3a-8d9e-0f1a2b3c4d5e")
 	private String workspaceWarrantFileId;
+
+	@Size(max = 5, message = "대표이미지는 최대 5개까지 등록할 수 있습니다.")
+	@Schema(description = "업장 대표이미지 목록 (최대 5개, fileId 중복 자동 제거, sortOrder 오름차순으로 노출)")
+	private Set<@Valid WorkspaceImageRequestDto> representativeImages;
+
+	public List<String> getOrderedRepresentativeImageFileIds() {
+		return WorkspaceImageRequestDto.toOrderedFileIds(representativeImages);
+	}
 }

src/main/java/com/dreamteam/alter/adapter/inbound/manager/workspace/controller/ManagerWorkspaceImageController.java

@@ -0,0 +1,60 @@
+package com.dreamteam.alter.adapter.inbound.manager.workspace.controller;
+
+import java.util.List;
+
+import org.springframework.http.ResponseEntity;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PathVariable;
+import org.springframework.web.bind.annotation.PutMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RestController;
+
+import com.dreamteam.alter.adapter.inbound.common.dto.CommonApiResponse;
+import com.dreamteam.alter.adapter.inbound.manager.workspace.dto.UpdateWorkspaceImagesRequestDto;
+import com.dreamteam.alter.adapter.inbound.manager.workspace.dto.WorkspaceImageResponseDto;
+import com.dreamteam.alter.application.aop.ManagerActionContext;
+import com.dreamteam.alter.domain.user.context.ManagerActor;
+import com.dreamteam.alter.domain.workspace.port.inbound.ManagerGetWorkspaceImagesUseCase;
+import com.dreamteam.alter.domain.workspace.port.inbound.ManagerUpdateWorkspaceImagesUseCase;
+
+import jakarta.annotation.Resource;
+import jakarta.validation.Valid;
+import lombok.RequiredArgsConstructor;
+
+@RestController
+@RequestMapping("/manager/workspaces")
+@PreAuthorize("hasAnyRole('MANAGER')")
+@RequiredArgsConstructor
+@Validated
+public class ManagerWorkspaceImageController implements ManagerWorkspaceImageControllerSpec {
+
+    @Resource(name = "managerGetWorkspaceImages")
+    private final ManagerGetWorkspaceImagesUseCase managerGetWorkspaceImages;
+
+    @Resource(name = "managerUpdateWorkspaceImages")
+    private final ManagerUpdateWorkspaceImagesUseCase managerUpdateWorkspaceImages;
+
+    @Override
+    @GetMapping("/{workspaceId}/images")
+    public ResponseEntity<CommonApiResponse<List<WorkspaceImageResponseDto>>> getWorkspaceImages(
+        @PathVariable Long workspaceId
+    ) {
+        ManagerActor actor = ManagerActionContext.getInstance().getActor();
+
+        return ResponseEntity.ok(CommonApiResponse.of(managerGetWorkspaceImages.execute(actor, workspaceId)));
+    }
+
+    @Override
+    @PutMapping("/{workspaceId}/images")
+    public ResponseEntity<CommonApiResponse<Void>> updateWorkspaceImages(
+        @PathVariable Long workspaceId,
+        @RequestBody @Valid UpdateWorkspaceImagesRequestDto request
+    ) {
+        ManagerActor actor = ManagerActionContext.getInstance().getActor();
+        managerUpdateWorkspaceImages.execute(actor, workspaceId, request);
+        return ResponseEntity.ok(CommonApiResponse.empty());
+    }
+}

src/main/java/com/dreamteam/alter/adapter/inbound/manager/workspace/controller/ManagerWorkspaceImageControllerSpec.java

@@ -0,0 +1,84 @@
+package com.dreamteam.alter.adapter.inbound.manager.workspace.controller;
+
+import java.util.List;
+
+import org.springframework.http.ResponseEntity;
+import org.springframework.web.bind.annotation.PathVariable;
+import org.springframework.web.bind.annotation.RequestBody;
+
+import com.dreamteam.alter.adapter.inbound.common.dto.CommonApiResponse;
+import com.dreamteam.alter.adapter.inbound.common.dto.ErrorResponse;
+import com.dreamteam.alter.adapter.inbound.manager.workspace.dto.UpdateWorkspaceImagesRequestDto;
+import com.dreamteam.alter.adapter.inbound.manager.workspace.dto.WorkspaceImageResponseDto;
+
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.media.Content;
+import io.swagger.v3.oas.annotations.media.ExampleObject;
+import io.swagger.v3.oas.annotations.media.Schema;
+import io.swagger.v3.oas.annotations.responses.ApiResponse;
+import io.swagger.v3.oas.annotations.responses.ApiResponses;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.validation.Valid;
+
+@Tag(name = "MANAGER - 업장 대표이미지 API")
+public interface ManagerWorkspaceImageControllerSpec {
+
+    @Operation(summary = "매니저 - 업장 대표이미지 목록 조회", description = "노출 순서(sortOrder) 오름차순으로 조회합니다.")
+    @ApiResponses(value = {
+        @ApiResponse(responseCode = "200", description = "대표이미지 목록 조회 성공"),
+        @ApiResponse(responseCode = "400", description = "존재하지 않는 업장",
+            content = @Content(
+                mediaType = "application/json",
+                schema = @Schema(implementation = ErrorResponse.class),
+                examples = {
+                    @ExampleObject(
+                        name = "존재하지 않는 업장입니다.",
+                        value = "{\"code\" : \"B008\"}"
+                    ),
+                })),
+    })
+    ResponseEntity<CommonApiResponse<List<WorkspaceImageResponseDto>>> getWorkspaceImages(
+        @PathVariable Long workspaceId
+    );
+
+    @Operation(summary = "매니저 - 업장 대표이미지 수정 (전체 교체)", description = "전달한 대표이미지 목록으로 전체 교체합니다. sortOrder 오름차순이 노출 순서이며(미지정 시 후순위), 추가/삭제/순서변경을 한 번에 처리합니다. 최대 5개.")
+    @ApiResponses(value = {
+        @ApiResponse(responseCode = "200", description = "대표이미지 수정 성공"),
+        @ApiResponse(responseCode = "400", description = "400 Error 실패 케이스",
+            content = @Content(
+                mediaType = "application/json",
+                schema = @Schema(implementation = ErrorResponse.class),
+                examples = {
+                    @ExampleObject(
+                        name = "존재하지 않는 업장입니다.",
+                        value = "{\"code\" : \"B008\"}"
+                    ),
+                    @ExampleObject(
+                        name = "대표이미지는 최대 5개까지 등록할 수 있습니다.",
+                        value = "{\"code\" : \"B001\"}"
+                    ),
+                    @ExampleObject(
+                        name = "존재하지 않는 파일입니다.",
+                        value = "{\"code\" : \"B021\"}"
+                    ),
+                    @ExampleObject(
+                        name = "유효하지 않은 파일입니다.",
+                        value = "{\"code\" : \"B022\"}"
+                    ),
+                })),
+        @ApiResponse(responseCode = "409", description = "이미 연결된 파일",
+            content = @Content(
+                mediaType = "application/json",
+                schema = @Schema(implementation = ErrorResponse.class),
+                examples = {
+                    @ExampleObject(
+                        name = "이미 연결된 파일입니다.",
+                        value = "{\"code\" : \"B025\"}"
+                    ),
+                })),
+    })
+    ResponseEntity<CommonApiResponse<Void>> updateWorkspaceImages(
+        @PathVariable Long workspaceId,
+        @RequestBody @Valid UpdateWorkspaceImagesRequestDto request
+    );
+}

src/main/java/com/dreamteam/alter/adapter/inbound/manager/workspace/dto/ManagerWorkspaceResponseDto.java

@@ -11,6 +11,7 @@
 
 import java.math.BigDecimal;
 import java.time.LocalDateTime;
+import java.util.List;
 
 @Getter
 @NoArgsConstructor(access = AccessLevel.PRIVATE)
@@ -69,7 +70,13 @@ public class ManagerWorkspaceResponseDto {
     @Schema(description = "업장 평판 요약 정보")
     private SelfReputationSummaryDto reputationSummary;
 
-    public static ManagerWorkspaceResponseDto of(ManagerWorkspaceResponse entity) {
+    @Schema(description = "업장 대표이미지 목록 (노출 순서 오름차순, 최대 5개)")
+    private List<WorkspaceImageResponseDto> representativeImages;
+
+    public static ManagerWorkspaceResponseDto of(
+        ManagerWorkspaceResponse entity,
+        List<WorkspaceImageResponseDto> representativeImages
+    ) {
         return ManagerWorkspaceResponseDto.builder()
             .id(entity.getId())
             .businessRegistrationNo(entity.getBusinessRegistrationNo())
@@ -84,6 +91,7 @@ public static ManagerWorkspaceResponseDto of(ManagerWorkspaceResponse entity) {
             .nextMonthShiftGenDay(entity.getNextMonthShiftGenDay())
             .createdAt(entity.getCreatedAt())
             .reputationSummary(SelfReputationSummaryDto.from(entity.getReputationSummary()))
+            .representativeImages(representativeImages)
             .build();
     }
 

src/main/java/com/dreamteam/alter/adapter/inbound/manager/workspace/dto/UpdateWorkspaceImagesRequestDto.java

@@ -0,0 +1,30 @@
+package com.dreamteam.alter.adapter.inbound.manager.workspace.dto;
+
+import java.util.List;
+import java.util.Set;
+
+import com.dreamteam.alter.adapter.inbound.common.dto.WorkspaceImageRequestDto;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.Valid;
+import jakarta.validation.constraints.NotNull;
+import jakarta.validation.constraints.Size;
+import lombok.AllArgsConstructor;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+@Data
+@NoArgsConstructor
+@AllArgsConstructor
+@Schema(description = "업장 대표이미지 수정 요청 DTO (전체 교체)")
+public class UpdateWorkspaceImagesRequestDto {
+
+    @NotNull
+    @Size(max = 5, message = "대표이미지는 최대 5개까지 등록할 수 있습니다.")
+    @Schema(description = "대표이미지 목록 (fileId 중복 자동 제거, sortOrder 오름차순으로 노출, 비우면 전체 삭제)")
+    private Set<@Valid WorkspaceImageRequestDto> images;
+
+    public List<String> getOrderedImageFileIds() {
+        return WorkspaceImageRequestDto.toOrderedFileIds(images);
+    }
+}

src/main/java/com/dreamteam/alter/adapter/inbound/manager/workspace/dto/WorkspaceImageResponseDto.java

@@ -0,0 +1,33 @@
+package com.dreamteam.alter.adapter.inbound.manager.workspace.dto;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.AccessLevel;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Getter;
+import lombok.NoArgsConstructor;
+
+@Getter
+@NoArgsConstructor(access = AccessLevel.PRIVATE)
+@AllArgsConstructor(access = AccessLevel.PRIVATE)
+@Builder(access = AccessLevel.PRIVATE)
+@Schema(description = "업장 대표이미지 응답 DTO")
+public class WorkspaceImageResponseDto {
+
+    @Schema(description = "파일 ID", example = "01959b4e-4e5f-7c3a-8d9e-0f1a2b3c4d5e")
+    private String fileId;
+
+    @Schema(description = "이미지 URL", example = "https://cdn.example.com/workspace_representative_image/abc.jpg")
+    private String url;
+
+    @Schema(description = "노출 순서 (0부터 시작)", example = "0")
+    private int sortOrder;
+
+    public static WorkspaceImageResponseDto of(String fileId, String url, int sortOrder) {
+        return WorkspaceImageResponseDto.builder()
+            .fileId(fileId)
+            .url(url)
+            .sortOrder(sortOrder)
+            .build();
+    }
+}

src/main/java/com/dreamteam/alter/adapter/outbound/workspace/persistence/WorkspaceImageJpaRepository.java

@@ -0,0 +1,11 @@
+package com.dreamteam.alter.adapter.outbound.workspace.persistence;
+
+import java.util.List;
+
+import org.springframework.data.jpa.repository.JpaRepository;
+
+import com.dreamteam.alter.domain.workspace.entity.WorkspaceImage;
+
+public interface WorkspaceImageJpaRepository extends JpaRepository<WorkspaceImage, Long> {
+    List<WorkspaceImage> findByWorkspaceIdOrderBySortOrderAsc(Long workspaceId);
+}

src/main/java/com/dreamteam/alter/adapter/outbound/workspace/persistence/WorkspaceImageQueryRepositoryImpl.java

@@ -0,0 +1,22 @@
+package com.dreamteam.alter.adapter.outbound.workspace.persistence;
+
+import java.util.List;
+
+import org.springframework.stereotype.Repository;
+
+import com.dreamteam.alter.domain.workspace.entity.WorkspaceImage;
+import com.dreamteam.alter.domain.workspace.port.outbound.WorkspaceImageQueryRepository;
+
+import lombok.RequiredArgsConstructor;
+
+@Repository
+@RequiredArgsConstructor
+public class WorkspaceImageQueryRepositoryImpl implements WorkspaceImageQueryRepository {
+
+    private final WorkspaceImageJpaRepository workspaceImageJpaRepository;
+
+    @Override
+    public List<WorkspaceImage> findAllByWorkspaceId(Long workspaceId) {
+        return workspaceImageJpaRepository.findByWorkspaceIdOrderBySortOrderAsc(workspaceId);
+    }
+}

src/main/java/com/dreamteam/alter/adapter/outbound/workspace/persistence/WorkspaceImageRepositoryImpl.java

@@ -0,0 +1,27 @@
+package com.dreamteam.alter.adapter.outbound.workspace.persistence;
+
+import java.util.List;
+
+import org.springframework.stereotype.Repository;
+
+import com.dreamteam.alter.domain.workspace.entity.WorkspaceImage;
+import com.dreamteam.alter.domain.workspace.port.outbound.WorkspaceImageRepository;
+
+import lombok.RequiredArgsConstructor;
+
+@Repository
+@RequiredArgsConstructor
+public class WorkspaceImageRepositoryImpl implements WorkspaceImageRepository {
+
+    private final WorkspaceImageJpaRepository workspaceImageJpaRepository;
+
+    @Override
+    public void saveAll(List<WorkspaceImage> workspaceImages) {
+        workspaceImageJpaRepository.saveAll(workspaceImages);
+    }
+
+    @Override
+    public void deleteAll(List<WorkspaceImage> workspaceImages) {
+        workspaceImageJpaRepository.deleteAll(workspaceImages);
+    }
+}

src/main/java/com/dreamteam/alter/adapter/outbound/workspace/persistence/WorkspaceRequestImageJpaRepository.java

@@ -0,0 +1,11 @@
+package com.dreamteam.alter.adapter.outbound.workspace.persistence;
+
+import java.util.List;
+
+import org.springframework.data.jpa.repository.JpaRepository;
+
+import com.dreamteam.alter.domain.workspace.entity.WorkspaceRequestImage;
+
+public interface WorkspaceRequestImageJpaRepository extends JpaRepository<WorkspaceRequestImage, Long> {
+    List<WorkspaceRequestImage> findByWorkspaceRequestIdOrderBySortOrderAsc(Long workspaceRequestId);
+}