Clarify branch and environment rules

Polish onboarding and reference asset layout
Improve ledger filters and dev sync checks
2026-04-02 11:29:41 +09:00 · 2026-04-02 11:22:52 +09:00 · 2026-04-02 11:17:01 +09:00 · 2026-04-02 11:13:43 +09:00 · 2026-04-02 10:38:47 +09:00 · 2026-04-01 18:01:59 +09:00
70 changed files with 8121 additions and 11791 deletions
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -0,0 +1,59 @@
+# Contributing
+
+## 기본 규칙
+
+- `main`은 팀 기준 브랜치로 사용합니다.
+- `dev`는 팀 개발 통합 브랜치로 사용합니다.
+- `main`, `dev`는 브랜치이고 `8080`, `8081`은 실행 환경입니다.
+- 권장 운영은 `main -> 8080`, `dev 또는 작업 브랜치 -> 8081`입니다.
+- 기능 개발과 버그 수정은 각자 작업 브랜치에서 진행합니다.
+- 직접 `8080` 기준 파일을 수정하지 않습니다.
+- 검증은 먼저 `8081` 개발 환경에서 수행합니다.
+- 커밋은 한 기능 또는 한 버그 단위로 작게 나눕니다.
+- 작업 시작 전 [docs/TEAM_GUIDE.md](docs/TEAM_GUIDE.md)를 먼저 읽습니다.
+
+## 권장 브랜치 이름
+
+- `feature/<name>-<topic>`
+- `fix/<name>-<topic>`
+- `chore/<name>-<topic>`
+
+예:
+
+- `fix/alex-organization-save`
+- `feature/minsu-ledger-filter`
+
+## 작업 순서
+
+1. `main` 최신 상태를 받습니다.
+2. 작업 브랜치를 만듭니다.
+3. `.env.example`을 `.env`로 복사합니다.
+4. 필요한 경우 `./scripts/prepare_dev_worktree.sh`로 격리된 개발 워크스페이스를 준비합니다.
+5. `8081`에서 수정과 검증을 진행합니다.
+6. 관련 publish 스크립트가 있는 화면은 publish 후 실제 런타임 파일까지 확인합니다.
+7. `docs/REGRESSION_CHECKLIST.md` 기준으로 필요한 시나리오를 점검합니다.
+8. 커밋 후 PR을 생성합니다.
+
+## PR 규칙
+
+- PR 하나에는 한 주제만 담습니다.
+- PR 본문에 아래 내용을 포함합니다.
+  - 작업 목적
+  - 변경 범위
+  - 검증 방법
+  - DB 영향 여부
+- 공용 구조 파일 수정 시 영향 화면을 명시합니다.
+
+## 파일 수정 기준
+
+- 탭 화면 수정은 먼저 `frontend/apps/*`를 봅니다.
+- 조직현황은 `frontend/apps/organization`와 `legacy/static/*` 구조를 함께 확인합니다.
+- integration 화면 런타임은 `incoming-files/served/*`지만, 직접 수정 원본은 `frontend/apps/*`입니다.
+- 원본 참고 파일은 `incoming-files/reference/*`에만 둡니다.
+
+## 문서 기준
+
+- 저장소 진입: [README.md](README.md)
+- 작업 시작 기준: [docs/TEAM_GUIDE.md](docs/TEAM_GUIDE.md)
+- 개발/운영 DB 원칙: [docs/DEV_PROD_DB_PROTOCOL.md](docs/DEV_PROD_DB_PROTOCOL.md)
+- 실제 서빙 책임 맵: [docs/architecture/8081_SERVING_MAP.md](docs/architecture/8081_SERVING_MAP.md)
--- a/DashBoard-organization.html
+++ b/DashBoard-organization.html
@@ -8,8 +8,8 @@
  <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
  <link href="https://fonts.googleapis.com/css2?family=Pretendard:wght@400;600;700;900&display=swap" rel="stylesheet" />
  <script src="https://cdn.tailwindcss.com"></script>
-    <link rel="stylesheet" href="/legacy/static/common.css?v=20260331-01" />
-    <link rel="stylesheet" href="/legacy/static/organization.css?v=20260331-01" />
+    <link rel="stylesheet" href="/legacy/static/common.css?v=20260402-02" />
+    <link rel="stylesheet" href="/legacy/static/organization.css?v=20260402-02" />
 </head>
 <body>
  <input type="file" id="upload-excel" class="hidden" accept=".xlsx, .csv" />
@@ -60,6 +60,6 @@
    </div>
  </div>

-    <script src="/legacy/static/organization.js?v=20260331-01"></script>
+    <script src="/legacy/static/organization.js?v=20260402-02"></script>
  </body>
 </html>
--- a/README.md
+++ b/README.md
@@ -0,0 +1,63 @@
+# MH Dashboard Organization
+
+조직현황, 자리배치도, 프로젝트별 분석, 팀/개인별 분석을 하나의 대시보드로 제공하는 사내 웹 애플리케이션입니다.
+
+## 구성
+
+- `frontend/`
+  - 허브 화면과 공통 스타일
+- `frontend/apps/`
+  - 화면별 source-of-truth 앱 소스
+- `legacy/static/`
+  - 조직현황 레거시 런타임 자산
+- `incoming-files/served/`
+  - integration 화면의 실제 런타임 서빙 자산
+- `incoming-files/reference/`
+  - 원본 참고 자산
+- `backend/app/`
+  - FastAPI 백엔드
+- `scripts/`
+  - 실행, publish, 검증, 동기화 스크립트
+
+## 핵심 원칙
+
+- `frontend/apps/*`가 탭별 수정 원본입니다.
+- `incoming-files/served/*`와 `legacy/static/*`는 런타임 자산입니다.
+- 조직현황/멤버/자리배치 관련 검증은 `8081` 개발 환경에서 먼저 수행합니다.
+- `8080`은 기준 데이터와 공개 환경, `8081`은 검증 환경으로 다룹니다.
+- `main`, `dev`는 Git 브랜치이고 `8080`, `8081`은 실행 환경입니다.
+- 권장 운영은 `main -> 8080`, `dev 또는 작업 브랜치 -> 8081`입니다.
+
+## 시작 문서
+
+- 첫 문서: [docs/TEAM_GUIDE.md](docs/TEAM_GUIDE.md)
+- 협업 규칙: [CONTRIBUTING.md](CONTRIBUTING.md)
+- 개발/운영 DB 원칙: [docs/DEV_PROD_DB_PROTOCOL.md](docs/DEV_PROD_DB_PROTOCOL.md)
+- 실제 서빙 책임 맵: [docs/architecture/8081_SERVING_MAP.md](docs/architecture/8081_SERVING_MAP.md)
+- 디자인 기준: [docs/architecture/DESIGN_SSOT.md](docs/architecture/DESIGN_SSOT.md)
+
+## 빠른 실행
+
+기본 공개 환경:
+
+```bash
+cp .env.example .env
+docker compose up -d --build
+```
+
+격리된 `8081` 개발 환경:
+
+```bash
+cp .env.example .env
+./scripts/prepare_dev_worktree.sh
+cd .dev-worktree-8081
+docker compose -p mh-dashboard-organization-dev --env-file .env -f docker-compose.8081.yml up -d --build
+```
+
+## publish 스크립트
+
+- 조직현황: `./scripts/publish_organization_app.sh`
+- 프로젝트별 분석: `./scripts/publish_payment_app.sh`
+- 팀/개인별 분석: `./scripts/publish_team_app.sh`
+- 사업관리대장: `./scripts/publish_ledger_app.sh`
+- DB 상태: `./scripts/publish_db_status_app.sh`
--- a/backend/app/admin_db_status.py
+++ b/backend/app/admin_db_status.py
@@ -0,0 +1,497 @@
+from __future__ import annotations
+
+from datetime import date, datetime
+from decimal import Decimal
+
+from fastapi import HTTPException
+
+from .db import get_conn
+
+
+DB_STATUS_TABLES = [
+    {
+        "table_ref": "public.members",
+        "label": "구성원 마스터",
+        "domain": "organization",
+        "timestamp_column": "updated_at",
+        "related_views": ["조직 현황", "자리배치도"],
+        "description": "조직/구성원 화면의 기준이 되는 현재 인원 마스터",
+    },
+    {
+        "table_ref": "public.member_versions",
+        "label": "구성원 이력",
+        "domain": "history",
+        "timestamp_column": "created_at",
+        "related_views": ["조직 현황", "이력 비교"],
+        "description": "as-of 조회와 변경 이력을 위한 시점 버전",
+    },
+    {
+        "table_ref": "public.seat_maps",
+        "label": "자리배치도 도면",
+        "domain": "seatmap",
+        "timestamp_column": "updated_at",
+        "related_views": ["자리배치도"],
+        "description": "오피스별 도면 메타데이터와 활성 상태",
+    },
+    {
+        "table_ref": "public.seat_positions",
+        "label": "현재 좌석 배치",
+        "domain": "seatmap",
+        "timestamp_column": "updated_at",
+        "related_views": ["자리배치도"],
+        "description": "현재 인원의 실제 배치 좌표/슬롯 연결",
+    },
+    {
+        "table_ref": "public.seat_assignment_versions",
+        "label": "좌석 배치 이력",
+        "domain": "history",
+        "timestamp_column": "created_at",
+        "related_views": ["자리배치도", "이력 비교"],
+        "description": "자리 이동 이력과 시점 조회용 배치 버전",
+    },
+    {
+        "table_ref": "public.integration_import_batches",
+        "label": "원본 업로드 배치",
+        "domain": "integration",
+        "timestamp_column": "imported_at",
+        "related_views": ["프로젝트별 분석", "팀/개인별 분석", "조직 현황"],
+        "description": "원본 파일 적재 단위와 최근 import 기록",
+    },
+    {
+        "table_ref": "public.integration_projects",
+        "label": "통합 프로젝트 표준화",
+        "domain": "integration",
+        "timestamp_column": "updated_at",
+        "related_views": ["프로젝트별 분석", "팀/개인별 분석"],
+        "description": "프로젝트 코드/이름/카테고리 정규화 결과",
+    },
+    {
+        "table_ref": "public.integration_work_logs",
+        "label": "근무 로그 표준화",
+        "domain": "integration",
+        "timestamp_column": "updated_at",
+        "related_views": ["팀/개인별 분석"],
+        "description": "MH workbook 기준 일자별 근무 로그 본체",
+    },
+    {
+        "table_ref": "public.integration_work_log_segments",
+        "label": "근무 로그 세그먼트",
+        "domain": "integration",
+        "timestamp_column": "created_at",
+        "related_views": ["팀/개인별 분석"],
+        "description": "근무 로그를 프로젝트/활동 기준으로 분해한 상세 세그먼트",
+    },
+    {
+        "table_ref": "public.integration_vouchers",
+        "label": "전표 표준화",
+        "domain": "integration",
+        "timestamp_column": "created_at",
+        "related_views": ["프로젝트별 분석"],
+        "description": "payment CSV 기준 프로젝트별 수입/지출 전표",
+    },
+    {
+        "table_ref": "public.integration_binary_sources",
+        "label": "바이너리 원본 보관",
+        "domain": "integration",
+        "timestamp_column": "imported_at",
+        "related_views": ["사업관리대장"],
+        "description": "엑셀/바이너리 원본을 DB에 보관하는 저장소",
+    },
+    {
+        "table_ref": "auth.users",
+        "label": "인증 사용자",
+        "domain": "auth",
+        "timestamp_column": "updated_at",
+        "related_views": ["로그인", "권한"],
+        "description": "로그인 계정, role, 활성 상태",
+    },
+    {
+        "table_ref": "auth.sessions",
+        "label": "인증 세션",
+        "domain": "auth",
+        "timestamp_column": "created_at",
+        "related_views": ["로그인", "권한"],
+        "description": "현재/과거 로그인 세션과 만료 상태",
+    },
+    {
+        "table_ref": "auth.login_audit_logs",
+        "label": "로그인 감사 로그",
+        "domain": "auth",
+        "timestamp_column": "created_at",
+        "related_views": ["로그인", "권한"],
+        "description": "로그인 성공/실패 기록",
+    },
+]
+
+DB_STATUS_TABLE_META = {str(item["table_ref"]): item for item in DB_STATUS_TABLES}
+DB_STATUS_TABLE_GROUPS = {
+    "public.members": "유지",
+    "public.member_versions": "유지",
+    "public.seat_maps": "유지",
+    "public.seat_positions": "유지",
+    "public.seat_slots": "유지",
+    "public.seat_assignment_versions": "유지",
+    "public.history_revisions": "유지",
+    "public.integration_import_batches": "유지",
+    "public.integration_projects": "유지",
+    "public.integration_work_logs": "유지",
+    "public.integration_work_log_segments": "유지",
+    "public.integration_vouchers": "유지",
+    "public.integration_binary_sources": "유지",
+    "auth.users": "유지",
+    "auth.sessions": "유지",
+    "auth.login_audit_logs": "유지",
+    "public.member_overrides": "주의",
+    "public.member_retirements": "주의",
+    "public.member_aliases": "주의",
+    "public.integration_project_aliases": "주의",
+    "public.integration_project_category_mappings": "주의",
+    "public.integration_project_pm_assignments": "주의",
+    "public.integration_raw_organization_rows": "원본·추적",
+    "public.integration_raw_mh_rows": "원본·추적",
+    "public.integration_raw_mh_pm_rows": "원본·추적",
+    "public.integration_raw_payment_rows": "원본·추적",
+}
+
+DB_STATUS_PRODUCT_GROUPS = {
+    "탭 데이터": [
+        "public.members",
+        "public.seat_maps",
+        "public.seat_slots",
+        "public.seat_positions",
+        "public.integration_projects",
+        "public.integration_work_logs",
+        "public.integration_work_log_segments",
+        "public.integration_vouchers",
+        "public.integration_binary_sources",
+    ],
+    "로그인·권한": [
+        "auth.users",
+        "auth.sessions",
+        "auth.login_audit_logs",
+    ],
+    "히스토리": [
+        "public.history_revisions",
+        "public.member_versions",
+        "public.seat_assignment_versions",
+    ],
+    "로우데이터·적재": [
+        "public.integration_import_batches",
+        "public.integration_raw_organization_rows",
+        "public.integration_raw_mh_rows",
+        "public.integration_raw_mh_pm_rows",
+        "public.integration_raw_payment_rows",
+    ],
+    "보정·보조": [
+        "public.member_overrides",
+        "public.member_retirements",
+        "public.member_aliases",
+        "public.integration_project_aliases",
+        "public.integration_project_category_mappings",
+        "public.integration_project_pm_assignments",
+    ],
+}
+
+DB_STATUS_SCREEN_MAP = [
+    {
+        "screen": "조직 현황",
+        "tables": [
+            "public.members",
+            "public.member_overrides",
+            "public.member_retirements",
+            "public.member_aliases",
+            "public.member_versions",
+            "public.history_revisions",
+        ],
+        "write_flow": "원본 조직 데이터 import 후 members 계열을 갱신하고, 수정/이력 기능은 revision 기반으로 누적합니다.",
+    },
+    {
+        "screen": "자리배치도",
+        "tables": [
+            "public.seat_maps",
+            "public.seat_slots",
+            "public.seat_positions",
+            "public.seat_assignment_versions",
+            "public.history_revisions",
+            "public.members",
+        ],
+        "write_flow": "고정 오피스 도면과 현재 좌석 배치를 읽고, 저장 시 현재 배치와 배치 이력을 함께 기록합니다.",
+    },
+    {
+        "screen": "프로젝트별 분석",
+        "tables": [
+            "public.integration_import_batches",
+            "public.integration_projects",
+            "public.integration_vouchers",
+            "public.integration_project_aliases",
+            "public.integration_project_category_mappings",
+            "public.integration_project_pm_assignments",
+        ],
+        "write_flow": "payment 원본 import 결과와 프로젝트 보정 테이블을 조합해 프로젝트 집계를 만듭니다.",
+    },
+    {
+        "screen": "팀/개인별 분석",
+        "tables": [
+            "public.integration_import_batches",
+            "public.integration_projects",
+            "public.integration_work_logs",
+            "public.integration_work_log_segments",
+            "public.integration_raw_mh_rows",
+            "public.integration_raw_mh_pm_rows",
+        ],
+        "write_flow": "MH 원본 row를 적재한 뒤 표준화 로그와 세그먼트로 분해해 화면 집계에 사용합니다.",
+    },
+    {
+        "screen": "사업관리대장",
+        "tables": [
+            "public.integration_binary_sources",
+        ],
+        "write_flow": "현재는 기본 바이너리 원본 보관 상태만 DB에 유지하며, 상세 계산 규칙은 별도 기준 정렬이 필요합니다.",
+    },
+    {
+        "screen": "로그인 / 권한",
+        "tables": [
+            "auth.users",
+            "auth.sessions",
+            "auth.login_audit_logs",
+        ],
+        "write_flow": "사용자 계정, 세션, 로그인 감사 로그를 auth 스키마에서 분리 운영합니다.",
+    },
+]
+
+
+def make_json_safe(value: object) -> object:
+    if isinstance(value, datetime):
+        return value.isoformat()
+    if isinstance(value, date):
+        return value.isoformat()
+    if isinstance(value, Decimal):
+        return float(value)
+    if isinstance(value, bytes):
+        return f"<{len(value)} bytes>"
+    if isinstance(value, dict):
+        return {str(key): make_json_safe(val) for key, val in value.items()}
+    if isinstance(value, list):
+        return [make_json_safe(item) for item in value]
+    return value
+
+
+def fetch_db_status_snapshot() -> dict[str, object]:
+    table_items: list[dict[str, object]] = []
+    with get_conn() as conn:
+        with conn.cursor() as cur:
+            cur.execute(
+                """
+                SELECT schemaname, tablename
+                FROM pg_tables
+                WHERE schemaname IN ('public', 'auth')
+                ORDER BY schemaname, tablename
+                """
+            )
+            all_tables = cur.fetchall()
+            for row in all_tables:
+                schema_name = str(row["schemaname"])
+                table_name = str(row["tablename"])
+                table_ref = f"{schema_name}.{table_name}"
+                spec = DB_STATUS_TABLE_META.get(table_ref, {})
+                cur.execute("SELECT to_regclass(%s) IS NOT NULL AS table_exists", (table_ref,))
+                exists_row = cur.fetchone()
+                exists = bool(exists_row["table_exists"]) if exists_row is not None else False
+                row_count = 0
+                last_event_at = None
+                if exists:
+                    timestamp_column = str(spec.get("timestamp_column") or "")
+                    query = f"SELECT COUNT(*)::bigint AS row_count"
+                    if timestamp_column:
+                        query += f", MAX({timestamp_column}) AS last_event_at"
+                    else:
+                        query += ", NULL::timestamptz AS last_event_at"
+                    query += f" FROM {schema_name}.{table_name}"
+                    cur.execute(query)
+                    metric_row = cur.fetchone() or {}
+                    row_count = int(metric_row.get("row_count") or 0)
+                    last_event_at = metric_row.get("last_event_at")
+                table_items.append(
+                    {
+                        "table_ref": table_ref,
+                        "schema": schema_name,
+                        "table_name": table_name,
+                        "label": str(spec.get("label") or table_name),
+                        "domain": str(spec.get("domain") or "other"),
+                        "description": str(spec.get("description") or "세부 보조/원본/운영 테이블"),
+                        "related_views": spec.get("related_views") or [],
+                        "group": DB_STATUS_TABLE_GROUPS.get(table_ref, "주의"),
+                        "exists": exists,
+                        "row_count": row_count,
+                        "last_event_at": last_event_at.isoformat() if last_event_at else None,
+                    }
+                )
+
+            cur.execute(
+                """
+                SELECT source_key, source_name, row_count, source_path, imported_at
+                FROM integration_import_batches
+                ORDER BY imported_at DESC, id DESC
+                """
+            )
+            import_batches = [
+                {
+                    "source_key": str(row["source_key"] or ""),
+                    "source_name": str(row["source_name"] or ""),
+                    "row_count": int(row["row_count"] or 0),
+                    "source_path": str(row["source_path"] or ""),
+                    "imported_at": row["imported_at"].isoformat() if row.get("imported_at") else None,
+                }
+                for row in cur.fetchall()
+            ]
+
+            binary_sources: list[dict[str, object]] = []
+            cur.execute("SELECT to_regclass('public.integration_binary_sources') IS NOT NULL AS table_exists")
+            binary_exists_row = cur.fetchone()
+            binary_exists = bool(binary_exists_row["table_exists"]) if binary_exists_row is not None else False
+            if binary_exists:
+                cur.execute(
+                    """
+                    SELECT source_key, source_name, filename, mime_type, OCTET_LENGTH(content) AS byte_size,
+                           content_sha256, imported_at
+                    FROM integration_binary_sources
+                    ORDER BY imported_at DESC, id DESC
+                    """
+                )
+                binary_sources = [
+                    {
+                        "source_key": str(row["source_key"] or ""),
+                        "source_name": str(row["source_name"] or ""),
+                        "filename": str(row["filename"] or ""),
+                        "mime_type": str(row["mime_type"] or ""),
+                        "byte_size": int(row["byte_size"] or 0),
+                        "content_sha256": str(row["content_sha256"] or ""),
+                        "imported_at": row["imported_at"].isoformat() if row.get("imported_at") else None,
+                    }
+                    for row in cur.fetchall()
+                ]
+
+            cur.execute(
+                """
+                SELECT COUNT(*)::bigint AS total_members,
+                       COUNT(*) FILTER (
+                           WHERE COALESCE(BTRIM(work_status), '') <> '퇴직'
+                       )::bigint AS active_members
+                FROM members
+                """
+            )
+            member_row = cur.fetchone() or {}
+
+            cur.execute(
+                """
+                SELECT COUNT(*)::bigint AS active_seat_maps
+                FROM seat_maps
+                WHERE is_active = TRUE
+                """
+            )
+            seat_map_row = cur.fetchone() or {}
+
+            cur.execute(
+                """
+                SELECT COUNT(*)::bigint AS fixed_office_maps
+                FROM seat_maps
+                WHERE source_type = 'fixed_html'
+                """
+            )
+            fixed_office_row = cur.fetchone() or {}
+
+    overview = {
+        "visible_tables": len(DB_STATUS_TABLES),
+        "total_tables": len(table_items),
+        "existing_tables": sum(1 for item in table_items if item["exists"]),
+        "registered_members": int(member_row.get("total_members") or 0),
+        "active_members": int(member_row.get("active_members") or 0),
+        "active_seat_maps": int(seat_map_row.get("active_seat_maps") or 0),
+        "fixed_office_maps": int(fixed_office_row.get("fixed_office_maps") or 0),
+        "import_batches": len(import_batches),
+        "binary_sources": len(binary_sources),
+    }
+    group_summary = {
+        "유지": [item["table_ref"] for item in table_items if item["group"] == "유지"],
+        "주의": [item["table_ref"] for item in table_items if item["group"] == "주의"],
+        "원본·추적": [item["table_ref"] for item in table_items if item["group"] == "원본·추적"],
+        "정리 후보": [item["table_ref"] for item in table_items if item["group"] == "정리 후보"],
+    }
+    product_summary = {
+        group_name: table_refs
+        for group_name, table_refs in DB_STATUS_PRODUCT_GROUPS.items()
+    }
+    return {
+        "generated_at": datetime.utcnow().isoformat() + "Z",
+        "overview": overview,
+        "tables": table_items,
+        "import_batches": import_batches,
+        "binary_sources": binary_sources,
+        "group_summary": group_summary,
+        "product_summary": product_summary,
+        "screen_map": DB_STATUS_SCREEN_MAP,
+        "notes": [
+            "members / seat_positions / seat_maps 는 현재 운영 상태를 나타냅니다.",
+            "member_versions / seat_assignment_versions / history_revisions 는 시점 조회와 변경 이력을 위한 테이블입니다.",
+            "integration_raw_* / integration_* 는 원본 적재와 표준화 결과를 분리해서 보관합니다.",
+            "integration_binary_sources 는 사업관리대장 같은 바이너리 원본 보관용입니다.",
+            "DB를 물리적으로 합치기보다, 화면/권한/이력/로우데이터 관점으로 묶어 보는 것이 현재 운영에 더 적합합니다.",
+            "재직 인원은 조직현황과 동일하게 work_status 값이 '퇴직'이 아닌 구성원 기준입니다.",
+        ],
+    }
+
+
+def fetch_db_table_preview(schema_name: str, table_name: str, limit: int = 50) -> dict[str, object]:
+    if schema_name not in {"public", "auth"}:
+        raise HTTPException(status_code=404, detail="Unknown schema.")
+
+    with get_conn() as conn:
+        with conn.cursor() as cur:
+            cur.execute(
+                """
+                SELECT tablename
+                FROM pg_tables
+                WHERE schemaname = %s
+                  AND tablename = %s
+                """,
+                (schema_name, table_name),
+            )
+            exists_row = cur.fetchone()
+            if exists_row is None:
+                raise HTTPException(status_code=404, detail="Unknown table.")
+
+            table_ref = f"{schema_name}.{table_name}"
+            spec = DB_STATUS_TABLE_META.get(table_ref, {})
+
+            cur.execute(
+                """
+                SELECT column_name, data_type
+                FROM information_schema.columns
+                WHERE table_schema = %s
+                  AND table_name = %s
+                ORDER BY ordinal_position
+                """,
+                (schema_name, table_name),
+            )
+            columns = [{"name": str(row["column_name"]), "type": str(row["data_type"])} for row in cur.fetchall()]
+
+            cur.execute(f"SELECT COUNT(*)::bigint AS row_count FROM {schema_name}.{table_name}")
+            row_count = int((cur.fetchone() or {}).get("row_count") or 0)
+
+            safe_limit = max(1, min(int(limit), 50))
+            cur.execute(f"SELECT * FROM {schema_name}.{table_name} LIMIT {safe_limit}")
+            rows = [make_json_safe(dict(row)) for row in cur.fetchall()]
+
+    return {
+        "table_ref": table_ref,
+        "schema": schema_name,
+        "table_name": table_name,
+        "label": str(spec.get("label") or table_name),
+        "domain": str(spec.get("domain") or "other"),
+        "description": str(spec.get("description") or "세부 보조/원본/운영 테이블"),
+        "related_views": spec.get("related_views") or [],
+        "row_count": row_count,
+        "limit": safe_limit,
+        "columns": columns,
+        "rows": rows,
+    }
--- a/backend/app/auth_routes.py
+++ b/backend/app/auth_routes.py
@@ -0,0 +1,172 @@
+from __future__ import annotations
+
+from datetime import datetime, timedelta, timezone
+import uuid
+from typing import Callable
+
+from fastapi import FastAPI, Form, Header, HTTPException, Request
+
+
+def register_auth_routes(
+    app: FastAPI,
+    *,
+    get_conn,
+    verify_password: Callable[[str, str], bool],
+    build_auth_session_payload: Callable[[dict[str, object], uuid.UUID, datetime], dict[str, object]],
+    extract_bearer_token: Callable[[str | None], str | None],
+    mock_login_enabled: bool,
+    auth_session_hours: int,
+) -> None:
+    @app.post("/api/auth/login")
+    def auth_login(
+        request: Request,
+        username: str = Form(...),
+        password: str = Form(...),
+    ) -> dict[str, object]:
+        normalized_username = username.strip().lower()
+        if not normalized_username or not password.strip():
+            raise HTTPException(status_code=400, detail="사번과 비밀번호를 입력해주세요.")
+
+        ip_address = request.client.host if request.client else None
+        user_agent = request.headers.get("user-agent", "")
+
+        with get_conn() as conn:
+            with conn.cursor() as cur:
+                cur.execute(
+                    """
+                    SELECT u.id, u.username, u.password_hash, u.display_name, u.role, u.member_id, u.is_active,
+                           m.rank
+                    FROM auth.users u
+                    LEFT JOIN members m ON m.id = u.member_id
+                    WHERE LOWER(u.username) = %s
+                    """,
+                    (normalized_username,),
+                )
+                user = cur.fetchone()
+
+                if user is None:
+                    cur.execute(
+                        """
+                        INSERT INTO auth.login_audit_logs (username, success, failure_reason, ip_address, user_agent)
+                        VALUES (%s, FALSE, %s, %s, %s)
+                        """,
+                        (normalized_username, "unknown_user", ip_address, user_agent),
+                    )
+                    conn.commit()
+                    raise HTTPException(status_code=401, detail="사번 또는 비밀번호가 올바르지 않습니다.")
+
+                if not bool(user.get("is_active")):
+                    cur.execute(
+                        """
+                        INSERT INTO auth.login_audit_logs (username, user_id, success, failure_reason, ip_address, user_agent)
+                        VALUES (%s, %s, FALSE, %s, %s, %s)
+                        """,
+                        (normalized_username, int(user["id"]), "inactive_user", ip_address, user_agent),
+                    )
+                    conn.commit()
+                    raise HTTPException(status_code=403, detail="비활성화된 계정입니다.")
+
+                if not verify_password(password, str(user.get("password_hash") or "")):
+                    cur.execute(
+                        """
+                        INSERT INTO auth.login_audit_logs (username, user_id, success, failure_reason, ip_address, user_agent)
+                        VALUES (%s, %s, FALSE, %s, %s, %s)
+                        """,
+                        (normalized_username, int(user["id"]), "invalid_password", ip_address, user_agent),
+                    )
+                    conn.commit()
+                    raise HTTPException(status_code=401, detail="사번 또는 비밀번호가 올바르지 않습니다.")
+
+                expires_at = datetime.now(timezone.utc) + timedelta(hours=auth_session_hours)
+                session_id = uuid.uuid4()
+                cur.execute(
+                    """
+                    INSERT INTO auth.sessions (id, user_id, expires_at, ip_address, user_agent)
+                    VALUES (%s, %s, %s, %s, %s)
+                    """,
+                    (session_id, int(user["id"]), expires_at, ip_address, user_agent),
+                )
+                cur.execute(
+                    "UPDATE auth.users SET last_login_at = NOW(), updated_at = NOW() WHERE id = %s",
+                    (int(user["id"]),),
+                )
+                cur.execute(
+                    """
+                    INSERT INTO auth.login_audit_logs (username, user_id, success, failure_reason, ip_address, user_agent)
+                    VALUES (%s, %s, TRUE, NULL, %s, %s)
+                    """,
+                    (normalized_username, int(user["id"]), ip_address, user_agent),
+                )
+            conn.commit()
+
+        return build_auth_session_payload(user, session_id, expires_at)
+
+    @app.post("/api/auth/logout")
+    def auth_logout(authorization: str | None = Header(default=None)) -> dict[str, bool]:
+        token = extract_bearer_token(authorization)
+        if not token:
+            return {"ok": True}
+
+        with get_conn() as conn:
+            with conn.cursor() as cur:
+                cur.execute(
+                    """
+                    UPDATE auth.sessions
+                    SET revoked_at = NOW()
+                    WHERE id = %s
+                      AND revoked_at IS NULL
+                    """,
+                    (token,),
+                )
+            conn.commit()
+        return {"ok": True}
+
+    @app.get("/api/auth/me")
+    def auth_me(authorization: str | None = Header(default=None)) -> dict[str, object]:
+        token = extract_bearer_token(authorization)
+        if not token:
+            raise HTTPException(status_code=401, detail="인증 정보가 없습니다.")
+
+        with get_conn() as conn:
+            with conn.cursor() as cur:
+                cur.execute(
+                    """
+                    SELECT s.id AS session_id, s.expires_at, s.revoked_at,
+                           u.id, u.username, u.display_name, u.role, u.member_id, u.is_active,
+                           m.rank
+                    FROM auth.sessions s
+                    JOIN auth.users u ON u.id = s.user_id
+                    LEFT JOIN members m ON m.id = u.member_id
+                    WHERE s.id = %s
+                    """,
+                    (token,),
+                )
+                row = cur.fetchone()
+
+        if row is None or row.get("revoked_at") is not None:
+            raise HTTPException(status_code=401, detail="세션이 유효하지 않습니다.")
+
+        expires_at = row["expires_at"]
+        now_utc = datetime.now(timezone.utc)
+        if expires_at is None or expires_at <= now_utc:
+            raise HTTPException(status_code=401, detail="세션이 만료되었습니다.")
+
+        if not bool(row.get("is_active")):
+            raise HTTPException(status_code=403, detail="비활성화된 계정입니다.")
+
+        return build_auth_session_payload(row, uuid.UUID(str(row["session_id"])), expires_at)
+
+    @app.post("/api/mock-login")
+    def mock_login(username: str = Form(...), password: str = Form(...)) -> dict[str, object]:
+        if not mock_login_enabled:
+            raise HTTPException(status_code=403, detail="Mock login is disabled.")
+        if not username.strip() or not password.strip():
+            raise HTTPException(status_code=400, detail="Username and password are required.")
+        return {
+            "user": {
+                "username": username.strip(),
+                "display_name": username.strip(),
+                "role": "admin",
+            },
+            "session_expires_at": datetime.utcnow().isoformat() + "Z",
+        }
--- a/backend/app/integration_routes.py
+++ b/backend/app/integration_routes.py
@@ -0,0 +1,50 @@
+from __future__ import annotations
+
+from fastapi import FastAPI
+
+
+def register_integration_routes(
+    app: FastAPI,
+    *,
+    import_integration_sources,
+    fetch_integration_summary,
+    fetch_project_metrics,
+    fetch_member_metrics,
+    fetch_team_metrics,
+    fetch_project_breakdowns,
+    fetch_payment_source_rows,
+    fetch_mh_source_rows,
+) -> None:
+    @app.post("/api/integration/import")
+    def import_integration_data() -> dict[str, object]:
+        return import_integration_sources()
+
+    @app.get("/api/integration/summary")
+    def integration_summary() -> dict[str, object]:
+        return fetch_integration_summary()
+
+    @app.get("/api/integration/projects")
+    def integration_projects(limit: int = 500, start_date: str | None = None, end_date: str | None = None) -> dict[str, list[dict[str, object]]]:
+        safe_limit = max(1, min(limit, 5000))
+        return {"items": fetch_project_metrics(safe_limit, start_date=start_date, end_date=end_date)}
+
+    @app.get("/api/integration/members")
+    def integration_members(limit: int = 500, start_date: str | None = None, end_date: str | None = None) -> dict[str, list[dict[str, object]]]:
+        safe_limit = max(1, min(limit, 5000))
+        return {"items": fetch_member_metrics(safe_limit, start_date=start_date, end_date=end_date)}
+
+    @app.get("/api/integration/teams")
+    def integration_teams(start_date: str | None = None, end_date: str | None = None) -> dict[str, list[dict[str, object]]]:
+        return {"items": fetch_team_metrics(start_date=start_date, end_date=end_date)}
+
+    @app.get("/api/integration/project-breakdowns")
+    def integration_project_breakdowns(start_date: str | None = None, end_date: str | None = None) -> dict[str, list[dict[str, object]]]:
+        return fetch_project_breakdowns(start_date=start_date, end_date=end_date)
+
+    @app.get("/api/integration/payment-source")
+    def integration_payment_source() -> dict[str, object]:
+        return fetch_payment_source_rows()
+
+    @app.get("/api/integration/mh-source")
+    def integration_mh_source() -> dict[str, object]:
+        return fetch_mh_source_rows()
--- a/backend/app/ledger_runtime.py
+++ b/backend/app/ledger_runtime.py
@@ -0,0 +1,111 @@
+from __future__ import annotations
+
+import hashlib
+import json
+from pathlib import Path
+from urllib.parse import quote
+
+from fastapi import HTTPException
+from fastapi.responses import FileResponse, Response
+
+
+BUSINESS_LEDGER_DEFAULT_SOURCE_KEY = "business_ledger_default"
+
+
+def sync_default_business_ledger_source(cur, incoming_files_dir: Path, served_dir: Path) -> None:
+    cur.execute("SELECT to_regclass('public.integration_binary_sources') IS NOT NULL AS table_exists")
+    row = cur.fetchone()
+    table_exists = bool(row["table_exists"]) if row is not None else False
+    if not table_exists:
+        return
+
+    business_dashboard_dir = incoming_files_dir / "사업관리대장"
+    business_ledger_served_dir = served_dir / "ledger"
+    candidates = [
+        business_ledger_served_dir / "사업관리대장-1.xlsx",
+        business_dashboard_dir / "사업관리대장-1.xlsx",
+        business_dashboard_dir / "사업관리 대장-1.xlsx",
+        business_dashboard_dir / "사업관리대장.xlsx",
+        business_dashboard_dir / "사업관리 대장.xlsx",
+    ]
+    source_path = next((candidate for candidate in candidates if candidate.exists()), None)
+    if source_path is None:
+        return
+
+    content = source_path.read_bytes()
+    content_sha256 = hashlib.sha256(content).hexdigest()
+    meta_json = {
+        "byte_size": len(content),
+        "source_path": str(source_path),
+        "synced_from": "startup",
+    }
+    cur.execute(
+        """
+        INSERT INTO integration_binary_sources (
+            source_key, source_name, filename, mime_type, content, content_sha256, meta_json, imported_at
+        )
+        VALUES (%s, %s, %s, %s, %s, %s, %s::jsonb, NOW())
+        ON CONFLICT (source_key) DO UPDATE
+        SET source_name = EXCLUDED.source_name,
+            filename = EXCLUDED.filename,
+            mime_type = EXCLUDED.mime_type,
+            content = EXCLUDED.content,
+            content_sha256 = EXCLUDED.content_sha256,
+            meta_json = EXCLUDED.meta_json,
+            imported_at = NOW()
+        WHERE integration_binary_sources.content_sha256 IS DISTINCT FROM EXCLUDED.content_sha256
+           OR integration_binary_sources.filename IS DISTINCT FROM EXCLUDED.filename
+           OR integration_binary_sources.mime_type IS DISTINCT FROM EXCLUDED.mime_type
+           OR integration_binary_sources.meta_json IS DISTINCT FROM EXCLUDED.meta_json
+        """,
+        (
+            BUSINESS_LEDGER_DEFAULT_SOURCE_KEY,
+            "사업관리대장 기본 원본",
+            source_path.name,
+            "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
+            content,
+            content_sha256,
+            json.dumps(meta_json, ensure_ascii=False),
+        ),
+    )
+
+
+def build_business_ledger_default_response(cur) -> Response:
+    cur.execute(
+        """
+        SELECT filename, mime_type, content
+        FROM integration_binary_sources
+        WHERE source_key = %s
+        ORDER BY imported_at DESC
+        LIMIT 1
+        """,
+        (BUSINESS_LEDGER_DEFAULT_SOURCE_KEY,),
+    )
+    row = cur.fetchone()
+    if not row:
+        raise HTTPException(status_code=404, detail="Business ledger default source not found.")
+
+    filename = str(row["filename"] or "사업관리대장-1.xlsx")
+    headers = {
+        "Content-Disposition": 'inline; filename="business-ledger-default.xlsx"',
+        "X-Source-Filename": "business-ledger-default.xlsx",
+        "X-Original-Filename": quote(filename),
+        "Cache-Control": "no-store, no-cache, must-revalidate, max-age=0",
+        "Pragma": "no-cache",
+    }
+    return Response(
+        content=bytes(row["content"]),
+        media_type=str(
+            row["mime_type"] or "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet"
+        ),
+        headers=headers,
+    )
+
+
+def build_ledger_index_response(ledger_index_path: Path) -> FileResponse:
+    if not ledger_index_path.exists():
+        raise HTTPException(status_code=404, detail="Business ledger integration file not found.")
+    response = FileResponse(ledger_index_path)
+    response.headers["Cache-Control"] = "no-store, no-cache, must-revalidate, max-age=0"
+    response.headers["Pragma"] = "no-cache"
+    return response
--- a/backend/app/main.py
+++ b/backend/app/main.py
--- a/backend/app/member_routes.py
+++ b/backend/app/member_routes.py
@@ -0,0 +1,147 @@
+from __future__ import annotations
+
+from datetime import datetime
+from typing import Callable
+
+from fastapi import Body, FastAPI, File, HTTPException, UploadFile
+
+
+def register_member_routes(
+    app: FastAPI,
+    *,
+    get_conn,
+    member_payload_cls,
+    member_bulk_payload_cls,
+    parse_as_of: Callable[[str | None], datetime | None],
+    fetch_members: Callable[[], list[dict[str, object]]],
+    fetch_members_as_of: Callable[[object, datetime], list[dict[str, object]]],
+    build_member_compare_items: Callable[[list[dict[str, object]], list[dict[str, object]]], list[dict[str, object]]],
+    serialize_member_payload: Callable[[object, int], tuple[object, ...]],
+    sync_auth_users_from_members: Callable[[object], None],
+    create_history_revision: Callable[[object, str, str], int],
+    fetch_history_revision_created_at: Callable[[object, int], datetime],
+    sync_member_versions: Callable[[object, list[int], str, int], None],
+    sync_seat_assignment_versions: Callable[[object, list[int], str, int], None],
+    replace_members: Callable[[list[object]], list[dict[str, object]]],
+    parse_import_rows: Callable[[UploadFile, bytes], list[object]],
+) -> None:
+    @app.get("/api/members")
+    def list_members(as_of: str | None = None) -> dict[str, list[dict[str, object]]]:
+        parsed_as_of = parse_as_of(as_of)
+        if parsed_as_of is None:
+            return {"items": fetch_members()}
+        with get_conn() as conn:
+            with conn.cursor() as cur:
+                return {"items": fetch_members_as_of(cur, parsed_as_of)}
+
+    @app.get("/api/history/members/compare")
+    def compare_members_history(from_date: str, to_date: str) -> dict[str, list[dict[str, object]]]:
+        parsed_from = parse_as_of(from_date)
+        parsed_to = parse_as_of(to_date)
+        if parsed_from is None or parsed_to is None:
+            raise HTTPException(status_code=400, detail="from_date and to_date are required.")
+        with get_conn() as conn:
+            with conn.cursor() as cur:
+                from_items = fetch_members_as_of(cur, parsed_from)
+                to_items = fetch_members_as_of(cur, parsed_to)
+        return {"items": build_member_compare_items(from_items, to_items)}
+
+    @app.post("/api/members")
+    def create_member(payload: dict = Body(...)) -> dict[str, object]:
+        payload = member_payload_cls.model_validate(payload)
+        with get_conn() as conn:
+            with conn.cursor() as cur:
+                cur.execute("SELECT COALESCE(MAX(sort_order), -1) + 1 AS next_order FROM members")
+                next_order = int(cur.fetchone()["next_order"])
+                cur.execute(
+                    """
+                    INSERT INTO members (
+                        name, employee_id, company, rank, role, department, grp, division, team, cell,
+                        work_status, work_time, phone, email, seat_label, photo_url, sort_order
+                    )
+                    VALUES (%s, %s, %s, %s, %s, %s, %s, %s, %s, %s, %s, %s, %s, %s, %s, %s, %s)
+                    RETURNING id, name, employee_id, company, rank, role, department, grp, division, team, cell,
+                              work_status, work_time, phone, email, seat_label, photo_url,
+                              sort_order, created_at, updated_at
+                    """,
+                    serialize_member_payload(payload, payload.sort_order if payload.sort_order is not None else next_order),
+                )
+                member = cur.fetchone()
+                sync_auth_users_from_members(cur)
+                revision_no = create_history_revision(cur, "member-create", f"Member created id={int(member['id'])}")
+                revision_created_at = fetch_history_revision_created_at(cur, revision_no)
+                sync_member_versions(cur, [int(member["id"])], "member-create", revision_no, revision_created_at)
+            conn.commit()
+        return {"item": member}
+
+    @app.put("/api/members/bulk-sync")
+    def bulk_sync_members(payload: dict = Body(...)) -> dict[str, list[dict[str, object]]]:
+        payload = member_bulk_payload_cls.model_validate(payload)
+        return {"items": replace_members(payload.items)}
+
+    @app.put("/api/members/{member_id}")
+    def update_member(member_id: int, payload: dict = Body(...)) -> dict[str, object]:
+        payload = member_payload_cls.model_validate(payload)
+        with get_conn() as conn:
+            with conn.cursor() as cur:
+                cur.execute(
+                    """
+                    UPDATE members
+                    SET name = %s,
+                        employee_id = %s,
+                        company = %s,
+                        rank = %s,
+                        role = %s,
+                        department = %s,
+                        grp = %s,
+                        division = %s,
+                        team = %s,
+                        cell = %s,
+                        work_status = %s,
+                        work_time = %s,
+                        phone = %s,
+                        email = %s,
+                        seat_label = %s,
+                        photo_url = %s,
+                        sort_order = COALESCE(%s, sort_order),
+                        updated_at = NOW()
+                    WHERE id = %s
+                    RETURNING id, name, employee_id, company, rank, role, department, grp, division, team, cell,
+                              work_status, work_time, phone, email, seat_label, photo_url,
+                              sort_order, created_at, updated_at
+                    """,
+                    (*serialize_member_payload(payload, payload.sort_order or 0)[:-1], payload.sort_order, member_id),
+                )
+                member = cur.fetchone()
+                if member is None:
+                    raise HTTPException(status_code=404, detail="Member not found.")
+                sync_auth_users_from_members(cur)
+                revision_no = create_history_revision(cur, "member-update", f"Member updated id={member_id}")
+                revision_created_at = fetch_history_revision_created_at(cur, revision_no)
+                sync_member_versions(cur, [member_id], "member-update", revision_no, revision_created_at)
+                sync_seat_assignment_versions(cur, [member_id], "member-update", revision_no, revision_created_at)
+            conn.commit()
+        return {"item": member}
+
+    @app.delete("/api/members/{member_id}")
+    def delete_member(member_id: int) -> dict[str, bool]:
+        with get_conn() as conn:
+            with conn.cursor() as cur:
+                cur.execute("DELETE FROM members WHERE id = %s", (member_id,))
+                deleted = cur.rowcount > 0
+                if deleted:
+                    sync_auth_users_from_members(cur)
+                    revision_no = create_history_revision(cur, "member-delete", f"Member deleted id={member_id}")
+                    revision_created_at = fetch_history_revision_created_at(cur, revision_no)
+                    sync_member_versions(cur, [member_id], "member-delete", revision_no, revision_created_at)
+                    sync_seat_assignment_versions(cur, [member_id], "member-delete", revision_no, revision_created_at)
+            conn.commit()
+        if not deleted:
+            raise HTTPException(status_code=404, detail="Member not found.")
+        return {"ok": True}
+
+    @app.post("/api/members/import")
+    async def import_members(file: UploadFile = File(...)) -> dict[str, list[dict[str, object]]]:
+        content = await file.read()
+        items = parse_import_rows(file, content)
+        return {"items": replace_members(items)}
--- a/backend/app/repositories/init.py
+++ b/backend/app/repositories/init.py
@@ -0,0 +1,19 @@
+from .organization import (
+    fetch_current_member_state,
+    fetch_current_seat_assignments,
+    fetch_history_revision,
+    fetch_history_revision_created_at,
+    fetch_history_revisions,
+    fetch_members,
+    fetch_members_as_of,
+)
+
+__all__ = [
+    "fetch_current_member_state",
+    "fetch_current_seat_assignments",
+    "fetch_history_revision",
+    "fetch_history_revision_created_at",
+    "fetch_history_revisions",
+    "fetch_members",
+    "fetch_members_as_of",
+]
--- a/backend/app/repositories/organization.py
+++ b/backend/app/repositories/organization.py
@@ -0,0 +1,145 @@
+from __future__ import annotations
+
+from datetime import date, datetime, time, timedelta
+from typing import Callable
+
+from fastapi import HTTPException
+
+
+def fetch_members(get_conn) -> list[dict[str, object]]:
+    with get_conn() as conn:
+        with conn.cursor() as cur:
+            cur.execute(
+                """
+                SELECT id, name, employee_id, company, rank, role, department, grp, division, team, cell,
+                       work_status, work_time, phone, email, seat_label, photo_url,
+                       sort_order, created_at, updated_at
+                FROM members
+                ORDER BY sort_order ASC, id ASC
+                """
+            )
+            return cur.fetchall()
+
+
+def fetch_history_revision(cur, revision_id: int) -> dict[str, object] | None:
+    cur.execute(
+        """
+        SELECT id, revision_label, created_at, note
+        FROM history_revisions
+        WHERE scope = 'organization'
+          AND id = %s
+        """,
+        (revision_id,),
+    )
+    return cur.fetchone()
+
+
+def fetch_history_revisions(
+    cur,
+    *,
+    app_timezone,
+    day: date | None = None,
+    limit: int = 100,
+) -> list[dict[str, object]]:
+    safe_limit = max(1, min(int(limit), 500))
+    if day is None:
+        cur.execute(
+            """
+            SELECT id, revision_label, created_at, note
+            FROM history_revisions
+            WHERE scope = 'organization'
+            ORDER BY created_at DESC, id DESC
+            LIMIT %s
+            """,
+            (safe_limit,),
+        )
+        return cur.fetchall()
+
+    day_start = datetime.combine(day, time.min, tzinfo=app_timezone)
+    day_end = day_start + timedelta(days=1)
+    cur.execute(
+        """
+        SELECT id, revision_label, created_at, note
+        FROM history_revisions
+        WHERE scope = 'organization'
+          AND created_at >= %s
+          AND created_at < %s
+        ORDER BY created_at ASC, id ASC
+        LIMIT %s
+        """,
+        (day_start, day_end, safe_limit),
+    )
+    return cur.fetchall()
+
+
+def fetch_history_revision_created_at(cur, revision_id: int) -> datetime:
+    revision = fetch_history_revision(cur, revision_id)
+    if revision is None:
+        raise HTTPException(status_code=404, detail="History revision not found.")
+    return revision["created_at"]
+
+
+def fetch_current_member_state(cur) -> dict[int, dict[str, object]]:
+    cur.execute(
+        """
+        SELECT id, name, employee_id, company, rank, role, department, grp, division, team, cell,
+               work_status, work_time, phone, email, seat_label, photo_url, sort_order,
+               created_at, updated_at
+        FROM members
+        """
+    )
+    return {int(row["id"]): row for row in cur.fetchall()}
+
+
+def fetch_current_seat_assignments(cur) -> dict[int, dict[str, object]]:
+    cur.execute(
+        """
+        SELECT member_id, seat_map_id, seat_slot_id, seat_label, updated_at
+        FROM seat_positions
+        """
+    )
+    return {int(row["member_id"]): row for row in cur.fetchall()}
+
+
+def fetch_members_as_of(cur, as_of: datetime) -> list[dict[str, object]]:
+    cur.execute(
+        """
+        SELECT mv.member_id AS id,
+               mv.name,
+               COALESCE(m.employee_id, '') AS employee_id,
+               mv.company,
+               mv.rank,
+               mv.role,
+               mv.department,
+               mv.grp,
+               mv.division,
+               mv.team,
+               mv.cell,
+               mv.work_status,
+               mv.work_time,
+               mv.phone,
+               mv.email,
+               COALESCE(sav.seat_label, '') AS seat_label,
+               mv.photo_url,
+               COALESCE(m.sort_order, 2147483647) AS sort_order,
+               mv.created_at,
+               mv.valid_from AS updated_at,
+               mv.valid_to AS history_valid_to,
+               mv.revision_no,
+               hr.created_at AS revision_created_at
+        FROM member_versions mv
+        LEFT JOIN members m
+          ON m.id = mv.member_id
+        LEFT JOIN history_revisions hr
+          ON hr.id = mv.revision_no
+        LEFT JOIN seat_assignment_versions sav
+          ON sav.member_id = mv.member_id
+         AND sav.valid_from <= %s
+         AND (sav.valid_to IS NULL OR sav.valid_to > %s)
+        WHERE mv.valid_from <= %s
+          AND (mv.valid_to IS NULL OR mv.valid_to > %s)
+        ORDER BY COALESCE(m.sort_order, 2147483647) ASC, mv.member_id ASC
+        """,
+        (as_of, as_of, as_of, as_of),
+    )
+    return cur.fetchall()
--- a/backend/app/routes/init.py
+++ b/backend/app/routes/init.py
@@ -0,0 +1,13 @@
+from .auth import register_auth_routes
+from .integration import register_integration_routes
+from .organization import register_member_routes
+from .seatmap import register_seatmap_routes
+from .system import register_system_routes
+
+__all__ = [
+    "register_auth_routes",
+    "register_integration_routes",
+    "register_member_routes",
+    "register_seatmap_routes",
+    "register_system_routes",
+]
--- a/backend/app/routes/auth.py
+++ b/backend/app/routes/auth.py
@@ -0,0 +1,3 @@
+from ..auth_routes import register_auth_routes
+
+__all__ = ["register_auth_routes"]
--- a/backend/app/routes/integration.py
+++ b/backend/app/routes/integration.py
@@ -0,0 +1,3 @@
+from ..integration_routes import register_integration_routes
+
+__all__ = ["register_integration_routes"]
--- a/backend/app/routes/organization.py
+++ b/backend/app/routes/organization.py
@@ -0,0 +1,3 @@
+from ..member_routes import register_member_routes
+
+__all__ = ["register_member_routes"]
--- a/backend/app/routes/seatmap.py
+++ b/backend/app/routes/seatmap.py
@@ -0,0 +1,3 @@
+from ..seatmap_routes import register_seatmap_routes
+
+__all__ = ["register_seatmap_routes"]
--- a/backend/app/routes/system.py
+++ b/backend/app/routes/system.py
@@ -0,0 +1,3 @@
+from ..system_routes import register_system_routes
+
+__all__ = ["register_system_routes"]
--- a/backend/app/schemas/init.py
+++ b/backend/app/schemas/init.py
@@ -0,0 +1,15 @@
+from .organization import (
+    MemberBulkPayload,
+    MemberPayload,
+    SeatLayoutPayload,
+    SeatLayoutPlacementPayload,
+    SeatMapPayload,
+)
+
+__all__ = [
+    "MemberBulkPayload",
+    "MemberPayload",
+    "SeatLayoutPayload",
+    "SeatLayoutPlacementPayload",
+    "SeatMapPayload",
+]
--- a/backend/app/schemas/organization.py
+++ b/backend/app/schemas/organization.py
@@ -0,0 +1,58 @@
+from __future__ import annotations
+
+from pydantic import BaseModel, Field
+
+
+class MemberPayload(BaseModel):
+    id: int | None = None
+    name: str = Field(min_length=1)
+    employee_id: str = ""
+    company: str = ""
+    rank: str = ""
+    role: str = ""
+    department: str = ""
+    grp: str = ""
+    division: str = ""
+    team: str = ""
+    cell: str = ""
+    work_status: str = ""
+    work_time: str = ""
+    phone: str = ""
+    email: str = ""
+    seat_label: str = ""
+    photo_url: str = ""
+    sort_order: int | None = None
+
+
+class MemberBulkPayload(BaseModel):
+    items: list[MemberPayload]
+
+
+class SeatMapPayload(BaseModel):
+    name: str = Field(min_length=1)
+    image_url: str = ""
+    source_type: str = "image"
+    source_url: str = ""
+    preview_svg: str = ""
+    view_box_min_x: float | None = None
+    view_box_min_y: float | None = None
+    view_box_width: float | None = None
+    view_box_height: float | None = None
+    image_width: int | None = None
+    image_height: int | None = None
+    grid_rows: int = Field(default=1, ge=1, le=200)
+    grid_cols: int = Field(default=1, ge=1, le=200)
+    cell_gap: int = Field(default=0, ge=0, le=24)
+    is_active: bool = True
+
+
+class SeatLayoutPlacementPayload(BaseModel):
+    member_id: int
+    seat_slot_id: int | None = None
+    row_index: int = Field(default=0, ge=0)
+    col_index: int = Field(default=0, ge=0)
+    seat_label: str = ""
+
+
+class SeatLayoutPayload(BaseModel):
+    placements: list[SeatLayoutPlacementPayload]
--- a/backend/app/seatmap_routes.py
+++ b/backend/app/seatmap_routes.py
@@ -0,0 +1,224 @@
+from __future__ import annotations
+
+from datetime import datetime
+from pathlib import Path
+import shutil
+import uuid
+from typing import Callable
+
+from fastapi import FastAPI, File, Form, HTTPException, UploadFile
+from fastapi.responses import HTMLResponse
+
+
+def register_seatmap_routes(
+    app: FastAPI,
+    *,
+    upload_dir: Path,
+    get_conn,
+    seat_map_payload_cls,
+    seat_layout_payload_cls,
+    fixed_office_source_key: str,
+    parse_dxf_layout: Callable[[Path], tuple[dict[str, object], list[dict[str, object]]]],
+    serialize_seat_map_payload: Callable[[object], tuple[object, ...]],
+    fetch_seat_layout: Callable[[int, object], dict[str, object]],
+    parse_as_of: Callable[[str | None], object],
+    ensure_fixed_office_seat_map: Callable[[str, bool], dict[str, object] | None],
+    build_center_chair_viewer_html: Callable[[dict[str, object]], str],
+    save_seat_layout: Callable[[int, object], list[dict[str, object]]],
+) -> None:
+    @app.post("/api/uploads/profile-photo")
+    def upload_profile_photo(file: UploadFile = File(...), member_name: str = Form("")) -> dict[str, str]:
+        suffix = Path(file.filename or "").suffix.lower()
+        if suffix not in {".png", ".jpg", ".jpeg", ".webp", ".gif"}:
+            raise HTTPException(status_code=400, detail="Only image files are allowed.")
+        stem = member_name.strip().replace(" ", "-") or "member"
+        filename = f"{datetime.utcnow().strftime('%Y%m%d%H%M%S')}-{stem}-{uuid.uuid4().hex[:8]}{suffix}"
+        target = upload_dir / filename
+        with target.open("wb") as out_file:
+            shutil.copyfileobj(file.file, out_file)
+        return {"url": f"/uploads/{filename}"}
+
+    @app.post("/api/uploads/seat-map-image")
+    def upload_seat_map_image(file: UploadFile = File(...), seat_map_name: str = Form("")) -> dict[str, str]:
+        suffix = Path(file.filename or "").suffix.lower()
+        if suffix not in {".png", ".jpg", ".jpeg", ".webp", ".gif"}:
+            raise HTTPException(status_code=400, detail="Only image files are allowed.")
+        stem = seat_map_name.strip().replace(" ", "-") or "seat-map"
+        filename = f"seat-map-{datetime.utcnow().strftime('%Y%m%d%H%M%S')}-{stem}-{uuid.uuid4().hex[:8]}{suffix}"
+        target = upload_dir / filename
+        with target.open("wb") as out_file:
+            shutil.copyfileobj(file.file, out_file)
+        return {"url": f"/uploads/{filename}"}
+
+    @app.post("/api/seat-maps/dxf")
+    async def create_dxf_seat_map(file: UploadFile = File(...), name: str = Form(...)) -> dict[str, object]:
+        suffix = Path(file.filename or "").suffix.lower()
+        if suffix != ".dxf":
+            raise HTTPException(status_code=400, detail="DXF 파일만 업로드할 수 있습니다.")
+
+        stem = name.strip().replace(" ", "-") or "seat-map"
+        filename = f"seat-map-{datetime.utcnow().strftime('%Y%m%d%H%M%S')}-{stem}-{uuid.uuid4().hex[:8]}{suffix}"
+        target = upload_dir / filename
+        content = await file.read()
+        with target.open("wb") as out_file:
+            out_file.write(content)
+
+        metadata, slots = parse_dxf_layout(target)
+
+        payload = seat_map_payload_cls(
+            name=name.strip(),
+            source_type="dxf",
+            source_url=f"/uploads/{filename}",
+            image_url="",
+            preview_svg=metadata["preview_svg"],
+            view_box_min_x=metadata["view_box_min_x"],
+            view_box_min_y=metadata["view_box_min_y"],
+            view_box_width=metadata["view_box_width"],
+            view_box_height=metadata["view_box_height"],
+            image_width=None,
+            image_height=None,
+            grid_rows=1,
+            grid_cols=1,
+            cell_gap=0,
+            is_active=True,
+        )
+
+        with get_conn() as conn:
+            with conn.cursor() as cur:
+                cur.execute("UPDATE seat_maps SET is_active = FALSE, updated_at = NOW() WHERE is_active = TRUE")
+                cur.execute(
+                    """
+                    INSERT INTO seat_maps (
+                        name, source_type, source_url, preview_svg,
+                        view_box_min_x, view_box_min_y, view_box_width, view_box_height,
+                        image_url, image_width, image_height, grid_rows, grid_cols, cell_gap, is_active
+                    )
+                    VALUES (%s, %s, %s, %s, %s, %s, %s, %s, %s, %s, %s, %s, %s, %s, %s)
+                    RETURNING id, name, source_type, source_url, preview_svg,
+                              view_box_min_x, view_box_min_y, view_box_width, view_box_height,
+                              image_url, image_width, image_height, grid_rows, grid_cols,
+                              cell_gap, is_active, created_at, updated_at
+                    """,
+                    serialize_seat_map_payload(payload),
+                )
+                seat_map = cur.fetchone()
+                for slot in slots:
+                    cur.execute(
+                        """
+                        INSERT INTO seat_slots (seat_map_id, slot_key, label, x, y, rotation, layer_name)
+                        VALUES (%s, %s, %s, %s, %s, %s, %s)
+                        """,
+                        (
+                            seat_map["id"],
+                            slot["slot_key"],
+                            slot["label"],
+                            slot["x"],
+                            slot["y"],
+                            slot["rotation"],
+                            slot["layer_name"],
+                        ),
+                    )
+            conn.commit()
+
+        return fetch_seat_layout(int(seat_map["id"]))
+
+    @app.get("/api/seat-maps/active")
+    def get_active_seat_map(office_key: str | None = None) -> dict[str, dict[str, object]]:
+        requested_key = (office_key or "").strip() or fixed_office_source_key
+        seat_map = ensure_fixed_office_seat_map(requested_key, activate=requested_key == fixed_office_source_key)
+        if seat_map is None:
+            raise HTTPException(status_code=404, detail="Active seat map not found.")
+        return {"item": seat_map}
+
+    @app.post("/api/seat-maps")
+    def create_seat_map(payload: seat_map_payload_cls) -> dict[str, dict[str, object]]:
+        with get_conn() as conn:
+            with conn.cursor() as cur:
+                if payload.is_active:
+                    cur.execute("UPDATE seat_maps SET is_active = FALSE, updated_at = NOW() WHERE is_active = TRUE")
+                cur.execute(
+                    """
+                    INSERT INTO seat_maps (
+                        name, source_type, source_url, preview_svg,
+                        view_box_min_x, view_box_min_y, view_box_width, view_box_height,
+                        image_url, image_width, image_height, grid_rows, grid_cols, cell_gap, is_active
+                    )
+                    VALUES (%s, %s, %s, %s, %s, %s, %s, %s, %s, %s, %s, %s, %s, %s, %s)
+                    RETURNING id, name, source_type, source_url, preview_svg,
+                              view_box_min_x, view_box_min_y, view_box_width, view_box_height,
+                              image_url, image_width, image_height, grid_rows, grid_cols,
+                              cell_gap, is_active, created_at, updated_at
+                    """,
+                    serialize_seat_map_payload(payload),
+                )
+                seat_map = cur.fetchone()
+            conn.commit()
+        return {"item": seat_map}
+
+    @app.put("/api/seat-maps/{seat_map_id}")
+    def update_seat_map(seat_map_id: int, payload: seat_map_payload_cls) -> dict[str, dict[str, object]]:
+        with get_conn() as conn:
+            with conn.cursor() as cur:
+                if payload.source_type != "dxf":
+                    cur.execute(
+                        """
+                        SELECT COUNT(*) AS count
+                        FROM seat_positions
+                        WHERE seat_map_id = %s
+                          AND (row_index >= %s OR col_index >= %s)
+                        """,
+                        (seat_map_id, payload.grid_rows, payload.grid_cols),
+                    )
+                    out_of_bounds_count = int(cur.fetchone()["count"])
+                    if out_of_bounds_count > 0:
+                        raise HTTPException(status_code=400, detail="현재 배치된 좌석이 새 그리드 범위를 벗어납니다. 먼저 좌석 배치를 정리하세요.")
+                if payload.is_active:
+                    cur.execute("UPDATE seat_maps SET is_active = FALSE, updated_at = NOW() WHERE is_active = TRUE AND id <> %s", (seat_map_id,))
+                cur.execute(
+                    """
+                    UPDATE seat_maps
+                    SET name = %s,
+                        source_type = %s,
+                        source_url = %s,
+                        preview_svg = %s,
+                        view_box_min_x = %s,
+                        view_box_min_y = %s,
+                        view_box_width = %s,
+                        view_box_height = %s,
+                        image_url = %s,
+                        image_width = %s,
+                        image_height = %s,
+                        grid_rows = %s,
+                        grid_cols = %s,
+                        cell_gap = %s,
+                        is_active = %s,
+                        updated_at = NOW()
+                    WHERE id = %s
+                    RETURNING id, name, source_type, source_url, preview_svg,
+                              view_box_min_x, view_box_min_y, view_box_width, view_box_height,
+                              image_url, image_width, image_height, grid_rows, grid_cols,
+                              cell_gap, is_active, created_at, updated_at
+                    """,
+                    (*serialize_seat_map_payload(payload), seat_map_id),
+                )
+                seat_map = cur.fetchone()
+                if seat_map is None:
+                    raise HTTPException(status_code=404, detail="Seat map not found.")
+            conn.commit()
+        return {"item": seat_map}
+
+    @app.get("/api/seat-maps/{seat_map_id}/layout")
+    def get_seat_layout(seat_map_id: int, as_of: str | None = None) -> dict[str, object]:
+        return fetch_seat_layout(seat_map_id, parse_as_of(as_of))
+
+    @app.get("/api/seat-maps/{seat_map_id}/viewer")
+    def get_seat_map_viewer(seat_map_id: int, as_of: str | None = None) -> HTMLResponse:
+        layout = fetch_seat_layout(seat_map_id, parse_as_of(as_of))
+        seat_map = layout.get("seat_map") or {}
+        if seat_map.get("source_type") not in {"dxf", "fixed_html"}:
+            raise HTTPException(status_code=400, detail="Viewer is only available for supported seat maps.")
+        return HTMLResponse(build_center_chair_viewer_html(layout))
+
+    @app.put("/api/seat-maps/{seat_map_id}/layout")
+    def update_seat_layout(seat_map_id: int, payload: seat_layout_payload_cls) -> dict[str, list[dict[str, object]]]:
+        return {"items": save_seat_layout(seat_map_id, payload)}
--- a/backend/app/services/init.py
+++ b/backend/app/services/init.py
@@ -0,0 +1,21 @@
+from .organization import (
+    create_history_revision,
+    merge_import_member,
+    normalize_phone,
+    pick_existing_member,
+    replace_members,
+    serialize_member_payload,
+    sync_member_versions,
+    sync_seat_assignment_versions,
+)
+
+__all__ = [
+    "create_history_revision",
+    "merge_import_member",
+    "normalize_phone",
+    "pick_existing_member",
+    "replace_members",
+    "serialize_member_payload",
+    "sync_member_versions",
+    "sync_seat_assignment_versions",
+]
--- a/backend/app/services/organization.py
+++ b/backend/app/services/organization.py
@@ -0,0 +1,350 @@
+from __future__ import annotations
+
+from datetime import datetime, timezone
+from typing import Callable
+
+from ..repositories import (
+    fetch_current_member_state,
+    fetch_current_seat_assignments,
+    fetch_history_revision_created_at,
+    fetch_members,
+)
+from ..schemas import MemberPayload
+
+
+def normalize_phone(value: object) -> str:
+    raw = str(value or "").strip()
+    digits = "".join(ch for ch in raw if ch.isdigit())
+    if not digits:
+        return ""
+    if len(digits) == 10 and not digits.startswith("0"):
+        digits = f"0{digits}"
+    if len(digits) == 11 and digits.startswith("0"):
+        return f"{digits[:3]}-{digits[3:7]}-{digits[7:]}"
+    if len(digits) == 10 and digits.startswith("0"):
+        return f"{digits[:3]}-{digits[3:6]}-{digits[6:]}"
+    return raw
+
+
+def serialize_member_payload(item, sort_order: int) -> tuple[object, ...]:
+    return (
+        item.name.strip(),
+        item.employee_id.strip(),
+        item.company.strip(),
+        item.rank.strip(),
+        item.role.strip(),
+        item.department.strip(),
+        item.grp.strip(),
+        item.division.strip(),
+        item.team.strip(),
+        item.cell.strip(),
+        item.work_status.strip(),
+        item.work_time.strip(),
+        normalize_phone(item.phone),
+        item.email.strip(),
+        item.seat_label.strip(),
+        item.photo_url.strip(),
+        sort_order,
+    )
+
+
+def create_history_revision(cur, label_prefix: str, note: str, *, app_timezone) -> int:
+    cur.execute(
+        """
+        INSERT INTO history_revisions (scope, revision_label, note)
+        VALUES ('organization', %s, %s)
+        RETURNING id
+        """,
+        (f"{label_prefix}-{datetime.now(app_timezone).strftime('%Y%m%d-%H%M%S-%f')}", note),
+    )
+    return int(cur.fetchone()["id"])
+
+
+def sync_member_versions(
+    cur,
+    member_ids: list[int],
+    change_reason: str,
+    revision_no: int,
+    effective_at: datetime | None = None,
+) -> None:
+    if not member_ids:
+        return
+    event_at = effective_at or datetime.now(timezone.utc)
+    unique_ids = sorted(set(int(member_id) for member_id in member_ids))
+    current_members = fetch_current_member_state(cur)
+    cur.execute(
+        """
+        SELECT id, member_id, name, company, rank, role, department, grp, division, team, cell,
+               work_status, work_time, phone, email, photo_url, valid_from, valid_to
+        FROM member_versions
+        WHERE member_id = ANY(%s)
+          AND valid_to IS NULL
+        """,
+        (unique_ids,),
+    )
+    active_versions = {int(row["member_id"]): row for row in cur.fetchall()}
+
+    for member_id in unique_ids:
+        current = current_members.get(member_id)
+        active = active_versions.get(member_id)
+        if current is None:
+            if active is not None:
+                cur.execute(
+                    "UPDATE member_versions SET valid_to = %s WHERE id = %s AND valid_to IS NULL",
+                    (event_at, int(active["id"])),
+                )
+            continue
+
+        current_tuple = (
+            str(current.get("name") or ""),
+            str(current.get("company") or ""),
+            str(current.get("rank") or ""),
+            str(current.get("role") or ""),
+            str(current.get("department") or ""),
+            str(current.get("grp") or ""),
+            str(current.get("division") or ""),
+            str(current.get("team") or ""),
+            str(current.get("cell") or ""),
+            str(current.get("work_status") or ""),
+            str(current.get("work_time") or ""),
+            str(current.get("phone") or ""),
+            str(current.get("email") or ""),
+            str(current.get("photo_url") or ""),
+        )
+        active_tuple = None
+        if active is not None:
+            active_tuple = (
+                str(active.get("name") or ""),
+                str(active.get("company") or ""),
+                str(active.get("rank") or ""),
+                str(active.get("role") or ""),
+                str(active.get("department") or ""),
+                str(active.get("grp") or ""),
+                str(active.get("division") or ""),
+                str(active.get("team") or ""),
+                str(active.get("cell") or ""),
+                str(active.get("work_status") or ""),
+                str(active.get("work_time") or ""),
+                str(active.get("phone") or ""),
+                str(active.get("email") or ""),
+                str(active.get("photo_url") or ""),
+            )
+        if active_tuple == current_tuple:
+            continue
+        if active is not None:
+            cur.execute(
+                "UPDATE member_versions SET valid_to = %s WHERE id = %s AND valid_to IS NULL",
+                (event_at, int(active["id"])),
+            )
+        cur.execute(
+            """
+            INSERT INTO member_versions (
+                member_id, name, company, rank, role, department, grp, division, team, cell,
+                work_status, work_time, phone, email, photo_url,
+                valid_from, valid_to, revision_no, changed_by_user_id, change_reason
+            )
+            VALUES (%s, %s, %s, %s, %s, %s, %s, %s, %s, %s, %s, %s, %s, %s, %s, %s, NULL, %s, NULL, %s)
+            """,
+            (member_id, *current_tuple, event_at, revision_no, change_reason),
+        )
+
+
+def sync_seat_assignment_versions(
+    cur,
+    member_ids: list[int],
+    change_reason: str,
+    revision_no: int,
+    effective_at: datetime | None = None,
+) -> None:
+    if not member_ids:
+        return
+    event_at = effective_at or datetime.now(timezone.utc)
+    unique_ids = sorted(set(int(member_id) for member_id in member_ids))
+    current_assignments = fetch_current_seat_assignments(cur)
+    cur.execute(
+        """
+        SELECT id, member_id, seat_map_id, seat_slot_id, seat_label
+        FROM seat_assignment_versions
+        WHERE member_id = ANY(%s)
+          AND valid_to IS NULL
+        """,
+        (unique_ids,),
+    )
+    active_versions = {int(row["member_id"]): row for row in cur.fetchall()}
+
+    for member_id in unique_ids:
+        current = current_assignments.get(member_id)
+        active = active_versions.get(member_id)
+        current_tuple = None
+        if current is not None:
+            current_tuple = (
+                current.get("seat_map_id"),
+                current.get("seat_slot_id"),
+                str(current.get("seat_label") or ""),
+            )
+        active_tuple = None
+        if active is not None:
+            active_tuple = (
+                active.get("seat_map_id"),
+                active.get("seat_slot_id"),
+                str(active.get("seat_label") or ""),
+            )
+        if active_tuple == current_tuple:
+            continue
+        if active is not None:
+            cur.execute(
+                "UPDATE seat_assignment_versions SET valid_to = %s WHERE id = %s AND valid_to IS NULL",
+                (event_at, int(active["id"])),
+            )
+        if current is None:
+            continue
+        cur.execute(
+            """
+            INSERT INTO seat_assignment_versions (
+                member_id, seat_map_id, seat_slot_id, seat_label,
+                valid_from, valid_to, revision_no, changed_by_user_id, change_reason
+            )
+            VALUES (%s, %s, %s, %s, %s, NULL, %s, NULL, %s)
+            """,
+            (
+                member_id,
+                current.get("seat_map_id"),
+                current.get("seat_slot_id"),
+                str(current.get("seat_label") or ""),
+                event_at,
+                revision_no,
+                change_reason,
+            ),
+        )
+
+
+def merge_import_member(item: MemberPayload, existing: dict[str, object] | None) -> MemberPayload:
+    if existing is None:
+        return item
+
+    payload = item.model_copy(deep=True)
+    if not payload.photo_url.strip():
+        payload.photo_url = str(existing.get("photo_url") or "")
+    if not payload.seat_label.strip():
+        payload.seat_label = str(existing.get("seat_label") or "")
+    return payload
+
+
+def pick_existing_member(
+    item: MemberPayload,
+    existing_by_employee_id: dict[str, list[dict[str, object]]],
+    existing_by_name: dict[str, list[dict[str, object]]],
+    matched_ids: set[int],
+) -> dict[str, object] | None:
+    employee_id = item.employee_id.strip()
+    if employee_id:
+        for candidate in existing_by_employee_id.get(employee_id, []):
+            candidate_id = int(candidate["id"])
+            if candidate_id not in matched_ids:
+                return candidate
+
+    name = item.name.strip()
+    if name:
+        available = [
+            candidate
+            for candidate in existing_by_name.get(name, [])
+            if int(candidate["id"]) not in matched_ids
+        ]
+        if len(available) == 1:
+            return available[0]
+
+    return None
+
+
+def replace_members(
+    items: list[MemberPayload],
+    *,
+    get_conn,
+    sync_auth_users_from_members: Callable[[object], None],
+    app_timezone,
+) -> list[dict[str, object]]:
+    with get_conn() as conn:
+        with conn.cursor() as cur:
+            cur.execute(
+                """
+                SELECT id, name, employee_id, company, rank, role, department, grp, division, team, cell,
+                       work_status, work_time, phone, email, seat_label, photo_url,
+                       sort_order, created_at, updated_at
+                FROM members
+                ORDER BY id ASC
+                """
+            )
+            existing_members = cur.fetchall()
+
+            existing_by_employee_id: dict[str, list[dict[str, object]]] = {}
+            existing_by_name: dict[str, list[dict[str, object]]] = {}
+            for member in existing_members:
+                employee_id = str(member.get("employee_id") or "").strip()
+                name = str(member.get("name") or "").strip()
+                if employee_id:
+                    existing_by_employee_id.setdefault(employee_id, []).append(member)
+                if name:
+                    existing_by_name.setdefault(name, []).append(member)
+
+            matched_ids: set[int] = set()
+            for index, item in enumerate(items):
+                existing = pick_existing_member(item, existing_by_employee_id, existing_by_name, matched_ids)
+                merged_item = merge_import_member(item, existing)
+                if existing is None:
+                    cur.execute(
+                        """
+                        INSERT INTO members (
+                            name, employee_id, company, rank, role, department, grp, division, team, cell,
+                            work_status, work_time, phone, email, seat_label, photo_url, sort_order
+                        )
+                        VALUES (%s, %s, %s, %s, %s, %s, %s, %s, %s, %s, %s, %s, %s, %s, %s, %s, %s)
+                        """,
+                        serialize_member_payload(merged_item, index),
+                    )
+                    continue
+
+                matched_ids.add(int(existing["id"]))
+                cur.execute(
+                    """
+                    UPDATE members
+                    SET name = %s,
+                        employee_id = %s,
+                        company = %s,
+                        rank = %s,
+                        role = %s,
+                        department = %s,
+                        grp = %s,
+                        division = %s,
+                        team = %s,
+                        cell = %s,
+                        work_status = %s,
+                        work_time = %s,
+                        phone = %s,
+                        email = %s,
+                        seat_label = %s,
+                        photo_url = %s,
+                        sort_order = %s,
+                        updated_at = NOW()
+                    WHERE id = %s
+                    """,
+                    (*serialize_member_payload(merged_item, index), int(existing["id"])),
+                )
+            stale_ids = [int(member["id"]) for member in existing_members if int(member["id"]) not in matched_ids]
+            if stale_ids:
+                cur.execute("DELETE FROM members WHERE id = ANY(%s)", (stale_ids,))
+            sync_auth_users_from_members(cur)
+            cur.execute("SELECT id FROM members")
+            current_ids = [int(row["id"]) for row in cur.fetchall()]
+            affected_member_ids = sorted(set(current_ids + [int(member["id"]) for member in existing_members]))
+            if affected_member_ids:
+                revision_no = create_history_revision(
+                    cur,
+                    "members-bulk-sync",
+                    "Bulk member sync applied",
+                    app_timezone=app_timezone,
+                )
+                revision_created_at = fetch_history_revision_created_at(cur, revision_no)
+                sync_member_versions(cur, affected_member_ids, "members-bulk-sync", revision_no, revision_created_at)
+                sync_seat_assignment_versions(cur, affected_member_ids, "members-bulk-sync", revision_no, revision_created_at)
+            conn.commit()
+    return fetch_members(get_conn)
--- a/backend/app/system_routes.py
+++ b/backend/app/system_routes.py
@@ -0,0 +1,120 @@
+from __future__ import annotations
+
+from datetime import datetime
+from pathlib import Path
+from typing import Callable
+
+from fastapi import FastAPI, HTTPException
+from fastapi.responses import FileResponse, Response
+
+from .admin_db_status import fetch_db_status_snapshot, fetch_db_table_preview
+
+
+def register_system_routes(
+    app: FastAPI,
+    *,
+    upload_dir: Path,
+    legacy_dir: Path,
+    incoming_files_dir: Path,
+    incoming_served_dir: Path,
+    db_status_served_dir: Path,
+    business_ledger_index_path: Path,
+    get_member_count: Callable[[], int],
+    get_conn,
+    build_business_ledger_default_response: Callable[[object], Response],
+    build_ledger_index_response: Callable[[Path], FileResponse],
+) -> None:
+    @app.get("/api/health")
+    def health() -> dict[str, object]:
+        checks = {
+            "upload_dir": upload_dir.exists(),
+        }
+
+        try:
+            member_count = get_member_count()
+            checks["database"] = True
+        except Exception:
+            member_count = None
+            checks["database"] = False
+
+        status = "ok" if all(checks.values()) else "degraded"
+        return {
+            "status": status,
+            "checks": checks,
+            "member_count": member_count,
+            "timestamp": datetime.utcnow().isoformat() + "Z",
+        }
+
+    @app.get("/api/admin/db-status")
+    def admin_db_status() -> dict[str, object]:
+        return fetch_db_status_snapshot()
+
+    @app.get("/api/admin/db-status/table")
+    def admin_db_status_table(schema: str, table: str, limit: int = 50) -> dict[str, object]:
+        return fetch_db_table_preview(schema, table, limit)
+
+    @app.get("/admin/db-status")
+    def admin_db_status_view() -> FileResponse:
+        target = db_status_served_dir / "index.html"
+        if not target.exists():
+            raise HTTPException(status_code=404, detail="DB status dashboard file not found.")
+        response = FileResponse(target)
+        response.headers["Cache-Control"] = "no-store, no-cache, must-revalidate, max-age=0"
+        response.headers["Pragma"] = "no-cache"
+        return response
+
+    @app.get("/api/integration/business-ledger-default")
+    def integration_business_ledger_default() -> Response:
+        with get_conn() as conn:
+            with conn.cursor() as cur:
+                return build_business_ledger_default_response(cur)
+
+    @app.get("/api/integration/mh-workbook")
+    def integration_mh_workbook() -> FileResponse:
+        target = incoming_files_dir / "MH.xlsx"
+        if not target.exists():
+            raise HTTPException(status_code=404, detail="MH workbook not found.")
+        return FileResponse(
+            target,
+            media_type="application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
+            filename="MH.xlsx",
+        )
+
+    @app.get("/legacy/organization")
+    def legacy_organization() -> FileResponse:
+        target = legacy_dir / "DashBoard-organization.html"
+        if not target.exists():
+            raise HTTPException(status_code=404, detail="Legacy dashboard file not found.")
+        return FileResponse(target)
+
+    @app.get("/legacy/organization-backup")
+    def legacy_organization_backup() -> FileResponse:
+        target = legacy_dir / "DashBoard-organization-backup.html"
+        if not target.exists():
+            raise HTTPException(status_code=404, detail="Legacy dashboard backup not found.")
+        return FileResponse(target)
+
+    @app.get("/integrations/payment")
+    def integration_payment() -> FileResponse:
+        target = incoming_served_dir / "payment.html"
+        if not target.exists():
+            raise HTTPException(status_code=404, detail="Payment integration file not found.")
+        return FileResponse(target)
+
+    @app.get("/integrations/ledger")
+    def integration_ledger() -> FileResponse:
+        return build_ledger_index_response(business_ledger_index_path)
+
+    @app.get("/integrations/mh")
+    def integration_mh() -> FileResponse:
+        target = incoming_served_dir / "mh.html"
+        if not target.exists():
+            raise HTTPException(status_code=404, detail="MH integration file not found.")
+        return FileResponse(target)
+
+    @app.get("/uploads/{filename}")
+    def get_upload(filename: str) -> FileResponse:
+        target = upload_dir / filename
+        if not target.exists():
+            raise HTTPException(status_code=404, detail="Upload not found.")
+        return FileResponse(target)
--- a/docs/AUTH_DB_DESIGN.md
+++ b/docs/AUTH_DB_DESIGN.md
@@ -286,9 +286,9 @@ API 보호 예시:
 기존 프론트엔드의 mock 로그인 제거.

 변경 대상:
- [frontend/public/app.js](/home/hyunho/projects/mh-dashboard-organization/frontend/public/app.js)
- [backend/app/main.py](/home/hyunho/projects/mh-dashboard-organization/backend/app/main.py)
- [backend/app/config.py](/home/hyunho/projects/mh-dashboard-organization/backend/app/config.py)
+- [frontend/public/app.js](../frontend/public/app.js)
+- [backend/app/main.py](../backend/app/main.py)
+- [backend/app/config.py](../backend/app/config.py)

 ### Phase 4

--- a/docs/DEPLOYMENT_GUIDE.md
+++ b/docs/DEPLOYMENT_GUIDE.md
@@ -23,19 +23,10 @@
 - 이 저장소를 서버로 복사합니다.
 - `.env.example`을 기준으로 `.env` 파일을 만들고 실제 DB 비밀번호를 넣습니다.

-## 4-1. 현재 로컬 PC 기준 WSL 작업 표준
- 현재 로컬 개발 서버는 `WSL2 + Ubuntu-24.04` 기준으로 구성했습니다.
- 기본 작업 사용자는 `hyunho` 입니다.
- 앞으로의 기준 작업 경로는 아래입니다.
-  - `/home/hyunho/projects/mh-dashboard-organization`
- Windows 폴더는 원본 참고용으로 남아 있을 수 있지만, 실제 실행과 개발 기준은 WSL 내부 경로로 맞추는 것을 권장합니다.
-
-## 4-2. VS Code는 어떤 경로를 열어야 하나
- VS Code 좌측 아래에 `WSL: Ubuntu-24.04` 가 보이는 상태로 여는 것이 가장 안전합니다.
- VS Code에서 `Remote-WSL: Reopen Folder in WSL` 기능으로 다시 열 수 있습니다.
- 다시 열어야 할 권장 경로는 아래입니다.
-  - `/home/hyunho/projects/mh-dashboard-organization`
- 이렇게 열면 Docker, Python, Linux 경로, 실행 환경이 실제 서버와 가장 비슷하게 맞춰집니다.
+## 4-1. 로컬 개발 환경 원칙
+- 로컬 개발은 Linux 계열 개발 환경을 권장합니다.
+- Docker, Python, 파일 경로가 실제 배포 환경과 최대한 비슷한 환경에서 작업하는 것이 안전합니다.
+- Windows 호스트를 사용하는 경우에도, 실제 실행 경로와 편집 경로가 어긋나지 않도록 주의합니다.

 ## 5. Docker 설치 관련 메모
 - 메신저에 공유된 명령어는 Ubuntu 서버에 Docker를 설치하기 위한 절차입니다.
@@ -73,8 +64,6 @@
 ## 10. 현재 로컬 테스트 접속 정보
 - 접속 주소: `http://localhost:8080`
 - 상태 확인 API: `http://localhost:8080/api/health`
- WSL 내부 실행 경로:
-  - `/home/hyunho/projects/mh-dashboard-organization`

 ## 11. 운영 검증 체크포인트
 - 엑셀 또는 CSV 업로드 후 `GET /api/members` 에서 데이터가 조회되는지 확인합니다.
--- a/docs/DEVELOPMENT_HISTORY.md
+++ b/docs/DEVELOPMENT_HISTORY.md
@@ -2,7 +2,7 @@

 ## Purpose

-이 문서는 `total` 브랜치에서 진행한 통합 작업을 기능 단위로 정리한 개발 히스토리다.
+이 문서는 이 저장소에서 진행한 통합 작업을 기능 단위로 정리한 개발 히스토리다.
 목표는 다음 두 가지다.

 - 지금까지 어떤 기능을 어떤 방식으로 붙였는지 빠르게 파악
@@ -161,12 +161,12 @@

 ### 작업 내용

- WSL 내부 `0.0.0.0:8080` 바인딩 확인
- Windows host에서 `portproxy`와 방화벽 규칙으로 다른 PC 접속 가능하게 정리
+- 개발 환경의 외부 접속 경로를 정리
+- 호스트 방화벽과 포트 포워딩 규칙으로 다른 PC 접속 가능하게 구성

 ### 유의사항

- Windows LAN IP 또는 WSL IP가 바뀌면 `portproxy`의 `connectaddress`는 다시 맞춰야 한다
+- 호스트 IP나 포워딩 대상 IP가 바뀌면 포트 포워딩 설정을 다시 맞춰야 한다
 - 운영 안정성을 위해 향후 자동화 스크립트화가 필요함

 ## 10. 인증 기본 구조 추가
@@ -226,7 +226,7 @@

 ### 설계 문서

- [HISTORY_ASOF_DB_PLAN.md](/home/hyunho/projects/mh-dashboard-organization/docs/HISTORY_ASOF_DB_PLAN.md)
+- [HISTORY_ASOF_DB_PLAN.md](HISTORY_ASOF_DB_PLAN.md)

 ## Next Focus

--- a/docs/DEV_PROD_DB_PROTOCOL.md
+++ b/docs/DEV_PROD_DB_PROTOCOL.md
@@ -10,15 +10,15 @@

 ### 코드 경로

- 공개용 `8080`: `/home/hyunho/projects/mh-dashboard-organization`
- 작업용 `8081`: `/home/hyunho/projects/mh-dashboard-organization/.dev-worktree-8081`
+- 공개용 `8080`: 메인 workspace
+- 작업용 `8081`: 메인 workspace 아래의 격리 worktree

 ### 작업용 Compose 기준

 - 공개용 `8080` stack: `docker-compose.yml`
 - 작업용 `8081` stack: `docker-compose.8081.yml`
 - 작업용 project name 기본값: `mh-dashboard-organization-dev`
- 작업용 `8081`는 반드시 `/home/hyunho/projects/mh-dashboard-organization/.dev-worktree-8081`에서 띄운다
+- 작업용 `8081`는 반드시 격리된 worktree에서 띄운다

 ### DB 볼륨

@@ -102,7 +102,7 @@
 1. `8080`과 `8081` 모두 기동 상태 확인
 2. 이번 작업이 `코드 변경`인지 `데이터 변경`인지 먼저 구분
 3. 공개용 기준 데이터가 필요한 화면이면 `8081` DB를 먼저 `8080` 기준으로 맞춤
-4. 작업 전후 검증은 [REGRESSION_CHECKLIST.md](/home/hyunho/projects/mh-dashboard-organization/docs/REGRESSION_CHECKLIST.md) 기준으로 수행
+4. 작업 전후 검증은 [REGRESSION_CHECKLIST.md](REGRESSION_CHECKLIST.md) 기준으로 수행

 ### 2. 기능 개발 중

@@ -154,7 +154,7 @@
 2. 공개용 기준 데이터가 필요한지 판단
 3. 필요하면 `8081` DB를 `8080` 기준으로 먼저 동기화
 4. 그 뒤 기능 개발과 검증 수행
-5. 검증은 [REGRESSION_CHECKLIST.md](/home/hyunho/projects/mh-dashboard-organization/docs/REGRESSION_CHECKLIST.md) 기준으로 수행
+5. 검증은 [REGRESSION_CHECKLIST.md](REGRESSION_CHECKLIST.md) 기준으로 수행
 6. 검증 완료 후 공개용에 코드 승격

 ## 다음 액션
@@ -167,14 +167,14 @@

 반복 가능한 동기화 스크립트:

- [sync_prod_db_to_dev.sh](/home/hyunho/projects/mh-dashboard-organization/scripts/sync_prod_db_to_dev.sh)
- [docker-compose.8081.yml](/home/hyunho/projects/mh-dashboard-organization/docker-compose.8081.yml)
+- [sync_prod_db_to_dev.sh](../scripts/sync_prod_db_to_dev.sh)
+- [docker-compose.8081.yml](../docker-compose.8081.yml)

 사용 방법:

 ```bash
 ./scripts/prepare_dev_worktree.sh
-cd /home/hyunho/projects/mh-dashboard-organization/.dev-worktree-8081
+cd <repo>/.dev-worktree-8081
 docker compose -p mh-dashboard-organization-dev --env-file .env -f docker-compose.8081.yml up -d --build
 ./scripts/sync_prod_db_to_dev.sh minimal
 ./scripts/sync_prod_db_to_dev.sh full
@@ -194,8 +194,8 @@ docker compose -p mh-dashboard-organization-dev --env-file .env -f docker-compos
 중요:

 - `8081`은 현재 메인 workspace를 직접 마운트하면 안 된다
- 컨테이너가 `/home/hyunho/projects/mh-dashboard-organization/...`를 물고 있으면 분리 상태가 깨진 것이다
- 정상 상태는 `docker inspect mh-dashboard-organization-dev-backend-1` 기준 마운트 소스가 `/home/hyunho/projects/mh-dashboard-organization/.dev-worktree-8081/...`로 나와야 한다
+- 컨테이너가 메인 workspace를 직접 물고 있으면 분리 상태가 깨진 것이다
+- 정상 상태는 `docker inspect mh-dashboard-organization-dev-backend-1` 기준 마운트 소스가 격리 worktree 경로로 나와야 한다

 규칙:

--- a/docs/INFRA_VALIDATION_CHECKLIST.md
+++ b/docs/INFRA_VALIDATION_CHECKLIST.md
@@ -5,7 +5,7 @@
 - 2026-03-27 기준 `curl http://localhost:8080/api/health` 정상
 - 2026-03-27 기준 `curl http://localhost:8080/api/members` 에서 `items` 비어 있지 않음
 - 다른 PC 접속도 현재 확인됨
- 개발/운영 DB 분리 운영 원칙은 [DEV_PROD_DB_PROTOCOL.md](/home/hyunho/projects/mh-dashboard-organization/docs/DEV_PROD_DB_PROTOCOL.md) 기준으로 관리
+- 개발/운영 DB 분리 운영 원칙은 [DEV_PROD_DB_PROTOCOL.md](DEV_PROD_DB_PROTOCOL.md) 기준으로 관리

 ## 1. 컨테이너 기동
 - `docker compose build`
--- a/docs/NEXT_SESSION_CHECKPOINT.md
+++ b/docs/NEXT_SESSION_CHECKPOINT.md
@@ -1,158 +0,0 @@
-# Next Session Checkpoint
-
-## Current Base
-
- `8080` 공개 기준 브랜치: `total`
- `8081` 작업 기준 브랜치: `work-8081`
- `8080` 공개 기준 커밋: `637b390`
- `8081` worktree 경로: `/home/hyunho/projects/mh-dashboard-organization/.dev-worktree-8081`
- `8081` 실제 서빙 책임 맵: [architecture/8081_SERVING_MAP.md](/home/hyunho/projects/mh-dashboard-organization/.dev-worktree-8081/docs/architecture/8081_SERVING_MAP.md)
- 메인 히스토리: [DEVELOPMENT_HISTORY.md](/home/hyunho/projects/mh-dashboard-organization/.dev-worktree-8081/docs/DEVELOPMENT_HISTORY.md)
- 작업 룰북: [WORK_RULEBOOK.md](/home/hyunho/projects/mh-dashboard-organization/.dev-worktree-8081/docs/WORK_RULEBOOK.md)
- 실행 플로우: [WORK_EXECUTION_FLOW.md](/home/hyunho/projects/mh-dashboard-organization/.dev-worktree-8081/docs/WORK_EXECUTION_FLOW.md)
- dev/prod DB 프로토콜: [DEV_PROD_DB_PROTOCOL.md](/home/hyunho/projects/mh-dashboard-organization/.dev-worktree-8081/docs/DEV_PROD_DB_PROTOCOL.md)
- 회귀 체크리스트: [REGRESSION_CHECKLIST.md](/home/hyunho/projects/mh-dashboard-organization/.dev-worktree-8081/docs/REGRESSION_CHECKLIST.md)
-
-## Mandatory Start Rule
-
-당일 첫 작업 전에는 아래 순서를 먼저 확인한다.
-
-1. 브랜치 기준 확인
-2. 열린 이슈 확인
-3. [WORK_RULEBOOK.md](/home/hyunho/projects/mh-dashboard-organization/.dev-worktree-8081/docs/WORK_RULEBOOK.md) 확인
-4. 이 문서 확인
-5. `git status`, 변경 파일, 미추적 파일 확인
-
-주의:
-
- `8080` 기준 코드는 직접 수정하지 않는다.
- 새 작업은 항상 `.dev-worktree-8081`에서 진행한다.
- 커밋과 푸시는 사용자 지시가 있을 때만 수행한다.
-
-## Confirmed Runtime Rule
-
- `8080`은 루트 workspace의 `total` 기준으로 유지한다.
- `8081`은 `.dev-worktree-8081` + `work-8081` 기준으로만 수정한다.
- `main`, `hyunho`는 보류 브랜치이며 현재 작업에 사용하지 않는다.
- `8081` 변경을 `8080`에 올릴 때는 reviewed file diff 기준으로만 반영한다.
- `8081` DB는 운영 정본이 아니라 `8080` 기준 검증용 복제본처럼 다룬다.
-
-## What Was Stabilized
-
-### Branch / Worktree Safety
-
- 기존 `8081` 작업본은 [`.dev-worktree-8081-backup-2026-04-01`](/home/hyunho/projects/mh-dashboard-organization/.dev-worktree-8081-backup-2026-04-01)로 보존
- 현재 [`.dev-worktree-8081`](/home/hyunho/projects/mh-dashboard-organization/.dev-worktree-8081)는 `work-8081` 기준으로 재생성
- `8080` 루트 workspace는 그대로 두고 분리 운영
-
-### 8081 Design / Serving Baseline
-
- 디자인 SSOT 토큰:
-  - [frontend/public/design-tokens.css](/home/hyunho/projects/mh-dashboard-organization/.dev-worktree-8081/frontend/public/design-tokens.css)
- 디자인 SSOT 패턴:
-  - [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) 기준으로 본다.
-
-디자인 수정 우선순위:
-
-1. [frontend/public/design-tokens.css](/home/hyunho/projects/mh-dashboard-organization/.dev-worktree-8081/frontend/public/design-tokens.css)
-2. [frontend/public/design-patterns.css](/home/hyunho/projects/mh-dashboard-organization/.dev-worktree-8081/frontend/public/design-patterns.css)
-3. 화면별 실제 서빙 파일
-
-주의:
-
- `incoming-files/sample style.css`는 참고 기준이지만 직접 런타임 수정 파일이 아니다.
- `incoming-files` 원본/reference 파일을 먼저 고치지 않는다.
- 새 디자인 수정은 먼저 토큰/패턴 파일에서 해결 가능한지 확인한 뒤, 불가피할 때만 화면별 파일에 내린다.
-
-### 1차 구조 정리 진행분
-
- 이슈 기준:
-  - `#14` 전체 구조 정리 umbrella
-  - `#18` 1차: 파일 책임 맵 정리 및 프런트 서빙 경로 정돈
-  - `#19` 2차: 백엔드 라우터/서빙 책임 분리
-  - `#20` 3차: worktree/스크립트/문서 정리
- 책임 맵 문서 추가:
-  - [architecture/8081_SERVING_MAP.md](/home/hyunho/projects/mh-dashboard-organization/.dev-worktree-8081/docs/architecture/8081_SERVING_MAP.md)
- `/integrations/payment`, `/integrations/mh`의 실제 서빙 파일을 분리:
-  - [incoming-files/served/payment.html](/home/hyunho/projects/mh-dashboard-organization/.dev-worktree-8081/incoming-files/served/payment.html)
-  - [incoming-files/served/mh.html](/home/hyunho/projects/mh-dashboard-organization/.dev-worktree-8081/incoming-files/served/mh.html)
- 기존 [incoming-files/payment.html](/home/hyunho/projects/mh-dashboard-organization/.dev-worktree-8081/incoming-files/payment.html), [incoming-files/mh.html](/home/hyunho/projects/mh-dashboard-organization/.dev-worktree-8081/incoming-files/mh.html)은 비교/복구용 복사본으로 당분간 유지
- backend 서빙 경로는 [backend/app/main.py](/home/hyunho/projects/mh-dashboard-organization/.dev-worktree-8081/backend/app/main.py)에서 `incoming-files/served/*`를 보도록 정리 시작
-
-## Current Actual Serving Map
-
- `/`:
-  - [frontend/public/index.html](/home/hyunho/projects/mh-dashboard-organization/.dev-worktree-8081/frontend/public/index.html)
- `/styles.css`:
-  - [frontend/public/styles.css](/home/hyunho/projects/mh-dashboard-organization/.dev-worktree-8081/frontend/public/styles.css)
- `/styles-8081-design.css`:
-  - [frontend/public/styles-8081-design.css](/home/hyunho/projects/mh-dashboard-organization/.dev-worktree-8081/frontend/public/styles-8081-design.css)
- `/legacy/organization`:
-  - [legacy/static/DashBoard-organization.html](/home/hyunho/projects/mh-dashboard-organization/.dev-worktree-8081/legacy/static/DashBoard-organization.html)
- `/integrations/payment`:
-  - [incoming-files/served/payment.html](/home/hyunho/projects/mh-dashboard-organization/.dev-worktree-8081/incoming-files/served/payment.html)
- `/integrations/ledger`:
-  - [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
-
- `8080`: `curl http://localhost:8080/api/health` 정상
- `8081` dev 컨테이너: proxy/backend/frontend/db `healthy`
- `8081` backend 내부 확인:
-  - `/api/health` 200
-  - `/legacy/organization` 200
-  - `/integrations/payment` 200
-  - `/integrations/ledger` 200
-  - `/integrations/mh` 200
- `incoming-files/served` 내 실제 서빙 파일 존재 확인
-
-주의:
-
- Codex 터미널 세션에서는 `curl http://localhost:8081`가 간헐적으로 실패할 수 있다.
- 이 경우 브라우저 확인 또는 컨테이너 내부 라우트 확인을 기준으로 판단한다.
-
-## Open Issues Relevant Now
-
- `#2` 백엔드 영속 저장 구조 운영 마무리
- `#14` 누적된 임시 로직 정리 및 중복 코드 제거
- `#16` 사업관리대장 메인 후속 정리 및 기준 분석
- `#19` 8081 백엔드 라우터/서빙 deeper 모듈 분리
- `#21` organization 레거시 구조 승격 및 장기 고도화
-
-## Recommended Next Work Order
-
-1. `#2` 기준으로 DB 상태 화면과 저장 구조 검증 흐름 고도화
-2. `#21` 이후 기준으로 실제 서비스 파일과 reference 파일 경계를 유지
-3. 사업관리대장 세부 데이터 정합성 보정은 원본 규칙 분석 후 진행
-4. 필요 시 `#19` 잔여 정리 항목 재평가
-
-## Quick Resume Prompt
-
-다음 세션 시작 시 아래 기준으로 이어가면 된다.
-
- `8080` 기준은 `total`
- `8081` 작업은 `work-8081` + `.dev-worktree-8081`
- 먼저 [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`
- `#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`를 먼저 확인
--- a/docs/REGRESSION_CHECKLIST.md
+++ b/docs/REGRESSION_CHECKLIST.md
@@ -15,8 +15,8 @@

 관련 문서:

- [DEV_PROD_DB_PROTOCOL.md](/home/hyunho/projects/mh-dashboard-organization/docs/DEV_PROD_DB_PROTOCOL.md)
- [INFRA_VALIDATION_CHECKLIST.md](/home/hyunho/projects/mh-dashboard-organization/docs/INFRA_VALIDATION_CHECKLIST.md)
+- [DEV_PROD_DB_PROTOCOL.md](DEV_PROD_DB_PROTOCOL.md)
+- [INFRA_VALIDATION_CHECKLIST.md](INFRA_VALIDATION_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`)를 반환해야 한다.
+
 ## 작업 유형별 필수 추가 확인

 ### 조직도 / 관리자모드 수정 시
--- a/docs/TEAM_GUIDE.md
+++ b/docs/TEAM_GUIDE.md
@@ -0,0 +1,172 @@
+# Team Guide
+
+이 문서는 이 저장소에서 작업할 때 가장 먼저 읽는 기준 문서다.
+
+목표는 세 가지다.
+
+- 어디를 수정해야 하는지 바로 알 수 있게 하기
+- `8080`과 `8081`을 헷갈리지 않게 하기
+- 작업 순서와 검증 기준을 하나의 문서로 시작하게 하기
+
+## 1. 먼저 이해할 구조
+
+- `frontend/apps/*`
+  - 화면별 source-of-truth
+- `incoming-files/served/*`
+  - integration 화면의 실제 런타임 파일
+- `legacy/static/*`
+  - 조직현황 레거시 런타임 파일
+- `incoming-files/reference/*`
+  - 원본 참고 자산
+- `backend/app/routes/*`
+  - API 엔드포인트 등록
+- `backend/app/services/*`
+  - 비즈니스 로직
+- `backend/app/repositories/*`
+  - DB 읽기 쿼리
+
+원칙:
+
+- source를 먼저 수정하고 runtime은 publish로 반영한다.
+- reference 파일은 비교/복구용이지 직접 수정 기준이 아니다.
+
+## 2. 환경 원칙
+
+팀 규칙 문장:
+
+- `main`과 `dev`는 코드 브랜치다.
+- `8080`과 `8081`은 실행 환경이다.
+- 브랜치 이름을 포트와 같은 뜻으로 쓰지 않는다.
+- 기본 운영은 `main`을 `8080` 기준 브랜치로 본다.
+- 개발 검증은 `dev` 또는 작업 브랜치를 `8081`에서 먼저 확인한다.
+
+- `8080`
+  - 공개 기준 환경
+  - 기준 데이터가 있는 쪽
+- `8081`
+  - 개발/검증 환경
+  - 먼저 수정하고 검증하는 쪽
+
+중요:
+
+- 새 작업은 항상 `.dev-worktree-8081` 기준으로 시작한다.
+- `8081`에서 검증되지 않은 변경을 바로 `8080`에 올리지 않는다.
+- `8081` DB는 독립 정본이 아니라 검증용 복제본처럼 다룬다.
+
+자세한 DB 운영 원칙은 [DEV_PROD_DB_PROTOCOL.md](DEV_PROD_DB_PROTOCOL.md)를 따른다.
+
+## 3. 작업 시작 순서
+
+1. 현재 브랜치와 변경 파일을 확인한다.
+2. 연결된 이슈 또는 작업 목적을 확인한다.
+3. 이번 작업의 source 파일과 runtime 파일을 구분한다.
+4. 필요한 경우 `8081` 개발 환경을 띄운다.
+5. 필요한 DB 동기화 범위를 결정한다.
+6. 수정 후 관련 시나리오를 검증한다.
+
+환경 준비:
+
+- 최초 실행 전 `.env.example`을 `.env`로 복사한다.
+- `./scripts/prepare_dev_worktree.sh`는 dev worktree에 `.env`가 없으면 `.env.example`로 기본 파일을 만든다.
+
+핵심 질문:
+
+- 지금 고치는 파일이 실제 source-of-truth가 맞는가?
+- 이 작업은 `8081`에서 먼저 검증해야 하는가?
+- DB 차이 때문에 생긴 문제는 아닌가?
+
+## 4. 수정 원칙
+
+- 한 작업은 한 기능 또는 한 버그 단위로 작게 나눈다.
+- 완료 기능은 관련 이슈 없이 함부로 건드리지 않는다.
+- 임시 우회 로직은 이유와 제거 계획이 있어야 한다.
+- 구조를 정리하더라도 기존 동작을 바꾸면 안 된다.
+
+고위험 영역:
+
+- `members`
+- `seat_maps`
+- `seat_slots`
+- `seat_positions`
+- `auth.*`
+- 동기화 스크립트
+- 스키마 변경
+
+이 영역은 변경 이유, 영향 범위, 검증 결과를 반드시 남긴다.
+
+## 5. 화면별 수정 기준
+
+### 조직현황
+
+- source: `frontend/apps/organization`
+- runtime: `DashBoard-organization.html`, `legacy/static/*`
+- publish: `./scripts/publish_organization_app.sh`
+
+### 프로젝트별 분석
+
+- source: `frontend/apps/payment/index.html`
+- runtime: `incoming-files/served/payment.html`
+- publish: `./scripts/publish_payment_app.sh`
+
+### 팀/개인별 분석
+
+- source: `frontend/apps/team/index.html`
+- runtime: `incoming-files/served/mh.html`
+- publish: `./scripts/publish_team_app.sh`
+
+### 사업관리대장
+
+- source: `frontend/apps/ledger/*`
+- runtime: `incoming-files/served/ledger/*`
+- publish: `./scripts/publish_ledger_app.sh`
+
+### DB 상태
+
+- source: `frontend/apps/db-status/index.html`
+- runtime: `incoming-files/served/db-status/index.html`
+- publish: `./scripts/publish_db_status_app.sh`
+
+실제 서빙 책임은 [architecture/8081_SERVING_MAP.md](architecture/8081_SERVING_MAP.md)에서 확인한다.
+
+## 6. 디자인 수정 원칙
+
+- 먼저 `frontend/public/design-tokens.css`
+- 다음 `frontend/public/design-patterns.css`
+- 그 다음 [architecture/DESIGN_SSOT.md](architecture/DESIGN_SSOT.md)
+- 마지막으로 화면별 파일
+
+금지:
+
+- reference 파일부터 수정하기
+- 토큰/패턴으로 해결 가능한 것을 화면별 하드코딩으로 처리하기
+- 예전 색 체계를 새 기본값으로 다시 넣기
+
+## 7. 검증 원칙
+
+- 완료 기준은 “코드를 썼다”가 아니라 “실제 동작을 검증했다”이다.
+- 구조 정리나 라우트 분리 후에는 `./scripts/check_8081_smoke.sh`를 먼저 본다.
+- 기능 수정 후에는 관련 화면만 보지 말고 주변 연동까지 확인한다.
+
+검증 세부 항목은 [REGRESSION_CHECKLIST.md](REGRESSION_CHECKLIST.md)를 따른다.
+
+자주 쓰는 DB 동기화:
+
+- 조직현황/멤버/자리배치: `./scripts/sync_prod_db_to_dev.sh minimal`
+- 분석 화면: `./scripts/sync_prod_db_to_dev.sh analysis`
+- 전체 재검증: `./scripts/sync_prod_db_to_dev.sh full`
+
+## 8. 커밋과 PR
+
+- 커밋은 한 주제만 담는다.
+- PR 본문에는 작업 목적, 변경 범위, 검증 방법, DB 영향 여부를 적는다.
+- 공용 구조 파일을 수정했으면 영향 화면을 명시한다.
+
+자세한 팀 작업 규칙은 [../CONTRIBUTING.md](../CONTRIBUTING.md)를 따른다.
+
+## 9. 이 문서 다음에 읽을 것
+
+- 협업 방식: [../CONTRIBUTING.md](../CONTRIBUTING.md)
+- DB 운영 원칙: [DEV_PROD_DB_PROTOCOL.md](DEV_PROD_DB_PROTOCOL.md)
+- 회귀 검증: [REGRESSION_CHECKLIST.md](REGRESSION_CHECKLIST.md)
+- 실제 서빙 책임: [architecture/8081_SERVING_MAP.md](architecture/8081_SERVING_MAP.md)
+- 디자인 기준: [architecture/DESIGN_SSOT.md](architecture/DESIGN_SSOT.md)
--- a/docs/TODAY_WORK_PREP_2026-03-30.md
+++ b/docs/TODAY_WORK_PREP_2026-03-30.md
@@ -1,143 +0,0 @@
-# Today Work Prep - 2026-03-30
-
-## Current Local State
-
- working branch: `total`
- HEAD: `24852d4` (`Fix seatmap slot matching and update member modal layout`)
- remote tracking: `origin/total`
- status: local branch is `ahead 2`
- open PRs: none
-
-untracked files:
-
- `docs/HISTORY_ASOF_DB_PLAN.md`
- `incoming-files/6f.html`
- `incoming-files/7f.html`
- `incoming-files/center.html`
-
-주의:
-
- `docs/NEXT_SESSION_CHECKPOINT.md` 의 최신 checked commit 은 아직 `1d15cf9` 로 남아 있다.
- 실제 최신 작업 판단은 아래 최근 2개 로컬 커밋 기준으로 보는 것이 맞다.
-
-## What Was Added After `origin/total`
-
-### Commit `d666141`
-
- 3개 고정 오피스 자리배치도 반영
-  - `technical-development-center`
-  - `hanmac-building-6f`
-  - `hanmac-building-7f`
- 백엔드 `office_key` 기반 active viewer/layout 조회 지원
- 프런트 자리배치도 탭에서 3개 오피스 선택 지원
- `scripts/sync_prod_db_to_dev.sh` 추가
- `docs/DEV_PROD_DB_PROTOCOL.md` 추가
-
-### Commit `24852d4`
-
- slot 기반 자리 저장 시 slot matching 보정
- 멤버 상세 모달 / 조직도 seat preview 레이아웃 조정
- 회귀 점검용 `docs/REGRESSION_CHECKLIST.md` 추가
- dev/prod sync script 후속 보정
-
-## Remote Branch / Issue Snapshot
-
-remote branches:
-
- `total` -> `1d15cf9`
- `hyunho` -> `8efb5da`
- `main` -> `7a0bd54`
-
-open issues:
-
- `#11` `[P0] [버그] 자리배치도 회귀 오류`
- `#12` `[P1] [DB] 공개용/작업용 seat_positions 스키마 불일치 정리`
- `#13` `[P1] [인프라] 작업용 DB 동기화 절차 안정화 및 자동화`
- `#14` `[P2] [리팩터링] 누적된 임시 로직 정리 및 중복 코드 제거`
- `#10` `[P1] [분석] 1~2월 원본 정합성 보정 및 팀/개인별 검색 범위 개선 작업 정리`
- `#9` `[P1] [이력관리] as-of date / 버전 누적 저장`
- `#8` `[P2] [자리배치도] 좌석 클릭 시 개인 상위 조직 트리 표시`
- `#7` `[P2] [자리배치도] 팀별 색상 오버레이 표시`
- `#5` `[P2] [인증] 권한 제어 마무리 및 mock login 정리`
- `#3` `[P1] [기능] 사무실 좌석 배치도 조회 및 관리자 편집 기능 고도화`
- `#2` `[P0] [인프라] 백엔드 영속 저장 구조 운영 마무리`
-
-현재 관계 해석:
-
- `#11` 은 최근 2개 커밋이 직접 겨냥한 회귀 묶음이다.
- `#12`, `#13` 은 `#11` 재발 방지용 운영 과제에 가깝다.
- `#3` 은 다중 오피스 도면 반영으로 많이 진척됐지만, 공개용 기준 회귀 검증 전에는 완료 처리하면 안 된다.
- `#2` 는 단순 구현보다 dev/prod 데이터 운영 기준 정리가 핵심으로 바뀌었다.
- `#5` 는 로그인 구현보다 권한 경계와 `/api/mock-login` 정리가 남은 상태다.
-
-## Best Starting Point Today
-
-오늘 첫 작업은 새 기능 추가보다, 최근 자리배치도/DB 동기화 작업을 검증 가능한 상태로 굳히는 쪽이 우선이다.
-
-우선순위:
-
-1. `#13` 프로토콜대로 작업용 DB를 `minimal` 범위로 동기화
-2. `docs/REGRESSION_CHECKLIST.md` 기준으로 자리배치도 회귀 확인
-3. 최근 2개 로컬 커밋을 `origin/total` 에 올릴지 결정
-4. 회귀가 남아 있으면 `#11` 계속, 없으면 `#5` 또는 `#12/#13` 후속 정리로 이동
-
-이 순서가 맞는 이유:
-
- 현재 가장 최근 변경이 seatmap + DB sync 쪽에 몰려 있다.
- 원격 `total` 은 아직 해당 수정들을 포함하지 않는다.
- 검증 없이 다른 기능으로 넘어가면 회귀 원인과 신규 작업이 다시 섞인다.
-
-## Concrete Start Checklist
-
-세션 시작 즉시:
-
-1. `docs/DEV_PROD_DB_PROTOCOL.md` 다시 확인
-2. 필요 시 `./scripts/sync_prod_db_to_dev.sh minimal`
-3. 로그인 상태 확인
-4. 아래 3개를 오피스별로 확인
-   - 관리자 DnD 배치 저장
-   - 조직도 상세 seat preview
-   - 비관리자 seatmap 진입 / 표시
-
-필수 확인 오피스:
-
- `기술개발센터`
- `한맥빌딩 6층`
- `한맥빌딩 7층`
-
-## Recommended Decision Tree
-
-### Case A. 회귀가 남아 있음
-
- 바로 `#11` 우선
- 동시에 원인 범주를 분리
-  - DB sync 실패
-  - `seat_positions` 스키마 차이
-  - 프런트 fallback 오류
-  - 저장 API 로직 오류
-
-### Case B. 회귀가 해소됨
-
- 최근 2개 커밋 푸시
- Gitea `#11`, `#3`, `#2` 코멘트 상태 업데이트
- 다음 메인 작업을 아래 중 하나로 선택
-  - `#5` 권한 제어 / mock login 제거
-  - `#12`, `#13` DB sync 안정화 마무리
-  - `#9` history / as-of 구조 착수
-
-## Suggested Main Task After Verification
-
-가장 자연스러운 다음 메인 작업은 `#5` 보다 `#12`, `#13` 마무리다.
-
-이유:
-
- 지금 이 코드베이스에서 자리배치도/조직도 검증은 DB 상태에 크게 좌우된다.
- 권한 작업을 시작해도 검증 기반이 흔들리면 다시 혼선이 생긴다.
- 반대로 sync 절차와 스키마 호환을 먼저 고정하면 이후 `#5`, `#9`, `#8`, `#7` 진행이 쉬워진다.
-
-## Short Summary
-
- 코드 최신 상태는 로컬 `total@24852d4`
- 원격 `total` 은 아직 최신 seatmap/sync 수정 전 상태
- 오늘 첫 목표는 `#11` 관련 회귀 검증과 `#12/#13` 기반 정리
- 검증 완료 전에는 새 기능보다 seatmap + DB 운영 안정화를 우선하는 것이 맞다
--- a/docs/WORK_EXECUTION_FLOW.md
+++ b/docs/WORK_EXECUTION_FLOW.md
@@ -1,269 +0,0 @@
-# Work Execution Flow
-
-## 목적
-
-이 문서는 앞으로 이 프로젝트에서 작업을 어떤 순서로 진행해야 하는지 아주 쉽게 고정하기 위한 문서다.
-
-세미나에서 들은 흐름을 이 프로젝트 기준으로 다시 쓰면 아래 순서다.
-
-1. `SSOT` 먼저 확인
-2. 이슈 생성 또는 연결
-3. 완료조건 먼저 적기
-4. 실행 계획 적기
-5. 필요한 동기화 먼저 하기
-6. 코드 수정 / 화면 작업 수행
-7. 가드레일 테스트
-8. 기록 남기기
-
-이 순서를 지키는 이유는 하나다.
-
- 작업 도중 기준이 바뀌지 않게 하기
- 임시 연결이 누적되지 않게 하기
- 나중에 봐도 왜 이렇게 했는지 알 수 있게 하기
- `8081` 작업이 `8080`을 망가뜨리지 않게 하기
-
-## 1. SSOT 먼저 확인
-
-`SSOT`는 Single Source Of Truth 의 줄임말이다.
-
-쉬운 말로:
-
- "무엇을 기준 진실로 볼 것인가"
-
-이걸 먼저 정하지 않으면 작업 중간에 기준이 계속 바뀌어서 코드가 꼬인다.
-
-이 프로젝트에서 자주 쓰는 SSOT:
-
- 공개용 코드 기준: `/home/hyunho/projects/mh-dashboard-organization`
- 작업용 코드 기준: `/home/hyunho/projects/mh-dashboard-organization/.dev-worktree-8081`
- 데이터 정본 기준: `8080` DB
- 기능 검증 기준: `8081`
- 사업관리대장 디자인 기준: `MH 통합 대시보드_260320.html`
- 허브 공통 시각 언어 기준: `sample style.css`
- 런타임 디자인 토큰 기준: `frontend/public/design-tokens.css`
- 런타임 디자인 패턴 기준: `frontend/public/design-patterns.css`
- 현재 작업 지시 기준: 연결된 Gitea 이슈
-
-작업 시작 전에 먼저 정해야 하는 질문:
-
- 이번 작업의 코드 기준은 어디인가?
- 이번 작업의 데이터 기준은 어디인가?
- 이번 화면의 디자인 기준 파일은 무엇인가?
- 지금 바꾸려는 화면이 실제로 어떤 파일에서 렌더링되는가?
-
-이걸 모르고 코드를 건드리면 높은 확률로 엉뚱한 파일을 수정하게 된다.
-
-디자인 작업 추가 규칙:
-
- 디자인 수정은 항상 `design-tokens.css`와 `design-patterns.css`를 먼저 확인한다.
- 색/패널/버튼/테이블/팝업이 공통 규칙으로 해결 가능한지 먼저 본다.
- 해결 가능하면 화면별 파일을 고치지 않고 토큰/패턴 파일에서 수정한다.
- 화면별 실제 서빙 파일은 마지막 단계에서만 조정한다.
- 원본/reference 파일은 비교용이지 직접 수정 우선 대상이 아니다.
-
-## 2. 이슈 생성 또는 연결
-
-작업은 이슈 없이 하지 않는다.
-
-이유:
-
- 왜 하는 작업인지 남기기 위해
- 중간에 범위가 커지는 걸 막기 위해
- 다음 세션에서 바로 이어가기 위해
-
-좋은 이슈는 아래 4개가 있어야 한다.
-
-1. 배경
-2. 목표
-3. 현재 상태
-4. 남은 작업
-
-이슈는 길게 쓸 필요는 없다.
-하지만 최소한 아래는 있어야 한다.
-
- 왜 이 작업을 하는지
- 어디까지가 이번 범위인지
- 무엇을 완료로 볼지
-
-## 3. 완료조건 먼저 적기
-
-이 단계가 중요하다.
-
-완료조건이 없으면 "대충 된 것 같음" 상태에서 끝나기 쉽다.
-
-좋은 완료조건 예시:
-
- `8081`이 `.dev-worktree-8081`를 실제로 마운트한다
- `사업관리대장` 탭이 원본 기준 레이아웃으로 열린다
- `8080`은 영향 없이 유지된다
- 관련 회귀 검증을 통과한다
-
-나쁜 완료조건 예시:
-
- 화면이 좀 괜찮아 보인다
- 아마 될 것 같다
- 코드 정리함
-
-완료조건은 반드시 확인 가능한 문장이어야 한다.
-
-즉:
-
- "봤을 때 예쁨"이 아니라
- "어떤 URL에서 어떤 동작이 확인됨"이어야 한다
-
-## 4. 실행 계획 적기
-
-계획은 길 필요 없다.
-
-이 프로젝트에서는 보통 아래 정도면 충분하다.
-
-1. 기준 파일과 현재 연결 구조 확인
-2. `8081` worktree 기준으로만 수정
-3. 필요한 데이터 동기화
-4. 화면/기능 수정
-5. 회귀 검증
-6. 이슈 코멘트와 체크포인트 기록
-
-핵심은:
-
- 수정 전에 먼저 구조를 파악하고
- 범위를 정하고
- 검증까지 포함해서 끝내는 것
-
-## 5. 실행 전 동기화
-
-이 프로젝트는 코드만 맞아도 안 되고, 데이터도 맞아야 한다.
-
-그래서 실행 전에 동기화가 필요할 수 있다.
-
-무슨 뜻이냐면:
-
- `8081`에서 기능 확인을 하더라도
- 데이터가 `8080`과 다르면 검증 결과를 신뢰하면 안 된다
-
-자주 쓰는 규칙:
-
- 조직도 / 멤버 / 자리배치 검증 전
-  - `./scripts/sync_prod_db_to_dev.sh minimal`
- 분석 화면까지 공개용 기준으로 맞춰야 할 때
-  - `./scripts/sync_prod_db_to_dev.sh full`
-
-또 코드 동기화도 중요하다.
-
- `8081`은 메인 workspace에서 직접 띄우지 않는다
- 먼저 `./scripts/prepare_dev_worktree.sh`
- 그 다음 `.dev-worktree-8081`에서 실행
-
-즉 이 프로젝트의 동기화는 두 종류다.
-
- DB 동기화
- 코드/worktree 동기화
-
-## 6. 실제 실행
-
-이 단계가 코드를 고치는 단계다.
-
-하지만 여기서도 규칙이 있다.
-
- `8081`에서 먼저 작업
- 기준 파일이 아닌 곳은 건드리지 않기
- 임시 우회 연결을 만들었으면 반드시 기록 남기기
- 연결 구조가 난잡해지면 바로 이슈에 `코드 정리 필요`를 남기기
-
-특히 이 프로젝트는 아래가 자주 꼬인다.
-
- `frontend/public`
- `legacy/static`
- `incoming-files`
- 정적 HTML
- iframe 연결
- 버전 쿼리스트링
-
-그래서 실행 중 계속 확인해야 한다.
-
- 지금 내가 고친 파일이 실제 서빙 파일이 맞는가?
- 지금 수정이 `8081` 전용인가, `8080` 공통인가?
- 이 연결은 임시인가, 기준 구조인가?
-
-## 7. 가드레일 테스트
-
-가드레일 테스트는 쉬운 말로:
-
- "이 수정 때문에 같이 망가지면 안 되는 것들을 확인하는 테스트"
-
-즉 핵심 기능만 보는 게 아니라, 같이 깨지기 쉬운 주변 기능까지 확인하는 것이다.
-
-이 프로젝트에서 가드레일 테스트 예시:
-
- `8081` 디자인 수정 후
-  - `8080`은 그대로인지 확인
- 조직현황 수정 후
-  - 조직도 iframe, 모달, 리스트뷰, seat preview 확인
- 자리배치 수정 후
-  - 관리자 저장
-  - 비관리자 조회
-  - 조직도 상세 seat preview
- 분석 화면 수정 후
-  - 기간 필터
-  - 프로젝트/팀 전환
-  - 빈 데이터 상태
-  - 스타일 깨짐 여부
-
-가드레일 테스트는 "다 테스트한다"가 아니다.
-
-이번 수정 때문에 같이 깨질 가능성이 높은 것만 빠르게 확인하는 것이다.
-
-## 8. 기록 남기기
-
-작업은 기록까지 남겨야 끝난다.
-
-남겨야 하는 것:
-
- 무엇을 바꿨는지
- 무엇을 기준으로 했는지
- 무엇을 검증했는지
- 무엇이 아직 안 끝났는지
- 다음에 어디서 이어야 하는지
-
-남길 위치:
-
- Gitea 이슈 코멘트
- 체크포인트 문서
- 필요하면 룰북/프로토콜 문서
-
-## 이 프로젝트용 한 줄 버전
-
-앞으로는 아래 순서로 생각하면 된다.
-
-1. 기준 진실부터 정한다
-2. 이슈에 작업 목적과 완료조건을 적는다
-3. 실행 전에 코드/DB 동기화를 맞춘다
-4. `8081`에서만 수정한다
-5. 같이 깨지면 안 되는 것까지 확인한다
-6. 결과를 기록한다
-
-## 시작할 때 바로 쓰는 짧은 템플릿
-
-작업 시작 전에 아래 6줄만 적어도 된다.
-
- SSOT:
-  - 코드 기준:
-  - 데이터 기준:
-  - 디자인 기준:
- 이슈:
- 완료조건:
- 계획:
- 필요한 동기화:
- 가드레일 테스트:
-
-예시:
-
- SSOT:
-  - 코드 기준: `/home/hyunho/projects/mh-dashboard-organization/.dev-worktree-8081`
-  - 데이터 기준: `8080` DB를 sync한 `8081`
-  - 디자인 기준: `MH 통합 대시보드_260320.html`
- 이슈: `#16`
- 완료조건: `8081`에서 사업관리대장 메인이 원본 톤으로 열리고 `8080`은 안 바뀜
- 계획: 연결 확인 → worktree 수정 → 검증 → 이슈 기록
- 필요한 동기화: `minimal`
- 가드레일 테스트: `8080 유지`, `조직현황 탭`, `프로젝트/팀 탭`
--- a/docs/WORK_RULEBOOK.md
+++ b/docs/WORK_RULEBOOK.md
@@ -1,285 +0,0 @@
-# Work Rulebook
-
-## Purpose
-
-이 문서는 이 프로젝트에서 매일 작업을 시작하고 마무리할 때 반드시 따를 운영 규칙을 고정하기 위한 룰북이다.
-
-목표는 아래 4가지다.
-
- 완료된 기능의 회귀 방지
- 코드 문제와 DB 문제의 혼선 방지
- 작업 기록 누락 방지
- 매일 같은 기준으로 안정적으로 이어서 작업
-
-## Rule 0. Morning Start Mandatory Check
-
-이 규칙은 강제 규칙이다.
-
-매일 아침 또는 그날의 첫 작업을 시작할 때는, 코드를 수정하기 전에 반드시 아래 순서를 먼저 수행한다.
-
-1. Gitea 브랜치 상태 확인
-2. 열린 이슈 확인
-3. 이 문서 `WORK_RULEBOOK.md` 확인
-4. 최신 체크포인트 문서 확인
-5. 현재 워크트리의 미푸시 커밋, 변경 파일, 미추적 파일 확인
-
-위 5단계를 확인하기 전에는 새 코드 작성, 기존 코드 수정, 임의 테스트 진행을 시작하지 않는다.
-
-즉:
-
- "오늘 첫 작업"의 시작점은 코드 수정이 아니라 상태 확인이다.
- 이 절차를 건너뛰고 바로 수정 작업에 들어가는 것은 금지한다.
-
-추가 기준:
-
- 실제 작업 순서는 [WORK_EXECUTION_FLOW.md](/home/hyunho/projects/mh-dashboard-organization/docs/WORK_EXECUTION_FLOW.md) 를 따른다.
- 특히 `SSOT → 이슈 → 완료조건 → 계획 → 동기화 → 실행 → 가드레일 테스트 → 기록` 순서를 기본 운영 흐름으로 본다.
-
-## Rule 1. Completed Feature Protection
-
-완료 판정된 작업물의 기능과 코드는 함부로 건드리지 않는다.
-
-세부 규칙:
-
- 직접 관련된 이슈가 없으면 완료 기능을 수정하지 않는다.
- 완료 기능 수정이 필요하면 먼저 이유와 영향 범위를 이슈 또는 코멘트에 남긴다.
- 단순 편의상 구조를 바꾸거나 정리하는 리팩터링으로 완료 기능 동작을 바꾸지 않는다.
- 완료 기능을 수정한 경우에는 관련 회귀 검증까지 완료해야 한다.
-
-핵심 원칙:
-
- "고치는 김에 같이 정리"를 금지한다.
- 수정 범위는 현재 작업 목적에 필요한 최소 범위로 제한한다.
-
-## Rule 2. Work Must Be Tied To An Issue
-
-원칙적으로 이슈 없는 작업은 하지 않는다.
-
-세부 규칙:
-
- 모든 작업은 기존 이슈에 연결하거나 새 이슈/작업 메모를 만든 뒤 시작한다.
- 왜 하는 작업인지 한 줄로라도 남긴다.
- 임시 대응도 예외가 아니다.
-
-## Rule 3. Branch And Workspace Awareness
-
-작업 전에 현재 브랜치와 워크트리 상태를 먼저 확인한다.
-
-반드시 확인할 항목:
-
- 현재 브랜치
- 원격 대비 ahead / behind 상태
- 미푸시 커밋
- 수정된 파일
- 미추적 파일
-
-금지:
-
- 로컬에서만 있는 상태를 기준 진실처럼 가정하기
- 미정리 변경사항을 모른 채 새 작업을 덧붙이기
-
-## Rule 4. DB Before Code Assumption
-
-조직도, 멤버, 자리배치도, 권한 문제는 코드보다 DB 상태 영향을 먼저 의심한다.
-
-세부 규칙:
-
- dev DB와 prod DB가 다른데 코드 버그로 단정하지 않는다.
- 공개용 기준 데이터가 필요한 검증은 먼저 동기화 상태를 확인한다.
- DB 차이를 무시한 검증 결과를 신뢰하지 않는다.
-
-## Rule 5. Dev / Prod Protocol Is Mandatory
-
-`docs/DEV_PROD_DB_PROTOCOL.md` 의 규칙은 권고가 아니라 작업 기준이다.
-
-핵심 원칙:
-
- 코드 선행은 `8081`
- 데이터 정본은 `8080`
- `8081` DB는 독립 정본이 아니라 검증용 복제본처럼 다룬다
-
-조직도/자리배치도/멤버 검증 전에는 필요 시 아래를 먼저 수행한다.
-
- `./scripts/sync_prod_db_to_dev.sh minimal`
-
-분석 화면까지 공개용 기준으로 맞출 필요가 있으면 아래를 사용한다.
-
- `./scripts/sync_prod_db_to_dev.sh full`
-
-## Rule 6. Validation Before Completion
-
-완료 기준은 "코드를 썼다"가 아니라 "실제 동작을 검증했다"이다.
-
-세부 규칙:
-
- 검증 없이 완료로 판단하지 않는다.
- 감으로 확인하지 않고 체크리스트 기준으로 확인한다.
- 회귀 가능성이 있는 수정은 관련 기능까지 같이 확인한다.
-
-검증 기준 문서:
-
- `docs/REGRESSION_CHECKLIST.md`
-
-## Rule 7. Seat Map Work Is High Risk
-
-자리배치도 관련 작업은 항상 고위험 작업으로 취급한다.
-
-작업 시 최소 확인 항목:
-
-1. 관리자 DnD 배치 / 저장
-2. 조직도 상세의 seat preview
-3. 비관리자 seatmap 진입 / 표시
-
-오피스가 여러 개면 아래 모두 확인한다.
-
- `기술개발센터`
- `한맥빌딩 6층`
- `한맥빌딩 7층`
-
-기술개발센터만 보고 완료 처리하지 않는다.
-
-## Rule 8. Auth / Schema / Sync Changes Are High Risk
-
-아래 영역은 일반 기능 수정처럼 다루지 않는다.
-
- `auth.*`
- `members`
- `seat_maps`
- `seat_slots`
- `seat_positions`
- 동기화 스크립트
- 스키마 변경
-
-이 작업은 반드시:
-
- 변경 이유 명시
- 영향 범위 확인
- 관련 검증 수행
- 결과 기록
-
-까지 포함해야 한다.
-
-## Rule 9. Temporary Logic Must Be Tracked
-
-mock, fallback, hotfix, 임시 우회 로직은 허용할 수 있다.
-하지만 반드시 추적 가능해야 한다.
-
-세부 규칙:
-
- 왜 임시인지 기록한다.
- 제거 또는 정식화할 이슈를 연결한다.
- 운영 기준 로직처럼 장기 방치하지 않는다.
-
-## Rule 10. End-Of-Day Closing Record
-
-작업 종료 시 아래를 반드시 남긴다.
-
- 무엇을 했는지
- 무엇을 검증했는지
- 무엇이 아직 남았는지
- 다음에 어디서 이어야 하는지
-
-남길 위치:
-
- Gitea 이슈 코멘트
- 또는 체크포인트 문서
-
-둘 다 가능하면 둘 다 남긴다.
-
-## Rule 11. Commit And Push Need Explicit User Instruction
-
-커밋과 푸시는 자동으로 하지 않는다.
-
-세부 규칙:
-
- 코드 수정, 문서 수정, 검증 작업은 커밋 없이 계속 진행할 수 있다.
- `git commit` 은 사용자가 명시적으로 지시한 경우에만 수행한다.
- `git push` 도 사용자가 명시적으로 지시한 경우에만 수행한다.
- 작업 중간 상태는 워크트리에 남겨둘 수 있으며, 임의로 잘라서 자주 커밋하지 않는다.
- 커밋이 필요하다고 판단되면 먼저 상태와 이유를 공유하고, 지시를 받은 뒤 진행한다.
-
-## Rule 12. Promote 8081 To 8080 By Reviewed File Diff Only
-
-`8081` 작업용에서 검증된 변경을 `8080` 공개용으로 가져갈 때는 전체 workspace 를 통째로 덮지 않는다.
-
-세부 규칙:
-
- 먼저 `8081` 작업용의 변경 파일 목록과 diff 를 확인한다.
- 공개용에 필요한 파일만 선택해서 메인 workspace 로 반영한다.
- 반영 후에는 메인 workspace 기준으로 최소 회귀 검증을 다시 수행한다.
- `8081` DB 기준으로만 맞는 수정인지, `8080` 기준 데이터에서도 맞는지 다시 확인한다.
- 검증이 끝나기 전에는 공개용 완료로 판단하지 않는다.
-
-금지:
-
- `8081` 작업 디렉터리를 통째로 복사해서 `8080`에 덮어쓰기
- diff 확인 없이 일괄 반영
- `8081`에서 됐으니 `8080`도 같을 것이라고 가정하기
-
-## Rule 13. 8081 Must Start From The Isolated Worktree
-
-`8081` 작업은 항상 `.dev-worktree-8081` 기준으로 시작한다.
-
-세부 규칙:
-
- 디자인 작업도 예외가 아니다.
- 허브/조직현황/프로젝트별 분석/사업관리대장 수정 전에 현재 실제 서빙 파일과 SSOT 파일을 먼저 확인한다.
-
-디자인 작업 강제 우선순위:
-
-1. `frontend/public/design-tokens.css`
-2. `frontend/public/design-patterns.css`
-3. `docs/architecture/DESIGN_SSOT.md`
-4. 그 다음 화면별 실제 서빙 파일
-
-금지:
-
- reference/original 파일을 먼저 수정하기
- 예전 파란톤/indigo/slate 계열을 새 기본값으로 다시 넣기
- 토큰/패턴으로 해결 가능한 문제를 화면별 임시 하드코딩으로 처리하기
-
-`8081` 작업용은 포트만 다른 복제 서버가 아니라, 코드 소스까지 분리된 전용 worktree여야 한다.
-
-세부 규칙:
-
- `8081`은 항상 `.dev-worktree-8081`에서 띄운다.
- 기동 전 `./scripts/prepare_dev_worktree.sh`를 먼저 실행한다.
- 재부팅 후 빠른 기동은 `./scripts/start_8081.sh` 또는 `./scripts/start_local_dashboards.sh`를 사용한다.
- `.env`와 로컬 전용 디자인 자산은 준비 스크립트가 복사한 것을 기준으로 사용한다.
- 기동 후 `docker inspect mh-dashboard-organization-dev-backend-1`로 마운트 소스를 확인한다.
-
-금지:
-
- 현재 메인 workspace를 직접 마운트한 상태로 `8081`을 띄우기
- `8080`과 `8081`이 같은 `frontend/public`, `legacy/static`, `incoming-files`를 동시에 보게 두기
- `8081`에서 보이던 디자인을 `8080` 공통 소스에 바로 덮어쓰기
-
-## Daily Start Checklist
-
-매일 첫 작업 시작 전 체크:
-
- 현재 브랜치 확인
- 원격 대비 커밋 상태 확인
- 열린 이슈 확인
- `WORK_RULEBOOK.md` 확인
- 최신 체크포인트 확인
- 미추적 / 수정 파일 확인
- 현재 작업은 커밋 없이 진행하고, 커밋/푸시는 지시받을 때만 한다는 규칙 확인
- 오늘 작업이 코드 문제인지 DB 문제인지 먼저 구분
- 공개용 기준 데이터 검증이 필요한지 판단
-
-## Daily End Checklist
-
-매일 작업 종료 전 체크:
-
- 오늘 변경 파일 정리
- 검증 결과 정리
- 미완료 항목 정리
- 관련 이슈 코멘트 또는 문서 업데이트
- 다음 시작 지점 명시
-
-## One-Line Operating Principle
-
-이 프로젝트의 작업 기준은 아래 한 줄로 요약한다.
-
- 상태를 먼저 확인하고, 완료 기능은 보호하며, DB와 검증을 무시하지 않고, 기록을 남기면서 작업한다.
--- a/docs/WSL_WORKSPACE_GUIDE.md
+++ b/docs/WSL_WORKSPACE_GUIDE.md
@@ -1,34 +0,0 @@
-# WSL 작업 기준 가이드
-
-## 1. 왜 WSL 기준으로 작업하나
- 현재 이 프로젝트는 Ubuntu 24.04 기반 Docker 환경에서 실행되고 있습니다.
- Windows 폴더에서 바로 작업하면 실행 경로와 편집 경로가 달라질 수 있습니다.
- 그래서 앞으로는 `WSL Ubuntu 내부 경로`를 기준 작업공간으로 사용하는 것을 권장합니다.
-
-## 2. 기준 작업 경로
- 사용자: `hyunho`
- 프로젝트 경로: `/home/hyunho/projects/mh-dashboard-organization`
-
-## 3. VS Code에서 여는 방법
-1. VS Code 명령 팔레트를 엽니다.
-2. `Remote-WSL: Reopen Folder in WSL` 를 실행합니다.
-3. 아래 경로를 엽니다.
-   - `/home/hyunho/projects/mh-dashboard-organization`
-4. 좌측 아래 상태 표시줄에 `WSL: Ubuntu-24.04` 가 보이면 정상입니다.
-
-## 4. 앞으로의 작업 규칙
- 코드 수정은 가능하면 WSL 경로 기준으로 진행합니다.
- Docker 실행, Python 실행, 배포 테스트도 WSL 안에서 진행합니다.
- Windows 경로는 참고용 또는 백업용으로만 보고, 실행 기준으로 사용하지 않는 것이 좋습니다.
-
-## 5. 자주 쓰는 명령
-```bash
-cd /home/hyunho/projects/mh-dashboard-organization
-docker compose ps
-docker compose logs backend
-docker compose up -d
-```
-
-## 6. 현재 확인 가능한 주소
- 메인 화면: `http://localhost:8080`
- API 상태 확인: `http://localhost:8080/api/health`
--- a/docs/architecture/8081_SERVING_MAP.md
+++ b/docs/architecture/8081_SERVING_MAP.md
@@ -47,7 +47,7 @@
  - 현재 실제 서빙 파일: `incoming-files/served/mh.html`
  - 앱 소스 기준: `frontend/apps/team/index.html`
  - publish 규칙: `scripts/publish_team_app.sh`
- URL: `/admin/db-status`
+- URL: `/db-status.html`
  - 현재 실제 서빙 파일: `incoming-files/served/db-status/index.html`
  - 앱 소스 기준: `frontend/apps/db-status/index.html`
  - publish 규칙: `scripts/publish_db_status_app.sh`
@@ -55,11 +55,12 @@
 정리 원칙:

 - `incoming-files` 아래에서는 `served/`를 실제 서빙 자산용으로 사용한다.
+- `payment`, `mh`, `ledger`, `db-status`는 사람이 직접 `served/`를 먼저 수정하지 않는다.
+- 이 4개 화면의 source-of-truth는 `frontend/apps/*`이고, publish 스크립트가 `served/`를 갱신한다.
 - `reference/`는 원본 참고 파일, 복구 참고 파일, 비교용 자산만 둔다.
 - 1차 정리에서는 기존 실제 서빙 파일을 `served/`에 복사하고, backend 서빙 경로를 먼저 `served/`로 갱신한다.
 - `사업관리대장`은 `#21`부터 wrapper decode 방식 대신 `served/ledger/index.html`과 `served/ledger/*`를 직접 서빙한다.
 - `사업관리대장` 수정 원본은 `#21` 다음 단계부터 `frontend/apps/ledger/*`를 먼저 보고, `scripts/publish_ledger_app.sh`로 runtime served 파일에 반영한다.
- 기존 루트 `incoming-files/payment.html`, `incoming-files/mh.html`는 안전한 비교/복구를 위해 당분간 남겨둔다.

 ## Seat Map

@@ -93,8 +94,8 @@

 - `260320.html`
 - `sample style.css`
- `opayment.html`
- `omh.html`
+- `reference/opayment.html`
+- `reference/omh.html`
 - `reference/ledger/MH 통합 대시보드_260320.html`
 - `reference/ledger/MH 통합 대시보드_260320.css`
 - 원본 xlsx/csv
@@ -113,5 +114,5 @@
 - 로그인은 `styles.css`만 본다.
 - 허브 8081 디자인은 `styles-8081-design.css`만 본다.
 - `/integrations/payment`, `/integrations/mh`의 실제 서빙 파일 위치가 문서와 코드에서 일치한다.
- `/admin/db-status`가 현재 DB 저장 구조와 import 상태를 화면에서 바로 보여준다.
+- `/db-status.html`가 현재 DB 저장 구조와 import 상태를 화면에서 바로 보여준다.
 - 기존 참고 자산을 지우지 않고도 실제 서빙 경로와 참고 경로를 구분할 수 있다.
--- a/docs/architecture/DB_TABLE_CATALOG.md
+++ b/docs/architecture/DB_TABLE_CATALOG.md
@@ -2,7 +2,7 @@

 ## Purpose

-이 문서는 `8081 / work-8081` 기준 현재 PostgreSQL 테이블 27개를 역할별로 분류한 운영 기준 문서다.
+이 문서는 현재 PostgreSQL 테이블을 역할별로 분류한 운영 기준 문서다.

 핵심 원칙:

@@ -130,6 +130,51 @@
 - `public.integration_raw_mh_pm_rows`
 - `public.integration_raw_payment_rows`

+## Product View
+
+운영자가 DB를 볼 때는 물리 테이블 수보다 아래 5개 묶음으로 보는 편이 더 이해하기 쉽다.
+
+### 탭 데이터
+
+- `public.members`
+- `public.seat_maps`
+- `public.seat_slots`
+- `public.seat_positions`
+- `public.integration_projects`
+- `public.integration_work_logs`
+- `public.integration_work_log_segments`
+- `public.integration_vouchers`
+- `public.integration_binary_sources`
+
+### 로그인·권한
+
+- `auth.users`
+- `auth.sessions`
+- `auth.login_audit_logs`
+
+### 히스토리
+
+- `public.history_revisions`
+- `public.member_versions`
+- `public.seat_assignment_versions`
+
+### 로우데이터·적재
+
+- `public.integration_import_batches`
+- `public.integration_raw_organization_rows`
+- `public.integration_raw_mh_rows`
+- `public.integration_raw_mh_pm_rows`
+- `public.integration_raw_payment_rows`
+
+### 보정·보조
+
+- `public.member_overrides`
+- `public.member_retirements`
+- `public.member_aliases`
+- `public.integration_project_aliases`
+- `public.integration_project_category_mappings`
+- `public.integration_project_pm_assignments`
+
 ## Operational Guidance

 ### 바로 줄이지 말아야 하는 것
--- a/docs/architecture/DESIGN_SSOT.md
+++ b/docs/architecture/DESIGN_SSOT.md
@@ -2,9 +2,9 @@

 ## Source of truth

- Primary visual source: [incoming-files/sample style.css](/home/hyunho/projects/mh-dashboard-organization/.dev-worktree-8081/incoming-files/sample%20style.css)
- Runtime token file: [design-tokens.css](/home/hyunho/projects/mh-dashboard-organization/.dev-worktree-8081/frontend/public/design-tokens.css)
- Runtime pattern file: [design-patterns.css](/home/hyunho/projects/mh-dashboard-organization/.dev-worktree-8081/frontend/public/design-patterns.css)
+- Primary visual source: [incoming-files/sample style.css](../../incoming-files/sample%20style.css)
+- Runtime token file: [design-tokens.css](../../frontend/public/design-tokens.css)
+- Runtime pattern file: [design-patterns.css](../../frontend/public/design-patterns.css)

 `sample style.css` defines the intended MH visual language. `design-tokens.css` is the token-level SSOT, and `design-patterns.css` is the component-level SSOT that packages those tokens into reusable runtime patterns.

--- a/frontend/apps/db-status/index.html
+++ b/frontend/apps/db-status/index.html
@@ -110,6 +110,14 @@
    .panel-body {
      padding: 16px 18px 20px;
    }
+    .panel-toolbar {
+      display: flex;
+      align-items: center;
+      justify-content: space-between;
+      gap: 12px;
+      margin-bottom: 14px;
+      flex-wrap: wrap;
+    }
    .panel-body.tight {
      padding-top: 0;
    }
@@ -211,6 +219,44 @@
      font-size: 11px;
      font-weight: 700;
    }
+    .toolbar-input {
+      width: min(360px, 100%);
+      padding: 11px 14px;
+      border-radius: 14px;
+      border: 1px solid rgba(132, 102, 54, 0.16);
+      background: rgba(255, 251, 244, 0.96);
+      color: #2f2419;
+      font: inherit;
+    }
+    .toolbar-input:focus {
+      outline: none;
+      border-color: rgba(129, 88, 31, 0.34);
+      box-shadow: 0 0 0 4px rgba(208, 176, 116, 0.16);
+    }
+    .toolbar-actions {
+      display: flex;
+      align-items: center;
+      gap: 10px;
+      flex-wrap: wrap;
+    }
+    .action-button {
+      border: 1px solid rgba(128, 98, 48, 0.14);
+      background: rgba(250, 240, 213, 0.62);
+      color: #6c4a1a;
+      border-radius: 999px;
+      padding: 9px 14px;
+      font: inherit;
+      font-size: 12px;
+      font-weight: 800;
+      cursor: pointer;
+    }
+    .action-button:hover {
+      background: rgba(244, 228, 186, 0.8);
+    }
+    .action-button:disabled {
+      cursor: not-allowed;
+      opacity: 0.45;
+    }
    .notes {
      margin: 0;
      padding-left: 18px;
@@ -219,6 +265,33 @@
      color: rgba(84, 65, 38, 0.84);
      line-height: 1.55;
    }
+    .mapping-list {
+      display: grid;
+      gap: 14px;
+    }
+    .mapping-card {
+      padding: 14px 16px;
+      border-radius: 18px;
+      background: rgba(255, 249, 239, 0.92);
+      border: 1px solid rgba(132, 102, 54, 0.12);
+    }
+    .mapping-card h3 {
+      margin: 0 0 8px;
+      font-size: 15px;
+      font-weight: 800;
+      letter-spacing: -0.02em;
+    }
+    .mapping-card p {
+      margin: 8px 0 0;
+      color: rgba(98, 75, 42, 0.74);
+      line-height: 1.55;
+      font-size: 13px;
+    }
+    .mapping-table-list {
+      display: flex;
+      flex-wrap: wrap;
+      gap: 6px;
+    }
    .preview-meta {
      display: grid;
      gap: 10px;
@@ -345,6 +418,9 @@
      <p>
        `원본 import 배치`는 업로드한 원본 파일이 몇 행으로 적재됐는지 보여주고, `바이너리 원본 보관`은 엑셀 같은 파일 자체를 DB에 보관하는 상태를 보여줍니다.
      </p>
+      <p>
+        아래 표는 전체 테이블을 보여주고, 오른쪽 패널은 화면별 데이터 소스와 저장 흐름을 운영 관점으로 묶어서 보여줍니다.
+      </p>
    </section>

    <section id="overview" class="overview"></section>
@@ -354,11 +430,17 @@
        <div class="panel-head">
          <div>
            <h2>전체 테이블 현황</h2>
-            <p>전체 27개 테이블을 보여주며, 테이블명을 누르면 샘플 row를 바로 확인할 수 있습니다.</p>
+            <p>현재 운영 DB의 전체 26개 테이블을 보여주며, 테이블명을 누르면 샘플 row를 바로 확인할 수 있습니다.</p>
          </div>
          <span id="generated-at" class="meta-chip">로딩 중</span>
        </div>
        <div class="panel-body">
+          <div class="panel-toolbar">
+            <input id="table-search" class="toolbar-input" type="search" placeholder="테이블명, 설명, 화면명으로 검색" />
+            <div class="toolbar-actions">
+              <span id="table-count" class="meta-chip">0 / 0</span>
+            </div>
+          </div>
          <table>
            <thead>
              <tr>
@@ -438,11 +520,24 @@
        <article class="panel">
          <div class="panel-head">
            <div>
-              <h2>테이블 분류</h2>
-              <p>유지/주의/원본·추적/정리 후보로 나눈 현재 기준입니다.</p>
+              <h2>운영 분류</h2>
+              <p>유지/주의/원본·추적/정리 후보 기준과 제품 관점 묶음을 같이 봅니다.</p>
            </div>
          </div>
-          <div id="group-summary" class="panel-body"></div>
+          <div class="panel-body">
+            <div id="group-summary"></div>
+            <div id="product-summary" style="margin-top:18px;"></div>
+          </div>
+        </article>
+
+        <article class="panel">
+          <div class="panel-head">
+            <div>
+              <h2>화면별 데이터 소스</h2>
+              <p>각 탭/기능이 실제로 어떤 테이블을 읽고 저장하는지 빠르게 확인합니다.</p>
+            </div>
+          </div>
+          <div id="screen-map" class="panel-body mapping-list"></div>
        </article>

      </div>
@@ -456,8 +551,11 @@
          <h2 id="preview-title">테이블 내용 미리보기</h2>
          <p id="preview-subtitle" class="muted">선택한 테이블의 컬럼과 최대 50개 row를 표시합니다.</p>
        </div>
+        <div class="toolbar-actions">
+          <button id="preview-download" class="action-button" type="button" disabled>CSV 다운로드</button>
          <button id="preview-close" class="modal-close" type="button" aria-label="닫기">×</button>
        </div>
+      </div>
      <div class="modal-body">
        <div id="preview-meta" class="preview-meta"></div>
        <div class="panel-body tight">
@@ -475,6 +573,9 @@
  </div>

  <script>
+    let allTables = [];
+    let currentPreview = null;
+
    function escapeHtml(value) {
      return String(value ?? "")
        .replaceAll("&", "&amp;")
@@ -529,6 +630,10 @@

    function renderTables(items) {
      const target = document.getElementById("table-body");
+      const countTarget = document.getElementById("table-count");
+      if (countTarget) {
+        countTarget.textContent = `${formatNumber(items.length)} / ${formatNumber(allTables.length)}`;
+      }
      if (!items.length) {
        target.innerHTML = '<tr><td colspan="5" class="empty">표시할 테이블이 없습니다.</td></tr>';
        return;
@@ -619,8 +724,46 @@
      `).join("");
    }

+    function renderProductSummary(summary) {
+      const target = document.getElementById("product-summary");
+      const groups = [
+        "탭 데이터",
+        "로그인·권한",
+        "히스토리",
+        "로우데이터·적재",
+        "보정·보조",
+      ];
+      target.innerHTML = groups.map((label) => `
+        <div style="display:grid; gap:8px; margin-bottom:16px;">
+          <div><span class="group-tag keep">${escapeHtml(label)}</span></div>
+          <div class="view-list">
+            ${((summary && summary[label]) || []).map((item) => `<span class="view-pill">${escapeHtml(item)}</span>`).join("") || '<span class="muted">없음</span>'}
+          </div>
+        </div>
+      `).join("");
+    }
+
+    function renderScreenMap(items) {
+      const target = document.getElementById("screen-map");
+      if (!items || !items.length) {
+        target.innerHTML = '<div class="empty">화면별 데이터 소스 정보가 없습니다.</div>';
+        return;
+      }
+      target.innerHTML = items.map((item) => `
+        <article class="mapping-card">
+          <h3>${escapeHtml(item.screen || "")}</h3>
+          <div class="mapping-table-list">
+            ${(item.tables || []).map((table) => `<span class="view-pill">${escapeHtml(table)}</span>`).join("")}
+          </div>
+          <p>${escapeHtml(item.write_flow || "")}</p>
+        </article>
+      `).join("");
+    }
+
    function renderTablePreview(payload) {
+      currentPreview = payload;
      const previewModal = document.getElementById("preview-modal");
+      const downloadButton = document.getElementById("preview-download");
      const previewMeta = document.getElementById("preview-meta");
      const previewTitle = document.getElementById("preview-title");
      const previewSubtitle = document.getElementById("preview-subtitle");
@@ -629,6 +772,9 @@

      previewTitle.textContent = `${payload.label} · ${payload.table_ref}`;
      previewSubtitle.textContent = `${formatNumber(payload.row_count)} rows / 최대 ${formatNumber(payload.limit)}개 표시`;
+      if (downloadButton) {
+        downloadButton.disabled = !(payload.rows && payload.rows.length);
+      }
      previewMeta.innerHTML = `
        <div>
          <div class="table-title">${escapeHtml(payload.label)}</div>
@@ -686,15 +832,62 @@
        throw new Error(`DB 상태를 불러오지 못했습니다. (${response.status})`);
      }
      const payload = await response.json();
+      allTables = payload.tables || [];
      document.getElementById("generated-at").textContent = payload.generated_at
        ? `갱신 ${formatDateTime(payload.generated_at)}`
        : "갱신 시각 없음";
      renderOverview(payload.overview || {});
-      renderTables(payload.tables || []);
+      renderTables(allTables);
      renderBatches(payload.import_batches || []);
      renderBinarySources(payload.binary_sources || []);
      renderNotes(payload.notes || []);
      renderGroupSummary(payload.group_summary || {});
+      renderProductSummary(payload.product_summary || {});
+      renderScreenMap(payload.screen_map || []);
+    }
+
+    function toCsvValue(value) {
+      const text = String(value ?? "");
+      if (!/[",\n]/.test(text)) return text;
+      return `"${text.replaceAll('"', '""')}"`;
+    }
+
+    function downloadPreviewCsv() {
+      if (!currentPreview || !currentPreview.columns || !currentPreview.rows || !currentPreview.rows.length) return;
+      const headers = currentPreview.columns.map((column) => column.name);
+      const lines = [
+        headers.map(toCsvValue).join(","),
+        ...currentPreview.rows.map((row) => headers.map((header) => toCsvValue(row[header] ?? "")).join(",")),
+      ];
+      const blob = new Blob(["\ufeff" + lines.join("\n")], { type: "text/csv;charset=utf-8;" });
+      const url = URL.createObjectURL(blob);
+      const link = document.createElement("a");
+      link.href = url;
+      link.download = `${currentPreview.table_name || "table-preview"}.csv`;
+      document.body.appendChild(link);
+      link.click();
+      link.remove();
+      URL.revokeObjectURL(url);
+    }
+
+    function applyTableSearch(query) {
+      const normalized = String(query || "").trim().toLowerCase();
+      if (!normalized) {
+        renderTables(allTables);
+        return;
+      }
+      const filtered = allTables.filter((item) => {
+        const haystack = [
+          item.label,
+          item.table_ref,
+          item.description,
+          ...(item.related_views || []),
+          item.domain,
+          item.group,
+        ].join(" ").toLowerCase();
+        return haystack.includes(normalized);
+      });
+      renderTables(filtered);
    }

    document.getElementById("preview-close").addEventListener("click", () => {
@@ -703,6 +896,11 @@
      modal.setAttribute("aria-hidden", "true");
    });

+    document.getElementById("preview-download").addEventListener("click", downloadPreviewCsv);
+    document.getElementById("table-search").addEventListener("input", (event) => {
+      applyTableSearch(event.target.value);
+    });
+
    document.getElementById("preview-modal").addEventListener("click", (event) => {
      if (event.target.id !== "preview-modal") return;
      const modal = document.getElementById("preview-modal");
--- a/frontend/apps/ledger/assets/ledger-override.js
+++ b/frontend/apps/ledger/assets/ledger-override.js
@@ -10,6 +10,10 @@
    return new Date(now.getFullYear(), now.getMonth(), now.getDate());
  }

+  function bgNormalizeText(value) {
+    return String(value || "").replace(/\s+/g, " ").trim();
+  }
+
  function bgParseDate(value) {
    var text = String(value || "").trim();
    if (!text) return null;
@@ -36,6 +40,44 @@
    return bgYearFromText(row && row.eDate);
  }

+  function normalizedCategory(row) {
+    var category = bgNormalizeText(row && row.cat);
+    if (category.indexOf("가족사") >= 0) return "가족사";
+    var corp = bgNormalizeText(row && row.corp);
+    if (corp && corp !== "바론") return "가족사";
+    return "바론";
+  }
+
+  function isSupportServiceRow(row) {
+    return bgNormalizeText(row && row.name).indexOf("경영 및 기술지원 서비스") >= 0;
+  }
+
+  function projectTypeLabel(row) {
+    if (isSupportServiceRow(row)) return "기술지원서비스";
+    return normalizedCategory(row);
+  }
+
+  function projectTypeRank(row) {
+    var label = projectTypeLabel(row);
+    if (label === "바론") return 0;
+    if (label === "가족사") return 1;
+    return 2;
+  }
+
+  function normalizeStatusLabel(status) {
+    var value = bgNormalizeText(status);
+    if (!value) return "-";
+    if (value === "완료") return "준공";
+    if (value === "진행") return "과업진행중";
+    if (value === "대기") return "계약대기";
+    if (value === "중지") return "과업중지";
+    return value;
+  }
+
+  function rowStatusLabel(row) {
+    return normalizeStatusLabel(row && row.status);
+  }
+
  function bgDisplayYear(row) {
    var start = bgStartYear(row);
    if (start) return start;
@@ -82,7 +124,7 @@
    if (!(cutoff && yearStart && startDate)) return false;
    if (startDate > cutoff) return false;
    if (endDate && endDate < yearStart) return false;
-    return !(endDate && endDate <= cutoff);
+    return rowStatusLabel(row) === "과업진행중";
  }

  function bgStartedInYear(row, year) {
@@ -96,7 +138,7 @@
    var cutoff = bgYearCutoff(year);
    var endDate = bgDateOrYearEnd(row);
    if (!(cutoff && endDate)) return false;
-    return endDate.getFullYear() === Number(year || 0) && endDate <= cutoff;
+    return rowStatusLabel(row) === "준공" && endDate.getFullYear() === Number(year || 0) && endDate <= cutoff;
  }

  function bgYearRange(row) {
@@ -140,16 +182,32 @@
    }, { c: 0, col: 0, recv: 0 });
  }

-  function isSupportServiceRow(row) {
-    var category = String((row && row.cat) || "").trim();
-    return category.indexOf("경영지원") >= 0 || category.indexOf("서비스") >= 0;
+  function isBaronProjectRow(row) {
+    return projectTypeLabel(row) === "바론";
  }

-  function isBaronProjectRow(row) {
-    var category = String((row && row.cat) || "").trim();
-    if (category.indexOf("바론") < 0) return false;
-    if (isSupportServiceRow(row)) return false;
-    return true;
+  function isSoftwareProjectRow(row) {
+    var name = bgNormalizeText(row && row.name).toLowerCase();
+    if (!name) return false;
+    return [
+      "프로그램",
+      "소프트웨어",
+      "software",
+      " sw",
+      "sw ",
+      "erp",
+      "tova",
+      "ipipe",
+      "eg-bim",
+      "cad"
+    ].some(function (keyword) {
+      return name.indexOf(keyword) >= 0;
+    });
+  }
+
+  function shouldSinkProjectName(row) {
+    var name = bgNormalizeText(row && row.name);
+    return name.indexOf("프로그램") >= 0 || name.indexOf("사용") >= 0;
  }

  function bgSummarize(rows, selectedYear) {
@@ -158,14 +216,18 @@
    var activeRows = items.filter(function (row) { return bgActiveInYear(row, targetYear); });
    var newProjectRows = items.filter(function (row) { return bgStartedInYear(row, targetYear); });
    var completedRows = items.filter(function (row) { return bgCompletedInYear(row, targetYear); });
-    var managementRows = newProjectRows.filter(isSupportServiceRow);
+    var managementRows = activeRows.filter(isSupportServiceRow);
+    var baronActiveRows = activeRows.filter(isBaronProjectRow);
    return {
      targetYear: targetYear,
      activeRows: activeRows,
      newProjectRows: newProjectRows,
      completedRows: completedRows,
      managementRows: managementRows,
-      managementTotals: bgTotals(managementRows)
+      managementTotals: bgTotals(managementRows),
+      baronActiveRows: baronActiveRows,
+      baronProjectTotals: bgTotals(baronActiveRows),
+      baronSoftwareCount: baronActiveRows.filter(isSoftwareProjectRow).length
    };
  }

@@ -177,13 +239,6 @@
    return bgActiveInYear(row, selectedYear);
  }

-  function normalizeStatusLabel(status) {
-    var value = String(status || "").trim();
-    if (!value) return "-";
-    if (value.indexOf("진행") >= 0) return "과업 진행중";
-    return value;
-  }
-
  function formatSplitPercent(split) {
    var numeric = parseFloat(String(split || "").replace(/[^0-9.\-]/g, ""));
    if (!Number.isFinite(numeric) || numeric === 0) return "분담율 -%";
@@ -204,17 +259,57 @@
  }

  function groupSortRank(row) {
-    var selectedYear = Number((S.dashboard && S.dashboard.year) || projectYear(row) || 0);
    var startYear = Number(projectYear(row) || 0);
-    if (typeof bgCompletedInYear === "function" && bgCompletedInYear(row, String(selectedYear))) return 9999;
    if (!startYear) return 9998;
    return startYear;
  }

  function tableGroupLabel(row) {
    var startYear = projectYear(row);
-    if (/^20\d{2}$/.test(startYear)) return startYear + "년";
-    return "미지정";
+    if (/^20\d{2}$/.test(startYear)) return startYear + " " + projectTypeLabel(row);
+    return "미지정 " + projectTypeLabel(row);
+  }
+
+  function compareDashboardRows(a, b) {
+    var typeRankDiff = projectTypeRank(a) - projectTypeRank(b);
+    if (typeRankDiff !== 0) return typeRankDiff;
+    var groupDiff = groupSortRank(a) - groupSortRank(b);
+    if (groupDiff !== 0) return groupDiff;
+    var sinkDiff = Number(shouldSinkProjectName(a)) - Number(shouldSinkProjectName(b));
+    if (sinkDiff !== 0) return sinkDiff;
+    return bgNormalizeText(a && a.name).localeCompare(bgNormalizeText(b && b.name), "ko");
+  }
+
+  function filterCategoryLabel(row) {
+    return projectTypeLabel(row);
+  }
+
+  function filterClientLabel(row) {
+    if (typeof normalizeClientDisplay === "function") {
+      return normalizeClientDisplay(row && row.client);
+    }
+    return bgNormalizeText(row && row.client) || "-";
+  }
+
+  function filterOrderLabel(row) {
+    return bgNormalizeText(row && row.order) || "-";
+  }
+
+  function receivableFilterLabel(row) {
+    var amount = Number((row && row.recv) || 0);
+    if (amount <= 0) return "미수 없음";
+    if (amount < 10000000) return "1천만 미만";
+    if (amount < 100000000) return "1천만 이상";
+    return "1억 이상";
+  }
+
+  function refreshFilterDom() {
+    E.filterButtons = Object.fromEntries(Array.from(document.querySelectorAll(".th-trigger")).map(function (el) {
+      return [el.dataset.filter, el];
+    }));
+    E.filterMenus = Object.fromEntries(Array.from(document.querySelectorAll(".th-menu")).map(function (el) {
+      return [el.dataset.filter, el];
+    }));
  }

  function renderLedgerTable() {
@@ -236,12 +331,7 @@
        + '<th class="num"><div class="th-head end"><button type="button" class="th-trigger" data-filter="rate" data-label="수금률"><span class="th-title">수금률</span><span class="th-mark"></span><span class="th-caret">▼</span></button><div id="filterRateMenu" class="th-menu" data-filter="rate"></div></div></th>'
        + "</tr>";
    }
-    var rows = (Array.isArray(S.viewRows) ? S.viewRows : []).slice().sort(function (a, b) {
-      var ar = groupSortRank(a);
-      var br = groupSortRank(b);
-      if (ar !== br) return ar - br;
-      return Number(b.recv || 0) - Number(a.recv || 0);
-    });
+    var rows = (Array.isArray(S.viewRows) ? S.viewRows : []).slice().sort(compareDashboardRows);
    S.viewRows = rows;
    var lastGroupLabel = "";
    E.tbody.innerHTML = rows.map(function (r) {
@@ -259,7 +349,7 @@
        + '<td><button type="button" class="project-link" data-project-key="' + escAttr(String(r.code || "") + "|" + String(r.name || "")) + '">' + esc(r.name || "-") + '</button><div class="subline">' + esc(r.periodText || "-") + '</div></td>'
        + '<td><div class="client-main">' + esc((r.client || "").trim() || "-") + '</div><div class="subline">' + esc(formatSplitPercent(r.split)) + '</div></td>'
        + '<td><div>' + esc(r.order || "-") + '</div></td>'
-        + '<td><div class="badge ' + (String(r.status || "").indexOf("완료") >= 0 ? 'ok' : '') + '">' + esc(normalizeStatusLabel(r.status)) + '</div></td>'
+        + '<td><div class="badge ' + (rowStatusLabel(r) === "준공" ? 'ok' : '') + '">' + esc(rowStatusLabel(r)) + '</div></td>'
        + '<td class="num"><strong>' + esc(won(r.cSup || 0)) + '</strong></td>'
        + '<td class="num"><strong>' + esc(r.outsourceCost ? won(r.outsourceCost) : "-") + '</strong></td>'
        + '<td class="num"><strong>' + esc(won(r.recv || 0)) + '</strong></td>'
@@ -267,6 +357,8 @@
        + '<td class="num"><strong style="color:' + (isSettledRow(r) ? '#b7aa93' : '#1a5645') + '">' + esc((Number(r.rate || 0)).toFixed(2) + "%") + '</strong></td>'
        + '</tr>';
    }).join("");
+    refreshFilterDom();
+    if (typeof syncColumnFilters === "function") syncColumnFilters(S.all);
  }

  function renderCollectionBoard(r) {
@@ -379,10 +471,8 @@
    }
    var years = bgEnsureYear(S.all);
    var summary = bgSummarize(S.all, S.dashboard.year);
-    var rows = Array.isArray(S.rows) ? S.rows : [];
-    var visibleBaronProjectRows = rows.filter(isBaronProjectRow);
-    var totals = bgTotals(visibleBaronProjectRows);
-    var totalRate = typeof rate === "function" ? rate("", totals.col, totals.col + totals.recv) : 0;
+    var totals = summary.baronProjectTotals;
+    var totalRate = totals.c > 0 ? (totals.col / totals.c) * 100 : 0;
    var toolbarHtml = '<div class="cards-toolbar">'
      + '<div class="cards-toolbar-row">'
      + years.map(function (year) {
@@ -393,14 +483,14 @@
      + '<div class="cards-toolbar-metrics">'
      + '<button type="button" class="summary-filter-chip ' + (S.dashboard.section === "active" ? "active" : "") + '" data-dashboard-section="active"><span class="label">' + esc(summary.targetYear) + '년 진행과업</span><span class="count">' + summary.activeRows.length.toLocaleString("ko-KR") + '건</span><span class="meta">전년도 이월 사업 포함</span></button>'
      + '<button type="button" class="summary-filter-chip ' + (S.dashboard.section === "new" ? "active" : "") + '" data-dashboard-section="new"><span class="label">' + esc(summary.targetYear) + '년 신규프로젝트</span><span class="count">' + summary.newProjectRows.length.toLocaleString("ko-KR") + '건</span><span class="meta">계약기간 시작년도 기준</span></button>'
-      + '<button type="button" class="summary-filter-chip ' + (S.dashboard.section === "completed" ? "active" : "") + '" data-dashboard-section="completed"><span class="label">' + esc(summary.targetYear) + '년 완료과업</span><span class="count">' + summary.completedRows.length.toLocaleString("ko-KR") + '건</span><span class="meta">해당년도 종료 사업 기준</span></button>'
+      + '<button type="button" class="summary-filter-chip ' + (S.dashboard.section === "completed" ? "active" : "") + '" data-dashboard-section="completed"><span class="label">' + esc(summary.targetYear) + '년 완료과업</span><span class="count">' + summary.completedRows.length.toLocaleString("ko-KR") + '건</span><span class="meta">진행상태 준공 기준</span></button>'
      + "</div></div>";
    var cards = [
-      { label: summary.targetYear + "년 프로젝트", value: visibleBaronProjectRows.length.toLocaleString("ko-KR") + " 건", note: "" },
-      { label: "계약금", value: won(totals.c), note: "" },
+      { label: summary.targetYear + "년 프로젝트", value: summary.baronActiveRows.length.toLocaleString("ko-KR") + "건 (" + summary.baronSoftwareCount.toLocaleString("ko-KR") + "건)", note: "바론 수행중 프로젝트 / SW" },
+      { label: "계약금 (VAT별도)", value: won(totals.c), note: "" },
      { label: "수금액", value: won(totals.col), note: "" },
      { label: "미수금", value: won(totals.recv), note: "" },
-      { label: "수금률(%)", value: totalRate.toFixed(2) + "%", note: "" },
+      { label: "수금율", value: totalRate.toFixed(2) + "%", note: "계약금 대비 수금액" },
      { label: "경영지원서비스 금액", value: won(summary.managementTotals.c), note: "", className: "management" }
    ];
    E.cards.innerHTML = toolbarHtml + cards.map(function (card) {
@@ -429,9 +519,62 @@
    S.rows = searched.filter(function (r) {
      return bgMatches(r) && matchesColumnFilters(r);
    });
+    S.rows.sort(compareDashboardRows);
    render();
  };

+  filterDefinitions = function () {
+    return [
+      { key: "cat", map: filterCategoryLabel },
+      { key: "code", map: function (r) { return r.code || "-"; } },
+      { key: "name", map: function (r) { return r.name || "-"; } },
+      { key: "client", map: filterClientLabel },
+      { key: "order", map: filterOrderLabel },
+      { key: "status", map: rowStatusLabel },
+      { key: "amount", map: amountFilterLabel },
+      { key: "outsource", map: outsourceFilterLabel },
+      { key: "receivable", map: receivableFilterLabel },
+      { key: "collected", map: collectedFilterLabel },
+      { key: "rate", map: rateFilterLabel }
+    ];
+  };
+
+  updateFilterButtons = function () {
+    Object.keys(E.filterButtons || {}).forEach(function (key) {
+      var btn = E.filterButtons[key];
+      if (!btn) return;
+      var active = !!S.filters[key];
+      btn.classList.toggle("active", active);
+      btn.title = active ? ((btn.dataset.label || "") + ": " + S.filters[key]) : (btn.dataset.label || "");
+      var mark = btn.querySelector(".th-mark");
+      if (mark) mark.textContent = active ? "•" : "";
+    });
+  };
+
+  syncColumnFilters = function (rows) {
+    filterDefinitions().forEach(function (def) {
+      var values = uniqueFilterValues(rows, def.map);
+      if (S.filters[def.key] && !values.includes(S.filters[def.key])) delete S.filters[def.key];
+      renderFilterMenu(def.key, values);
+    });
+    updateFilterButtons();
+  };
+
+  matchesColumnFilters = function (r) {
+    if (S.filters.cat && filterCategoryLabel(r) !== S.filters.cat) return false;
+    if (S.filters.code && (r.code || "-") !== S.filters.code) return false;
+    if (S.filters.name && (r.name || "-") !== S.filters.name) return false;
+    if (S.filters.client && filterClientLabel(r) !== S.filters.client) return false;
+    if (S.filters.order && filterOrderLabel(r) !== S.filters.order) return false;
+    if (S.filters.status && rowStatusLabel(r) !== S.filters.status) return false;
+    if (S.filters.amount && amountFilterLabel(r) !== S.filters.amount) return false;
+    if (S.filters.outsource && outsourceFilterLabel(r) !== S.filters.outsource) return false;
+    if (S.filters.receivable && receivableFilterLabel(r) !== S.filters.receivable) return false;
+    if (S.filters.collected && collectedFilterLabel(r) !== S.filters.collected) return false;
+    if (S.filters.rate && rateFilterLabel(r) !== S.filters.rate) return false;
+    return true;
+  };
+
  if (E.cards && !E.cards.dataset.dashboardBound) {
    E.cards.dataset.dashboardBound = "true";
    E.cards.addEventListener("click", function (event) {
@@ -472,6 +615,26 @@
    });
  }

+  var panel = document.querySelector(".panel");
+  if (panel && !panel.dataset.ledgerFilterBound) {
+    panel.dataset.ledgerFilterBound = "true";
+    panel.addEventListener("click", function (event) {
+      var trigger = event.target && event.target.closest ? event.target.closest(".th-trigger") : null;
+      if (trigger) {
+        refreshFilterDom();
+        event.stopPropagation();
+        toggleFilterMenu(trigger.dataset.filter);
+        return;
+      }
+      var option = event.target && event.target.closest ? event.target.closest("button[data-filter-value]") : null;
+      var menu = event.target && event.target.closest ? event.target.closest(".th-menu") : null;
+      if (option && menu) {
+        event.stopPropagation();
+        setFilterValue(menu.dataset.filter, option.getAttribute("data-filter-value") || "");
+      }
+    });
+  }
+
  setTimeout(function () {
    try {
      filter();
--- a/frontend/apps/organization/README.md
+++ b/frontend/apps/organization/README.md
@@ -0,0 +1,16 @@
+# Organization App
+
+조직현황 탭 전용 소스 디렉터리다.
+
+- 편집 원본:
+  - `index.html`
+  - `assets/common.css`
+  - `assets/organization.css`
+  - `assets/organization.js`
+- 실제 서빙 대상:
+  - `DashBoard-organization.html`
+  - `legacy/static/common.css`
+  - `legacy/static/organization.css`
+  - `legacy/static/organization.js`
+
+수정 후에는 `scripts/publish_organization_app.sh`를 실행해 서빙 파일로 반영한다.
--- a/frontend/apps/organization/assets/common.css
+++ b/frontend/apps/organization/assets/common.css
@@ -0,0 +1,110 @@
+@import url("/design-tokens.css?v=20260401-01");
+@import url("/design-patterns.css?v=20260401-01");
+
+:root {
+  --font-sans: var(--ds-font-sans);
+
+  --color-bg: var(--ds-bg);
+  --color-bg-soft: var(--ds-bg-soft);
+  --color-surface: var(--ds-panel);
+  --color-surface-soft: var(--ds-panel-soft);
+  --color-surface-strong: var(--ds-panel-strong);
+  --color-text: var(--ds-ink);
+  --color-text-soft: var(--ds-text-soft);
+  --color-text-muted: var(--ds-text-muted);
+  --color-border: var(--ds-line);
+  --color-border-soft: var(--ds-line-soft);
+  --color-header: var(--ds-brand);
+  --color-header-soft: var(--ds-brand-soft);
+  --color-accent: var(--ds-accent);
+  --color-accent-soft: var(--ds-accent-soft);
+  --color-accent-strong: var(--ds-accent-strong);
+
+  --radius-sm: var(--ds-radius-sm);
+  --radius-md: var(--ds-radius-md);
+  --radius-lg: var(--ds-radius-lg);
+  --radius-xl: var(--ds-radius-xl);
+  --radius-pill: var(--ds-radius-pill);
+
+  --shadow-soft: var(--ds-shadow-soft);
+  --shadow-card: var(--ds-shadow-card);
+  --shadow-float: var(--ds-shadow-float);
+
+  --space-1: var(--ds-space-1);
+  --space-2: var(--ds-space-2);
+  --space-3: var(--ds-space-3);
+  --space-4: var(--ds-space-4);
+  --space-5: var(--ds-space-5);
+  --space-6: var(--ds-space-6);
+}
+
+* {
+  box-sizing: border-box;
+}
+
+html,
+body {
+  margin: 0;
+  height: 100%;
+  min-height: 100%;
+  font-family: var(--font-sans);
+  color: var(--color-text);
+  background: var(--ds-bg-gradient);
+}
+
+body {
+  min-height: 100vh;
+  overflow: hidden;
+  background: var(--ds-bg-gradient);
+}
+
+button,
+input,
+select,
+textarea,
+a {
+  font: inherit;
+}
+
+.ui-card {
+  background: var(--color-surface-soft);
+  border: 1px solid var(--color-border-soft);
+  border-radius: var(--radius-lg);
+  box-shadow: var(--shadow-soft);
+  backdrop-filter: blur(10px);
+}
+
+.ui-pill {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  min-height: 38px;
+  padding: 0 14px;
+  border-radius: var(--radius-pill);
+}
+
+.ui-button-primary {
+  border: none;
+  color: #fff;
+  background: var(--color-accent);
+  box-shadow: var(--shadow-float);
+}
+
+.ui-button-secondary {
+  border: 1px solid var(--color-border-soft);
+  color: var(--color-text);
+  background: var(--ds-surface-tint);
+}
+
+.ui-input {
+  border: 1px solid var(--color-border-soft);
+  border-radius: var(--radius-pill);
+  background: var(--ds-surface-tint-strong);
+  color: var(--color-text);
+  outline: none;
+}
+
+.ui-input:focus {
+  border-color: rgba(47, 153, 115, 0.45);
+  box-shadow: 0 0 0 4px rgba(47, 153, 115, 0.1);
+}
--- a/frontend/apps/organization/assets/organization.css
+++ b/frontend/apps/organization/assets/organization.css
--- a/frontend/apps/organization/assets/organization.js
+++ b/frontend/apps/organization/assets/organization.js
--- a/frontend/apps/organization/index.html
+++ b/frontend/apps/organization/index.html
@@ -0,0 +1,65 @@
+<!DOCTYPE html>
+<html lang="ko">
+<head>
+  <meta charset="UTF-8" />
+  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  <title>MH 조직현황 관리</title>
+  <link rel="preconnect" href="https://fonts.googleapis.com" />
+  <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
+  <link href="https://fonts.googleapis.com/css2?family=Pretendard:wght@400;600;700;900&display=swap" rel="stylesheet" />
+  <script src="https://cdn.tailwindcss.com"></script>
+    <link rel="stylesheet" href="/legacy/static/common.css?v=20260402-02" />
+    <link rel="stylesheet" href="/legacy/static/organization.css?v=20260402-02" />
+</head>
+<body>
+  <input type="file" id="upload-excel" class="hidden" accept=".xlsx, .csv" />
+
+  <div class="search-section">
+    <div class="flex flex-col w-full">
+      <div class="relative flex items-center w-full">
+        <span class="search-icon">
+          <svg width="15" height="15" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="3" stroke-linecap="round" stroke-linejoin="round"><circle cx="11" cy="11" r="8"></circle><line x1="21" y1="21" x2="16.65" y2="16.65"></line></svg>
+        </span>
+        <input type="text" id="search-input" placeholder="이름 또는 조직 검색" class="search-input" />
+      </div>
+      <div id="dept-tabs" class="dept-tabs-container"></div>
+    </div>
+  </div>
+
+  <div id="stats-area" class="stats-section" style="padding: 10px 15px;">
+    <div class="flex justify-between items-center mb-0 cursor-pointer p-0" id="stats-header">
+      <h2 class="stats-title text-xs font-black text-slate-800 flex items-center gap-2">인원 현황 통계 <span id="total-count-badge" class="bg-indigo-100 text-indigo-600 text-[10px] px-2 py-0.5 rounded-full">0명</span></h2>
+      <span id="stats-toggle-icon" class="text-slate-400 text-xs transition-transform duration-200" style="transform: rotate(-90deg);">▼</span>
+    </div>
+    <div id="stats-table-container" class="mt-3 overflow-hidden transition-all duration-300" style="display: none;"></div>
+  </div>
+
+  <div id="tree-root" class="org-canvas">
+    <div class="text-slate-400 font-bold mt-20 text-xs text-center">서버에서 조직 데이터를 불러오는 중입니다.</div>
+  </div>
+
+  <button id="admin-mode-btn" class="admin-mode-btn" data-label="관리자 모드 전환">🔐</button>
+
+  <div id="last-updated" class="fixed bottom-4 left-5 text-[10px] text-slate-400 font-bold z-[4000] pointer-events-none" style="letter-spacing: 0.02em; opacity: 0.8;"></div>
+
+  <div class="fab-container" id="fab-container">
+    <button class="fab-main text-white" id="fab-main">+</button>
+    <div class="fab-menu" id="fab-menu"></div>
+  </div>
+
+  <div id="modal">
+    <div class="modal-content">
+      <div id="modal-header-area">
+        <h2 id="modal-title" class="text-xl font-black mb-6 text-slate-800 border-b pb-4">구성원 정보 수정</h2>
+      </div>
+      <div id="modal-fields" class="grid grid-cols-2 gap-x-8 gap-y-5"></div>
+      <div id="modal-footer-area" class="flex gap-4 mt-10">
+        <button id="modal-cancel-btn" class="flex-1 bg-slate-100 py-3.5 rounded-xl font-bold text-sm">취소</button>
+        <button id="btn-save" class="flex-1 bg-indigo-600 text-white py-3.5 rounded-xl font-bold text-sm">저장</button>
+      </div>
+    </div>
+  </div>
+
+    <script src="/legacy/static/organization.js?v=20260402-02"></script>
+  </body>
+</html>
--- a/frontend/public/app.js
+++ b/frontend/public/app.js
@@ -50,6 +50,7 @@ const seatMapDom = {
    formGap: null,
    formImage: document.getElementById("seatmap-admin-form-image"),
    search: document.getElementById("seatmap-admin-search"),
+    context: document.getElementById("seatmap-admin-context"),
    unassigned: document.getElementById("seatmap-admin-unassigned"),
    officeTabs: document.getElementById("seatmap-admin-office-tabs"),
    sidebarTitle: document.getElementById("seatmap-admin-sidebar-title"),
@@ -75,6 +76,7 @@ const seatMapDom = {
    formGap: null,
    formImage: null,
    search: document.getElementById("seatmap-readonly-search"),
+    context: document.getElementById("seatmap-readonly-context"),
    unassigned: document.getElementById("seatmap-readonly-unassigned"),
    officeTabs: document.getElementById("seatmap-readonly-office-tabs"),
    sidebarTitle: document.getElementById("seatmap-readonly-sidebar-title"),
@@ -100,6 +102,7 @@ let seatMapFormCols = seatMapDom.admin.formCols;
 let seatMapFormGap = seatMapDom.admin.formGap;
 let seatMapFormImage = seatMapDom.admin.formImage;
 let seatMapSearch = seatMapDom.admin.search;
+let seatMapContext = seatMapDom.admin.context;
 let seatMapUnassigned = seatMapDom.admin.unassigned;
 let seatMapOfficeTabs = seatMapDom.admin.officeTabs;
 let seatMapSidebarTitle = seatMapDom.admin.sidebarTitle;
@@ -135,6 +138,7 @@ const seatMapState = {
  search: "",
  status: "",
  statusTone: "info",
+  selectedMemberId: null,
  draggingMemberId: null,
  zoom: 1,
  panning: false,
@@ -491,6 +495,7 @@ function syncSeatMapDomRefs() {
  seatMapFormGap = dom.formGap;
  seatMapFormImage = dom.formImage;
  seatMapSearch = dom.search;
+  seatMapContext = dom.context;
  seatMapUnassigned = dom.unassigned;
  seatMapOfficeTabs = dom.officeTabs;
  seatMapSidebarTitle = dom.sidebarTitle;
@@ -837,6 +842,98 @@ function getMemberMap() {
  return new Map(seatMapState.members.map((member) => [Number(member.id), member]));
 }

+function buildSeatMapTeamTone(teamName) {
+  const team = String(teamName || "").trim();
+  if (!team) {
+    return {
+      accent: "rgba(120, 132, 119, 0.86)",
+      soft: "rgba(120, 132, 119, 0.18)",
+      label: "미분류",
+    };
+  }
+  const palette = [
+    { accent: "rgba(13, 148, 136, 0.9)", soft: "rgba(13, 148, 136, 0.18)" },
+    { accent: "rgba(202, 138, 4, 0.9)", soft: "rgba(202, 138, 4, 0.18)" },
+    { accent: "rgba(5, 150, 105, 0.9)", soft: "rgba(5, 150, 105, 0.18)" },
+    { accent: "rgba(180, 83, 9, 0.9)", soft: "rgba(180, 83, 9, 0.18)" },
+    { accent: "rgba(20, 83, 45, 0.9)", soft: "rgba(20, 83, 45, 0.16)" },
+    { accent: "rgba(11, 110, 79, 0.9)", soft: "rgba(11, 110, 79, 0.18)" },
+  ];
+  let hash = 0;
+  for (const char of team) {
+    hash = ((hash * 31) + char.charCodeAt(0)) % 2147483647;
+  }
+  const picked = palette[Math.abs(hash) % palette.length];
+  return { ...picked, label: team };
+}
+
+function getSeatMapTeamStyle(member) {
+  const tone = buildSeatMapTeamTone(getSeatMapOrgUnitLabel(member));
+  return `--seatmap-team-accent:${tone.accent}; --seatmap-team-soft:${tone.soft};`;
+}
+
+function renderSeatMapTeamChip(member) {
+  const label = getSeatMapOrgUnitLabel(member);
+  const tone = buildSeatMapTeamTone(label);
+  return `<span class="seatmap-team-chip" style="${escapeHtml(getSeatMapTeamStyle({ team: label }))}">${escapeHtml(label)}</span>`;
+}
+
+function getSeatMapOrgPath(member) {
+  const values = [
+    member?.department,
+    member?.grp,
+    member?.division,
+    member?.team,
+    member?.cell,
+  ]
+    .map((value) => String(value || "").trim())
+    .filter(Boolean);
+  return values.filter((value, index) => values.indexOf(value) === index);
+}
+
+function getSeatMapOrgUnitLabel(member) {
+  return String(
+    member?.team
+    || member?.division
+    || member?.grp
+    || member?.department
+    || member?.cell
+    || "미분류"
+  ).trim() || "미분류";
+}
+
+function getSeatMapOverlayTeamLabel(member) {
+  return String(member?.team || "").trim();
+}
+
+function renderSeatMapMemberContext(memberId) {
+  if (!seatMapContext) return;
+  const member = memberId ? getMemberMap().get(Number(memberId)) : null;
+  seatMapState.selectedMemberId = member ? Number(member.id) : null;
+  if (!member) {
+    seatMapContext.classList.add("hidden");
+    seatMapContext.innerHTML = "";
+    return;
+  }
+  const tone = buildSeatMapTeamTone(member.team);
+  const orgPath = getSeatMapOrgPath(member);
+  seatMapContext.classList.remove("hidden");
+  seatMapContext.innerHTML = `
+    <div class="seatmap-context-head">
+      <div class="seatmap-context-title">
+        <strong>${escapeHtml(member.name || "-")}</strong>
+        <span>${escapeHtml(member.rank || member.role || "구성원")}</span>
+      </div>
+      <span class="seatmap-context-badge" style="${escapeHtml(getSeatMapTeamStyle(member))}">${escapeHtml(tone.label)}</span>
+    </div>
+    <div class="seatmap-context-tree">
+      ${orgPath.length
+        ? orgPath.map((item) => `<span class="seatmap-context-node">${escapeHtml(item)}</span>`).join("")
+        : '<div class="seatmap-context-empty">표시할 상위 조직 정보가 없습니다.</div>'}
+    </div>
+  `;
+}
+
 function getPlacementForMember(memberId) {
  return getPlacementSource().find((item) => Number(item.member_id) === Number(memberId)) || null;
 }
@@ -871,9 +968,13 @@ function getSidebarMembers() {
  return members.filter(memberMatchesSeatMapSearch);
 }

-function focusSeatMapMember(memberId) {
+function focusSeatMapMember(memberId, options = {}) {
+  const showContext = options.showContext !== false;
  const placement = getPlacementForMember(memberId);
  const member = getMemberMap().get(Number(memberId));
+  if (showContext) {
+    renderSeatMapMemberContext(memberId);
+  }
  if (!placement) {
    setSeatMapStatus("해당 인원은 아직 배치되지 않았습니다.", "info");
    return;
@@ -943,6 +1044,46 @@ function getSlotPlacementMap() {
  return slotMap;
 }

+function buildSeatMapGridTeamOverlays(rows, cols, placementMap, memberMap) {
+  const groups = new Map();
+  placementMap.forEach((placement) => {
+    const member = memberMap.get(Number(placement.member_id));
+    if (!member) return;
+    const label = getSeatMapOverlayTeamLabel(member);
+    if (!label) return;
+    const rowIndex = Number(placement.row_index);
+    const colIndex = Number(placement.col_index);
+    if (!Number.isFinite(rowIndex) || !Number.isFinite(colIndex)) return;
+    if (!groups.has(label)) {
+      groups.set(label, {
+        label,
+        toneMember: { team: label },
+        minRow: rowIndex,
+        maxRow: rowIndex,
+        minCol: colIndex,
+        maxCol: colIndex,
+        count: 1,
+      });
+      return;
+    }
+    const group = groups.get(label);
+    group.minRow = Math.min(group.minRow, rowIndex);
+    group.maxRow = Math.max(group.maxRow, rowIndex);
+    group.minCol = Math.min(group.minCol, colIndex);
+    group.maxCol = Math.max(group.maxCol, colIndex);
+    group.count += 1;
+  });
+  return Array.from(groups.values())
+    .filter((group) => group.count >= 2 && group.maxRow < rows && group.maxCol < cols)
+    .map((group) => `
+      <div
+        class="seatmap-team-overlay"
+        data-team-label="${escapeHtml(group.label)}"
+        style="${escapeHtml(getSeatMapTeamStyle(group.toneMember))}; grid-column:${group.minCol + 1} / ${group.maxCol + 2}; grid-row:${group.minRow + 1} / ${group.maxRow + 2};"
+      ></div>
+    `);
+}
+
 function upsertDraftPlacement(memberId, rowIndex, colIndex) {
  const cellMap = getCellPlacementMap();
  const existing = cellMap.get(`${rowIndex}:${colIndex}`);
@@ -1003,11 +1144,12 @@ function renderMemberCard(member, draggable) {
    ? `<span class="seatmap-member-avatar"><img src="${photoUrl}" alt="${escapeHtml(member.name)}"></span>`
    : `<span class="seatmap-member-avatar seatmap-member-avatar-fallback">${escapeHtml(getInitials(member.name))}</span>`;
  return `
-    <div class="seatmap-member-card${draggable ? " draggable" : ""}" draggable="${draggable}" data-member-id="${Number(member.id)}">
+    <div class="seatmap-member-card team-colored${draggable ? " draggable" : ""}" style="${escapeHtml(getSeatMapTeamStyle(member))}" draggable="${draggable}" data-member-id="${Number(member.id)}">
      ${avatar}
      <span class="seatmap-member-text">
        <strong>${escapeHtml(member.name || "-")}</strong>
-        <em>${escapeHtml(member.department || member.team || member.rank || "-")}</em>
+        <em>${escapeHtml(member.rank || "-")}</em>
+        <span class="seatmap-team-chip" style="${escapeHtml(getSeatMapTeamStyle({ team: getSeatMapOrgUnitLabel(member) }))}">${escapeHtml(getSeatMapOrgUnitLabel(member))}</span>
      </span>
    </div>
  `;
@@ -1015,11 +1157,12 @@ function renderMemberCard(member, draggable) {

 function renderUnassignedMemberCard(member, draggable) {
  return `
-    <div class="seatmap-member-card seatmap-member-card-compact${draggable ? " draggable" : ""}" draggable="${draggable}" data-member-id="${Number(member.id)}">
+    <div class="seatmap-member-card seatmap-member-card-compact${draggable ? " draggable" : ""}" style="${escapeHtml(getSeatMapTeamStyle(member))}" draggable="${draggable}" data-member-id="${Number(member.id)}">
      <span class="seatmap-member-text seatmap-member-text-inline">
        <strong>${escapeHtml(member.name || "-")}</strong>
        <em>${escapeHtml(member.rank || "-")}</em>
      </span>
+      ${renderSeatMapTeamChip(member)}
    </div>
  `;
 }
@@ -1027,14 +1170,13 @@ function renderUnassignedMemberCard(member, draggable) {
 function renderSeatMapSearchCard(member) {
  const placement = getPlacementForMember(Number(member.id));
  if (!placement) return "";
-  const badge = `<span class="seatmap-member-badge occupied">${escapeHtml(placement.seat_label || "배치완료")}</span>`;
  return `
    <button class="seatmap-member-search-card" type="button" data-member-id="${Number(member.id)}">
      <span class="seatmap-member-text seatmap-member-text-inline">
        <strong>${escapeHtml(member.name || "-")}</strong>
-        <em>${escapeHtml(member.rank || member.department || "-")}</em>
+        <em>${escapeHtml(member.rank || "-")}</em>
      </span>
-      ${badge}
+      ${renderSeatMapTeamChip(member)}
    </button>
  `;
 }
@@ -1054,14 +1196,16 @@ function renderSeatMapBoard() {
  const gap = Number(seatMapState.seatMap.cell_gap || 0);
  const editable = seatMapState.editMode && isAdmin();
  const cells = [];
+  const overlays = buildSeatMapGridTeamOverlays(rows, cols, placementMap, memberMap);

  for (let rowIndex = 0; rowIndex < rows; rowIndex += 1) {
    for (let colIndex = 0; colIndex < cols; colIndex += 1) {
      const key = `${rowIndex}:${colIndex}`;
      const placement = placementMap.get(key);
      const member = placement ? memberMap.get(Number(placement.member_id)) : null;
+      const teamStyle = member ? ` style="${escapeHtml(getSeatMapTeamStyle(member))}"` : "";
      cells.push(`
-        <div class="seatmap-cell${placement ? " occupied" : ""}${editable ? " editable" : ""}" data-row="${rowIndex}" data-col="${colIndex}">
+        <div class="seatmap-cell${placement ? " occupied" : ""}${member ? " team-colored" : ""}${editable ? " editable" : ""}" data-row="${rowIndex}" data-col="${colIndex}"${teamStyle}>
          <span class="seatmap-cell-label">${escapeHtml(computeSeatLabel(rowIndex, colIndex))}</span>
          ${member ? renderMemberCard(member, editable) : ""}
        </div>
@@ -1072,7 +1216,7 @@ function renderSeatMapBoard() {
  seatMapBoard.innerHTML = `
    <div class="seatmap-canvas" style="--seatmap-rows:${rows}; --seatmap-cols:${cols}; --seatmap-gap:${gap}px;">
      <img class="seatmap-image" src="${escapeHtml(seatMapState.seatMap.image_url)}" alt="${escapeHtml(seatMapState.seatMap.name)}">
-      <div class="seatmap-grid">${cells.join("")}</div>
+      <div class="seatmap-grid">${overlays.join("")}${cells.join("")}</div>
    </div>
  `;
 }
@@ -1175,6 +1319,7 @@ function renderSeatMapActions() {
 function updateSeatMapDraftUi() {
  renderSeatMapActions();
  renderUnassignedMembers();
+  renderSeatMapMemberContext(seatMapState.selectedMemberId);
  syncSeatMapViewerFrame();
 }

@@ -1394,6 +1539,9 @@ function handleEmbeddedNavigationMessage(event) {
      updateSeatMapDraftUi();
    }
  }
+  if (data.type === "seatmap-member-selected") {
+    renderSeatMapMemberContext(Number(data.memberId || 0) || null);
+  }
 }

 async function fetchJson(url, options) {
@@ -1437,6 +1585,7 @@ async function loadSeatMapData(force = false) {
    seatMapState.placements = clonePlacements(layoutPayload.placements || []);
    seatMapState.zoom = 1;
    seatMapState.hoveredSlotId = null;
+    seatMapState.selectedMemberId = null;
    seatMapState.editMode = canEditSeatMap();
    resetSeatMapDraft();
    seatMapState.loaded = true;
@@ -1450,6 +1599,7 @@ async function loadSeatMapData(force = false) {
      seatMapState.placements = [];
      seatMapState.zoom = 1;
      seatMapState.hoveredSlotId = null;
+      seatMapState.selectedMemberId = null;
      seatMapState.editMode = canEditSeatMap();
      resetSeatMapDraft();
      seatMapState.loaded = true;
@@ -1690,7 +1840,7 @@ function setActiveView(view) {
    dbStatusFrame.src = resolveAppUrl(frameSrc);
  }
  if (isSeatMapAdmin || isSeatMapReadonly) {
-    loadSeatMapData();
+    loadSeatMapData(previousView !== currentView);
  }
  notifyEmbeddedTabActivated();
 }
@@ -1886,14 +2036,15 @@ Object.values(seatMapDom).forEach((dom) => {
  });

  dom.unassigned?.addEventListener("click", (event) => {
-    const button = event.target.closest("[data-member-id]");
-    if (!button) return;
-    if (button.classList.contains("seatmap-member-search-card")) {
-      focusSeatMapMember(Number(button.dataset.memberId));
+    const target = event.target.closest("[data-member-id]");
+    if (!target) return;
+    if (target.classList.contains("seatmap-member-search-card")) {
+      focusSeatMapMember(Number(target.dataset.memberId), { showContext: false });
      return;
    }
+    renderSeatMapMemberContext(Number(target.dataset.memberId));
    if (canEditSeatMap()) return;
-    focusSeatMapMember(Number(button.dataset.memberId));
+    focusSeatMapMember(Number(target.dataset.memberId));
  });
  dom.unassigned?.addEventListener("dragover", (event) => {
    if (!seatMapState.editMode) return;
@@ -1922,6 +2073,17 @@ Object.values(seatMapDom).forEach((dom) => {
    if (!fitButton) return;
    fitDxfSeatMapBoard();
  });
+  dom.board?.addEventListener("click", (event) => {
+    const memberCard = event.target.closest(".seatmap-member-card[data-member-id]");
+    if (memberCard) {
+      renderSeatMapMemberContext(Number(memberCard.dataset.memberId));
+      return;
+    }
+    const cell = event.target.closest(".seatmap-cell[data-row][data-col]");
+    if (!cell) return;
+    const placement = getCellPlacementMap().get(`${Number(cell.dataset.row)}:${Number(cell.dataset.col)}`);
+    renderSeatMapMemberContext(placement ? Number(placement.member_id) : null);
+  });
  dom.board?.addEventListener("dragover", (event) => {
    if (!seatMapState.editMode) return;
    const target = isSlotBasedSeatMap()
--- a/frontend/public/db-status.html
+++ b/frontend/public/db-status.html
@@ -110,6 +110,14 @@
    .panel-body {
      padding: 16px 18px 20px;
    }
+    .panel-toolbar {
+      display: flex;
+      align-items: center;
+      justify-content: space-between;
+      gap: 12px;
+      margin-bottom: 14px;
+      flex-wrap: wrap;
+    }
    .panel-body.tight {
      padding-top: 0;
    }
@@ -211,6 +219,44 @@
      font-size: 11px;
      font-weight: 700;
    }
+    .toolbar-input {
+      width: min(360px, 100%);
+      padding: 11px 14px;
+      border-radius: 14px;
+      border: 1px solid rgba(132, 102, 54, 0.16);
+      background: rgba(255, 251, 244, 0.96);
+      color: #2f2419;
+      font: inherit;
+    }
+    .toolbar-input:focus {
+      outline: none;
+      border-color: rgba(129, 88, 31, 0.34);
+      box-shadow: 0 0 0 4px rgba(208, 176, 116, 0.16);
+    }
+    .toolbar-actions {
+      display: flex;
+      align-items: center;
+      gap: 10px;
+      flex-wrap: wrap;
+    }
+    .action-button {
+      border: 1px solid rgba(128, 98, 48, 0.14);
+      background: rgba(250, 240, 213, 0.62);
+      color: #6c4a1a;
+      border-radius: 999px;
+      padding: 9px 14px;
+      font: inherit;
+      font-size: 12px;
+      font-weight: 800;
+      cursor: pointer;
+    }
+    .action-button:hover {
+      background: rgba(244, 228, 186, 0.8);
+    }
+    .action-button:disabled {
+      cursor: not-allowed;
+      opacity: 0.45;
+    }
    .notes {
      margin: 0;
      padding-left: 18px;
@@ -219,6 +265,33 @@
      color: rgba(84, 65, 38, 0.84);
      line-height: 1.55;
    }
+    .mapping-list {
+      display: grid;
+      gap: 14px;
+    }
+    .mapping-card {
+      padding: 14px 16px;
+      border-radius: 18px;
+      background: rgba(255, 249, 239, 0.92);
+      border: 1px solid rgba(132, 102, 54, 0.12);
+    }
+    .mapping-card h3 {
+      margin: 0 0 8px;
+      font-size: 15px;
+      font-weight: 800;
+      letter-spacing: -0.02em;
+    }
+    .mapping-card p {
+      margin: 8px 0 0;
+      color: rgba(98, 75, 42, 0.74);
+      line-height: 1.55;
+      font-size: 13px;
+    }
+    .mapping-table-list {
+      display: flex;
+      flex-wrap: wrap;
+      gap: 6px;
+    }
    .preview-meta {
      display: grid;
      gap: 10px;
@@ -345,6 +418,9 @@
      <p>
        `원본 import 배치`는 업로드한 원본 파일이 몇 행으로 적재됐는지 보여주고, `바이너리 원본 보관`은 엑셀 같은 파일 자체를 DB에 보관하는 상태를 보여줍니다.
      </p>
+      <p>
+        아래 표는 전체 테이블을 보여주고, 오른쪽 패널은 화면별 데이터 소스와 저장 흐름을 운영 관점으로 묶어서 보여줍니다.
+      </p>
    </section>

    <section id="overview" class="overview"></section>
@@ -354,11 +430,17 @@
        <div class="panel-head">
          <div>
            <h2>전체 테이블 현황</h2>
-            <p>전체 27개 테이블을 보여주며, 테이블명을 누르면 샘플 row를 바로 확인할 수 있습니다.</p>
+            <p>현재 운영 DB의 전체 26개 테이블을 보여주며, 테이블명을 누르면 샘플 row를 바로 확인할 수 있습니다.</p>
          </div>
          <span id="generated-at" class="meta-chip">로딩 중</span>
        </div>
        <div class="panel-body">
+          <div class="panel-toolbar">
+            <input id="table-search" class="toolbar-input" type="search" placeholder="테이블명, 설명, 화면명으로 검색" />
+            <div class="toolbar-actions">
+              <span id="table-count" class="meta-chip">0 / 0</span>
+            </div>
+          </div>
          <table>
            <thead>
              <tr>
@@ -438,11 +520,24 @@
        <article class="panel">
          <div class="panel-head">
            <div>
-              <h2>테이블 분류</h2>
-              <p>유지/주의/원본·추적/정리 후보로 나눈 현재 기준입니다.</p>
+              <h2>운영 분류</h2>
+              <p>유지/주의/원본·추적/정리 후보 기준과 제품 관점 묶음을 같이 봅니다.</p>
            </div>
          </div>
-          <div id="group-summary" class="panel-body"></div>
+          <div class="panel-body">
+            <div id="group-summary"></div>
+            <div id="product-summary" style="margin-top:18px;"></div>
+          </div>
+        </article>
+
+        <article class="panel">
+          <div class="panel-head">
+            <div>
+              <h2>화면별 데이터 소스</h2>
+              <p>각 탭/기능이 실제로 어떤 테이블을 읽고 저장하는지 빠르게 확인합니다.</p>
+            </div>
+          </div>
+          <div id="screen-map" class="panel-body mapping-list"></div>
        </article>

      </div>
@@ -456,8 +551,11 @@
          <h2 id="preview-title">테이블 내용 미리보기</h2>
          <p id="preview-subtitle" class="muted">선택한 테이블의 컬럼과 최대 50개 row를 표시합니다.</p>
        </div>
+        <div class="toolbar-actions">
+          <button id="preview-download" class="action-button" type="button" disabled>CSV 다운로드</button>
          <button id="preview-close" class="modal-close" type="button" aria-label="닫기">×</button>
        </div>
+      </div>
      <div class="modal-body">
        <div id="preview-meta" class="preview-meta"></div>
        <div class="panel-body tight">
@@ -475,6 +573,9 @@
  </div>

  <script>
+    let allTables = [];
+    let currentPreview = null;
+
    function escapeHtml(value) {
      return String(value ?? "")
        .replaceAll("&", "&amp;")
@@ -529,6 +630,10 @@

    function renderTables(items) {
      const target = document.getElementById("table-body");
+      const countTarget = document.getElementById("table-count");
+      if (countTarget) {
+        countTarget.textContent = `${formatNumber(items.length)} / ${formatNumber(allTables.length)}`;
+      }
      if (!items.length) {
        target.innerHTML = '<tr><td colspan="5" class="empty">표시할 테이블이 없습니다.</td></tr>';
        return;
@@ -619,8 +724,46 @@
      `).join("");
    }

+    function renderProductSummary(summary) {
+      const target = document.getElementById("product-summary");
+      const groups = [
+        "탭 데이터",
+        "로그인·권한",
+        "히스토리",
+        "로우데이터·적재",
+        "보정·보조",
+      ];
+      target.innerHTML = groups.map((label) => `
+        <div style="display:grid; gap:8px; margin-bottom:16px;">
+          <div><span class="group-tag keep">${escapeHtml(label)}</span></div>
+          <div class="view-list">
+            ${((summary && summary[label]) || []).map((item) => `<span class="view-pill">${escapeHtml(item)}</span>`).join("") || '<span class="muted">없음</span>'}
+          </div>
+        </div>
+      `).join("");
+    }
+
+    function renderScreenMap(items) {
+      const target = document.getElementById("screen-map");
+      if (!items || !items.length) {
+        target.innerHTML = '<div class="empty">화면별 데이터 소스 정보가 없습니다.</div>';
+        return;
+      }
+      target.innerHTML = items.map((item) => `
+        <article class="mapping-card">
+          <h3>${escapeHtml(item.screen || "")}</h3>
+          <div class="mapping-table-list">
+            ${(item.tables || []).map((table) => `<span class="view-pill">${escapeHtml(table)}</span>`).join("")}
+          </div>
+          <p>${escapeHtml(item.write_flow || "")}</p>
+        </article>
+      `).join("");
+    }
+
    function renderTablePreview(payload) {
+      currentPreview = payload;
      const previewModal = document.getElementById("preview-modal");
+      const downloadButton = document.getElementById("preview-download");
      const previewMeta = document.getElementById("preview-meta");
      const previewTitle = document.getElementById("preview-title");
      const previewSubtitle = document.getElementById("preview-subtitle");
@@ -629,6 +772,9 @@

      previewTitle.textContent = `${payload.label} · ${payload.table_ref}`;
      previewSubtitle.textContent = `${formatNumber(payload.row_count)} rows / 최대 ${formatNumber(payload.limit)}개 표시`;
+      if (downloadButton) {
+        downloadButton.disabled = !(payload.rows && payload.rows.length);
+      }
      previewMeta.innerHTML = `
        <div>
          <div class="table-title">${escapeHtml(payload.label)}</div>
@@ -686,15 +832,62 @@
        throw new Error(`DB 상태를 불러오지 못했습니다. (${response.status})`);
      }
      const payload = await response.json();
+      allTables = payload.tables || [];
      document.getElementById("generated-at").textContent = payload.generated_at
        ? `갱신 ${formatDateTime(payload.generated_at)}`
        : "갱신 시각 없음";
      renderOverview(payload.overview || {});
-      renderTables(payload.tables || []);
+      renderTables(allTables);
      renderBatches(payload.import_batches || []);
      renderBinarySources(payload.binary_sources || []);
      renderNotes(payload.notes || []);
      renderGroupSummary(payload.group_summary || {});
+      renderProductSummary(payload.product_summary || {});
+      renderScreenMap(payload.screen_map || []);
+    }
+
+    function toCsvValue(value) {
+      const text = String(value ?? "");
+      if (!/[",\n]/.test(text)) return text;
+      return `"${text.replaceAll('"', '""')}"`;
+    }
+
+    function downloadPreviewCsv() {
+      if (!currentPreview || !currentPreview.columns || !currentPreview.rows || !currentPreview.rows.length) return;
+      const headers = currentPreview.columns.map((column) => column.name);
+      const lines = [
+        headers.map(toCsvValue).join(","),
+        ...currentPreview.rows.map((row) => headers.map((header) => toCsvValue(row[header] ?? "")).join(",")),
+      ];
+      const blob = new Blob(["\ufeff" + lines.join("\n")], { type: "text/csv;charset=utf-8;" });
+      const url = URL.createObjectURL(blob);
+      const link = document.createElement("a");
+      link.href = url;
+      link.download = `${currentPreview.table_name || "table-preview"}.csv`;
+      document.body.appendChild(link);
+      link.click();
+      link.remove();
+      URL.revokeObjectURL(url);
+    }
+
+    function applyTableSearch(query) {
+      const normalized = String(query || "").trim().toLowerCase();
+      if (!normalized) {
+        renderTables(allTables);
+        return;
+      }
+      const filtered = allTables.filter((item) => {
+        const haystack = [
+          item.label,
+          item.table_ref,
+          item.description,
+          ...(item.related_views || []),
+          item.domain,
+          item.group,
+        ].join(" ").toLowerCase();
+        return haystack.includes(normalized);
+      });
+      renderTables(filtered);
    }

    document.getElementById("preview-close").addEventListener("click", () => {
@@ -703,6 +896,11 @@
      modal.setAttribute("aria-hidden", "true");
    });

+    document.getElementById("preview-download").addEventListener("click", downloadPreviewCsv);
+    document.getElementById("table-search").addEventListener("input", (event) => {
+      applyTableSearch(event.target.value);
+    });
+
    document.getElementById("preview-modal").addEventListener("click", (event) => {
      if (event.target.id !== "preview-modal") return;
      const modal = document.getElementById("preview-modal");
--- a/frontend/public/index.html
+++ b/frontend/public/index.html
@@ -16,7 +16,7 @@
  <link rel="stylesheet" href="/design-patterns.css?v=20260401-01">
  <link rel="stylesheet" href="/legacy/static/common.css">
  <!-- Keep login and common hub defaults aligned with 8080. -->
-  <link rel="stylesheet" href="/styles.css?v=20260330-01">
+  <link rel="stylesheet" href="/styles.css?v=20260402-01">
  <!-- 8081-only hub overrides must not restyle the login screen. -->
  <link rel="stylesheet" href="/styles-8081-design.css?v=20260401-01">
 </head>
@@ -105,7 +105,7 @@
      <section id="organization-stage" class="main-stage">
        <div class="stage-frame">
          <!-- Legacy organization keeps its own CSS/JS responsibility under /legacy/static. -->
-          <iframe id="organization-frame" src="/legacy/organization?v=20260330-02" data-src="/legacy/organization?v=20260330-02" title="조직도 메인 화면"></iframe>
+          <iframe id="organization-frame" src="/legacy/organization?v=20260402-02" data-src="/legacy/organization?v=20260402-02" title="조직도 메인 화면"></iframe>
        </div>
      </section>
      <section id="project-stage" class="main-stage" hidden>
@@ -181,6 +181,7 @@
                  <span class="hidden">구성원 검색</span>
                  <input id="seatmap-admin-search" type="search" placeholder="이름 또는 부서 검색">
                </label>
+                <div id="seatmap-admin-context" class="seatmap-context-panel hidden"></div>
                <div id="seatmap-admin-unassigned" class="seatmap-member-list"></div>
              </section>
            </aside>
@@ -220,6 +221,7 @@
                  <span class="hidden">구성원 검색</span>
                  <input id="seatmap-readonly-search" type="search" placeholder="이름 또는 부서 검색">
                </label>
+                <div id="seatmap-readonly-context" class="seatmap-context-panel hidden"></div>
                <div id="seatmap-readonly-unassigned" class="seatmap-member-list"></div>
              </section>
            </aside>
--- a/frontend/public/styles.css
+++ b/frontend/public/styles.css
@@ -344,6 +344,12 @@ body {
  padding-right: 8px;
 }

+.header-date-field select option {
+  background: var(--color-surface);
+  color: var(--color-text);
+  font-weight: 700;
+}
+
 .header-date-sep {
  color: var(--color-text-muted);
  font-size: 12px;
@@ -913,6 +919,39 @@ body {
  padding: var(--seatmap-gap);
 }

+.seatmap-team-overlay {
+  pointer-events: none;
+  align-self: stretch;
+  justify-self: stretch;
+  border-radius: 20px;
+  border: 2px solid color-mix(in srgb, var(--seatmap-team-accent, rgba(13, 148, 136, 0.3)) 62%, white);
+  background: linear-gradient(
+    180deg,
+    color-mix(in srgb, var(--seatmap-team-soft, rgba(13, 148, 136, 0.12)) 100%, transparent),
+    color-mix(in srgb, var(--seatmap-team-soft, rgba(13, 148, 136, 0.08)) 90%, transparent)
+  );
+  box-shadow: inset 0 0 0 1px rgba(255, 255, 255, 0.22), 0 8px 18px rgba(16, 37, 29, 0.08);
+  margin: 4px;
+  z-index: 0;
+}
+
+.seatmap-team-overlay::before {
+  content: attr(data-team-label);
+  position: absolute;
+  top: 10px;
+  left: 12px;
+  display: inline-flex;
+  align-items: center;
+  min-height: 26px;
+  padding: 0 11px;
+  border-radius: 999px;
+  background: color-mix(in srgb, var(--seatmap-team-soft, rgba(13, 148, 136, 0.14)) 84%, white);
+  color: color-mix(in srgb, var(--seatmap-team-accent, #0f766e) 86%, #10251d);
+  font-size: 11px;
+  font-weight: 900;
+  letter-spacing: 0.02em;
+}
+
 .seatmap-cell {
  position: relative;
  min-width: 0;
@@ -920,6 +959,7 @@ body {
  border: 1px dashed rgba(15, 23, 42, 0.14);
  background: rgba(255, 255, 255, 0.12);
  transition: border-color 0.18s ease, background 0.18s ease;
+  z-index: 1;
 }

 .seatmap-cell.editable:hover {
@@ -931,6 +971,13 @@ body {
  background: rgba(255, 255, 255, 0.18);
 }

+.seatmap-cell.occupied.team-colored {
+  border-color: color-mix(in srgb, var(--seatmap-team-accent, rgba(15, 118, 110, 0.72)) 62%, white);
+  background:
+    linear-gradient(180deg, color-mix(in srgb, var(--seatmap-team-soft, rgba(15, 118, 110, 0.14)) 86%, transparent), rgba(255, 255, 255, 0.14)),
+    rgba(255, 255, 255, 0.18);
+}
+
 .seatmap-cell-label {
  position: absolute;
  top: 4px;
@@ -959,6 +1006,12 @@ body {
  overflow: hidden;
 }

+.seatmap-member-card.team-colored {
+  border-color: color-mix(in srgb, var(--seatmap-team-accent, rgba(245, 158, 11, 0.95)) 42%, rgba(255,255,255,0.4));
+  background:
+    linear-gradient(180deg, color-mix(in srgb, var(--seatmap-team-soft, rgba(245, 158, 11, 0.18)) 68%, rgba(15, 23, 42, 0.84)) 0%, rgba(15, 23, 42, 0.84) 100%);
+}
+
 .seatmap-member-card.draggable {
  cursor: grab;
 }
@@ -1008,11 +1061,26 @@ body {
 }

 .seatmap-member-text em {
-  color: rgba(226, 232, 240, 0.84);
+  color: rgba(255, 247, 237, 0.96);
  font-size: 10px;
+  font-weight: 800;
  font-style: normal;
 }

+.seatmap-team-chip {
+  display: inline-flex;
+  align-items: center;
+  max-width: 100%;
+  padding: 2px 6px;
+  border-radius: 999px;
+  background: color-mix(in srgb, var(--seatmap-team-soft, rgba(245, 158, 11, 0.18)) 88%, white);
+  color: color-mix(in srgb, var(--seatmap-team-accent, #b45309) 85%, #10251d);
+  font-size: 10px;
+  font-weight: 900;
+  line-height: 1;
+  letter-spacing: 0.01em;
+}
+
 .seatmap-sidebar {
  height: 100%;
  min-height: 0;
@@ -1195,6 +1263,11 @@ body {
  text-align: left;
 }

+.seatmap-member-search-card.team-colored {
+  border-color: color-mix(in srgb, var(--seatmap-team-accent, rgba(245, 158, 11, 0.24)) 34%, rgba(226, 232, 240, 0.9));
+  background: linear-gradient(180deg, color-mix(in srgb, var(--seatmap-team-soft, rgba(245, 158, 11, 0.1)) 78%, white), #fff);
+}
+
 .seatmap-member-badge {
  flex: 0 0 auto;
  display: inline-flex;
@@ -1219,8 +1292,8 @@ body {
  min-height: 42px;
  padding: 10px 12px;
  border-radius: 12px;
-  background: #3f4658;
-  border: 1px solid rgba(148, 163, 184, 0.14);
+  background: transparent;
+  border: 1px solid rgba(194, 170, 134, 0.34);
  box-shadow: none;
 }

@@ -1232,12 +1305,14 @@ body {

 .seatmap-member-text-inline strong {
  font-size: 13px;
+  color: #10251d;
 }

 .seatmap-member-text-inline em {
  display: inline;
-  color: rgba(226, 232, 240, 0.8);
+  color: #6f5b3e;
  font-size: 11px;
+  font-weight: 800;
 }

 .seatmap-slot .seatmap-member-card {
@@ -1266,6 +1341,81 @@ body {
  display: none;
 }

+.seatmap-context-panel {
+  display: grid;
+  gap: 10px;
+  padding: 14px;
+  border: 1px solid rgba(194, 170, 134, 0.28);
+  border-radius: 18px;
+  background: linear-gradient(180deg, rgba(255, 252, 247, 0.96), rgba(246, 239, 227, 0.92));
+  box-shadow: 0 14px 28px rgba(16, 37, 29, 0.08);
+}
+
+.seatmap-context-panel.hidden {
+  display: none;
+}
+
+.seatmap-context-head {
+  display: flex;
+  align-items: flex-start;
+  justify-content: space-between;
+  gap: 10px;
+}
+
+.seatmap-context-title {
+  display: grid;
+  gap: 4px;
+}
+
+.seatmap-context-title strong {
+  color: #10251d;
+  font-size: 14px;
+  font-weight: 900;
+}
+
+.seatmap-context-title span {
+  color: #6b7280;
+  font-size: 11px;
+  font-weight: 700;
+}
+
+.seatmap-context-badge {
+  display: inline-flex;
+  align-items: center;
+  min-height: 28px;
+  padding: 0 10px;
+  border-radius: 999px;
+  background: color-mix(in srgb, var(--seatmap-team-soft, rgba(245, 158, 11, 0.14)) 88%, white);
+  color: color-mix(in srgb, var(--seatmap-team-accent, #b45309) 84%, #10251d);
+  font-size: 11px;
+  font-weight: 900;
+}
+
+.seatmap-context-tree {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 8px;
+}
+
+.seatmap-context-node {
+  display: inline-flex;
+  align-items: center;
+  min-height: 30px;
+  padding: 0 11px;
+  border-radius: 999px;
+  background: rgba(255, 255, 255, 0.84);
+  border: 1px solid rgba(194, 170, 134, 0.28);
+  color: #30423a;
+  font-size: 11px;
+  font-weight: 800;
+}
+
+.seatmap-context-empty {
+  color: #7b7b6c;
+  font-size: 12px;
+  line-height: 1.5;
+}
+
 .seatmap-dxf-stage {
  cursor: grab;
 }
--- a/incoming-files/README.md
+++ b/incoming-files/README.md
@@ -14,7 +14,8 @@

 - backend `/integrations/payment`, `/integrations/mh`는 위 `served/*`만 읽는다.
 - backend `/integrations/ledger`와 `/integrations/ledger-assets/*`도 `served/ledger/*`만 읽는다.
- 새 기능을 붙일 때도 실제 서비스 파일은 `served/` 기준으로 수정한다.
+- 다만 `payment`, `mh`, `ledger`, `db-status`는 이제 앱 소스가 따로 있으므로, 실제 수정은 `frontend/apps/*`에서 하고 publish 스크립트로 `served/`에 반영한다.
+- 즉 `served/`는 runtime 기준이고, 사람이 직접 먼저 수정하는 source-of-truth는 아니다.

 ## Reference

@@ -28,11 +29,8 @@
 - 샘플 스타일 파일
 - 원본/백업 HTML
 - 디자인 비교용 파일
+- `reference/omh.html`
+- `reference/opayment.html`
 - `reference/ledger/MH 통합 대시보드_260320.html`
 - `reference/ledger/MH 통합 대시보드_260320.css`
-
-## Temporary Comparison Copies
-
- 현재 루트의 `payment.html`, `mh.html`은 당장 삭제하지 않는다.
- 이 두 파일은 기존 recovery 작업본과 현재 `served/*`를 비교하거나 되돌릴 때만 본다.
- 다음 차수에서 안전성이 확보되면 `reference/` 하위로 재배치 여부를 검토한다.
+- `reference/ledger/사업관리대장-1.xlsx`
--- a/incoming-files/mh.html
+++ b/incoming-files/mh.html
--- a/incoming-files/payment.html
+++ b/incoming-files/payment.html
--- a/incoming-files/reference/README.md
+++ b/incoming-files/reference/README.md
@@ -8,8 +8,7 @@

 - `ledger/`
  - 사업관리대장 원본 wrapper/html/css/xlsx
-  - 이전 override 복사본
-  - 중첩 백업 디렉터리
+  - 이전 override 참고 파일

 규칙:

--- a/incoming-files/reference/ledger/README.md
+++ b/incoming-files/reference/ledger/README.md
@@ -0,0 +1,22 @@
+# reference/ledger
+
+이 디렉터리는 `사업관리대장` 원본 참고 자산만 둔다.
+
+원칙:
+
+- 직접 서빙하지 않는다.
+- 비교, 복구, 기준 확인이 필요할 때만 본다.
+- 실제 수정 원본은 `frontend/apps/ledger/*`다.
+- 실제 runtime 응답은 `incoming-files/served/ledger/*`다.
+
+현재 포함:
+
+- 원본 HTML/CSS
+- 원본 XLSX
+- 과거 override 참고 파일
+- 단일 canonical reference set만 유지
+
+주의:
+
+- `reference/ledger` 아래에 다시 `ledger/` 같은 중첩 복사본을 만들지 않는다.
+- 원본 정리가 필요하면 이 디렉터리에서만 구조를 맞춘다.
--- a/incoming-files/reference/ledger/사업관리대장/MH
+++ b/incoming-files/reference/ledger/사업관리대장/MH
--- a/incoming-files/reference/ledger/사업관리대장/MH
+++ b/incoming-files/reference/ledger/사업관리대장/MH
--- a/incoming-files/reference/ledger/사업관리대장/사업관리대장-1.xlsx
+++ b/incoming-files/reference/ledger/사업관리대장/사업관리대장-1.xlsx
--- a/incoming-files/reference/omh.html
+++ b/incoming-files/reference/omh.html
--- a/incoming-files/reference/opayment.html
+++ b/incoming-files/reference/opayment.html
--- a/incoming-files/served/db-status/index.html
+++ b/incoming-files/served/db-status/index.html
@@ -110,6 +110,14 @@
    .panel-body {
      padding: 16px 18px 20px;
    }
+    .panel-toolbar {
+      display: flex;
+      align-items: center;
+      justify-content: space-between;
+      gap: 12px;
+      margin-bottom: 14px;
+      flex-wrap: wrap;
+    }
    .panel-body.tight {
      padding-top: 0;
    }
@@ -211,6 +219,44 @@
      font-size: 11px;
      font-weight: 700;
    }
+    .toolbar-input {
+      width: min(360px, 100%);
+      padding: 11px 14px;
+      border-radius: 14px;
+      border: 1px solid rgba(132, 102, 54, 0.16);
+      background: rgba(255, 251, 244, 0.96);
+      color: #2f2419;
+      font: inherit;
+    }
+    .toolbar-input:focus {
+      outline: none;
+      border-color: rgba(129, 88, 31, 0.34);
+      box-shadow: 0 0 0 4px rgba(208, 176, 116, 0.16);
+    }
+    .toolbar-actions {
+      display: flex;
+      align-items: center;
+      gap: 10px;
+      flex-wrap: wrap;
+    }
+    .action-button {
+      border: 1px solid rgba(128, 98, 48, 0.14);
+      background: rgba(250, 240, 213, 0.62);
+      color: #6c4a1a;
+      border-radius: 999px;
+      padding: 9px 14px;
+      font: inherit;
+      font-size: 12px;
+      font-weight: 800;
+      cursor: pointer;
+    }
+    .action-button:hover {
+      background: rgba(244, 228, 186, 0.8);
+    }
+    .action-button:disabled {
+      cursor: not-allowed;
+      opacity: 0.45;
+    }
    .notes {
      margin: 0;
      padding-left: 18px;
@@ -219,6 +265,33 @@
      color: rgba(84, 65, 38, 0.84);
      line-height: 1.55;
    }
+    .mapping-list {
+      display: grid;
+      gap: 14px;
+    }
+    .mapping-card {
+      padding: 14px 16px;
+      border-radius: 18px;
+      background: rgba(255, 249, 239, 0.92);
+      border: 1px solid rgba(132, 102, 54, 0.12);
+    }
+    .mapping-card h3 {
+      margin: 0 0 8px;
+      font-size: 15px;
+      font-weight: 800;
+      letter-spacing: -0.02em;
+    }
+    .mapping-card p {
+      margin: 8px 0 0;
+      color: rgba(98, 75, 42, 0.74);
+      line-height: 1.55;
+      font-size: 13px;
+    }
+    .mapping-table-list {
+      display: flex;
+      flex-wrap: wrap;
+      gap: 6px;
+    }
    .preview-meta {
      display: grid;
      gap: 10px;
@@ -345,6 +418,9 @@
      <p>
        `원본 import 배치`는 업로드한 원본 파일이 몇 행으로 적재됐는지 보여주고, `바이너리 원본 보관`은 엑셀 같은 파일 자체를 DB에 보관하는 상태를 보여줍니다.
      </p>
+      <p>
+        아래 표는 전체 테이블을 보여주고, 오른쪽 패널은 화면별 데이터 소스와 저장 흐름을 운영 관점으로 묶어서 보여줍니다.
+      </p>
    </section>

    <section id="overview" class="overview"></section>
@@ -354,11 +430,17 @@
        <div class="panel-head">
          <div>
            <h2>전체 테이블 현황</h2>
-            <p>전체 27개 테이블을 보여주며, 테이블명을 누르면 샘플 row를 바로 확인할 수 있습니다.</p>
+            <p>현재 운영 DB의 전체 26개 테이블을 보여주며, 테이블명을 누르면 샘플 row를 바로 확인할 수 있습니다.</p>
          </div>
          <span id="generated-at" class="meta-chip">로딩 중</span>
        </div>
        <div class="panel-body">
+          <div class="panel-toolbar">
+            <input id="table-search" class="toolbar-input" type="search" placeholder="테이블명, 설명, 화면명으로 검색" />
+            <div class="toolbar-actions">
+              <span id="table-count" class="meta-chip">0 / 0</span>
+            </div>
+          </div>
          <table>
            <thead>
              <tr>
@@ -438,11 +520,24 @@
        <article class="panel">
          <div class="panel-head">
            <div>
-              <h2>테이블 분류</h2>
-              <p>유지/주의/원본·추적/정리 후보로 나눈 현재 기준입니다.</p>
+              <h2>운영 분류</h2>
+              <p>유지/주의/원본·추적/정리 후보 기준과 제품 관점 묶음을 같이 봅니다.</p>
            </div>
          </div>
-          <div id="group-summary" class="panel-body"></div>
+          <div class="panel-body">
+            <div id="group-summary"></div>
+            <div id="product-summary" style="margin-top:18px;"></div>
+          </div>
+        </article>
+
+        <article class="panel">
+          <div class="panel-head">
+            <div>
+              <h2>화면별 데이터 소스</h2>
+              <p>각 탭/기능이 실제로 어떤 테이블을 읽고 저장하는지 빠르게 확인합니다.</p>
+            </div>
+          </div>
+          <div id="screen-map" class="panel-body mapping-list"></div>
        </article>

      </div>
@@ -456,8 +551,11 @@
          <h2 id="preview-title">테이블 내용 미리보기</h2>
          <p id="preview-subtitle" class="muted">선택한 테이블의 컬럼과 최대 50개 row를 표시합니다.</p>
        </div>
+        <div class="toolbar-actions">
+          <button id="preview-download" class="action-button" type="button" disabled>CSV 다운로드</button>
          <button id="preview-close" class="modal-close" type="button" aria-label="닫기">×</button>
        </div>
+      </div>
      <div class="modal-body">
        <div id="preview-meta" class="preview-meta"></div>
        <div class="panel-body tight">
@@ -475,6 +573,9 @@
  </div>

  <script>
+    let allTables = [];
+    let currentPreview = null;
+
    function escapeHtml(value) {
      return String(value ?? "")
        .replaceAll("&", "&amp;")
@@ -529,6 +630,10 @@

    function renderTables(items) {
      const target = document.getElementById("table-body");
+      const countTarget = document.getElementById("table-count");
+      if (countTarget) {
+        countTarget.textContent = `${formatNumber(items.length)} / ${formatNumber(allTables.length)}`;
+      }
      if (!items.length) {
        target.innerHTML = '<tr><td colspan="5" class="empty">표시할 테이블이 없습니다.</td></tr>';
        return;
@@ -619,8 +724,46 @@
      `).join("");
    }

+    function renderProductSummary(summary) {
+      const target = document.getElementById("product-summary");
+      const groups = [
+        "탭 데이터",
+        "로그인·권한",
+        "히스토리",
+        "로우데이터·적재",
+        "보정·보조",
+      ];
+      target.innerHTML = groups.map((label) => `
+        <div style="display:grid; gap:8px; margin-bottom:16px;">
+          <div><span class="group-tag keep">${escapeHtml(label)}</span></div>
+          <div class="view-list">
+            ${((summary && summary[label]) || []).map((item) => `<span class="view-pill">${escapeHtml(item)}</span>`).join("") || '<span class="muted">없음</span>'}
+          </div>
+        </div>
+      `).join("");
+    }
+
+    function renderScreenMap(items) {
+      const target = document.getElementById("screen-map");
+      if (!items || !items.length) {
+        target.innerHTML = '<div class="empty">화면별 데이터 소스 정보가 없습니다.</div>';
+        return;
+      }
+      target.innerHTML = items.map((item) => `
+        <article class="mapping-card">
+          <h3>${escapeHtml(item.screen || "")}</h3>
+          <div class="mapping-table-list">
+            ${(item.tables || []).map((table) => `<span class="view-pill">${escapeHtml(table)}</span>`).join("")}
+          </div>
+          <p>${escapeHtml(item.write_flow || "")}</p>
+        </article>
+      `).join("");
+    }
+
    function renderTablePreview(payload) {
+      currentPreview = payload;
      const previewModal = document.getElementById("preview-modal");
+      const downloadButton = document.getElementById("preview-download");
      const previewMeta = document.getElementById("preview-meta");
      const previewTitle = document.getElementById("preview-title");
      const previewSubtitle = document.getElementById("preview-subtitle");
@@ -629,6 +772,9 @@

      previewTitle.textContent = `${payload.label} · ${payload.table_ref}`;
      previewSubtitle.textContent = `${formatNumber(payload.row_count)} rows / 최대 ${formatNumber(payload.limit)}개 표시`;
+      if (downloadButton) {
+        downloadButton.disabled = !(payload.rows && payload.rows.length);
+      }
      previewMeta.innerHTML = `
        <div>
          <div class="table-title">${escapeHtml(payload.label)}</div>
@@ -686,15 +832,62 @@
        throw new Error(`DB 상태를 불러오지 못했습니다. (${response.status})`);
      }
      const payload = await response.json();
+      allTables = payload.tables || [];
      document.getElementById("generated-at").textContent = payload.generated_at
        ? `갱신 ${formatDateTime(payload.generated_at)}`
        : "갱신 시각 없음";
      renderOverview(payload.overview || {});
-      renderTables(payload.tables || []);
+      renderTables(allTables);
      renderBatches(payload.import_batches || []);
      renderBinarySources(payload.binary_sources || []);
      renderNotes(payload.notes || []);
      renderGroupSummary(payload.group_summary || {});
+      renderProductSummary(payload.product_summary || {});
+      renderScreenMap(payload.screen_map || []);
+    }
+
+    function toCsvValue(value) {
+      const text = String(value ?? "");
+      if (!/[",\n]/.test(text)) return text;
+      return `"${text.replaceAll('"', '""')}"`;
+    }
+
+    function downloadPreviewCsv() {
+      if (!currentPreview || !currentPreview.columns || !currentPreview.rows || !currentPreview.rows.length) return;
+      const headers = currentPreview.columns.map((column) => column.name);
+      const lines = [
+        headers.map(toCsvValue).join(","),
+        ...currentPreview.rows.map((row) => headers.map((header) => toCsvValue(row[header] ?? "")).join(",")),
+      ];
+      const blob = new Blob(["\ufeff" + lines.join("\n")], { type: "text/csv;charset=utf-8;" });
+      const url = URL.createObjectURL(blob);
+      const link = document.createElement("a");
+      link.href = url;
+      link.download = `${currentPreview.table_name || "table-preview"}.csv`;
+      document.body.appendChild(link);
+      link.click();
+      link.remove();
+      URL.revokeObjectURL(url);
+    }
+
+    function applyTableSearch(query) {
+      const normalized = String(query || "").trim().toLowerCase();
+      if (!normalized) {
+        renderTables(allTables);
+        return;
+      }
+      const filtered = allTables.filter((item) => {
+        const haystack = [
+          item.label,
+          item.table_ref,
+          item.description,
+          ...(item.related_views || []),
+          item.domain,
+          item.group,
+        ].join(" ").toLowerCase();
+        return haystack.includes(normalized);
+      });
+      renderTables(filtered);
    }

    document.getElementById("preview-close").addEventListener("click", () => {
@@ -703,6 +896,11 @@
      modal.setAttribute("aria-hidden", "true");
    });

+    document.getElementById("preview-download").addEventListener("click", downloadPreviewCsv);
+    document.getElementById("table-search").addEventListener("input", (event) => {
+      applyTableSearch(event.target.value);
+    });
+
    document.getElementById("preview-modal").addEventListener("click", (event) => {
      if (event.target.id !== "preview-modal") return;
      const modal = document.getElementById("preview-modal");
--- a/incoming-files/served/ledger/README.md
+++ b/incoming-files/served/ledger/README.md
@@ -4,8 +4,8 @@

 source-of-truth:

- [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](../../../frontend/apps/ledger)
+- 반영 스크립트: [scripts/publish_ledger_app.sh](../../../scripts/publish_ledger_app.sh)

 - `index.html`: `/integrations/ledger` 응답 본문
  - `frontend/apps/ledger/index.html` 템플릿에서 publish 시 생성
--- a/incoming-files/served/ledger/ledger-override.js
+++ b/incoming-files/served/ledger/ledger-override.js
@@ -10,6 +10,10 @@
    return new Date(now.getFullYear(), now.getMonth(), now.getDate());
  }

+  function bgNormalizeText(value) {
+    return String(value || "").replace(/\s+/g, " ").trim();
+  }
+
  function bgParseDate(value) {
    var text = String(value || "").trim();
    if (!text) return null;
@@ -36,6 +40,44 @@
    return bgYearFromText(row && row.eDate);
  }

+  function normalizedCategory(row) {
+    var category = bgNormalizeText(row && row.cat);
+    if (category.indexOf("가족사") >= 0) return "가족사";
+    var corp = bgNormalizeText(row && row.corp);
+    if (corp && corp !== "바론") return "가족사";
+    return "바론";
+  }
+
+  function isSupportServiceRow(row) {
+    return bgNormalizeText(row && row.name).indexOf("경영 및 기술지원 서비스") >= 0;
+  }
+
+  function projectTypeLabel(row) {
+    if (isSupportServiceRow(row)) return "기술지원서비스";
+    return normalizedCategory(row);
+  }
+
+  function projectTypeRank(row) {
+    var label = projectTypeLabel(row);
+    if (label === "바론") return 0;
+    if (label === "가족사") return 1;
+    return 2;
+  }
+
+  function normalizeStatusLabel(status) {
+    var value = bgNormalizeText(status);
+    if (!value) return "-";
+    if (value === "완료") return "준공";
+    if (value === "진행") return "과업진행중";
+    if (value === "대기") return "계약대기";
+    if (value === "중지") return "과업중지";
+    return value;
+  }
+
+  function rowStatusLabel(row) {
+    return normalizeStatusLabel(row && row.status);
+  }
+
  function bgDisplayYear(row) {
    var start = bgStartYear(row);
    if (start) return start;
@@ -82,7 +124,7 @@
    if (!(cutoff && yearStart && startDate)) return false;
    if (startDate > cutoff) return false;
    if (endDate && endDate < yearStart) return false;
-    return !(endDate && endDate <= cutoff);
+    return rowStatusLabel(row) === "과업진행중";
  }

  function bgStartedInYear(row, year) {
@@ -96,7 +138,7 @@
    var cutoff = bgYearCutoff(year);
    var endDate = bgDateOrYearEnd(row);
    if (!(cutoff && endDate)) return false;
-    return endDate.getFullYear() === Number(year || 0) && endDate <= cutoff;
+    return rowStatusLabel(row) === "준공" && endDate.getFullYear() === Number(year || 0) && endDate <= cutoff;
  }

  function bgYearRange(row) {
@@ -140,16 +182,32 @@
    }, { c: 0, col: 0, recv: 0 });
  }

-  function isSupportServiceRow(row) {
-    var category = String((row && row.cat) || "").trim();
-    return category.indexOf("경영지원") >= 0 || category.indexOf("서비스") >= 0;
+  function isBaronProjectRow(row) {
+    return projectTypeLabel(row) === "바론";
  }

-  function isBaronProjectRow(row) {
-    var category = String((row && row.cat) || "").trim();
-    if (category.indexOf("바론") < 0) return false;
-    if (isSupportServiceRow(row)) return false;
-    return true;
+  function isSoftwareProjectRow(row) {
+    var name = bgNormalizeText(row && row.name).toLowerCase();
+    if (!name) return false;
+    return [
+      "프로그램",
+      "소프트웨어",
+      "software",
+      " sw",
+      "sw ",
+      "erp",
+      "tova",
+      "ipipe",
+      "eg-bim",
+      "cad"
+    ].some(function (keyword) {
+      return name.indexOf(keyword) >= 0;
+    });
+  }
+
+  function shouldSinkProjectName(row) {
+    var name = bgNormalizeText(row && row.name);
+    return name.indexOf("프로그램") >= 0 || name.indexOf("사용") >= 0;
  }

  function bgSummarize(rows, selectedYear) {
@@ -158,14 +216,18 @@
    var activeRows = items.filter(function (row) { return bgActiveInYear(row, targetYear); });
    var newProjectRows = items.filter(function (row) { return bgStartedInYear(row, targetYear); });
    var completedRows = items.filter(function (row) { return bgCompletedInYear(row, targetYear); });
-    var managementRows = newProjectRows.filter(isSupportServiceRow);
+    var managementRows = activeRows.filter(isSupportServiceRow);
+    var baronActiveRows = activeRows.filter(isBaronProjectRow);
    return {
      targetYear: targetYear,
      activeRows: activeRows,
      newProjectRows: newProjectRows,
      completedRows: completedRows,
      managementRows: managementRows,
-      managementTotals: bgTotals(managementRows)
+      managementTotals: bgTotals(managementRows),
+      baronActiveRows: baronActiveRows,
+      baronProjectTotals: bgTotals(baronActiveRows),
+      baronSoftwareCount: baronActiveRows.filter(isSoftwareProjectRow).length
    };
  }

@@ -177,13 +239,6 @@
    return bgActiveInYear(row, selectedYear);
  }

-  function normalizeStatusLabel(status) {
-    var value = String(status || "").trim();
-    if (!value) return "-";
-    if (value.indexOf("진행") >= 0) return "과업 진행중";
-    return value;
-  }
-
  function formatSplitPercent(split) {
    var numeric = parseFloat(String(split || "").replace(/[^0-9.\-]/g, ""));
    if (!Number.isFinite(numeric) || numeric === 0) return "분담율 -%";
@@ -204,17 +259,57 @@
  }

  function groupSortRank(row) {
-    var selectedYear = Number((S.dashboard && S.dashboard.year) || projectYear(row) || 0);
    var startYear = Number(projectYear(row) || 0);
-    if (typeof bgCompletedInYear === "function" && bgCompletedInYear(row, String(selectedYear))) return 9999;
    if (!startYear) return 9998;
    return startYear;
  }

  function tableGroupLabel(row) {
    var startYear = projectYear(row);
-    if (/^20\d{2}$/.test(startYear)) return startYear + "년";
-    return "미지정";
+    if (/^20\d{2}$/.test(startYear)) return startYear + " " + projectTypeLabel(row);
+    return "미지정 " + projectTypeLabel(row);
+  }
+
+  function compareDashboardRows(a, b) {
+    var typeRankDiff = projectTypeRank(a) - projectTypeRank(b);
+    if (typeRankDiff !== 0) return typeRankDiff;
+    var groupDiff = groupSortRank(a) - groupSortRank(b);
+    if (groupDiff !== 0) return groupDiff;
+    var sinkDiff = Number(shouldSinkProjectName(a)) - Number(shouldSinkProjectName(b));
+    if (sinkDiff !== 0) return sinkDiff;
+    return bgNormalizeText(a && a.name).localeCompare(bgNormalizeText(b && b.name), "ko");
+  }
+
+  function filterCategoryLabel(row) {
+    return projectTypeLabel(row);
+  }
+
+  function filterClientLabel(row) {
+    if (typeof normalizeClientDisplay === "function") {
+      return normalizeClientDisplay(row && row.client);
+    }
+    return bgNormalizeText(row && row.client) || "-";
+  }
+
+  function filterOrderLabel(row) {
+    return bgNormalizeText(row && row.order) || "-";
+  }
+
+  function receivableFilterLabel(row) {
+    var amount = Number((row && row.recv) || 0);
+    if (amount <= 0) return "미수 없음";
+    if (amount < 10000000) return "1천만 미만";
+    if (amount < 100000000) return "1천만 이상";
+    return "1억 이상";
+  }
+
+  function refreshFilterDom() {
+    E.filterButtons = Object.fromEntries(Array.from(document.querySelectorAll(".th-trigger")).map(function (el) {
+      return [el.dataset.filter, el];
+    }));
+    E.filterMenus = Object.fromEntries(Array.from(document.querySelectorAll(".th-menu")).map(function (el) {
+      return [el.dataset.filter, el];
+    }));
  }

  function renderLedgerTable() {
@@ -236,12 +331,7 @@
        + '<th class="num"><div class="th-head end"><button type="button" class="th-trigger" data-filter="rate" data-label="수금률"><span class="th-title">수금률</span><span class="th-mark"></span><span class="th-caret">▼</span></button><div id="filterRateMenu" class="th-menu" data-filter="rate"></div></div></th>'
        + "</tr>";
    }
-    var rows = (Array.isArray(S.viewRows) ? S.viewRows : []).slice().sort(function (a, b) {
-      var ar = groupSortRank(a);
-      var br = groupSortRank(b);
-      if (ar !== br) return ar - br;
-      return Number(b.recv || 0) - Number(a.recv || 0);
-    });
+    var rows = (Array.isArray(S.viewRows) ? S.viewRows : []).slice().sort(compareDashboardRows);
    S.viewRows = rows;
    var lastGroupLabel = "";
    E.tbody.innerHTML = rows.map(function (r) {
@@ -259,7 +349,7 @@
        + '<td><button type="button" class="project-link" data-project-key="' + escAttr(String(r.code || "") + "|" + String(r.name || "")) + '">' + esc(r.name || "-") + '</button><div class="subline">' + esc(r.periodText || "-") + '</div></td>'
        + '<td><div class="client-main">' + esc((r.client || "").trim() || "-") + '</div><div class="subline">' + esc(formatSplitPercent(r.split)) + '</div></td>'
        + '<td><div>' + esc(r.order || "-") + '</div></td>'
-        + '<td><div class="badge ' + (String(r.status || "").indexOf("완료") >= 0 ? 'ok' : '') + '">' + esc(normalizeStatusLabel(r.status)) + '</div></td>'
+        + '<td><div class="badge ' + (rowStatusLabel(r) === "준공" ? 'ok' : '') + '">' + esc(rowStatusLabel(r)) + '</div></td>'
        + '<td class="num"><strong>' + esc(won(r.cSup || 0)) + '</strong></td>'
        + '<td class="num"><strong>' + esc(r.outsourceCost ? won(r.outsourceCost) : "-") + '</strong></td>'
        + '<td class="num"><strong>' + esc(won(r.recv || 0)) + '</strong></td>'
@@ -267,6 +357,8 @@
        + '<td class="num"><strong style="color:' + (isSettledRow(r) ? '#b7aa93' : '#1a5645') + '">' + esc((Number(r.rate || 0)).toFixed(2) + "%") + '</strong></td>'
        + '</tr>';
    }).join("");
+    refreshFilterDom();
+    if (typeof syncColumnFilters === "function") syncColumnFilters(S.all);
  }

  function renderCollectionBoard(r) {
@@ -379,10 +471,8 @@
    }
    var years = bgEnsureYear(S.all);
    var summary = bgSummarize(S.all, S.dashboard.year);
-    var rows = Array.isArray(S.rows) ? S.rows : [];
-    var visibleBaronProjectRows = rows.filter(isBaronProjectRow);
-    var totals = bgTotals(visibleBaronProjectRows);
-    var totalRate = typeof rate === "function" ? rate("", totals.col, totals.col + totals.recv) : 0;
+    var totals = summary.baronProjectTotals;
+    var totalRate = totals.c > 0 ? (totals.col / totals.c) * 100 : 0;
    var toolbarHtml = '<div class="cards-toolbar">'
      + '<div class="cards-toolbar-row">'
      + years.map(function (year) {
@@ -393,14 +483,14 @@
      + '<div class="cards-toolbar-metrics">'
      + '<button type="button" class="summary-filter-chip ' + (S.dashboard.section === "active" ? "active" : "") + '" data-dashboard-section="active"><span class="label">' + esc(summary.targetYear) + '년 진행과업</span><span class="count">' + summary.activeRows.length.toLocaleString("ko-KR") + '건</span><span class="meta">전년도 이월 사업 포함</span></button>'
      + '<button type="button" class="summary-filter-chip ' + (S.dashboard.section === "new" ? "active" : "") + '" data-dashboard-section="new"><span class="label">' + esc(summary.targetYear) + '년 신규프로젝트</span><span class="count">' + summary.newProjectRows.length.toLocaleString("ko-KR") + '건</span><span class="meta">계약기간 시작년도 기준</span></button>'
-      + '<button type="button" class="summary-filter-chip ' + (S.dashboard.section === "completed" ? "active" : "") + '" data-dashboard-section="completed"><span class="label">' + esc(summary.targetYear) + '년 완료과업</span><span class="count">' + summary.completedRows.length.toLocaleString("ko-KR") + '건</span><span class="meta">해당년도 종료 사업 기준</span></button>'
+      + '<button type="button" class="summary-filter-chip ' + (S.dashboard.section === "completed" ? "active" : "") + '" data-dashboard-section="completed"><span class="label">' + esc(summary.targetYear) + '년 완료과업</span><span class="count">' + summary.completedRows.length.toLocaleString("ko-KR") + '건</span><span class="meta">진행상태 준공 기준</span></button>'
      + "</div></div>";
    var cards = [
-      { label: summary.targetYear + "년 프로젝트", value: visibleBaronProjectRows.length.toLocaleString("ko-KR") + " 건", note: "" },
-      { label: "계약금", value: won(totals.c), note: "" },
+      { label: summary.targetYear + "년 프로젝트", value: summary.baronActiveRows.length.toLocaleString("ko-KR") + "건 (" + summary.baronSoftwareCount.toLocaleString("ko-KR") + "건)", note: "바론 수행중 프로젝트 / SW" },
+      { label: "계약금 (VAT별도)", value: won(totals.c), note: "" },
      { label: "수금액", value: won(totals.col), note: "" },
      { label: "미수금", value: won(totals.recv), note: "" },
-      { label: "수금률(%)", value: totalRate.toFixed(2) + "%", note: "" },
+      { label: "수금율", value: totalRate.toFixed(2) + "%", note: "계약금 대비 수금액" },
      { label: "경영지원서비스 금액", value: won(summary.managementTotals.c), note: "", className: "management" }
    ];
    E.cards.innerHTML = toolbarHtml + cards.map(function (card) {
@@ -429,9 +519,62 @@
    S.rows = searched.filter(function (r) {
      return bgMatches(r) && matchesColumnFilters(r);
    });
+    S.rows.sort(compareDashboardRows);
    render();
  };

+  filterDefinitions = function () {
+    return [
+      { key: "cat", map: filterCategoryLabel },
+      { key: "code", map: function (r) { return r.code || "-"; } },
+      { key: "name", map: function (r) { return r.name || "-"; } },
+      { key: "client", map: filterClientLabel },
+      { key: "order", map: filterOrderLabel },
+      { key: "status", map: rowStatusLabel },
+      { key: "amount", map: amountFilterLabel },
+      { key: "outsource", map: outsourceFilterLabel },
+      { key: "receivable", map: receivableFilterLabel },
+      { key: "collected", map: collectedFilterLabel },
+      { key: "rate", map: rateFilterLabel }
+    ];
+  };
+
+  updateFilterButtons = function () {
+    Object.keys(E.filterButtons || {}).forEach(function (key) {
+      var btn = E.filterButtons[key];
+      if (!btn) return;
+      var active = !!S.filters[key];
+      btn.classList.toggle("active", active);
+      btn.title = active ? ((btn.dataset.label || "") + ": " + S.filters[key]) : (btn.dataset.label || "");
+      var mark = btn.querySelector(".th-mark");
+      if (mark) mark.textContent = active ? "•" : "";
+    });
+  };
+
+  syncColumnFilters = function (rows) {
+    filterDefinitions().forEach(function (def) {
+      var values = uniqueFilterValues(rows, def.map);
+      if (S.filters[def.key] && !values.includes(S.filters[def.key])) delete S.filters[def.key];
+      renderFilterMenu(def.key, values);
+    });
+    updateFilterButtons();
+  };
+
+  matchesColumnFilters = function (r) {
+    if (S.filters.cat && filterCategoryLabel(r) !== S.filters.cat) return false;
+    if (S.filters.code && (r.code || "-") !== S.filters.code) return false;
+    if (S.filters.name && (r.name || "-") !== S.filters.name) return false;
+    if (S.filters.client && filterClientLabel(r) !== S.filters.client) return false;
+    if (S.filters.order && filterOrderLabel(r) !== S.filters.order) return false;
+    if (S.filters.status && rowStatusLabel(r) !== S.filters.status) return false;
+    if (S.filters.amount && amountFilterLabel(r) !== S.filters.amount) return false;
+    if (S.filters.outsource && outsourceFilterLabel(r) !== S.filters.outsource) return false;
+    if (S.filters.receivable && receivableFilterLabel(r) !== S.filters.receivable) return false;
+    if (S.filters.collected && collectedFilterLabel(r) !== S.filters.collected) return false;
+    if (S.filters.rate && rateFilterLabel(r) !== S.filters.rate) return false;
+    return true;
+  };
+
  if (E.cards && !E.cards.dataset.dashboardBound) {
    E.cards.dataset.dashboardBound = "true";
    E.cards.addEventListener("click", function (event) {
@@ -472,6 +615,26 @@
    });
  }

+  var panel = document.querySelector(".panel");
+  if (panel && !panel.dataset.ledgerFilterBound) {
+    panel.dataset.ledgerFilterBound = "true";
+    panel.addEventListener("click", function (event) {
+      var trigger = event.target && event.target.closest ? event.target.closest(".th-trigger") : null;
+      if (trigger) {
+        refreshFilterDom();
+        event.stopPropagation();
+        toggleFilterMenu(trigger.dataset.filter);
+        return;
+      }
+      var option = event.target && event.target.closest ? event.target.closest("button[data-filter-value]") : null;
+      var menu = event.target && event.target.closest ? event.target.closest(".th-menu") : null;
+      if (option && menu) {
+        event.stopPropagation();
+        setFilterValue(menu.dataset.filter, option.getAttribute("data-filter-value") || "");
+      }
+    });
+  }
+
  setTimeout(function () {
    try {
      filter();
--- a/legacy/static/organization.css
+++ b/legacy/static/organization.css
@@ -338,11 +338,16 @@ body {

 .modal-content.wide #modal-fields {
  min-height: 0;
+  overflow-y: auto;
+  padding-right: 4px;
 }

 .modal-content.wide #modal-footer-area {
  margin-top: 0 !important;
  flex-shrink: 0;
+  position: relative;
+  z-index: 2;
+  background: var(--color-surface);
 }

 .member-photo-field {
@@ -761,6 +766,7 @@ body {
  height: 300px;
  border: 0;
  background: var(--color-surface);
+  pointer-events: none;
 }

 .seat-preview-card.is-assigned .seat-preview-frame {
@@ -1033,7 +1039,8 @@ body {
 .modal-footer-actions {
  display: flex;
  gap: 10px;
-  width: 100%;
+  width: auto;
+  flex: 1 1 auto;
  justify-content: flex-end;
  align-items: center;
 }
@@ -1045,10 +1052,12 @@ body {
  padding: 14px 18px;
  transition: all 0.2s ease;
  border: 1px solid transparent;
+  white-space: nowrap;
+  writing-mode: horizontal-tb;
 }

 .modal-btn-cancel {
-  flex: 1 1 0;
+  flex: 0 1 140px;
  background: var(--color-surface-strong);
  color: var(--color-text-soft);
  border-color: var(--color-border);
@@ -1059,7 +1068,7 @@ body {
 }

 .modal-btn-save {
-  flex: 1 1 0;
+  flex: 0 1 140px;
  background: var(--color-header);
  color: #fff;
  box-shadow: 0 10px 22px rgba(47, 153, 115, 0.2);
@@ -1070,6 +1079,8 @@ body {
 }

 .modal-btn-delete {
+  flex: 0 0 132px;
+  min-width: 132px;
  background: rgba(198, 71, 56, 0.12);
  color: #a33427;
  border-color: rgba(198, 71, 56, 0.2);
--- a/legacy/static/organization.js
+++ b/legacy/static/organization.js
@@ -4,6 +4,7 @@ let selectedDept = '전체';
 let editingMembers = [];
 let collapsedUnits = new Set();
 let isListMode = false;
+let isListDetailModal = false;
 let emptyStateMessage = '서버에 조직 데이터가 없습니다. 상단의 업로드 버튼으로 초기 데이터를 넣어주세요.';
 let photoPreviewObjectUrl = null;
 let seatMapLayoutCache = null;
@@ -485,6 +486,24 @@ function createNodeDOM(node, parentId) {
  return nodeItem;
 }

+function applyMemberPlacementFromTarget(member, targetLevel, targetName, targetMember = null) {
+  const targetLevelIndex = levelOrder.indexOf(targetLevel);
+  if (targetLevelIndex === -1) {
+    return member;
+  }
+  for (let index = 0; index <= targetLevelIndex; index += 1) {
+    member[levelOrder[index]] = targetMember ? (targetMember[levelOrder[index]] || '') : (index === targetLevelIndex ? targetName : member[levelOrder[index]]);
+  }
+  if (!targetMember) {
+    member[targetLevel] = targetName;
+  }
+  for (let index = targetLevelIndex + 1; index < levelOrder.length; index += 1) {
+    member[levelOrder[index]] = '';
+  }
+  rebuildMemberPath(member);
+  return member;
+}
+
 function drawLines() {
  const container = document.getElementById('tree-root');
  const svg = document.getElementById('svg-canvas');
@@ -628,6 +647,11 @@ function render() {
    deptBox.id = deptId;
    deptBox.className = 'dept-box';
    deptBox.setAttribute('data-level', '부서');
+    if (isAdmin) {
+      deptBox.ondragover = (event) => handleDragOver(event);
+      deptBox.ondragleave = (event) => handleDragLeave(event);
+      deptBox.ondrop = (event) => handleDrop(event, '부서', deptName);
+    }
    deptBox.innerHTML = `<div class="dept-header ${isAdmin ? 'clickable-title' : ''} ${hasMembers ? 'has-members' : ''}" ${isAdmin ? `onclick="openOrgEditModal('부서', '${jsString(deptName)}')"` : ''}>${deptName} (${totalCount})</div>`;

    if (hasMembers) {
@@ -827,6 +851,53 @@ function openAddModal(event) {
  openModal(null);
 }

+function renderListViewShell(defaultDate) {
+  const modal = document.getElementById('modal');
+  modal.querySelector('.modal-content').classList.add('wide');
+  document.getElementById('modal-title').innerText = '인원 명단';
+  const fieldsArea = document.getElementById('modal-fields');
+  fieldsArea.className = 'flex flex-col w-full overflow-hidden';
+  fieldsArea.style.maxHeight = '75vh';
+  fieldsArea.style.overflowY = 'hidden';
+  fieldsArea.innerHTML = `
+    <div class="list-toolbar">
+      <div class="list-toolbar-row">
+        <div class="list-toolbar-group">
+          <button type="button" onclick="showCurrentListView()" class="list-mode-btn">현재 명단</button>
+        </div>
+        <div class="list-toolbar-divider" aria-hidden="true"></div>
+        <div class="list-toolbar-group list-date-group">
+          <input type="date" id="list-snapshot-date" value="${escapeHtml(defaultDate)}" class="list-date-input">
+          <button type="button" onclick="loadSnapshotListView()" class="list-mode-btn">기준일 조회</button>
+        </div>
+        <div class="list-toolbar-divider" aria-hidden="true"></div>
+        <div class="list-toolbar-group list-date-group">
+          <input type="date" id="list-compare-from" value="${escapeHtml(defaultDate)}" class="list-date-input">
+          <span class="list-date-separator">~</span>
+          <input type="date" id="list-compare-to" value="${escapeHtml(defaultDate)}" class="list-date-input">
+          <button type="button" onclick="loadCompareListView()" class="list-mode-btn">변경 비교</button>
+        </div>
+      </div>
+      <div class="list-toolbar-row">
+        <input type="text" id="list-search-input" placeholder="이름 또는 부서/팀 검색 (Enter 시 이동)" class="flex-1 bg-[#f6eddd] border-2 border-[#e0d0b4] p-3 rounded-xl text-sm outline-none font-bold text-[#1f2f25] focus:border-[#d68a3a] transition-all" onkeydown="if(event.key==='Enter') handleListSearch(this.value)">
+        <button type="button" onclick="handleListSearch(document.getElementById('list-search-input').value)" class="bg-[#214634] text-white px-5 rounded-xl font-bold text-sm">검색</button>
+      </div>
+      <div id="list-view-status" class="list-view-status"></div>
+    </div>
+    <div id="list-table-container" class="overflow-y-auto flex-1 border rounded-xl"></div>
+  `;
+  modal.style.display = 'flex';
+}
+
+function returnToListViewModal() {
+  if (!isListMode) {
+    return;
+  }
+  isListDetailModal = false;
+  renderListViewShell(listViewState.snapshotDate || getDefaultHistoryDate());
+  renderListViewModalContent();
+}
+
 function updateParentList() {
  const type = document.getElementById('new-unit-type').value;
  const parentSelect = document.getElementById('new-unit-parent');
@@ -1159,7 +1230,8 @@ function openModal(id) {
  modal.querySelector('.modal-content').classList.add('wide');
  fieldsArea.className = 'flex flex-col w-full';
  fieldsArea.style.maxHeight = 'none';
-  fieldsArea.style.overflowY = 'visible';
+  fieldsArea.style.overflowY = 'auto';
+  isListDetailModal = isListMode;

  const sourceValues = isListMode ? editingMembers : members;
  let orgFields = '<div id="modal-sec-org" class="hidden grid grid-cols-2 gap-3 modal-form-grid">';
@@ -1279,11 +1351,17 @@ function openModal(id) {
 }

 function closeModal() {
+  if (isListMode && isListDetailModal) {
+    returnToListViewModal();
+    return;
+  }
  resetPhotoPreviewObjectUrl();
  document.getElementById('modal').style.display = 'none';
  document.getElementById('modal-fields').className = 'grid grid-cols-2 gap-x-8 gap-y-5';
  document.getElementById('modal-fields').style.maxHeight = 'none';
+  document.getElementById('modal-fields').style.overflowY = 'visible';
  document.querySelector('.modal-content').classList.remove('wide');
+  isListDetailModal = false;
  isListMode = false;
 }

@@ -1337,8 +1415,7 @@ async function saveMember() {
    if (!id) {
      targetList.push(member);
    }
-    renderListViewTable();
-    closeModal();
+    returnToListViewModal();
    return;
  }

@@ -1367,11 +1444,16 @@ async function deleteMember(id) {
  }

  if (isListMode) {
+    const shouldReturnToList = isListDetailModal;
    const idx = editingMembers.findIndex((member) => member._id === id);
    if (idx !== -1) {
      editingMembers.splice(idx, 1);
    }
+    if (shouldReturnToList) {
+      returnToListViewModal();
+    } else {
      renderListViewTable();
+    }
    return;
  }

@@ -1396,44 +1478,11 @@ function openListViewModal(event) {
  listViewState.compareToDate = defaultDate;
  listViewState.snapshotMembers = [];
  listViewState.compareItems = [];
-
-  const modal = document.getElementById('modal');
-  modal.querySelector('.modal-content').classList.add('wide');
-  document.getElementById('modal-title').innerText = '인원 명단';
-  const fieldsArea = document.getElementById('modal-fields');
-  fieldsArea.className = 'flex flex-col w-full overflow-hidden';
-  fieldsArea.style.maxHeight = '75vh';
  isListMode = true;
+  isListDetailModal = false;
  editingMembers = cloneMembers(members);
-  fieldsArea.innerHTML = `
-    <div class="list-toolbar">
-      <div class="list-toolbar-row">
-        <div class="list-toolbar-group">
-          <button type="button" onclick="showCurrentListView()" class="list-mode-btn">현재 명단</button>
-        </div>
-        <div class="list-toolbar-divider" aria-hidden="true"></div>
-        <div class="list-toolbar-group list-date-group">
-          <input type="date" id="list-snapshot-date" value="${escapeHtml(defaultDate)}" class="list-date-input">
-          <button type="button" onclick="loadSnapshotListView()" class="list-mode-btn">기준일 조회</button>
-        </div>
-        <div class="list-toolbar-divider" aria-hidden="true"></div>
-        <div class="list-toolbar-group list-date-group">
-          <input type="date" id="list-compare-from" value="${escapeHtml(defaultDate)}" class="list-date-input">
-          <span class="list-date-separator">~</span>
-          <input type="date" id="list-compare-to" value="${escapeHtml(defaultDate)}" class="list-date-input">
-          <button type="button" onclick="loadCompareListView()" class="list-mode-btn">변경 비교</button>
-        </div>
-      </div>
-      <div class="list-toolbar-row">
-        <input type="text" id="list-search-input" placeholder="이름 또는 부서/팀 검색 (Enter 시 이동)" class="flex-1 bg-[#f6eddd] border-2 border-[#e0d0b4] p-3 rounded-xl text-sm outline-none font-bold text-[#1f2f25] focus:border-[#d68a3a] transition-all" onkeydown="if(event.key==='Enter') handleListSearch(this.value)">
-        <button type="button" onclick="handleListSearch(document.getElementById('list-search-input').value)" class="bg-[#214634] text-white px-5 rounded-xl font-bold text-sm">검색</button>
-      </div>
-      <div id="list-view-status" class="list-view-status"></div>
-    </div>
-    <div id="list-table-container" class="overflow-y-auto flex-1 border rounded-xl"></div>
-  `;
+  renderListViewShell(defaultDate);
  renderListViewModalContent();
-  modal.style.display = 'flex';
 }

 async function applyListViewChanges() {
@@ -1697,12 +1746,29 @@ function toggleUnitCollapse(level, name) {

 let draggedGroup = null;
 function handleListGroupDragStart(event, level, name) {
+  draggedIdx = null;
  draggedGroup = { level, name };
  event.dataTransfer.effectAllowed = 'move';
 }

 function handleListGroupDrop(event, targetLevel, targetName) {
  event.preventDefault();
+  if (draggedIdx !== null) {
+    const movingMember = editingMembers[draggedIdx];
+    if (!movingMember) {
+      return;
+    }
+    const moved = editingMembers.splice(draggedIdx, 1)[0];
+    applyMemberPlacementFromTarget(moved, targetLevel, targetName, null);
+    let targetIdx = editingMembers.findIndex((member) => member[targetLevel] === targetName);
+    if (targetIdx === -1) {
+      targetIdx = editingMembers.length;
+    }
+    editingMembers.splice(targetIdx, 0, moved);
+    draggedIdx = null;
+    renderListViewTable();
+    return;
+  }
  if (!draggedGroup || (draggedGroup.level === targetLevel && draggedGroup.name === targetName)) {
    return;
  }
@@ -1743,6 +1809,7 @@ function handleListSearch(value) {

 let draggedIdx = null;
 function handleListDragStart(event, index) {
+  draggedGroup = null;
  draggedIdx = index;
  event.dataTransfer.effectAllowed = 'move';
  event.target.classList.add('dragging');
@@ -1753,7 +1820,11 @@ function handleListDrop(event, targetIdx) {
  if (draggedIdx === null || draggedIdx === targetIdx) {
    return;
  }
+  const targetMember = editingMembers[targetIdx] || null;
  const moved = editingMembers.splice(draggedIdx, 1)[0];
+  if (targetMember) {
+    applyMemberPlacementFromTarget(moved, levelOrder[levelOrder.length - 1], targetMember[levelOrder[levelOrder.length - 1]] || '', targetMember);
+  }
  editingMembers.splice(targetIdx, 0, moved);
  draggedIdx = null;
  renderListViewTable();
@@ -1804,13 +1875,10 @@ async function handleDrop(event, targetLevel, targetName) {
    }
    const nextMembers = cloneMembers(members);
    const moved = nextMembers[memberIndex];
-    for (let index = 0; index <= targetLevelIndex; index += 1) {
-      moved[levelOrder[index]] = targetMember ? targetMember[levelOrder[index]] : targetName;
+    if (targetLevelIndex === -1) {
+      return;
    }
-    for (let index = targetLevelIndex + 1; index < levelOrder.length; index += 1) {
-      moved[levelOrder[index]] = '';
-    }
-    rebuildMemberPath(moved);
+    applyMemberPlacementFromTarget(moved, targetLevel, targetName, targetMember);
    nextMembers.splice(memberIndex, 1);
    nextMembers.push(moved);
    await syncMembers(nextMembers);
@@ -1859,10 +1927,7 @@ async function handleDropMember(event, targetId) {
    }
    const moved = nextMembers[movingIdx];
    const target = nextMembers[targetIdx];
-    levelOrder.forEach((level) => {
-      moved[level] = target[level];
-    });
-    rebuildMemberPath(moved);
+    applyMemberPlacementFromTarget(moved, levelOrder[levelOrder.length - 1], target[levelOrder[levelOrder.length - 1]] || '', target);
    nextMembers.splice(movingIdx, 1);
    targetIdx = nextMembers.findIndex((member) => member._id === targetId);
    nextMembers.splice(insertAfter ? targetIdx + 1 : targetIdx, 0, moved);
--- a/scripts/check_8081_smoke.sh
+++ b/scripts/check_8081_smoke.sh
@@ -0,0 +1,69 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+cd "$ROOT_DIR"
+
+echo "[smoke] checking dev containers"
+docker ps --format '{{.Names}}' | grep -qx 'mh-dashboard-organization-dev-backend-1'
+docker ps --format '{{.Names}}' | grep -qx 'mh-dashboard-organization-dev-proxy-1'
+
+echo "[smoke] running 8081 endpoint checks"
+docker exec mh-dashboard-organization-dev-backend-1 python - <<'PY'
+import sys
+import urllib.request
+import json
+
+
+checks = [
+    ("health", "http://127.0.0.1:8000/api/health", b'"status"'),
+    ("db-status-api", "http://127.0.0.1:8000/api/admin/db-status", b'"tables"'),
+    ("ledger-default-api", "http://127.0.0.1:8000/api/integration/business-ledger-default", b'PK'),
+    ("legacy-organization", "http://127.0.0.1:8000/legacy/organization", b'organization'),
+    ("payment", "http://127.0.0.1:8000/integrations/payment", b'const App = () =>'),
+    ("ledger", "http://127.0.0.1:8000/integrations/ledger", b'xlsx.full.min.js'),
+    ("mh", "http://127.0.0.1:8000/integrations/mh", b'const App = () =>'),
+    ("proxy-root", "http://proxy/", b'app.js'),
+    ("proxy-db-status", "http://proxy/db-status.html", b'전체 테이블 현황'),
+]
+
+failed = []
+
+for name, url, needle in checks:
+    try:
+        with urllib.request.urlopen(url, timeout=8) as response:
+            body = response.read()
+            status = getattr(response, "status", response.getcode())
+            if status != 200:
+                failed.append(f"{name}: unexpected status {status}")
+                continue
+            if needle not in body:
+                failed.append(f"{name}: missing expected marker {needle!r}")
+                continue
+            print(f"[ok] {name} -> {status}")
+    except Exception as exc:
+        failed.append(f"{name}: {exc}")
+
+try:
+    with urllib.request.urlopen("http://127.0.0.1:8000/api/integration/summary", timeout=8) as response:
+        payload = json.loads(response.read().decode())
+        counts = payload.get("counts") or {}
+        work_logs = int(counts.get("work_logs") or 0)
+        vouchers = int(counts.get("vouchers") or 0)
+        if work_logs <= 0:
+            failed.append(f"analysis-summary: work_logs is {work_logs}")
+        if vouchers <= 0:
+            failed.append(f"analysis-summary: vouchers is {vouchers}")
+        if work_logs > 0 and vouchers > 0:
+            print(f"[ok] analysis-summary -> work_logs={work_logs}, vouchers={vouchers}")
+except Exception as exc:
+    failed.append(f"analysis-summary: {exc}")
+
+if failed:
+    print("[smoke] failures detected:")
+    for item in failed:
+        print(f" - {item}")
+    sys.exit(1)
+
+print("[smoke] all checks passed")
+PY
--- a/scripts/prepare_dev_worktree.sh
+++ b/scripts/prepare_dev_worktree.sh
@@ -38,6 +38,10 @@ fi

 echo "[4/6] Copying local runtime env when available"
 copy_optional_path ".env"
+if [[ ! -f "${DEV_DIR}/.env" && -f "${DEV_DIR}/.env.example" ]]; then
+  cp "${DEV_DIR}/.env.example" "${DEV_DIR}/.env"
+  echo "Created ${DEV_DIR}/.env from .env.example"
+fi

 echo "[5/6] Copying local-only incoming design assets when available"
 copy_optional_path "incoming-files/1.png"
--- a/scripts/publish_organization_app.sh
+++ b/scripts/publish_organization_app.sh
@@ -0,0 +1,13 @@
+#!/usr/bin/env bash
+
+set -euo pipefail
+
+ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+APP_DIR="${ROOT_DIR}/frontend/apps/organization"
+
+cp "${APP_DIR}/index.html" "${ROOT_DIR}/DashBoard-organization.html"
+cp "${APP_DIR}/assets/common.css" "${ROOT_DIR}/legacy/static/common.css"
+cp "${APP_DIR}/assets/organization.css" "${ROOT_DIR}/legacy/static/organization.css"
+cp "${APP_DIR}/assets/organization.js" "${ROOT_DIR}/legacy/static/organization.js"
+
+echo "Published organization app source to legacy runtime files"
--- a/scripts/publish_payment_app.sh
+++ b/scripts/publish_payment_app.sh
@@ -5,9 +5,7 @@ set -euo pipefail
 ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
 APP_DIR="${ROOT_DIR}/frontend/apps/payment"
 TARGET_FILE="${ROOT_DIR}/incoming-files/served/payment.html"
-COMPARE_FILE="${ROOT_DIR}/incoming-files/payment.html"

 cp "${APP_DIR}/index.html" "${TARGET_FILE}"
-cp "${APP_DIR}/index.html" "${COMPARE_FILE}"

 echo "Published payment app source to ${TARGET_FILE}"
--- a/scripts/publish_team_app.sh
+++ b/scripts/publish_team_app.sh
@@ -5,9 +5,7 @@ set -euo pipefail
 ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
 APP_DIR="${ROOT_DIR}/frontend/apps/team"
 TARGET_FILE="${ROOT_DIR}/incoming-files/served/mh.html"
-COMPARE_FILE="${ROOT_DIR}/incoming-files/mh.html"

 cp "${APP_DIR}/index.html" "${TARGET_FILE}"
-cp "${APP_DIR}/index.html" "${COMPARE_FILE}"

 echo "Published team app source to ${TARGET_FILE}"
--- a/scripts/sync_prod_db_to_dev.sh
+++ b/scripts/sync_prod_db_to_dev.sh
@@ -9,6 +9,28 @@ DEV_PROJECT_NAME="${DEV_PROJECT_NAME:-mh-dashboard-organization-dev}"
 DEV_COMPOSE_FILE="${DEV_COMPOSE_FILE:-${DEV_DIR}/docker-compose.8081.yml}"
 SCOPE="${1:-minimal}"

+ANALYSIS_TABLES=(
+  integration_import_batches
+  integration_raw_organization_rows
+  integration_raw_mh_rows
+  integration_raw_mh_pm_rows
+  integration_raw_payment_rows
+  integration_project_aliases
+  integration_project_category_mappings
+  integration_project_pm_assignments
+  integration_projects
+  integration_work_logs
+  integration_work_log_segments
+  integration_vouchers
+)
+
+MINIMAL_PRESERVE_TABLES=(
+  integration_project_pm_assignments
+  integration_work_logs
+  integration_work_log_segments
+  integration_vouchers
+)
+
 if [[ ! -f "${PROD_DIR}/docker-compose.yml" ]]; then
  echo "Production workspace not found: ${PROD_DIR}" >&2
  exit 1
@@ -38,35 +60,11 @@ case "${SCOPE}" in
    )
    ;;
  analysis)
-    TABLES=(
-      integration_import_batches
-      integration_raw_organization_rows
-      integration_raw_mh_rows
-      integration_raw_mh_pm_rows
-      integration_raw_payment_rows
-      integration_project_aliases
-      integration_project_category_mappings
-      integration_project_pm_assignments
-      integration_projects
-      integration_work_logs
-      integration_work_log_segments
-      integration_vouchers
-    )
+    TABLES=("${ANALYSIS_TABLES[@]}")
    ;;
  full)
    TABLES=(
-      integration_import_batches
-      integration_raw_organization_rows
-      integration_raw_mh_rows
-      integration_raw_mh_pm_rows
-      integration_raw_payment_rows
-      integration_project_aliases
-      integration_project_category_mappings
-      integration_project_pm_assignments
-      integration_projects
-      integration_work_logs
-      integration_work_log_segments
-      integration_vouchers
+      "${ANALYSIS_TABLES[@]}"
      member_aliases
      member_overrides
      member_retirements
@@ -81,6 +79,16 @@ case "${SCOPE}" in
    ;;
 esac

+PRESERVE_TABLES=()
+if [[ "${SCOPE}" == "minimal" ]]; then
+  PRESERVE_TABLES=("${MINIMAL_PRESERVE_TABLES[@]}")
+fi
+
+DUMP_TABLES=("${TABLES[@]}")
+if [[ ${#PRESERVE_TABLES[@]} -gt 0 ]]; then
+  DUMP_TABLES+=("${PRESERVE_TABLES[@]}")
+fi
+
 PROD_COMPOSE=(docker compose --project-directory "${PROD_DIR}")
 DEV_COMPOSE=(docker compose -p "${DEV_PROJECT_NAME}" --env-file "${DEV_DIR}/.env" -f "${DEV_COMPOSE_FILE}")

@@ -129,7 +137,7 @@ echo "[4/8] Building truncate script for ${SCOPE} scope"

 echo "[5/8] Dumping ${SCOPE} data from 8080 source DB"
 TABLE_ARGS=()
-for table in "${TABLES[@]}"; do
+for table in "${DUMP_TABLES[@]}"; do
  TABLE_ARGS+=(-t "public.${table}")
 done
 run_compose "${PROD_DIR}" "${PROD_COMPOSE[@]}" exec -T db \
@@ -193,7 +201,7 @@ echo "[7.8/8] Resetting serial sequences"
  echo "SELECT setval(pg_get_serial_sequence('public.member_retirements', 'id'), COALESCE((SELECT MAX(id) FROM public.member_retirements), 1), true);"
  echo "SELECT setval(pg_get_serial_sequence('public.seat_maps', 'id'), COALESCE((SELECT MAX(id) FROM public.seat_maps), 1), true);"
  echo "SELECT setval(pg_get_serial_sequence('public.seat_slots', 'id'), COALESCE((SELECT MAX(id) FROM public.seat_slots), 1), true);"
-  if [[ "${SCOPE}" == "analysis" || "${SCOPE}" == "full" ]]; then
+  if [[ "${SCOPE}" == "analysis" || "${SCOPE}" == "full" || "${#PRESERVE_TABLES[@]}" -gt 0 ]]; then
    echo "SELECT setval(pg_get_serial_sequence('public.integration_import_batches', 'id'), COALESCE((SELECT MAX(id) FROM public.integration_import_batches), 1), true);"
    echo "SELECT setval(pg_get_serial_sequence('public.integration_raw_organization_rows', 'id'), COALESCE((SELECT MAX(id) FROM public.integration_raw_organization_rows), 1), true);"
    echo "SELECT setval(pg_get_serial_sequence('public.integration_raw_mh_rows', 'id'), COALESCE((SELECT MAX(id) FROM public.integration_raw_mh_rows), 1), true);"
@@ -236,7 +244,7 @@ UNION ALL
 SELECT 'auth_users', COUNT(*)::text FROM auth.users
 ORDER BY table_name;
 SQL
-  if [[ "${SCOPE}" == "analysis" || "${SCOPE}" == "full" ]]; then
+  if [[ "${SCOPE}" == "analysis" || "${SCOPE}" == "full" || "${#PRESERVE_TABLES[@]}" -gt 0 ]]; then
    cat <<'SQL'
 SELECT 'integration_work_logs', COUNT(*)::text FROM public.integration_work_logs
 UNION ALL
Author	SHA1	Message	Date
hyunho	4c52fa53e8	Clarify branch and environment rules	2026-04-02 11:29:41 +09:00
hyunho	f5c68ada80	Polish onboarding and reference asset layout	2026-04-02 11:22:52 +09:00
hyunho	c0564ee326	Improve ledger filters and dev sync checks	2026-04-02 11:17:01 +09:00
hyunho	f8ea345882	Refactor app structure and simplify team docs	2026-04-02 11:13:43 +09:00
hyunho	8125193378	Fix organization member editing and drag sync	2026-04-02 10:38:47 +09:00
hyunho	a4480c3435	feat: add seatmap context panel and smoke checks	2026-04-01 18:01:59 +09:00
hyunho	19c8c6ade1	feat: improve db status table browsing	2026-04-01 17:06:39 +09:00
hyunho	c3afc0c772	refactor: split backend route domains	2026-04-01 16:58:51 +09:00
hyunho	03e90d18a3	refactor: split system and serving routes	2026-04-01 16:49:27 +09:00
hyunho	57d9f630bc	refactor: improve db ops visibility and split runtime helpers	2026-04-01 16:41:52 +09:00