From 6ba8738b71c3eb29ca52fe3ac29a3fd5b26260a6 Mon Sep 17 00:00:00 2001 From: pro Date: Fri, 30 Jan 2026 15:11:12 +0900 Subject: [PATCH] =?UTF-8?q?docs:=EA=B3=B5=EB=8F=99=20=EA=B0=9C=EB=B0=9C=20?= =?UTF-8?q?=EC=9B=8C=ED=81=AC=ED=94=8C=EB=A1=9C=EC=9A=B0=20=EA=B0=80?= =?UTF-8?q?=EC=9D=B4=EB=93=9C=20=EC=B6=94=EA=B0=80?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 로컬(Docker) 환경 업데이트 절차 - 서버 환경 업데이트 절차 - 환경별 명령어 요약 표 - pull 후 체크리스트 Co-Authored-By: Claude Opus 4.5 --- CLAUDE.md | 112 ++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 112 insertions(+) diff --git a/CLAUDE.md b/CLAUDE.md index a7b729f..292c09b 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -2,6 +2,26 @@ > 이 파일은 모든 프로젝트에 적용되는 전역 규칙입니다. +## 메모리 + +### sam설명 +SAM 프로젝트의 기술적 개요 문서입니다. 이 문서를 참조하면 SAM 프로젝트가 무엇인지 이해할 수 있습니다. + +**파일 경로**: `/home/aweso/sam/docs/SAM_PROJECT_OVERVIEW_FOR_AI.md` + +**핵심 요약**: +- **회사**: 주일/경동 (블라인드/스크린 제조업체) +- **프로젝트**: SAM (Smart Automation Management) - 차세대 ERP/MES 통합 시스템 +- **기술 스택**: Laravel 11 + HTMX + Tailwind CSS + MySQL 8.0 +- **아키텍처**: Multi-tenant (tenant_id 기반 데이터 격리) +- **레거시**: 5130.co.kr (PHP 기반) → SAM으로 마이그레이션 중 + +**사용자가 'sam설명'이라고 말하면**: +1. 위 경로의 `SAM_PROJECT_OVERVIEW_FOR_AI.md` 파일을 읽어서 전체 내용을 파악하세요 +2. SAM 프로젝트의 비즈니스 도메인, 기술 스택, 현재 작업 현황을 이해한 상태로 작업하세요 + +--- + ## Git 커밋 규칙 (최우선 필수 규칙) > **경고: 이 규칙은 절대 누락되어서는 안 됩니다!** @@ -145,3 +165,95 @@ docker exec sam-mng-1 php artisan cache:clear - [ ] `composer` 명령 → `docker exec sam-mng-1 composer` 또는 `sam-api-1` 사용 - [ ] DB 시더 실행 필요 시 → Docker를 통해 실행 - [ ] **마이그레이션은 반드시 API에서 실행** → `docker exec sam-api-1 php artisan migrate` + +--- + +## 공동 개발 워크플로우 (필수) + +> **중요: 코드를 pull 받은 후 반드시 필요한 명령을 실행하세요!** + +### 로컬 환경 (Docker) 업데이트 + +```bash +# 1. 코드 받기 (WSL에서 실행) +cd /home/aweso/sam/api +git pull + +cd /home/aweso/sam/mng +git pull + +# 2. 의존성 업데이트 (composer.json 변경 시) +docker exec sam-api-1 composer install +docker exec sam-mng-1 composer install + +# 3. DB 마이그레이션 (API에서만!) +docker exec sam-api-1 php artisan migrate + +# 4. 캐시 클리어 (설정 변경 시) +docker exec sam-api-1 php artisan config:clear +docker exec sam-mng-1 php artisan config:clear +``` + +### 서버 환경 업데이트 + +```bash +# API 프로젝트 +cd /home/webservice/api +git pull +composer install +php artisan migrate +php artisan config:clear + +# MNG 프로젝트 (마이그레이션 없음) +cd /home/webservice/mng +git pull +composer install +php artisan config:clear +``` + +### 요약 표 + +| 작업 | 로컬 (Docker) | 서버 | +|------|--------------|------| +| git pull | WSL에서 직접 | 서버에서 직접 | +| composer install | `docker exec sam-api-1 composer install` | `composer install` | +| migrate | `docker exec sam-api-1 php artisan migrate` | `php artisan migrate` | +| config:clear | `docker exec sam-api-1 php artisan config:clear` | `php artisan config:clear` | + +### 체크리스트 (pull 후) + +- [ ] API: `git pull` → `composer install` → `php artisan migrate` → `config:clear` +- [ ] MNG: `git pull` → `composer install` → `config:clear` (마이그레이션 없음) + +--- + +## 사용 가능한 Agents + +`~/.claude/agents/` 폴더에 있는 에이전트들: + +| Agent | 설명 | +|-------|------| +| `organizer-agent` | 프로젝트 구조화 및 정리 | +| `proposal-agent` | 제안서 작성 | +| `research-agent` | 리서치 및 조사 | + +--- + +## 사용 가능한 Skills + +`~/.claude/skills/` 폴더에 있는 스킬들 (슬래시 명령어로 사용): + +| Skill | 설명 | +|-------|------| +| `pptx-skill` | PowerPoint 생성 | +| `pdf-template-skill` | PDF 템플릿 분석/생성 | +| `proposal-skill` | 제안서 생성 | +| `storyboard-generator` | 스토리보드 생성 | +| `code-flow-web-report` | 코드 플로우 웹 리포트 | +| `codebase-analysis-web-report` | 코드베이스 분석 리포트 | +| `code-bug-finder` | 버그 탐지 | +| `code-refactoring` | 코드 리팩토링 | +| `uml-generator` | UML 다이어그램 생성 | +| `design-skill` | 디자인 작업 | + +**사용 방법**: `/skill-name` 형식으로 호출 (예: `/pptx-skill`)