# Roadmap produit — Karbé

Cette roadmap décrit la trajectoire produit de **Karbé**, la marketplace de
location de carbets fluviaux de Guyane. Elle est organisée en trois phases :
**MVP** (premier produit utilisable de bout en bout), **V2** (montée en gamme et
expérience), **V3** (passage à l'échelle et nouveaux marchés).

> Les phases sont indicatives et sont amenées à évoluer en fonction des retours
> utilisateurs et des priorités business. Les statuts ✅ / 🚧 / ⬜ reflètent
> l'avancement au moment de la rédaction.

## Vision

Devenir **la** plateforme de référence pour la découverte et la réservation
d'hébergements fluviaux et nature en Guyane, en valorisant l'offre des hôtes
locaux et en proposant aux voyageurs (particuliers comme comités d'entreprise)
une expérience de réservation simple, fiable et sécurisée.

## Objectifs par phase

| Phase | Objectif | Public visé |
| --- | --- | --- |
| **MVP** | Réserver et payer un carbet de bout en bout. | Voyageurs particuliers + hôtes |
| **V2** | Fidéliser, fluidifier et industrialiser l'usage. | Voyageurs récurrents, hôtes pros, comités d'entreprise |
| **V3** | Passer à l'échelle et ouvrir de nouveaux usages/marchés. | Partenaires, B2B, international |

---

## Phase 1 — MVP

**But :** un voyageur peut trouver un carbet, le réserver, le payer ; un hôte
peut publier et gérer son offre. La boucle économique de base fonctionne.

### Périmètre fonctionnel

| # | Fonctionnalité | Description | Statut |
| --- | --- | --- | --- |
| 1 | Socle technique | Scaffold Next.js + TypeScript + Prisma + Tailwind. | ✅ |
| 2 | Modèle de données | Schéma Prisma complet + migrations (entités Karbé). | ✅ |
| 3 | Authentification multi-rôles | Inscription / connexion Voyageur, Hôte, Admin (NextAuth). | 🚧 |
| 4 | Interface propriétaire | CRUD des carbets + upload des photos. | 🚧 |
| 5 | Recherche & fiche publique | Listing et fiche carbet en SSR (SEO). | ⬜ |
| 6 | Réservation & disponibilités | Calendrier de dispo, sélection de dates, créneaux comités d'entreprise. | ⬜ |
| 7 | Paiement | Encaissement Stripe (réservation + abonnement loueur). | ⬜ |
| 8 | Avis & notes | Évaluation du séjour après le check-out. | ⬜ |
| 9 | Conformité | CGV, RGPD, mentions légales. | 🚧 |
| 10 | Documentation | README, roadmap, doc d'architecture. | 🚧 |

### Critères de sortie du MVP

- Un voyageur peut s'inscrire, rechercher un carbet, réserver des dates
  disponibles et payer.
- Un hôte peut publier un carbet avec photos, tarifs et calendrier.
- Les pages publiques sont indexables (SSR/SEO).
- Les obligations légales (CGV, RGPD, mentions légales) sont en place.

---

## Phase 2 — V2

**But :** améliorer l'expérience, fidéliser les utilisateurs et outiller les
hôtes professionnels et le canal B2B (comités d'entreprise).

### Pistes fonctionnelles

- **Recherche avancée** — carte interactive (fleuves/localités), filtres
  (équipements, capacité, prix, note), tri pertinent.
- **Favoris & wishlists** — exploitation du modèle de favoris pour sauvegarder
  et comparer des carbets.
- **Messagerie enrichie** — notifications (e-mail / in-app), messages
  pré-séjour et post-séjour, modèles de réponse pour les hôtes.
- **Tableau de bord hôte** — statistiques (taux d'occupation, revenus),
  gestion des paiements/payouts, politiques d'annulation paramétrables.
- **Gestion des annulations & remboursements** — règles claires côté voyageur
  et hôte, remboursements automatisés via Stripe.
- **Portail comités d'entreprise (CE)** — espace dédié, créneaux et tarifs
  négociés, facturation centralisée.
- **Modération des avis** — signalement, réponses des hôtes, contrôle qualité.
- **Synchronisation de calendrier** — import/export iCal pour éviter les
  doubles réservations.
- **Internationalisation (i18n)** — préparation multilingue (FR puis EN/PT,
  pertinent pour la zone transfrontalière Brésil/Suriname).
- **Optimisation mobile** — parcours responsive soigné, performance sur réseaux
  contraints.

### Critères de sortie de la V2

- Les hôtes pilotent leur activité depuis un tableau de bord.
- Le canal comités d'entreprise est opérationnel.
- Le taux de conversion et la rétention sont mesurés et suivis.

---

## Phase 3 — V3

**But :** passer à l'échelle, ouvrir de nouveaux usages et marchés, et
renforcer la confiance.

### Pistes fonctionnelles

- **Applications mobiles** (iOS / Android) ou PWA installable.
- **Tarification dynamique** — recommandations de prix selon la saison et la
  demande.
- **Recommandations personnalisées** — moteur de suggestions de carbets.
- **Vérification d'identité (KYC)** et label « hôte vérifié » renforcé.
- **Assurance séjour / annulation** via un partenaire.
- **Intégrations partenaires** — tour-opérateurs, transport fluvial,
  activités (pêche, randonnée, excursions).
- **Programme de fidélité** — points, parrainage, offres récurrentes.
- **API publique** — ouverture aux partenaires et revendeurs.
- **Mode hors-ligne / faible connectivité** — consultation et préparation de
  réservation adaptées aux zones isolées de Guyane.
- **Expansion géographique** — autres territoires (Antilles, Amazonie
  transfrontalière), multi-devises.

### Critères de sortie de la V3

- Présence mobile native ou PWA.
- Écosystème de partenaires intégré via API.
- Modèle économique diversifié (commissions, abonnements, partenariats).

---

## Synthèse

```text
MVP   ──▶  Réserver & payer un carbet de bout en bout
 V2   ──▶  Expérience, fidélisation, hôtes pros & comités d'entreprise
 V3   ──▶  Mobile, partenariats, API, passage à l'échelle
```

Pour le détail technique des fonctionnalités, voir
[`docs/ARCHITECTURE.md`](./docs/ARCHITECTURE.md).