부동산실록

문제

목표

• 계산기를 50개 넘게 갖추고, 세율이 바뀌면 자동으로 갱신한다.
• 검색에 잘 걸리도록 서버에서 렌더링하고, 모바일과 다크 모드를 지원한다.
• 실거래가, 주소, 건축물 정보를 모으되, 믿을 수 있는지 대조해서 보여 준다.
• 커뮤니티와 기사로 다시 찾아올 이유를 만든다.

풀어 간 과정

처음 시도한 방법, 막힌 지점, 방향을 바꾼 이유를 시간 순서로 적었어요.

1. 2026년 3월

   원래 사이트를 계산기 단위로 뜯어보기

   원래 사이트의 계산기 56개를 입력 필드와 PHP 요청 구조까지 하나씩 문서로 남겼어요. 반응형 웹 하나로 다시 만들고, 옛 사이트에서는 위키와 세율표만 옮기기로 정했어요. 옛 기능마다 무엇으로 대신할지 표로 맞춰 보다가, CSV 내보내기와 사용량 통계가 빠진 것도 찾아 되살렸어요.

2. 2026년 5월

   공공데이터는 서로 대조해서

   실거래가, 주소, 지오코딩 API를 비교해 보니 어느 하나로는 다 채울 수 없었어요. 지오코더에는 건물을 계속 가리키는 ID가 없고, 실거래가에는 정규화된 주소 키가 없었거든요. 그래서 도로명주소와 건축물대장으로 보강하고, 실거래가와 도로명주소는 건물관리번호가 정확히 같을 때만 잇는 교차 검증을 넣었어요.

3. 2026년 7월

   로드맵을 다시 보며 빈 곳 찾기

   기능 로드맵을 점검하면서 데이터 품질을 다루는 층이 아직 없다는 걸 적어 두었어요. 국토부 데이터를 그대로 믿기 어려운 이유도 이 문서에 정리했어요.

지금의 구조

공공데이터를 모아 검증하고, 계산기와 지도로 보여 주는 순서예요.

1. 1

   국토부 실거래가를 모으고, 도로명주소와 건축물대장으로 보강하고, 행정안전부 건물 도형을 들여와요.

2. 2

   수집할 때마다 기록을 남기고, 실거래가와 도로명주소는 서로 대조해 검증해요.

3. 3

   청약 공고는 출처 5곳을 우선순위에 따라 합치고 중복을 지워요.

4. 4

   세법을 반영한 계산 엔진이 Decimal로 계산해요. 계산기는 66종이에요.

5. 5

   단지 요약은 AI가 쓰고, 입력값의 해시로 7일 동안 캐시해요.

6. 6

   기사는 LLM이 초안을 쓰고, 점수 기준을 넘은 것만 자동으로 발행돼요.

핵심 결정

어려웠던 문제

겪었거나 배포 전에 막은 문제를 어떻게 알아챘고, 무엇을 의심해 원인을 찾았는지, 다시 일어나지 않게 무엇을 바꿨는지 기록했어요.

previous_year_total = 0
"year_over_year_change": previous_year_total - previous_year_total,

previous_year_total = self._to_int(self.inputs.get("previous_year_tax", 0))
tax_burden_cap_rate = 1.05 if is_one_household_one_home else 1.30
if previous_year_total > 0:
    tax_burden_cap_amount = self.floor_to_won(previous_year_total * tax_burden_cap_rate)
    if total_holding_tax > tax_burden_cap_amount:
        tax_burden_cap_applied = True
        total_holding_tax = tax_burden_cap_amount
"year_over_year_change": total_holding_tax - previous_year_total,

useEffect(() => {
  console.error("Calculator error:", error);
}, [error]);

useEffect(() => {
  if (reloadOnChunkLoadError(error)) return;
  console.error("Calculator error:", error);
}, [error]);

// chunk-reload.ts 핵심
try { lastReloadAt = Number(sessionStorage.getItem(KEY)) || 0; }
catch { return false; }   // 저장소가 없으면 반복을 막을 수 없으니 새로고침하지 않아요
if (Date.now() - lastReloadAt < 30_000) return false;
sessionStorage.setItem(KEY, String(Date.now()));
window.location.reload();
return true;

결과

계산기

66종 (원래 사이트는 56종)

계산기 감사

P0 버그 4건 수정, 테스트 302건 통과

단지 좌표

190,857개 중 173,602개 확보 (91%)

백엔드 테스트

테스트 함수 1,027개

• 계산할 때마다 페이지를 통째로 다시 받던 구조에서, 입력은 화면에서 받고 계산은 API가 맡는 구조로 바뀌었어요.
• 계산기, 실거래가 지도, 청약 공고, 부동산 위키와 커뮤니티를 한 사이트에서 써요.