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

110 lines
2.4 KiB
PHP
Raw Normal View History

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
<?php
namespace App\Services;
use App\Models\Folder;
class FolderService extends Service
{
/**
* Get all folders for tenant
*/
public function index(): \Illuminate\Database\Eloquent\Collection
{
return Folder::where('tenant_id', $this->tenantId())
->ordered()
->get();
}
/**
* Get active folders only
*/
public function getActiveFolders(): \Illuminate\Database\Eloquent\Collection
{
return Folder::where('tenant_id', $this->tenantId())
->active()
->ordered()
->get();
}
/**
* Get folder by ID
*/
public function show(int $id): Folder
{
return Folder::where('tenant_id', $this->tenantId())->findOrFail($id);
}
/**
* Create new folder
*/
public function store(array $data): Folder
{
$data['tenant_id'] = $this->tenantId();
$data['created_by'] = $this->apiUserId();
// Auto-increment display_order if not provided
if (! isset($data['display_order'])) {
$maxOrder = Folder::where('tenant_id', $this->tenantId())->max('display_order') ?? 0;
$data['display_order'] = $maxOrder + 1;
}
return Folder::create($data);
}
/**
* Update folder
*/
public function update(int $id, array $data): Folder
{
$folder = $this->show($id);
$data['updated_by'] = $this->apiUserId();
$folder->update($data);
return $folder->fresh();
}
/**
* Delete folder (set inactive)
*/
public function destroy(int $id): Folder
{
$folder = $this->show($id);
// Check if folder has files
if ($folder->files()->count() > 0) {
throw new \Exception(__('error.folder_has_files'));
}
$folder->update([
'is_active' => false,
'updated_by' => $this->apiUserId(),
]);
return $folder;
}
/**
* Reorder folders
*/
public function reorder(array $orders): array
{
$folders = [];
foreach ($orders as $order) {
$folder = Folder::where('tenant_id', $this->tenantId())
->findOrFail($order['id']);
$folder->update([
'display_order' => $order['display_order'],
'updated_by' => $this->apiUserId(),
]);
$folders[] = $folder->fresh();
}
return $folders;
}
}