MH-DashBoard-organization/docs/WSL_WORKSPACE_GUIDE.md

WSL 작업 기준 가이드

1. 왜 WSL 기준으로 작업하나

• 현재 이 프로젝트는 Ubuntu 24.04 기반 Docker 환경에서 실행되고 있습니다.
• Windows 폴더에서 바로 작업하면 실행 경로와 편집 경로가 달라질 수 있습니다.
• 그래서 앞으로는 WSL Ubuntu 내부 경로를 기준 작업공간으로 사용하는 것을 권장합니다.

2. 기준 작업 경로

• 사용자: hyunho
• 프로젝트 경로: /home/hyunho/projects/mh-dashboard-organization

3. VS Code에서 여는 방법

1. VS Code 명령 팔레트를 엽니다.
2. Remote-WSL: Reopen Folder in WSL 를 실행합니다.
3. 아래 경로를 엽니다.
   • /home/hyunho/projects/mh-dashboard-organization
4. 좌측 아래 상태 표시줄에 WSL: Ubuntu-24.04 가 보이면 정상입니다.

4. 앞으로의 작업 규칙

• 코드 수정은 가능하면 WSL 경로 기준으로 진행합니다.
• Docker 실행, Python 실행, 배포 테스트도 WSL 안에서 진행합니다.
• Windows 경로는 참고용 또는 백업용으로만 보고, 실행 기준으로 사용하지 않는 것이 좋습니다.

5. 자주 쓰는 명령

cd /home/hyunho/projects/mh-dashboard-organization
docker compose ps
docker compose logs backend
docker compose up -d

6. 현재 확인 가능한 주소

• 메인 화면: http://localhost:8080
• API 상태 확인: http://localhost:8080/api/health