<?php
/**
 * Core TenantResolver Class
 *
 * @version     1.0.$Revision:$
 * @version     SVN: $Id:$
 * @package     bplan-base/globals
 * @subpackage  MultiTenancy
 * @author      Wassilios Meletiadis <wassilios.meletiadis@bplan-solutions.de>
 * @copyright   Copyright (C) 2025, 2026 bplan-solutions GmbH & Co. KG <https://www.bplan-solutions.de/>
 * /Δ\
 */

namespace BplanBase\Globals\MultiTenancy;


use BplanBase\Globals\Models\Tenant;
use BplanBase\Globals\Models\User;
use BplanBase\Globals\Repositories\Core\TenantLocaleRepository;
use BplanBase\Globals\Repositories\Core\TenantRepository;
use Illuminate\Database\Eloquent\ModelNotFoundException;
use Illuminate\Http\Request;
use InvalidArgumentException;
use Symfony\Component\HttpKernel\Exception\AccessDeniedHttpException;


/**
 * Core TenantResolver Class
 *
 * @version     1.2.0 / 2026-04-14
 * @author      Wassilios Meletiadis <wassilios.meletiadis@bplan-solutions.de>
 */
class CoreApiTenantInitializer
{


/* +++ TRAITS +++ +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ */


/* +++ CLASS CONSTANTS +++ ++++++++++++++++++++++++++++++++++++++++++++++++++ */


/* +++ OBJECT MEMBERS +++ +++++++++++++++++++++++++++++++++++++++++++++++++++ */


    /**
     * @var     string|null
     */
    private string|null $_configTenant;


    /**
     * @var     Request
     */
    private Request $_Request;


    /**
     * @var     bool
     */
    private bool $_singleTenantMode;


    /**
     * @var     User
     */
    private User $_User;


/* +++ CLASS MEMBERS +++ ++++++++++++++++++++++++++++++++++++++++++++++++++++ */


/* +++ OBJECT METHODS +++ +++++++++++++++++++++++++++++++++++++++++++++++++++ */


    /**
     *
     * @param       Request $Request
     *
     * @param       User $User
     *
     * @version     1.0.0 / 2026-03-24
     * @author      Wassilios Meletiadis <wassilios.meletiadis@bplan-solutions.de>
     */
    public function __construct(Request $Request, User $User)
    {
        $this->_init($Request, $User);

    } // __construct()


    /**
     * Initialisiert Objektvariablen
     *
     * @param       Request $Request
     *
     * @param       User $User
     *
     * @return      void
     *
     * @version     1.1.0 / 2026-03-30
     * @author      Wassilios Meletiadis <wassilios.meletiadis@bplan-solutions.de>
     */
    private function _init(Request $Request, User $User): void
    {
        $this->_configTenant = config('globals.global-tenant');
        $this->_Request = $Request;
        $this->_singleTenantMode = !empty($this->_configTenant);
        $this->_User = $User;

    } // _init()


    /**
     * Aktiviert den Mandanten via Spatie und überträgt die Daten in die Registry
     *
     * Da die API stateless ist, gibt es keinen Session-Zwischenschritt.
     * Die Registry wird direkt aus dem aufgelösten Tenant-Objekt befüllt.
     *
     * @param       Tenant $Tenant
     *
     * @return      void
     *
     * @version     1.1.0 / 2026-03-30
     * @author      Wassilios Meletiadis <wassilios.meletiadis@bplan-solutions.de>
     */
    private function _initRegistry(Tenant $Tenant): void
    {
        $tenantLocales = TenantLocaleRepository::determineTenantLocales($Tenant->id);

        $Tenant->makeCurrent();

        \Registry::put('core.authCheck',       false, true);
        \Registry::put('core.masterTenantId',  $Tenant->master_id ?? null, true);
        \Registry::put('core.tenant',          $Tenant, true);
        \Registry::put('core.tenantId',        (int) $Tenant->id, true);
        \Registry::put('core.tenantLocales',   $tenantLocales ?? [1 => config('app.fallback_locale')], true);
        \Registry::put('core.user',            $this->_User);   // @todo    Ggf. Verwendung überall durch app()->user() ersetzen? Kann dort, wo ein angemeldeter User existiert, ersetzt werden. Wenn der Gast-User möglich sein könnte, dann muss die Registry verwendet werden.
        \Registry::put('core.userAccessLevel', $this->_User->access_level ?? null, true);
        \Registry::put('core.userId',          $this->_User->id, true);

    } // _initRegistry()


    /**
     * Setzt die Registry zurück
     *
     * Da die API stateless ist, gibt es keine Session die zurückgesetzt werden muss.
     *
     * @return      void
     *
     * @version     1.0.1 / 2026-04-14
     * @author      Wassilios Meletiadis <wassilios.meletiadis@bplan-solutions.de>
     */
    private function _reset(): void
    {
        \Registry::forget('core');

    } // _reset()


    /**
     * Verarbeitet den Request und initialisiert den Mandanten
     *
     * Der Request-Header "Api-Tenant-UUID" ist immer erforderlich — auch im Single-Tenant-Modus.
     * Dadurch wird sichergestellt, dass kein unkontrollierter Zugriff möglich ist, nur weil ein
     * Mandant in der Konfiguration hinterlegt ist.
     *
     * Im Single-Tenant-Modus wird der konfigurierte Mandant geladen und die übermittelte UUID
     * gegen diesen validiert. Ein Mandantenwechsel ist nicht möglich.
     *
     * Im Multi-Tenant-Modus wird der Mandant direkt per UUID ermittelt.
     *
     * In der Entwicklungsumgebung akzeptiert der Header neben der UUID auch numerische IDs
     * und Identifier, sodass keine neue UUID nach einem Migrate/Seed ausgelesen werden muss.
     *
     * @throws      InvalidArgumentException
     *
     * @throws      ModelNotFoundException
     *
     * @throws      AccessDeniedHttpException
     *
     * @return      void
     *
     * @version     1.1.0 / 2026-03-30
     * @author      Wassilios Meletiadis <wassilios.meletiadis@bplan-solutions.de>
     */
    public function initialize(): void
    {
        $tenantUuid = $this->_Request->header('Api-Tenant-UUID');

        if (empty($tenantUuid)) {
            throw new InvalidArgumentException('Request header [Api-Tenant-UUID] is missing.');
        }

        if ($this->_singleTenantMode === true) {
            $Tenant = TenantRepository::getByVarious($this->_configTenant, ignoreRestriction: true);

            if ($Tenant === null) {
                throw new InvalidArgumentException('Configured tenant ['.$this->_configTenant.'] not found.');
            }
            /*
            **  In der Produktionsumgebung muss die gesendete UUID exakt mit der UUID des konfigurierten
            **  Mandanten übereinstimmen.
            **
            **  In der Entwicklungsumgebung wird der gesendete Wert ebenfalls aufgelöst (UUID, ID oder
            **  Identifier möglich) und anschließend per ID verglichen. Das verhindert, dass der Entwickler
            **  nach jedem Migrate/Seed eine neue UUID ermitteln und konfigurieren muss. */
            if (config('app.env') === 'production') {
                $uuidMatches = ($Tenant->uuid === $tenantUuid);
            } else {
                $RequestedTenant = TenantRepository::getByVarious($tenantUuid, ignoreRestriction: true);
                $uuidMatches = ($RequestedTenant !== null && (int) $RequestedTenant->id === (int) $Tenant->id);
            }

            if ($uuidMatches === false) {
                $this->_reset();

                throw new AccessDeniedHttpException('Tenant UUID mismatch.');
            }
        } else {
            if (config('app.env') === 'production') {
                $Tenant = TenantRepository::getByUuid($tenantUuid, ignoreRestriction: true);
            } else {
                $Tenant = TenantRepository::getByVarious($tenantUuid, ignoreRestriction: true);
            }

            if ($Tenant === null) {
                $this->_reset();

                throw new ModelNotFoundException('Tenant ['.$tenantUuid.'] not found.');
            }
        }

        if ($Tenant->active === false) {
            $this->_reset();

            throw new AccessDeniedHttpException('Tenant ['.$Tenant->id.'] is inactive.');
        }

        $this->_initRegistry($Tenant);

    } // initialize()


/* +++ CLASS METHODS +++ ++++++++++++++++++++++++++++++++++++++++++++++++++++ */


} // class CoreApiTenantInitializer {}
