• 목차

1. 배경

1-1. 프로젝트 목표

자연스럽고 가벼운 소통을 이어가기 위한 비공식 대화 공간을 제공한다.

1-2. 문제 정의

조직 내 대화가 일회성에 그치는 문제를 해결하고, 연결이 지속될 수 있는 공간이 부족했다.

2. 설계 및 기술 자료

2-1. ERD 설계서

Tuning

• DDL 스크립트

2-2. API 명세서

v1

▫️ 시그널 보내기

<aside> <img src="/icons/asterisk_gray.svg" alt="/icons/asterisk_gray.svg" width="40px" />

• 처리 로직

  1. 요청자가 보낼 상대(receiverUserId)와 메시지(message)를 서버에 전달
  2. 서버는 다음을 검증 및 처리
     • receiverUserId에 해당하는 사용자가 탈퇴한 사용자인지 확인
     • 시그널룸(Signal Room)이 새로 생성될 수 있는지 확인
     • 필요한 경우 신규 시그널룸 생성 및 roomId 발급
  3. 성공 시, roomId를 응답으로 반환

• 처리 시 유의사항

  1. 상대방(receiverUserId)이 이미 탈퇴한 사용자라면 시그널 생성 불가
  2. 하나의 요청마다 새로운 시그널룸 생성
  3. 사용자가 보낼 메시지에 대해 메세지 클린봇 도입 (v3)

• 응답 시나리오 (Response)

  201	SIGNAL_ROOM_CREATED	시그널 룸이 정상적으로 생성된 경우
  410	USER_DEACTIVATED	수신 대상 사용자가 탈퇴한 경우

</aside>

▫️ 개인 채널보관함 목록 반환

<aside> <img src="/icons/asterisk_gray.svg" alt="/icons/asterisk_gray.svg" width="40px" />

• 처리 로직

  1. 사용자가 참여하고 있는 채널방 목록을 조회
     1. partnerProfileImage, partnerNickname, lastMessage, lastMessageTime, isRead, relationType 등 정보를 함께 조회
  2. 페이징 처리
     1. 요청된 page, size에 따라 목록을 반환
  3. 참여 중인 채널이 없는 경우 별도 메시지 반환

• 처리 시 유의사항

  1. 응답 데이터에는 각 채널방의 마지막 메시지 정보와 읽음 여부까지 포함
  2. 채널방 목록이 없을 경우 정상 응답(200 OK) + NO_CHANNEL_ROOM 코드로 대응
  3. 페이지네이션에 대한 유효성 검증 필요 (예: page가 음수일 경우 기본값 처리 등)

• 응답 시나리오 (Response)

  200	CHANNEL_ROOM_LIST_FETCHED	채널방 목록 조회 성공
  200	NO_CHANNEL_ROOM	참여 중인 채널이 없는 경우

</aside>