Feat/#23 학생회 공지 게시글 생성/조회/수정/삭제 기능 및 72시간 이내 행사 조회 기능 구현

src/main/java/com/campus/campus/domain/councilNotice/application/dto/request/NoticeRequestDto.java

@@ -0,0 +1,10 @@
+package com.campus.campus.domain.councilNotice.application.dto.request;
+
+import java.util.List;
+
+public record NoticeRequestDto(
+	String title,
+	String content,
+	List<String> imageUrls
+) {
+}

src/main/java/com/campus/campus/domain/councilNotice/application/dto/response/NoticeListItemResponseDto.java

@@ -0,0 +1,15 @@
+package com.campus.campus.domain.councilNotice.application.dto.response;
+
+import java.time.LocalDateTime;
+
+import lombok.Builder;
+
+@Builder
+public record NoticeListItemResponseDto(
+	Long id,
+	String title,
+	boolean isWriter,
+	LocalDateTime createdAt,
+	LocalDateTime updatedAt
+) {
+}

src/main/java/com/campus/campus/domain/councilNotice/application/dto/response/NoticeResponseDto.java

@@ -0,0 +1,20 @@
+package com.campus.campus.domain.councilNotice.application.dto.response;
+
+import java.time.LocalDateTime;
+import java.util.List;
+
+import lombok.Builder;
+
+@Builder
+public record NoticeResponseDto(
+	Long id,
+	Long writerId,
+	String writerName,
+	boolean isWriter,
+	String title,
+	String content,
+	List<String> images,
+	LocalDateTime createdAt,
+	LocalDateTime updatedAt
+) {
+}

src/main/java/com/campus/campus/domain/councilNotice/application/exception/ErrorCode.java

@@ -0,0 +1,21 @@
+package com.campus.campus.domain.councilNotice.application.exception;
+
+import org.springframework.http.HttpStatus;
+
+import com.campus.campus.global.common.exception.ErrorCodeInterface;
+
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+@Getter
+@AllArgsConstructor
+public enum ErrorCode implements ErrorCodeInterface {
+
+	NOTICE_NOT_FOUND(2501, HttpStatus.NOT_FOUND, "공지를 찾을 수 없습니다."),
+	NOT_NOTICE_WRITER(2502, HttpStatus.FORBIDDEN, "작성자만 해당 공지를 수정하거나 삭제할 수 있습니다."),
+	NOTICE_IMAGE_LIMIT_EXCEEDED(2503, HttpStatus.BAD_REQUEST, "공지 이미지는 최대 10개까지 등록할 수 있습니다.");
+
+	private final int code;
+	private final HttpStatus status;
+	private final String message;
+}

src/main/java/com/campus/campus/domain/councilNotice/application/exception/NotNoticeWriterException.java

@@ -0,0 +1,9 @@
+package com.campus.campus.domain.councilNotice.application.exception;
+
+import com.campus.campus.global.common.exception.ApplicationException;
+
+public class NotNoticeWriterException extends ApplicationException {
+	public NotNoticeWriterException() {
+		super(ErrorCode.NOT_NOTICE_WRITER);
+	}
+}

src/main/java/com/campus/campus/domain/councilNotice/application/exception/NoticeImageLimitExceededException.java

@@ -0,0 +1,9 @@
+package com.campus.campus.domain.councilNotice.application.exception;
+
+import com.campus.campus.global.common.exception.ApplicationException;
+
+public class NoticeImageLimitExceededException extends ApplicationException {
+	public NoticeImageLimitExceededException() {
+		super(ErrorCode.NOTICE_IMAGE_LIMIT_EXCEEDED);
+	}
+}

src/main/java/com/campus/campus/domain/councilNotice/application/exception/NoticeNotFoundException.java

@@ -0,0 +1,9 @@
+package com.campus.campus.domain.councilNotice.application.exception;
+
+import com.campus.campus.global.common.exception.ApplicationException;
+
+public class NoticeNotFoundException extends ApplicationException {
+	public NoticeNotFoundException() {
+		super(ErrorCode.NOTICE_NOT_FOUND);
+	}
+}

src/main/java/com/campus/campus/domain/councilNotice/application/mapper/StudentCouncilNoticeMapper.java

@@ -0,0 +1,52 @@
+package com.campus.campus.domain.councilNotice.application.mapper;
+
+import java.util.List;
+
+import com.campus.campus.domain.council.domain.entity.StudentCouncil;
+import com.campus.campus.domain.councilNotice.application.dto.request.NoticeRequestDto;
+import com.campus.campus.domain.councilNotice.application.dto.response.NoticeListItemResponseDto;
+import com.campus.campus.domain.councilNotice.application.dto.response.NoticeResponseDto;
+import com.campus.campus.domain.councilNotice.domain.entity.NoticeImage;
+import com.campus.campus.domain.councilNotice.domain.entity.StudentCouncilNotice;
+
+public class StudentCouncilNoticeMapper {
+
+	public static StudentCouncilNotice toEntity(StudentCouncil writer, NoticeRequestDto dto) {
+		return StudentCouncilNotice.builder()
+			.title(dto.title())
+			.content(dto.content())
+			.writer(writer)
+			.build();
+	}
+
+	public static NoticeImage toEntity(StudentCouncilNotice notice, String imageUrl) {
+		return NoticeImage.builder()
+			.notice(notice)
+			.imageUrl(imageUrl)
+			.build();
+	}
+
+	public static NoticeResponseDto toDetail(StudentCouncilNotice notice, List<String> imageUrls, Long councilId) {
+		return NoticeResponseDto.builder()
+			.id(notice.getId())
+			.writerId(notice.getWriter().getId())
+			.writerName(notice.getWriter().getFullCouncilName())
+			.isWriter(notice.isWrittenByCouncil(councilId))
+			.title(notice.getTitle())
+			.content(notice.getContent())
+			.images(imageUrls)
+			.createdAt(notice.getCreatedAt())
+			.updatedAt(notice.getUpdatedAt())
+			.build();
+	}
+
+	public static NoticeListItemResponseDto toListItem(StudentCouncilNotice notice, Long currentUserId) {
+		return NoticeListItemResponseDto.builder()
+			.id(notice.getId())
+			.title(notice.getTitle())
+			.isWriter(notice.isWrittenByCouncil(currentUserId))
+			.createdAt(notice.getCreatedAt())
+			.updatedAt(notice.getUpdatedAt())
+			.build();
+	}
+}

src/main/java/com/campus/campus/domain/councilNotice/application/service/StudentCouncilNoticeService.java

@@ -0,0 +1,201 @@
+package com.campus.campus.domain.councilNotice.application.service;
+
+import java.util.ArrayList;
+import java.util.List;
+
+import org.springframework.data.domain.Page;
+import org.springframework.data.domain.PageRequest;
+import org.springframework.data.domain.Pageable;
+import org.springframework.data.domain.Sort;
+import org.springframework.stereotype.Service;
+import org.springframework.transaction.annotation.Transactional;
+
+import com.campus.campus.domain.council.application.exception.StudentCouncilNotFoundException;
+import com.campus.campus.domain.council.domain.entity.StudentCouncil;
+import com.campus.campus.domain.council.domain.repository.StudentCouncilRepository;
+import com.campus.campus.domain.councilNotice.application.dto.request.NoticeRequestDto;
+import com.campus.campus.domain.councilNotice.application.dto.response.NoticeListItemResponseDto;
+import com.campus.campus.domain.councilNotice.application.dto.response.NoticeResponseDto;
+import com.campus.campus.domain.councilNotice.application.exception.NotNoticeWriterException;
+import com.campus.campus.domain.councilNotice.application.exception.NoticeImageLimitExceededException;
+import com.campus.campus.domain.councilNotice.application.exception.NoticeNotFoundException;
+import com.campus.campus.domain.councilNotice.application.mapper.StudentCouncilNoticeMapper;
+import com.campus.campus.domain.councilNotice.domain.entity.NoticeImage;
+import com.campus.campus.domain.councilNotice.domain.entity.StudentCouncilNotice;
+import com.campus.campus.domain.councilNotice.domain.repository.NoticeImageRepository;
+import com.campus.campus.domain.councilNotice.domain.repository.StudentCouncilNoticeRepository;
+import com.campus.campus.global.oci.application.service.PresignedUrlService;
+
+import lombok.RequiredArgsConstructor;
+import lombok.extern.slf4j.Slf4j;
+
+@Slf4j
+@Service
+@RequiredArgsConstructor
+public class StudentCouncilNoticeService {
+
+	private static final int MAX_IMAGE_COUNT = 10;
+
+	private final StudentCouncilNoticeRepository noticeRepository;
+	private final StudentCouncilRepository studentCouncilRepository;
+	private final NoticeImageRepository noticeImageRepository;
+	private final PresignedUrlService presignedUrlService;
+
+	@Transactional
+	public NoticeResponseDto create(Long councilId, NoticeRequestDto dto) {
+
+		if (dto.imageUrls() != null && dto.imageUrls().size() > MAX_IMAGE_COUNT) {
+			throw new NoticeImageLimitExceededException();
+		}
+
+		StudentCouncil writer = studentCouncilRepository.findByIdWithDetailsAndDeletedAtIsNull(councilId)
+			.orElseThrow(StudentCouncilNotFoundException::new);
+
+		StudentCouncilNotice notice =
+			noticeRepository.save(StudentCouncilNoticeMapper.toEntity(writer, dto));
+
+		if (dto.imageUrls() != null && !dto.imageUrls().isEmpty()) {
+			List<NoticeImage> images = dto.imageUrls().stream()
+				.map(imageUrl -> StudentCouncilNoticeMapper.toEntity(notice, imageUrl))
+				.toList();
+
+			noticeImageRepository.saveAll(images);
+		}
+
+		List<String> imageUrls = noticeImageRepository
+			.findAllByNoticeOrderByIdAsc(notice)
+			.stream()
+			.map(NoticeImage::getImageUrl)
+			.toList();
+
+		return StudentCouncilNoticeMapper.toDetail(notice, imageUrls, councilId);
+	}
+
+	@Transactional(readOnly = true)
+	public NoticeResponseDto findById(Long noticeId, Long councilId) {
+
+		StudentCouncilNotice notice = noticeRepository.findByIdWithFullInfo(noticeId)
+			.orElseThrow(NoticeNotFoundException::new);
+
+		List<String> imageUrls = noticeImageRepository
+			.findAllByNoticeOrderByIdAsc(notice)
+			.stream()
+			.map(NoticeImage::getImageUrl)
+			.toList();
+
+		return StudentCouncilNoticeMapper.toDetail(notice, imageUrls, councilId);
+	}
+
+	@Transactional(readOnly = true)
+	public Page<NoticeListItemResponseDto> findAll(int page, int size, Long councilId) {
+
+		Pageable pageable = PageRequest.of(
+			Math.max(page - 1, 0),
+			size,
+			Sort.by(Sort.Direction.DESC, "createdAt")
+		);
+
+		Page<StudentCouncilNotice> notices = noticeRepository.findAll(pageable);
+
+		return notices.map(notice ->
+			StudentCouncilNoticeMapper.toListItem(notice, councilId)
+		);
+	}
+
+	@Transactional
+	public NoticeResponseDto update(Long councilId, Long noticeId, NoticeRequestDto dto) {
+
+		if (dto.imageUrls() != null && dto.imageUrls().size() > MAX_IMAGE_COUNT) {
+			throw new NoticeImageLimitExceededException();
+		}
+
+		StudentCouncilNotice notice = noticeRepository.findByIdWithFullInfo(noticeId)
+			.orElseThrow(NoticeNotFoundException::new);
+
+		if (!notice.isWrittenByCouncil(councilId)) {
+			throw new NotNoticeWriterException();
+		}
+
+		// 업데이트 전 기존 이미지 스냅샷
+		List<NoticeImage> oldImages = noticeImageRepository.findAllByNotice(notice);
+
+		notice.update(dto.title(), dto.content());
+
+		// DB 이미지 교체
+		noticeImageRepository.deleteByNotice(notice);
+
+		if (dto.imageUrls() != null) {
+			for (String imageUrl : dto.imageUrls()) {
+				noticeImageRepository.save(StudentCouncilNoticeMapper.toEntity(notice, imageUrl));
+			}
+		}
+
+		cleanupUnusedImages(oldImages, dto);
+
+		List<String> imageUrls = noticeImageRepository
+			.findAllByNoticeOrderByIdAsc(notice)
+			.stream()
+			.map(NoticeImage::getImageUrl)
+			.toList();
+
+		return StudentCouncilNoticeMapper.toDetail(notice, imageUrls, councilId);
+	}
+
+	@Transactional
+	public void delete(Long councilId, Long noticeId) {
+
+		StudentCouncilNotice notice = noticeRepository.findByIdWithFullInfo(noticeId)
+			.orElseThrow(NoticeNotFoundException::new);
+
+		if (!notice.isWrittenByCouncil(councilId)) {
+			throw new NotNoticeWriterException();
+		}
+
+		List<NoticeImage> images = noticeImageRepository.findAllByNotice(notice);
+
+		List<String> deleteTargets = new ArrayList<>();
+		images.stream()
+			.map(NoticeImage::getImageUrl)
+			.forEach(deleteTargets::add);
+
+		noticeImageRepository.deleteAll(images);
+		noticeRepository.delete(notice);
+
+		for (String imageUrl : deleteTargets) {
+			if (imageUrl == null || imageUrl.isBlank()) {
+				continue;
+			}
+
+			try {
+				presignedUrlService.deleteImage(imageUrl);
+			} catch (Exception e) {
+				log.warn("OCI 파일 삭제 실패 (파일이 없을 수 있음): {}", imageUrl);
+			}
+		}
+	}
+
+	private void cleanupUnusedImages(List<NoticeImage> oldImages, NoticeRequestDto dto) {
+		List<String> newUrls = dto.imageUrls() == null ? List.of() : dto.imageUrls();
+
+		List<String> deleteTargets = new ArrayList<>();
+
+		// 본문 이미지 중 제거된 이미지
+		oldImages.stream()
+			.map(NoticeImage::getImageUrl)
+			.filter(url -> !newUrls.contains(url))
+			.forEach(deleteTargets::add);
+
+		//삭제
+		for (String imageUrl : deleteTargets) {
+			if (imageUrl == null || imageUrl.isBlank()) {
+				continue;
+			}
+
+			try {
+				presignedUrlService.deleteImage(imageUrl);
+			} catch (Exception e) {
+				log.warn("OCI 파일 삭제 실패 (파일이 없을 수 있음): {}", imageUrl);
+			}
+		}
+	}
+}

src/main/java/com/campus/campus/domain/councilNotice/domain/entity/NoticeImage.java

@@ -0,0 +1,34 @@
+package com.campus.campus.domain.councilNotice.domain.entity;
+
+import jakarta.persistence.Column;
+import jakarta.persistence.Entity;
+import jakarta.persistence.FetchType;
+import jakarta.persistence.GeneratedValue;
+import jakarta.persistence.GenerationType;
+import jakarta.persistence.Id;
+import jakarta.persistence.JoinColumn;
+import jakarta.persistence.ManyToOne;
+import lombok.AccessLevel;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Getter;
+import lombok.NoArgsConstructor;
+
+@Entity
+@Getter
+@NoArgsConstructor(access = AccessLevel.PROTECTED)
+@AllArgsConstructor
+@Builder
+public class NoticeImage {
+
+	@Id
+	@GeneratedValue(strategy = GenerationType.IDENTITY)
+	private Long id;
+
+	@ManyToOne(fetch = FetchType.LAZY, optional = false)
+	@JoinColumn(name = "notice_id")
+	private StudentCouncilNotice notice;
+
+	@Column(nullable = false)
+	private String imageUrl;
+}