추가 기능 – 참여 승인제 + 알림 연동 명세서 (Group V2 기준)

[claudia99503]

참여 승인제 도입을 위한 API 수정 / 추가 정리 (Group V2 기준)

본 문서는 Group V2 API를 기준으로
모임 참여 승인제 및 알림 연동을 도입하기 위해
필요한 API 수정 및 신규 API 항목을 간단히 정리합니다.

---

1. 모임 생성 API 수정

POST /api/v2/groups/create

추가 필요

• joinPolicy 필드 추가

값 정의

• FREE
  기존 방식과 동일하게 승인 없이 즉시 참여
• APPROVAL_REQUIRED
  방장 승인 후 참여 확정

{
  "joinPolicy": "APPROVAL_REQUIRED"
}

---

2. 모임 참가 API 분기 처리

POST /api/v2/groups/{groupId}/attend

동작 분기

• joinPolicy = FREE

  • 기존과 동일
  • 즉시 ATTEND 상태로 참가 처리

• joinPolicy = APPROVAL_REQUIRED

  • 즉시 참여되지 않음
  • 프론트에서 참여 요청 모달을 노출
  • 모달에서 한 줄 메시지(introMessage) 입력 후 제출
  • 참가자 상태를 PENDING 으로 생성
  • 참여 요청 알림이 방장에게 전송됨

---

3. 참가자 상태 확장

GroupUser / Membership 도메인

상태 추가

• PENDING : 승인 대기
• REJECTED : 승인 거절

정책

• ATTEND 상태만 participantCount에 포함
• PENDING, REJECTED 상태는 인원 수에 포함하지 않음

---

4. 참여 승인 처리 API 추가

POST /api/v2/groups/{groupId}/join-requests/{groupUserId}/approve
POST /api/v2/groups/{groupId}/join-requests/{groupUserId}/reject

정책

• 방장 전용

상태 변경

• 승인: PENDING → ATTEND
• 거절: PENDING → REJECTED

---

5. 참여 승인 전용 페이지 조회 API 추가

GET /api/v2/groups/{groupId}/join-requests

정책

• 방장 전용

응답

• PENDING 상태의 신청자 목록
• 신청자별 introMessage

---

6. 알림 API 연동

• 참여 요청 발생 시

  • 알림 타입: GROUP_JOIN_REQUEST
  • 수신자: 방장

• 승인 시

  • 알림 타입: GROUP_JOIN_APPROVED
  • 수신자: 신청자

• 거절 시

  • 알림 타입: GROUP_JOIN_REJECTED
  • 수신자: 신청자

• 참여 요청 알림은 신청자별로 생성되며,
  어떤 알림을 선택하더라도 참여 승인 전용 페이지로 이동하여
  해당 모임의 전체 참여 신청자 목록과 사용자별 한 줄 메시지를 확인하고
  승인 또는 거절을 처리할 수 있다.

---

7. 모임 목록 / 내 모임 목록 응답 정책 (모임 상세 페이지 포함)

GET /api/v2/groups
GET /api/v2/groups/me

• myMembership.status = PENDING 상태 유지
• 프론트엔드에서 대기중 뱃지 노출 가능

---

요약

• 생성: joinPolicy 추가
• 참가: ATTEND / PENDING 분기
• 승인제 모임 참여 시 프론트에서 참여 요청 모달 노출 및 한 줄 메시지 제출
• 상태: PENDING, REJECTED 추가
• 승인 / 거절 처리 API 추가
• 승인 요청 조회 API 추가
• 알림 타입 확장
• 목록 API는 상태값 활용

[claudia99503]

결론 요약

• 모임 생성

  • 승인제 없는 기본형 모임 (즉시 참여, 기존 방식)
  • 승인제 있는 모임 (방장 승인 후 참여 확정)

• 승인제 모임의 경우

  • 참여 요청 시 승인 대기 상태(PENDING)로 관리
  • 참여 요청 시 프론트에서 참여 요청 모달을 노출하고, 한 줄 메시지 입력 후 제출
  • 모임 목록, 모임 상세, 내 모임 목록에서 대기중 상태 뱃지 노출
  • 참여 요청 알림은 신청자별로 생성되며, 알림 선택 시 참여 승인 전용 페이지로 이동
  • 참여 승인 전용 페이지에서 해당 모임의 전체 참여 신청자 목록과 사용자별 한 줄 메시지를 확인하고 수락 또는 거절 처리 가능

• 알림

  • 참여 요청 발생 시 방장에게 알림 전달
  • 승인 또는 거절 처리 시 신청자에게 결과 알림 전달