feat: unify 8081 dashboard design system and views

docs/architecture/8081_SERVING_MAP.md

@@ -0,0 +1,100 @@
+# 8081 Serving Map
+
+## Purpose
+
+이 문서는 `8081` 작업용에서 어떤 URL이 어떤 파일을 실제로 읽는지 고정하기 위한 책임 맵이다.
+이번 1차 정리의 목표는 기능 변경이 아니라 `실제 서빙 파일`, `공통 기본 스타일`, `8081 전용 오버라이드`, `참고 원본 자산`의 경계를 분명히 하는 것이다.
+
+## Runtime Entry Points
+
+- 허브 엔트리: `/`
+  - 파일: `frontend/public/index.html`
+- 허브 공통 스크립트:
+  - 파일: `frontend/public/app.js`
+- 허브 공통 기본 스타일:
+  - 파일: `frontend/public/styles.css`
+- 허브 8081 전용 디자인 오버라이드:
+  - 파일: `frontend/public/styles-8081-design.css`
+
+## Login Rules
+
+- 로그인 화면 기본 구조와 스타일은 `8080` 공통 기준을 따른다.
+- 로그인 기본 스타일은 `frontend/public/styles.css`에서만 정의한다.
+- `frontend/public/styles-8081-design.css`에는 로그인 관련 셀렉터를 넣지 않는다.
+
+## Legacy Organization
+
+- URL: `/legacy/organization`
+- HTML 파일:
+  - `DashBoard-organization.html`
+- 정적 자산:
+  - `legacy/static/common.css`
+  - `legacy/static/organization.css`
+  - `legacy/static/organization.js`
+
+## Integration Screens
+
+- URL: `/integrations/payment`
+  - 현재 실제 서빙 파일: `incoming-files/served/payment.html`
+- URL: `/integrations/mh`
+  - 현재 실제 서빙 파일: `incoming-files/served/mh.html`
+
+정리 원칙:
+
+- `incoming-files` 아래에서는 `served/`를 실제 서빙 자산용으로 사용한다.
+- `reference/`는 원본 참고 파일, 복구 참고 파일, 비교용 자산만 둔다.
+- 1차 정리에서는 기존 실제 서빙 파일을 `served/`에 복사하고, backend 서빙 경로를 먼저 `served/`로 갱신한다.
+- 기존 루트 `incoming-files/payment.html`, `incoming-files/mh.html`는 안전한 비교/복구를 위해 당분간 남겨둔다.
+
+## Seat Map
+
+- 허브 화면 구성:
+  - `frontend/public/index.html`
+  - `frontend/public/app.js`
+  - `frontend/public/styles.css`
+  - `frontend/public/styles-8081-design.css`
+- API / viewer:
+  - `backend/app/main.py`
+  - `backend/app/db.py`
+  - `backend/app/center_chair_viewer_template.html`
+
+## Incoming Files Classification
+
+### Served
+
+- 실제 URL에서 직접 읽는 파일
+- 예:
+  - `served/payment.html`
+  - `served/mh.html`
+
+### Reference
+
+- 원본 HTML/CSS/XLSX/CSV
+- 복구 비교용 자산
+- 직접 서빙하지 않는 참고 파일
+- 필요 시 다음 차수에서 `reference/` 하위로 단계적 재배치한다.
+
+예:
+
+- `260320.html`
+- `sample style.css`
+- `opayment.html`
+- `omh.html`
+- `사업관리대장/*`
+- 원본 xlsx/csv
+
+## Out Of Scope For Phase 1
+
+- DB 스키마 의미 변경
+- 계산식 변경
+- 권한 로직 변경
+- 신규 기능 추가
+- backend 라우터 대분해
+
+## Phase 1 Success Criteria
+
+- 수정 대상 파일을 화면별로 즉시 찾을 수 있다.
+- 로그인은 `styles.css`만 본다.
+- 허브 8081 디자인은 `styles-8081-design.css`만 본다.
+- `/integrations/payment`, `/integrations/mh`의 실제 서빙 파일 위치가 문서와 코드에서 일치한다.
+- 기존 참고 자산을 지우지 않고도 실제 서빙 경로와 참고 경로를 구분할 수 있다.