ZipPit Dev Status

인프라 체크

0

기능 현황

39활성5부분2비활성

레거시

2페이지

시뮬레이션

2026-Q1-v1룰셋

인프라 & 데이터 상태

상태 확인 중...

기능 체크리스트

상태기능데이터단계
매칭 시뮬레이션/match

핵심 기능. 연소득+현금 → 매수 여력 판정 + 정책대출 자동 매칭

complexescomplex_areaskb_price
활성
가족 조건 입력 (신혼/신생아)/match

메인 폼에서 가족 형태 선택 → 정책대출(디딤돌/신생아특례) 정확도 향상

없음
활성
최적 대출 추천 카드/match

정책대출 자격/금리/절감액 실계산 (매수가능 대출 중앙값 기반). 메타데이터는 policy-loans.ts 원본 참조

complexescomplex_areas
활성
큐레이션 탭 (상급지/학군/대단지/숲세권)/match

테마별 매물 필터링. 대단지 기준: 1,000세대(상수). 상급지: 시세 높은순 실데이터 정렬

complexes
활성
학군지 뱃지/match

⚠️ 하드코딩 MVP: 서울+수도권 15개 동 수동매핑 (school-zones.ts). 확장 시 교육청 API/DB화 필요

없음
부분
숲세권 뱃지/match

⚠️ 하드코딩 MVP: 아파트 이름에 파크/포레/숲/센트럴/그린 키워드 정규식 매칭. GIS 데이터 없어 이름 기반

없음
부분
종합 품질 점수 (추천순)/match

신축(+20)/대단지(+18)/학군(+15)/시세(+12)/숲세권(+5) 가산점. A+B 통합정렬. 모든 정렬의 tiebreaker

complexes
활성
A+B 통합 추천순 정렬/match

추천순: 등급 구분 없이 A+B를 평당가×품질로 통합 정렬. C만 하단 분리

없음
활성
평당가 표시 + 평당가 높은순/match

카드에 '평당 X만' 표시. 정렬 옵션에 '평당가 높은순' 추가

complex_areas
활성
BEST 추천 이유 문구/match

1위 카드에 '추천 이유: 3년차 신축 · 1,745세대 대단지 · 평당 2,100만' 자동 생성

없음
활성
대출 전략 토글/match

주담대 최대(DSR 40%) / 보수적(DSR 30%) 선택. 보수적 모드 시 DSR 한도 제한

없음
활성
월 생활비 입력/match

감당 가능 월상환 역산 (월소득-생활비). gradeReason에 '생활비 차감 후 월 X만원 여유/초과' 반영

없음
활성
인테리어 비용 입력/match

3천만/5천만/1억 퀵버튼. extraCost로 시뮬레이션에 반영 → 필요현금에 합산

없음
활성
시군구 복수 선택/match

체크박스 드롭다운으로 송파+강동+광진 등 복수 시군구 선택. API에서 병렬 쿼리 합산

complexes
활성
가격대 세분화/match,/complex

10~20억 → 10~15억/15~20억 분리. 매칭+단지탐색 통일

없음
활성
조건 자동 저장/복원/match,/complex

localStorage 기반. 재방문 시 소득/현금/가족/대출조건 자동 복원 + 토스트 알림

없음
활성
단지 목록 탐색/complex

Sticky 조건 바 + 등급 필터 + Quick View + 이 지역 결과 보기

complexescomplex_areaskb_price
활성
단지 상세 2열 레이아웃/complex/[id]

메인(지도/시세/실거래) + 금융 사이드바(매수판단/비용/시나리오/입지/주변단지) sticky

complexescomplex_areaskb_pricecoordinateskakao_js
활성
전체 비용 상세 내역/complex/[id]

매매가/취득세/중개수수료/등기비 breakdown + 대출한도 차감 → 내가 준비할 현금

complexes
활성
금리 시나리오 비교/complex/[id]

현재(4.5%)/인상(5.5%)/인상(6.5%)/정책대출(2%) 4가지 월상환·소득비율 비교

없음
활성
입지 지표 3종/complex/[id],QuickView

거래활발도(6개월)/가격위치(2년 최고-최저%)/전세가율. 중복 없는 신규 데이터

trade_historycomplex_areas
활성
주변 단지 비교 모달/complex/[id]

같은 시군구 5개 단지. 클릭 시 QuickView 모달로 비교 (페이지 이동 없음)

complexes
활성
시세 추이 차트/complex/[id]

실거래 이력 데이터 의존. 데이터 없는 단지는 차트 미표시

trade_history
부분
사도되나? 리포트/complex/[id]/report

매수판단 배너 + 4축 분석(자금/부담/타이밍/규제) + 입지 지표. QuickView 상단에도 요약 표시

complexescomplex_areasregulationstrade_history
활성
예시 비교/examples

시뮬레이션 엔진 하드코딩. DB 불필요

없음
활성
용어 사전/glossary

정적 콘텐츠. DB 불필요

없음
활성
가이드/guide

정적 콘텐츠. DB 불필요

없음
활성
업데이트 내역/changelog

버전별 변경사항 안내. 홈 footer 링크. 새 기능 배포 시 CHANGELOG 배열에 추가

없음
활성
네이버 매물 수/호가/complex

market_data DB → complex_areas 배치 동기화 (load-s3-data.py Step 5). naver_min_price/naver_avg_price/naver_listing_count 반영

naver_listingsnaver_price
활성
매물 필터/complex

매물 데이터 있는 단지 카드에 매물 배지 표시. 매물 없으면 자동 숨김

naver_listings
활성
KB vs 네이버 호가 비교/complex

KB시세 대비 네이버 호가 비교 시각화. KB 대비 3%↓ 이상 시 배지 표시

kb_pricenaver_price
활성
아파트 검색 자동완성/complex

전국 단지 이름+주소 검색. 시도 제한 없이 자동완성. 선택 시 지도 Level 3 줌인 + panTo

complexes
활성
관심 단지 저장/complex

localStorage 기반 (비회원). QuickView 하트 토글 + PC 사이드바 관심 단지 탭. 최대 50개

없음
활성
직장 역 기반 출퇴근 시간/complex

수도권 35개 주요역 좌표 DB. 직장역 선택 시 각 단지 카드에 출퇴근 시간 표시. 직선거리×3분 보정

없음
활성
맞벌이 이중 직장/complex

직장 A/B 2개 입력. 직장A 선택 시 직장B 입력 자동 노출. 카드에 양쪽 출퇴근 시간 동시 표시

없음
활성
커뮤니티 기반 예시 비교/examples

블라인드/스레드 실제 질문 기반 3개: 신혼부부+강남, 맞벌이 이중직장, 서울구축vs경기신축

없음
활성
재개발/재건축 현황/complex/[id]

market_data에서 1,076건 적재. QuickView에 진행단계 배지 표시. 25개 진행단계 분류

redevelopment_zones
활성
주택가격지수/시장방향성/complex,/api/v2/market/indices

88K건. QuickView에 시장 트렌드 배지(📈상승중), 단지탐색 상단에 시장정보 배너 표시

housing_price_indices
활성
미분양 현황/complex/[id]

시군구별 월별 미분양. 1,716건. 100세대 이상 시 QuickView 경고 표시

unsold_housing
활성
분양권 거래/프리미엄/api/v2/market/presale

분양거래 198K건 + 프리미엄 15K건. 시군구별 거래 + TOP 프리미엄 API 제공

presale_transactionspresale_premium
활성
개별 매물 리스트/complex/[id]

naver_listings 657K건. 퀵뷰에서 접이식 섹션으로 최저가순 개별 매물 표시. /api/v2/complexes/:id/listings

naver_listings
활성
지오코딩 (주소 검색)/api/map/geocode

카카오 REST API 키 설정 필요

kakao_rest
활성
통근 시간 분석/api/map/commute

API 실패 시 직선거리 추정으로 fallback

kakao_restcoordinates
부분
GIS 공간분석 (역세권/주변시세)/complex/[id]

lbd-gis-staging 미연결. fallback 텍스트 표시

gis_db
비활성
POI 주변시설/api/map/poi

GIS DB 미연결. 빈 배열 반환

gis_db
비활성
개발 뉴스/호재/api/map/dev-news

GIS 실패 시 정적 데이터(GTX 등)로 fallback

gis_db
부분
분양 매물 (레거시)/deal

Prisma 로컬 DB 필요. 프로덕션 미동작

prisma_db
레거시
관리자 대시보드 (레거시)/admin

Prisma 로컬 DB 필요. 프로덕션 미동작

prisma_db
레거시

데이터 파이프라인

단지 마스터S3 → RDScomplexesload-s3-data.pyloaded
면적 데이터S3 → RDScomplex_areasload-s3-data.pyloaded
KB 시세S3 → RDScomplex_areas (trade_*)load-s3-data.pyloaded
네이버 매물/호가market_data → RDScomplex_areas (naver_*)load-s3-data.py Step 5loaded
네이버 개별 매물market_data → RDSnaver_listings (657K)load-s3-data.py Step 5loaded
실거래 이력S3 → RDStrade_historyload-s3-data.pypartial
규제 지역S3 → RDSregulationssetup-rds.sqlloaded
GIS 데이터lbd-gis-staging여러 테이블외부 관리disconnected

시뮬레이션 엔진 (2026-Q1-v1)

DSR 한도40% (은행), 50% (비은행)
LTV 비규제70%
LTV 조정50%
LTV 투기과열40%
LTV 누진9억 초과분: LTV 절반
생애최초 LTV80% (6억 이하, 무주택)
스트레스 DSR변동 +1.5%p, 혼합 +0.75%p
기본 금리4.5% (사용자 변경 가능: 3.0~7.0%)
취득세 1주택1.1~3.3%
정책대출신생아특례(5억/1.6~3.3%), 디딤돌(2~3억/2~3%)

금융 계산은 TypeScript 순수 함수로 구현 (LLM 위임 금지). 49개 단위 테스트 통과.

기술 스택

FrontendNext.js 16 (App Router), React 19, TypeScript 5
StylingTailwind CSS 4, Lucide React
Statenuqs (URL 파라미터 동기화)
BackendNext.js Route Handlers (/app/api/v2/)
Service DBAWS RDS PostgreSQL 16 + PostGIS (real_estate 스키마)
GIS DBlbd-gis-staging (PostGIS, 읽기 전용)
MapKakao Maps JS SDK
TestingVitest (51 tests)
Packagepnpm 10
Buildoutput: "standalone" (PM2 배포)
Deployjay-dev (15.165.120.34), PM2 zipfit, port 4200

환경변수

필수REAL_ESTATE_DATABASE_URLRDS landbook-apt (부동산 데이터)
필수NEXT_PUBLIC_KAKAO_MAP_KEY카카오맵 JS키
선택KAKAO_REST_KEY카카오 REST API (지오코딩/통근)
선택GIS_DATABASE_URLlbd-gis-staging (PNU/GIS)
선택DATABASE_URLPrisma 로컬 Docker (레거시)

API 엔드포인트

POST/api/v2/simulate/match매칭 시뮬레이션RDS
POST/api/v2/complexes/list단지 목록RDS
GET/api/v2/complexes/[id]/previewQuick ViewRDS
GET/api/v2/complexes/[id]/report사도되나? 판단RDS
GET/api/v2/complexes/[id]/price-history시세 추이RDS
GET/api/v2/complexes/search아파트 검색 자동완성RDS
GET/api/v2/complexes/[id]/listings개별 매물 리스트RDS
GET/api/v2/regions지역 목록RDS
GET/api/v2/health상태 체크RDS
GET/api/map/geocode지오코딩카카오
GET/api/map/commute통근 시간카카오

마케팅 & SEO

도메인zippit.im후이즈 등록, SSL certbot 적용완료
Google Search Consoleapps@spacewalk.techDNS TXT 인증 완료, sitemap 제출 완료 (2026-03-19)완료
Sitemap/sitemap.xml정적 19페이지 + 동적 단지 ~5,000개완료
robots.txt/robots.txt/admin/, /api/, /embed/ 차단완료
JSON-LD 구조화 데이터WebApplication schemaGoogle 리치 결과 대응완료
OG Image1200×630 동적 생성루트 공통 OG 이미지 (opengraph-image.tsx)완료
메타 태그 (keywords)12개 키워드아파트 대출 계산기, DSR, LTV, 생애최초 등완료
Title Template%s | ZipPit전 페이지 자동 적용완료
네이버 Search Advisor-미등록. 한국 검색 트래픽 핵심예정
Google Analytics (GA4)NEXT_PUBLIC_GA_IDenv 설정 시 자동 활성화 (코드 준비됨)예정
페이지별 OG 이미지-현재 모든 페이지 동일 OG 이미지. 개별 생성 필요예정
커뮤니티 시딩-부동산 갤러리, 블라인드, 에브리타임 등예정
콘텐츠 마케팅-블로그/브런치 시리즈, 카드뉴스예정
SNS 채널-인스타그램, 쇼츠/틱톡예정

디자인 시스템 & 마스코트

마스코트 "피티" (Fiti)

집 모양 모자 + squircle 몸체. 등급/상태별 6가지 표정

기본
지금 바로
조금만 더
아직은 일러요
로딩
!
에러
크기 변형:

카테고리 아이콘

가족 형태 + 정책대출 아이콘 (stroke 기반, currentColor)

싱글
신혼부부
가족
신생아
디딤돌

지도 / POI 아이콘

지도 오버레이 및 주변시설 마커용 (stroke 기반)

지하철
GTX
학교
병원
마트
공원
재개발
신도시
인프라

상태 아이콘 & 등급 도트

안전
주의
등급 도트

컬러 팔레트

Primary & Brand

Primary#2563EB
Dark#1E40AF
Light#60A5FA
Accent#FBBF24

등급 컬러

지금 바로emerald
조금만 더amber
아직은 일러요red