1. 프로젝트 시작 가이드 (초기 정렬)

이 문서는 1인 개발자가 Loafacto Hub를 빠르게 정비하기 위한 핵심 문서 지도입니다.

분류	항목	우선순위	비고
운영	Lean WBS	1단계	GitHub Projects로 작은 단위 작업 관리
문서	Monorepo Root README	1단계	앱 구조, 실행 방법, 배포 요건 정리
아키텍처	ERD & JWT Logic	1단계	인증/권한 체계를 먼저 확정

2. 다음 점검 항목

• API 문서화: FastAPI 실행 후 /docs(Swagger)에서 스펙 공유
• 프론트 실행 스크립트: apps/web-ui/package.json의 scripts 정리
• 기능 우선순위: MVP 기능부터 실제 사용 흐름으로 정렬

3. 운영/개발 전략

향후 확장성 확보를 위해 운영 단계별 실행 로그를 남기는 방식으로 관리합니다.

• Offline 배포 전략: 배포 이력과 빌드 산출물 버전 추적
• AI Agent Trace Log: 의사결정/자동화 결과를 로그로 남겨 복구성 확보

---

최종 가이드 정리 원칙 (Golden Rule)

모든 작업은 README.md 기준으로 통일합니다.

1. 최상위 구조는 apps/ 기준으로 정리하고, 공통 유틸은 명확히 분리한다.
2. 도메인별 책임을 분리하고, 패키지 경계(packages/)를 필요 시 점진 도입한다.
3. 문서의 각 항목은 feat: 내용 형식의 변경 이력으로 남기고, 실행 확인 단계를 붙인다.