K-City 하위 모듈 · 초안(v0.1) 단계 · 다른 모듈이 호출하는 유틸리티

이 부동산은 얼마로 추정되는가

감정평가(추정) 모듈은 도시정비(재개발) 모듈을 비롯해 부동산 가치 추정이 필요한 여러 K-서비스가 공유해서 호출하는 범용 모듈입니다. 도시정비 모듈은 더 이상 자체 감정평가 기능을 갖지 않고, 감정가가 필요할 때마다 이 모듈을 호출합니다.

누가 호출하는가

호출자에 종속되지 않는 범용 모듈

이 모듈은 특정 상위 모듈의 일부가 아니라, 부동산 가치 추정이 필요한 누구든 호출할 수 있는 독립 유틸리티입니다.

도시정비(재개발) 모듈
조합원 개인의 감정가를 추정받아, 그 값으로 분담금·환급금을 계산합니다.
향후 다른 K-서비스
담보대출 참고용 시세 추정 등, 부동산 가치가 필요한 다른 모듈도 동일한 인터페이스로 호출할 수 있습니다.
사용자 직접 문의
"우리 집 시세가 궁금하다" 같은 일반 문의도 같은 모듈이 처리합니다(목적 필드로 구분).
호출 인터페이스

다른 모듈이 이렇게 호출하고, 이렇게 돌려받습니다

호출한 대상이 사람인지 다른 모듈인지 구분하지 않고 같은 형식으로 응답합니다 — 다만 목적(purpose)에 따라 설명 방식은 달라질 수 있습니다.

요청 (예: 도시정비 모듈 → 본 모듈)
{"agency":"kcity","module":"appraisal","task_key":"...", "target":{"address":"영도구 청학1구역 내 소유 주택","area_sqm":84.9,"type":"residential"}, "purpose":"urban_renewal_contribution", "requested_by":"module:urban_renewal"}
응답
{"task_key":"...", "estimate":{"amount":310000000,"unit":"KRW","as_of":"2026-09-09"}, "methods_used":["comparable_sales","official_land_price"], "cross_check_delta_pct":6.2, "confidence":"medium", "basis":["인근 유사 사례 5건","2026년 개별공시지가"], "disclaimer":"참고용 추정치이며 법정 감정평가가 아님"}
추정 방법

한국 감정평가 3방식을 참고해 간이 적용

둘 이상의 방법이 적용 가능하면 교차 검증하고, 방법 간 차이가 크면 그 차이를 함께 보고합니다.

1
비교사례법(거래사례비교법) — 기본
인근 유사 부동산의 최근 실거래가를 면적·입지·시점 차이 보정해 추정.
2
공시지가기준법 — 보조
개별공시지가·공동주택공시가격에 시세 반영률을 적용. 비교사례 부족 시 사용.
3
원가법 — 특수 건물 한정
신축 소요비용에서 감가를 차감. 비교사례가 거의 없을 때만.
4
수익환원법 — 수익형 부동산
임대 순수익을 환원율로 나눔. 상가 등 수익 부동산에 한함.
정직한 한계 고지

아직 없는 것

공공데이터 API 실시간 연동 — 현재는 웹검색으로 공개 자료를 조사하는 수준까지만, 대량 자동 조회는 지원하지 않습니다.
법정 감정평가와의 괴리율 실측 — 이 모듈의 추정치가 실제 감정평가사 평가액과 평균적으로 얼마나 차이 나는지 검증된 바 없습니다.
백엔드 연동 — sp-catalog.json 등록·worker.js 라우팅이 아직 연결되지 않았습니다. 호출자 모듈(도시정비 등)도 실제로는 이 경로를 아직 참조하지 못합니다.
면책 원칙
참고용 추정치입니다. 「감정평가 및 감정평가사에 관한 법률」에 따라 담보·경매·수용보상 등 법적 효력이 필요한 감정평가는 언제나 인가받은 감정평가사·감정평가법인의 고유 권한입니다. 본 모듈의 추정치는 그 자체로 법정 감정평가서를 대체하지 않습니다.
문서

정본 문서

SP-27b_kcity_appraisal_v0_1.txt
본 모듈의 범위·추정 방법·호출 인터페이스가 담긴 정본 문서.
도시정비(재개발) 모듈
본 모듈을 호출해 감정가를 받아오는 형제 모듈.
K-City 소개로 돌아가기
시민 복지 총합 최적 도시 설계 — 본체 소개 페이지.
GitHub — Openhash-Gopang/city ↗
K-City 관련 문서와 코드가 모두 이곳에 있습니다.