[P1] [리팩터링 1차] 8081 파일 책임 맵 정리 및 프런트 서빙 경로 정돈 #18

New Issue

2026-04-01T09:29:17+09:00

hyunho commented

2026-04-01 09:29:17 +09:00

상위 이슈

연결: #14

배경

현재 8081에서는 허브 엔트리, 로그인, 조직현황 레거시, 분석 화면, 디자인 오버라이드, incoming-files 참고 자산이 서로 얽혀 있어 어떤 URL이 어떤 파일을 실제로 읽는지 다시 추적해야 하는 상태다.

특히 아래 혼선이 크다.

frontend/public/index.html
frontend/public/styles.css
frontend/public/styles-8081-design.css
legacy/static/common.css
legacy/static/organization.css
legacy/static/organization.js
incoming-files/payment.html
incoming-files/mh.html
incoming-files 내부 참고/복구 자산

이번 차수 목표

기능 추가 전에 8081 프런트 쪽 책임과 실제 서빙 경로를 먼저 고정한다.

작업 범위

허브 기준 실제 서빙 파일 맵 문서화
로그인/허브/조직현황/프로젝트/팀분석별 파일 책임 분리
styles.css는 공통 기본, styles-8081-design.css는 8081 전용 오버라이드로 정착
index.html asset version 및 iframe 연결 정리
incoming-files 안에서 실제 서빙 자산과 참고 자산 구분 기준 수립
recovery 백업본에서 흡수한 디자인 파일을 work-8081 정식 구조에 맞게 재배치

제외 범위

DB 스키마 의미 변경
분석 계산식 수정
인증 정책 변경
seatmap 기능 로직 변경

완료 조건

각 화면이 실제로 읽는 파일이 문서와 코드에서 일치할 것
로그인 화면은 8080 기본 스타일을 유지하고, 8081 전용 디자인은 별도 오버라이드 파일로만 적용될 것
incoming-files에서 실제 서빙 자산과 참고 자산의 구분 기준이 정리될 것
이후 기능 추가 시 수정 대상 파일을 즉시 판단할 수 있을 것

## 상위 이슈 - 연결: `#14` ## 배경 현재 `8081`에서는 허브 엔트리, 로그인, 조직현황 레거시, 분석 화면, 디자인 오버라이드, `incoming-files` 참고 자산이 서로 얽혀 있어 어떤 URL이 어떤 파일을 실제로 읽는지 다시 추적해야 하는 상태다. 특히 아래 혼선이 크다. - `frontend/public/index.html` - `frontend/public/styles.css` - `frontend/public/styles-8081-design.css` - `legacy/static/common.css` - `legacy/static/organization.css` - `legacy/static/organization.js` - `incoming-files/payment.html` - `incoming-files/mh.html` - `incoming-files` 내부 참고/복구 자산 ## 이번 차수 목표 기능 추가 전에 `8081` 프런트 쪽 책임과 실제 서빙 경로를 먼저 고정한다. ## 작업 범위 - 허브 기준 실제 서빙 파일 맵 문서화 - 로그인/허브/조직현황/프로젝트/팀분석별 파일 책임 분리 - `styles.css`는 공통 기본, `styles-8081-design.css`는 8081 전용 오버라이드로 정착 - `index.html` asset version 및 iframe 연결 정리 - `incoming-files` 안에서 실제 서빙 자산과 참고 자산 구분 기준 수립 - recovery 백업본에서 흡수한 디자인 파일을 `work-8081` 정식 구조에 맞게 재배치 ## 제외 범위 - DB 스키마 의미 변경 - 분석 계산식 수정 - 인증 정책 변경 - seatmap 기능 로직 변경 ## 완료 조건 - 각 화면이 실제로 읽는 파일이 문서와 코드에서 일치할 것 - 로그인 화면은 8080 기본 스타일을 유지하고, 8081 전용 디자인은 별도 오버라이드 파일로만 적용될 것 - `incoming-files`에서 실제 서빙 자산과 참고 자산의 구분 기준이 정리될 것 - 이후 기능 추가 시 수정 대상 파일을 즉시 판단할 수 있을 것

hyunho commented

2026-04-01 09:33:31 +09:00

1차 구조 정리 진행 기록.

현재까지 반영한 내용:

docs/architecture/8081_SERVING_MAP.md 추가
8081 기준 실제 서빙 경로와 파일 책임을 먼저 문서화
로그인 기본 스타일은 styles.css 공통 기준으로 유지, 허브 8081 전용 오버라이드는 styles-8081-design.css로 분리 시작
/integrations/payment, /integrations/mh의 실제 서빙 파일을 incoming-files/served/payment.html, incoming-files/served/mh.html로 분리
backend main.py에서 위 served/ 경로를 읽도록 변경

현재 유지한 원칙:

기능/DB 의미 변경 없음
8080 루트 소스 수정 없음
8081 work-8081 기준에서만 구조 정리 수행

크로스 체크 결과:

8080 /api/health 정상
8081 dev 컨테이너 health 정상
backend 내부 기준
- /api/health 200
- /legacy/organization 200
- /integrations/payment 200
- /integrations/mh 200
/app/incoming-files/served/payment.html, /app/incoming-files/served/mh.html 존재 확인

현재 남은 1차 범위:

incoming-files 안의 실제 서빙 자산 / 참고 원본 자산 경계 더 명확히 정리
index.html asset version과 iframe 연결 규칙 문서/코드 기준 더 단순화
recovery에서 흡수된 디자인 파일들의 역할을 더 명시적으로 정리

주의:

아직 incoming-files/payment.html, incoming-files/mh.html 원본 파일은 남겨둔 상태이며, 현재는 안전한 전환을 위해 served/에 복사 후 서빙 경로만 변경함
대규모 이동/삭제는 1차 정리 마감 직전에 다시 검토

1차 구조 정리 진행 기록. 현재까지 반영한 내용: - `docs/architecture/8081_SERVING_MAP.md` 추가 - `8081` 기준 실제 서빙 경로와 파일 책임을 먼저 문서화 - 로그인 기본 스타일은 `styles.css` 공통 기준으로 유지, 허브 8081 전용 오버라이드는 `styles-8081-design.css`로 분리 시작 - `/integrations/payment`, `/integrations/mh`의 실제 서빙 파일을 `incoming-files/served/payment.html`, `incoming-files/served/mh.html`로 분리 - backend `main.py`에서 위 `served/` 경로를 읽도록 변경 현재 유지한 원칙: - 기능/DB 의미 변경 없음 - `8080` 루트 소스 수정 없음 - `8081` work-8081 기준에서만 구조 정리 수행 크로스 체크 결과: - `8080 /api/health` 정상 - `8081` dev 컨테이너 health 정상 - backend 내부 기준 - `/api/health` 200 - `/legacy/organization` 200 - `/integrations/payment` 200 - `/integrations/mh` 200 - `/app/incoming-files/served/payment.html`, `/app/incoming-files/served/mh.html` 존재 확인 현재 남은 1차 범위: - `incoming-files` 안의 실제 서빙 자산 / 참고 원본 자산 경계 더 명확히 정리 - `index.html` asset version과 iframe 연결 규칙 문서/코드 기준 더 단순화 - recovery에서 흡수된 디자인 파일들의 역할을 더 명시적으로 정리 주의: - 아직 `incoming-files/payment.html`, `incoming-files/mh.html` 원본 파일은 남겨둔 상태이며, 현재는 안전한 전환을 위해 `served/`에 복사 후 서빙 경로만 변경함 - 대규모 이동/삭제는 1차 정리 마감 직전에 다시 검토

hyunho commented

2026-04-01 09:35:32 +09:00

추가 진행 기록.

이번 라운드에서 한 정리:

frontend/public/index.html에 역할 주석 추가
- styles.css는 로그인/공통 기본
- styles-8081-design.css는 8081 허브 전용 오버라이드
- /legacy/organization, /integrations/payment, /integrations/mh의 실제 책임 위치를 주석으로 명시
docs/architecture/8081_SERVING_MAP.md 갱신
- /integrations/payment, /integrations/mh 실제 서빙 파일을 incoming-files/served/* 기준으로 정정
- 루트 incoming-files/payment.html, incoming-files/mh.html는 당분간 비교/복구용으로 남긴다는 정책 명시
incoming-files/served/README.md 추가
incoming-files/reference/README.md 추가

현재 1차 정리 결과 해석:

실제 서빙 파일과 참고 자산의 경계가 문서/디렉터리 구조에서 보이기 시작함
로그인 기본 스타일과 8081 허브 오버라이드의 경계도 코드 상에서 명시됨
아직 위험한 대량 이동/삭제는 하지 않았고, 안전한 복사+경로 전환 방식으로만 진행함

이번 라운드 크로스 체크:

backend 내부 기준
- /api/health 200
- /legacy/organization 200
- /integrations/payment 200
- /integrations/mh 200
/app/incoming-files/served 안에 payment.html, mh.html, README.md 존재 확인

다음 1차 잔여 범위:

현재 수정된 디자인 흡수 파일들(index.html, legacy/static/*, incoming-files/payment.html, incoming-files/mh.html)을 기준으로 ‘정식 서빙 파일/비교용 파일/오버라이드 파일’ 3분류를 더 분명하게 정리
가능하면 payment.html, mh.html 루트 파일을 더 이상 수정하지 않도록 작업 기준을 served/ 쪽으로 고정
그 후 1차 마감 판단

추가 진행 기록. 이번 라운드에서 한 정리: - `frontend/public/index.html`에 역할 주석 추가 - `styles.css`는 로그인/공통 기본 - `styles-8081-design.css`는 8081 허브 전용 오버라이드 - `/legacy/organization`, `/integrations/payment`, `/integrations/mh`의 실제 책임 위치를 주석으로 명시 - `docs/architecture/8081_SERVING_MAP.md` 갱신 - `/integrations/payment`, `/integrations/mh` 실제 서빙 파일을 `incoming-files/served/*` 기준으로 정정 - 루트 `incoming-files/payment.html`, `incoming-files/mh.html`는 당분간 비교/복구용으로 남긴다는 정책 명시 - `incoming-files/served/README.md` 추가 - `incoming-files/reference/README.md` 추가 현재 1차 정리 결과 해석: - 실제 서빙 파일과 참고 자산의 경계가 문서/디렉터리 구조에서 보이기 시작함 - 로그인 기본 스타일과 8081 허브 오버라이드의 경계도 코드 상에서 명시됨 - 아직 위험한 대량 이동/삭제는 하지 않았고, 안전한 복사+경로 전환 방식으로만 진행함 이번 라운드 크로스 체크: - backend 내부 기준 - `/api/health` 200 - `/legacy/organization` 200 - `/integrations/payment` 200 - `/integrations/mh` 200 - `/app/incoming-files/served` 안에 `payment.html`, `mh.html`, `README.md` 존재 확인 다음 1차 잔여 범위: - 현재 수정된 디자인 흡수 파일들(`index.html`, `legacy/static/*`, `incoming-files/payment.html`, `incoming-files/mh.html`)을 기준으로 ‘정식 서빙 파일/비교용 파일/오버라이드 파일’ 3분류를 더 분명하게 정리 - 가능하면 `payment.html`, `mh.html` 루트 파일을 더 이상 수정하지 않도록 작업 기준을 `served/` 쪽으로 고정 - 그 후 1차 마감 판단

hyunho commented

2026-04-01 09:38:53 +09:00

2026-04-01 1차 구조 정리 진행상황 업데이트

반영/확인 내용:

docs/architecture/8081_SERVING_MAP.md 추가
docs/NEXT_SESSION_CHECKPOINT.md를 현재 운영 구조(8080=total, 8081=work-8081) 기준으로 갱신
/integrations/payment, /integrations/mh의 실제 서빙 파일을 incoming-files/served/payment.html, incoming-files/served/mh.html로 고정
backend 라우트도 위 served/*를 보도록 정리 시작
허브 공통 기본 스타일(styles.css)과 8081 전용 허브 디자인 오버라이드(styles-8081-design.css) 책임을 분리
기존 incoming-files/payment.html, incoming-files/mh.html은 비교/복구용 복사본으로 당분간 유지

크로스 체크:

8080 /api/health 정상
8081 dev 컨테이너 proxy/backend/frontend/db healthy
backend 내부 기준 /api/health, /legacy/organization, /integrations/payment, /integrations/mh 모두 200
frontend/proxy 기준 styles-8081-design.css 실제 서빙 확인

현재 판단:

1차 정리 범위에서 실제 서빙 경로와 비교용 자산 경계는 일단 고정됨
다음은 같은 이슈 범위에서 실제 서빙 파일과 참고 파일의 분류를 더 명시적으로 정리한 뒤, 기능 추가 작업(사업관리대장 탭 기능 등)에 들어가면 됨
backend 대분해는 #19, 스크립트/문서 운영 규칙 정리는 #20에서 진행

2026-04-01 1차 구조 정리 진행상황 업데이트 반영/확인 내용: - `docs/architecture/8081_SERVING_MAP.md` 추가 - `docs/NEXT_SESSION_CHECKPOINT.md`를 현재 운영 구조(`8080=total`, `8081=work-8081`) 기준으로 갱신 - `/integrations/payment`, `/integrations/mh`의 실제 서빙 파일을 `incoming-files/served/payment.html`, `incoming-files/served/mh.html`로 고정 - backend 라우트도 위 `served/*`를 보도록 정리 시작 - 허브 공통 기본 스타일(`styles.css`)과 8081 전용 허브 디자인 오버라이드(`styles-8081-design.css`) 책임을 분리 - 기존 `incoming-files/payment.html`, `incoming-files/mh.html`은 비교/복구용 복사본으로 당분간 유지 크로스 체크: - `8080 /api/health` 정상 - `8081` dev 컨테이너 proxy/backend/frontend/db healthy - backend 내부 기준 `/api/health`, `/legacy/organization`, `/integrations/payment`, `/integrations/mh` 모두 200 - frontend/proxy 기준 `styles-8081-design.css` 실제 서빙 확인 현재 판단: - 1차 정리 범위에서 실제 서빙 경로와 비교용 자산 경계는 일단 고정됨 - 다음은 같은 이슈 범위에서 실제 서빙 파일과 참고 파일의 분류를 더 명시적으로 정리한 뒤, 기능 추가 작업(사업관리대장 탭 기능 등)에 들어가면 됨 - backend 대분해는 `#19`, 스크립트/문서 운영 규칙 정리는 `#20`에서 진행

hyunho commented

2026-04-01 09:41:43 +09:00

2026-04-01 1차 정리 상태 업데이트

현재 판단:

#18 범위의 1차 안정화는 완료로 봐도 되는 상태
전체 리팩터링이 끝난 것은 아니지만, 기능 작업(사업관리대장 탭 기능, 디자인 통일, 세부 기능 추가)에 들어가도 될 만큼의 구조 안정화는 확보됨

1차 안정화 완료로 보는 근거:

8080=total, 8081=work-8081 작업 축 분리 고정
실제 서빙 파일과 비교/복구용 파일 경계 고정
/integrations/payment, /integrations/mh 실제 서빙 경로를 incoming-files/served/*로 명시화
로그인 기본 스타일(styles.css)과 8081 허브 전용 오버라이드(styles-8081-design.css) 책임 분리
체크포인트, 서빙 맵 문서, 이슈 체계가 현재 코드 구조와 일치
주요 라우트(/api/health, /legacy/organization, /integrations/payment, /integrations/mh) 재검증 완료

남은 범위:

backend 라우터/서빙 책임 분리는 #19
worktree/스크립트/운영 문서 정리는 #20
#18은 필요 시 기능 작업 중 발생하는 프런트 자산 경계 보정 정도만 추가로 수행

권장 다음 작업:

#18은 현재 상태로 유지하고, 다음 우선순위인 사업관리대장 탭 기능 작업으로 이동

2026-04-01 1차 정리 상태 업데이트 현재 판단: - `#18` 범위의 1차 안정화는 완료로 봐도 되는 상태 - 전체 리팩터링이 끝난 것은 아니지만, 기능 작업(사업관리대장 탭 기능, 디자인 통일, 세부 기능 추가)에 들어가도 될 만큼의 구조 안정화는 확보됨 1차 안정화 완료로 보는 근거: - `8080=total`, `8081=work-8081` 작업 축 분리 고정 - 실제 서빙 파일과 비교/복구용 파일 경계 고정 - `/integrations/payment`, `/integrations/mh` 실제 서빙 경로를 `incoming-files/served/*`로 명시화 - 로그인 기본 스타일(`styles.css`)과 8081 허브 전용 오버라이드(`styles-8081-design.css`) 책임 분리 - 체크포인트, 서빙 맵 문서, 이슈 체계가 현재 코드 구조와 일치 - 주요 라우트(`/api/health`, `/legacy/organization`, `/integrations/payment`, `/integrations/mh`) 재검증 완료 남은 범위: - backend 라우터/서빙 책임 분리는 `#19` - worktree/스크립트/운영 문서 정리는 `#20` - `#18`은 필요 시 기능 작업 중 발생하는 프런트 자산 경계 보정 정도만 추가로 수행 권장 다음 작업: - `#18`은 현재 상태로 유지하고, 다음 우선순위인 사업관리대장 탭 기능 작업으로 이동

hyunho commented

2026-04-01 14:02:33 +09:00

1차 구조 정리 후속으로 8081 디자인 SSOT와 런타임 패턴을 실제 코드 기준으로 승격했습니다.

이번 반영 요약:

디자인 토큰 SSOT 추가: frontend/public/design-tokens.css
디자인 패턴 SSOT 추가: frontend/public/design-patterns.css
기준 문서 정리: docs/architecture/DESIGN_SSOT.md
다음 작업 시 디자인 수정 우선순위를 tokens -> patterns -> 화면별 실제 서빙 파일로 체크포인트/룰북/실행플로우에 고정
incoming-files/served/payment.html, incoming-files/served/mh.html, legacy/static/*, frontend/public/*가 공통 디자인 기준을 바라보도록 정리
project/payment 화면의 프로젝트명 초기 비표시 문제 수정

현재 이슈 #18 관점 결과:

실제 서빙 파일 경계는 유지
디자인 수정 기준 파일 경로까지 명시됨
프런트 서빙 경로 정돈 + 디자인 SSOT 승격까지 1차 범위 확장 완료

커밋: fb5b0f0 feat: unify 8081 dashboard design system and views

1차 구조 정리 후속으로 8081 디자인 SSOT와 런타임 패턴을 실제 코드 기준으로 승격했습니다. 이번 반영 요약: - 디자인 토큰 SSOT 추가: `frontend/public/design-tokens.css` - 디자인 패턴 SSOT 추가: `frontend/public/design-patterns.css` - 기준 문서 정리: `docs/architecture/DESIGN_SSOT.md` - 다음 작업 시 디자인 수정 우선순위를 `tokens -> patterns -> 화면별 실제 서빙 파일`로 체크포인트/룰북/실행플로우에 고정 - `incoming-files/served/payment.html`, `incoming-files/served/mh.html`, `legacy/static/*`, `frontend/public/*`가 공통 디자인 기준을 바라보도록 정리 - `project/payment` 화면의 프로젝트명 초기 비표시 문제 수정 현재 이슈 #18 관점 결과: - 실제 서빙 파일 경계는 유지 - 디자인 수정 기준 파일 경로까지 명시됨 - 프런트 서빙 경로 정돈 + 디자인 SSOT 승격까지 1차 범위 확장 완료 커밋: `fb5b0f0 feat: unify 8081 dashboard design system and views`

hyunho commented

2026-04-01 14:37:50 +09:00

현재 기준으로 완료 처리 가능.

반영 완료:

8081 서빙 책임 맵 문서화
payment, mh, ledger 실제 서빙 경로 고정
incoming-files 내 served / reference 경계 수립
이후 수정 원본 위치까지 앱 소스 기준으로 승격

현재는 이 이슈의 1차 목표였던 파일 책임 맵 정리 및 프런트 서빙 경로 정돈을 넘어, #21에서 실제 서비스 코드 독립화까지 진행된 상태.

현재 기준으로 완료 처리 가능. 반영 완료: - `8081` 서빙 책임 맵 문서화 - `payment`, `mh`, `ledger` 실제 서빙 경로 고정 - `incoming-files` 내 served / reference 경계 수립 - 이후 수정 원본 위치까지 앱 소스 기준으로 승격 현재는 이 이슈의 1차 목표였던 파일 책임 맵 정리 및 프런트 서빙 경로 정돈을 넘어, `#21`에서 실제 서비스 코드 독립화까지 진행된 상태.

hyunho closed this issue

2026-04-01 14:37:55 +09:00

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: hyunho/MH-DashBoard-organization#18