[Feat] Organization 도메인 Port 설계 및 프로젝트 구조 확정

.gitignore

@@ -236,4 +236,4 @@ $RECYCLE.BIN/
 # Windows shortcuts
 *.lnk
 
-# End of https://www.toptal.com/developers/gitignore/api/java,intellij+all,macos,windows,linux
+# End of https://www.toptal.com/developers/gitignore/api/java,intellij+all,macos,windows,linux

src/main/java/com/umc/product/organization/application/port/in/DeleteSchoolUseCase.java

@@ -0,0 +1,8 @@
+package com.umc.product.organization.application.port.in;
+
+import java.util.List;
+
+public interface DeleteSchoolUseCase {
+    void deleteById(Long schoolId);
+    void deleteAll(List<Long> schoolIds);
+}

src/main/java/com/umc/product/organization/application/port/in/GetDeletableSchoolListUseCase.java

@@ -0,0 +1,12 @@
+package com.umc.product.organization.application.port.in;
+
+import com.umc.product.organization.application.port.in.dto.DeletableSchoolSummary;
+import com.umc.product.organization.application.port.in.dto.SchoolDeleteSearchCondition;
+import com.umc.product.organization.application.port.in.dto.paging.PageRequest;
+import com.umc.product.organization.application.port.in.dto.paging.PageResult;
+import java.util.List;
+
+public interface GetDeletableSchoolListUseCase {
+    PageResult<DeletableSchoolSummary> getList(SchoolDeleteSearchCondition condition, PageRequest pageRequest);
+
+}

src/main/java/com/umc/product/organization/application/port/in/GetSchoolUserCase.java

@@ -0,0 +1,12 @@
+package com.umc.product.organization.application.port.in;
+
+
+import com.umc.product.organization.application.port.in.dto.SchoolInfo;
+import com.umc.product.organization.application.port.in.dto.SchoolSummary;
+import java.util.List;
+
+public interface GetSchoolUserCase {
+    List<SchoolSummary> getAll(Long gisuId);
+    SchoolInfo getById(Long schoolId);
+
+}

src/main/java/com/umc/product/organization/application/port/in/RegisterSchoolUseCase.java

@@ -0,0 +1,7 @@
+package com.umc.product.organization.application.port.in;
+
+import com.umc.product.organization.application.port.in.dto.RegisterSchoolCommand;
+
+public interface RegisterSchoolUseCase {
+    Long register(RegisterSchoolCommand command);
+}

src/main/java/com/umc/product/organization/application/port/in/UpdateSchoolUseCase.java

@@ -0,0 +1,8 @@
+package com.umc.product.organization.application.port.in;
+
+import com.umc.product.organization.application.port.in.dto.UpdateSchoolCommand;
+import com.umc.product.organization.application.port.in.dto.UpdateSchoolInfo;
+
+public interface UpdateSchoolUseCase {
+    UpdateSchoolInfo update(UpdateSchoolCommand command);
+}

src/main/java/com/umc/product/organization/application/port/in/dto/DeletableSchoolSummary.java

@@ -0,0 +1,14 @@
+package com.umc.product.organization.application.port.in.dto;
+
+import java.time.LocalDate;
+
+public record DeletableSchoolSummary(
+        Long schoolId,
+        String schoolName,
+        Long chapterId,
+        String chapterName,
+        LocalDate createdAt,
+        boolean isActive
+) {
+
+}

src/main/java/com/umc/product/organization/application/port/in/dto/RegisterSchoolCommand.java

@@ -0,0 +1,12 @@
+package com.umc.product.organization.application.port.in.dto;
+
+import com.umc.product.organization.domain.Chapter;
+import jakarta.validation.constraints.NotBlank;
+
+public record RegisterSchoolCommand(
+        @NotBlank
+        String schoolName,
+        Long chapterId,
+        String remark
+) {
+}

src/main/java/com/umc/product/organization/application/port/in/dto/SchoolDeleteSearchCondition.java

@@ -0,0 +1,7 @@
+package com.umc.product.organization.application.port.in.dto;
+
+public record SchoolDeleteSearchCondition(
+        String keyword,
+        Long chapterId
+) {
+}

src/main/java/com/umc/product/organization/application/port/in/dto/SchoolInfo.java

@@ -0,0 +1,14 @@
+package com.umc.product.organization.application.port.in.dto;
+
+import java.time.LocalDate;
+
+public record SchoolInfo(
+        Long chapterId,
+        String chapterName,
+        String schoolName,
+        Long schoolId,
+        String remark,
+        LocalDate createdAt,
+        LocalDate updatedAt
+) {
+}

src/main/java/com/umc/product/organization/application/port/in/dto/SchoolSummary.java

@@ -0,0 +1,7 @@
+package com.umc.product.organization.application.port.in.dto;
+
+public record SchoolSummary(
+        Long schoolId,
+        String schoolName
+) {
+}

src/main/java/com/umc/product/organization/application/port/in/dto/UpdateSchoolCommand.java

@@ -0,0 +1,17 @@
+package com.umc.product.organization.application.port.in.dto;
+
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.NotNull;
+import java.time.LocalDate;
+
+public record UpdateSchoolCommand(
+        @NotNull
+        Long schoolId,
+        @NotBlank
+        String schoolName,
+        @NotNull
+        String chapterId,
+        String remark
+
+) {
+}

src/main/java/com/umc/product/organization/application/port/in/dto/UpdateSchoolInfo.java

@@ -0,0 +1,13 @@
+package com.umc.product.organization.application.port.in.dto;
+
+import java.time.LocalDate;
+
+public record UpdateSchoolInfo(
+    String newSchoolName,
+    Long chapterId,
+    String chapterName,
+    String remark,
+    LocalDate createdAt,
+    LocalDate updatedAt
+) {
+}

src/main/java/com/umc/product/organization/application/port/in/dto/paging/PageRequest.java

@@ -0,0 +1,14 @@
+package com.umc.product.organization.application.port.in.dto.paging;
+
+import jakarta.validation.constraints.Max;
+import jakarta.validation.constraints.Min;
+
+public record PageRequest(
+        // common으로 빼도 괜찮을 거 같습니다
+        @Min(1) int page,
+        @Min(1) @Max(100) int limit
+) {
+    public long offset() {
+        return (long) (page - 1) * limit;
+    }
+}

src/main/java/com/umc/product/organization/application/port/in/dto/paging/PageResult.java

@@ -0,0 +1,14 @@
+package com.umc.product.organization.application.port.in.dto.paging;
+
+import java.util.List;
+
+public record PageResult<T>(
+        List<T> items,
+        long totalCount,
+        int page,
+        int limit
+) {
+    public long totalPages() {
+        return (totalCount + limit - 1) / limit;
+    }
+}

src/main/java/com/umc/product/organization/application/port/out/LoadCentralOrganizationPort.java

@@ -0,0 +1,10 @@
+package com.umc.product.organization.application.port.out;
+
+import com.umc.product.organization.domain.CentralOrganization;
+import java.util.Optional;
+
+public interface LoadCentralOrganizationPort {
+
+    Optional<CentralOrganization> findById(Long id);
+
+}

src/main/java/com/umc/product/organization/application/port/out/LoadChapterPort.java

@@ -0,0 +1,13 @@
+package com.umc.product.organization.application.port.out;
+
+import com.umc.product.organization.domain.Chapter;
+import com.umc.product.organization.domain.Gisu;
+import java.util.List;
+import java.util.Optional;
+
+public interface LoadChapterPort {
+
+    Optional<Chapter> findById(Long id);
+    List<Chapter> findAll();
+    List<Chapter> findAllByGisu(Gisu gisu);
+}

src/main/java/com/umc/product/organization/application/port/out/LoadChapterSchoolPort.java

@@ -0,0 +1,14 @@
+package com.umc.product.organization.application.port.out;
+
+import com.umc.product.organization.domain.Chapter;
+import com.umc.product.organization.domain.ChapterSchool;
+import com.umc.product.organization.domain.School;
+import java.util.List;
+import java.util.Optional;
+
+public interface LoadChapterSchoolPort {
+
+    Optional<ChapterSchool> findById(Long id);
+    Optional<ChapterSchool> findByChapterAndSchool(Chapter chapter, School school);
+    List<ChapterSchool> findAllByChapter(Chapter chapter);
+}

src/main/java/com/umc/product/organization/application/port/out/LoadGisuPort.java

@@ -0,0 +1,11 @@
+package com.umc.product.organization.application.port.out;
+
+import com.umc.product.organization.domain.Gisu;
+import java.util.List;
+import java.util.Optional;
+
+public interface LoadGisuPort {
+
+    Optional<Gisu> findById(Long id);
+    List<Gisu> findAll();
+}

src/main/java/com/umc/product/organization/application/port/out/LoadSchoolPort.java

@@ -0,0 +1,13 @@
+package com.umc.product.organization.application.port.out;
+
+import com.umc.product.organization.domain.Chapter;
+import com.umc.product.organization.domain.School;
+import java.util.List;
+import java.util.Optional;
+
+public interface LoadSchoolPort {
+
+    Optional<School> findById(Long id);
+    List<School> findAll();
+    List<School> findByChapter(Chapter chapter);
+}

src/main/java/com/umc/product/organization/application/port/out/LoadStudyGroupMemberPort.java

@@ -0,0 +1,12 @@
+package com.umc.product.organization.application.port.out;
+
+import com.umc.product.organization.domain.StudyGroup;
+import com.umc.product.organization.domain.StudyGroupMember;
+import java.util.List;
+import java.util.Optional;
+
+public interface LoadStudyGroupMemberPort {
+
+    Optional<StudyGroupMember> findById(Long id);
+    List<StudyGroupMember> findByStudyGroup(StudyGroup studyGroup);
+}

src/main/java/com/umc/product/organization/application/port/out/LoadStudyGroupPort.java

@@ -0,0 +1,10 @@
+package com.umc.product.organization.application.port.out;
+
+import com.umc.product.organization.domain.StudyGroup;
+import java.util.Optional;
+
+public interface LoadStudyGroupPort {
+
+    Optional<StudyGroup> findById(Long id);
+    Optional<StudyGroup> findByName(String name);
+}

src/main/java/com/umc/product/organization/application/port/out/SaveCentralOrganizationPort.java

@@ -0,0 +1,9 @@
+package com.umc.product.organization.application.port.out;
+
+import com.umc.product.organization.domain.CentralOrganization;
+
+public interface SaveCentralOrganizationPort {
+
+    CentralOrganization save(CentralOrganization organization);
+    void delete(CentralOrganization organization);
+}

src/main/java/com/umc/product/organization/application/port/out/SaveChapterPort.java

@@ -0,0 +1,10 @@
+package com.umc.product.organization.application.port.out;
+
+import com.umc.product.organization.domain.Chapter;
+
+public interface SaveChapterPort {
+
+
+    Chapter save(Chapter chapter);
+    void delete(Chapter chapter);
+}

src/main/java/com/umc/product/organization/application/port/out/SaveChapterSchoolPort.java

@@ -0,0 +1,9 @@
+package com.umc.product.organization.application.port.out;
+
+import com.umc.product.organization.domain.ChapterSchool;
+
+public interface SaveChapterSchoolPort {
+
+    ChapterSchool save(ChapterSchool chapterSchool);
+    void delete(ChapterSchool chapterSchool);
+}

src/main/java/com/umc/product/organization/application/port/out/SaveGisuPort.java

@@ -0,0 +1,9 @@
+package com.umc.product.organization.application.port.out;
+
+import com.umc.product.organization.domain.Gisu;
+
+public interface SaveGisuPort {
+
+    Gisu save(Gisu gisu);
+    void delete(Gisu gisu);
+}

src/main/java/com/umc/product/organization/application/port/out/SaveSchoolPort.java

@@ -0,0 +1,9 @@
+package com.umc.product.organization.application.port.out;
+
+import com.umc.product.organization.domain.School;
+
+public interface SaveSchoolPort {
+
+    School save(School school);
+    void delete(School school);
+}

src/main/java/com/umc/product/organization/application/port/out/SaveStudyGroupMemberPort.java

@@ -0,0 +1,9 @@
+package com.umc.product.organization.application.port.out;
+
+import com.umc.product.organization.domain.StudyGroupMember;
+
+public interface SaveStudyGroupMemberPort {
+
+    StudyGroupMember save(StudyGroupMember studyGroupMember);
+    void delete(StudyGroupMember studyGroupMember);
+}

src/main/java/com/umc/product/organization/application/port/out/SaveStudyGroupPort.java

@@ -0,0 +1,9 @@
+package com.umc.product.organization.application.port.out;
+
+import com.umc.product.organization.domain.StudyGroup;
+
+public interface SaveStudyGroupPort {
+
+    StudyGroup save(StudyGroup studyGroup);
+    void delete(StudyGroup studyGroup);
+}

src/main/java/com/umc/product/organization/domain/CentralOrganization.java

@@ -0,0 +1,45 @@
+package com.umc.product.organization.domain;
+
+import com.umc.product.global.exception.BusinessException;
+import com.umc.product.global.exception.constant.Domain;
+import com.umc.product.organization.exception.OrganizationErrorCode;
+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.Builder;
+import lombok.Getter;
+import lombok.NoArgsConstructor;
+
+@Entity
+@Getter
+@NoArgsConstructor(access = AccessLevel.PROTECTED)
+public class CentralOrganization {
+
+    @Id
+    @GeneratedValue(strategy = GenerationType.IDENTITY)
+    private Long id;
+
+    @ManyToOne(fetch = FetchType.LAZY)
+    @JoinColumn(name = "gisu_id")
+    private Gisu gisu;
+
+    private String name;
+
+    @Builder
+    private CentralOrganization(Gisu gisu, String name) {
+        validate(gisu, name);
+        this.gisu = gisu;
+        this.name = name;
+    }
+
+    private static void validate(Gisu gisu, String name) {
+        if (gisu == null) throw new BusinessException(Domain.COMMON, OrganizationErrorCode.GISU_REQUIRED);
+        if (name == null || name.isBlank()) throw new BusinessException(Domain.COMMON, OrganizationErrorCode.ORGAN_NAME_REQUIRED);
+    }
+
+}