TK-FB-Project/docs/CLEANUP_TODO.md

문서 정리 목록

생성일: 2026-02-03 아래 항목들을 검토 후 삭제 또는 통합하세요.

---

1. 삭제 권장 (더 이상 사용하지 않음)

루트 폴더

경로	사유
update-logs/	단 1개 파일(updates.md)만 있음, 개발 log로 통합 권장
daily_work_reports.sql	오래된 SQL 덤프, 필요시 DB에서 재생성 가능
hyungi.sql	오래된 대용량 SQL 덤프 (682KB), 삭제 권장
test_push.txt	테스트 파일, 삭제

docs/ 폴더

경로	사유
docs/refactoring/	2025-12월 리팩토링 계획, 완료 후 불필요
docs/deployment_notes.md	간단한 메모, TBM_DEPLOYMENT_GUIDE.md에 통합 가능
docs/database/CURRENT_SCHEMA.md	CHECKLIST.md 또는 CODING_GUIDE.md에 통합 권장

---

2. 통합 권장 (중복 폴더)

개발 로그 폴더 통합

현재 두 개의 개발 로그 폴더가 있습니다:

• 개발 log/ (8개 파일)
• 개발로그/ (5개 파일)

권장 작업:

# 개발로그/ 폴더의 파일을 개발 log/로 이동
mv "개발로그/"* "개발 log/"
rmdir "개발로그"

---

3. _archive/ 폴더 검토

현재 아카이브된 파일들 (참고용으로 유지 가능):

파일	내용	판단
DATABASE_SCHEMA.md	초기 DB 스키마	참고용 유지
DELETED_PAGES.md	삭제된 페이지 기록	히스토리용 유지
DELETED_TABLES.md	삭제된 테이블 기록	히스토리용 유지
MYSQL_COMPATIBILITY_NOTES.md	MySQL 호환성 메모	참고용 유지
README.md	레거시 시작 가이드	삭제 가능
TESTING_GUIDE.md	테스트 가이드 (Jest)	테스트 시 참고용 유지
룰.md	초기 개발 규칙	삭제 가능 (CODING_GUIDE.md로 대체됨)
검토_리포트.md	2025-07 검토 리포트	삭제 가능

---

4. 유지할 핵심 문서

루트 (4개)

• CODING_GUIDE.md - 메인 개발 가이드
• DEV_LOG.md - 개발 현황
• CHECKLIST.md - 프로젝트 체크리스트
• docker-compose.yml - Docker 설정

docs/ (7개)

• docs/README.md - 문서 인덱스
• docs/ADMIN_PAGE_STANDARD.md - 관리 페이지 표준
• docs/DOCUMENTATION_STANDARD.md - 문서 작성 표준
• docs/TBM_DEPLOYMENT_GUIDE.md - TBM 배포 가이드
• docs/guides/SETUP.md - 개발 환경 설정
• docs/guides/CODING_STYLE.md - 코딩 스타일
• docs/guides/work-report-time-input-guide.md - 시간 입력 UX

docs/architecture/ (1개)

• docs/architecture/OVERVIEW.md - 시스템 아키텍처 (업데이트 필요)

---

5. 정리 완료 후 README.md 업데이트 필요

docs/README.md의 다음 섹션을 업데이트하세요:

1. 웹 UI 페이지 구조 (현재 outdated - safety/ 페이지 변경됨)
2. 개발 로그 섹션 (폴더 통합 후 경로 수정)
3. 문서 분류 (삭제된 문서 제거)

---

요약

분류	개수	조치
삭제 권장	7개 파일/폴더	수동 삭제
통합 권장	2개 폴더	개발로그 → 개발 log
유지	12개 핵심 문서	-
아카이브 검토	8개 파일	4개 삭제 가능