From 3e7fd2e776cafc31f6e78ce41289b59f5d3a61fe Mon Sep 17 00:00:00 2001 From: hskwon Date: Thu, 20 Nov 2025 16:48:22 +0900 Subject: [PATCH] =?UTF-8?q?docs:=20shared=20=EB=AA=A8=EB=8D=B8=20=EC=B0=B8?= =?UTF-8?q?=EC=A1=B0=20=EC=A0=9C=EA=B1=B0=20-=20=EB=8F=85=EB=A6=BD=20?= =?UTF-8?q?=EB=AA=A8=EB=8D=B8=20=EA=B5=AC=EC=A1=B0=EB=A1=9C=20=EB=B3=80?= =?UTF-8?q?=EA=B2=BD?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- CLAUDE.md | 46 +++++++++++++++++++++------------------------- 1 file changed, 21 insertions(+), 25 deletions(-) diff --git a/CLAUDE.md b/CLAUDE.md index efcca8d..c84e6d1 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -13,8 +13,8 @@ ### Core Applications - `front/www/` - Main CodeIgniter application directory - `front/_Codeigniter/` - CodeIgniter 3 system files (extracted from www) - **5130/** - Legacy PHP application for construction/manufacturing management -- **shared/** - Common models and services package shared between applications - **docker/** - Docker configuration files +- **mng/** - MNG admin panel (Plain Laravel, DaisyUI) ### Key Features & Components - Multi-tenant architecture with tenant switching capabilities @@ -25,14 +25,13 @@ ### Key Features & Components - Category management with templates and versioning - Design workflow with version control and audit logging -### Shared Models Structure -The `shared/` directory contains common Eloquent models organized by domain: -- **Members/** - User and tenant management -- **Products/** - Product catalog and BOM structures -- **Materials/** - Material specifications and inventory -- **Orders/** - Order processing workflows -- **Tenants/** - Multi-tenant configurations -- **Commons/** - Shared utilities and common data +### Models Structure (독립 운영) +**중요**: 각 프로젝트는 독립적인 모델을 사용합니다. +- **admin/app/Models/** - Admin 프로젝트 전용 모델 (Filament 통합) +- **api/app/Models/** - API 프로젝트 전용 모델 (REST API) +- **mng/app/Models/** - MNG 프로젝트 전용 모델 (관리자 패널) + +**이전 shared/ 구조는 각 프로젝트로 이관 완료되었습니다.** ## Development Commands @@ -121,7 +120,7 @@ ## Database & Models ### Multi-tenant Data Architecture - Tenant isolation via `tenant_id` columns with BelongsToTenant global scope -- Shared models in `shared/Models/` with tenant scoping +- 각 프로젝트는 독립적인 모델 사용 (admin, api, mng) - Global admin tables for system management - Soft deletes (`deleted_at`) applied across most entities - Common audit columns: `created_by`, `updated_by`, `deleted_by` @@ -245,8 +244,8 @@ ### 1. 기능 개발 워크플로우 (Feature Development) - API 테스트 (Postman/Swagger UI) 4. Frontend 연동 - - Admin 패널 (Filament) 또는 CodeIgniter 뷰 구현 - - 필요시 공통 모델을 shared/로 이동 + - Admin 패널 (Filament) 구현 + - 각 프로젝트는 독립적인 모델 사용 5. 품질 검증 - API 테스트 실행 @@ -315,11 +314,11 @@ ### 3. 데이터베이스 변경 워크플로우 ### 4. 멀티 저장소 동기화 워크플로우 (상시 적용) ``` -작업 순서: api (백엔드) → admin (관리 UI) → front (사용자 UI) → shared (공통) +작업 순서: api (백엔드) → admin (관리 UI) → mng (MNG 관리 UI) 의존성 관리: - API 변경사항 완료 후 Frontend 작업 -- Shared 모델 변경 시 모든 저장소 동기화 +- 각 프로젝트는 독립적인 모델 사용 (동기화 불필요) - Docker 설정 변경 시 전체 재시작 통합 테스트: @@ -603,18 +602,16 @@ ### Parameter-based BOM Resolution ## Git Repository Structure & Workflow ### Multiple Repository Setup -This project uses **5 separate Git repositories** for different components: -- **api/** - API project repository -- **admin/** - Laravel admin panel repository -- **front/www/** - CodeIgniter frontend repository -- **front/_Codeigniter/** - Extracted CI3 system files repository -- **shared/** - Shared models and services (planned for future use when API is mature) +This project uses **3 separate Git repositories** for different components: +- **api/** - API project repository (독립 모델) +- **admin/** - Laravel admin panel repository (독립 모델) +- **mng/** - MNG admin panel repository (독립 모델) ### Work Tracking & Commit Workflow -1. **Work Tracking**: All ongoing work is documented in `CURRENT_WORKS.md` at the root level -2. **Progress Updates**: As features are developed, update `CURRENT_WORKS.md` with changes per repository +1. **Work Tracking**: All ongoing work is documented in `CURRENT_WORKS.md` at each repository root +2. **Progress Updates**: As features are developed, update `CURRENT_WORKS.md` with changes 3. **Commit Process**: When a feature is complete: - - Organize completed work by repository (api, admin, front/www, front/_Codeigniter, shared) + - Organize completed work by repository (api, admin, mng) - Update `CURRENT_WORKS.md` with summary of modified/added/deleted files - Create Git commits in each affected repository - If `CURRENT_WORKS.md` doesn't exist, create it and add to Git @@ -645,8 +642,7 @@ #### CURRENT_WORKS.md 파일 위치 (중요!) **⚠️ 절대 규칙: 각 저장소별 개별 CURRENT_WORKS.md 파일 생성** - ✅ `/SAM/api/CURRENT_WORKS.md` - API 저장소 작업 내용 - ✅ `/SAM/admin/CURRENT_WORKS.md` - Admin 저장소 작업 내용 -- ✅ `/SAM/front/www/CURRENT_WORKS.md` - Frontend 저장소 작업 내용 -- ✅ `/SAM/shared/CURRENT_WORKS.md` - Shared 저장소 작업 내용 +- ✅ `/SAM/mng/CURRENT_WORKS.md` - MNG 저장소 작업 내용 - ❌ `/SAM/CURRENT_WORKS.md` (루트에 저장 금지!) #### CURRENT_WORKS.md Structure