feat: 약관 동의 저장 기능 추가

src/main/java/kr/swyp/backend/common/config/SecurityConfig.java

@@ -79,6 +79,7 @@ public SecurityFilterChain filterChain(HttpSecurity http) throws Exception {
                         .requestMatchers("/error").permitAll()
                         .requestMatchers("/error/**").permitAll()
                         .requestMatchers("/actuator/**").permitAll()
+                        .requestMatchers("/terms").permitAll()
                         .anyRequest().authenticated())
 
                 .addFilterBefore(usernamePasswordAuthenticationFilter(),

src/main/java/kr/swyp/backend/member/repository/MemberTermsAgreementRepository.java

@@ -0,0 +1,16 @@
+package kr.swyp.backend.member.repository;
+
+import java.util.List;
+import java.util.Optional;
+import java.util.UUID;
+import kr.swyp.backend.member.domain.MemberTermsAgreement;
+import org.springframework.data.jpa.repository.JpaRepository;
+
+public interface MemberTermsAgreementRepository extends JpaRepository<MemberTermsAgreement, Long> {
+
+    List<MemberTermsAgreement> findAllByMemberId(UUID memberId);
+
+    Optional<MemberTermsAgreement> findByMemberIdAndTermsId(UUID memberId, Long termsId);
+
+    void deleteAllByMemberId(UUID memberId);
+}

src/main/java/kr/swyp/backend/member/service/MemberServiceImpl.java

@@ -15,6 +15,7 @@
 import kr.swyp.backend.member.repository.MemberCheckRateRepository;
 import kr.swyp.backend.member.repository.MemberRepository;
 import kr.swyp.backend.member.repository.MemberSocialLoginInfoRepository;
+import kr.swyp.backend.member.repository.MemberTermsAgreementRepository;
 import kr.swyp.backend.member.repository.MemberWithdrawalLogRepository;
 import lombok.RequiredArgsConstructor;
 import org.springframework.stereotype.Service;
@@ -30,6 +31,7 @@ public class MemberServiceImpl implements MemberService {
     private final MemberWithdrawalLogRepository memberWithdrawalLogRepository;
     private final MemberCheckRateRepository memberCheckRateRepository;
     private final FriendRepository friendRepository;
+    private final MemberTermsAgreementRepository memberTermsAgreementRepository;
 
     @Transactional(readOnly = true)
     public MemberInfoResponse getMemberInfo(UUID memberId) {
@@ -57,6 +59,9 @@ public void withdrawMember(UUID memberId, MemberWithdrawRequest request) {
         memberCheckRateRepository.findByMember(member)
                 .ifPresent(memberCheckRateRepository::delete);
 
+        // 약관 동의 정보 삭제
+        memberTermsAgreementRepository.deleteAllByMemberId(memberId);
+
         // 탈퇴 처리
         member.updateWithdrawnAt();
 

src/main/java/kr/swyp/backend/term/controller/TermController.java

@@ -0,0 +1,52 @@
+package kr.swyp.backend.term.controller;
+
+import jakarta.validation.Valid;
+import java.util.List;
+import java.util.UUID;
+import kr.swyp.backend.member.dto.MemberDetails;
+import kr.swyp.backend.term.dto.TermDto.TermResponse;
+import kr.swyp.backend.term.dto.TermDto.TermsAgreementRequest;
+import kr.swyp.backend.term.dto.TermDto.TermsAgreementResponse;
+import kr.swyp.backend.term.service.TermService;
+import lombok.RequiredArgsConstructor;
+import org.springframework.http.ResponseEntity;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.security.core.annotation.AuthenticationPrincipal;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RestController;
+
+@RestController
+@RequestMapping("/terms")
+@RequiredArgsConstructor
+public class TermController {
+
+    private final TermService termService;
+
+    @GetMapping
+    public ResponseEntity<List<TermResponse>> getAllTerms() {
+        List<TermResponse> terms = termService.getAllTerms();
+        return ResponseEntity.ok(terms);
+    }
+
+    @GetMapping("/me")
+    @PreAuthorize("hasAnyAuthority('USER', 'ADMIN', 'SUPER_ADMIN')")
+    public ResponseEntity<TermsAgreementResponse> getMyTermsAgreements(
+            @AuthenticationPrincipal MemberDetails memberDetails) {
+        UUID memberId = memberDetails.getMemberId();
+        TermsAgreementResponse response = termService.getMemberTermsAgreements(memberId);
+        return ResponseEntity.ok(response);
+    }
+
+    @PostMapping("/me")
+    @PreAuthorize("hasAnyAuthority('USER', 'ADMIN', 'SUPER_ADMIN')")
+    public ResponseEntity<Void> saveMyTermsAgreements(
+            @AuthenticationPrincipal MemberDetails memberDetails,
+            @Valid @RequestBody TermsAgreementRequest request) {
+        UUID memberId = memberDetails.getMemberId();
+        termService.saveMemberTermsAgreements(memberId, request);
+        return ResponseEntity.ok().build();
+    }
+}

src/main/java/kr/swyp/backend/term/dto/TermDto.java

@@ -0,0 +1,100 @@
+package kr.swyp.backend.term.dto;
+
+import jakarta.validation.constraints.NotEmpty;
+import jakarta.validation.constraints.NotNull;
+import java.time.LocalDateTime;
+import java.util.List;
+import kr.swyp.backend.member.domain.MemberTermsAgreement;
+import kr.swyp.backend.term.domain.Term;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Getter;
+import lombok.NoArgsConstructor;
+
+public class TermDto {
+
+    @Getter
+    @Builder
+    @NoArgsConstructor
+    @AllArgsConstructor
+    public static class TermResponse {
+
+        private Long termId;
+        private String title;
+        private String version;
+        private Boolean isRequired;
+
+        public static TermResponse fromEntity(Term term) {
+            return TermResponse.builder()
+                    .termId(term.getId())
+                    .title(term.getTitle())
+                    .version(term.getVersion())
+                    .isRequired(term.getIsRequired())
+                    .build();
+        }
+    }
+
+    @Getter
+    @Builder
+    @NoArgsConstructor
+    @AllArgsConstructor
+    public static class TermAgreementRequest {
+
+        @NotNull(message = "약관 ID는 필수입니다.")
+        private Long termId;
+
+        @NotNull(message = "동의 여부는 필수입니다.")
+        private Boolean isAgreed;
+    }
+
+    @Getter
+    @Builder
+    @NoArgsConstructor
+    @AllArgsConstructor
+    public static class TermsAgreementRequest {
+
+        @NotEmpty(message = "약관 동의 목록은 비어있을 수 없습니다.")
+        private List<TermAgreementRequest> agreements;
+    }
+
+    @Getter
+    @Builder
+    @NoArgsConstructor
+    @AllArgsConstructor
+    public static class TermAgreementResponse {
+
+        private Long termId;
+        private String title;
+        private String version;
+        private Boolean isRequired;
+        private Boolean isAgreed;
+        private LocalDateTime agreedAt;
+
+        public static TermAgreementResponse fromEntity(Term term,
+                MemberTermsAgreement agreement) {
+            return TermAgreementResponse.builder()
+                    .termId(term.getId())
+                    .title(term.getTitle())
+                    .version(term.getVersion())
+                    .isRequired(term.getIsRequired())
+                    .isAgreed(agreement != null && agreement.getIsAgreed())
+                    .agreedAt(agreement != null ? agreement.getCreatedAt() : null)
+                    .build();
+        }
+    }
+
+    @Getter
+    @Builder
+    @NoArgsConstructor
+    @AllArgsConstructor
+    public static class TermsAgreementResponse {
+
+        private List<TermAgreementResponse> agreements;
+
+        public static TermsAgreementResponse of(List<TermAgreementResponse> agreements) {
+            return TermsAgreementResponse.builder()
+                    .agreements(agreements)
+                    .build();
+        }
+    }
+}

src/main/java/kr/swyp/backend/term/repository/TermRepository.java

@@ -0,0 +1,10 @@
+package kr.swyp.backend.term.repository;
+
+import java.util.Optional;
+import kr.swyp.backend.term.domain.Term;
+import org.springframework.data.jpa.repository.JpaRepository;
+
+public interface TermRepository extends JpaRepository<Term, Long> {
+
+    Optional<Term> findByTitle(String title);
+}

src/main/java/kr/swyp/backend/term/service/TermService.java

@@ -0,0 +1,26 @@
+package kr.swyp.backend.term.service;
+
+import java.util.List;
+import java.util.UUID;
+import kr.swyp.backend.term.dto.TermDto.TermAgreementResponse;
+import kr.swyp.backend.term.dto.TermDto.TermResponse;
+import kr.swyp.backend.term.dto.TermDto.TermsAgreementRequest;
+import kr.swyp.backend.term.dto.TermDto.TermsAgreementResponse;
+
+public interface TermService {
+
+    /**
+     * 모든 약관 목록 조회.
+     */
+    List<TermResponse> getAllTerms();
+
+    /**
+     * 특정 회원의 약관 동의 상태 조회.
+     */
+    TermsAgreementResponse getMemberTermsAgreements(UUID memberId);
+
+    /**
+     * 회원의 약관 동의 저장/업데이트.
+     */
+    void saveMemberTermsAgreements(UUID memberId, TermsAgreementRequest request);
+}

src/main/java/kr/swyp/backend/term/service/TermServiceImpl.java

@@ -0,0 +1,100 @@
+package kr.swyp.backend.term.service;
+
+import java.util.List;
+import java.util.Map;
+import java.util.NoSuchElementException;
+import java.util.UUID;
+import java.util.stream.Collectors;
+import kr.swyp.backend.member.domain.MemberTermsAgreement;
+import kr.swyp.backend.member.repository.MemberTermsAgreementRepository;
+import kr.swyp.backend.term.domain.Term;
+import kr.swyp.backend.term.dto.TermDto.TermAgreementRequest;
+import kr.swyp.backend.term.dto.TermDto.TermAgreementResponse;
+import kr.swyp.backend.term.dto.TermDto.TermResponse;
+import kr.swyp.backend.term.dto.TermDto.TermsAgreementRequest;
+import kr.swyp.backend.term.dto.TermDto.TermsAgreementResponse;
+import kr.swyp.backend.term.repository.TermRepository;
+import lombok.RequiredArgsConstructor;
+import org.springframework.stereotype.Service;
+import org.springframework.transaction.annotation.Transactional;
+
+@Service
+@RequiredArgsConstructor
+public class TermServiceImpl implements TermService {
+
+    private final TermRepository termRepository;
+    private final MemberTermsAgreementRepository memberTermsAgreementRepository;
+
+    @Override
+    @Transactional(readOnly = true)
+    public List<TermResponse> getAllTerms() {
+        return termRepository.findAll().stream()
+                .map(TermResponse::fromEntity)
+                .collect(Collectors.toList());
+    }
+
+    @Override
+    @Transactional(readOnly = true)
+    public TermsAgreementResponse getMemberTermsAgreements(UUID memberId) {
+        // 모든 약관 조회
+        List<Term> allTerms = termRepository.findAll();
+
+        // 회원의 약관 동의 정보 조회
+        List<MemberTermsAgreement> memberAgreements =
+                memberTermsAgreementRepository.findAllByMemberId(memberId);
+
+        // termId를 키로 하는 Map 생성
+        Map<Long, MemberTermsAgreement> agreementMap = memberAgreements.stream()
+                .collect(Collectors.toMap(
+                        MemberTermsAgreement::getTermsId,
+                        agreement -> agreement
+                ));
+
+        // 모든 약관에 대해 동의 상태를 포함한 응답 생성
+        List<TermAgreementResponse> responses = allTerms.stream()
+                .map(term -> TermAgreementResponse.fromEntity(
+                        term,
+                        agreementMap.get(term.getId())
+                ))
+                .collect(Collectors.toList());
+
+        return TermsAgreementResponse.of(responses);
+    }
+
+    @Override
+    @Transactional
+    public void saveMemberTermsAgreements(UUID memberId, TermsAgreementRequest request) {
+        for (TermAgreementRequest agreementRequest : request.getAgreements()) {
+            // 약관 존재 여부 확인
+            Term term = termRepository.findById(agreementRequest.getTermId())
+                    .orElseThrow(() -> new NoSuchElementException(
+                            "약관을 찾을 수 없습니다. ID: " + agreementRequest.getTermId()));
+
+            // 필수 약관인데 동의하지 않은 경우 예외 발생
+            if (term.getIsRequired() && !agreementRequest.getIsAgreed()) {
+                throw new IllegalArgumentException(
+                        "필수 약관에 동의해야 합니다: " + term.getTitle());
+            }
+
+            // 기존 동의 정보 조회
+            MemberTermsAgreement existingAgreement =
+                    memberTermsAgreementRepository.findByMemberIdAndTermsId(
+                            memberId, agreementRequest.getTermId()
+                    ).orElse(null);
+
+            if (existingAgreement != null) {
+                // 기존 레코드가 있으면 삭제 후 새로 생성 (업데이트)
+                memberTermsAgreementRepository.delete(existingAgreement);
+            }
+
+            // 새로운 동의 정보 저장
+            MemberTermsAgreement newAgreement = MemberTermsAgreement.builder()
+                    .memberId(memberId)
+                    .termsId(agreementRequest.getTermId())
+                    .isAgreed(agreementRequest.getIsAgreed())
+                    .build();
+
+            memberTermsAgreementRepository.save(newAgreement);
+        }
+    }
+}