Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This commit is contained in:
@@ -0,0 +1,30 @@
|
||||
<?php
|
||||
|
||||
namespace Technical\Integrations\Contracts;
|
||||
|
||||
use Carbon\CarbonInterface;
|
||||
use Functional\Users\Models\User;
|
||||
use Technical\Integrations\Models\Integration;
|
||||
|
||||
/**
|
||||
* Contrat que doit implémenter toute future couche fournisseur (functional/strava,
|
||||
* functional/garmin, ...) pour se brancher sur la couche technical/integrations,
|
||||
* sans que celle-ci n'ait besoin de connaître le fournisseur.
|
||||
*/
|
||||
interface ActivityProvider
|
||||
{
|
||||
/** Clé unique du fournisseur, ex "strava" (sert d'identifiant dans le registre et la colonne "provider"). */
|
||||
public function key(): string;
|
||||
|
||||
/** Libellé humain du fournisseur, ex "Strava". */
|
||||
public function label(): string;
|
||||
|
||||
/** URL d'autorisation OAuth vers laquelle rediriger l'utilisateur pour connecter son compte. */
|
||||
public function connectUrl(User $user): string;
|
||||
|
||||
/** Traite le retour du flow OAuth (callback) et crée/met à jour l'intégration correspondante. */
|
||||
public function handleCallback(User $user, array $payload): Integration;
|
||||
|
||||
/** Récupère les activités du fournisseur pour une intégration donnée, depuis une date optionnelle. */
|
||||
public function fetchActivities(Integration $integration, ?CarbonInterface $since = null): iterable;
|
||||
}
|
||||
@@ -0,0 +1,24 @@
|
||||
<?php
|
||||
|
||||
namespace Technical\Integrations\Enums;
|
||||
|
||||
/**
|
||||
* État d'une intégration (compte connecté chez un fournisseur externe).
|
||||
* Stocké en base comme string ("no-db-enums") : le cast Eloquent fait le lien avec ce PHP enum.
|
||||
*/
|
||||
enum IntegrationStatus: string
|
||||
{
|
||||
case Connected = 'connected';
|
||||
case Revoked = 'revoked';
|
||||
case Error = 'error';
|
||||
|
||||
/** Libellé court, utilisé le temps qu'aucune traduction dédiée ne soit nécessaire. */
|
||||
public function label(): string
|
||||
{
|
||||
return match ($this) {
|
||||
self::Connected => 'Connecté',
|
||||
self::Revoked => 'Révoqué',
|
||||
self::Error => 'Erreur',
|
||||
};
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,53 @@
|
||||
<?php
|
||||
|
||||
namespace Technical\Integrations\Models;
|
||||
|
||||
use Functional\Users\Models\User;
|
||||
use Illuminate\Database\Eloquent\Attributes\UseFactory;
|
||||
use Illuminate\Database\Eloquent\Factories\HasFactory;
|
||||
use Illuminate\Database\Eloquent\Model;
|
||||
use Illuminate\Database\Eloquent\Relations\BelongsTo;
|
||||
use Technical\Integrations\Database\Factories\ExternalActivityFactory;
|
||||
|
||||
/**
|
||||
* Activité importée depuis un fournisseur externe (course, sortie vélo, etc.), rattachée
|
||||
* à l'intégration qui l'a récupérée. Couche générique : "provider" et "type" restent des strings
|
||||
* libres propres au fournisseur, jamais de référence en dur.
|
||||
*
|
||||
* @property string $provider
|
||||
* @property string $external_id
|
||||
* @property string $type
|
||||
* @property \Illuminate\Support\Carbon $started_at
|
||||
* @property int|null $duration_seconds
|
||||
* @property float|null $distance_meters
|
||||
* @property int|null $calories
|
||||
* @property array|null $raw
|
||||
*/
|
||||
#[UseFactory(ExternalActivityFactory::class)]
|
||||
class ExternalActivity extends Model
|
||||
{
|
||||
use HasFactory;
|
||||
|
||||
protected $fillable = [
|
||||
'integration_id', 'user_id', 'provider', 'external_id', 'type', 'started_at',
|
||||
'duration_seconds', 'distance_meters', 'calories', 'raw',
|
||||
];
|
||||
|
||||
protected $casts = [
|
||||
'started_at' => 'datetime',
|
||||
'duration_seconds' => 'integer',
|
||||
'distance_meters' => 'decimal:2',
|
||||
'calories' => 'integer',
|
||||
'raw' => 'array',
|
||||
];
|
||||
|
||||
public function integration(): BelongsTo
|
||||
{
|
||||
return $this->belongsTo(Integration::class);
|
||||
}
|
||||
|
||||
public function user(): BelongsTo
|
||||
{
|
||||
return $this->belongsTo(User::class);
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,59 @@
|
||||
<?php
|
||||
|
||||
namespace Technical\Integrations\Models;
|
||||
|
||||
use Functional\Users\Models\User;
|
||||
use Illuminate\Database\Eloquent\Attributes\UseFactory;
|
||||
use Illuminate\Database\Eloquent\Factories\HasFactory;
|
||||
use Illuminate\Database\Eloquent\Model;
|
||||
use Illuminate\Database\Eloquent\Relations\BelongsTo;
|
||||
use Illuminate\Database\Eloquent\Relations\HasMany;
|
||||
use Technical\Integrations\Database\Factories\IntegrationFactory;
|
||||
use Technical\Integrations\Enums\IntegrationStatus;
|
||||
|
||||
/**
|
||||
* Compte connecté d'un utilisateur chez un fournisseur externe (Garmin/Strava/...).
|
||||
* Couche générique : ne référence jamais un fournisseur en dur, seulement sa clé (provider).
|
||||
*
|
||||
* @property string $provider
|
||||
* @property string|null $external_user_id
|
||||
* @property string|null $access_token
|
||||
* @property string|null $refresh_token
|
||||
* @property \Illuminate\Support\Carbon|null $token_expires_at
|
||||
* @property array|null $scopes
|
||||
* @property IntegrationStatus $status
|
||||
* @property \Illuminate\Support\Carbon $connected_at
|
||||
* @property \Illuminate\Support\Carbon|null $last_synced_at
|
||||
* @property array|null $meta
|
||||
*/
|
||||
#[UseFactory(IntegrationFactory::class)]
|
||||
class Integration extends Model
|
||||
{
|
||||
use HasFactory;
|
||||
|
||||
protected $fillable = [
|
||||
'user_id', 'provider', 'external_user_id', 'access_token', 'refresh_token',
|
||||
'token_expires_at', 'scopes', 'status', 'connected_at', 'last_synced_at', 'meta',
|
||||
];
|
||||
|
||||
protected $casts = [
|
||||
'access_token' => 'encrypted',
|
||||
'refresh_token' => 'encrypted',
|
||||
'token_expires_at' => 'datetime',
|
||||
'scopes' => 'array',
|
||||
'status' => IntegrationStatus::class,
|
||||
'connected_at' => 'datetime',
|
||||
'last_synced_at' => 'datetime',
|
||||
'meta' => 'array',
|
||||
];
|
||||
|
||||
public function user(): BelongsTo
|
||||
{
|
||||
return $this->belongsTo(User::class);
|
||||
}
|
||||
|
||||
public function externalActivities(): HasMany
|
||||
{
|
||||
return $this->hasMany(ExternalActivity::class);
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,33 @@
|
||||
<?php
|
||||
|
||||
namespace Technical\Integrations\Providers;
|
||||
|
||||
use Technical\Integrations\Database\Seeders\IntegrationsSeeder;
|
||||
use Technical\Integrations\Support\ProviderRegistry;
|
||||
use Xefi\LaravelOSDD\LayerServiceProvider;
|
||||
|
||||
class IntegrationsServiceProvider extends LayerServiceProvider
|
||||
{
|
||||
public function boot(): void
|
||||
{
|
||||
if ($this->app->runningInConsole()) {
|
||||
$this->loadMigrationsFrom(__DIR__ . '/../../database/migrations');
|
||||
$this->loadSeeders([IntegrationsSeeder::class]);
|
||||
}
|
||||
|
||||
$this->withRouting(
|
||||
web: __DIR__ . '/../../routes/web.php',
|
||||
api: __DIR__ . '/../../routes/api.php',
|
||||
commands: __DIR__ . '/../../routes/console.php',
|
||||
channels: __DIR__ . '/../../routes/channels.php',
|
||||
);
|
||||
}
|
||||
|
||||
public function register(): void
|
||||
{
|
||||
// Singleton partagé : une future couche fournisseur (functional/strava, functional/garmin, ...)
|
||||
// récupère ce même registre via app(ProviderRegistry::class)->register(new SonProvider(...))
|
||||
// dans son propre boot(), sans jamais modifier cette couche technical/integrations.
|
||||
$this->app->singleton(ProviderRegistry::class, fn () => new ProviderRegistry());
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,52 @@
|
||||
<?php
|
||||
|
||||
namespace Technical\Integrations\Support;
|
||||
|
||||
use Technical\Integrations\Contracts\ActivityProvider;
|
||||
|
||||
/**
|
||||
* Registre des fournisseurs d'activités disponibles (Garmin/Strava/...).
|
||||
* Bindé en singleton par IntegrationsServiceProvider::register().
|
||||
*
|
||||
* Pour brancher un fournisseur externe : dans le boot() de sa propre couche
|
||||
* (ex functional/strava), appeler
|
||||
* `app(ProviderRegistry::class)->register(new StravaProvider(...))`.
|
||||
* La couche technical/integrations n'a alors jamais besoin de connaître ce fournisseur.
|
||||
*/
|
||||
class ProviderRegistry
|
||||
{
|
||||
/** @var array<string, ActivityProvider> */
|
||||
private array $providers = [];
|
||||
|
||||
/** Enregistre un fournisseur dans le registre, sous sa clé (ActivityProvider::key()). */
|
||||
public function register(ActivityProvider $provider): void
|
||||
{
|
||||
$this->providers[$provider->key()] = $provider;
|
||||
}
|
||||
|
||||
/** Récupère un fournisseur par sa clé, ou null s'il n'est pas enregistré. */
|
||||
public function get(string $key): ?ActivityProvider
|
||||
{
|
||||
return $this->providers[$key] ?? null;
|
||||
}
|
||||
|
||||
/**
|
||||
* Liste de tous les fournisseurs enregistrés.
|
||||
*
|
||||
* @return array<int, ActivityProvider>
|
||||
*/
|
||||
public function all(): array
|
||||
{
|
||||
return array_values($this->providers);
|
||||
}
|
||||
|
||||
/**
|
||||
* Liste des clés de tous les fournisseurs enregistrés.
|
||||
*
|
||||
* @return array<int, string>
|
||||
*/
|
||||
public function keys(): array
|
||||
{
|
||||
return array_keys($this->providers);
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user