Files
sam-api/app/Services/MenuBootstrapService.php

292 lines
10 KiB
PHP
Raw Permalink Normal View History

<?php
namespace App\Services;
use App\Models\Commons\GlobalMenu;
use App\Models\Commons\Menu;
use Illuminate\Support\Facades\DB;
/**
* 테넌트를 위한 기본 메뉴 생성 서비스
*/
class MenuBootstrapService
{
/**
* 글로벌 메뉴 템플릿을 테넌트에 복제
*
* - 활성화된 글로벌 메뉴만 복제 (is_active=1)
* - global_menu_id로 원본 추적 가능
* - is_customized=0 (원본 상태)
*
* @param int $tenantId 테넌트 ID
* @return array 생성된 메뉴 ID 목록
*/
public static function cloneGlobalMenusForTenant(int $tenantId): array
{
return DB::transaction(function () use ($tenantId) {
// 1. 활성화된 글로벌 템플릿 메뉴 조회 (global_menus 테이블에서)
$templateMenus = GlobalMenu::where('is_active', true) // 활성화된 메뉴만 복사
->orderByRaw('COALESCE(parent_id, 0)')
->orderBy('sort_order')
->get();
// 2. parent_id 매핑 테이블 생성 (글로벌 ID → 테넌트 ID)
$idMapping = [];
$menuIds = [];
// 3. 계층 순서대로 복제 (parent → child)
foreach ($templateMenus as $template) {
// parent가 복제되지 않은 경우 (비활성 부모) 건너뛰기
if ($template->parent_id && ! isset($idMapping[$template->parent_id])) {
continue;
}
$newMenu = Menu::create([
'tenant_id' => $tenantId,
'parent_id' => $template->parent_id
? ($idMapping[$template->parent_id] ?? null)
: null,
'global_menu_id' => $template->id, // 원본 글로벌 메뉴 ID 저장
'name' => $template->name,
'url' => $template->url,
'icon' => $template->icon,
'sort_order' => $template->sort_order,
'is_active' => $template->is_active,
'hidden' => $template->hidden,
'is_customized' => false, // 원본 상태
'is_external' => $template->is_external,
'external_url' => $template->external_url,
]);
// 4. ID 매핑 저장
$idMapping[$template->id] = $newMenu->id;
$menuIds[] = $newMenu->id;
}
return $menuIds;
});
}
/**
* 특정 글로벌 메뉴를 테넌트에 복제 (단일)
*
* @param int $globalMenuId 글로벌 메뉴 ID
* @param int $tenantId 테넌트 ID
* @param int|null $newParentId 복제 부모 메뉴 ID (테넌트 메뉴)
* @return Menu|null 생성된 테넌트 메뉴 (이미 복제된 경우 null)
*/
public static function cloneSingleMenu(int $globalMenuId, int $tenantId, ?int $newParentId = null): ?Menu
{
// 이미 복제된 메뉴인지 확인
$exists = Menu::withoutGlobalScopes()
->where('tenant_id', $tenantId)
->where('global_menu_id', $globalMenuId)
->exists();
if ($exists) {
return null;
}
// 글로벌 메뉴 조회 (global_menus 테이블에서)
$globalMenu = GlobalMenu::find($globalMenuId);
if (! $globalMenu) {
return null;
}
// 테넌트 메뉴로 복제
return Menu::create([
'tenant_id' => $tenantId,
'parent_id' => $newParentId,
'global_menu_id' => $globalMenu->id,
'name' => $globalMenu->name,
'url' => $globalMenu->url,
'icon' => $globalMenu->icon,
'sort_order' => $globalMenu->sort_order,
'is_active' => $globalMenu->is_active,
'hidden' => $globalMenu->hidden,
'is_customized' => false,
'is_external' => $globalMenu->is_external,
'external_url' => $globalMenu->external_url,
]);
}
/**
* 글로벌 메뉴와 하위 메뉴를 모두 테넌트에 복제 (재귀)
*
* @param int $globalMenuId 글로벌 메뉴 ID
* @param int $tenantId 테넌트 ID
* @param int|null $newParentId 복제 부모 메뉴 ID
* @return array 생성된 메뉴 ID 목록
*/
public static function cloneMenuWithChildren(int $globalMenuId, int $tenantId, ?int $newParentId = null): array
{
return DB::transaction(function () use ($globalMenuId, $tenantId, $newParentId) {
$menuIds = [];
// 1. 루트 메뉴 복제
$rootMenu = self::cloneSingleMenu($globalMenuId, $tenantId, $newParentId);
if (! $rootMenu) {
return $menuIds;
}
$menuIds[] = $rootMenu->id;
// 2. 하위 메뉴 재귀 복제 (global_menus 테이블에서)
$children = GlobalMenu::where('parent_id', $globalMenuId)
->where('is_active', true)
->orderBy('sort_order')
->get();
foreach ($children as $child) {
$childIds = self::cloneMenuWithChildren($child->id, $tenantId, $rootMenu->id);
$menuIds = array_merge($menuIds, $childIds);
}
return $menuIds;
});
}
/**
* 테넌트를 위한 기본 메뉴 구조 생성 (구버전 - 하위 호환성 유지)
*
* @deprecated Use cloneGlobalMenusForTenant() instead
*
* @param int $tenantId 테넌트 ID
* @return array 생성된 메뉴 ID 목록
*/
public static function createDefaultMenus(int $tenantId): array
{
return DB::transaction(function () use ($tenantId) {
$menuIds = [];
// 1. 대시보드 (최상위)
$dashboard = Menu::create([
'tenant_id' => $tenantId,
'parent_id' => null,
'name' => '대시보드',
'url' => '/dashboard',
'is_active' => 1,
'sort_order' => 1,
'hidden' => 0,
'is_external' => 0,
'icon' => 'dashboard',
]);
$menuIds[] = $dashboard->id;
// 2. 기초정보관리 (최상위)
$baseInfo = Menu::create([
'tenant_id' => $tenantId,
'parent_id' => null,
'name' => '기초정보관리',
'url' => '',
'is_active' => 1,
'sort_order' => 2,
'hidden' => 0,
'is_external' => 0,
'icon' => 'folder',
]);
$menuIds[] = $baseInfo->id;
// 2-1. 제품 관리 (기초정보관리 하위)
$product = Menu::create([
'tenant_id' => $tenantId,
'parent_id' => $baseInfo->id,
'name' => '제품 관리',
'url' => '/base/product/lists',
'is_active' => 1,
'sort_order' => 1,
'hidden' => 0,
'is_external' => 0,
'icon' => 'inventory',
]);
$menuIds[] = $product->id;
// 2-2. 거래처 관리 (기초정보관리 하위)
$client = Menu::create([
'tenant_id' => $tenantId,
'parent_id' => $baseInfo->id,
'name' => '거래처 관리',
'url' => '/base/client/lists',
'is_active' => 1,
'sort_order' => 2,
'hidden' => 0,
'is_external' => 0,
'icon' => 'business',
]);
$menuIds[] = $client->id;
// 2-3. 모델 및 BOM관리 (기초정보관리 하위)
$bom = Menu::create([
'tenant_id' => $tenantId,
'parent_id' => $baseInfo->id,
'name' => '모델 및 BOM관리',
'url' => '/base/bom/lists',
'is_active' => 1,
'sort_order' => 3,
'hidden' => 0,
'is_external' => 0,
'icon' => 'assignment',
]);
$menuIds[] = $bom->id;
// 3. 시스템 관리 (최상위)
$system = Menu::create([
'tenant_id' => $tenantId,
'parent_id' => null,
'name' => '시스템 관리',
'url' => '',
'is_active' => 1,
'sort_order' => 3,
'hidden' => 0,
'is_external' => 0,
'icon' => 'settings',
]);
$menuIds[] = $system->id;
// 3-1. 사용자 관리 (시스템 관리 하위)
$user = Menu::create([
'tenant_id' => $tenantId,
'parent_id' => $system->id,
'name' => '사용자 관리',
'url' => '/system/user/lists',
'is_active' => 1,
'sort_order' => 1,
'hidden' => 0,
'is_external' => 0,
'icon' => 'people',
]);
$menuIds[] = $user->id;
// 3-2. 권한 관리 (시스템 관리 하위)
$permission = Menu::create([
'tenant_id' => $tenantId,
'parent_id' => $system->id,
'name' => '권한 관리',
'url' => '/system/permission/lists',
'is_active' => 1,
'sort_order' => 2,
'hidden' => 0,
'is_external' => 0,
'icon' => 'lock',
]);
$menuIds[] = $permission->id;
// 3-3. 부서 관리 (시스템 관리 하위)
$department = Menu::create([
'tenant_id' => $tenantId,
'parent_id' => $system->id,
'name' => '부서 관리',
'url' => '/system/department/lists',
'is_active' => 1,
'sort_order' => 3,
'hidden' => 0,
'is_external' => 0,
'icon' => 'corporate_fare',
]);
$menuIds[] = $department->id;
return $menuIds;
});
}
feat: 파일 저장 시스템 DB 마이그레이션 - enhance_files_table: 이중 파일명 시스템 (display_name/stored_name), 폴더 관리, 문서 연결 지원 - create_folders_table: 동적 폴더 관리 시스템 (tenant별 커스터마이징 가능) - 5개 stub 마이그레이션 생성 (file_share_links, file_deletion_logs, storage_usage_history, add_storage_columns_to_tenants) - FolderSeeder stub 생성 - CURRENT_WORKS.md에 Phase 1 진행상황 문서화 fix: 파일 공유 및 삭제 기능 버그 수정 - ShareLinkRequest: PATH 파라미터 {id}를 file_id로 자동 병합 - routes/api.php: 공유 링크 다운로드를 auth.apikey 그룹 밖으로 이동 (인증 불필요) - FileShareLink: File, Tenant 클래스 import 추가 - File 모델: softDeleteFile()에서 SoftDeletes의 delete() 메서드 사용 - FileStorageService: getTrash(), restoreFile(), permanentDelete()에서 onlyTrashed() 사용 - File 모델: Tenant 네임스페이스 수정 (App\Models\Tenants\Tenant) refactor: Swagger 문서 정리 - File 태그를 Files로 통합 - FileApi.php의 모든 태그를 Files로 변경 - 구 파일 시스템 라우트 삭제 (prefix 'file') - 구 FileController.php 삭제 - 신규 파일 저장소 시스템으로 완전 통합 fix: 모든 legacy 파일 컬럼 nullable 일괄 처리 - 5개 legacy 컬럼을 한 번에 nullable로 변경 * original_name, file_name, file_name_old (string) * fileable_id, fileable_type (polymorphic) - foreach 루프로 반복 작업 자동화 - 신규/기존 시스템 간 완전한 하위 호환성 확보 fix: legacy 파일 컬럼 nullable 처리 완료 - file_name, file_name_old 컬럼도 nullable로 변경 - 기존 시스템과 신규 시스템 간 완전한 하위 호환성 확보 - Legacy: original_name, file_name, file_name_old (nullable) - New: display_name, stored_name (required) fix: original_name 컬럼 nullable 처리 - original_name을 nullable로 변경하여 하위 호환성 유지 - 새 시스템에서는 display_name 사용, 기존 시스템은 original_name 사용 가능 fix: 파일 업로드 DB 컬럼 누락 및 메시지 구조 개선 - files 테이블에 감사 컬럼 추가 (created_by, updated_by, uploaded_by) - ApiResponse::handle() 메시지 로직 개선 (접미사 제거) - 다국어 지원을 위한 완성된 문장 구조 유지 - FileUploadRequest 파일 검증 규칙 수정 fix: 파일 저장소 버그 수정 및 신규 테넌트 폴더 자동 생성 - FolderSeeder 네임스페이스 수정 (App\Models\Tenant → App\Models\Tenants\Tenant) - FileStorageController use 문 구문 오류 수정 (/ → \) - TenantObserver에 신규 테넌트 기본 폴더 자동 생성 로직 추가 - 5개 기본 폴더 (생산관리, 품질관리, 회계, 인사, 일반) - 에러 처리 및 로깅 - 회원가입 시 자동 실행
2025-11-10 19:08:56 +09:00
}