CamerMove v.0.1-beta

1. Vue d'ensemble

CamerMove est une plateforme multi-services dediee a la mobilite au Cameroun. Elle connecte les voyageurs aux transporteurs, hotels, loueurs de vehicules et prestataires de services via un seul compte et un systeme de paiement unifie (Mobile Money).

2. Architecture

2.1 Structure du monorepo

camermove/
+-- apps/
|   +-- api/           # API REST Fastify (port 3000)
|   +-- web/           # Frontend Next.js 16 (port 3002)
|   +-- worker/        # Jobs BullMQ + Consumer Kafka
+-- packages/
|   +-- config/        # Configuration Zod (loadEnv)
|   +-- db/            # Schema Prisma + repositories
|   +-- events/        # Types et producteurs Kafka
|   +-- frontend/      # Stores Zustand, hooks, API clients
|   +-- media/         # Stockage S3/MinIO
|   +-- observability/ # Prometheus + OpenTelemetry
|   +-- shared/        # Calculs financiers, BullMQ queues
+-- tests/             # Tests E2E Playwright
+-- docs/              # Documentation + screenshots
+-- infra/             # Docker Compose, Prometheus, Grafana

2.2 Principes directeurs

3. Modules (6 Services)

3.1 Transport Interurbain ACTIF

Module principal - recherche et reservation de bus interurbain.

Routes : /results → /trips/:id → /book/:tripId → /book/confirmation

API : GET /search, GET /trips/:id, POST /bookings

3.2 Hotels ACTIF

Recherche et reservation d'hebergements verifies.

Routes : /hotels → /hotels/:id → /hotels/confirmation

3.3 Location de Vehicules ACTIF

Location de vehicules avec prise en charge.

Routes : /rentals → /rentals/:id → /rentals/confirmation

3.4 Transport de Colis ACTIF

Envoi et suivi de colis entre villes.

Routes : /parcels (envoi/suivi) → /parcels/success → /parcels/track/:trackingNumber

3.5 Assurance Voyage ACTIF

Souscription assurance voyage (sante, bagages, rapatriement).

Routes : /insurance → /insurance/success

3.6 Billetterie Evenementielle ACTIF

Vente de billets pour concerts, matchs, festivals.

Routes : /events → /events/:id → /book/confirmation

4. Authentification

Systeme JWT avec 4 roles hierarchiques et refresh tokens securises.

4.1 Roles

4.2 Flux complet

4.3 Securite

• Mots de passe haches avec argon2
• Tokens JWT signe HS256, expiration 15 min
• Refresh tokens stockes en DB avec rotation (detection vol)
• Rate limiting: 5 tentatives/min sur /auth/login
• Audit logs: toutes les actions sensibles enregistrees
• Cookie SameSite=Lax (protection CSRF)

5. Workflow de Reservation (Transport)

5.1 Etapes

5.2 Diagramme

[Recherche] --> [Resultats] --> [Detail Trajet] --> [Selection Siege]
     |                                                    |
     v                                                    v
[Cache Redis]                                    [Zustand Store]
                                                       |
[Confirmation] <-- [Paiement] <-- [Hold 15min] <-- [Infos Passager]
     |
     v
[Billet QR] --> [Dashboard] --> [Email/SMS Notification]

6. Administration

Interface d'administration reservee aux roles admin et super_admin.

7. Espace Transporteur

8. Espace Partenaire

9. API REST & Swagger

L'API REST est documentee avec OpenAPI/Swagger et accessible a http://localhost:3000/docs.

Authorization: Bearer <access_token>\nContent-Type: application/json\nIdempotency-Key: <uuid>  # Pour POST/PUT/PATCH

10. Toutes les Routes (50+)

Pages publiques (30)

Pages authentifiees (3)

Pages admin (7)

11. Captures d'ecran

33 captures d'ecran generees via Playwright (Chromium, Desktop + Mobile).

Page d'accueil

Connexion

Tableau de bord

Swagger API Docs

Dashboard Admin

Menu Mobile

Toutes les captures : homepage, results, hotels, rentals, parcels, events, insurance, faq, how-it-works, legal-cgu, legal-privacy, contact, become-partner, transporter-apply, login, register, admin-login, ticket-lookup, dashboard, dashboard-bookings, dashboard-tickets, admin-dashboard, admin-users, admin-trips, admin-bookings, admin-payments, admin-transporters, admin-settings, swagger, health, mobile-homepage, mobile-login, mobile-nav

12. Base de Donnees

12.1 Modeles principaux

12.2 Index

• Trip @@index([departureAt],[price],[status],[routeId,departureAt])
• Booking @@index([userId,status],[tripId],[status,holdExpiresAt])
• Ticket @@index([bookingId],[verificationCode])

13. Evenements Kafka

14. Mises a jour & Ameliorations

14.1 Ameliorations prioritaires

14.2 Problemes connus

• /dashboard/page.tsx importe ApiError qui n'est pas exporte depuis lib/api/client.ts
• Middleware Next.js deprecie (migration vers proxy)
• WebSocket pour sieges non implemente (polling actuel)
• Mode intra-urban en developpement