diff --git a/CODING_GUIDE.md b/CODING_GUIDE.md index baa2c15..d7a45e6 100644 --- a/CODING_GUIDE.md +++ b/CODING_GUIDE.md @@ -92,6 +92,37 @@ docker-compose up -d # 수동 실행 - **일관된 헤더**: 모든 페이지에서 `` 사용 - **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 개발 가이드 diff --git a/개발 log/2026-01-20-page-restructure.md b/개발 log/2026-01-20-page-restructure.md new file mode 100644 index 0000000..129549f --- /dev/null +++ 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