Étude de cas
Une plateforme configurable pour les communautés privées. Walking Club en est la première configuration ; les adhésions, événements, réservations, paiements et opérations organisateur sont des fonctions communes de la plateforme.
Problème
Les organisateurs géraient candidatures, accès, événements, paiements et communication dans plusieurs outils. Vif fournit une source de vérité unique pour les adhésions et les réservations, avec des informations d’événement protégées et des contrôles explicites.
Mon travail
J’ai implémenté le modèle métier, le schéma et les migrations PostgreSQL, les handlers et workers Go, l’interface rendue côté serveur, les composants TypeScript, les intégrations, les contrôles de déploiement et les tests automatisés.
Implémentation
Vif est un monolithe Go modulaire avec un accès direct à PostgreSQL via pgx. Les pages sont rendues côté serveur ; de petits Web Components TypeScript ajoutent les interactions nécessaires. Keycloak fournit l’identité OIDC. Une outbox transactionnelle sort les notifications du chemin de requête, et Stripe Sandbox reste isolé derrière la frontière de paiement.
Frontières transactionnelles
Les états d’adhésion, d’événement et de réservation restent dans PostgreSQL et évoluent dans des transactions explicites. La concurrence et les retours arrière restent lisibles, au prix de davantage de SQL et de coordination métier qu’avec un ORM.
Confirmation du paiement
Un retour navigateur réussi n’accorde jamais un droit payé. Seul un webhook Stripe dont la signature est vérifiée, enregistré puis appliqué de façon idempotente peut modifier l’accès. La confirmation peut être moins immédiate, mais un callback dupliqué ou falsifié ne crée pas de droit.
Gestion des erreurs
Vif laisse l’inscription en attente au lieu de faire confiance à l’URL de retour. Une réconciliation bornée signale qu’un événement fournisseur semble manquer sans appliquer son contenu. L’organisateur peut demander à Stripe de le renvoyer ; seul le nouveau webhook signé ferme le signalement et fait avancer l’état.
Vérification