feat: add db status viewer and db cleanup baseline

docs/NEXT_SESSION_CHECKPOINT.md

@@ -53,12 +53,15 @@
   - [frontend/public/design-patterns.css](/home/hyunho/projects/mh-dashboard-organization/.dev-worktree-8081/frontend/public/design-patterns.css)
 - 디자인 기준 문서:
   - [architecture/DESIGN_SSOT.md](/home/hyunho/projects/mh-dashboard-organization/.dev-worktree-8081/docs/architecture/DESIGN_SSOT.md)
+- DB 테이블 분류 기준 문서:
+  - [architecture/DB_TABLE_CATALOG.md](/home/hyunho/projects/mh-dashboard-organization/.dev-worktree-8081/docs/architecture/DB_TABLE_CATALOG.md)
 - 로그인 기본 스타일은 [frontend/public/styles.css](/home/hyunho/projects/mh-dashboard-organization/.dev-worktree-8081/frontend/public/styles.css) 기준으로 유지
 - `8081` 허브 전용 디자인은 [frontend/public/styles-8081-design.css](/home/hyunho/projects/mh-dashboard-organization/.dev-worktree-8081/frontend/public/styles-8081-design.css)에서만 덮어씀
 - 조직현황은 [legacy/static/common.css](/home/hyunho/projects/mh-dashboard-organization/.dev-worktree-8081/legacy/static/common.css), [legacy/static/organization.css](/home/hyunho/projects/mh-dashboard-organization/.dev-worktree-8081/legacy/static/organization.css), [legacy/static/organization.js](/home/hyunho/projects/mh-dashboard-organization/.dev-worktree-8081/legacy/static/organization.js)를 사용
 - 프로젝트별 분석 디자인은 [incoming-files/served/payment.html](/home/hyunho/projects/mh-dashboard-organization/.dev-worktree-8081/incoming-files/served/payment.html) 내부에서 `design-tokens.css` + `design-patterns.css`를 참조
 - 프로젝트별 분석 수정 원본은 [frontend/apps/payment/index.html](/home/hyunho/projects/mh-dashboard-organization/.dev-worktree-8081/frontend/apps/payment/index.html) 이고, 반영은 [scripts/publish_payment_app.sh](/home/hyunho/projects/mh-dashboard-organization/.dev-worktree-8081/scripts/publish_payment_app.sh)로 한다.
 - 팀/개인별 분석 수정 원본은 [frontend/apps/team/index.html](/home/hyunho/projects/mh-dashboard-organization/.dev-worktree-8081/frontend/apps/team/index.html) 이고, 반영은 [scripts/publish_team_app.sh](/home/hyunho/projects/mh-dashboard-organization/.dev-worktree-8081/scripts/publish_team_app.sh)로 한다.
+- DB 상태 화면 수정 원본은 [frontend/apps/db-status/index.html](/home/hyunho/projects/mh-dashboard-organization/.dev-worktree-8081/frontend/apps/db-status/index.html) 이고, 반영은 [scripts/publish_db_status_app.sh](/home/hyunho/projects/mh-dashboard-organization/.dev-worktree-8081/scripts/publish_db_status_app.sh)로 한다.
 - 사업관리대장 실제 서비스 코드는 [incoming-files/served/ledger](/home/hyunho/projects/mh-dashboard-organization/.dev-worktree-8081/incoming-files/served/ledger) 기준으로 본다.
 - 사업관리대장 앱 소스 기준은 [frontend/apps/ledger](/home/hyunho/projects/mh-dashboard-organization/.dev-worktree-8081/frontend/apps/ledger) 이고, 반영은 [scripts/publish_ledger_app.sh](/home/hyunho/projects/mh-dashboard-organization/.dev-worktree-8081/scripts/publish_ledger_app.sh)로 한다.
 - 사업관리대장 상세 팝업 디자인 수정 원본은 [frontend/apps/ledger/assets/ledger-override.js](/home/hyunho/projects/mh-dashboard-organization/.dev-worktree-8081/frontend/apps/ledger/assets/ledger-override.js) 기준으로 본다.
@@ -106,6 +109,8 @@
   - [incoming-files/served/ledger/index.html](/home/hyunho/projects/mh-dashboard-organization/.dev-worktree-8081/incoming-files/served/ledger/index.html)
 - `/integrations/mh`:
   - [incoming-files/served/mh.html](/home/hyunho/projects/mh-dashboard-organization/.dev-worktree-8081/incoming-files/served/mh.html)
+- `/admin/db-status`:
+  - [incoming-files/served/db-status/index.html](/home/hyunho/projects/mh-dashboard-organization/.dev-worktree-8081/incoming-files/served/db-status/index.html)
 
 ## Cross Checks Last Confirmed
 
@@ -126,20 +131,18 @@
 
 ## Open Issues Relevant Now
 
+- `#2` 백엔드 영속 저장 구조 운영 마무리
 - `#14` 누적된 임시 로직 정리 및 중복 코드 제거
-- `#16` 사업관리대장 메인 연동 및 기본 원본 DB화
-- `#17` 8081 분리 worktree 기동 절차와 로컬 디자인 자산 복제 고정
-- `#18` 8081 파일 책임 맵 정리 및 프런트 서빙 경로 정돈
-- `#19` 8081 백엔드 라우터/서빙 책임 분리
-- `#20` 8081 worktree 준비 스크립트·문서·운영 규칙 정리
-- `#21` reference 의존 제거 및 8081 실제 서비스 코드 독립화
+- `#16` 사업관리대장 메인 후속 정리 및 기준 분석
+- `#19` 8081 백엔드 라우터/서빙 deeper 모듈 분리
+- `#21` organization 레거시 구조 승격 및 장기 고도화
 
 ## Recommended Next Work Order
 
-1. `#21` 이후 기준으로 실제 서비스 파일과 reference 파일 경계를 유지
-2. 사업관리대장 세부 데이터 정합성 보정
-3. 그 다음 화면별 앱 구조 승격 검토
-4. 필요 시 `#19`, `#20` 잔여 정리 항목 재평가
+1. `#2` 기준으로 DB 상태 화면과 저장 구조 검증 흐름 고도화
+2. `#21` 이후 기준으로 실제 서비스 파일과 reference 파일 경계를 유지
+3. 사업관리대장 세부 데이터 정합성 보정은 원본 규칙 분석 후 진행
+4. 필요 시 `#19` 잔여 정리 항목 재평가
 
 ## Quick Resume Prompt
 
@@ -150,4 +153,6 @@
 - 먼저 [WORK_RULEBOOK.md](/home/hyunho/projects/mh-dashboard-organization/.dev-worktree-8081/docs/WORK_RULEBOOK.md), [NEXT_SESSION_CHECKPOINT.md](/home/hyunho/projects/mh-dashboard-organization/.dev-worktree-8081/docs/NEXT_SESSION_CHECKPOINT.md), [architecture/8081_SERVING_MAP.md](/home/hyunho/projects/mh-dashboard-organization/.dev-worktree-8081/docs/architecture/8081_SERVING_MAP.md) 확인
 - 디자인 수정이면 [frontend/public/design-tokens.css](/home/hyunho/projects/mh-dashboard-organization/.dev-worktree-8081/frontend/public/design-tokens.css), [frontend/public/design-patterns.css](/home/hyunho/projects/mh-dashboard-organization/.dev-worktree-8081/frontend/public/design-patterns.css), [architecture/DESIGN_SSOT.md](/home/hyunho/projects/mh-dashboard-organization/.dev-worktree-8081/docs/architecture/DESIGN_SSOT.md) 먼저 확인
 - 현재 구조 독립화 기준 이슈는 `#21`
-- 작업 전 `git status`, dev 컨테이너 상태, `/api/health`, `/legacy/organization`, `/integrations/payment`, `/integrations/ledger`, `/integrations/mh`를 먼저 확인
+- `#2` 기준 DB 상태 확인은 `/api/admin/db-status` 또는 허브의 `DB 상태` 탭을 먼저 본다.
+- 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`를 먼저 확인

docs/architecture/8081_SERVING_MAP.md

@@ -47,6 +47,10 @@
   - 현재 실제 서빙 파일: `incoming-files/served/mh.html`
   - 앱 소스 기준: `frontend/apps/team/index.html`
   - publish 규칙: `scripts/publish_team_app.sh`
+- URL: `/admin/db-status`
+  - 현재 실제 서빙 파일: `incoming-files/served/db-status/index.html`
+  - 앱 소스 기준: `frontend/apps/db-status/index.html`
+  - publish 규칙: `scripts/publish_db_status_app.sh`
 
 정리 원칙:
 
@@ -109,4 +113,5 @@
 - 로그인은 `styles.css`만 본다.
 - 허브 8081 디자인은 `styles-8081-design.css`만 본다.
 - `/integrations/payment`, `/integrations/mh`의 실제 서빙 파일 위치가 문서와 코드에서 일치한다.
+- `/admin/db-status`가 현재 DB 저장 구조와 import 상태를 화면에서 바로 보여준다.
 - 기존 참고 자산을 지우지 않고도 실제 서빙 경로와 참고 경로를 구분할 수 있다.

docs/architecture/DB_TABLE_CATALOG.md

@@ -0,0 +1,160 @@
+# DB Table Catalog
+
+## Purpose
+
+이 문서는 `8081 / work-8081` 기준 현재 PostgreSQL 테이블 27개를 역할별로 분류한 운영 기준 문서다.
+
+핵심 원칙:
+
+- 테이블 수가 많다고 바로 줄이지 않는다.
+- 먼저 `유지 / 주의 / 원본·추적 / 정리 후보`로 나눈다.
+- 실제 운영 화면과 저장 흐름에 필요한 것은 유지한다.
+- 의미가 불분명하거나 중복 역할만 하는 것은 후보로 남겨두고, 실제 삭제는 별도 검증 후 진행한다.
+
+## Summary
+
+- 전체 테이블: `26`
+- 유지: `16`
+- 주의: `6`
+- 원본·추적: `4`
+- 정리 후보: `0`
+
+## 1. 유지
+
+현재 운영 화면, 인증, 이력, 적재 흐름에서 계속 필요하다.
+
+- `auth.users`
+- `auth.sessions`
+- `auth.login_audit_logs`
+- `public.members`
+- `public.member_versions`
+- `public.history_revisions`
+- `public.seat_maps`
+- `public.seat_slots`
+- `public.seat_positions`
+- `public.seat_assignment_versions`
+- `public.integration_import_batches`
+- `public.integration_projects`
+- `public.integration_work_logs`
+- `public.integration_work_log_segments`
+- `public.integration_vouchers`
+- `public.integration_binary_sources`
+
+설명:
+
+- `members`, `seat_*`는 조직현황/자리배치도 핵심
+- `member_versions`, `seat_assignment_versions`, `history_revisions`는 as-of 조회와 이력 비교 핵심
+- `integration_*` 표준화 결과는 프로젝트별 분석 / 팀·개인별 분석 핵심
+- `integration_binary_sources`는 사업관리대장 같은 바이너리 원본 보관용
+- `auth.*`는 로그인과 권한 운영 핵심
+
+## 2. 주의
+
+현재도 역할은 있지만, 실제 운영에서 얼마나 계속 필요한지 주기적으로 점검해야 한다.
+
+- `public.member_overrides`
+- `public.member_retirements`
+- `public.member_aliases`
+- `public.integration_project_aliases`
+- `public.integration_project_category_mappings`
+- `public.integration_project_pm_assignments`
+
+설명:
+
+- 이 테이블들은 핵심 마스터라기보다 “보정/매핑/예외 처리” 성격이 강하다.
+- 운영상 필요할 수 있지만, 남용되면 기준 데이터가 흐려진다.
+- 사용 규칙과 관리 책임을 분명히 해야 한다.
+
+## 3. 원본·추적
+
+원본 적재와 검증을 위해 필요하다. 직접 서비스 화면의 주 출력원이 아니라, 적재 근거와 추적용이다.
+
+- `public.integration_raw_organization_rows`
+- `public.integration_raw_mh_rows`
+- `public.integration_raw_mh_pm_rows`
+- `public.integration_raw_payment_rows`
+
+설명:
+
+- 원본 파일을 바로 표준화 테이블에만 넣으면, 나중에 적재 오류를 추적하기 어렵다.
+- raw row 보관은 import 검증과 재현성 측면에서 의미가 있다.
+- 단, 장기 보관 정책과 용량 관리는 별도 필요하다.
+
+## 4. 정리 후보
+
+현재 기준 정리 후보 테이블은 없다.
+
+## Domain Map
+
+### 인증
+
+- `auth.users`
+- `auth.sessions`
+- `auth.login_audit_logs`
+
+### 조직 / 구성원
+
+- `public.members`
+- `public.member_overrides`
+- `public.member_retirements`
+- `public.member_aliases`
+
+### 자리배치도
+
+- `public.seat_maps`
+- `public.seat_slots`
+- `public.seat_positions`
+
+### 이력
+
+- `public.history_revisions`
+- `public.member_versions`
+- `public.seat_assignment_versions`
+
+### integration 표준화
+
+- `public.integration_import_batches`
+- `public.integration_projects`
+- `public.integration_project_aliases`
+- `public.integration_project_category_mappings`
+- `public.integration_project_pm_assignments`
+- `public.integration_work_logs`
+- `public.integration_work_log_segments`
+- `public.integration_vouchers`
+- `public.integration_binary_sources`
+
+### integration raw
+
+- `public.integration_raw_organization_rows`
+- `public.integration_raw_mh_rows`
+- `public.integration_raw_mh_pm_rows`
+- `public.integration_raw_payment_rows`
+
+## Operational Guidance
+
+### 바로 줄이지 말아야 하는 것
+
+- `integration_raw_*`
+- `member_versions`
+- `seat_assignment_versions`
+- `auth.*`
+
+이건 지금 구조상 “많아 보여도 필요한 층”이다.
+
+### 먼저 점검할 것
+
+- `member_overrides`, `member_aliases`, `project_aliases`의 실제 운영 빈도
+- `seat_maps`의 과거 실험 도면 정리 기준
+
+### 정리 원칙
+
+1. 테이블을 없애기 전에 실제 읽는 API/화면/스크립트를 확인한다.
+2. 원본 추적용 테이블은 운영 출력용 테이블과 구분해서 판단한다.
+3. 테이블 삭제보다 먼저 “사용 안 함” 상태를 문서화한다.
+4. 삭제는 백업과 검증 절차가 준비된 뒤에만 한다.
+
+## Recommended Next Checks
+
+1. `seat_maps` 과거 DXF 시도본 정리 기준 수립
+2. `주의` 그룹 테이블의 입력/수정 주체 명확화
+3. `DB 상태` 화면에서 이 분류를 기준으로 계속 설명 유지