73e5eff7bd
- CODING_GUIDE에 새 페이지 구조 및 네이밍 규칙 추가 - 상세한 개편 과정 문서 작성 (2026-01-20-page-restructure.md) 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
170 lines
5.4 KiB
Markdown
170 lines
5.4 KiB
Markdown
# 페이지 구조 대대적 개편 - 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
|