Documentation du frontend

Documentation vivante du frontend RoadTrip (Vite + Vue 3 <script setup lang="ts">), en français. Chaque page décrit l'état actuel du projet et évolue avec le code — ce n'est pas un journal de décisions : on modifie les pages en place plutôt que d'y ajouter des entrées.

Vue d'ensemble

SPA Vue 3 qui consomme l'API REST du backend Travelise RoadTrip. L'interface est portée pour le design uniquement depuis le dépôt d'inspiration .lovable-ref/ (React + shadcn/ui, en lecture seule — voir le skill inspiration-to-vue) ; aucune logique React/Supabase n'est reprise. La logique métier (données, authentification, persistance) est branchée séparément sur l'API RoadTrip.

Architecture

• Structure du projet — arborescence src/, conventions de dossiers, routeur.
• Couche API (HTTP) — client généré localement (src/api/generated/, via @hey-api/openapi-ts depuis le contrat servi par le backend), configuration, authentification.
• État applicatif (Pinia) — stores, store de session auth persisté dans localStorage.
• Routage & gardes — routes, historique web, gardes d'auth, redirection par rôle.
• Système de design — jetons @theme (Tailwind v4), primitives shadcn-vue.
• Internationalisation — vue-i18n : langues, catalogues, détection et persistance.
• Validation de formulaires — Regle : composable partagé useRegle, messages traduits via vue-i18n.
• Environnements & versionnement — bandeau staging/dev, suffixe de titre, version du build, image dédiée derrière le reverse proxy.
• Tests — Vitest, environnement jsdom, conventions de specs.

Fonctionnalités

• Authentification — écran de connexion et contrat du composant LoginForm.
• Tableau de bord super-admin — barre latérale, cockpit, sections à venir.
• Tableau de bord voyageur — barre latérale, « Mes voyages », sections à venir.
• Tableau de bord région — portail « gestionnaire » (casquette organisation region), vue d'ensemble, sections à venir.
• Tableau de bord revendeur — portail revendeur (casquette organisation reseller), vue d'ensemble, sections à venir.
• Mon profil — section profil partagée par tous les portails (consultation et édition du profil de l'utilisateur connecté).

Contributors

No contributors

Changelog

No recent changes