종합부동산웹앱 투자 관제실 랜딩페이지 구성
질의 원문
이거 투자 관제실의랜딩페이지를 만들어주고 전체적인 사용성과 접근 방법을 다시 구성해봐.
수집 경로와 시점
- 수집·구현시점: 2026-08-12 21:50:43 +09:00
- 확인 경로: 로컬 저장소
src/realestate/webapp/templates/index.html,src/realestate/webapp/static/app.css,src/realestate/webapp/static/app.js,tests/test_webapp_app.py - 직전 맥락: 사용자는 정적 현황판이 아니라 “AI가 붙어 있는 투자분석 사이트”를 원한다고 정리했다. 따라서 홈 화면은 문서 목록보다 자연어 질의, 원천 호출, 후보 관리, 현황판 축적의 접근 흐름을 먼저 보여줘야 한다.
데이터 등급
| 항목 | 등급 | 비고 |
|---|---|---|
| 사용자 지시 | 1차 사용자 입력 | 본 대화에서 직접 제공 |
| 화면 구조 | 로컬 구현 상태 | Jinja 템플릿·CSS·JS 파일 기준 |
| 사용성 판단 | 설계 판단 | 실제 사용자 테스트 전의 제품 설계 가정 |
| 투자 데이터 | 해당 없음 | 이번 작업은 UI/접근 흐름이며 신규 투자 판단 수치 없음 |
설계 결정
홈 화면을 “문서 현황판”이 아니라 “투자 관제실 랜딩”으로 재구성했다. 첫 화면에서 사용자가 바로 알 수 있어야 하는 흐름은 다음 4단계다.
- 질의 정리: 지역·금액·유형을 분석 목적과 제약으로 변환한다.
- 원천 호출: 실거래·건축물대장·경매·정비사업 원천을 실행 계획으로 묶는다.
- 후보 관제: 실행 후보를 목표가·원천 식별자와 함께 워치리스트로 넘긴다.
- 문서 축적: 분석 결과를
docs/analysis에 저장하고 투자 현황판에서 다시 본다.
이를 위해 홈 상단에 control-landing 섹션을 추가했다. 랜딩 안에는 AI 관제실 설명, 분석 시작 CTA, 워치리스트·파이프라인 이동, 보드·문서·후보·검토 파이프라인 빠른 이동을 배치했다.
또한 사용자가 빈 질의 입력 앞에서 멈추지 않도록 query-launchpad 대표 질의 버튼을 추가했다. 버튼을 누르면 AI 워크벤치의 질의·전략 프로필·지역·상한가가 자동으로 채워지고 워크벤치로 이동한다.
가정
- 첫 사용자는 “무엇을 입력해야 하는지”를 가장 먼저 궁금해한다.
- 숙련 사용자는 워치리스트·파이프라인·보드·문서로 바로 이동하는 빠른 길이 필요하다.
- 원천 식별자는 중요하지만 첫 인지 단계에서는 보조 정보다. 따라서 랜딩은 질의와 흐름을 먼저 설명하고, 구체 식별자는 워크벤치에서 입력하게 한다.
한계·미확인
- 실제 사용자 클릭 데이터나 세션 녹화 기반 사용성 검증은 아직 없다.
- 이번 변경은 홈 화면 구조와 프리셋 입력 흐름 중심이며, 원천별 상세 화면이나 카드 클릭 이동은 아직 추가하지 않았다.
- 외부 원천 API 호출 여부와 투자 판단 정확도는 이번 랜딩 구성의 검증 대상이 아니다.
검증
- RED:
$env:PYTHONPATH='src'; python -m pytest tests/test_webapp_app.py::test_homepage_presents_investment_control_room_landing tests/test_webapp_app.py::test_static_css_styles_control_room_landing -q-> 2 failed - GREEN:
$env:PYTHONPATH='src'; python -m pytest tests/test_webapp_app.py::test_homepage_presents_investment_control_room_landing tests/test_webapp_app.py::test_static_css_styles_control_room_landing -q-> 2 passed - RED:
$env:PYTHONPATH='src'; python -m pytest tests/test_webapp_app.py::test_homepage_offers_control_room_query_launchpad tests/test_webapp_app.py::test_static_js_handles_query_presets tests/test_webapp_app.py::test_static_css_styles_control_room_landing -q-> 3 failed - GREEN:
$env:PYTHONPATH='src'; python -m pytest tests/test_webapp_app.py::test_homepage_offers_control_room_query_launchpad tests/test_webapp_app.py::test_static_js_handles_query_presets tests/test_webapp_app.py::test_static_css_styles_control_room_landing -q-> 3 passed
다음 단계
- 원천 시그널 카드 클릭 시 관련 원천 입력 또는 실행 결과 섹션으로 이동한다.
- 질의 프리셋을 사용자의 최근 분석 주제와 워치리스트 상태 기반으로 동적으로 추천한다.
- 모바일에서 프리셋 선택 후 계획 생성까지 한 번에 이어지는 단축 실행 버튼을 검토한다.
원문 Markdown: docs/analysis/2026-08-12-종합부동산웹앱-투자관제실-랜딩페이지구성.md