https://zip-line.kr

📱 서비스 시연 영상

📝 서비스 소개

집라인(Zipline)은 "집(Home)"과 "라인(Line)"의 합성어로, 공인중개사가 부동산과 고객을 최적의 경로로 연결하는 다리 역할을 할 수 있도록 돕습니다.

🚀 주요 기능

📊 통계

대시보드 화면에서 계약, 고객, 상담 현황을 요약해 제공하여, 중개사가 현재 업무 상황을 한눈에 파악할 수 있도록 돕습니다.

📅 일정

주간/월간 단위로 계약 일정과 상담 일정을 조회하고 관리할 수 있으며, 일정을 추가, 수정, 삭제하는 기능을 통해 체계적인 스케줄 관리를 지원합니다.

📋 설문

신규 고객 유입 시 필요한 정보를 사전에 수집할 수 있는 설문 기능을 지원합니다.

QR코드 및 URL 링크를 통해 간편하게 설문을 배포하고, 제출된 답변을 통해 고객의 니즈를 빠르게 파악할 수 있습니다.

📄 계약

고객과 매물 간의 계약 과정을 체계적이고 효율적으로 관리합니다.

🗨️ 상담

고객과의 상담 기록을 등록하고 조회할 수 있으며, 상담 일시나 고객 정보를 기준으로 빠르게 검색할 수 있습니다.

🏢 매물

매물을 등록하고, 상세 조건(가격, 면적, 반려동물 여부 등)을 기준으로 조회 및 필터링할 수 있으며, 매물 히스토리도 관리할 수 있습니다.

👥 고객

고객 정보를 등록하고, 다양한 필터링 및 라벨링 기능을 통해 고객을 체계적으로 분류 및 관리할 수 있으며, 고객별 계약/상담/매물 내역도 손쉽게 관리할 수 있습니다.

📩 문자

단체 문자 발송, 문자 템플릿 관리, 생일 및 계약 기간 만료 전 알림 문자 발송 기능을 통해 고객 커뮤니케이션을 손쉽게 자동화하고 관리할 수 있도록 합니다.

🌐 외부 매물 데이터 조회

외부 부동산 플랫폼(네이버, 직방)에서 매물 정보를 확인할 수 있도록 하여, 중개사의 정보 수집 업무를 간편하게 만듭니다.

⚙ 기술 스택

Front-end

Back-end

Infra

Tools

🛠️ 프로젝트 아키텍처

🛠️ CI / CD 파이프라인

⚙ GithubAction + DockerHub CI/CD Process

1. GitHub Actions + DockerHub

apiserver와 crawlerserver 멀티모듈 프로젝트의 백엔드 배포를 자동화. 핵심 기능:

1. 코드 변경 감지: dev 또는 test 브랜치에 푸시되거나 PR이 생성되면 CI/CD 워크플로우가 자동으로 시작됩니다.
2. 자동화된 테스트 및 빌드: 각 모듈의 유닛 및 통합 테스트를 실행하여 코드 안정성을 검증하고, 독립적인 JAR 파일로 빌드합니다.
3. Docker 이미지 관리: 빌드된 JAR 파일은 전용 Dockerfile을 통해 Docker 이미지로 변환되며, 이 이미지들은 Docker Hub에 푸시되어 중앙에서 관리됩니다.
    - dev 브랜치: apiserver:dev, crawlerserver:dev 태그로 이미지를 푸시하고 개발 전용 EC2 인스턴스에 배포됩니다. SPRING_PROFILES_ACTIVE=dev와 같은 개발 환경 변수가 주입됩니다.
    - test 브랜치: apiserver:test, crawlerserver:test 태그로 이미지를 푸시하고 테스트 전용 EC2 인스턴스에 배포됩니다. SPRING_PROFILES_ACTIVE=test와 같은 테스트 환경 변수가 주입됩니다.
4. 분기별 EC2 배포: 각 브랜치(dev/test)에 맞는 EC2 인스턴스에 SSH로 접속하여, 기존 컨테이너를 중지 및 제거하고 최신 Docker 이미지를 Pull 받아 실행합니다.
5. 환경 변수 주입: GitHub Secrets에 정의된 민감한 환경 변수들이 안전하게 Docker 컨테이너에 주입됩니다.

2. Vercel을 활용한 프론트엔드 배포

이 전략은 프론트엔드 애플리케이션의 배포를 효율적으로 처리합니다. 핵심 기능:

자동 배포: Vercel의 통합 CI/CD 기능을 활용하여 Git 저장소에 푸시되는 변경 사항을 자동으로 감지하고 빌드하여 배포합니다.
Preview Deployments: PR 생성 시 자동으로 Preview 환경을 제공하여, 실제 병합 전에 변경 사항을 쉽게 검토할 수 있습니다.
글로벌 CDN: Vercel의 글로벌 CDN을 통해 사용자에게 빠르고 안정적인 서비스 접근성을 제공합니다.
간편한 환경 설정: Vercel 대시보드에서 환경 변수 및 도메인 설정을 직관적으로 관리할 수 있습니다.

3. Redis, S3, RDS를 용도에 맞게 분리하여 확장성 보장

이 전략은 클라우드 서비스를 용도에 따라 분리하여 사용함으로써 시스템의 확장성과 안정성을 극대화합니다. 핵심 기능:

Elasticache를 사용한 Redis (캐싱/토큰 관리): 인메모리 데이터 스토어인 Redis를 활용하여 빠른 데이터 접근이 필요한 캐싱, 사용자 토큰 관리, 실시간 데이터 처리 등에 사용합니다. 이를 통해 데이터베이스 부하를 줄이고 애플리케이션 응답 속도를 향상시킵니다.

Amazon S3 (객체 스토리지): 확장 가능한 클라우드 객체 스토리지인 S3를 이용하여 이미지, 동영상, 문서 등 정적 파일 및 대용량 데이터를 저장하고 관리합니다. 웹 서버와 분리하여 파일 저장 공간에 대한 확장성 문제를 해결합니다.

Amazon RDS (관계형 데이터베이스): 관계형 데이터베이스 서비스인 RDS를 사용하여 애플리케이션의 핵심 비즈니스 로직과 관련된 구조화된 데이터를 저장하고 관리합니다. RDS는 자동 백업, 복제, 패치 등 관리형 서비스를 제공하여 데이터베이스 운영 부담을 줄입니다.

🗂️ 기술 문서

📄 API 명세서

📋 기능 명세서

🔧 트러블 슈팅

📖 메뉴얼

📊 ERD

💁‍♂️ 프로젝트 팀원

이름	역할	담당 업무
채지원	백엔드 개발자 (팀장)	문자 발송 / 문자 템플릿 관리, 공인중개사 일정 관리, 프론트엔드 개발 및 배포
신중우	백엔드 개발자	AWS(EC2,RDS,Redis), CICD, 공개매물 크롤링 서버, 조회, 대쉬보드 통계, 리퀴베이스, 법정동코드 조회, 프로젝트 구조 리펙토링
신윤상	백엔드 개발자	고객 관리, 설문 관리, 상담 관리, ExcelImport
조수연	백엔드 개발자	회원가입/로그인, 계약, 매물, 고객 라벨 관리, 프론트 엔드 개발(계약, 매물 페이지)

📁 관련 레포지토리