메인 홈으로Project Case Study

폐쇄형 메타버스 SNS, WOOMS

소규모 그룹 안에서 편지, 사진, 방명록, 라디오로 추억을 저장하는 폐쇄형 메타버스 SNS

진행 기간2024.07.08 ~ 2024.08.16 (7주)
수행 역할프론트엔드 개발
인원 구성6명 (프론트엔드 3명, 백엔드 3명)
개발 도구
ReactJavaScriptRedux

사용 기술 스택 (Tech Stack)

ReactJavaScriptReduxReact RouterAxiosTailwind CSS

주요 기능 및 수행 항목

  • ✓모달 위 알림이 가려지는 문제를 별도 렌더링 영역으로 분리하여 홈/그룹 공간 전역 알림 노출 안정화
  • ✓편지 작성 단계 이동 시 입력값이 사라지는 문제를 작성 흐름 상위 상태로 관리하여 편지 작성 경험 개선
  • ✓일반 로그인과 OAuth 로그인 완료 후 사용자 정보를 동일한 인증 흐름으로 정리하여 로그인/세션 관리 안정화
  • ✓로그인, 회원가입, 비밀번호 재설정, 내 정보 수정 기능 구현
  • ✓편지 작성, 조회, 삭제, 읽지 않은 편지 수 조회 기능 구현
  • ✓홈/그룹 공간 BGM 자동 재생 및 재생 상태 유지 기능 구현
  • ✓서비스 소개, 주요 기능 안내, 로그인 이동을 포함한 기본 홈페이지 기능 구현

심층 트러블슈팅 케이스 분석

윤대영 개발자가 직접 고민하고 구조적으로 돌파해낸 대표적 문제 해결 사례입니다.

Case 1

홈/그룹 공간 위 전역 알림이 가려지는 문제 해결

문제 상황 & 원인 (Problem & Cause)

홈 화면, 그룹 화면, 전역 알림 레이어가 중첩된 구조에서 화면 내부 z-index 조정만으로는 컴포넌트 종속성과 브라우저 렌더링 컨텍스트 영향으로 알림 위치 최상단 보장 및 안정적 제어가 불가능했습니다.

해결 과정 & 아키텍처 변경 (Solution)

index.html에 앱 루트와 완전히 분리된 portal-root DOM을 추가하고, React Portal을 도입하여 Alert 컴포넌트가 최상위 DOM 노드에서 직접 렌더링되도록 렌더링 레이어를 계층적으로 분리했습니다.

최종 적용 결과 (Result)

홈/그룹 공간 내부 z-index 충돌과 관계없이 로그인 실패, 편지 전송 완료 등의 공통 알림이 최상단에 안정적으로 노출되도록 개선했습니다.

아키텍처 및 화면 설계 흐름도
홈/그룹 공간 위 전역 알림이 가려지는 문제 해결
Case 2

편지 작성 중 단계 이동 시 입력값이 유실되는 문제 해결

문제 상황 & 원인 (Problem & Cause)

수신자 선택, 내용 작성, 도착 날짜 선택의 단계별 컴포넌트 내부에서만 로컬 state를 관리하여, 유저가 단계 전환(다음/이전)을 진행할 때 하위 컴포넌트가 언마운트되며 입력되었던 서신 데이터가 초기화되는 문제가 발생했습니다.

해결 과정 & 아키텍처 변경 (Solution)

편지 작성 흐름 전체를 관장하는 최상위 부모 컴포넌트인 WriteLetterMain으로 selectedUser, content, selectedDate 상태를 끌어올리고(Lifting State Up), 각 자식 컴포넌트에 상태 및 onChange 콜백을 주입해 데이터를 중앙 보존했습니다.

최종 적용 결과 (Result)

단계 전환 및 이탈 후 복귀 시에도 입력 필드 상태가 안정적으로 회복되어 사용자 중심의 단계별 작성 흐름을 안정적으로 확보했습니다.

아키텍처 및 화면 설계 흐름도
편지 작성 중 단계 이동 시 입력값이 유실되는 문제 해결
Case 3

로그인 방식별 인증 완료 흐름 분산 문제 해결

문제 상황 & 원인 (Problem & Cause)

일반 로그인(POST API)과 소셜 OAuth 로그인(Redirect 콜백 방식)의 인증 진입 및 복귀 포인트가 달라 사용자 세션 저장, 프로필 조회, 화면 리다이렉트 흐름이 분산되고 코드 중복과 세션 일관성 결여 문제가 잠재했습니다.

해결 과정 & 아키텍처 변경 (Solution)

로그인 방식과 무관하게 로그인이 완료된 직후 사용자 정보를 받아와 전역 인증 스토어의 상태를 일관되게 갱신 및 유지하는 단일 후처리 파이프라인으로 통일했습니다.

최종 적용 결과 (Result)

세션 가드, 상단 네비게이션바, 프로필 수정 등 로그인 판단 기준을 일원화하여 세션 동기화 결함을 원천 방어했습니다.

아키텍처 및 화면 설계 흐름도
로그인 방식별 인증 완료 흐름 분산 문제 해결