투자 현황판 하위 구조와 작성 기준 (2026-07-28)

질의 원문

현황판의 구성을 전체 현황판에 개별 질문이 아니라 지역 등 큰 범위의 질문들은 별도의 하위 현황판을 만들어서 추가 분석을 모아 볼 수 있도록 해줘.

그래봐야 기존 문서가 엄청 많은게 아니잖아? 너의 제안 방식대로 해서 문제가 없으면 진행하고 현황판 작성 기준 지침을 만들고 로컬 지침에 추가해줘. claude code, codex 모두 적용해줘.

실행 경로와 시점

• 시점: 2026-07-28 KST
• 대상:
• src/realestate/dashboard/investment_board.py
• tests/test_investment_board.py
• docs/guides/투자현황판_작성기준.md
• AGENTS.md
• CLAUDE.md
• 검증 예정:
• python -m pytest tests/test_investment_board.py -q
• python -m realestate.cli invest-board

데이터 등급

구현 결과

• 전체 현황판 첫 섹션을 지역·테마별 하위 현황판으로 재구성한다.
• BOARD_GROUPS에 정의한 지역·테마 기준으로 분석 문서를 묶는다.
• 하위 현황판은 reports/boards/{board_id}.html로 생성한다.
• 각 하위 현황판은 개별 분석 렌더링 문서인 reports/analysis/*.html로 연결한다.
• 기존 개별 분석 렌더링과 최근 분석 카드 기능은 유지한다.

현재 하위 현황판

설계 결정

• 문서 수가 아직 많지 않으므로 복잡한 frontmatter 체계를 도입하지 않는다.
• 대신 BOARD_GROUPS 수동 정의 + 키워드 보조 매칭을 사용한다.
• 한 문서가 여러 큰 흐름에 걸치면 중복 배치를 허용한다.
• 생성 산출물 HTML은 직접 수정하지 않고, Markdown 원문과 생성기만 수정한다.

한계와 후속 기준

• 키워드 매칭은 보조 수단이므로 오분류가 보이면 BOARD_GROUPS 키워드를 조정한다.
• 문서가 크게 늘어나면 각 Markdown에 board: frontmatter를 추가하는 방식으로 전환할 수 있다.
• 새 분석을 추가할 때는 docs/guides/투자현황판_작성기준.md를 기준으로 현황판 그룹 배치를 함께 확인한다.