Skip to content

S1J2-Lab/home-protect-client

Repository files navigation

지켜줘홈즈 서비스 소개

🏠 지켜줘홈즈 (Home Protect)

전세 사기 예방, 첫걸음

계약서 작성 후, 도장 찍기 전에 업로드하세요.
AI가 1~2분 만에 전세가율 · 등기부등본 · 계약서 독소조항 · 건축물 현황을 한 번에 분석해 드립니다.


Deploy



목차


💡 서비스 소개

전세사기 피해자는 2026년 5월 기준 누적 3만 8,503건, 피해의 75%가 2030 청년층에 집중되어 있습니다.

등기부등본을 혼자 해석하기엔 법률 전문 지식이 필요하고, 전문가에게 맡기기엔 비용이 부담스럽습니다.
지켜줘홈즈는 이 정보 비대칭의 공백을 채우기 위해 만들어졌습니다.


[완전 무방비]  ────────  [지켜줘홈즈]  ────────  [전문가 의뢰]
                          │
               파일 업로드 + 간단한 정보 입력
               → AI 통합 분석 (1~2분)
               → 위험 조항 경고 + 대응 방법
               → 완전 무료 · 비로그인 · 전국 지원

"변호사한테 맡기기엔 비용이 부담스럽고, 그냥 넘어가기엔 불안하다"
2030 청년 임차인이 계약 전 스스로 위험 신호를 확인할 수 있는 1차 안전망을 제공합니다.


분석 소요 시간 이용 비용 회원가입 지원 파일
평균 1~2분 완전 무료 불필요 PDF · JPG · PNG

✨ 핵심 기능

서비스는 3단계 흐름으로 동작합니다.


Step 1 — 정보 입력 & 파일 업로드

Step 1: 정보 입력 및 파일 업로드

주소를 검색하고 계약 유형(전세 / 반전세 / 월세), 보증금, 계약 기간을 입력합니다.
등기부등본과 임대차계약서를 PDF · JPG · PNG 형식으로 업로드하면 준비가 끝납니다.

  • 개인정보(주민등록번호·전화번호) 감지 시 외부 AI 전송 전 즉시 차단
  • 업로드 파일 및 OCR 결과는 Redis에 세션으로 저장 후 30분 자동 삭제


Step 2 — AI 통합 분석 (1~2분)

Step 2: AI 분석 진행

4가지 분석이 병렬로 실행되며, 각 단계가 완료되는 즉시 실시간으로 화면에 전달됩니다.

분석 항목 데이터 소스
전세가율 서울시 전월세·매매 실거래가 공공 API
등기부등본 CLOVA OCR → Gemini AI
임대차계약서 독소조항 CLOVA OCR → Claude AI + Pinecone 판례 RAG
건축물 현황 국토교통부 건축물대장 API


Step 3 — 결과 확인 & PDF 다운로드

Step 3: 결과 확인 및 PDF 다운로드

항목별 위험도와 상세 설명, AI가 판단하기 어려운 수동 확인 체크리스트를 함께 제공합니다.
분석 결과 전체를 PDF 리포트로 저장할 수 있습니다.

전세가율 판정 기준

전세가율 판정
80% 이상 🔴 위험 — 깡통전세 위험 경고
60 ~ 80% 🟡 주의 — 추가 확인 필요
60% 미만 🟢 안전

계약서 독소조항 분류

분류 설명
🔴 danger 판례 근거 있는 고위험 조항
🟡 caution AI 법리 판단 기반 주의 조항

🛠 기술 스택

Frontend

React TypeScript Vite Emotion Axios


Backend

Java Spring Boot Spring WebFlux Redis Gradle


AI / OCR

Gemini Claude Pinecone CLOVA


인프라 / DevOps

AWS ECS Docker GitHub Actions CloudWatch


🏗 아키텍처

지켜줘홈즈 아키텍처 다이어그램

4개 분석이 병렬로 실행(CompletableFuture)되며, 외부 API 장애 시에도 완료된 단계의 결과는 그대로 사용자에게 전달됩니다.
각 분석 단계에 개별 30초 타임아웃이 적용되고, SSE 스트리밍으로 진행 상태를 실시간 전달합니다.


🚀 시작하기

서비스 이용 (바로 사용)

https://homeprotect.shop


로컬 실행 — Frontend

git clone https://github.com/S1J2-Lab/home-protect-client.git
cd home-protect-client

yarn install
cp .env.example .env.local
# .env.local 에 백엔드 API 주소 설정

yarn dev
# → http://localhost:5173

로컬 실행 — Backend

git clone https://github.com/S1J2-Lab/home-protect-server.git
cd home-protect-server

# .env 에 외부 API 키 설정 필요
# (공공데이터 포털, CLOVA OCR, Gemini, Claude, Pinecone)
cp .env.example .env

docker-compose up -d

외부 AI/OCR API 키 없이는 분석 기능이 동작하지 않습니다.


👥 팀 소개

공공데이터 활용 아이디어 공모전 2026 출품작

이세비 조지현 박지현
이세비의 프로필 이미지 조지현의 프로필 이미지 박지현의 프로필 이미지
Frontend Frontend Backend
@2seb2 @zeon0xx0 @jjhparkk

지켜줘홈즈는 법률 전문가의 정밀 검토를 대체하지 않습니다.
계약 전 위험 신호를 스스로 확인할 수 있도록 돕는 1차 안전망을 목표로 합니다.


© 2026 Home Protect Team · All rights reserved.

About

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages