전체 사용자 및 사용자 검색 API 구현

README.md

@@ -0,0 +1,44 @@
+# Groom
+
+ GSM Room Booking System
+
+---
+
+## Commit Message Rule
+
+| Type   | Meaning            |
+|--------|--------------------|
+| add    | 새로운 코드나 파일을 추가했을 때 |
+| update | 기존의 코드를 수정했을 때     |
+| fix    | 버그를 수정했을 때         |
+| delete | 삭제한 사항이 있을 때       |
+| chore  | 그 외 자잘한 작업을 했을 때   |
+| docs   | 문서를 수정했을 때         |
+| test   | 테스트 관련 사항을 수정했을 때  |
+| merge  | 브랜치를 병합했을 때        |
+| init   | 프로젝트를 초기화했을 때      |
+
+### Example
+
+```bash
+docs: README 작성
+
+README.md 파일을 작성했습니다
+```
+---
+
+## Branch Rule
+
+기본적으로 ``Git Flow``를 따르며, ``main``,`develop`,`feature`,`hotfix` 브랜치를 사용합니다.
+
+| Branch  | Meaning                  | Merge Branch |
+|---------|--------------------------|--------------|
+| main    | 배포 가능한 상태로 유지하는 브랜치      | [가장 최신 버전]   |
+| develop | 다음 버전을 개발하는 브랜치          | main         |
+| feature | 기능을 개발하는 브랜치             | develop      |
+| hotfix  | 배포 버전에서 발생한 버그를 수정하는 브랜치 | main         |
+
+
+## Database Schema
+
+<iframe width="600" height="336" src="https://www.erdcloud.com/p/gBu6AkAeoALCdRew2" frameborder="0" allowfullscreen></iframe>

src/main/java/com/ampersand/groom/domain/member/application/MemberApplicationAdapter.java

@@ -0,0 +1,41 @@
+package com.ampersand.groom.domain.member.application;
+
+import com.ampersand.groom.domain.member.application.port.MemberApplicationPort;
+import com.ampersand.groom.domain.member.application.usecase.FindAllMembersUseCase;
+import com.ampersand.groom.domain.member.application.usecase.FindMembersByCriteriaUseCase;
+import com.ampersand.groom.domain.member.domain.constant.MemberRole;
+import com.ampersand.groom.domain.member.presentation.data.response.GetCurrentMemberResponse;
+import com.ampersand.groom.domain.member.presentation.data.response.GetMemberResponse;
+import com.ampersand.groom.global.annotation.adapter.Adapter;
+import com.ampersand.groom.global.annotation.adapter.constant.AdapterType;
+import lombok.RequiredArgsConstructor;
+
+import java.util.List;
+
+@Adapter(AdapterType.INBOUND)
+@RequiredArgsConstructor
+public class MemberApplicationAdapter implements MemberApplicationPort {
+
+    private final FindAllMembersUseCase findAllMembersUseCase;
+    private final FindMembersByCriteriaUseCase findMembersByCriteriaUseCase;
+
+    @Override
+    public List<GetMemberResponse> findAllMembers() {
+        return findAllMembersUseCase.execute();
+    }
+
+    @Override
+    public List<GetMemberResponse> findMembersByCriteria(Long id, String name, Integer generation, String email, Boolean isAvailable, MemberRole role) {
+        return findMembersByCriteriaUseCase.execute(id, name, generation, email, isAvailable, role);
+    }
+
+    @Override
+    public GetCurrentMemberResponse findCurrentMember() {
+        return null;  // TODO: 인증/인가 및 booking 관련 로직 구현 시 구현
+    }
+
+    @Override
+    public void updatePassword(Long id, String currentPassword, String newPassword) {
+        // TODO: 인증/인가 및 Email 전송 로직 구현 시 구현
+    }
+}

src/main/java/com/ampersand/groom/domain/member/application/port/MemberApplicationPort.java

@@ -0,0 +1,17 @@
+package com.ampersand.groom.domain.member.application.port;
+
+import com.ampersand.groom.domain.member.domain.constant.MemberRole;
+import com.ampersand.groom.domain.member.presentation.data.response.GetCurrentMemberResponse;
+import com.ampersand.groom.domain.member.presentation.data.response.GetMemberResponse;
+
+import java.util.List;
+
+public interface MemberApplicationPort {
+    List<GetMemberResponse> findAllMembers();
+
+    List<GetMemberResponse> findMembersByCriteria(Long id, String name, Integer generation, String email, Boolean isAvailable, MemberRole role);
+
+    GetCurrentMemberResponse findCurrentMember();
+
+    void updatePassword(Long id, String currentPassword, String newPassword);
+}

src/main/java/com/ampersand/groom/domain/member/application/port/MemberPersistencePort.java

@@ -0,0 +1,16 @@
+package com.ampersand.groom.domain.member.application.port;
+
+import com.ampersand.groom.domain.member.domain.Member;
+import com.ampersand.groom.domain.member.domain.constant.MemberRole;
+
+import java.util.List;
+
+public interface MemberPersistencePort {
+    List<Member> findAllMembers();
+
+    List<Member> findMembersByCriteria(Long id, String name, Integer generation, String email, Boolean isAvailable, MemberRole role);
+
+    Member findMemberById(Long id);
+
+    void updateMemberPassword(Long id, String newPassword);
+}

src/main/java/com/ampersand/groom/domain/member/application/usecase/FindAllMembersUseCase.java

@@ -0,0 +1,23 @@
+package com.ampersand.groom.domain.member.application.usecase;
+
+import com.ampersand.groom.domain.member.application.port.MemberPersistencePort;
+import com.ampersand.groom.domain.member.persistence.mapper.MemberMapper;
+import com.ampersand.groom.domain.member.presentation.data.response.GetMemberResponse;
+import com.ampersand.groom.global.annotation.usecase.UseCaseWithReadOnlyTransaction;
+import lombok.RequiredArgsConstructor;
+
+import java.util.List;
+
+@UseCaseWithReadOnlyTransaction
+@RequiredArgsConstructor
+public class FindAllMembersUseCase {
+
+    private final MemberPersistencePort memberPersistencePort;
+    private final MemberMapper memberMapper;
+
+    public List<GetMemberResponse> execute() {
+        return memberPersistencePort.findAllMembers().stream().map(
+                memberMapper::toResponse
+        ).toList();
+    }
+}

src/main/java/com/ampersand/groom/domain/member/application/usecase/FindMembersByCriteriaUseCase.java

@@ -0,0 +1,24 @@
+package com.ampersand.groom.domain.member.application.usecase;
+
+import com.ampersand.groom.domain.member.application.port.MemberPersistencePort;
+import com.ampersand.groom.domain.member.domain.constant.MemberRole;
+import com.ampersand.groom.domain.member.persistence.mapper.MemberMapper;
+import com.ampersand.groom.domain.member.presentation.data.response.GetMemberResponse;
+import com.ampersand.groom.global.annotation.usecase.UseCaseWithReadOnlyTransaction;
+import lombok.RequiredArgsConstructor;
+
+import java.util.List;
+
+@UseCaseWithReadOnlyTransaction
+@RequiredArgsConstructor
+public class FindMembersByCriteriaUseCase {
+
+    private final MemberPersistencePort memberPersistencePort;
+    private final MemberMapper memberMapper;
+
+    public List<GetMemberResponse> execute(Long id, String name, Integer generation, String email, Boolean isAvailable, MemberRole role) {
+        return memberPersistencePort.findMembersByCriteria(id, name, generation, email, isAvailable, role).stream().map(
+                memberMapper::toResponse
+        ).toList();
+    }
+}

src/main/java/com/ampersand/groom/domain/member/domain/Member.java

@@ -0,0 +1,17 @@
+package com.ampersand.groom.domain.member.domain;
+
+import com.ampersand.groom.domain.member.domain.constant.MemberRole;
+import lombok.Builder;
+import lombok.Getter;
+
+@Getter
+@Builder
+public class Member {
+    private final Long id;
+    private final String name;
+    private final String email;
+    private final String password;
+    private final Integer generation;
+    private final Boolean isAvailable;
+    private final MemberRole role;
+}

src/main/java/com/ampersand/groom/domain/member/domain/constant/MemberRole.java

@@ -0,0 +1,12 @@
+package com.ampersand.groom.domain.member.domain.constant;
+
+import org.springframework.security.core.GrantedAuthority;
+
+public enum MemberRole implements GrantedAuthority {
+    ROLE_ADMIN, ROLE_STUDENT, ROLE_TEACHER;
+
+    @Override
+    public String getAuthority() {
+        return name();
+    }
+}

src/main/java/com/ampersand/groom/domain/member/exception/MemberNotFoundException.java

@@ -0,0 +1,10 @@
+package com.ampersand.groom.domain.member.exception;
+
+import com.ampersand.groom.global.error.ErrorCode;
+import com.ampersand.groom.global.error.exception.GroomException;
+
+public class MemberNotFoundException extends GroomException {
+    public MemberNotFoundException() {
+        super(ErrorCode.MEMBER_NOT_FOUND);
+    }
+}

src/main/java/com/ampersand/groom/domain/member/persistence/MemberPersistenceAdapter.java

@@ -0,0 +1,47 @@
+package com.ampersand.groom.domain.member.persistence;
+
+import com.ampersand.groom.domain.member.application.port.MemberPersistencePort;
+import com.ampersand.groom.domain.member.domain.Member;
+import com.ampersand.groom.domain.member.domain.constant.MemberRole;
+import com.ampersand.groom.domain.member.exception.MemberNotFoundException;
+import com.ampersand.groom.domain.member.persistence.mapper.MemberMapper;
+import com.ampersand.groom.domain.member.persistence.repository.MemberJpaRepository;
+import com.ampersand.groom.global.annotation.adapter.Adapter;
+import com.ampersand.groom.global.annotation.adapter.constant.AdapterType;
+import lombok.RequiredArgsConstructor;
+
+import java.util.List;
+
+@Adapter(AdapterType.OUTBOUND)
+@RequiredArgsConstructor
+public class MemberPersistenceAdapter implements MemberPersistencePort {
+
+    private final MemberJpaRepository memberJpaRepository;
+    private final MemberMapper memberMapper;
+
+    @Override
+    public List<Member> findAllMembers() {
+        return memberJpaRepository.findAll().stream()
+                .map(memberMapper::toDomain)
+                .toList();
+    }
+
+    @Override
+    public List<Member> findMembersByCriteria(Long id, String name, Integer generation, String email, Boolean isAvailable, MemberRole role) {
+        return memberJpaRepository.findMembersByCriteria(id, name, generation, email, isAvailable, role).stream()
+                .map(memberMapper::toDomain)
+                .toList();
+    }
+
+    @Override
+    public Member findMemberById(Long id) {
+        return memberJpaRepository.findById(id)
+                .map(memberMapper::toDomain)
+                .orElseThrow(MemberNotFoundException::new);
+    }
+
+    @Override
+    public void updateMemberPassword(Long id, String newPassword) {
+        memberJpaRepository.updatePassword(id, newPassword);
+    }
+}

src/main/java/com/ampersand/groom/domain/member/persistence/entity/MemberJpaEntity.java

@@ -0,0 +1,42 @@
+package com.ampersand.groom.domain.member.persistence.entity;
+
+import com.ampersand.groom.domain.member.domain.constant.MemberRole;
+import com.ampersand.groom.global.entity.BaseIdEntity;
+import jakarta.persistence.*;
+import lombok.Builder;
+import lombok.Getter;
+import lombok.NoArgsConstructor;
+import lombok.ToString;
+
+@Getter
+@NoArgsConstructor
+@Entity
+@Table(name = "member")
+@ToString
+public class MemberJpaEntity extends BaseIdEntity {
+    @Column(nullable = false)
+    private String name;
+    @Column(nullable = false, unique = true)
+    private String email;
+    @Column(nullable = false)
+    @ToString.Exclude
+    private String password;
+    @Column(nullable = false)
+    private Integer generation;
+    @Column(nullable = false, name = "available")
+    private Boolean isAvailable;
+    @Column(nullable = false)
+    @Enumerated(EnumType.STRING)
+    private MemberRole role;
+
+    @Builder
+    public MemberJpaEntity(Long id, String name, String email, String password, Integer generation, Boolean isAvailable, MemberRole role) {
+        this.id = id;
+        this.name = name;
+        this.email = email;
+        this.password = password;
+        this.generation = generation;
+        this.isAvailable = isAvailable;
+        this.role = role;
+    }
+}