====== Sprint 7 — Extranet Propriétaire ====== ===== Objectif du Sprint ===== Mettre à disposition des propriétaires un espace sécurisé leur permettant de suivre l'activité de leurs biens en temps réel. À l'issue du Sprint 7 : * Un propriétaire dispose de son espace dédié * Il peut consulter ses biens * Il peut consulter ses réservations * Il peut suivre ses revenus * Il peut télécharger ses contrats * Il peut télécharger ses factures * Il peut exporter ses données financières Ce sprint constitue la première version du portail propriétaire. ---- ====== Périmètre ====== ===== Modules concernés ===== OwnersModule OwnerDashboardModule OwnerPropertiesModule OwnerReservationsModule OwnerRevenueModule OwnerDocumentsModule ---- ====== Workflow métier ====== Connexion ↓ Dashboard ├── Mes Biens ├── Réservations ├── Revenus ├── Documents └── Exports ---- ====== User Stories ====== ===== US-701 : Accéder à son espace propriétaire ===== **En tant que propriétaire** Je souhaite accéder à mon portail Afin de suivre l'activité de mes biens. ---- ===== Endpoint ===== GET /owner/dashboard ---- ===== Contrôle d'accès ===== ROLE_OWNER ou ROLE_ADMIN ---- ====== US-702 : Consulter le tableau de bord ====== ===== KPIs ===== Nombre de biens Nombre de réservations Revenus du mois Revenus annuels Taux d'occupation Réservations à venir ---- ===== Endpoint ===== GET /owner/dashboard/summary ---- ====== US-703 : Consulter ses biens ====== ===== Endpoint ===== GET /owner/properties ---- ===== Informations ===== Référence Titre Ville Statut Capacité Occupation ---- ====== US-704 : Consulter le détail d'un bien ====== ===== Endpoint ===== GET /owner/properties/{id} ---- ===== Informations ===== Description Galerie Disponibilités Tarifs Historique réservations ---- ====== US-705 : Consulter le calendrier ====== ===== Endpoint ===== GET /owner/properties/{id}/calendar ---- ===== Vues ===== Mensuelle Trimestrielle Annuelle ---- ===== Statuts ===== Disponible Réservé Maintenance Bloqué ---- ====== US-706 : Consulter les réservations ====== ===== Endpoint ===== GET /owner/reservations ---- ===== Filtres ===== Bien Date Statut Client ---- ===== Informations ===== Référence Client Dates Montant Statut ---- ====== US-707 : Consulter une réservation ====== ===== Endpoint ===== GET /owner/reservations/{id} ---- ===== Informations ===== Client Voyageurs Montants Contrat Paiements ---- ====== Gestion financière ====== ===== US-708 : Consulter ses revenus ====== ===== Endpoint ===== GET /owner/revenues ---- ===== KPIs ===== CA mensuel CA annuel Montants encaissés Montants en attente Revenus par bien ---- ===== Agrégations ===== Mois Trimestre Année ---- ====== US-709 : Consulter les paiements ====== ===== Endpoint ===== GET /owner/payments ---- ===== Informations ===== Réservation Date Montant Statut ---- ====== US-710 : Export financier ====== ===== Endpoint ===== GET /owner/revenues/export ---- ===== Formats ===== Excel CSV PDF ---- ====== Documents ====== ===== US-711 : Consulter les contrats ====== ===== Endpoint ===== GET /owner/contracts ---- ===== Informations ===== Référence Client Date signature Montant ---- ====== US-712 : Télécharger un contrat ====== ===== Endpoint ===== GET /owner/contracts/{id}/download ---- ====== US-713 : Consulter les factures ====== ===== Endpoint ===== GET /owner/invoices ---- ====== US-714 : Télécharger une facture ====== ===== Endpoint ===== GET /owner/invoices/{id}/download ---- ====== Modèle Prisma ====== ===== Owner ===== model Owner { id String @id @default(uuid()) userId String @unique ownerCode String @unique active Boolean createdAt DateTime @default(now()) } ---- ===== OwnerRevenueSnapshot ===== model OwnerRevenueSnapshot { id String @id @default(uuid()) ownerId String month Int year Int revenue Decimal occupancyRate Decimal } ---- ====== Architecture Backend ====== src/modules/owners ├── dashboard │ ├── properties │ ├── reservations │ ├── revenues │ ├── payments │ ├── contracts │ └── documents ---- ====== Domain Services ====== OwnerDashboardService OwnerPropertyService OwnerReservationService OwnerRevenueService OwnerDocumentService ---- ====== Événements métier ====== ===== OwnerRevenueUpdated ===== OwnerRevenueUpdated ---- ===== OwnerExportGenerated ===== OwnerExportGenerated ---- ====== Swagger ====== ===== Tags ===== Owners OwnerDashboard OwnerProperties OwnerReservations OwnerRevenues OwnerDocuments ---- ===== Volume API ===== Environ : 20 endpoints ---- ====== Frontend ====== ===== Pages ===== /owner /owner/dashboard /owner/properties /owner/properties/[id] /owner/calendar /owner/reservations /owner/revenues /owner/contracts /owner/invoices /owner/documents ---- ===== Composants ===== OwnerDashboard OwnerPropertyCard OwnerReservationTable OwnerRevenueChart OwnerDocumentLibrary OwnerExportButton ---- ====== Widgets Dashboard ====== ===== Bloc Revenus ===== CA Mois CA Année Évolution ---- ===== Bloc Réservations ===== À venir En cours Terminées ---- ===== Bloc Occupation ===== Taux occupation Par bien Global ---- ====== Tests ====== ===== Unitaires ===== OwnerDashboardService OwnerRevenueService OwnerReservationService OwnerDocumentService ---- ===== Intégration ===== Connexion propriétaire ↓ Consultation dashboard ↓ Consultation revenus ↓ Export ---- ===== E2E ===== Login ↓ Dashboard ↓ Mes biens ↓ Réservations ↓ Contrats ↓ Factures ↓ Export financier ---- ====== Définition de terminé ====== Le Sprint 7 est terminé lorsque : * Dashboard propriétaire opérationnel * Consultation biens opérationnelle * Consultation réservations opérationnelle * Revenus opérationnels * Contrats opérationnels * Factures opérationnelles * Exports opérationnels * Swagger à jour * Tests verts * CI verte ---- ====== Livrables ====== * OwnersModule * OwnerDashboardModule * OwnerPropertiesModule * OwnerReservationsModule * OwnerRevenueModule * OwnerDocumentsModule * DTO * Swagger * Tests * Migrations Prisma ---- ====== Démonstration Sprint ====== Scénario métier : 1. Connexion propriétaire 2. Consultation dashboard 3. Consultation bien 4. Consultation réservations 5. Consultation revenus 6. Consultation contrats 7. Téléchargement facture 8. Export Excel ---- ====== Bilan Release 1.1 ====== À l'issue du Sprint 7 : * MVP Client complet * Back Office opérationnel * Réservation opérationnelle * Contrats opérationnels * Paiements opérationnels * Extranet propriétaire opérationnel La plateforme couvre désormais les processus principaux de gestion locative. ---- ====== Sprint suivant ====== ===== Sprint 8 — CRM & Relation Client ===== Objectif : Outiller les équipes commerciales et administratives. Modules concernés : CRMModule LeadsModule ActivitiesModule TasksModule PipelineModule CustomerNotesModule Fonctionnalités : * Gestion des prospects * Pipeline commercial * Activités * Tâches * Notes clients * Historique interactions * Relances automatiques À l'issue du Sprint 8, l'agence disposera d'un CRM intégré directement connecté aux réservations et aux clients.