70630b380a
모든 작업자가 개인 계정으로 로그인하여 본인의 연차와 출근 기록을 확인할 수 있는 시스템을 구축했습니다. 주요 기능: - 작업자-계정 1:1 통합 (기존 작업자 자동 계정 생성) - 연차 관리 시스템 (연도별 잔액 관리) - 출근 기록 시스템 (일일 근태 기록) - 나의 대시보드 페이지 (개인 정보 조회) 데이터베이스: - workers 테이블에 salary, base_annual_leave 컬럼 추가 - work_attendance_types, vacation_types 테이블 생성 - daily_attendance_records 테이블 생성 - worker_vacation_balance 테이블 생성 - 기존 작업자 자동 계정 생성 (username: 이름 기반) - Guest 역할 추가 백엔드 API: - 한글→영문 변환 유틸리티 (hangulToRoman.js) - UserRoutes에 개인 정보 조회 API 추가 - GET /api/users/me (내 정보) - GET /api/users/me/attendance-records (출근 기록) - GET /api/users/me/vacation-balance (연차 잔액) - GET /api/users/me/work-reports (작업 보고서) - GET /api/users/me/monthly-stats (월별 통계) 프론트엔드: - 나의 대시보드 페이지 (my-dashboard.html) - 연차 정보 위젯 (총/사용/잔여) - 월별 출근 캘린더 - 근무 시간 통계 - 최근 작업 보고서 목록 - 네비게이션 바에 "나의 대시보드" 메뉴 추가 배포 시 주의사항: - 마이그레이션 실행 필요 - 자동 생성된 계정 초기 비밀번호: 1234 - 작업자들에게 첫 로그인 후 비밀번호 변경 안내 필요 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
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 사용 예제
📖 주요 문서
시작하기
- 개발 환경 설정 - 프로젝트 설정 및 실행 방법
- 시스템 아키텍처 - 전체 시스템 구조 이해
- 코딩 스타일 가이드 - 코드 작성 규칙
개발
- API 문서 - REST API 엔드포인트 레퍼런스
- 데이터베이스 스키마 - DB 구조 및 관계
- 문제 해결 - 자주 발생하는 문제 해결법
리팩토링
🔄 문서 업데이트 규칙
- 리팩토링 시: 변경 사항을
refactoring/LOG.md에 기록 - API 변경 시:
api/ENDPOINTS.md업데이트 - 아키텍처 변경 시: 관련 다이어그램 및 문서 갱신
- 새로운 기능 추가 시: 해당 가이드 문서 작성
📝 문서 작성 가이드
문서 작성 원칙
- 명확성: 기술 용어는 쉽게 설명
- 최신성: 코드 변경 시 즉시 업데이트
- 완결성: 독립적으로 이해 가능하도록 작성
- 예제 포함: 코드 예제와 스크린샷 활용
마크다운 스타일
# H1: 문서 제목 (한 문서에 한 개만)
## H2: 주요 섹션
### H3: 하위 섹션
- 리스트 사용
- 코드 블록 활용
- 테이블로 정보 정리
🔗 외부 리소스
📅 문서 이력
| 날짜 | 버전 | 변경 내용 | 작성자 |
|---|---|---|---|
| 2025-12-11 | 1.0 | 문서 구조 초기 생성 | Claude Code |
📧 문의
문서 관련 질문이나 개선 제안은 프로젝트 관리자에게 문의하세요.