TK-FB-Project/개발 log/2026-01-20-page-restructure.md

페이지 구조 대대적 개편 - 2026-01-20

배경

기존 페이지 구조는 여러 폴더에 분산되어 있고, 파일명이 용도를 명확히 나타내지 못했습니다.

• 34개의 HTML 페이지 중 11개만 실제 사용
• 폴더 구조가 직관적이지 않음 (common, analysis, management 등)
• 파일명이 길고 일관성 없음 (daily-work-report-viewer.html 등)

목표

1. 미사용 페이지 정리 (보관)
2. 명확하고 직관적인 폴더 구조
3. 간결하고 일관성 있는 파일명
4. 향후 확장 가능한 구조

---

변경 내용

1. 미사용 페이지 아카이브 (24개)

모든 미사용 페이지를 .archived-* 형태로 보관:

• .archived-admin/ (8개): 구버전 admin 페이지
• .archived-*-analysis.html (5개): 레거시 분석 페이지
• .archived-*-dashboard.html (3개): 사용하지 않는 대시보드
• .archived-*.html (8개): 기타 미사용 페이지

2. 새로운 폴더 구조

Before (기존)

pages/
├── admin/              (8개 - 전체 미사용)
├── analysis/           (6개 - 1개만 사용)
├── common/             (8개 - 2개만 사용)
├── dashboard/          (3개 - 1개만 사용)
├── management/         (4개 - 전체 사용)
├── profile/            (4개 - 3개 사용)
└── work-reports/       (2개 - 미사용)

After (개편)

pages/
├── dashboard.html      # 메인 대시보드
├── work/               # 작업 관련 (3개)
├── admin/              # 관리 기능 (5개)
├── profile/            # 프로필 (2개)
└── .archived-*/        # 미사용 페이지 (24개)

3. 파일명 개선

기존 경로	새 경로	용도
dashboard/group-leader.html	dashboard.html	메인 대시보드
common/daily-work-report.html	work/report-create.html	작업보고서 작성
common/daily-work-report-viewer.html	work/report-view.html	작업보고서 조회
analysis/work-analysis.html	work/analysis.html	작업 분석
management/work-management.html	admin/index.html	관리 메뉴 허브
management/project-management.html	admin/projects.html	프로젝트 관리
management/worker-management.html	admin/workers.html	작업자 관리
management/code-management.html	admin/codes.html	코드 관리
profile/my-profile.html	profile/info.html	내 정보
profile/change-password.html	profile/password.html	비밀번호 변경
profile/admin-settings.html	admin/accounts.html	계정 관리

4. 내부 링크 수정

모든 페이지의 링크를 새 경로로 업데이트:

• navbar.html: 프로필 메뉴 링크 (3개)
• dashboard.html: 빠른 작업 링크 (4개)
• admin/index.html: 관리 메뉴 링크 (4개)
• admin/*.html: 뒤로가기 링크 (3개)
• load-navbar.js: 대시보드 버튼 경로

---

네이밍 규칙

파일명

• 메인 페이지: 단일 명사 (dashboard.html)
• 관리 페이지: 복수형 명사 (projects.html, workers.html)
• 기능 페이지: 동사-명사 (report-create.html, report-view.html)

폴더명

• 단수형, 소문자
• 명확한 용도 (work/, admin/, profile/)

---

네비게이션 구조

dashboard.html (진입점)
├─┬─ 작업 메뉴
│ ├─→ work/report-create.html    (작업 입력)
│ ├─→ work/report-view.html      (작업 조회)
│ └─→ work/analysis.html          (작업 분석) [관리자]
│
├─┬─ 관리 메뉴 [관리자만]
│ ├─→ admin/index.html            (관리 허브)
│ │   ├─→ admin/projects.html
│ │   ├─→ admin/workers.html
│ │   ├─→ admin/codes.html
│ │   └─→ admin/accounts.html
│
└─┬─ 프로필 메뉴 (navbar)
  ├─→ profile/info.html
  ├─→ profile/password.html
  └─→ admin/accounts.html [관리자]

---

영향 범위

변경된 파일

• 페이지: 39개 (이동/개명 35개, 수정 4개)
• 공통 컴포넌트: 2개 (navbar.html, load-navbar.js)
• 문서: 1개 (CODING_GUIDE.md)

CSS/JS 경로

• 모든 페이지가 절대 경로 사용 (/css/, /js/)
• 폴더 이동에 영향받지 않음 ✅

---

테스트 체크리스트

• 대시보드 접근 확인
• navbar 메뉴 모든 링크 작동 확인
• 작업 보고서 작성 페이지 접근
• 작업 보고서 조회 페이지 접근
• 작업 분석 페이지 접근 (관리자)
• 관리 메뉴 접근 (관리자)
  • 프로젝트 관리
  • 작업자 관리
  • 코드 관리
  • 계정 관리
• 프로필 페이지 접근
  • 내 정보
  • 비밀번호 변경
• 뒤로가기 버튼 작동 확인

---

향후 개선 사항

1. 추가 페이지 검토

   • 작업 검색 페이지 (work/search.html)
   • 알림/공지 페이지 (notifications.html)
   • 도움말 페이지 (help.html)

2. URL 리다이렉트

   • 구버전 URL 호환성 유지 (선택사항)
   • .htaccess 또는 JavaScript 리다이렉트

3. 폴더 정리

   • 빈 폴더 제거 (dashboard, management, analysis, common)
   • .archived-* 폴더를 단일 archived/ 폴더로 통합

---

커밋 정보

• 커밋 해시: a6ab9e3
• 날짜: 2026-01-20
• 영향받는 파일: 39개
• 변경 라인: +21, -19