sam-api/lang/en/error.php

<?php

declare(strict_types=1);

/**
 * System/Domain error messages (client-facing, fixed strings)
 * - Not DB-driven
 * - Used in global handler/service exceptions
 * - Example: throw new NotFoundHttpException(__('error.not_found'));
 */
return [

    // 4xx Common
    'not_found'        => 'The requested URI or data was not found.', // 404
    'tenant_id'        => 'No active tenant is set.',                 // 400 (Service::tenantId() missing)
    'unauthenticated'  => 'Authentication failed.',                   // 401
    'forbidden'        => 'You do not have permission for this request.', // 403
    'bad_request'      => 'Invalid request.',                         // 400

    // Validation / Parameters
    'validation_failed' => 'Request data validation failed.',         // 422
    'missing_parameter' => 'A required parameter is missing.',        // 400

    // Resource-specific (optional, with :resource placeholder)
    'not_found_resource' => ':resource could not be found.',          // 404

    // Business rules
    'duplicate'       => 'Duplicate data exists.',
    'conflict'        => 'The request conflicts with the current state.', // 409
    'state_invalid'   => 'The current state does not allow this operation.', // 400/409

    // Server errors
    'server_error'    => 'An internal server error occurred.',        // 5xx

    // Estimate related errors
    'estimate' => [
        'cannot_delete_sent_or_approved' => 'Cannot delete estimates that have been sent or approved.',
        'invalid_status_transition' => 'Cannot change status from the current state.',
    ],

    // BOM template related
    'bom_template' => [
        'not_found' => 'No applicable BOM template found.',
    ],

    // Model set related
    'modelset' => [
        'has_dependencies' => 'Cannot delete due to associated products or subcategories.',
    ],

    // Settings management related
    'settings' => [
        'field_not_found' => 'Field setting not found.',
        'option_group_not_found' => 'Option group not found.',
        'common_code_duplicate' => 'Duplicate common code exists.',
        'invalid_field_type' => 'Invalid field type.',
    ],

    // Materials management related
    'materials' => [
        'not_found' => 'Material information not found.',
        'duplicate_code' => 'Duplicate material code.',
        'in_use_cannot_delete' => 'Cannot delete material that is currently in use.',
    ],

    // File management related
    'file' => [
        'not_found' => 'File not found.',
        'upload_failed' => 'File upload failed.',
        'invalid_file_type' => 'Invalid file type.',
        'file_too_large' => 'File size is too large.',
    ],

    // Client group related
    'duplicate_code' => 'Duplicate group code.',
    'has_clients' => 'Cannot delete the client group because it has associated clients.',
    'code_exists_in_deleted' => 'The same code exists in deleted data. Please permanently delete that code first or use a different code.',

];