⚙️[기능추가][관리자] 대시보드 최근 목록 클릭 기능 추가

[wheemin1]

📝 현재 문제점

• 관리자 대시보드의 최근 가입 회원 목록과 최근 등록 물품 목록이 단순 나열만 되어 있어 클릭 시 아무런 동작이 없음
• 각 항목을 클릭했을 때 알맞은 상세 페이지로 이동하는 기능이 없어 관리 편의성이 떨어짐

🛠️ 해결 방안 / 제안 기능

• 최근 가입 회원 목록의 항목 클릭 시 → 회원 상세 페이지로 이동
• 최근 등록 물품 목록의 항목 클릭 시 → 물품 상세(글) 페이지로 이동

⚙️ 작업 내용

• 대시보드 최근 가입 회원 리스트 항목에 회원 상세 페이지 링크 연결
• 대시보드 최근 등록 물품 리스트 항목에 물품 상세 페이지 링크 연결

🙋‍♂️ 담당자

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

[github-actions]

Chuseok22 Issue Helper

브랜치명

20260227_#552_대시보드_최근_목록_클릭_기능_추가

커밋 메시지

대시보드_최근_목록_클릭_기능_추가 : feat : {변경 사항에 대한 설명} https://github.com/TEAM-ROMROM/RomRom-BE/issues/552

[Cassiiopeia]

📌 작업 개요

관리자 대시보드의 최근 가입 회원 목록 및 최근 등록 물품 목록 항목 클릭 시 상세 페이지로 이동할 수 있도록 백엔드 단건 조회 API 추가.
POST /api/admin/members/detail, POST /api/admin/items/detail 두 엔드포인트를 신규 구현하여 프론트엔드에서 ID 기반 상세 조회 가능하도록 지원.

---

🎯 구현 목표

• 대시보드 최근 가입 회원 항목 클릭 → 회원 단건 상세 조회 API 연결
• 대시보드 최근 등록 물품 항목 클릭 → 물품 단건 상세 조회 API 연결

---

✅ 구현 내용

관리자용 회원 단건 조회 API 추가

• 파일: RomRom-Domain-Member/src/main/java/com/romrom/member/service/MemberService.java
• 변경 내용: getMemberDetailForAdmin(AdminRequest) 메서드 추가. memberId로 회원 Entity 조회 후 AdminResponse.member에 직접 담아 반환
• 이유: 대시보드 최근 가입 회원 목록에서 특정 회원 클릭 시 상세 정보를 반환할 서비스 로직 필요

관리자용 물품 단건 조회 API 추가

• 파일: RomRom-Domain-Item/src/main/java/com/romrom/item/service/ItemService.java
• 변경 내용: getItemDetailForAdmin(AdminRequest) 메서드 추가. itemId로 물품 Entity 조회 후 AdminResponse.item에 직접 담아 반환
• 이유: 대시보드 최근 등록 물품 목록에서 특정 물품 클릭 시 상세 정보를 반환할 서비스 로직 필요

Controller 엔드포인트 연결

• 파일: RomRom-Web/src/main/java/com/romrom/web/controller/api/AdminApiController.java
• 변경 내용: POST /members/detail, POST /items/detail 엔드포인트 추가. 모두 MULTIPART_FORM_DATA_VALUE + @ModelAttribute 패턴 준수
• 이유: 프로젝트 전체 POST API 컨벤션에 맞춰 일관성 있게 엔드포인트 노출

Swagger 문서 추가

• 파일: RomRom-Web/src/main/java/com/romrom/web/controller/api/AdminApiControllerDocs.java
• 변경 내용: 두 단건 조회 API에 대한 @ApiChangeLog(issueNumber = 552) 및 @Operation 문서 추가
• 이유: API 변경 이력 관리 및 Swagger UI에서 파라미터/반환값 명세 제공

---

🔧 주요 변경사항 상세

getMemberDetailForAdmin (MemberService)

memberId(UUID) 기반으로 memberRepository.findById 호출. 존재하지 않으면 MEMBER_NOT_FOUND 에러 발생.
프로젝트 Response 원칙에 따라 Entity → DTO 변환 없이 Member Entity를 AdminResponse.member에 직접 담아 반환.

getItemDetailForAdmin (ItemService)

itemId(UUID) 기반으로 itemRepository.findById 호출. 존재하지 않으면 ITEM_NOT_FOUND 에러 발생.
Item Entity를 AdminResponse.item에 직접 담아 반환 (Entity 직접 반환 원칙 적용).

AdminResponse DTO

item (단건 물품), member (단건 회원) 필드가 단건 조회 응답 데이터로 활용됨.
기존 목록 조회용 items, members (Page) 필드와 구분하여 단건 조회 전용으로 사용.

특이사항:

• getRecentMembersForAdmin의 lastLoginDate 필드는 임시로 member.getUpdatedDate()를 사용 (실제 로그인 시각 필드 추가 시 교체 필요)
• 단건 조회 API는 삭제 여부(isDeleted) 필터링 없이 raw Entity를 반환하므로, 삭제된 항목도 ID가 있으면 조회됨 — 운영 정책에 따라 확인 필요

---

🧪 테스트 및 검증

• POST /api/admin/members/detail — memberId (UUID) 전달 시 회원 Entity 반환 확인
• POST /api/admin/items/detail — itemId (UUID) 전달 시 물품 Entity 반환 확인
• 존재하지 않는 ID 전달 시 MEMBER_NOT_FOUND / ITEM_NOT_FOUND 에러 반환 확인
• Swagger UI에서 @ApiChangeLog(issueNumber = 552) 문서 노출 확인

---

📌 참고사항

• 이슈 #552는 백엔드 API 추가까지만 해당하며, 프론트엔드 링크 연결 작업은 별도 진행
• lastLoginDate는 추후 실제 로그인 시각 컬럼 확보 시 수정 필요

[Cassiiopeia]

@suh-lab test build

[github-actions]

❌ Issue Preview 배포 실패!

브랜치: 20260227_#552_대시보드_최근_목록_클릭_기능_추가

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

📋 빌드/배포 로그 확인

🔍 가능한 원인

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

💡 다음 단계

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

---

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