StreakFit — API Laravel 13 OSDD + Octane/FrankenPHP
Build & Deploy / build (push) Successful in 18s

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This commit is contained in:
2026-07-19 03:00:17 +02:00
co-authored by Claude Opus 4.8
commit af32669931
300 changed files with 21235 additions and 0 deletions
@@ -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);
}
}