Vue DEV / IT — Architecture TAXIE V1

Vue technique pour IANOVATION : tout ce qu'il faut implémenter côté backend pour que le mockup devienne une app réelle

~31 endpoints REST3 WebSocket channels3 cron jobs7 tables DB5 services externes

Chiffrage backend V1 — estimation par lot

REST endpoints

9.9 j-h

WebSocket

1.5 j-h

Cron jobs

1.0 j-h

Infra + tests + déploiement

6.4 j-h

Total backend

18.8 j-h

9 400 €

Frontend (apps + déploiement)

18 j-h (9 000 €)

Total projet V1

36.8 j-h (18 400 €)

Avec buffer 20%

44.2 j-h (22 080 €)

TJM 500 € · estimations indicatives basées sur le cahier des charges V1. Bulles d'endpoints détaillées ci-dessous, hover pour la charge précise.

API REST (FastAPI)

Auth

3 endpoints

POST/auth/login0.5 j-h
Login email + mdp → JWT
POST/auth/refresh0.3 j-h
Renouveler le JWT
POST/auth/logout0.2 j-h
Invalider le refresh token
Sous-total1.0 j-h

Commandes

5 endpoints

GET/api/commandes0.5 j-h
Liste paginée + filtres ?q=&statut=&clientType=&taxiId=&date_from=&date_to=
GET/api/commandes/:id0.2 j-h
Détail d'une commande
POST/api/commandes0.3 j-h
Créer (admin ou via formulaire public)
PATCH/api/commandes/:id0.4 j-h
Modifier statut / taxiId / dateISO (drag&drop)
DELETE/api/commandes/:id0.2 j-h
Annuler une commande
Sous-total1.6 j-h

Taxis & Flotte

4 endpoints

GET/api/taxis0.2 j-h
Liste flotte avec statuts
GET/api/taxis/:id0.3 j-h
Détail taxi + courses du jour
PATCH/api/taxis/:id0.2 j-h
Mettre à jour statut (hors-service, dispo…)
GET/api/stats/flotte0.6 j-h
KPIs flotte agrégés (paramètre ?date=)
Sous-total1.3 j-h

Interventions

4 endpoints

GET/api/interventions0.3 j-h
Liste avec filtres ?statut=&priorite=
POST/api/interventions0.4 j-h
Créer une intervention (depuis admin ou cron SLA)
PATCH/api/interventions/:id0.2 j-h
Changer statut (résolu) ou priorité
DELETE/api/interventions/:id0.1 j-h
Supprimer
Sous-total1.0 j-h

Chauffeur

5 endpoints

GET/api/me/demandes0.3 j-h
Demandes en attente assignées au chauffeur connecté
POST/api/demandes/:id/accept0.3 j-h
Chauffeur accepte → commande passe en assignée
POST/api/demandes/:id/refuse0.3 j-h
Chauffeur refuse → retour au pool admin
GET/api/me/courses0.3 j-h
Mes courses du jour / historique
GET/api/me/stats0.5 j-h
Mes KPIs (semaine / mois / année)
Sous-total1.7 j-h

Notifications

3 endpoints

GET/api/notifications0.2 j-h
Mes notifs (admin ou chauffeur)
PATCH/api/notifications/:id/read0.1 j-h
Marquer lu
PATCH/api/notifications/read-all0.1 j-h
Tout marquer lu
Sous-total0.4 j-h

Société & CRUD admin

4 endpoints

GET/api/societe · PATCH /api/societe0.3 j-h
Fiche société (édition Paramètres)
POST/api/taxis · PATCH · DELETE0.4 j-h
CRUD flotte (Paramètres → Taxis)
POST/api/users · PATCH · DELETE0.7 j-h
CRUD chauffeurs + invitation Brevo (lien magique)
POST/api/clients · PATCH · DELETE0.3 j-h
CRUD clients B2B
Sous-total1.7 j-h

Public (formulaire) & Onboarding

3 endpoints

POST/api/public/commandes0.6 j-h
Création depuis formulaire web (captcha required)
GET/api/public/captcha-config0.1 j-h
Site key reCAPTCHA pour le front public
POST/api/onboarding/bootstrap0.5 j-h
Wizard onboarding → crée société + taxis + chauffeurs + clients en 1 transaction
Sous-total1.2 j-h

WebSocket — Push temps réel

WS
/ws/notifications
Push notifs admin (nouvelle commande, alerte SLA, intervention créée)
0.7 j-h
WS
/ws/demandes/:chauffeurId
Push notifs chauffeur (demande assignée, modif horaire, annulation)
0.5 j-h
WS
/ws/planning
Live updates planning (drag&drop d'un autre user, statut change)
0.3 j-h

Cron jobs

*/5 * * * *
SLA 2h check
0.5 j-h
Si commande en-attente depuis > 2h → crée intervention prise-en-charge + notif admin
0 3 * * *
Backup Postgres
0.2 j-h
Dump nightly → /root/nova-backups/ (cron existant VPS)
0 0 * * 1
Reset stats hebdo
0.3 j-h
Snapshot des KPIs chauffeur de la semaine S-1 pour comparaison

Backend — autre infrastructure

Sous-total : 6.4 j-h

Modèle de données + migrations Alembic1 j-h
Auth JWT middleware + RBAC (admin/chauffeur)0.8 j-h
Audit log middleware0.3 j-h
Setup FastAPI + Postgres Docker0.8 j-h
Tests API (pytest, ~30 tests)1.5 j-h
Brevo SMTP wrapper + templates HTML0.7 j-h
FCM client + tokens management0.5 j-h
Déploiement VPS + CI/CD0.8 j-h

Services externes

Firebase Cloud Messaging (FCM)

Notifs push iOS+Android (chauffeurs)

💰 Gratuit jusqu'à 1M messages/mois

Brevo (ex-Sendinblue) SMTP

Mails transactionnels (confirmation commande, alertes)

💰 Gratuit < 300 mails/jour

reCAPTCHA v3

Anti-spam formulaire public

💰 Gratuit jusqu'à 1M req/mois

Twilio / Vapi.ai (V3)

Numéro vocal + assistant IA — pour V3, hors V1

💰 ~0,05€/min vocal + $0,07/min IA

OpenAI / Anthropic API (V2)

Agent IA mail (parsing) — pour V2, hors V1

💰 ~$0,01 par mail traité

Base de données — Postgres 16

Table	Colonnes
users	id, email, password_hash, role, name, phone, taxi_id?, active, created_at
taxis	id, numero, plaque, vignette, statut
clients	id, type, nom, contact_email, contact_phone, adresse
commandes	id, reference, client_id, prise_en_charge, destination, date_iso, passagers, bagages, vol?, taxi_id?, statut, created_at, updated_at
interventions	id, commande_id, taxi_id?, type, titre, description, statut, priorite, created_at
notifications	id, user_id, type, titre, description, lu, dateISO
audit_log	id, user_id, action, entity, entity_id, payload_json, ts

Dépendances par écran

Admin / Planning (Jour / Semaine / Mois)
- •GET /api/commandes?date_from&date_to (filtré selon la vue)
- •PATCH /api/commandes/:id { taxiId, dateISO } (drag&drop)
- •WS /ws/planning (live updates)
- •GET /api/taxis (4 taxis principaux affichés en colonnes)
Admin / Commandes
- •GET /api/commandes?q=&statut=&clientType=&page=
- •PATCH /api/commandes/:id (modal détail)
- •POST /api/audit_log (auto via middleware backend)
Admin / Taxis
- •GET /api/taxis
- •GET /api/stats/flotte?date=
- •PATCH /api/taxis/:id (changement statut hors-service)
Admin / Interventions
- •GET /api/interventions?statut=
- •POST /api/interventions (modal créer)
- •PATCH /api/interventions/:id (marquer résolue)
- •WS /ws/notifications (push si SLA 2h trigger)
Chauffeur / Accueil
- •GET /api/me/demandes
- •WS /ws/demandes/:chauffeurId
- •POST /api/demandes/:id/accept | refuse
- •FCM push (nouvelle demande)
Chauffeur / Agenda
- •GET /api/me/courses?date=
Chauffeur / Historique
- •GET /api/me/courses?statut=&q=
Chauffeur / Statistiques
- •GET /api/me/stats?period=week|month|year
Formulaire public
- •GET /api/public/captcha-config
- •POST /api/public/commandes (validation captcha côté serveur)
- •Brevo SMTP (mail confirmation client)

Stack frontend (déjà en place dans le mockup)

Next.js 16

App Router + Server Components

React 19

Hooks + Suspense

Tailwind 4

Design tokens + utilities

Zustand

State global + persist localStorage

lucide-react

Icônes vectorielles

PWA manifest

Installable iOS + Android

FastAPI client

À ajouter : axios ou fetch wrapper avec JWT

WebSocket client

À ajouter : socket.io ou native WS + reconnect

📄 Cahier des charges complet : DATA/PROJETS/MICK-PLATEFORME-TAXIE/00-brief/CAHIER-DES-CHARGES-BACKEND-V1.md

Chiffrage V1 reventilé : 36.8 j-h = 18 400 € HT · avec buffer 20% : 22 080 € HT · TJM 500 €

Retour mockup

Vue DEV / IT — Architecture TAXIE V1

Vue technique pour IANOVATION : tout ce qu'il faut implémenter côté backend pour que le mockup devienne une app réelle

~31 endpoints REST3 WebSocket channels3 cron jobs7 tables DB5 services externes

Chiffrage backend V1 — estimation par lot

REST endpoints

9.9 j-h

WebSocket

1.5 j-h

Cron jobs

1.0 j-h

Infra + tests + déploiement

6.4 j-h

Total backend

18.8 j-h

9 400 €

Frontend (apps + déploiement)

18 j-h (9 000 €)

Total projet V1

36.8 j-h (18 400 €)

Avec buffer 20%

44.2 j-h (22 080 €)

TJM 500 € · estimations indicatives basées sur le cahier des charges V1. Bulles d'endpoints détaillées ci-dessous, hover pour la charge précise.

API REST (FastAPI)

Auth

3 endpoints

POST/auth/login0.5 j-h
Login email + mdp → JWT
POST/auth/refresh0.3 j-h
Renouveler le JWT
POST/auth/logout0.2 j-h
Invalider le refresh token
Sous-total1.0 j-h

Commandes

5 endpoints

GET/api/commandes0.5 j-h
Liste paginée + filtres ?q=&statut=&clientType=&taxiId=&date_from=&date_to=
GET/api/commandes/:id0.2 j-h
Détail d'une commande
POST/api/commandes0.3 j-h
Créer (admin ou via formulaire public)
PATCH/api/commandes/:id0.4 j-h
Modifier statut / taxiId / dateISO (drag&drop)
DELETE/api/commandes/:id0.2 j-h
Annuler une commande
Sous-total1.6 j-h

Taxis & Flotte

4 endpoints

GET/api/taxis0.2 j-h
Liste flotte avec statuts
GET/api/taxis/:id0.3 j-h
Détail taxi + courses du jour
PATCH/api/taxis/:id0.2 j-h
Mettre à jour statut (hors-service, dispo…)
GET/api/stats/flotte0.6 j-h
KPIs flotte agrégés (paramètre ?date=)
Sous-total1.3 j-h

Interventions

4 endpoints

GET/api/interventions0.3 j-h
Liste avec filtres ?statut=&priorite=
POST/api/interventions0.4 j-h
Créer une intervention (depuis admin ou cron SLA)
PATCH/api/interventions/:id0.2 j-h
Changer statut (résolu) ou priorité
DELETE/api/interventions/:id0.1 j-h
Supprimer
Sous-total1.0 j-h

Chauffeur

5 endpoints

GET/api/me/demandes0.3 j-h
Demandes en attente assignées au chauffeur connecté
POST/api/demandes/:id/accept0.3 j-h
Chauffeur accepte → commande passe en assignée
POST/api/demandes/:id/refuse0.3 j-h
Chauffeur refuse → retour au pool admin
GET/api/me/courses0.3 j-h
Mes courses du jour / historique
GET/api/me/stats0.5 j-h
Mes KPIs (semaine / mois / année)
Sous-total1.7 j-h

Notifications

3 endpoints

GET/api/notifications0.2 j-h
Mes notifs (admin ou chauffeur)
PATCH/api/notifications/:id/read0.1 j-h
Marquer lu
PATCH/api/notifications/read-all0.1 j-h
Tout marquer lu
Sous-total0.4 j-h

Société & CRUD admin

4 endpoints

GET/api/societe · PATCH /api/societe0.3 j-h
Fiche société (édition Paramètres)
POST/api/taxis · PATCH · DELETE0.4 j-h
CRUD flotte (Paramètres → Taxis)
POST/api/users · PATCH · DELETE0.7 j-h
CRUD chauffeurs + invitation Brevo (lien magique)
POST/api/clients · PATCH · DELETE0.3 j-h
CRUD clients B2B
Sous-total1.7 j-h

Public (formulaire) & Onboarding

3 endpoints

POST/api/public/commandes0.6 j-h
Création depuis formulaire web (captcha required)
GET/api/public/captcha-config0.1 j-h
Site key reCAPTCHA pour le front public
POST/api/onboarding/bootstrap0.5 j-h
Wizard onboarding → crée société + taxis + chauffeurs + clients en 1 transaction
Sous-total1.2 j-h

WebSocket — Push temps réel

WS
/ws/notifications
Push notifs admin (nouvelle commande, alerte SLA, intervention créée)
0.7 j-h
WS
/ws/demandes/:chauffeurId
Push notifs chauffeur (demande assignée, modif horaire, annulation)
0.5 j-h
WS
/ws/planning
Live updates planning (drag&drop d'un autre user, statut change)
0.3 j-h

Cron jobs

*/5 * * * *
SLA 2h check
0.5 j-h
Si commande en-attente depuis > 2h → crée intervention prise-en-charge + notif admin
0 3 * * *
Backup Postgres
0.2 j-h
Dump nightly → /root/nova-backups/ (cron existant VPS)
0 0 * * 1
Reset stats hebdo
0.3 j-h
Snapshot des KPIs chauffeur de la semaine S-1 pour comparaison

Backend — autre infrastructure

Sous-total : 6.4 j-h

Modèle de données + migrations Alembic1 j-h
Auth JWT middleware + RBAC (admin/chauffeur)0.8 j-h
Audit log middleware0.3 j-h
Setup FastAPI + Postgres Docker0.8 j-h
Tests API (pytest, ~30 tests)1.5 j-h
Brevo SMTP wrapper + templates HTML0.7 j-h
FCM client + tokens management0.5 j-h
Déploiement VPS + CI/CD0.8 j-h

Services externes

Firebase Cloud Messaging (FCM)

Notifs push iOS+Android (chauffeurs)

💰 Gratuit jusqu'à 1M messages/mois

Brevo (ex-Sendinblue) SMTP

Mails transactionnels (confirmation commande, alertes)

💰 Gratuit < 300 mails/jour

reCAPTCHA v3

Anti-spam formulaire public

💰 Gratuit jusqu'à 1M req/mois

Twilio / Vapi.ai (V3)

Numéro vocal + assistant IA — pour V3, hors V1

💰 ~0,05€/min vocal + $0,07/min IA

OpenAI / Anthropic API (V2)

Agent IA mail (parsing) — pour V2, hors V1

💰 ~$0,01 par mail traité

Base de données — Postgres 16

Table	Colonnes
users	id, email, password_hash, role, name, phone, taxi_id?, active, created_at
taxis	id, numero, plaque, vignette, statut
clients	id, type, nom, contact_email, contact_phone, adresse
commandes	id, reference, client_id, prise_en_charge, destination, date_iso, passagers, bagages, vol?, taxi_id?, statut, created_at, updated_at
interventions	id, commande_id, taxi_id?, type, titre, description, statut, priorite, created_at
notifications	id, user_id, type, titre, description, lu, dateISO
audit_log	id, user_id, action, entity, entity_id, payload_json, ts

Dépendances par écran

Admin / Planning (Jour / Semaine / Mois)
- •GET /api/commandes?date_from&date_to (filtré selon la vue)
- •PATCH /api/commandes/:id { taxiId, dateISO } (drag&drop)
- •WS /ws/planning (live updates)
- •GET /api/taxis (4 taxis principaux affichés en colonnes)
Admin / Commandes
- •GET /api/commandes?q=&statut=&clientType=&page=
- •PATCH /api/commandes/:id (modal détail)
- •POST /api/audit_log (auto via middleware backend)
Admin / Taxis
- •GET /api/taxis
- •GET /api/stats/flotte?date=
- •PATCH /api/taxis/:id (changement statut hors-service)
Admin / Interventions
- •GET /api/interventions?statut=
- •POST /api/interventions (modal créer)
- •PATCH /api/interventions/:id (marquer résolue)
- •WS /ws/notifications (push si SLA 2h trigger)
Chauffeur / Accueil
- •GET /api/me/demandes
- •WS /ws/demandes/:chauffeurId
- •POST /api/demandes/:id/accept | refuse
- •FCM push (nouvelle demande)
Chauffeur / Agenda
- •GET /api/me/courses?date=
Chauffeur / Historique
- •GET /api/me/courses?statut=&q=
Chauffeur / Statistiques
- •GET /api/me/stats?period=week|month|year
Formulaire public
- •GET /api/public/captcha-config
- •POST /api/public/commandes (validation captcha côté serveur)
- •Brevo SMTP (mail confirmation client)

Stack frontend (déjà en place dans le mockup)

Next.js 16

App Router + Server Components

React 19

Hooks + Suspense

Tailwind 4

Design tokens + utilities

Zustand

State global + persist localStorage

lucide-react

Icônes vectorielles

PWA manifest

Installable iOS + Android

FastAPI client

À ajouter : axios ou fetch wrapper avec JWT

WebSocket client

À ajouter : socket.io ou native WS + reconnect

📄 Cahier des charges complet : DATA/PROJETS/MICK-PLATEFORME-TAXIE/00-brief/CAHIER-DES-CHARGES-BACKEND-V1.md

Chiffrage V1 reventilé : 36.8 j-h = 18 400 € HT · avec buffer 20% : 22 080 € HT · TJM 500 €