feat: 관리자 인증 기능을 구현한다

src/docs/asciidoc/admin.adoc

@@ -0,0 +1,42 @@
+:toc: left
+:source-highlighter: highlightjs
+:sectlinks:
+:toclevels: 2
+:sectlinks:
+:sectnums:
+
+== Admin
+
+=== 회원 가입(POST api/admins/auth/sign-up)
+
+==== 요청
+include::{snippets}/admin-auth-controller-test/관리자_회원가입/http-request.adoc[]
+include::{snippets}/admin-auth-controller-test/관리자_회원가입/request-fields.adoc[]
+
+==== 응답
+include::{snippets}/admin-auth-controller-test/관리자_회원가입/http-response.adoc[]
+include::{snippets}/admin-auth-controller-test/관리자_회원가입/response-headers.adoc[]
+include::{snippets}/admin-auth-controller-test/관리자_회원가입/response-fields.adoc[]
+
+
+=== 로그인(POST api/admins/auth/login)
+
+==== 요청
+include::{snippets}/admin-auth-controller-test/관리자_로그인/http-request.adoc[]
+include::{snippets}/admin-auth-controller-test/관리자_로그인/request-fields.adoc[]
+
+==== 응답
+include::{snippets}/admin-auth-controller-test/관리자_로그인/http-response.adoc[]
+include::{snippets}/admin-auth-controller-test/관리자_로그인/response-headers.adoc[]
+include::{snippets}/admin-auth-controller-test/관리자_로그인/response-fields.adoc[]
+
+
+=== 엑세스 토큰 재발행(POST api/admins/auth/access-token-regeneration)
+
+==== 요청
+include::{snippets}/admin-auth-controller-test/관리자_액세스_토큰_재발행/http-request.adoc[]
+include::{snippets}/admin-auth-controller-test/관리자_액세스_토큰_재발행/request-headers.adoc[]
+
+==== 응답
+include::{snippets}/admin-auth-controller-test/관리자_액세스_토큰_재발행/http-response.adoc[]
+include::{snippets}/admin-auth-controller-test/관리자_액세스_토큰_재발행/response-fields.adoc[]

src/docs/asciidoc/index.adoc

@@ -5,8 +5,8 @@
 :sectlinks:
 
 == atwoz Server API
-* link:auth.html[회원 API]
 * link:member.html[회원 정보 API]
+* link:admin.html[관리자 정보 API]
 * link:mission.html[미션 API]
 * link:membermissions.html[회원 미션 API]
 * link:survey.html[연애고사 API]

src/docs/asciidoc/member.adoc

@@ -7,11 +7,23 @@
 
 == Member
 
+=== 로그인 (POST api/members/auth/login)
+
+==== 요청
+include::{snippets}/member-auth-controller-web-mvc-test/유저_로그인/http-request.adoc[]
+include::{snippets}/member-auth-controller-web-mvc-test/유저_로그인/request-fields.adoc[]
+
+==== 응답
+include::{snippets}/member-auth-controller-web-mvc-test/유저_로그인/http-response.adoc[]
+include::{snippets}/member-auth-controller-web-mvc-test/유저_로그인/request-fields.adoc[]
+
+
 === 닉네임 중복 확인 (GET /api/members/nickname/existence)
 
 ==== 요청
-include::{snippets}/member-controller-web-mvc-test/닉네임_중복_확인/request-headers.adoc[]
 include::{snippets}/member-controller-web-mvc-test/닉네임_중복_확인/http-request.adoc[]
+include::{snippets}/member-controller-web-mvc-test/닉네임_중복_확인/request-headers.adoc[]
+include::{snippets}/member-controller-web-mvc-test/닉네임_중복_확인/path-parameters.adoc[]
 
 ==== 응답
 include::{snippets}/member-controller-web-mvc-test/닉네임_중복_확인/http-response.adoc[]

src/main/java/com/atwoz/admin/application/auth/AdminAuthService.java

@@ -0,0 +1,69 @@
+package com.atwoz.admin.application.auth;
+
+import com.atwoz.admin.application.auth.dto.AdminAccessTokenResponse;
+import com.atwoz.admin.application.auth.dto.AdminLoginRequest;
+import com.atwoz.admin.application.auth.dto.AdminProfileSignUpRequest;
+import com.atwoz.admin.application.auth.dto.AdminSignUpRequest;
+import com.atwoz.admin.application.auth.dto.AdminTokenResponse;
+import com.atwoz.admin.domain.admin.Admin;
+import com.atwoz.admin.domain.admin.AdminRepository;
+import com.atwoz.admin.domain.admin.AdminTokenProvider;
+import com.atwoz.admin.exception.exceptions.AdminNotFoundException;
+import lombok.RequiredArgsConstructor;
+import org.springframework.stereotype.Service;
+import org.springframework.transaction.annotation.Transactional;
+
+@RequiredArgsConstructor
+@Service
+@Transactional
+public class AdminAuthService {
+
+    private static final String ID = "id";
+
+    private final AdminRepository adminRepository;
+    private final AdminTokenProvider adminTokenProvider;
+
+    public AdminTokenResponse signUp(final AdminSignUpRequest adminSignUpRequest) {
+        AdminProfileSignUpRequest adminProfileSignUpRequest = adminSignUpRequest.adminProfileSignUpRequest();
+        Admin admin = Admin.createWith(
+                adminSignUpRequest.email(),
+                adminSignUpRequest.password(),
+                adminSignUpRequest.confirmPassword(),
+                adminProfileSignUpRequest.name(),
+                adminProfileSignUpRequest.phoneNumber()
+        );
+        Admin savedAdmin = adminRepository.save(admin);
+
+        return createAdminTokenResponse(savedAdmin.getId());
+    }
+
+    private AdminTokenResponse createAdminTokenResponse(final Long id) {
+        return new AdminTokenResponse(
+                adminTokenProvider.createAccessToken(id),
+                adminTokenProvider.createRefreshToken(id)
+        );
+    }
+
+    public AdminTokenResponse login(final AdminLoginRequest adminLoginRequest) {
+        Admin foundAdmin = findAdminByEmail(adminLoginRequest.email());
+        foundAdmin.validatePassword(adminLoginRequest.password());
+
+        return createAdminTokenResponse(foundAdmin.getId());
+    }
+
+    public AdminAccessTokenResponse reGenerateAccessToken(final String refreshToken) {
+        Admin foundAdmin = findAdminById(adminTokenProvider.extract(refreshToken, ID, Long.class));
+
+        return new AdminAccessTokenResponse(adminTokenProvider.createAccessToken(foundAdmin.getId()));
+    }
+
+    private Admin findAdminByEmail(final String email) {
+        return adminRepository.findAdminByEmail(email)
+                .orElseThrow(AdminNotFoundException::new);
+    }
+
+    private Admin findAdminById(final Long id) {
+        return adminRepository.findAdminById(id)
+                .orElseThrow(AdminNotFoundException::new);
+    }
+}

src/main/java/com/atwoz/admin/application/auth/dto/AdminAccessTokenResponse.java

@@ -0,0 +1,6 @@
+package com.atwoz.admin.application.auth.dto;
+
+public record AdminAccessTokenResponse(
+        String accessToken
+) {
+}

src/main/java/com/atwoz/admin/application/auth/dto/AdminLoginRequest.java

@@ -0,0 +1,12 @@
+package com.atwoz.admin.application.auth.dto;
+
+import jakarta.validation.constraints.NotBlank;
+
+public record AdminLoginRequest(
+        @NotBlank(message = "이메일을 입력해주세요")
+        String email,
+
+        @NotBlank(message = "비밀번호를 입력해주세요")
+        String password
+) {
+}

src/main/java/com/atwoz/admin/application/auth/dto/AdminProfileSignUpRequest.java

@@ -0,0 +1,12 @@
+package com.atwoz.admin.application.auth.dto;
+
+import jakarta.validation.constraints.NotBlank;
+
+public record AdminProfileSignUpRequest(
+        @NotBlank(message = "이름을 입력해주세요.")
+        String name,
+
+        @NotBlank(message = "전화번호를 입력해주세요.")
+        String phoneNumber
+) {
+}

src/main/java/com/atwoz/admin/application/auth/dto/AdminSignUpRequest.java

@@ -0,0 +1,21 @@
+package com.atwoz.admin.application.auth.dto;
+
+import jakarta.validation.Valid;
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.NotNull;
+
+public record AdminSignUpRequest(
+        @NotBlank(message = "이메일을 입력해주세요")
+        String email,
+
+        @NotBlank(message = "비밀번호를 입력해주세요")
+        String password,
+
+        @NotBlank(message = "비밀번호 확인을 위해 다시한번 입력해주세요")
+        String confirmPassword,
+
+        @Valid
+        @NotNull(message = "관리자 프로필 정보를 입력해주세요")
+        AdminProfileSignUpRequest adminProfileSignUpRequest
+) {
+}

src/main/java/com/atwoz/admin/application/auth/dto/AdminTokenResponse.java

@@ -0,0 +1,7 @@
+package com.atwoz.admin.application.auth.dto;
+
+public record AdminTokenResponse(
+        String accessToken,
+        String refreshToken
+) {
+}

src/main/java/com/atwoz/admin/config/AdminAuthConfig.java

@@ -0,0 +1,40 @@
+package com.atwoz.admin.config;
+
+import com.atwoz.admin.ui.auth.interceptor.AdminLoginValidCheckerInterceptor;
+import com.atwoz.admin.ui.auth.support.resolver.AdminAuthArgumentResolver;
+import com.atwoz.admin.ui.auth.support.resolver.AdminRefreshTokenExtractionArgumentResolver;
+import com.atwoz.global.config.interceptor.PathMatcherInterceptor;
+import java.util.List;
+import lombok.RequiredArgsConstructor;
+import org.springframework.context.annotation.Configuration;
+import org.springframework.web.method.support.HandlerMethodArgumentResolver;
+import org.springframework.web.servlet.HandlerInterceptor;
+import org.springframework.web.servlet.config.annotation.InterceptorRegistry;
+import org.springframework.web.servlet.config.annotation.WebMvcConfigurer;
+
+import static com.atwoz.global.config.interceptor.support.HttpMethod.OPTIONS;
+
+@RequiredArgsConstructor
+@Configuration
+public class AdminAuthConfig implements WebMvcConfigurer {
+
+    private final AdminAuthArgumentResolver adminAuthArgumentResolver;
+    private final AdminRefreshTokenExtractionArgumentResolver adminRefreshTokenExtractionArgumentResolver;
+    private final AdminLoginValidCheckerInterceptor adminLoginValidCheckerInterceptor;
+
+    @Override
+    public void addInterceptors(final InterceptorRegistry registry) {
+        registry.addInterceptor(adminLoginValidCheckerInterceptor());
+    }
+
+    private HandlerInterceptor adminLoginValidCheckerInterceptor() {
+        return new PathMatcherInterceptor(adminLoginValidCheckerInterceptor)
+                .excludePathPattern("/**", OPTIONS);
+    }
+
+    @Override
+    public void addArgumentResolvers(final List<HandlerMethodArgumentResolver> resolvers) {
+        resolvers.add(adminAuthArgumentResolver);
+        resolvers.add(adminRefreshTokenExtractionArgumentResolver);
+    }
+}

src/main/java/com/atwoz/admin/domain/admin/Admin.java

@@ -0,0 +1,87 @@
+package com.atwoz.admin.domain.admin;
+
+import com.atwoz.admin.domain.admin.vo.AdminStatus;
+import com.atwoz.admin.domain.admin.vo.Authority;
+import com.atwoz.admin.domain.admin.vo.Department;
+import com.atwoz.admin.exception.exceptions.InvalidPasswordException;
+import com.atwoz.admin.exception.exceptions.PasswordMismatchException;
+import jakarta.persistence.Column;
+import jakarta.persistence.Entity;
+import jakarta.persistence.EnumType;
+import jakarta.persistence.Enumerated;
+import jakarta.persistence.GeneratedValue;
+import jakarta.persistence.GenerationType;
+import jakarta.persistence.Id;
+import lombok.AccessLevel;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.EqualsAndHashCode;
+import lombok.Getter;
+import lombok.NoArgsConstructor;
+
+@Getter
+@Builder
+@EqualsAndHashCode(of = "id", callSuper = false)
+@AllArgsConstructor(access = AccessLevel.PRIVATE)
+@NoArgsConstructor(access = AccessLevel.PROTECTED)
+@Entity
+public class Admin {
+
+    @Id
+    @GeneratedValue(strategy = GenerationType.IDENTITY)
+    private Long id;
+
+    @Column(unique = true, nullable = false)
+    private String email;
+
+    @Column(nullable = false)
+    private String password;
+
+    @Column(nullable = false)
+    private String name;
+
+    @Column(nullable = false)
+    private String phoneNumber;
+
+    @Enumerated(value = EnumType.STRING)
+    @Column(nullable = false)
+    private Authority authority;
+
+    @Enumerated(value = EnumType.STRING)
+    @Column(nullable = false)
+    private Department department;
+
+    @Enumerated(value = EnumType.STRING)
+    @Column(nullable = false)
+    private AdminStatus adminStatus;
+
+    public static Admin createWith(final String email,
+                                   final String password,
+                                   final String confirmPassword,
+                                   final String name,
+                                   final String phoneNumber) {
+        validatePasswordsMatch(password, confirmPassword);
+        return Admin.builder()
+                .email(email)
+                .password(password)
+                .name(name)
+                .phoneNumber(phoneNumber)
+                .authority(Authority.ADMIN)
+                .department(Department.OPERATION)
+                .adminStatus(AdminStatus.PENDING)
+                .build();
+    }
+
+    private static void validatePasswordsMatch(final String password,
+                                              final String confirmPassword) {
+        if (!password.equals(confirmPassword)) {
+            throw new PasswordMismatchException();
+        }
+    }
+
+    public void validatePassword(final String password) {
+        if (!password.equals(this.password)) {
+            throw new InvalidPasswordException();
+        }
+    }
+}

src/main/java/com/atwoz/admin/domain/admin/AdminRepository.java

@@ -0,0 +1,12 @@
+package com.atwoz.admin.domain.admin;
+
+import java.util.Optional;
+
+public interface AdminRepository {
+
+    Admin save(Admin admin);
+
+    Optional<Admin> findAdminById(Long id);
+
+    Optional<Admin> findAdminByEmail(String email);
+}

src/main/java/com/atwoz/admin/domain/admin/AdminTokenProvider.java

@@ -0,0 +1,10 @@
+package com.atwoz.admin.domain.admin;
+
+public interface AdminTokenProvider {
+
+    String createAccessToken(Long id);
+
+    String createRefreshToken(Long id);
+
+    <T> T extract(String token, String claimName, Class<T> classType);
+}

src/main/java/com/atwoz/admin/domain/admin/vo/AdminStatus.java

@@ -0,0 +1,8 @@
+package com.atwoz.admin.domain.admin.vo;
+
+public enum AdminStatus {
+
+    AVAILABLE,
+    UNAVAILABLE,
+    PENDING
+}