📌 요구사항 명세서 ️

1. 서비스별 요구사항

1.1. 사용자 서비스 (User Service)

요구사항 ID	요구사항 내용	우선순위	담당자	상태
US-001	User / Owner
회원가입	높음 ⬆️	윤하준, 이도현	완료 ✅	ADMIN 계정은 미리 생성
US-002	User/Owner
로그인/로그아웃 기능	높음 ⬆️	윤하준, 이도현	완료 ✅	-
US-003	정보 수정 기능 (닉네임 수정, 비밀번호 수정)/
(가게 정보 수정, 가게상호, 주소, 가게전화번호)	높음 ⬆️	윤하준, 김예은	완료 ✅	1.
회원 비밀번호 수정시 기존 비밀번화 확인 로직 필요.

RST-002, RST-003, RST-004, RST-005 참조 | | US-004 | 사용자 리뷰 내역 조회 기능 | 높음 ⬆️ | 윤하준, 이도현 | 완료 ✅ | RS-02 참조 | | US-005 | 사용자 리뷰 수정 및 삭제 기능 | 높음 ⬆️ | 윤하준, 이도현 | 완료 ✅ | RS-02 참조, RS-02 참조 | | US-006 | 회원탈퇴 기능 | 중간 | 윤하준 | pending ❌ | 회원 탈퇴시 다른 서비스의 로직들이 많이 얽혀 있기에 추후 진행 예정. | | US-007 | 사용자 위치 정보 기반 식당 검색 기능 | 낮음 | 윤하준, 이도현 | pending ❌ | 추후 진행 예정 |

1.2. 식당 서비스 (Restaurant Service)

요구사항 ID	요구사항 내용	우선순위	담당자	상태
RST-001	상점 등록	높음 ⬆️	김예은	완료 ✅
RST-002	상점 수정	높음 ⬆️	김예은, 이도현	완료 ✅
RST-003	사용자 상점 상세 조회	높음 ⬆️	김예은	완료 ✅
RST-004	상점 삭제	높음 ⬆️	김예은	완료 ✅
RST-005	상점 리스트	높음 ⬆️	김예은	완료 ✅
RST-006	상점 검색	높음 ⬆️	김예은	완료 ✅

1.3. 리뷰 서비스 (Review Service)

요구사항 ID	요구사항 내용	우선순위	담당자	상태
RS-01	사용자 리뷰 작성(별점, 사진 업로드 포함)	높음 ⬆️	이도현, 윤하준	완료 ✅
RS-02	사용자 리뷰 조회	높음 ⬆️	이도현	완료 ✅
RS-03	사용자 리뷰 수정	높음 ⬆️	이도현	완료 ✅
RS-04	사용자 리뷰 삭제	높음 ⬆️	이도현	완료 ✅
RS-05	리뷰에 사용자 프로필 사진, 뱃지 표현	높음 ⬆️	이도현, 신현국
RS-06	리뷰에 사용자 리뷰 개수 표시	중간	이도현	완료 ✅
RS-07	리뷰 작성 날짜 표시	중간	이도현	완료 ✅
RS-08	사용자 리뷰 작성 시 포인트 증가 요청	높음 ⬆️	이도현, 윤하준	완료 ✅
RS-09	가게 별 리뷰 개수, 평균 별점 통계 계산	중간	이도현	완료 ✅

1.4. 포인트 서비스 (Point Service)

요구사항 ID	요구사항 내용	우선순위	담당자	상태	비고
PS-001	사용자 포인트 기반 적절한 배지 부여	높음 ⬆️	신현국	완료 ✅	assignBadge 내부 로직 기반
PS-002	Role에 따라서 배지 부여	높음 ⬆️	신현국	완료 ✅	운영자는 “운영자” 배지 부여
PS-003	댓글 등 사용자 이름 옆에 표시할 배지 아이콘 정보 제공	높음 ⬆️	신현국	완료 ✅	getUserBadgeByUserId 이용
PS-004	사용자 배지 진행도 및 다음 티어까지 남은 포인트 계산 기능	보통 ⬆️	신현국	완료 ✅	getBadgeProgress API
PS-005	사용자 ID로 현재 부여된 배지 상세 정보 조회	보통 ⬆️	신현국	완료 ✅	getUserBadge API
PS-006	유효하지 않은 배지 요청 시 예외 처리 및 메시지 반환	보통 ⬆️	신현국	완료 ✅	try-catch + HttpStatus 사용
PS-007	배지 히스토리 저장(배지 변경 시마다 기록 남기기)	중간 ⬆️	신현국	Pending❌	테이블 하나 추가하고 저장만 해도 OK
PS-008	마이페이지에 내가 받은 배지 이력 보여주기	보통 ⬆️	신현국	Pending❌	프론트에서 리스트로 보여주면 끝
PS-009	배지 레벨/아이콘/설명 CRUD용 관리자 API 만들기	보통 ⬆️	신현국	Pending❌	Postman으로 테스트 가능

📌 API 명세서

2. 서비스 별 API 명세서

2.1. 사용자 서비스(User Service) API

이름	URL	메서드	인증	설명
회원가입	POST `/user-service/users/signup`	POST	❌	사용자 계정 생성
로그인	POST `/user-service/user/login`	POST	❌	JWT 토큰 발급
토큰 리프레쉬	POST `/user-service/user/refresh`	POST	✅
회원 리스트 전달	POST `/users`	POST	✅	파라미터(userIds)가 들어오면 해당하는 유저 리스트 전달
회원 정보 전달	GET `/users`	GET	✅	파라미터(이메일)로 해당 유저정보 전달
회원 포인트 조회	GET `/user/{userId}/point`	GET	✅	회원 포인트 조회
프로필 사진 등록 및 수정	POST `/user/profile`	POST	✅	회원 프로필 사진 등록 및 수정
회원 정보 수정	PUT `/user/update-info`	PUT	✅	회원 닉네임 및
비밀번호 수정
회원 포인트 추가	PUT `/users/point`	PUT	✅	파라미터(userId, point)들어오면 매칭 후 증가

회원가입
로그인
토큰 리프레시
회원 리스트 조회
회원 정보 조회
회원 포인트 조회