Files
sam-docs/quickstart/dev-commands.md
kent 66eac6b39f docs: [문서정리] 전체 문서 업데이트 및 admin→mng 전환 반영
- Phase 1-3: 핵심/보조 문서 업데이트, 버전 최신화
- Phase 4: 오래된 파일 정리 및 아카이브
  - D0.8 Storyboard → history/2025-12/ 이동
  - admin 참조 4개 파일 수정 (docker-setup, git-conventions, project-launch-roadmap, remote-work-setup)
  - 빈 디렉토리 6개 삭제
- 버전 정보: React 19.2.1, Next.js 15.5.7
- remote-work-setup.md DEPRECATED 표시
2025-12-26 16:47:36 +09:00

3.6 KiB

개발 명령어 모음

업데이트: 2025-12-26


MNG Application (mng/)

개발 서버

# 개별 서비스
php artisan serve                    # Laravel server
npm run dev                          # Vite dev server (Tailwind)

테스트

composer test
php artisan test

코드 품질

./vendor/bin/pint          # PHP CS Fixer (포맷팅)

API Application (api/)

개발 서버

# 모든 서비스 동시 실행
composer dev

데이터베이스

# 마이그레이션 상태 확인
php artisan migrate:status

# 마이그레이션 실행
php artisan migrate

# 마이그레이션 롤백
php artisan migrate:rollback --step=N

# 기존 DB에서 마이그레이션 생성
php artisan migrate:generate

API 문서

# Swagger 문서 재생성
php artisan l5-swagger:generate

# 접근
# - Swagger UI: http://api.sam.kr/api-docs/index.html
# - JSON Spec: http://api.sam.kr/docs/api-docs.json

개발 도구

# IDE Helper
php artisan ide-helper:generate
php artisan ide-helper:models

# 코드 포맷팅
./vendor/bin/pint

스케줄러

# 스케줄러 작업 목록 확인
php artisan schedule:list

# 스케줄러 즉시 실행 (테스트)
php artisan schedule:run

# 특정 커맨드 실행
php artisan audit:prune
php artisan sanctum:prune-expired --hours=24

Frontend (front/www/)

CodeIgniter 3

# PHP 의존성 설치
composer install

# 개발 서버
php -S localhost:8080

# Note: front/_Codeigniter/에 CI3 시스템 파일
# Main application은 front/www/ 디렉토리

공통 (Build & Assets)

Frontend Assets

# Production build
npm run build

# Development with hot reload
npm run dev

# 개별 디렉토리
cd mng && npm run build
cd api && npm run build
cd react && npm run build

Git

상태 확인

# 현재 브랜치 및 변경사항
git status

# 브랜치 목록
git branch

# 변경 내용 확인
git diff

커밋

# 변경사항 스테이징
git add .

# 커밋
git commit -m "type: message"

# 커밋 로그
git log --oneline -10

Docker

서비스 관리

# Docker 서비스 시작
docker-compose up -d

# Docker 서비스 중지
docker-compose down

# Docker 서비스 재시작
docker-compose restart

# Docker 로그 확인
docker-compose logs -f

환경 확인

PHP & Composer

# PHP 버전
php -v

# Composer 버전
composer -V

# 설치된 패키지 확인
composer show

Node & NPM

# Node 버전
node -v

# NPM 버전
npm -v

# 설치된 패키지 확인
npm list --depth=0

유용한 명령어

로그 확인

# Laravel 로그 실시간 확인
tail -f storage/logs/laravel.log

# Scheduler 로그 확인
tail -f storage/logs/scheduler.log

# Pail 사용 (Laravel 12)
php artisan pail --timeout=0

캐시 관리

# 모든 캐시 클리어
php artisan cache:clear

# 설정 캐시 클리어
php artisan config:clear

# 라우트 캐시 클리어
php artisan route:clear

# 뷰 캐시 클리어
php artisan view:clear

최적화

# Production 최적화
php artisan optimize

# Autoload 최적화
composer dump-autoload -o

트러블슈팅

권한 문제

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

의존성 재설치

# Composer
rm -rf vendor
composer install

# NPM
rm -rf node_modules
npm install

환경 초기화

# .env 파일 복사 (처음 설치 시)
cp .env.example .env

# Application key 생성
php artisan key:generate