docs: shared 모델 참조 제거 - 독립 모델 구조로 변경

This commit is contained in:
2025-11-20 16:48:22 +09:00
parent 7109fc5199
commit 3e7fd2e776

View File

@@ -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