# 페이지 구조 대대적 개편 - 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