Perso

<h1>VeloFleet</h1><p>SaaS de gestion de flotte et de locations de vélos pour professionnels du cycle premium.</p><h2>🎯 Présentation</h2><p><strong>VeloFleet</strong> est une plateforme multi-tenant destinée aux loueurs de vélos professionnels. Elle couvre l'ensemble du cycle de vie d'une location, de la maintenance à la comptabilité.</p><h3>Fonctionnalités principales</h3><ul><li><p><strong>Flotte</strong> : CRUD vélos, catégories, statuts (disponible, en location, en maintenance, hivernage), compteur de locations, seuil maintenance, saison hivernale</p></li><li><p><strong>Locations</strong> : Réservations, check-in/check-out, grille d'inspection (départ + retour), caution, frais de retard, annulation</p></li><li><p><strong>Tarification</strong> : Grille 3D (catégorie × classe × durée), saisons tarifaires à coefficient, règles de réduction, TVA multi-pays</p></li><li><p><strong>Clients</strong> : Fichier client, historique, documents</p></li><li><p><strong>Maintenance</strong> : Déclaration, affectation, packs, opérations, remise en service avec photo obligatoire, ordres de réparation imprimables, travaux supplémentaires, devis internes</p></li><li><p><strong>Comptabilité</strong> : Suivi des coûts, injection OR, historique financier</p></li><li><p><strong>Dashboard</strong> : KPIs opérationnels, rapport fin de journée, résumé des incidents</p></li><li><p><strong>Multi-site</strong> : Gestion de plusieurs sites par tenant</p></li><li><p><strong>Multi-tenant</strong> : Isolation complète des données, onboarding guidé</p></li></ul><h2>🛠️ Stack technique</h2><h3>Backend</h3><ul><li><p>Langage : PHP 8.4 (strict_types, classes final)</p></li><li><p>Framework : Laravel 12</p></li><li><p>Base de données : PostgreSQL 15 (AWS RDS)</p></li><li><p>Cache / Queue : Redis</p></li><li><p>Authentification : Keycloak (OAuth2 / OIDC)</p></li><li><p>Paiements : Stripe</p></li><li><p>Stockage fichiers : Google Cloud Storage (GCS)</p></li><li><p>Architecture : DDD Modulaire — 13 Bounded Contexts</p></li><li><p>Patterns : CQRS-like, Domain Events, Repository, Single Action Controllers</p></li><li><p>Qualité : PHPStan niveau 8, PHPCS PSR-12, Pest (tests unitaires)</p></li></ul><h3>Frontend</h3><ul><li><p>Framework : React 18 + TypeScript</p></li><li><p>Build : Vite + TanStack Router</p></li><li><p>State / Data : TanStack Query v5</p></li><li><p>UI : Tailwind CSS + shadcn/ui, Lucide React</p></li><li><p>Mobile : PWA (Progressive Web App)</p></li></ul><h3>Infrastructure</h3><ul><li><p>Déploiement : Docker / GCP App Runner</p></li><li><p>Reverse proxy : Nginx</p></li><li><p>CI/CD : GitHub Actions</p></li><li><p>Monitoring : AWS CloudWatch</p></li></ul><h2>🏗️ Architecture</h2><h3>Bounded Contexts (13 modules)</h3><p>src/</p><ul><li><p>Auth/ — Authentification, rôles, permissions</p></li><li><p>Fleet/ — Vélos, catégories, saison hivernale, compteur</p></li><li><p>Rental/ — Locations, inspection check-in/retour, cautions</p></li><li><p>Customer/ — Clients, documents</p></li><li><p>Pricing/ — Grille tarifaire, saisons, réductions, TVA</p></li><li><p>Maintenance/ — Interventions, OR, packs, remise en service</p></li><li><p>Accounting/ — Comptabilité, coûts, injection financière</p></li><li><p>Dashboard/ — KPIs, statistiques, rapport fin de journée</p></li><li><p>Incident/ — Incidents et signalements</p></li><li><p>Contract/ — Contrats de location</p></li><li><p>Subscription/ — Abonnements SaaS</p></li><li><p>Tenant/ — Multi-tenancy, sites, onboarding</p></li><li><p>Shared/ — Kernel partagé (EventBus, DomainEvent, Value Objects)</p></li></ul><h3>Couches DDD par module</h3><p>src/{Module}/</p><ul><li><p>Domain/ — Entités, Value Objects, interfaces — pur PHP, 0 dépendance framework</p></li><li><p>Application/ — Handlers, Commands, Queries, Responses — dépend uniquement du Domain</p></li><li><p>Infrastructure/ — Eloquent repositories, migrations, providers, adapters</p></li><li><p>Interface/ — Controllers, Requests, routes HTTP</p></li></ul><h3>Principes appliqués</h3><ul><li><p>declare(strict_types=1) partout, classes final par défaut</p></li><li><p>1 classe = 1 responsabilité, 1 fichier = 1 classe</p></li><li><p>Single Action Controllers (__invoke uniquement)</p></li><li><p>Aucune dépendance cross-module directe — communication via Domain Events</p></li><li><p>Montants en centimes HT, TVA via PricingHelper</p></li><li><p>Repository pattern : interfaces dans le Domain, implémentations Eloquent en Infrastructure</p></li></ul><h2>🚀 Installation</h2><h3>Prérequis</h3><ul><li><p>Docker &amp; Docker Compose</p></li><li><p>PHP 8.4+</p></li><li><p>Composer 2+</p></li></ul><h3>Démarrage</h3><p>git clone <a target="_blank" rel="noopener noreferrer nofollow" href="mailto:git@github.com">git@github.com</a>:fbo94/veloflott.git cd veloflott cp .env.example .env docker compose up -d composer install php artisan key:generate php artisan migrate php artisan db:seed # optionnel</p><h3>Accès aux services</h3><ul><li><p>API <a target="_blank" rel="noopener noreferrer nofollow" href="https://velofleet.localhost/api">https://velofleet.localhost/api</a> — Bearer token</p></li><li><p>Keycloak Admin <a target="_blank" rel="noopener noreferrer nofollow" href="https://keycloak.localhost:8080">https://keycloak.localhost:8080</a> — admin / admin</p></li><li><p>PostgreSQL <a target="_blank" rel="noopener noreferrer nofollow" href="http://localhost:5432">localhost:5432</a> — voir .env</p></li></ul><h2>🔐 Authentification</h2><p>VeloFleet utilise <strong>Keycloak</strong> (OAuth2 / OIDC). Le token JWT est validé à chaque requête via le middleware keycloak.</p><p>Client → GET /api/auth/authorization-url → {url, state} → Redirect vers Keycloak login ← Callback ?code=xxx&amp;state=yyy → POST /api/auth/authorize {code, state} ← {access_token, refresh_token, user} → API calls : Authorization: Bearer {token}</p><h3>Rôles</h3><ul><li><p>super_admin : Accès total multi-tenant (gestion tenants, TVA, abonnements)</p></li><li><p>admin : Accès complet au sein du tenant</p></li><li><p>manager : Gestion opérationnelle (clôture maintenance, surcharge coût)</p></li><li><p>employee : Opérations courantes (location, inspection, maintenance)</p></li></ul><h2>📡 API — Aperçu des endpoints</h2><h3>Fleet</h3><ul><li><p>GET/POST /api/fleet/bikes — Lister / Créer un vélo</p></li><li><p>PUT/DELETE /api/fleet/bikes/{id} — Modifier / Supprimer</p></li><li><p>PUT /api/fleet/bikes/{id}/reset-counter — Reset compteur de locations</p></li><li><p>PUT /api/fleet/bikes/{id}/counter-threshold — Seuil maintenance</p></li><li><p>POST /api/fleet/seasons — Ouvrir une saison hivernale</p></li><li><p>PUT /api/fleet/seasons/{id}/close — Fermer la saison</p></li></ul><h3>Rental</h3><ul><li><p>POST /api/rentals — Créer une location</p></li><li><p>PUT /api/rentals/{id}/checkin — Check-in</p></li><li><p>PUT /api/rentals/{id}/checkout — Check-out</p></li><li><p>PUT /api/rentals/{id}/complete — Clôturer</p></li><li><p>PUT /api/rental-items/{id}/inspection — Sauvegarder l'inspection (départ/retour)</p></li></ul><h3>Pricing</h3><ul><li><p>GET/PUT /api/pricing/rates — Grille tarifaire 3D</p></li><li><p>GET/POST /api/pricing/seasons — Saisons tarifaires</p></li><li><p>GET /api/tax-rates — Taux de TVA (lecture ouverte)</p></li><li><p>POST/PUT/DELETE /api/tax-rates — Gestion TVA (super_admin)</p></li></ul><h3>Maintenance</h3><ul><li><p>POST /api/maintenance/maintenances — Déclarer une intervention</p></li><li><p>PUT /api/maintenance/maintenances/{id}/start — Démarrer</p></li><li><p>PUT /api/maintenance/maintenances/{id}/return-to-service — Remise en service + photo</p></li><li><p>POST /api/maintenance/maintenances/{id}/repair-order — Générer un OR</p></li><li><p>PUT /api/repair-orders/{id}/close — Clôturer l'OR</p></li></ul><h2>🧪 Tests</h2><p># Tous les tests docker compose exec php vendor/bin/pest # Un module spécifique docker compose exec php vendor/bin/pest tests/Unit/Rental/ # Analyse statique PHPStan niveau 8 docker compose exec php vendor/bin/phpstan analyse src --level=8 # Vérification du style PHPCS docker compose exec php vendor/bin/phpcs --standard=PSR12 src</p><h2>🔧 Commandes utiles</h2><p># Shell dans le container PHP docker compose exec php bash # Migrations docker compose exec php php artisan migrate docker compose exec php php artisan migrate:fresh --seed # Vider les caches docker compose exec php php artisan cache:clear docker compose exec php php artisan config:clear docker compose exec php php artisan route:clear # Créer un super admin docker compose exec php php artisan app:create-super-admin # Sync des rôles Keycloak docker compose exec php php artisan app:sync-keycloak-roles</p><h2>📋 Qualité &amp; Conventions</h2><h3>Checklist avant PR</h3><ul><li><p>phpstan analyse --level=8 → aucune erreur</p></li><li><p>phpcs --standard=PSR12 → aucune erreur</p></li><li><p>Tests unitaires du use case présents (pest)</p></li><li><p>Aucune dépendance cross-module directe</p></li><li><p>Montants en centimes, pas en euros</p></li><li><p>Pas de dd() / var_dump() oubliés</p></li></ul><h3>Commits (Conventional Commits)</h3><p>feat(module): [VEL-XXX] description fix(module): description refactor(module): description test(module): description</p><h2>🗺️ Roadmap</h2><h3>✅ Livré</h3><ul><li><p>Auth Keycloak, rôles, permissions multi-niveaux</p></li><li><p>CRUD flotte complet (vélos, catégories, tailles, marques)</p></li><li><p>Locations complètes (réservation → check-in → retour → facturation)</p></li><li><p>Grille d'inspection départ + retour avec détection dégradations</p></li><li><p>Tarification 3D + saisons tarifaires + réductions + TVA</p></li><li><p>Maintenance complète (déclaration, packs, opérations, OR imprimables)</p></li><li><p>Remise en service avec photo obligatoire + timer d'intervention</p></li><li><p>Travaux supplémentaires + validation manager</p></li><li><p>Devis internes + clôture OR + injection comptabilité</p></li><li><p>Saison hivernale (hivernage/déhibernage automatique de la flotte)</p></li><li><p>Compteur de locations par vélo + seuil maintenance</p></li><li><p>Dashboard KPIs + rapport fin de journée</p></li><li><p>Multi-tenant + Multi-site</p></li><li><p>Cautions Stripe, frais de retard, annulations</p></li></ul><h3>🔜 En cours / À venir</h3><ul><li><p>Notifications manager (email/push) sur remise en service</p></li><li><p>Stock pièces détachées + alertes seuil</p></li><li><p>Sous-traitance maintenance (prestataires externes)</p></li><li><p>Application mobile hors-ligne (VEL-124-128)</p></li><li><p>Contrats de location sur tablette</p></li><li><p>KPIs opérationnels avancés (MTTR, taux de panne)</p></li><li><p>Export ERP / comptabilité</p></li><li><p>Module Marketing &amp; Fidélité (parrainage, NPS, campagnes)</p></li></ul><h2>📄 Licence</h2><p>Propriétaire — Tous droits réservés.</p>

Application de gestion de flotte de vélos

https://github.com/fbo94/veloflott

DevOps

Domain Driven Design

Software Craftsmanship

Velofleet

Lead Developer / Solution architect

Projet : sécurisation et unification de l’authentification sur une plateforme B2C à dominante B2B.  

Prise en main et évolution d’un backend **PHP 8.3** déjà en production : corrections, réduction de la dette technique, amélioration des performances et de la lisibilité du code.  

Mise en place d’un **SSO centralisé avec Keycloak** : design IAM, configuration des realms / clients / rôles, implémentation des flux **OAuth2 / OpenID Connect** et des tokens **JWT** pour sécuriser les APIs, le front web et le back‑office.  

Migration progressive des anciens mécanismes d’authentification (sessions PHP, tokens maison, ACL dispersées) vers Keycloak, avec maintien de la compatibilité et limitation de l’impact pour les utilisateurs finaux.  

Intégration de Keycloak dans l’écosystème Symfony : adaptation des couches de sécurité, stratégie d’autorisations **RBAC** orientée comptes entreprise, gestion du cycle de vie des tokens.  

Industrialisation des déploiements via **Docker** et amélioration des pipelines **CI/CD** existants (** GitHub Actions**) : build, tests automatisés, quality checks et déploiements multi-environnements.  

Travail quotidien au sein d’une équipe (devs, QA, PO) : participation aux ateliers métiers, challenge des besoins, revues de code, diffusion de bonnes pratiques et renforcement de la couverture de tests sur les briques critiques.

Francis Boudo

Lead Developer / Solution architect

À propos

Expérience de travail

Backend senior developer

Tech lead web

Responsable applicatif

Senior php backend developer

Développeur back-end

Développeur back-end

Developpeur PHP Symfony

Developpeur php symfony

Développeur php

Développeur PHP

Portfolio

Velofleet

Perso

Talents

Recruteurs

À propos