feat: add seatmap context panel and smoke checks

docs/NEXT_SESSION_CHECKPOINT.md

@@ -132,11 +132,33 @@
 ## Open Issues Relevant Now
 
 - `#2` 백엔드 영속 저장 구조 운영 마무리
+- `#7` 자리배치도 팀별 구역 색상 오버레이
+- `#8` 자리배치도 좌석 클릭 시 개인 상위 조직 트리 표시
 - `#14` 누적된 임시 로직 정리 및 중복 코드 제거
 - `#16` 사업관리대장 메인 후속 정리 및 기준 분석
 - `#19` 8081 백엔드 라우터/서빙 deeper 모듈 분리
 - `#21` organization 레거시 구조 승격 및 장기 고도화
 
+## Current Seatmap Work Note
+
+- `#8`:
+  - 자리배치도 우측 패널에 선택 인원 상위 조직 트리 표시 로직을 추가했다.
+  - 좌석 클릭 / 구성원 카드 클릭 / fixed viewer 선택 이벤트가 부모 화면으로 올라오도록 연결했다.
+  - 검색 카드 클릭은 상단 패널을 띄우지 않고 좌석 포커스만 하도록 분리했다.
+- `#7`:
+  - 해석 기준은 `개별 좌석 색칠`이 아니라 `팀이 모여 있는 좌석 군집을 하나의 구역처럼 보여주는 오버레이`다.
+  - grid 배치도와 fixed/DXF viewer 양쪽에 팀 구역 오버레이 코드를 넣었다.
+  - 현재 증상은 `처음 반짝 보였다가 사라지는 현상`이며, 데이터 부재가 아니라 viewer draw/layer 타이밍 문제로 보인다.
+  - 다음 작업 시작 시 `#7`을 먼저 재확인한다.
+- 자리배치도 카드 텍스트 규칙:
+  - `이름 - 직급 - 팀(또는 다음 조직 fallback)` 순서
+  - 검색 목록 카드에는 `chair-00` 같은 좌석 배지를 노출하지 않음
+  - 미배치 인원 카드는 외곽선만 사용하고 내부 채움색은 사용하지 않음
+- 사업관리대장 기본 원본 API 오류:
+  - 원인은 DB가 아니라 `X-Original-Filename` 한글 헤더 인코딩 오류였음
+  - [backend/app/ledger_runtime.py](/home/hyunho/projects/mh-dashboard-organization/.dev-worktree-8081/backend/app/ledger_runtime.py) 에서 URL-encoded 헤더로 수정
+  - `./scripts/check_8081_smoke.sh` 에 `ledger-default-api` 체크를 넣음
+
 ## Recommended Next Work Order
 
 1. `#2` 기준으로 DB 상태 화면과 저장 구조 검증 흐름 고도화
@@ -156,3 +178,4 @@
 - `#2` 기준 DB 상태 확인은 `/api/admin/db-status` 또는 허브의 `DB 상태` 탭(`/db-status.html`)을 먼저 본다.
 - DB 테이블 유지/주의/원본·추적/정리 후보 분류는 [architecture/DB_TABLE_CATALOG.md](/home/hyunho/projects/mh-dashboard-organization/.dev-worktree-8081/docs/architecture/DB_TABLE_CATALOG.md) 기준으로 본다.
 - 작업 전 `git status`, dev 컨테이너 상태, `/api/health`, `/legacy/organization`, `/integrations/payment`, `/integrations/ledger`, `/integrations/mh`, `/api/admin/db-status`를 먼저 확인
+- 구조 정리나 라우트 변경 직후에는 `./scripts/check_8081_smoke.sh` 를 먼저 실행해 `ledger-default-api` 까지 확인

docs/REGRESSION_CHECKLIST.md

@@ -27,6 +27,7 @@
 - `docker compose ps`에서 `backend`, `frontend`, `proxy`, `db`가 정상인지 확인
 - `8081`은 기본적으로 `./scripts/start_8081.sh` 또는 `./scripts/prepare_dev_worktree.sh` 후 `.dev-worktree-8081` 에서 `docker compose -p mh-dashboard-organization-dev --env-file .env -f docker-compose.8081.yml up -d --build` 로 기동
 - `8081` 기동 후 `docker inspect mh-dashboard-organization-dev-backend-1`에서 마운트 경로가 `.dev-worktree-8081/...`인지 확인
+- 구조 정리, 라우트 분리, 기본 원본 API 변경 후에는 먼저 `./scripts/check_8081_smoke.sh` 를 실행한다
 
 ### 2. 데이터 동기화 범위 결정
 
@@ -52,6 +53,7 @@
 - 메인 허브가 정상 렌더링된다.
 - 상단 탭 이동이 정상 동작한다.
 - 로그인 상태가 비정상적으로 풀리지 않는다.
+- `DB 상태` 탭이 정상 렌더링된다.
 
 ### B. 조직현황
 
@@ -100,6 +102,12 @@
 - `GPD`, `TDC` 선택 시 각 소속 범위만 버튼 기준으로 보인다.
 - 검색은 버튼 상태와 무관하게 전체 데이터를 검색한다.
 
+### G. 사업관리대장 기본 원본
+
+- `/api/integration/business-ledger-default` 가 `200` 이어야 한다.
+- `사업관리대장` 탭 진입 시 기본 원본이 비어 있지 않다.
+- 기본 원본 응답은 바이너리 XLSX 시그니처(`PK`)를 반환해야 한다.
+
 ## 작업 유형별 필수 추가 확인
 
 ### 조직도 / 관리자모드 수정 시

docs/WORK_EXECUTION_FLOW.md

@@ -158,6 +158,7 @@
 
 - DB 동기화
 - 코드/worktree 동기화
+- 구조 정리나 서빙 경로 수정 직후에는 `./scripts/check_8081_smoke.sh` 로 핵심 런타임을 먼저 확인
 
 ## 6. 실제 실행
 

docs/WORK_RULEBOOK.md

@@ -119,6 +119,7 @@
 검증 기준 문서:
 
 - `docs/REGRESSION_CHECKLIST.md`
+- 구조 정리, 라우트 분리, 기본 원본 API 변경 후에는 `./scripts/check_8081_smoke.sh` 를 먼저 통과시킨다.
 
 ## Rule 7. Seat Map Work Is High Risk