From a7be8f76bf7eaacafcbdc6b3d2deec899c7dae9c Mon Sep 17 00:00:00 2001 From: gahusb Date: Thu, 9 Jul 2026 14:08:14 +0900 Subject: [PATCH] =?UTF-8?q?docs(CLAUDE.md):=20realestate=20=EB=A7=A4?= =?UTF-8?q?=EB=AC=BC=20=EC=95=8C=EB=A6=BC+=EC=95=88=EC=A0=84=EB=A7=88?= =?UTF-8?q?=EC=A7=84=20=EC=97=94=EB=93=9C=ED=8F=AC=EC=9D=B8=ED=8A=B8=20+?= =?UTF-8?q?=20agent-office=20notify-listing=20=EB=93=B1=EC=9E=AC?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-Authored-By: Claude Opus 4.8 (1M context) Claude-Session: https://claude.ai/code/session_01EqCYBhvTcdeCTUDX3RhWx9 --- CLAUDE.md | 17 +++++++++++++---- 1 file changed, 13 insertions(+), 4 deletions(-) diff --git a/CLAUDE.md b/CLAUDE.md index 8dd5907..aa61bfe 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -332,10 +332,12 @@ docker compose up -d | POST | `/api/internal/insta/update` | Windows 워커 결과 webhook | ### realestate-lab (realestate-lab/) -공공데이터포털 청약 분양정보 수집 + 자치구 5티어 매칭 + agent-office push 알림. -- 핵심 파일: `main.py`, `db.py`, `collector.py`, `matcher.py`, `notifier.py`, `models.py` +공공데이터포털 청약 분양정보 수집 + 자치구 5티어 매칭 + agent-office push 알림. **+ 매물 알림(전월세·매매) + 안전마진/매수 적정성 판정 + 재무·규제 예산 산정**(2026-07-09 추가). +- 핵심 파일(청약): `main.py`, `db.py`, `collector.py`, `matcher.py`, `notifier.py`, `models.py` +- 핵심 파일(매물): `listing_collector.py`(국토부 실거래[합법]+네이버 호가[폴백]), `listing_matcher.py`(안전마진·적정성), `finance_rules.py`+`finance_rules_config.py`(전세대출·LTV·DSR·토허), `lawd_codes.py`(법정동코드) - 매칭 100점: 지역35 / 주택유형10 / 면적15 / 가격15 / 자격25 -- 📌 상세(DB 스키마·스케줄러 4단계·매칭 모델·notifier 멱등 흐름·env): **`service_realestate.md`** +- 매물 판정: 임차 전세가율 ≤0.70🟢/≤0.80🟡/>0.80🔴, 매매 호가율 ≤0.97🟢/≤1.05🟡/>1.05🔴, 실거래 표본<3 ⚪보류. 네이버 차단돼도 실거래·안전마진·청약 무중단(`naver_ok`) +- 📌 상세(DB 스키마·스케줄러·매칭 모델·notifier 멱등·매물 4테이블·판정 경계·env): **`service_realestate.md`** | 메서드 | 경로 | 설명 | |--------|------|------| @@ -349,6 +351,12 @@ docker compose up -d | POST | `/api/realestate/matches/refresh` | 매칭 재계산 | | PATCH | `/api/realestate/matches/{id}/read` | 신규 알림 읽음 | | GET | `/api/realestate/dashboard` | 요약 (진행중·신규매칭·일정) | +| GET | `/api/realestate/listings` | 매물 목록 (dong/deal_type/tier/matched_only/page/size) | +| POST/GET | `/api/realestate/listings/collect` (+ `/collect/status`) | 매물 수동 수집(collect→match→notify)/상태 | +| GET/PUT | `/api/realestate/listings/criteria` | 매물 조건(동·거래유형·보증금상한·자기자금·연소득 등) 조회/수정 | +| GET | `/api/realestate/listings/matches` | 매물 매칭+판정 결과 | +| POST | `/api/realestate/safety-check` | 단건 안전마진/적정성 판정 (실거래 median 대비) | +| POST | `/api/realestate/budget` | 전세/매수 예산·규제 산정 (전세대출·LTV·DSR·토허) | ### agent-office (agent-office/) AI 에이전트 가상 오피스 — 기존 서비스 API를 프록시로 호출, 실시간 WebSocket + 텔레그램 봇. @@ -365,7 +373,8 @@ AI 에이전트 가상 오피스 — 기존 서비스 API를 프록시로 호출 | POST | `/api/agent-office/command` | 에이전트 명령 전송 | | POST | `/api/agent-office/approve` | 작업 승인/거부 | | POST | `/api/agent-office/telegram/webhook` | 텔레그램 Webhook (realestate_bookmark_* 콜백 포함) | -| POST | `/api/agent-office/realestate/notify` | realestate-lab 전용 push 수신 → 텔레그램 | +| POST | `/api/agent-office/realestate/notify` | realestate-lab 청약 매칭 push 수신 → 텔레그램 | +| POST | `/api/agent-office/realestate/notify-listing` | realestate-lab 매물 알림 push 수신 → 텔레그램(너+아내, 안전마진/적정성 렌더) | | GET | `/api/agent-office/states` | 전체 에이전트 상태 | | GET | `/api/agent-office/nodes` | 분산 워커(NAS↔Windows) 관측 — heartbeat 생사+큐깊이+dead-letter 집계 (web-ui `/infra` Three.js 시각화 소비). 상세 → `infra_distributed_workers.md` | | GET | `/api/agent-office/activity` | 전 에이전트 통합 활동 피드 (tasks+logs UNION). 필터 `agent_id`/`type`(task\|log)/`status`/`days` + `limit`/`offset` |