Files
TK-FB-Project/docs
Hyungi Ahn 4d0c4c0801 feat: TBM 시스템 구축 및 페이지 권한 관리 기능 추가
## 주요 변경사항

### 1. TBM (Tool Box Meeting) 시스템 구축
- **데이터베이스 스키마** (5개 테이블 생성)
  - tbm_sessions: TBM 세션 관리
  - tbm_team_assignments: 팀 구성 관리
  - tbm_safety_checks: 안전 체크리스트 마스터 (17개 항목)
  - tbm_safety_records: 안전 체크 기록
  - team_handovers: 작업 인계 관리

- **API 엔드포인트** (17개)
  - TBM 세션 CRUD
  - 팀 구성 관리
  - 안전 체크리스트
  - 작업 인계
  - 통계 및 리포트

- **프론트엔드**
  - TBM 관리 페이지 (/pages/work/tbm.html)
  - 모달 기반 UI (세션 생성, 팀 구성, 안전 체크)

### 2. 페이지 권한 관리 시스템
- 페이지별 접근 권한 설정 기능
- 관리자 페이지 (/pages/admin/page-access.html)
- 사용자별 페이지 권한 부여/회수
- TBM 페이지 등록 및 권한 연동

### 3. 네비게이션 role 표시 버그 수정
- load-navbar.js: case-insensitive role 매칭 적용
- JWT의 "Admin" role이 "관리자"로 정상 표시
- admin-only 메뉴 항목 정상 표시

### 4. 대시보드 개선
- 작업 현황 테이블 가독성 향상
- 고대비 색상 및 명확한 구분선 적용
- 이모지 제거 및 SVG 아이콘 적용

### 5. 문서화
- TBM 배포 가이드 작성 (docs/TBM_DEPLOYMENT_GUIDE.md)
- 데이터베이스 스키마 상세 기록
- 배포 절차 및 체크리스트 제공

## 기술 스택
- Backend: Node.js, Express, MySQL
- Frontend: Vanilla JavaScript, HTML5, CSS3
- Database: MySQL (InnoDB)

## 파일 변경사항

### 신규 파일
- api.hyungi.net/db/migrations/20260120000000_create_tbm_system.js
- api.hyungi.net/db/migrations/20260120000001_add_tbm_page.js
- api.hyungi.net/models/tbmModel.js
- api.hyungi.net/models/pageAccessModel.js
- api.hyungi.net/controllers/tbmController.js
- api.hyungi.net/controllers/pageAccessController.js
- api.hyungi.net/routes/tbmRoutes.js
- web-ui/pages/work/tbm.html
- web-ui/pages/admin/page-access.html
- web-ui/js/page-access-management.js
- docs/TBM_DEPLOYMENT_GUIDE.md

### 수정 파일
- api.hyungi.net/config/routes.js (TBM 라우트 추가)
- web-ui/js/load-navbar.js (role 매칭 버그 수정)
- web-ui/pages/admin/workers.html (HTML 구조 수정)
- web-ui/pages/dashboard.html (이모지 제거)
- web-ui/css/design-system.css (색상 팔레트 추가)
- web-ui/css/modern-dashboard.css (가독성 개선)
- web-ui/js/modern-dashboard.js (SVG 아이콘 적용)

## 배포 시 주의사항
⚠️ 본 서버 배포 시 반드시 마이그레이션 실행 필요:
```bash
npm run db:migrate
```

상세한 배포 절차는 docs/TBM_DEPLOYMENT_GUIDE.md 참조

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2026-01-20 15:38:17 +09:00
..

TK-FB-Project 개발 문서

📚 문서 구조

이 디렉토리는 TK-FB-Project의 개발 및 유지보수를 위한 종합 문서 저장소입니다.

디렉토리 구조

docs/
├── README.md                          # 이 파일 - 문서 인덱스
├── architecture/                      # 아키텍처 관련 문서
│   ├── OVERVIEW.md                   # 시스템 아키텍처 개요
│   ├── DATABASE.md                   # 데이터베이스 스키마 및 설계
│   └── API_DESIGN.md                 # API 설계 원칙
├── refactoring/                      # 리팩토링 관련 문서
│   ├── PLAN.md                       # 리팩토링 계획 및 로드맵
│   ├── LOG.md                        # 리팩토링 작업 로그
│   └── ANALYSIS.md                   # 코드 분석 리포트
├── guides/                           # 개발 가이드
│   ├── SETUP.md                      # 개발 환경 설정
│   ├── CODING_STYLE.md               # 코딩 스타일 가이드
│   ├── GIT_WORKFLOW.md               # Git 워크플로우
│   ├── SECURITY.md                   # 보안 가이드라인
│   └── TROUBLESHOOTING.md            # 문제 해결 가이드
└── api/                              # API 문서
    ├── ENDPOINTS.md                  # API 엔드포인트 목록
    ├── AUTHENTICATION.md             # 인증 및 권한
    └── EXAMPLES.md                   # API 사용 예제

📖 주요 문서

시작하기

개발

리팩토링

🔄 문서 업데이트 규칙

  1. 리팩토링 시: 변경 사항을 refactoring/LOG.md에 기록
  2. API 변경 시: api/ENDPOINTS.md 업데이트
  3. 아키텍처 변경 시: 관련 다이어그램 및 문서 갱신
  4. 새로운 기능 추가 시: 해당 가이드 문서 작성

📝 문서 작성 가이드

문서 작성 원칙

  • 명확성: 기술 용어는 쉽게 설명
  • 최신성: 코드 변경 시 즉시 업데이트
  • 완결성: 독립적으로 이해 가능하도록 작성
  • 예제 포함: 코드 예제와 스크린샷 활용

마크다운 스타일

# H1: 문서 제목 (한 문서에 한 개만)
## H2: 주요 섹션
### H3: 하위 섹션

- 리스트 사용
- 코드 블록 활용
- 테이블로 정보 정리

🔗 외부 리소스

📅 문서 이력

날짜 버전 변경 내용 작성자
2025-12-11 1.0 문서 구조 초기 생성 Claude Code

📧 문의

문서 관련 질문이나 개선 제안은 프로젝트 관리자에게 문의하세요.