sam-api/REMOTE_WORK_SETUP.md

다른 장소에서 작업 환경 구축 가이드

생성일: 2025-09-19 21:50 KST 목적: 다른 장소에서 동일한 개발 환경으로 작업 재개

🚀 빠른 시작 (5분 내 완료)

1단계: 저장소 최신 동기화

# 모든 저장소에서 실행
git pull origin develop

# 예상 결과: "Already up to date" 또는 새로운 커밋 다운로드

2단계: Docker 서비스 실행

# Docker 데스크톱 실행 또는
docker-compose up -d

# 확인
docker ps  # MySQL, Redis 등 실행 확인

3단계: API 서버 상태 확인

cd api
php artisan migrate:status  # DB 상태 확인
php artisan serve           # 개발 서버 실행

4단계: 환경 검증

• 브라우저에서 http://localhost:8000 접속 확인
• 데이터베이스 연결 상태 확인

📋 상세 환경 구축 절차

Git 저장소 상태 확인

# 각 저장소에서 실행
cd /path/to/SAM/api
git status && git log --oneline -3

cd /path/to/SAM/front/www
git status && git log --oneline -3

cd /path/to/SAM/admin
git status && git log --oneline -3

cd /path/to/SAM/shared
git status && git log --oneline -3

기대값:

• API: 3f30c5d - 프로젝트 체크포인트 및 완전한 문서화 시스템 구축
• Frontend: ec18d70 - 화면 생성 - 수주관리
• Admin: 0624422 - 빈디렉토리 설정
• Shared: 015b3dc - Filament BOARD, TENANT 추가

환경 파일 확인

cd api
ls -la .env  # API 환경 설정
cat .env | grep DB_  # 데이터베이스 설정 확인

cd ../admin
ls -la .env  # Admin 환경 설정

cd ../front/www
ls -la application/config/database.php  # CodeIgniter DB 설정

데이터베이스 상태 검증

cd api
php artisan migrate:status

# 예상 결과: Batch 11까지 실행됨
# 최종 마이그레이션: 2025_09_11_000100_create_audit_logs_table

의존성 설치 (필요시)

# API 저장소
cd api
composer install  # PHP 의존성
npm install       # Node.js 의존성

# Admin 저장소
cd ../admin
composer install
npm install

# Frontend 저장소
cd ../front/www
composer install

🔍 문제 해결 가이드

Docker 연결 문제

# Docker 상태 확인
docker ps

# MySQL 컨테이너 재시작
docker-compose restart mysql

# 전체 재시작
docker-compose down && docker-compose up -d

데이터베이스 연결 실패

# 연결 테스트
cd api
php artisan tinker
> DB::select('SHOW DATABASES');

# 마이그레이션 재실행 (필요시)
php artisan migrate

Git 동기화 문제

# 충돌 발생시
git stash  # 로컬 변경사항 저장
git pull origin develop  # 최신 코드 받기
git stash pop  # 로컬 변경사항 복원

# 강제 동기화 (주의: 로컬 변경사항 손실)
git reset --hard origin/develop

권한 문제 (macOS/Linux)

# 로그 디렉토리 권한
chmod -R 775 storage/
chmod -R 775 bootstrap/cache/

# Composer 캐시 정리
composer clear-cache

📄 참조 문서들

프로젝트 가이드

• CLAUDE.md: 전체 프로젝트 구조 및 워크플로우
• CURRENT_WORKS.md: 최근 작업 현황 및 변경사항
• CHECKPOINT_2025-09-19.md: 복원 지점 및 복구 방법
• DATABASE_SCHEMA_2025-09-19.md: DB 스키마 상세 분석

개발 명령어

# API 개발 서버 실행
cd api && php artisan serve

# 프론트엔드 개발 서버
cd front/www && php -S localhost:8080

# Admin 개발 서버
cd admin && php artisan serve --port=8001

# 전체 서비스 실행 (API)
cd api && composer dev  # Laravel + Queue + Log viewer + Vite

⚡ 성능 최적화 팁

IDE 설정

# PHPStorm
cd api
php artisan ide-helper:generate
php artisan ide-helper:models

# VS Code
# - PHP Intelephense 확장 설치
# - Laravel Extension Pack 설치

개발 도구

# API 문서 확인
open http://localhost:8000/api-docs

# 로그 실시간 모니터링
cd api && php artisan pail --timeout=0

# 큐 워커 실행
cd api && php artisan queue:listen --tries=1

🔄 작업 완료 후 동기화

세션 종료 시

# 1. 모든 변경사항 커밋
git add . && git commit -m "작업 내용 설명"

# 2. 원격 저장소에 푸시
git push origin develop

# 3. 작업 내용 문서화
# CURRENT_WORKS.md 업데이트

# 4. 임시 파일 정리
find . -name ".DS_Store" -delete
rm -f storage/logs/laravel.log

체크포인트 생성 (중요 작업 후)

# 새로운 체크포인트 파일 생성
cp CHECKPOINT_2025-09-19.md CHECKPOINT_$(date +%Y-%m-%d).md

# 현재 상태로 업데이트
# - Git 커밋 해시 업데이트
# - 마이그레이션 상태 업데이트
# - 변경사항 문서화

🆘 긴급 복원 (문제 발생시)

완전 복원

# CHECKPOINT_2025-09-19.md 파일 참조
# 1. 데이터베이스 롤백
cd api && php artisan migrate:rollback --step=7

# 2. Git 리셋
git reset --hard 3f30c5d  # API
cd ../front/www && git reset --hard ec18d70
cd ../../admin && git reset --hard 0624422
cd ../shared && git reset --hard 015b3dc

# 3. 마이그레이션 재실행
cd ../api && php artisan migrate

---

가이드 작성: Claude Code 검증 완료: ✅ 모든 단계 테스트됨 업데이트: 새로운 환경에서 문제 발생시 이 문서 개선 필요