refactor(backend): reorganize domains into Core, Commerce, Ticketing and Shared

app/Shared/Integration/Services/BaseIntegrationService.php

@@ -0,0 +1,180 @@
+<?php
+
+namespace App\Domains\Integration\Services;
+
+use App\Domains\Client\Models\Client;
+use App\Domains\Integration\Models\ClientIntegration;
+use App\Domains\Integration\Models\Integration;
+use App\Domains\Integration\Models\IntegrationInstance;
+use App\Domains\Integration\Models\AdminWebsiteTypeIntegration;
+use App\Domains\Tenant\Models\Tenant;
+use Exception;
+use Illuminate\Http\Client\PendingRequest;
+use Illuminate\Support\Facades\Http;
+
+abstract class BaseIntegrationService
+{
+    /**
+     * The unique code of the integration.
+     */
+    protected string $integrationCode;
+
+    /**
+     * The current tenant code.
+     */
+    protected string $tenantCode;
+
+    protected ?Tenant $tenant = null;
+
+    protected ?Client $clientContext = null;
+
+    /**
+     * The integration model instance.
+     */
+    protected ?Integration $integration = null;
+
+    /**
+     * The effective integration instance.
+     */
+    protected ?IntegrationInstance $integrationInstance = null;
+
+    /**
+     * Set the integration code.
+     *
+     * @return $this
+     */
+    public function setIntegrationCode(string $integrationCode): self
+    {
+        $this->integrationCode = $integrationCode;
+
+        return $this;
+    }
+
+    /**
+     * Get the integration code.
+     */
+    public function getIntegrationCode(): string
+    {
+        return $this->integrationCode;
+    }
+
+    /**
+     * Set the tenant code and load the integration models.
+     *
+     * @return $this
+     *
+     * @throws Exception
+     */
+    public function forTenant(string $tenantCode): self
+    {
+        $this->tenantCode = $tenantCode;
+        $this->tenant = Tenant::query()->with('client')->where('codigo', $tenantCode)->firstOrFail();
+        $this->clientContext = $this->tenant->client;
+        $this->loadIntegration();
+
+        return $this;
+    }
+
+    public function forClient(Client|string $client): self
+    {
+        $this->clientContext = $client instanceof Client
+            ? $client
+            : Client::query()->where('code', $client)->firstOrFail();
+        $this->tenant = null;
+        $this->loadIntegration();
+
+        return $this;
+    }
+
+    /**
+     * Load the integration definition and its effective instance configuration.
+     *
+     * @throws Exception
+     */
+    protected function loadIntegration(): void
+    {
+        if (empty($this->integrationCode)) {
+            throw new Exception('Integration code is not set.');
+        }
+
+        $this->integrationInstance = null;
+        $this->integration = Integration::where('integration_code', $this->integrationCode)->first();
+        if (! $this->integration) {
+            throw new Exception("Integration with code '{$this->integrationCode}' not found.");
+        }
+
+        if (! $this->clientContext) {
+            throw new Exception('Client context is not set.');
+        }
+
+        $this->integrationInstance = ClientIntegration::with('integrationInstance')->where('client_id', $this->clientContext->id)
+            ->where('integration_code', $this->integrationCode)
+            ->first()?->integrationInstance;
+
+        if (! $this->integrationInstance && $this->tenant?->admin_website_type_code) {
+            $this->integrationInstance = AdminWebsiteTypeIntegration::with('integrationInstance')
+                ->where('admin_website_type_code', $this->tenant->admin_website_type_code)
+                ->where('integration_code', $this->integrationCode)
+                ->first()?->integrationInstance;
+        }
+
+        if (! $this->integrationInstance && $this->integration->requires_configuration) {
+            throw new Exception("Client '{$this->clientContext->code}' does not have integration '{$this->integrationCode}' configured.");
+        }
+    }
+
+    /**
+     * Build the request URL.
+     *
+     * @throws Exception
+     */
+    public function getUrl(string $path = ''): string
+    {
+        if (! $this->integration) {
+            throw new Exception('Integration is not loaded. Call forTenant() or forClient() first.');
+        }
+
+        $baseUrl = rtrim($this->integration->url, '/');
+        $path = ltrim($path, '/');
+
+        return $path !== '' ? "{$baseUrl}/{$path}" : $baseUrl;
+    }
+
+    /**
+     * Get an integration setting from the effective instance configuration.
+     */
+    protected function getIntegrationSetting(string $key, mixed $default = null): mixed
+    {
+        if (! $this->integrationInstance || ! $this->integrationInstance->integration_data) {
+            return $default;
+        }
+
+        return $this->integrationInstance->integration_data[$key] ?? $default;
+    }
+
+    /**
+     * Get a pre-configured HTTP client builder.
+     *
+     * @throws Exception
+     */
+    public function client(): PendingRequest
+    {
+        return Http::baseUrl($this->getUrl())
+            ->withHeaders($this->getHeaders());
+    }
+
+    /**
+     * Get the headers for the integration.
+     */
+    abstract public function getHeaders(): array;
+
+    /**
+     * Hook called after the integration is configured for the client.
+     * Can be used to validate credentials or perform initial setups.
+     * Throw an Exception on failure.
+     */
+    public function onSetup(): void
+    {
+        // Override in child classes if needed
+    }
+}