Plateforme de gestion des installations sportives
Une plateforme qui centralise installations, équipements, réservations, maintenances et usagers, avec des workflows adaptés aux agents, équipes terrain et administrateurs.
Surf Web Development · Collectivité territoriale française
Cette étude de cas n’expose aucune donnée interne.
- 01WebReact 19, TanStack Query, formulaires validés par Zod
- 02APINestJS, REST, JWT, Passport et Swagger
- 03DomaineRéservations, récurrence, conflits et maintenance
- 04ServicesPostgreSQL, Prisma, email, PDF et cartographie
Problème métier
Les réservations, associations, équipements et interventions étaient répartis entre plusieurs processus. La plateforme devait prévenir les conflits de créneaux, fiabiliser les disponibilités et rendre les changements de statut traçables.
Mon rôle et ma contribution
Développeur full-stack à dominante Backend. J’ai contribué à la conception des API et du schéma de données, aux règles de réservation et maintenance, aux interfaces React ainsi qu’aux tests et au cycle de livraison.
- API NestJS structurées par domaines métier
- Modélisation Prisma des installations, créneaux, équipements et maintenances
- Règles de conflits et récurrence des réservations
- Notifications, documents PDF et contrats d’API Swagger
- Tests Jest sur les réservations, maintenances, équipements et utilisateurs
Fonctionnalités essentielles
- 01Réservations et disponibilités
- 02Détection des conflits de créneaux
- 03Gestion des installations et équipements
- 04Signalements et maintenances
- 05Notifications et documents
- 06Tableaux de bord par profil
Architecture simplifiée
- 01WebReact 19, TanStack Query, formulaires validés par Zod
- 02APINestJS, REST, JWT, Passport et Swagger
- 03DomaineRéservations, récurrence, conflits et maintenance
- 04ServicesPostgreSQL, Prisma, email, PDF et cartographie
Défi technique principal
Garantir la cohérence des réservations récurrentes et des maintenances : une série peut chevaucher un créneau, rendre une installation indisponible ou nécessiter une modification partielle sans casser l’historique.
Résultats qualitatifs
- Centralisation de plusieurs processus dans une plateforme unique
- Réduction du risque de doubles réservations par des règles explicites
- Suivi plus lisible des équipements et interventions
- Couverture automatisée de scénarios métier sensibles
Limites, confidentialité et enseignements
Le client final reste volontairement anonymisé comme collectivité territoriale française. Aucun nom, logo, URL, écran interne ou donnée d’usager n’est publié. Le diagramme présenté a été créé spécifiquement pour expliquer l’architecture.
Technologies utilisées
Frontend
- React 19
- TypeScript
- Vite
- TanStack Query
- Zod
- Radix UI
Backend
- NestJS
- Prisma
- PostgreSQL
- JWT
- Swagger
Services
- Nodemailer
- PDFKit
- MapTiler
- Recharts
Qualité
- Jest
- CI/CD
- Postman
- ESLint
- Prettier