docs: 페이지 구조 개편 문서화

- CODING_GUIDE에 새 페이지 구조 및 네이밍 규칙 추가 - 상세한 개편 과정 문서 작성 (2026-01-20-page-restructure.md) 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
2026-01-20 10:46:10 +09:00
parent a6ab9e395d
commit 73e5eff7bd
2 changed files with 200 additions and 0 deletions
--- a/CODING_GUIDE.md
+++ b/CODING_GUIDE.md
@@ -92,6 +92,37 @@ docker-compose up -d # 수동 실행
 - **일관된 헤더**: 모든 페이지에서 `<div id="navbar-container"></div>` 사용
 - **CSS 로딩 순서**: `design-system.css` → 페이지별 CSS

+### 페이지 구조 (2026-01-20 개편)
+```
+web-ui/pages/
+├── dashboard.html              # 메인 대시보드
+├── work/                       # 작업 관련 페이지
+│   ├── report-create.html      # 작업보고서 작성
+│   ├── report-view.html        # 작업보고서 조회
+│   └── analysis.html           # 작업 분석
+├── admin/                      # 관리자 기능
+│   ├── index.html              # 관리 메뉴 허브
+│   ├── projects.html           # 프로젝트 관리
+│   ├── workers.html            # 작업자 관리
+│   ├── codes.html              # 코드 관리
+│   └── accounts.html           # 계정 관리
+├── profile/                    # 사용자 프로필
+│   ├── info.html               # 내 정보
+│   └── password.html           # 비밀번호 변경
+└── .archived-*/                # 미사용 페이지 보관
+```
+
+**네이밍 규칙**:
+- 메인 페이지: 단일 명사 (`dashboard.html`)
+- 관리 페이지: 복수형 명사 (`projects.html`, `workers.html`)
+- 기능 페이지: 동사-명사 (`report-create.html`, `report-view.html`)
+- 폴더명: 단수형, 소문자 (`work/`, `admin/`, `profile/`)
+
+**네비게이션 구조**:
+- 1차: `dashboard.html` (메인 진입점)
+- 2차: `admin/index.html` (관리 허브)
+- 모든 페이지: navbar를 통해 profile, 작업 페이지로 이동 가능
+
 ---

 ## 📡 API 개발 가이드
--- a/log/2026-01-20-page-restructure.md
+++ b/log/2026-01-20-page-restructure.md
@@ -0,0 +1,169 @@
+# 페이지 구조 대대적 개편 - 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