종합부동산웹앱 AI 분석 워크벤치 설계

질의 원문

내가 maico 질문을 여기서 했다. maico 관련 질문은 무시하고

AI 분석 지침 + 실행계획 생성형

사용자가 “노원 재건축 5억 이하 찾아줘”처럼 질의하면 AI가 분석 목적, 필요한 원천, 호출할 수집기, 확인 한계, 결과 문서 구조를 만들고 백엔드 도구를 실행합니다.

위의 내용으로 진행해줘.

수집 경로와 시점

• 수집시점: 2026-08-12 KST
• 확인 경로: 로컬 저장소의 웹앱 구조, src/realestate/webapp/, docs/CONTEXT_HANDOFF.md, docs/PROJECT_FILE_MAP.md, docs/STATUS.md
• 실행 맥락: 사용자는 MAICO 관련 발화를 이 프로젝트 판단에서 제외하라고 명시했고, 본 문서는 종합 부동산 투자분석 웹앱에 한정한다.

데이터 등급

판단

현재 정적 투자 현황판은 분석 문서의 색인·아카이브 역할이고, 웹앱 홈 화면도 아직 문서·보드·기존 도구 중심이다. 사용자가 요구한 제품은 여기서 한 단계 위의 AI 투자분석 워크벤치다.

확정된 1차 방향은 다음과 같다.

1. 사용자가 자연어 투자 질의를 입력한다.
2. AI 분석가 계층이 분석 목적, 필요한 원천, 호출할 수집기, 확인 한계, 결과 문서 구조를 만든다.
3. 백엔드가 가능한 수집기와 기존 분석 엔진을 실행한다.
4. 결과는 후보 우선순위, 가격 기준, 자금 계획, 리스크, 원본 확인 과제로 정리한다.
5. 결과 문서는 docs/analysis에 저장하고 현황판·워치리스트·파이프라인에서 확인 가능하게 한다.

설계 결정

• 새 설계 문서: docs/plans/2026-08-12-ai-investment-analyst-workbench-design.md
• 구현 계획 문서: docs/plans/2026-08-12-ai-investment-analyst-workbench.md
• 1차 구현은 외부 LLM 호출이 없어도 작동하는 deterministic planner로 시작한다.
• 향후 LLM API 연결은 AnalystProvider 계층 뒤에 붙이되, 실행 권한은 백엔드 오케스트레이터가 허용된 수집기와 도구로 제한한다.

가정

• “AI가 붙어 있다”는 의미는 단순 채팅창이 아니라, 질의를 분석 업무로 바꾸고 백엔드 실행을 조율하는 계층을 뜻한다.
• 현재 확보한 raw 데이터 API와 수집기는 투자안 산출의 재료이며, AI는 그 재료를 호출할 순서와 분석 문서 구조를 만든다.
• 첫 구현은 재건축/재개발, 경매/공매, 일반 시세, 자금조달, 임대수요, 학군/교통 질의를 분류하는 규칙 기반 planner로 충분하다.

한계·미확인

• 이 문서는 설계 기록이며, 특정 지역이나 매물의 투자 결론을 산출하지 않았다.
• 실제 LLM API 키와 모델 선택은 아직 고정하지 않는다.
• 경매 권리관계, 정비사업 권리산정일·조합원 지위·분담금, 등기부·대장 확인은 자동 확정 대상이 아니다.
• 학교알리미·서울 열린데이터광장 등 추가 수집기는 워크벤치가 호출할 수 있는 원천으로 연결해야 하지만, 본 설계 문서에서는 개별 수집기 구현을 다루지 않는다.

다음 단계

1. src/realestate/webapp/analyst.py에 질의 → 분석 계획 planner를 추가한다.
2. src/realestate/webapp/orchestrator.py에 분석 계획 실행 요약기를 추가한다.
3. /api/analyst/plan, /api/analyst/run을 FastAPI에 연결한다.
4. 홈 화면 첫 영역을 AI 투자분석 워크벤치로 재구성한다.
5. 저장 결과가 docs/analysis와 투자 현황판에 이어지도록 기존 기록 저장 흐름을 재사용한다.