← 포트폴리오 목록
실버케어 패밀리 케어허브
실버케어 매칭 CRM을 확장해 보호자·선생님·관리자가 함께 쓰는 재활 진행 피드, 실시간 채팅, 정산 스트림, 부모님 프로필 통합 조회를 3-pane 워크스페이스 구조로 설계·구현합니다.
Socket.io 다중 채널 메시지 순서 보장 설계Redis Pub/Sub 어댑터로 다중 서버 환경에서도 채널별 메시지 순서가 유지되는 구조를 구현합니다.
정산 이벤트 소싱 스트림 구축결제·환불·차감 이벤트를 정규화한 정산 스트림과 Materialized View 기반 집계 로직을 설계합니다.
정보 패널 아코디언 컴포넌트 설계프로필·배정·케어 기록을 한 패널에서 탐색 가능한 Compound Component 기반 아코디언을 구현합니다.
Overview
프로젝트 개요
실버케어 매칭 CRM을 확장해 보호자·선생님·관리자가 함께 쓰는 재활 진행 피드, 실시간 채팅, 정산 스트림, 부모님 프로필 통합 조회를 3-pane 워크스페이스 구조로 설계·구현합니다.
요구사항 정의
프로젝트 핵심 과제
프로젝트 진행 시 해결한 핵심 기술 과제입니다.
다중 서버 환경에서 Socket.io 메시지 순서와 읽음 상태 동기화를 보장하는 Redis Pub/Sub 설계가 필요합니다
결제·환불·차감이 뒤섞인 정산 내역을 회차 단위로 정확히 집계하는 이벤트 소싱 모델 설계가 필요합니다
가족 구성원별로 접근 가능한 케어 기록 범위를 분리하는 채널 단위 권한 모델 설계가 필요합니다
채팅 첨부파일과 정산 증빙 문서가 뒤섞이지 않
파일 저장소 네임스페이스 분리 전략이 필요합니다
구현 내용
핵심 기능 상세
핵심 기능 1
가족 재활 현황 대시보드
보호자가 로그인하면 부모님의 재활 회차별 진행 기록과 다음 방문 일정을 피드 형태로 확인하고, 우측 패널에서 부모님 프로필 요약을 함께 볼 수 있습니다
핵심 기능 2
보호자·선생님 실시간 채팅
보호자와 담당 선생님, 필요 시 관리자까지 참여하는 채널형 채팅으로 사진·서류 첨부를 주고받을 수 있습니다
핵심 기능 3
정산 & 결제 내역 스트림
계약금 결제 이후 발생하는 회차별 정산·환불 내역을 시간순 스트림으로 모아 보호자와 관리자가 함께 확인합니다
핵심 기능 4
부모님 프로필 & 케어 히스토리
부모님의 질환·재활목적·거주지역 등 기본 정보와 배정 이력, 회차별 케어 기록을 우측 정보 패널에서 통합 조회합니다
구현 과정
프로젝트 진행 단계
STEP 1
가족·채팅·정산 도메인 스키마 확장 설계
기존 CRM 스키마에 채널·메시지·정산 이벤트 테이블 9개를 추가하고 Prisma 관계 재정의
STEP 2
Socket.io 실시간 채팅 인프라 구축
Socket.io 네임스페이스, Redis Pub/Sub 어댑터, S3 첨부 업로드 API 8개 구현
STEP 3
패밀리 케어허브 UI 개발
React 기반 3-pane 워크스페이스, 피드·채팅·정산 스트림 등 9개 화면 구현
STEP 4
정산 집계 및 통합 검증
Materialized View 기반 정산 집계 로직 검증, 채널별 메시지 순서 보장 테스트
프로젝트 성과
주요 성과
Socket.io 다중 채널 메시지 순서 보장 설계Redis Pub/Sub 어댑터로 다중 서버 환경에서도 채널별 메시지 순서가 유지되는 구조를 구현합니다.
정산 이벤트 소싱 스트림 구축결제·환불·차감 이벤트를 정규화한 정산 스트림과 Materialized View 기반 집계 로직을 설계합니다.
정보 패널 아코디언 컴포넌트 설계프로필·배정·케어 기록을 한 패널에서 탐색 가능한 Compound Component 기반 아코디언을 구현합니다.
S3 presigned 업로드 구조 구현채팅 첨부파일을 서버 경유 없이 S3로 직접 업로드하는 presigned URL 발급 API를 구현합니다.
Review
기술적 주안점
- 재활 진행 상황을 대화형 피드로 재구성해 보호자가 회차별 변화를 스크롤만으로 파악할 수 있는 화면을 설계합니다
- Socket.io와 Redis Pub/Sub 조합으로 다중 서버 환경에서도 채널별 메시지가 순서대로 전달되는 구조를 설계합니다
- 정산 이벤트를 스트림 형태로 축적해 결제 이후 발생하는 모든 금전 변동을 한 화면에서 추적할 수 있는 구조를 설계합니다
