⚙️ [기능추가[관리자] 회원 상세 페이지 추가

[wheemin1]

📝 현재 문제점

• 회원 관리 목록이나 각종 리스트에서 회원 항목을 클릭해도 이동할 회원 상세 페이지가 존재하지 않음
• 특정 회원의 세부 정보(등록 물품, 신고 내역 등)를 한눈에 확인하거나 상태를 관리할 수 있는 화면이 없음

🛠️ 해결 방안 / 제안 기능

• 회원 상세 페이지를 신규 추가하여 아래 정보를 제공
  • 닉네임, 이메일, 가입일 등 기본 정보
  • 해당 회원이 등록한 물품 목록 (판매 중 / 거래 완료 구분)
  • 신고 유무 및 신고 내역
  • 회원 상태 전환 기능 (활성 / 정지 / 탈퇴 등)

⚙️ 작업 내용

• 회원 상세 조회 API 추가 (기본 정보 + 등록 물품 목록 + 신고 내역 포함)
• 회원 상태 전환 API 연동
• 관리자 회원 목록 → 상세 페이지 이동 링크 연결

🙋‍♂️ 담당자

• 백엔드: 이름
• 프론트엔드: 이름
• 디자인: 이름

[github-actions]

Chuseok22 Issue Helper

브랜치명

20260226_#551_회원_상세_페이지_추가

커밋 메시지

회원_상세_페이지_추가 : feat : {변경 사항에 대한 설명} https://github.com/TEAM-ROMROM/RomRom-BE/issues/551

[Cassiiopeia]

[관리자] 회원 상세 페이지 추가

이슈: #551

---

📌 작업 개요

관리자 페이지에서 특정 회원의 상세 정보를 확인할 수 없던 문제를 해결하기 위해 회원 상세 조회 API와 상태 전환 API를 추가. 기본 정보, 등록 물품 목록, 신고 내역을 하나의 응답으로 제공하며, 계정 상태 변경(활성/정지/탈퇴 등)도 지원.

---

🎯 구현 목표

• 회원 상세 조회 API: 기본 정보 + 전체 등록 물품 목록 + 신고당한 내역 통합 제공
• 회원 상태 전환 API: AccountStatus enum 기반 계정 상태 변경
• 기존 Admin API 컨벤션(AdminRequest/AdminResponse 단일 DTO 패턴) 준수

---

✅ 구현 내용

1. AdminRequest - 회원 관련 필드 추가

• 파일: RomRom-Common/src/main/java/com/romrom/common/dto/AdminRequest.java
• 변경 내용:
  • memberId (UUID): 상세 조회 및 상태 변경 시 대상 회원 식별자
  • accountStatus (AccountStatus): 변경할 계정 상태값 (ACTIVE, SUSPENDED, DELETED 등)
• 이유: 단일 Request DTO로 회원 관련 모든 Admin 액션을 처리하는 컨벤션 준수

2. AdminResponse - 회원 상세 DTO 추가

• 파일: RomRom-Common/src/main/java/com/romrom/common/dto/AdminResponse.java
• 변경 내용:
  • memberDetail 필드 (AdminMemberDetailDto 타입): 회원 상세 조회 결과를 담는 전용 필드
  • AdminMemberDetailDto 내부 클래스 신규 추가:
    • member (Member Entity): 회원 기본 정보 (Entity 직접 포함)
    • items (List<Item>): 삭제되지 않은 전체 등록 물품 목록
    • memberReports (List<MemberReport>): 신고당한 내역 목록 (신고자, 사유 포함)
    • reportCount (Long): 신고 총 건수
• 이유: Entity 직접 응답 원칙 준수, 상세 정보를 하나의 객체로 구조화

3. ItemRepository - 회원별 물품 조회 메서드 추가

• 파일: RomRom-Domain-Item/src/main/java/com/romrom/item/repository/postgres/ItemRepository.java
• 변경 내용:
  • findByMemberAndIsDeletedFalseOrderByCreatedDateDesc(Member member): 삭제되지 않은 물품을 최신순으로 조회
• 이유: 관리자 상세 조회에서 해당 회원의 전체 등록 물품(FOR_SALE/RESERVED/SOLD_OUT 모두 포함)을 최신순으로 가져오기 위한 전용 메서드

4. MemberReportRepository - 특정 회원 신고 내역 조회 메서드 추가

• 파일: RomRom-Domain-Report/src/main/java/com/romrom/report/repository/MemberReportRepository.java
• 변경 내용:
  • findByTargetMemberOrderByCreatedDateDesc(Member targetMember): @EntityGraph로 targetMember, reporter, memberReportReasons 연관 관계 즉시 로딩, 최신순 정렬
  • countByTargetMember(Member targetMember): 특정 회원에 대한 신고 건수 카운트
• 이유: N+1 문제 방지를 위해 @EntityGraph로 필요한 연관 데이터 한 번에 로딩

5. MemberService - 회원 상세 조회 및 상태 변경 서비스 메서드 추가

• 파일: RomRom-Domain-Member/src/main/java/com/romrom/member/service/MemberService.java
• 변경 내용:
  • getMemberDetailForAdmin(AdminRequest): memberId로 회원 조회 후 물품 목록, 신고 내역, 신고 건수를 AdminMemberDetailDto로 묶어 반환
  • updateMemberStatusForAdmin(AdminRequest): memberId로 회원 조회 후 accountStatus 값으로 상태 변경 및 저장, 변경된 회원 정보 반환
• 이유: 트랜잭션 단위 및 의존성 관리를 위해 서비스 레이어에서 Repository 조합 처리

6. AdminApiController - 회원 상세/상태 변경 엔드포인트 추가

• 파일: RomRom-Web/src/main/java/com/romrom/web/controller/api/AdminApiController.java
• 변경 내용:
  • POST /api/admin/members/detail (multipart/form-data): memberId 파라미터로 회원 상세 조회
  • POST /api/admin/members/status (multipart/form-data): memberId + accountStatus 파라미터로 상태 변경
• 이유: Admin API의 multipart/form-data 기반 POST 패턴 통일, @LogMonitor로 로그 추적 적용

---

🔧 주요 변경사항 상세

회원 상세 조회 흐름

POST /api/admin/members/detail
  → AdminApiController.getMemberDetail()
  → MemberService.getMemberDetailForAdmin()
    → MemberRepository.findById(memberId)
    → ItemRepository.findByMemberAndIsDeletedFalseOrderByCreatedDateDesc(member)
    → MemberReportRepository.findByTargetMemberOrderByCreatedDateDesc(member)
    → MemberReportRepository.countByTargetMember(member)
  → AdminResponse { memberDetail: { member, items, memberReports, reportCount } }

회원 상태 변경 흐름

POST /api/admin/members/status
  → AdminApiController.updateMemberStatus()
  → MemberService.updateMemberStatusForAdmin()
    → MemberRepository.findById(memberId)
    → member.setAccountStatus(accountStatus)
    → MemberRepository.save(member)
  → AdminResponse { member: 변경된 회원 정보 }

@entitygraph 적용 이유

MemberReportRepository의 findByTargetMemberOrderByCreatedDateDesc에 @EntityGraph를 적용하여 targetMember, reporter, memberReportReasons를 즉시 로딩. 신고 목록 조회 시 연관 엔티티마다 별도 쿼리가 발생하는 N+1 문제를 방지.

---

🧪 테스트 및 검증

• 특정 회원의 상세 조회 시 기본 정보, 등록 물품, 신고 내역이 모두 포함되는지 확인
• 삭제된 물품(isDeleted = true)은 목록에서 제외되는지 확인
• accountStatus 변경 후 응답에 변경된 상태가 반영되는지 확인
• 신고 내역이 없는 회원 조회 시 빈 목록과 reportCount = 0 반환 확인

---

📌 참고사항

• 물품 목록은 ItemStatus 필터 없이 전체(FOR_SALE / RESERVED / SOLD_OUT) 포함 반환
• 회원 상태 변경은 AccountStatus enum 값에 따라 처리되며, 유효하지 않은 값 전달 시 바인딩 오류 발생
• 기존 getMembersForAdmin(목록)과 getMemberDetailForAdmin(상세) 엔드포인트가 분리되어 있으므로 목록 → 상세 페이지 이동 시 memberId 전달 필요

[Cassiiopeia]

@suh-lab test build

[github-actions]

❌ Issue Preview 배포 실패!

브랜치: 20260226_#551_회원_상세_페이지_추가

단계	상태	소요 시간
🔨 프로젝트 빌드	❌ 실패	-
🐳 Docker 이미지 생성	⏸️ 대기	-
🚀 서버 배포 & Health Check	⏸️ 대기	-

📋 빌드/배포 로그 확인

🔍 가능한 원인

• Gradle 빌드 실패
• Docker 이미지 빌드 실패
• 컨테이너 시작 실패 (Spring Boot 기동 오류)
• Health Check 타임아웃 (120초 내 기동 완료 안됨)

💡 다음 단계

1. 위 링크에서 빌드/배포 로그를 확인하세요
2. 문제를 수정한 후 다시 시도하세요: @suh-lab test build

---

🤖 이 댓글은 Issue Preview 시스템에 의해 자동 생성되었습니다.

[Cassiiopeia]

[관리자] 회원 상세 페이지 추가

이슈: #551

📌 작업 개요

관리자 페이지에서 특정 회원의 상세 정보를 확인할 수 없던 문제 해결. 회원 상세 조회 API와 계정 상태 전환 API를 추가하여 기본 정보 · 등록 물품 목록 · 신고 내역을 하나의 응답으로 통합 제공.

기존 AdminRequest / AdminResponse가 RomRom-Common 모듈에 위치하면서 Member, Item, MemberReport Entity를 직접 참조하는 의존성 문제도 함께 해결. DTO를 RomRom-Application 모듈로 이전하고, Admin 관련 서비스 로직을 Application 레이어로 분리.

---

🎯 구현 목표

• 회원 상세 조회 API: 기본 정보 + 전체 등록 물품 목록 + 신고당한 내역 통합 제공
• 회원 상태 전환 API: AccountStatus enum 기반 계정 상태 변경
• 모듈 의존성 구조 정상화: Common → Application 레이어로 Admin DTO/서비스 이전

---

✅ 구현 내용

1. AdminRequest / AdminResponse — Common → Application 모듈 이전

• 이전 위치: RomRom-Common/src/main/java/com/romrom/common/dto/
• 신규 위치: RomRom-Application/src/main/java/com/romrom/application/dto/
• 이유: Common 모듈은 도메인 모듈에 의존할 수 없는 구조. Member, Item, MemberReport Entity를 직접 참조하려면 이 모든 도메인에 의존 가능한 Application 레이어에 위치해야 함

AdminRequest 변경사항

• memberId (UUID): 상세 조회 및 상태 변경 대상 회원 식별자 추가
• accountStatus (AccountStatus): 변경할 계정 상태값 추가
• password 필드에 @ToString.Exclude 적용 — 로그에 비밀번호 노출 방지

AdminResponse 변경사항

• AdminMemberDetailDto 내부 클래스 추가
  • member (Member Entity): 회원 기본 정보
  • items (List<Item>): 삭제되지 않은 전체 등록 물품 목록
  • memberReports (List<MemberReport>): 신고당한 내역
  • reportCount (Long): 신고 총 건수
• Page<Member> members / Page<Item> items: 기존 중간 DTO(AdminMemberDto, AdminItemDto) 제거 → Entity 직접 사용으로 전환 (프로젝트 컨벤션 준수)

2. AdminMemberService — 신규 생성 (Application 레이어)

• 파일: RomRom-Application/src/main/java/com/romrom/application/service/AdminMemberService.java
• getMembersForAdmin: 키워드 검색 + 페이지네이션, Page<Member> 직접 반환
• getRecentMembersForAdmin: 대시보드용 최근 가입 회원 조회
• getMemberDetailForAdmin: 회원 기본 정보 + 등록 물품 + 신고 내역 통합 조회. reportCount는 memberReports.size()로 산출하여 별도 count 쿼리 제거
• updateMemberStatusForAdmin: AccountStatus 변경 및 저장

3. AdminItemService — 신규 생성 (Application 레이어)

• 파일: RomRom-Application/src/main/java/com/romrom/application/service/AdminItemService.java
• getItemsForAdmin: 다중 조건 필터링 + 페이지네이션, Page<Item> 직접 반환
• getRecentItemsForAdmin: 대시보드용 최근 등록 물품 조회
• totalCount는 itemPage.getTotalElements() 사용 (기존 itemRepository.count() 버그 수정)
• ItemImageRepository 의존 제거 — Item Entity에 @OneToMany itemImages 있으므로 별도 조회 불필요, N+1 문제 해소

4. AdminAuthService — Domain-Auth → Application 레이어 이전

• 이전 위치: RomRom-Domain-Auth/src/main/java/com/romrom/auth/service/AdminAuthService.java
• 신규 위치: RomRom-Application/src/main/java/com/romrom/application/service/AdminAuthService.java
• @Transactional → @Transactional(readOnly = true) 전환 (DB 쓰기 없음)
• 인증 순서 수정: 역할 체크 → 비밀번호 검증 순에서 비밀번호 검증 → 역할 체크 순으로 변경 (정보 노출 최소화)
• logout(): 예외 삼킴(catch Exception) 제거 → 명확한 예외 전파, 파라미터 accessToken → refreshToken으로 수정

5. MemberService / ItemService — Admin 관련 메서드 제거

• 파일: RomRom-Domain-Member/src/main/java/com/romrom/member/service/MemberService.java
• 파일: RomRom-Domain-Item/src/main/java/com/romrom/item/service/ItemService.java
• Admin 서비스 로직을 Application 레이어로 이전하면서 기존 도메인 서비스의 Admin 메서드 제거. 순환 의존성 방지

6. ItemRepository — 회원별 물품 조회 메서드 추가

• 파일: RomRom-Domain-Item/src/main/java/com/romrom/item/repository/postgres/ItemRepository.java
• findByMemberAndIsDeletedFalseOrderByCreatedDateDesc(Member member): 삭제되지 않은 전체 물품을 최신순 조회

7. MemberReportRepository — 신고 내역 조회 메서드 추가

• 파일: RomRom-Domain-Report/src/main/java/com/romrom/report/repository/MemberReportRepository.java
• findByTargetMemberOrderByCreatedDateDesc(Member targetMember): @EntityGraph로 targetMember, reporter, memberReportReasons 즉시 로딩, N+1 방지

8. AdminApiController — 엔드포인트 추가 및 개선

• 파일: RomRom-Web/src/main/java/com/romrom/web/controller/api/AdminApiController.java
• POST /api/admin/members/detail (multipart/form-data): 회원 상세 조회
• POST /api/admin/members/status (multipart/form-data): 계정 상태 변경
• login() try-catch 제거 → GlobalExceptionHandler 위임
• setSecure() 하드코딩 제거 → @Value("${server.ssl.enabled:false}") 기반 동적 설정
• 쿠키명 통일: accessToken, refreshToken, authStatus

9. AdminPageController — 쿠키명 수정

• 파일: RomRom-Web/src/main/java/com/romrom/web/controller/view/AdminPageController.java
• adminAccessToken / adminRefreshToken → accessToken / refreshToken 통일
• authStatus 쿠키 삭제 처리 추가

---

🔧 주요 변경사항 상세

모듈 의존성 구조 개선

[AS-IS]
RomRom-Common (AdminRequest, AdminResponse)
  └─ Member, Item, MemberReport Entity 직접 참조 → 컴파일 불가

[TO-BE]
RomRom-Application (AdminRequest, AdminResponse, AdminMemberService, AdminItemService, AdminAuthService)
  └─ Domain-Member, Domain-Item, Domain-Report에 모두 의존 가능 → 정상 컴파일

회원 상세 조회 흐름

POST /api/admin/members/detail
  → AdminApiController.getMemberDetail()
  → AdminMemberService.getMemberDetailForAdmin()
    → MemberRepository.findById(memberId)
    → ItemRepository.findByMemberAndIsDeletedFalseOrderByCreatedDateDesc(member)
    → MemberReportRepository.findByTargetMemberOrderByCreatedDateDesc(member)  // @EntityGraph
  → AdminResponse { memberDetail: { member, items, memberReports, reportCount } }

Entity 직접 반환 원칙 준수

기존 코드에서 AdminMemberDto, AdminItemDto로 변환하던 방식을 제거. Page<Member>, Page<Item> Entity 직접 반환으로 전환. 불필요한 중간 매핑 코드 제거 및 프로젝트 컨벤션 일관성 확보.

---

🧪 테스트 및 검증

• 특정 회원 상세 조회 시 기본 정보 · 등록 물품 · 신고 내역 모두 포함 확인
• 삭제된 물품(isDeleted = true) 목록 제외 확인
• accountStatus 변경 후 응답에 변경된 상태 반영 확인
• 신고 내역 없는 회원 조회 시 빈 목록 + reportCount = 0 반환 확인
• 비밀번호 오류 시 INVALID_CREDENTIALS, 관리자 권한 없을 시 UNAUTHORIZED 반환 확인

---

📌 참고사항

• 물품 목록은 ItemStatus 필터 없이 전체(FOR_SALE / RESERVED / SOLD_OUT) 포함 반환
• reportCount는 별도 count 쿼리 없이 memberReports.size()로 산출
• setSecure는 server.ssl.enabled 환경 변수 기반으로 설정되므로 로컬(HTTP)에서도 쿠키 정상 동작