프로젝트 온보딩 가이드

이 문서는 새로운 개발자(또는 AI Agent)가 LENSNARA SCM 프로젝트에 합류할 때 가장 먼저 읽어야 할 가이드입니다.

1. 프로젝트 한눈에 보기

LENSNARA SCM은 다채널 이커머스 공급망 관리 시스템입니다.

• 핵심 원칙: "SCM은 쇼핑몰의 주문서만 수집하고, 재고의 기준은 SCM을 따른다"
• 판매 채널: 미쯔노, 센스매니아, 지니 (3개)
• Admin URL: http://192.168.1.80/admin
• 관리자 테스트 계정: [email protected] / dock2030
• 문서 허브: http://192.168.1.80/plan

2. 필수 읽기 문서 (순서대로)

1. 이 문서 — 프로젝트 개요
2. 시스템 아키텍처 가이드 — 코드 구조, 서비스 로직
3. 데이터베이스 ERD — 테이블 구조, 관계
4. REST API 규격서 — 외부 연동 API
5. 프로젝트 현황 보고서 — 완료/미완료 기능
6. v1 초기 기획서 — 원본 기획서 (참고용)

3. 개발 환경

버전 조회일: 2026-02-19

프로젝트 경로

# 소스 코드
/home/lensnara/git/lensnara_scm/

# Nginx 설정
/etc/nginx/sites-enabled/

# 주요 설정 파일
.env                         # 환경 변수
bootstrap/app.php            # 미들웨어, 예외, 라우팅
bootstrap/providers.php      # 서비스 프로바이더
GEMINI.md / CLAUDE.md        # AI 에이전트용 가이드라인

4. 자주 쓰는 명령어

# 캐시 전체 클리어
php artisan optimize:clear

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

# 테스트 실행
php artisan test --compact

# 특정 테스트만
php artisan test --compact --filter=testName

# 코드 포매팅
./vendor/bin/pint --dirty

# Tinker (DB 직접 조회)
php artisan tinker

5. 핵심 코드 진입점

6. 작업 시 반드시 지켜야 할 규칙

PO 승인이 필요한 작업

• 새 패키지 추가/제거 (composer/npm)
• DB 스키마 변경 (마이그레이션)
• 인증/권한/결제 영향 영역
• 기술 스택 버전 변경

코드 규칙

• 수정 범위 엄수: 지시된 기능만 수정, 주변 리팩토링 금지
• 한국어: 모든 설명, 주석은 한국어
• PHP 8.5: 최신 문법 활용 (typed properties, match, enums)
• Eloquent: DB:: 대신 Model::query() 사용
• 테스트: 모든 변경은 PHPUnit으로 검증

Docker 안전 규칙 (Docker 환경일 경우)

• 코드 수정 후 docker-compose down 금지 (Hot Reload 사용)
• DB 컨테이너에 down -v 절대 금지

7. 현재 미완료 작업 (Phase 10)

우선순위별로 다음 작업이 남아있습니다:

자세한 내용은 프로젝트 현황 보고서를 참고하세요.