프로젝트 개요
Homyu는 말레이시아 부동산 시장을 대상으로 매물 등록·탐색, 임대/매매 계약 관리, 문의·알림 시스템을 통합 제공하는 풀스택 부동산 플랫폼입니다.
모노레포 구조로 FastAPI 백엔드, Next.js 기반 공개 홈페이지(SSR), 관리자 대시보드(Static Export), 사용자 포털(Static Export) 4개 서비스를 운영합니다. 백엔드는 SQLModel + Alembic을 활용한 DDD 아키텍처로 15개 도메인 모듈, 68개 API 엔드포인트를 구성했으며, AWS ECS Fargate 기반으로 배포됩니다.
기능 플로우
주요 기능
- 지도 기반 매물 탐색:
Google Maps,Mapbox,Leaflet3종 지도 엔진을 지원하며,Supercluster를 활용한 클러스터링으로 대량 매물을 효율적으로 시각화합니다. 사용자 위치 기반 주변 매물 검색과 필터링을 제공합니다. - 매물 관리: 임대(Rental)와 매매(Sale) 매물을 등록·수정·삭제할 수 있습니다. 이미지 업로드, 공개/비공개 전환, 매물 복제 기능을 지원하며, Presigned URL 기반
S3직접 업로드로 서버 부하를 최소화합니다. - 계약 관리: 임대/매매 계약의 생성부터 종료까지 전체 라이프사이클을 관리합니다. 참여자 관리, 기간 변경, 조기 종료, 갱신 이력 추적, 문서 첨부 기능을 포함합니다.
- 매물 비교: 관심 매물을 비교 페이지에서 나란히 놓고 조건을 비교할 수 있습니다.
- 거래 성사 사례: 실제 거래가 완료된 Success Deals를 공개하여 플랫폼 신뢰도를 높입니다.
- 문의 시스템: 매물 단위로 문의를 송수신하고 읽음 처리를 관리합니다. 에이전트와 사용자 간 실시간 소통을 지원합니다.
- 알림 시스템: 읽지 않은 알림 카운트, 개별/일괄 읽음 처리를 제공하여 중요 이벤트를 놓치지 않도록 합니다.
- 회원 인증: JWT + Redis 세션 기반 인증으로 보안을 강화했습니다. 비밀번호 재설정(이메일), 다중 역할 지원을 포함합니다.
- 뉴스/콘텐츠 관리: 관리자가 작성한 부동산 뉴스를 공개 홈페이지에 노출합니다. 콘텐츠를 통해 사용자 유입과 플랫폼 활성화를 도모합니다.
- 관리자 대시보드: 회원·매물·계약·뉴스를 통합 관리하는 운영 도구입니다. 통계 개요 화면에서 주요 지표를 한눈에 파악할 수 있습니다.
- 이미지 최적화:
AWS Lambda기반 On-Demand 이미지 변환으로 WebP 포맷 변환과 리사이즈를 자동 처리하여 로딩 속도를 개선합니다. - 프론트엔드 관측성:
Grafana Faro를 활용한 브라우저 RUM(Real User Monitoring)으로 실사용자 성능 지표를 수집합니다.
