Crealcs Development DokuWiki

Modifiez cette page et cliquez sur « Enregistrer ». Voyez le guide de mise en page pour une aide à propos du formatage. Veuillez ne modifier cette page que si vous pouvez l'améliorer. Si vous souhaitez faire des tests, faites vos premiers pas dans le bac à sable.

====== Sprint 5 — Réservations ======

===== Objectif =====

Implémenter le cœur transactionnel de la plateforme.

Ce sprint transforme la plateforme Property Management en véritable plateforme de réservation exploitable.

À l'issue du Sprint 5 :

<code>
✓ Reservation

✓ Guest

✓ Booking Workflow

✓ Check-In

✓ Check-Out

✓ Payments Integration

✓ Billing

✓ Stay Management

✓ Reservation Intelligence
</code>

----

====== Architecture cible ======

<code>
Customer

↓

Reservation

↓

Booking Workflow

↓

Payment

↓

Check-In

↓

Stay Management

↓

Check-Out

↓

Billing

↓

Analytics
</code>

----

====== Domaines métier ======

Le Sprint 5 introduit les domaines suivants :

<code>
Reservation

Guest

ReservationGuest

ReservationPayment

ReservationInvoice

ReservationTimeline

CheckIn

CheckOut

Stay

ReservationDocument
</code>

----

====== Sous-sprints ======

===== Sprint 5-A =====

Fondation Réservation

<code>
Reservation Core

Guest Management

Reservation Lifecycle

Workflow Engine
</code>

----

===== Sprint 5-B =====

Paiement & Facturation

<code>
Payment Integration

Invoices

Refunds

Transactions
</code>

----

===== Sprint 5-C =====

Check-In / Check-Out

<code>
Arrival Workflow

Departure Workflow

Digital Check-In

Stay Tracking
</code>

----

===== Sprint 5-D =====

Exploitation Séjour

<code>
Guest Requests

Incidents

Housekeeping

Maintenance
</code>

----

===== Sprint 5-E =====

Reservation Intelligence

<code>
Reservation Analytics

Fraud Detection

Booking Insights

Forecasting
</code>

----

====== Livrables fin Sprint 5 ======

<code>
Reservation Engine

Booking Workflow Engine

Payment Platform

Invoice Engine

Check-In Platform

Stay Management

Reservation Analytics

Enterprise Booking System
</code>

----

====== Sprint 5-A.1 — Implémentation Prisma Reservation Core ======

===== Objectif =====

Créer le cœur du moteur de réservation.

Cette couche constitue la fondation transactionnelle de toute la plateforme.

À l'issue de cette étape :

<code>
✓ Reservation

✓ Guest

✓ ReservationGuest

✓ Multi-tenant

✓ Property Ready

✓ Customer Ready

✓ Payment Ready

✓ Analytics Ready
</code>

----

====== Architecture cible ======

<code>
Customer

↓

Reservation

↓

ReservationGuest

↓

Guests

↓

Payments

↓

Check-In
</code>

----

====== Sprint 5-A.1-A ======

===== Extension Prisma =====

----

====== Étape 1 — Création Reservation ======

===== Ajouter dans schema.prisma =====

<code prisma>
model Reservation {

id                    String
                        @id
                        @default(uuid())

tenantId              String

propertyId            String

customerId            String

reservationNumber     String
                        @unique

status                ReservationStatus

source                ReservationSource

checkInDate           DateTime

checkOutDate          DateTime

nights                Int

adults                Int
                        @default(1)

children              Int
                        @default(0)

infants               Int
                        @default(0)

totalGuests           Int

currency              String
                        @default("EUR")

subtotalAmount        Decimal
                        @db.Decimal(12,2)

taxesAmount           Decimal
                        @db.Decimal(12,2)

feesAmount            Decimal
                        @db.Decimal(12,2)

discountAmount        Decimal
                        @db.Decimal(12,2)
                        @default(0)

totalAmount           Decimal
                        @db.Decimal(12,2)

paidAmount            Decimal
                        @db.Decimal(12,2)
                        @default(0)

notes                 String?

internalNotes         String?

confirmedAt           DateTime?

cancelledAt           DateTime?

createdAt             DateTime
                        @default(now())

updatedAt             DateTime
                        @updatedAt

tenant                Tenant
                        @relation(
                          fields:[tenantId],
                          references:[id]
                        )

property              Property
                        @relation(
                          fields:[propertyId],
                          references:[id]
                        )

customer              Customer
                        @relation(
                          fields:[customerId],
                          references:[id]
                        )

guests                ReservationGuest[]

@@index([tenantId])

@@index([propertyId])

@@index([customerId])

@@index([status])

@@index([checkInDate])

@@index([checkOutDate])

@@index([reservationNumber])
}
</code>

----

====== Étape 2 — Création Guest ======

===== Ajouter =====

<code prisma>
model Guest {

id                    String
                        @id
                        @default(uuid())

tenantId              String

firstName             String

lastName              String

email                 String?

phone                 String?

dateOfBirth           DateTime?

nationality           String?

documentType          String?

documentNumber        String?

emergencyContact      String?

emergencyPhone        String?

notes                 String?

createdAt             DateTime
                        @default(now())

updatedAt             DateTime
                        @updatedAt

tenant                Tenant
                        @relation(
                          fields:[tenantId],
                          references:[id]
                        )

reservations          ReservationGuest[]

@@index([tenantId])

@@index([email])

@@index([lastName])

@@index([documentNumber])
}
</code>

----

====== Étape 3 — Création ReservationGuest ======

===== Ajouter =====

<code prisma>
model ReservationGuest {

id                    String
                        @id
                        @default(uuid())

reservationId         String

guestId               String

isPrimaryGuest        Boolean
                        @default(false)

createdAt             DateTime
                        @default(now())

reservation           Reservation
                        @relation(
                          fields:[reservationId],
                          references:[id],
                          onDelete:Cascade
                        )

guest                 Guest
                        @relation(
                          fields:[guestId],
                          references:[id],
                          onDelete:Cascade
                        )

@@unique([
    reservationId,
    guestId
  ])

@@index([reservationId])

@@index([guestId])
}
</code>

----

====== Sprint 5-A.1-B ======

===== Enums =====

----

====== Étape 4 — ReservationStatus ======

===== Ajouter =====

<code prisma>
enum ReservationStatus {

DRAFT

PENDING

CONFIRMED

CHECKED_IN

CHECKED_OUT

COMPLETED

CANCELLED

NO_SHOW
}
</code>

----

====== Étape 5 — ReservationSource ======

===== Ajouter =====

<code prisma>
enum ReservationSource {

DIRECT

WEBSITE

MOBILE_APP

AIRBNB

BOOKING

EXPEDIA

MANUAL

API
}
</code>

----

====== Sprint 5-A.1-C ======

===== Relations Existantes =====

----

====== Étape 6 — Customer ======

===== Ajouter =====

<code prisma>
reservations Reservation[]
</code>

----

====== Étape 7 — Property ======

===== Ajouter =====

<code prisma>
reservations Reservation[]
</code>

----

====== Étape 8 — Tenant ======

===== Ajouter =====

<code prisma>
reservations Reservation[]

guests Guest[]
</code>

----

====== Sprint 5-A.1-D ======

===== Contraintes Métier =====

----

====== Étape 9 — Validation ======

===== Vérifier =====

<code>
checkInDate < checkOutDate
</code>

----

====== Étape 10 — Vérifier ======

===== Calcul automatique =====

<code>
nights

=

checkOutDate
-
checkInDate
</code>

----

====== Étape 11 — Vérifier ======

===== Calcul automatique =====

<code>
totalGuests

=

adults
+
children
+
infants
</code>

----

====== Étape 12 — Prévenir ======

===== Double réservation =====

via :

<code>
PropertyAvailability

Reservation Engine
</code>

----

====== Sprint 5-A.1-E ======

===== Indexation Enterprise =====

----

====== Étape 13 — Ajouter =====

<code prisma>
@@index([
  tenantId,
  status
])

@@index([
  propertyId,
  checkInDate
])

@@index([
  propertyId,
  checkOutDate
])

@@index([
  customerId,
  createdAt
])
</code>

----

====== Étape 14 — Recherche ======

Optimiser :

<code>
Réservation

Client

Propriété

Date

Statut
</code>

----

====== Sprint 5-A.1-F ======

===== Analytics Ready =====

----

====== Étape 15 — Préparer =====

Compatible avec :

<code>
Occupancy Analytics

Revenue Analytics

Booking Analytics

Forecasting
</code>

----

====== Étape 16 — Préparer =====

Compatible avec :

<code>
Customer Analytics

Guest Analytics

Travel Patterns
</code>

----

====== Sprint 5-A.1-G ======

===== Migration =====

----

====== Étape 17 — Générer =====

<code bash>
npx prisma migrate dev \
--name reservation_core
</code>

----

====== Étape 18 — Générer =====

<code bash>
npx prisma generate
</code>

----

====== Étape 19 — Vérifier =====

<code bash>
npx prisma studio
</code>

Présence de :

<code>
Reservation

Guest

ReservationGuest
</code>

----

====== Définition de terminé ======

Le Sprint 5-A.1 est terminé lorsque :

<code>
✓ Reservation créé

✓ Guest créé

✓ ReservationGuest créé

✓ Enums créés

✓ Relations créées

✓ Multi-tenant Ready

✓ Payment Ready

✓ Analytics Ready

✓ Migration exécutée
</code>

----

====== Livrables ======

<code>
Reservation

Guest

ReservationGuest

ReservationStatus

ReservationSource

Reservation Core Schema
</code>

----

====== Sprint 5-A.2 — Workflow de Réservation & Lifecycle ======

===== Objectif =====

Transformer le modèle Reservation en véritable moteur transactionnel Enterprise.

Cette couche gère :

<code>
Lifecycle

Workflow

Automatisation

Audit

Historique

Orchestration
</code>

de toutes les réservations.

À l'issue de cette étape :

<code>
✓ ReservationTimeline

✓ ReservationEvent

✓ ReservationWorkflow

✓ Status Machine

✓ Lifecycle Automation

✓ Audit Trail

✓ Booking Orchestration Engine
</code>

----

====== Architecture cible ======

<code>
Reservation

↓

Workflow Engine

├── State Machine
├── Timeline
├── Events
├── Automation
├── Notifications
└── Audit Trail

↓

Payments

↓

Check-In

↓

Stay Management
</code>

----

====== Sprint 5-A.2-A ======

===== Extension Prisma =====

----

====== Étape 1 — ReservationTimeline ======

===== Ajouter dans schema.prisma =====

<code prisma>
model ReservationTimeline {

id                    String
                        @id
                        @default(uuid())

reservationId         String

eventType             ReservationEventType

title                 String

description           String?

metadata              Json?

createdBy             String?

createdAt             DateTime
                        @default(now())

reservation           Reservation
                        @relation(
                          fields:[reservationId],
                          references:[id],
                          onDelete:Cascade
                        )

@@index([reservationId])

@@index([eventType])

@@index([createdAt])
}
</code>

----

====== Étape 2 — ReservationEvent ======

===== Ajouter =====

<code prisma>
model ReservationEvent {

id                    String
                        @id
                        @default(uuid())

reservationId         String

eventType             ReservationEventType

oldStatus             ReservationStatus?

newStatus             ReservationStatus?

payload               Json?

processed             Boolean
                        @default(false)

createdAt             DateTime
                        @default(now())

reservation           Reservation
                        @relation(
                          fields:[reservationId],
                          references:[id],
                          onDelete:Cascade
                        )

@@index([reservationId])

@@index([processed])

@@index([eventType])
}
</code>

----

====== Étape 3 — ReservationWorkflow ======

===== Ajouter =====

<code prisma>
model ReservationWorkflow {

reservationId         String
                        @id

currentStatus         ReservationStatus

lastTransitionAt      DateTime?

workflowVersion       String
                        @default("1.0")

automated             Boolean
                        @default(true)

updatedAt             DateTime
                        @updatedAt

reservation           Reservation
                        @relation(
                          fields:[reservationId],
                          references:[id],
                          onDelete:Cascade
                        )
}
</code>

----

====== Étape 4 — Migration ======

===== Générer =====

<code bash>
npx prisma migrate dev \
--name reservation_workflow
</code>

----

====== Sprint 5-A.2-B ======

===== Workflow Engine =====

----

====== Étape 5 — Création Module ======

<code>
src/modules/reservation-workflow

├── workflow
│
├── state-machine
│
├── timeline
│
├── events
│
├── automation
│
└── reservation-workflow.module.ts
</code>

----

====== Étape 6 — Services ======

===== Créer =====

<code>
ReservationWorkflowService

ReservationStateMachineService

ReservationTimelineService

ReservationEventService

ReservationAutomationService
</code>

----

====== Sprint 5-A.2-C ======

===== State Machine =====

----

====== Étape 7 — Définir le Workflow ======

<code>
DRAFT

↓

PENDING

↓

CONFIRMED

↓

CHECKED_IN

↓

CHECKED_OUT

↓

COMPLETED
</code>

----

====== Étape 8 — États alternatifs ======

<code>
PENDING

↓

CANCELLED
</code>

----

<code>
CONFIRMED

↓

NO_SHOW
</code>

----

====== Étape 9 — Transitions autorisées ======

<code ts>
const transitions = {

DRAFT: [
    PENDING,
    CANCELLED
  ],

PENDING: [
    CONFIRMED,
    CANCELLED
  ],

CONFIRMED: [
    CHECKED_IN,
    CANCELLED,
    NO_SHOW
  ],

CHECKED_IN: [
    CHECKED_OUT
  ],

CHECKED_OUT: [
    COMPLETED
  ]
};
</code>

----

====== Étape 10 — Validation ======

===== Refuser =====

toute transition invalide.

----

====== Sprint 5-A.2-D ======

===== Timeline =====

----

====== Étape 11 — Timeline Service ======

===== Créer =====

<code>
reservation-timeline.service.ts
</code>

----

===== Méthodes =====

<code ts>
addEvent()

getTimeline()

buildHistory()
</code>

----

====== Étape 12 — Historiser ======

<code>
Création

Confirmation

Paiement

Check-In

Check-Out

Annulation
</code>

----

====== Étape 13 — Exemple ======

<code json>
{
  "event":"CONFIRMED",
  "timestamp":"2027-01-10T12:00:00Z"
}
</code>

----

====== Sprint 5-A.2-E ======

===== Event Bus =====

----

====== Étape 14 — ReservationEventService ======

===== Créer =====

<code>
reservation-event.service.ts
</code>

----

===== Émettre =====

<code>
RESERVATION_CREATED

RESERVATION_CONFIRMED

RESERVATION_CANCELLED

CHECKIN_STARTED

CHECKOUT_COMPLETED
</code>

----

====== Étape 15 — Préparer ======

Compatible avec :

<code>
Payments

Notifications

Invoices

Analytics
</code>

----

====== Étape 16 — Pattern ======

===== Utiliser =====

<code>
Domain Events
</code>

pour les futurs microservices.

----

====== Sprint 5-A.2-F ======

===== Lifecycle Automation =====

----

====== Étape 17 — ReservationAutomationService ======

===== Créer =====

<code>
reservation-automation.service.ts
</code>

----

===== Automatiser =====

<code>
Confirmation

Reminders

Check-In

Check-Out

Completion
</code>

----

====== Étape 18 — Jobs ======

===== Ajouter =====

<code>
J-7 Arrival Reminder

J-1 Arrival Reminder

Check-In Reminder

Check-Out Reminder
</code>

----

====== Étape 19 — Auto-completion ======

===== Passer =====

<code>
CHECKED_OUT

↓

COMPLETED
</code>

après validation du séjour.

----

====== Sprint 5-A.2-G ======

===== Audit Trail =====

----

====== Étape 20 — Audit Intégral ======

===== Journaliser =====

<code>
Status Change

User Action

System Action

Automation Action
</code>

----

====== Étape 21 — Exemple ======

<code>
Reservation #RSV-1001

CONFIRMED

Par :

Admin

Le :

2027-01-05 14:32
</code>

----

====== Étape 22 — Intégration ======

===== Réutiliser =====

<code>
AuditLog

AuditModule
</code>

déjà présent dans la plateforme.

----

====== Sprint 5-A.2-H ======

===== API Workflow =====

----

====== Étape 23 — Endpoints ======

===== Ajouter =====

<code http>
GET /reservations/{id}/timeline

GET /reservations/{id}/workflow

POST /reservations/{id}/confirm

POST /reservations/{id}/cancel

POST /reservations/{id}/check-in

POST /reservations/{id}/check-out

POST /reservations/{id}/complete
</code>

----

====== Étape 24 — Exemple ======

===== Workflow =====

<code json>
{
  "status":"CONFIRMED",
  "lastTransitionAt":"2027-01-05T14:32:00Z"
}
</code>

----

====== Sprint 5-A.2-I ======

===== Sécurité =====

----

====== Étape 25 — Permissions ======

===== Ajouter =====

<code>
reservation.read

reservation.create

reservation.update

reservation.cancel

reservation.checkin

reservation.checkout

reservation.workflow
</code>

----

====== Étape 26 — Multi-Tenant ======

===== Vérifier =====

sur toutes les transitions :

<code>
tenantId

propertyId

reservationId
</code>

----

====== Étape 27 — Idempotence ======

===== Garantir =====

qu'un événement :

<code>
CHECK_IN

CHECK_OUT

CONFIRM
</code>

ne soit pas exécuté deux fois.

----

====== Sprint 5-A.2-J ======

===== Préparation Sprint 5-B =====

----

====== Étape 28 — Compatible ======

Préparer :

<code>
Payment Intent

Invoice

Refund

Transaction
</code>

----

====== Étape 29 — Compatible ======

Préparer :

<code>
Notifications

Emails

SMS

Push
</code>

----

====== Étape 30 — Compatible ======

Préparer :

<code>
Reservation Analytics

Fraud Detection

Revenue Analytics
</code>

----

====== Définition de terminé ======

Le Sprint 5-A.2 est terminé lorsque :

<code>
✓ ReservationTimeline créé

✓ ReservationEvent créé

✓ ReservationWorkflow créé

✓ State Machine opérationnelle

✓ Lifecycle Automation opérationnelle

✓ Audit Trail opérationnel

✓ Event Bus opérationnel
</code>

----

====== Livrables ======

<code>
ReservationTimeline

ReservationEvent

ReservationWorkflow

ReservationWorkflowService

ReservationStateMachineService

ReservationTimelineService

ReservationEventService

ReservationAutomationService

Booking Workflow Engine
</code>

----

====== Sprint 5-B.1 — Intégration Paiements ======

===== Objectif =====

Connecter le moteur de réservation au moteur financier.

Cette couche gère :

<code>
Paiements

Intentions de paiement

Transactions

Remboursements

Webhooks

Réconciliation
</code>

pour toutes les réservations.

À l'issue de cette étape :

<code>
✓ ReservationPayment

✓ PaymentIntent

✓ Transaction

✓ Refund

✓ Stripe Integration

✓ Webhook Processing

✓ Financial Transaction Engine
</code>

----

====== Architecture cible ======

<code>
Reservation

↓

Payment Engine

├── Payment Intent
├── Transaction
├── Refund
├── Webhooks
├── Reconciliation
└── Audit

↓

Invoice Engine

↓

Revenue Analytics
</code>

----

====== Sprint 5-B.1-A ======

===== Extension Prisma =====

----

====== Étape 1 — ReservationPayment ======

===== Ajouter dans schema.prisma =====

<code prisma>
model ReservationPayment {

id                    String
                        @id
                        @default(uuid())

tenantId              String

reservationId         String

paymentProvider       PaymentProvider

paymentStatus         PaymentStatus

currency              String
                        @default("EUR")

amount                Decimal
                        @db.Decimal(12,2)

paidAmount            Decimal
                        @db.Decimal(12,2)
                        @default(0)

dueAmount             Decimal
                        @db.Decimal(12,2)

externalReference     String?

paidAt                DateTime?

createdAt             DateTime
                        @default(now())

updatedAt             DateTime
                        @updatedAt

reservation           Reservation
                        @relation(
                          fields:[reservationId],
                          references:[id],
                          onDelete:Cascade
                        )

transactions          PaymentTransaction[]

refunds               PaymentRefund[]

@@index([tenantId])

@@index([reservationId])

@@index([paymentStatus])
}
</code>

----

====== Étape 2 — PaymentIntent ======

===== Ajouter =====

<code prisma>
model PaymentIntent {

id                    String
                        @id
                        @default(uuid())

reservationPaymentId  String

providerIntentId      String
                        @unique

amount                Decimal
                        @db.Decimal(12,2)

currency              String

clientSecret          String?

status                PaymentIntentStatus

expiresAt             DateTime?

createdAt             DateTime
                        @default(now())

@@index([providerIntentId])

@@index([status])
}
</code>

----

====== Étape 3 — PaymentTransaction ======

===== Ajouter =====

<code prisma>
model PaymentTransaction {

id                    String
                        @id
                        @default(uuid())

reservationPaymentId  String

transactionReference  String
                        @unique

providerTransactionId String?

amount                Decimal
                        @db.Decimal(12,2)

currency              String

status                TransactionStatus

metadata              Json?

processedAt           DateTime?

createdAt             DateTime
                        @default(now())

@@index([transactionReference])

@@index([status])
}
</code>

----

====== Étape 4 — PaymentRefund ======

===== Ajouter =====

<code prisma>
model PaymentRefund {

id                    String
                        @id
                        @default(uuid())

reservationPaymentId  String

transactionId         String?

refundReference       String
                        @unique

amount                Decimal
                        @db.Decimal(12,2)

reason                String?

status                RefundStatus

refundedAt            DateTime?

createdAt             DateTime
                        @default(now())

@@index([refundReference])

@@index([status])
}
</code>

----

====== Étape 5 — Enums ======

===== Ajouter =====

<code prisma>
enum PaymentProvider {

STRIPE

PAYPAL

ADYEN

MANUAL
}

enum PaymentStatus {

PENDING

PARTIALLY_PAID

PAID

FAILED

REFUNDED

CANCELLED
}

enum PaymentIntentStatus {

REQUIRES_PAYMENT_METHOD

REQUIRES_CONFIRMATION

PROCESSING

SUCCEEDED

CANCELED
}

enum TransactionStatus {

PENDING

SUCCESS

FAILED

CANCELLED
}

enum RefundStatus {

PENDING

PROCESSING

COMPLETED

FAILED
}
</code>

----

====== Étape 6 — Relations ======

===== Ajouter dans Reservation =====

<code prisma>
payments ReservationPayment[]
</code>

----

====== Étape 7 — Migration ======

===== Générer =====

<code bash>
npx prisma migrate dev \
--name reservation_payments
</code>

----

====== Sprint 5-B.1-B ======

===== Module Paiements =====

----

====== Étape 8 — Création ======

<code>
src/modules/payments

├── stripe
│
├── intents
│
├── transactions
│
├── refunds
│
├── webhooks
│
└── payments.module.ts
</code>

----

====== Étape 9 — Services ======

===== Créer =====

<code>
PaymentService

StripePaymentService

PaymentIntentService

TransactionService

RefundService

WebhookService
</code>

----

====== Sprint 5-B.1-C ======

===== Stripe Integration =====

----

====== Étape 10 — Installation ======

<code bash>
npm install stripe
</code>

----

====== Étape 11 — Variables ======

===== Ajouter =====

<code env>
STRIPE_SECRET_KEY=

STRIPE_WEBHOOK_SECRET=

STRIPE_PUBLISHABLE_KEY=
</code>

----

====== Étape 12 — StripePaymentService ======

===== Créer =====

<code>
stripe-payment.service.ts
</code>

----

===== Méthodes =====

<code ts>
createPaymentIntent()

confirmPayment()

cancelPayment()

retrievePayment()
</code>

----

====== Étape 13 — Création Intent ======

===== Exemple =====

<code ts>
const intent =
 await stripe.paymentIntents.create({

amount: 12500,

currency: 'eur',

metadata: {

reservationId
   }
 });
</code>

----

====== Sprint 5-B.1-D ======

===== Paiement Réservation =====

----

====== Étape 14 — PaymentService ======

===== Créer =====

<code>
payment.service.ts
</code>

----

===== Méthodes =====

<code ts>
createReservationPayment()

payReservation()

capturePayment()

cancelPayment()
</code>

----

====== Étape 15 — Workflow ======

<code>
Reservation

↓

Payment Intent

↓

Stripe

↓

Webhook

↓

PAID
</code>

----

====== Étape 16 — Mise à jour ======

===== Synchroniser =====

<code>
Reservation.paidAmount

ReservationPayment.status
</code>

automatiquement.

----

====== Sprint 5-B.1-E ======

===== Transactions =====

----

====== Étape 17 — TransactionService ======

===== Créer =====

<code>
transaction.service.ts
</code>

----

===== Journaliser =====

<code>
Authorization

Capture

Failure

Cancellation
</code>

----

====== Étape 18 — Réconciliation ======

===== Vérifier =====

<code>
Stripe

=

Base locale
</code>

----

====== Étape 19 — Référence ======

===== Générer =====

pour chaque transaction.

----

====== Sprint 5-B.1-F ======

===== Remboursements =====

----

====== Étape 20 — RefundService ======

===== Créer =====

<code>
refund.service.ts
</code>

----

===== Méthodes =====

<code ts>
createRefund()

approveRefund()

executeRefund()
</code>

----

====== Étape 21 — Supporter =====

<code>
Full Refund

Partial Refund

Policy Refund
</code>

----

====== Étape 22 — Exemple ======

<code>
Paiement

500 €

↓

Refund

100 €
</code>

----

====== Sprint 5-B.1-G ======

===== Webhooks =====

----

====== Étape 23 — WebhookController ======

===== Créer =====

<code>
webhook.controller.ts
</code>

----

====== Étape 24 — Endpoint ======

===== Ajouter =====

<code http>
POST /payments/webhooks/stripe
</code>

----

====== Étape 25 — Traiter ======

<code>
payment_intent.succeeded

payment_intent.payment_failed

charge.refunded

charge.dispute.created
</code>

----

====== Étape 26 — Sécuriser ======

===== Vérifier =====

<code>
STRIPE_WEBHOOK_SECRET
</code>

avant traitement.

----

====== Sprint 5-B.1-H ======

===== API Paiements =====

----

====== Étape 27 — Endpoints ======

===== Ajouter =====

<code http>
POST /reservations/{id}/payments

GET  /reservations/{id}/payments

POST /payments/intents

POST /payments/{id}/capture

POST /payments/{id}/refund

GET  /payments/{id}/transactions
</code>

----

====== Étape 28 — Exemple ======

===== Retour =====

<code json>
{
  "paymentIntentId":"pi_xxx",
  "clientSecret":"secret_xxx"
}
</code>

----

====== Sprint 5-B.1-I ======

===== Sécurité =====

----

====== Étape 29 — Permissions ======

===== Ajouter =====

<code>
payment.read

payment.create

payment.capture

payment.refund

payment.webhook

payment.admin
</code>

----

====== Étape 30 — Audit ======

===== Journaliser =====

<code>
PAYMENT_CREATED

PAYMENT_SUCCEEDED

PAYMENT_FAILED

REFUND_CREATED

REFUND_COMPLETED

WEBHOOK_RECEIVED
</code>

----

====== Étape 31 — Idempotence ======

===== Garantir =====

pour :

<code>
Webhooks

Captures

Refunds
</code>

afin d'éviter les doublons.

----

====== Sprint 5-B.1-J ======

===== Préparation Sprint 5-B.2 =====

----

====== Étape 32 — Compatible ======

Préparer :

<code>
Invoices

Credit Notes

Taxes

Accounting
</code>

----

====== Étape 33 — Compatible ======

Préparer :

<code>
Multi Currency

Payment Plans

Installments

Deposit Payments
</code>

----

====== Définition de terminé ======

Le Sprint 5-B.1 est terminé lorsque :

<code>
✓ ReservationPayment créé

✓ PaymentIntent créé

✓ PaymentTransaction créé

✓ PaymentRefund créé

✓ Stripe intégré

✓ Webhooks intégrés

✓ Refunds intégrés

✓ Audit intégré
</code>

----

====== Livrables ======

<code>
ReservationPayment

PaymentIntent

PaymentTransaction

PaymentRefund

StripePaymentService

PaymentService

RefundService

WebhookService

Enterprise Payment Platform
</code>

----

====== Sprint 5-B.2 — Facturation Enterprise & Comptabilité ======

===== Objectif =====

Transformer le moteur de paiement en plateforme financière Enterprise.

Cette couche gère :

<code>
Facturation

Avoirs

Fiscalité

Comptabilité

Conformité financière

Exports ERP
</code>

À l'issue de cette étape :

<code>
✓ Invoice

✓ InvoiceLine

✓ CreditNote

✓ Tax Engine

✓ Accounting Export

✓ Financial Compliance

✓ Financial Platform
</code>

----

====== Architecture cible ======

<code>
Reservation

↓

Payment

↓

Invoice Engine

├── Invoices
├── Invoice Lines
├── Credit Notes
├── Tax Engine
├── Accounting
└── Compliance

↓

ERP

↓

Financial Reporting
</code>

----

====== Sprint 5-B.2-A ======

===== Extension Prisma =====

----

====== Étape 1 — Invoice ======

===== Ajouter dans schema.prisma =====

<code prisma>
model Invoice {

id                    String
                        @id
                        @default(uuid())

tenantId              String

reservationId         String?

customerId            String

invoiceNumber         String
                        @unique

status                InvoiceStatus

currency              String
                        @default("EUR")

issueDate             DateTime

dueDate               DateTime?

subtotalAmount        Decimal
                        @db.Decimal(14,2)

taxAmount             Decimal
                        @db.Decimal(14,2)

totalAmount           Decimal
                        @db.Decimal(14,2)

paidAmount            Decimal
                        @db.Decimal(14,2)
                        @default(0)

notes                 String?

createdAt             DateTime
                        @default(now())

updatedAt             DateTime
                        @updatedAt

lines                 InvoiceLine[]

creditNotes           CreditNote[]

@@index([tenantId])

@@index([reservationId])

@@index([customerId])

@@index([status])
}
</code>

----

====== Étape 2 — InvoiceLine ======

===== Ajouter =====

<code prisma>
model InvoiceLine {

id                    String
                        @id
                        @default(uuid())

invoiceId             String

description           String

quantity              Decimal
                        @db.Decimal(10,2)

unitPrice             Decimal
                        @db.Decimal(12,2)

taxRate               Decimal
                        @db.Decimal(5,2)

totalAmount           Decimal
                        @db.Decimal(14,2)

createdAt             DateTime
                        @default(now())

invoice               Invoice
                        @relation(
                          fields:[invoiceId],
                          references:[id],
                          onDelete:Cascade
                        )

@@index([invoiceId])
}
</code>

----

====== Étape 3 — CreditNote ======

===== Ajouter =====

<code prisma>
model CreditNote {

id                    String
                        @id
                        @default(uuid())

tenantId              String

invoiceId             String

creditNoteNumber      String
                        @unique

reason                String

amount                Decimal
                        @db.Decimal(14,2)

status                CreditNoteStatus

issuedAt              DateTime

createdAt             DateTime
                        @default(now())

invoice               Invoice
                        @relation(
                          fields:[invoiceId],
                          references:[id]
                        )

@@index([tenantId])

@@index([invoiceId])

@@index([status])
}
</code>

----

====== Étape 4 — AccountingExport ======

===== Ajouter =====

<code prisma>
model AccountingExport {

id                    String
                        @id
                        @default(uuid())

tenantId              String

exportType            AccountingExportType

fileName              String

status                ExportStatus

generatedAt           DateTime?

createdAt             DateTime
                        @default(now())

@@index([tenantId])

@@index([exportType])

@@index([status])
}
</code>

----

====== Étape 5 — Enums ======

===== Ajouter =====

<code prisma>
enum InvoiceStatus {

DRAFT

ISSUED

PARTIALLY_PAID

PAID

OVERDUE

CANCELLED
}

enum CreditNoteStatus {

DRAFT

ISSUED

APPLIED

CANCELLED
}

enum AccountingExportType {

CSV

FEC

SAGE

CEGID

QUICKBOOKS

XERO
}

enum ExportStatus {

PENDING

PROCESSING

COMPLETED

FAILED
}
</code>

----

====== Étape 6 — Migration ======

===== Générer =====

<code bash>
npx prisma migrate dev \
--name invoicing_accounting
</code>

----

====== Sprint 5-B.2-B ======

===== Invoice Module =====

----

====== Étape 7 — Création ======

<code>
src/modules/invoicing

├── invoices
│
├── credit-notes
│
├── taxes
│
├── exports
│
├── compliance
│
└── invoicing.module.ts
</code>

----

====== Étape 8 — Services ======

===== Créer =====

<code>
InvoiceService

InvoiceLineService

CreditNoteService

TaxEngineService

AccountingExportService

FinancialComplianceService
</code>

----

====== Sprint 5-B.2-C ======

===== Génération de Factures =====

----

====== Étape 9 — InvoiceService ======

===== Créer =====

<code>
invoice.service.ts
</code>

----

===== Méthodes =====

<code ts>
createInvoice()

issueInvoice()

markAsPaid()

cancelInvoice()

generatePdf()
</code>

----

====== Étape 10 — Numérotation ======

===== Générer =====

de manière séquentielle.

----

====== Étape 11 — Facturation Réservation ======

===== Générer automatiquement =====

après :

<code>
Reservation Confirmed

ou

Payment Completed
</code>

selon configuration.

----

====== Sprint 5-B.2-D ======

===== Tax Engine =====

----

====== Étape 12 — TaxEngineService ======

===== Créer =====

<code>
tax-engine.service.ts
</code>

----

===== Supporter =====

<code>
TVA France

TVA UE

Taxe de séjour

Taxes locales

Exonérations
</code>

----

====== Étape 13 — TaxRule ======

===== Ajouter =====

<code prisma>
model TaxRule {

id                    String
                        @id
                        @default(uuid())

countryCode           String

regionCode            String?

taxType               String

rate                  Decimal
                        @db.Decimal(6,3)

active                Boolean
                        @default(true)

createdAt             DateTime
                        @default(now())

@@index([countryCode])

@@index([taxType])
}
</code>

----

====== Étape 14 — Calcul ======

===== Supporter =====

<code>
HT

TVA

TTC
</code>

pour toutes les factures.

----

====== Sprint 5-B.2-E ======

===== Avoirs =====

----

====== Étape 15 — CreditNoteService ======

===== Créer =====

<code>
credit-note.service.ts
</code>

----

===== Méthodes =====

<code ts>
createCreditNote()

applyCreditNote()

cancelCreditNote()
</code>

----

====== Étape 16 — Cas d'usage ======

<code>
Annulation

Remboursement

Erreur facturation

Geste commercial
</code>

----

====== Étape 17 — Exemple ======

<code>
Facture

500 €

↓

Avoir

100 €
</code>

----

====== Sprint 5-B.2-F ======

===== Exports Comptables =====

----

====== Étape 18 — AccountingExportService ======

===== Créer =====

<code>
accounting-export.service.ts
</code>

----

===== Formats =====

<code>
CSV

Excel

FEC

Sage

Cegid

QuickBooks

Xero
</code>

----

====== Étape 19 — Endpoints ======

===== Ajouter =====

<code http>
POST /accounting/exports

GET  /accounting/exports

GET  /accounting/exports/{id}
</code>

----

====== Étape 20 — Jobs ======

===== Générer =====

exports mensuels automatiques.

----

====== Sprint 5-B.2-G ======

===== Conformité Financière =====

----

====== Étape 21 — FinancialComplianceService ======

===== Créer =====

<code>
financial-compliance.service.ts
</code>

----

===== Contrôler =====

<code>
Numérotation

Intégrité

TVA

Archivage

Traçabilité
</code>

----

====== Étape 22 — Audit ======

===== Garantir =====

l'immutabilité des factures émises.

----

====== Étape 23 — Archivage ======

===== Supporter =====

<code>
PDF/A

Stockage S3

Conservation légale
</code>

----

====== Sprint 5-B.2-H ======

===== API Facturation =====

----

====== Étape 24 — Endpoints ======

===== Ajouter =====

<code http>
GET    /invoices

GET    /invoices/{id}

POST   /invoices

POST   /invoices/{id}/issue

POST   /invoices/{id}/pay

POST   /credit-notes

GET    /credit-notes
</code>

----

====== Étape 25 — Exemple ======

===== Réponse =====

<code json>
{
  "invoiceNumber":"INV-2027-000001",
  "status":"ISSUED",
  "totalAmount":1250.00
}
</code>

----

====== Sprint 5-B.2-I ======

===== Sécurité =====

----

====== Étape 26 — Permissions ======

===== Ajouter =====

<code>
invoice.read

invoice.create

invoice.issue

invoice.pay

invoice.export

creditnote.manage

accounting.admin
</code>

----

====== Étape 27 — Multi-Tenant ======

===== Vérifier =====

sur :

<code>
Invoice

CreditNote

AccountingExport
</code>

----

====== Étape 28 — Audit ======

===== Journaliser =====

<code>
INVOICE_CREATED

INVOICE_ISSUED

INVOICE_PAID

CREDIT_NOTE_CREATED

ACCOUNTING_EXPORT_GENERATED
</code>

----

====== Sprint 5-B.2-J ======

===== Préparation Sprint 5-C =====

----

====== Étape 29 — Compatible ======

Préparer :

<code>
Check-In

Check-Out

Guest Identity

Arrival Workflow
</code>

----

====== Étape 30 — Compatible ======

Préparer :

<code>
Revenue Recognition

Financial Reporting

BI Platform

Enterprise ERP
</code>

----

====== Définition de terminé ======

Le Sprint 5-B.2 est terminé lorsque :

<code>
✓ Invoice créé

✓ InvoiceLine créé

✓ CreditNote créé

✓ Tax Engine créé

✓ Exports comptables créés

✓ Conformité financière créée

✓ Audit intégré
</code>

----

====== Livrables ======

<code>
Invoice

InvoiceLine

CreditNote

TaxRule

AccountingExport

InvoiceService

CreditNoteService

TaxEngineService

AccountingExportService

FinancialComplianceService

Enterprise Financial Platform
</code>

----

====== Sprint 5-C.1 — Check-In Digital & Gestion des Arrivées ======

===== Objectif =====

Implémenter l'expérience d'arrivée complète des voyageurs.

Cette couche transforme la réservation confirmée en séjour actif.

À l'issue de cette étape :

<code>
✓ CheckIn

✓ Guest Verification

✓ Identity Documents

✓ Arrival Workflow

✓ Digital Signature

✓ Arrival Dashboard

✓ Digital Arrival Platform
</code>

----

====== Architecture cible ======

<code>
Reservation

↓

Arrival Workflow

├── Guest Verification
├── Identity Documents
├── Digital Signature
├── Check-In Validation
├── Key Delivery
└── Arrival Dashboard

↓

Stay Management

↓

Check-Out
</code>

----

====== Sprint 5-C.1-A ======

===== Extension Prisma =====

----

====== Étape 1 — CheckIn ======

===== Ajouter dans schema.prisma =====

<code prisma>
model CheckIn {

id                    String
                        @id
                        @default(uuid())

tenantId              String

reservationId         String
                        @unique

status                CheckInStatus

scheduledAt           DateTime?

startedAt             DateTime?

completedAt           DateTime?

verified              Boolean
                        @default(false)

signatureCompleted    Boolean
                        @default(false)

notes                 String?

createdAt             DateTime
                        @default(now())

updatedAt             DateTime
                        @updatedAt

reservation           Reservation
                        @relation(
                          fields:[reservationId],
                          references:[id],
                          onDelete:Cascade
                        )

documents             IdentityDocument[]

@@index([tenantId])

@@index([status])
}
</code>

----

====== Étape 2 — IdentityDocument ======

===== Ajouter =====

<code prisma>
model IdentityDocument {

id                    String
                        @id
                        @default(uuid())

checkInId             String

guestId               String

documentType          IdentityDocumentType

documentNumber        String?

storagePath           String

verificationStatus    VerificationStatus

verifiedAt            DateTime?

createdAt             DateTime
                        @default(now())

checkIn               CheckIn
                        @relation(
                          fields:[checkInId],
                          references:[id],
                          onDelete:Cascade
                        )

@@index([checkInId])

@@index([guestId])

@@index([verificationStatus])
}
</code>

----

====== Étape 3 — GuestVerification ======

===== Ajouter =====

<code prisma>
model GuestVerification {

id                    String
                        @id
                        @default(uuid())

guestId               String

verificationStatus    VerificationStatus

verificationMethod    VerificationMethod

riskScore             Float?
                        @default(0)

verifiedAt            DateTime?

createdAt             DateTime
                        @default(now())

@@index([guestId])

@@index([verificationStatus])
}
</code>

----

====== Étape 4 — DigitalSignature ======

===== Ajouter =====

<code prisma>
model DigitalSignature {

id                    String
                        @id
                        @default(uuid())

reservationId         String

signerId              String

documentType          String

signaturePath         String?

signedAt              DateTime?

ipAddress             String?

status                SignatureStatus

createdAt             DateTime
                        @default(now())

@@index([reservationId])

@@index([signerId])

@@index([status])
}
</code>

----

====== Étape 5 — Enums ======

===== Ajouter =====

<code prisma>
enum CheckInStatus {

PENDING

IN_PROGRESS

VERIFIED

COMPLETED

REJECTED
}

enum IdentityDocumentType {

PASSPORT

ID_CARD

DRIVER_LICENSE

RESIDENCE_PERMIT
}

enum VerificationStatus {

PENDING

VERIFIED

REJECTED

MANUAL_REVIEW
}

enum VerificationMethod {

MANUAL

OCR

BIOMETRIC

THIRD_PARTY
}
</code>

----

====== Étape 6 — Migration ======

===== Générer =====

<code bash>
npx prisma migrate dev \
--name digital_checkin
</code>

----

====== Sprint 5-C.1-B ======

===== Check-In Module =====

----

====== Étape 7 — Création ======

<code>
src/modules/checkin

├── checkin
│
├── verification
│
├── documents
│
├── signatures
│
├── arrivals
│
└── checkin.module.ts
</code>

----

====== Étape 8 — Services ======

===== Créer =====

<code>
CheckInService

GuestVerificationService

IdentityDocumentService

DigitalSignatureService

ArrivalWorkflowService

ArrivalDashboardService
</code>

----

====== Sprint 5-C.1-C ======

===== Workflow d'Arrivée =====

----

====== Étape 9 — ArrivalWorkflowService ======

===== Créer =====

<code>
arrival-workflow.service.ts
</code>

----

===== Workflow =====

<code>
Reservation Confirmed

↓

Document Upload

↓

Identity Verification

↓

Digital Signature

↓

Check-In Approval

↓

Arrival Completed
</code>

----

====== Étape 10 — Validation ======

===== Exiger =====

<code>
Document valide

Signature valide

Paiement conforme
</code>

avant check-in.

----

====== Étape 11 — Automatisation ======

===== Déclencher =====

<code>
J-7 Arrival Email

J-3 Reminder

J-1 Check-In Link

Arrival Instructions
</code>

----

====== Sprint 5-C.1-D ======

===== Vérification Voyageur =====

----

====== Étape 12 — GuestVerificationService ======

===== Créer =====

<code>
guest-verification.service.ts
</code>

----

===== Méthodes =====

<code ts>
verifyGuest()

calculateRiskScore()

approveVerification()

rejectVerification()
</code>

----

====== Étape 13 — Contrôles ======

===== Vérifier =====

<code>
Identité

Âge

Document expiré

Doublons

Blacklist
</code>

----

====== Étape 14 — Risk Score ======

===== Calculer =====

à partir de :

<code>
Documents

Historique

Pays

Fraude
</code>

----

====== Sprint 5-C.1-E ======

===== Gestion Documentaire =====

----

====== Étape 15 — IdentityDocumentService ======

===== Créer =====

<code>
identity-document.service.ts
</code>

----

===== Méthodes =====

<code ts>
uploadDocument()

validateDocument()

extractDocumentData()

deleteDocument()
</code>

----

====== Étape 16 — Upload ======

===== Supporter =====

<code>
Passport

Carte identité

Permis

Titre séjour
</code>

----

====== Étape 17 — Stockage ======

===== Utiliser =====

<code>
MinIO

S3

Encryption At Rest
</code>

----

====== Étape 18 — OCR ======

===== Extraire =====

<code>
Nom

Prénom

Date naissance

Numéro document

Expiration
</code>

----

====== Sprint 5-C.1-F ======

===== Signature Numérique =====

----

====== Étape 19 — DigitalSignatureService ======

===== Créer =====

<code>
digital-signature.service.ts
</code>

----

===== Méthodes =====

<code ts>
requestSignature()

signDocument()

verifySignature()
</code>

----

====== Étape 20 — Documents ======

===== Supporter =====

<code>
Contrat location

Conditions générales

Règlement intérieur

Décharge responsabilité
</code>

----

====== Étape 21 — Journaliser ======

<code>
Date

IP

Utilisateur

Document
</code>

----

====== Sprint 5-C.1-G ======

===== Arrival Dashboard =====

----

====== Étape 22 — ArrivalDashboardService ======

===== Créer =====

<code>
arrival-dashboard.service.ts
</code>

----

===== Afficher =====

<code>
Arrivées du jour

Check-In en attente

Vérifications manuelles

Documents manquants

Signatures manquantes
</code>

----

====== Étape 23 — KPI ======

===== Mesurer =====

<code>
Arrival Completion Rate

Average Check-In Time

Verification Success Rate

Digital Adoption Rate
</code>

----

====== Étape 24 — Endpoint ======

===== Ajouter =====

<code http>
GET /arrivals/dashboard
</code>

----

====== Sprint 5-C.1-H ======

===== API Check-In =====

----

====== Étape 25 — Endpoints ======

===== Ajouter =====

<code http>
GET  /reservations/{id}/checkin

POST /reservations/{id}/checkin/start

POST /reservations/{id}/documents

POST /reservations/{id}/verify

POST /reservations/{id}/signature

POST /reservations/{id}/checkin/complete
</code>

----

====== Étape 26 — Réponse ======

===== Exemple =====

<code json>
{
  "status":"VERIFIED",
  "documentsValid":true,
  "signatureCompleted":true
}
</code>

----

====== Sprint 5-C.1-I ======

===== Sécurité =====

----

====== Étape 27 — Permissions ======

===== Ajouter =====

<code>
checkin.read

checkin.start

checkin.verify

checkin.complete

checkin.documents

checkin.admin
</code>

----

====== Étape 28 — RGPD ======

===== Appliquer =====

<code>
Consentement

Chiffrement

Conservation limitée

Suppression automatique
</code>

aux documents d'identité.

----

====== Étape 29 — Audit ======

===== Journaliser =====

<code>
CHECKIN_STARTED

DOCUMENT_UPLOADED

GUEST_VERIFIED

SIGNATURE_COMPLETED

CHECKIN_COMPLETED
</code>

----

====== Sprint 5-C.1-J ======

===== Préparation Sprint 5-C.2 =====

----

====== Étape 30 — Compatible ======

Préparer :

<code>
Check-Out

Damage Reports

Deposit Release

Guest Satisfaction
</code>

----

====== Étape 31 — Compatible ======

Préparer :

<code>
Smart Locks

Keyless Entry

IoT Access

Mobile Keys
</code>

----

====== Définition de terminé ======

Le Sprint 5-C.1 est terminé lorsque :

<code>
✓ CheckIn créé

✓ Guest Verification créée

✓ Identity Documents créés

✓ Arrival Workflow créé

✓ Digital Signature créée

✓ Arrival Dashboard créé

✓ Audit intégré
</code>

----

====== Livrables ======

<code>
CheckIn

IdentityDocument

GuestVerification

DigitalSignature

CheckInService

GuestVerificationService

IdentityDocumentService

DigitalSignatureService

ArrivalWorkflowService

ArrivalDashboardService

Digital Check-In Platform
</code>

----

====== Sprint 5-C.2 — Check-Out Digital & Clôture du Séjour ======

===== Objectif =====

Finaliser le cycle de vie complet du séjour.

Cette couche transforme un séjour actif en séjour clôturé tout en gérant :

<code>
Départ

Contrôle logement

Dépôt de garantie

Satisfaction client

Clôture financière

Clôture opérationnelle
</code>

À l'issue de cette étape :

<code>
✓ CheckOut

✓ Damage Report

✓ Deposit Release

✓ Guest Feedback

✓ Stay Closure

✓ Departure Dashboard

✓ Digital Departure Platform
</code>

----

====== Architecture cible ======

<code>
Stay

↓

Check-Out Workflow

├── Departure Validation
├── Damage Inspection
├── Deposit Release
├── Guest Feedback
├── Invoice Closure
└── Reservation Completion

↓

Analytics

↓

CRM

↓

Reviews
</code>

----

====== Sprint 5-C.2-A ======

===== Extension Prisma =====

----

====== Étape 1 — CheckOut ======

===== Ajouter dans schema.prisma =====

<code prisma>
model CheckOut {

id                    String
                        @id
                        @default(uuid())

tenantId              String

reservationId         String
                        @unique

status                CheckOutStatus

scheduledAt           DateTime?

startedAt             DateTime?

completedAt           DateTime?

depositReleased       Boolean
                        @default(false)

feedbackSubmitted     Boolean
                        @default(false)

notes                 String?

createdAt             DateTime
                        @default(now())

updatedAt             DateTime
                        @updatedAt

reservation           Reservation
                        @relation(
                          fields:[reservationId],
                          references:[id],
                          onDelete:Cascade
                        )

damageReports         DamageReport[]

@@index([tenantId])

@@index([status])
}
</code>

----

====== Étape 2 — DamageReport ======

===== Ajouter =====

<code prisma>
model DamageReport {

id                    String
                        @id
                        @default(uuid())

checkOutId            String

severity              DamageSeverity

category              DamageCategory

title                 String

description           String?

estimatedCost         Decimal?
                        @db.Decimal(12,2)

resolved              Boolean
                        @default(false)

createdAt             DateTime
                        @default(now())

checkOut              CheckOut
                        @relation(
                          fields:[checkOutId],
                          references:[id],
                          onDelete:Cascade
                        )

photos                DamagePhoto[]

@@index([checkOutId])

@@index([severity])

@@index([resolved])
}
</code>

----

====== Étape 3 — DamagePhoto ======

===== Ajouter =====

<code prisma>
model DamagePhoto {

id                    String
                        @id
                        @default(uuid())

damageReportId        String

imageUrl              String

createdAt             DateTime
                        @default(now())

damageReport          DamageReport
                        @relation(
                          fields:[damageReportId],
                          references:[id],
                          onDelete:Cascade
                        )

@@index([damageReportId])
}
</code>

----

====== Étape 4 — GuestFeedback ======

===== Ajouter =====

<code prisma>
model GuestFeedback {

id                    String
                        @id
                        @default(uuid())

reservationId         String
                        @unique

overallRating         Int

cleanlinessRating     Int?

comfortRating         Int?

serviceRating         Int?

comment               String?

submittedAt           DateTime
                        @default(now())

reservation           Reservation
                        @relation(
                          fields:[reservationId],
                          references:[id],
                          onDelete:Cascade
                        )
}
</code>

----

====== Étape 5 — Enums ======

===== Ajouter =====

<code prisma>
enum CheckOutStatus {

PENDING

IN_PROGRESS

INSPECTED

COMPLETED
}

enum DamageSeverity {

LOW

MEDIUM

HIGH

CRITICAL
}

enum DamageCategory {

CLEANING

FURNITURE

ELECTRICAL

PLUMBING

SECURITY

OTHER
}
</code>

----

====== Étape 6 — Migration ======

===== Générer =====

<code bash>
npx prisma migrate dev \
--name digital_checkout
</code>

----

====== Sprint 5-C.2-B ======

===== Check-Out Module =====

----

====== Étape 7 — Création ======

<code>
src/modules/checkout

├── checkout
│
├── damages
│
├── deposits
│
├── feedback
│
├── departure
│
└── checkout.module.ts
</code>

----

====== Étape 8 — Services ======

===== Créer =====

<code>
CheckOutService

DamageReportService

DepositReleaseService

GuestFeedbackService

StayClosureService

DepartureDashboardService
</code>

----

====== Sprint 5-C.2-C ======

===== Workflow de Départ =====

----

====== Étape 9 — StayClosureService ======

===== Créer =====

<code>
stay-closure.service.ts
</code>

----

===== Workflow =====

<code>
Check-Out Started

↓

Inspection

↓

Damage Review

↓

Deposit Decision

↓

Feedback

↓

Reservation Completed
</code>

----

====== Étape 10 — Validation ======

===== Vérifier =====

<code>
Paiements finalisés

Inspection terminée

Aucune anomalie bloquante
</code>

avant clôture.

----

====== Étape 11 — Automatisation ======

===== Déclencher =====

<code>
Check-Out Reminder

Feedback Request

Review Invitation

CRM Update
</code>

----

====== Sprint 5-C.2-D ======

===== Gestion des Dégradations =====

----

====== Étape 12 — DamageReportService ======

===== Créer =====

<code>
damage-report.service.ts
</code>

----

===== Méthodes =====

<code ts>
createDamageReport()

uploadDamagePhoto()

estimateDamageCost()

resolveDamage()
</code>

----

====== Étape 13 — Catégories ======

===== Supporter =====

<code>
Ménage

Mobilier

Électrique

Plomberie

Sécurité
</code>

----

====== Étape 14 — IA Future ======

Préparer :

<code>
Vision AI

Damage Detection

Cost Estimation
</code>

----

====== Sprint 5-C.2-E ======

===== Libération du Dépôt =====

----

====== Étape 15 — DepositReleaseService ======

===== Créer =====

<code>
deposit-release.service.ts
</code>

----

===== Méthodes =====

<code ts>
releaseDeposit()

holdDeposit()

partialRelease()

chargeDamageCost()
</code>

----

====== Étape 16 — Scénarios ======

===== Supporter =====

<code>
Full Release

Partial Release

Full Retention
</code>

----

====== Étape 17 — Intégration ======

===== Connecter =====

<code>
SecurityDepositPolicy

PaymentRefund

ReservationPayment
</code>

----

====== Sprint 5-C.2-F ======

===== Feedback Voyageur =====

----

====== Étape 18 — GuestFeedbackService ======

===== Créer =====

<code>
guest-feedback.service.ts
</code>

----

===== Méthodes =====

<code ts>
submitFeedback()

calculateSatisfaction()

generateReviewRequest()
</code>

----

====== Étape 19 — Notes ======

===== Collecter =====

<code>
Propreté

Confort

Service

Expérience globale
</code>

----

====== Étape 20 — Intégration ======

===== Alimenter =====

<code>
Property Reviews

CRM Analytics

Property Reputation
</code>

----

====== Sprint 5-C.2-G ======

===== Departure Dashboard =====

----

====== Étape 21 — DepartureDashboardService ======

===== Créer =====

<code>
departure-dashboard.service.ts
</code>

----

===== Afficher =====

<code>
Départs du jour

Inspections en attente

Dépôts à rembourser

Feedbacks reçus

Incidents ouverts
</code>

----

====== Étape 22 — KPI ======

===== Mesurer =====

<code>
Checkout Completion Rate

Average Checkout Time

Deposit Release Time

Guest Satisfaction
</code>

----

====== Étape 23 — Endpoint ======

===== Ajouter =====

<code http>
GET /departures/dashboard
</code>

----

====== Sprint 5-C.2-H ======

===== API Check-Out =====

----

====== Étape 24 — Endpoints ======

===== Ajouter =====

<code http>
GET  /reservations/{id}/checkout

POST /reservations/{id}/checkout/start

POST /reservations/{id}/damage-reports

POST /reservations/{id}/deposit/release

POST /reservations/{id}/feedback

POST /reservations/{id}/checkout/complete
</code>

----

====== Étape 25 — Réponse ======

===== Exemple =====

<code json>
{
  "status":"COMPLETED",
  "depositReleased":true,
  "feedbackSubmitted":true
}
</code>

----

====== Sprint 5-C.2-I ======

===== Sécurité =====

----

====== Étape 26 — Permissions ======

===== Ajouter =====

<code>
checkout.read

checkout.start

checkout.complete

checkout.damage

checkout.deposit

checkout.admin
</code>

----

====== Étape 27 — Audit ======

===== Journaliser =====

<code>
CHECKOUT_STARTED

DAMAGE_REPORTED

DEPOSIT_RELEASED

FEEDBACK_SUBMITTED

CHECKOUT_COMPLETED
</code>

----

====== Étape 28 — Multi-Tenant ======

===== Vérifier =====

sur :

<code>
CheckOut

DamageReport

GuestFeedback
</code>

----

====== Sprint 5-C.2-J ======

===== Préparation Sprint 5-D =====

----

====== Étape 29 — Compatible ======

Préparer :

<code>
Housekeeping

Maintenance

Guest Requests

Incident Management
</code>

----

====== Étape 30 — Compatible ======

Préparer :

<code>
Guest Journey

Customer Success

Operational Excellence

Service Automation
</code>

----

====== Définition de terminé ======

Le Sprint 5-C.2 est terminé lorsque :

<code>
✓ CheckOut créé

✓ DamageReport créé

✓ Deposit Release créé

✓ Guest Feedback créé

✓ Stay Closure créé

✓ Departure Dashboard créé

✓ Audit intégré
</code>

----

====== Livrables ======

<code>
CheckOut

DamageReport

DamagePhoto

GuestFeedback

CheckOutService

DamageReportService

DepositReleaseService

GuestFeedbackService

StayClosureService

DepartureDashboardService

Digital Check-Out Platform
</code>

----

====== Sprint 5-D.1 — Gestion des Demandes Voyageurs & Service Desk ======

===== Objectif =====

Mettre en place la couche opérationnelle du séjour.

Cette couche permet de gérer :

<code>
Demandes voyageurs

Incidents

Maintenance

Tâches

Communication

Suivi opérationnel
</code>

depuis l'arrivée jusqu'au départ.

À l'issue de cette étape :

<code>
✓ GuestRequest

✓ ServiceTicket

✓ Incident

✓ TaskAssignment

✓ Guest Communication

✓ Service Dashboard

✓ Hospitality Service Desk
</code>

----

====== Architecture cible ======

<code>
Guest

↓

Guest Request

↓

Service Desk

├── Tickets
├── Incidents
├── Tasks
├── Communications
├── Escalations
└── SLA

↓

Operations

↓

Analytics
</code>

----

====== Sprint 5-D.1-A ======

===== Extension Prisma =====

----

====== Étape 1 — GuestRequest ======

===== Ajouter dans schema.prisma =====

<code prisma>
model GuestRequest {

id                    String
                        @id
                        @default(uuid())

tenantId              String

reservationId         String

guestId               String?

requestType           GuestRequestType

priority              TicketPriority

status                TicketStatus

subject               String

description           String

requestedAt           DateTime
                        @default(now())

resolvedAt            DateTime?

satisfactionScore     Int?

createdAt             DateTime
                        @default(now())

updatedAt             DateTime
                        @updatedAt

tickets               ServiceTicket[]

@@index([tenantId])

@@index([reservationId])

@@index([status])

@@index([priority])
}
</code>

----

====== Étape 2 — ServiceTicket ======

===== Ajouter =====

<code prisma>
model ServiceTicket {

id                    String
                        @id
                        @default(uuid())

tenantId              String

guestRequestId        String

assignedTo            String?

ticketNumber          String
                        @unique

status                TicketStatus

priority              TicketPriority

slaDueAt              DateTime?

resolvedAt            DateTime?

createdAt             DateTime
                        @default(now())

updatedAt             DateTime
                        @updatedAt

request               GuestRequest
                        @relation(
                          fields:[guestRequestId],
                          references:[id],
                          onDelete:Cascade
                        )

tasks                 TaskAssignment[]

@@index([tenantId])

@@index([assignedTo])

@@index([status])
}
</code>

----

====== Étape 3 — Incident ======

===== Ajouter =====

<code prisma>
model Incident {

id                    String
                        @id
                        @default(uuid())

tenantId              String

reservationId         String?

propertyId            String

severity              IncidentSeverity

category              IncidentCategory

title                 String

description           String

status                IncidentStatus

openedAt              DateTime
                        @default(now())

closedAt              DateTime?

createdAt             DateTime
                        @default(now())

@@index([tenantId])

@@index([propertyId])

@@index([status])

@@index([severity])
}
</code>

----

====== Étape 4 — TaskAssignment ======

===== Ajouter =====

<code prisma>
model TaskAssignment {

id                    String
                        @id
                        @default(uuid())

tenantId              String

ticketId              String?

incidentId            String?

assignedUserId        String

title                 String

description           String?

dueDate               DateTime?

completed             Boolean
                        @default(false)

completedAt           DateTime?

createdAt             DateTime
                        @default(now())

@@index([tenantId])

@@index([assignedUserId])

@@index([completed])
}
</code>

----

====== Étape 5 — GuestCommunication ======

===== Ajouter =====

<code prisma>
model GuestCommunication {

id                    String
                        @id
                        @default(uuid())

tenantId              String

reservationId         String

channel               CommunicationChannel

direction             CommunicationDirection

subject               String?

message               String

sentAt                DateTime
                        @default(now())

createdAt             DateTime
                        @default(now())

@@index([tenantId])

@@index([reservationId])

@@index([channel])
}
</code>

----

====== Étape 6 — Enums ======

===== Ajouter =====

<code prisma>
enum GuestRequestType {

HOUSEKEEPING

MAINTENANCE

AMENITY

INFORMATION

CHECKIN

CHECKOUT

TRANSPORT

OTHER
}

enum TicketStatus {

OPEN

IN_PROGRESS

WAITING

RESOLVED

CLOSED
}

enum TicketPriority {

LOW

MEDIUM

HIGH

URGENT
}

enum IncidentSeverity {

LOW

MEDIUM

HIGH

CRITICAL
}

enum IncidentStatus {

OPEN

INVESTIGATING

RESOLVED

CLOSED
}

enum IncidentCategory {

FACILITY

SECURITY

CLEANING

PAYMENT

TECHNICAL

OTHER
}

enum CommunicationChannel {

EMAIL

SMS

PHONE

IN_APP
}

enum CommunicationDirection {

INBOUND

OUTBOUND
}
</code>

----

====== Étape 7 — Migration ======

===== Générer =====

<code bash>
npx prisma migrate dev \
--name guest_service_desk
</code>

----

====== Sprint 5-D.1-B ======

===== Module Service Desk =====

----

====== Étape 8 — Création ======

<code>
src/modules/service-desk

├── guest-requests
│
├── tickets
│
├── incidents
│
├── tasks
│
├── communications
│
├── sla
│
└── service-desk.module.ts
</code>

----

====== Étape 9 — Services ======

===== Créer =====

<code>
GuestRequestService

ServiceTicketService

IncidentService

TaskAssignmentService

GuestCommunicationService

ServiceDashboardService
</code>

----

====== Sprint 5-D.1-C ======

===== Demandes Voyageurs =====

----

====== Étape 10 — GuestRequestService ======

===== Créer =====

<code>
guest-request.service.ts
</code>

----

===== Méthodes =====

<code ts>
createRequest()

assignRequest()

resolveRequest()

rateSatisfaction()
</code>

----

====== Étape 11 — Cas d'usage ======

===== Supporter =====

<code>
Serviettes

Ménage

Réparation

Questions

Transport

Assistance
</code>

----

====== Étape 12 — Workflow ======

<code>
Guest Request

↓

Ticket

↓

Assignment

↓

Resolution

↓

Feedback
</code>

----

====== Sprint 5-D.1-D ======

===== Tickets & SLA =====

----

====== Étape 13 — ServiceTicketService ======

===== Créer =====

<code>
service-ticket.service.ts
</code>

----

===== SLA par priorité =====

<code>
LOW      48h

MEDIUM   24h

HIGH      8h

URGENT    1h
</code>

----

====== Étape 14 — Méthodes ======

<code ts>
createTicket()

assignTicket()

escalateTicket()

closeTicket()
</code>

----

====== Étape 15 — Numérotation ======

===== Générer =====

----

====== Sprint 5-D.1-E ======

===== Gestion des Incidents =====

----

====== Étape 16 — IncidentService ======

===== Créer =====

<code>
incident.service.ts
</code>

----

===== Méthodes =====

<code ts>
openIncident()

investigateIncident()

resolveIncident()

closeIncident()
</code>

----

====== Étape 17 — Types ======

===== Supporter =====

<code>
Panne climatisation

Fuite

Problème serrure

Sécurité

Incident paiement
</code>

----

====== Étape 18 — Escalade ======

===== Automatique =====

si :

<code>
Severity = CRITICAL
</code>

----

====== Sprint 5-D.1-F ======

===== Assignation des Tâches =====

----

====== Étape 19 — TaskAssignmentService ======

===== Créer =====

<code>
task-assignment.service.ts
</code>

----

===== Méthodes =====

<code ts>
assignTask()

completeTask()

reassignTask()
</code>

----

====== Étape 20 — Assignation ======

===== Supporter =====

<code>
Housekeeping

Maintenance

Reception

Manager
</code>

----

====== Étape 21 — Notifications ======

===== Déclencher =====

lors des nouvelles tâches.

----

====== Sprint 5-D.1-G ======

===== Communications Voyageur =====

----

====== Étape 22 — GuestCommunicationService ======

===== Créer =====

<code>
guest-communication.service.ts
</code>

----

===== Méthodes =====

<code ts>
sendMessage()

receiveMessage()

getConversation()
</code>

----

====== Étape 23 — Canaux ======

===== Supporter =====

<code>
Email

SMS

Téléphone

In-App
</code>

----

====== Étape 24 — Timeline ======

===== Centraliser =====

toutes les interactions client.

----

====== Sprint 5-D.1-H ======

===== Service Dashboard =====

----

====== Étape 25 — ServiceDashboardService ======

===== Créer =====

<code>
service-dashboard.service.ts
</code>

----

===== Afficher =====

<code>
Tickets ouverts

Tickets SLA en retard

Incidents actifs

Tâches assignées

Satisfaction client
</code>

----

====== Étape 26 — KPI ======

===== Mesurer =====

<code>
Resolution Time

SLA Compliance

Ticket Volume

CSAT

Incident Rate
</code>

----

====== Étape 27 — Endpoint ======

===== Ajouter =====

<code http>
GET /service-desk/dashboard
</code>

----

====== Sprint 5-D.1-I ======

===== API Service Desk =====

----

====== Étape 28 — Endpoints ======

===== Ajouter =====

<code http>
GET    /guest-requests

POST   /guest-requests

PUT    /guest-requests/{id}

POST   /tickets/{id}/assign

POST   /tickets/{id}/close

POST   /incidents

PUT    /incidents/{id}

POST   /tasks/{id}/complete

GET    /communications/{reservationId}
</code>

----

====== Étape 29 — Exemple ======

===== Création demande =====

<code json>
{
  "requestType":"HOUSEKEEPING",
  "subject":"Serviettes supplémentaires"
}
</code>

----

====== Sprint 5-D.1-J ======

===== Gouvernance =====

----

====== Étape 30 — Permissions ======

===== Ajouter =====

<code>
service.read

service.manage

service.assign

service.incident

service.communication

service.admin
</code>

----

====== Étape 31 — Audit ======

===== Journaliser =====

<code>
REQUEST_CREATED

TICKET_ASSIGNED

INCIDENT_OPENED

TASK_COMPLETED

MESSAGE_SENT

SLA_BREACHED
</code>

----

====== Étape 32 — Préparation Sprint 5-D.2 =====

Compatible avec :

<code>
Housekeeping Automation

Maintenance Management

Operational Intelligence

Work Orders
</code>

----

====== Définition de terminé ======

Le Sprint 5-D.1 est terminé lorsque :

<code>
✓ GuestRequest créé

✓ ServiceTicket créé

✓ Incident créé

✓ TaskAssignment créé

✓ GuestCommunication créé

✓ Service Dashboard créé

✓ SLA intégré

✓ Audit intégré
</code>

----

====== Livrables ======

<code>
GuestRequest

ServiceTicket

Incident

TaskAssignment

GuestCommunication

GuestRequestService

ServiceTicketService

IncidentService

TaskAssignmentService

GuestCommunicationService

ServiceDashboardService

Hospitality Service Desk
</code>

----

====== Sprint 5-D.2 — Housekeeping & Maintenance Operations ======

===== Objectif =====

Automatiser les opérations terrain de la plateforme.

Cette couche permet de piloter :

<code>
Ménage

Maintenance

Statut des logements

Inventaire

Maintenance préventive

Performance opérationnelle
</code>

afin de transformer la plateforme en véritable PMS (Property Management System).

À l'issue de cette étape :

<code>
✓ Housekeeping

✓ Room Status

✓ Maintenance Work Orders

✓ Preventive Maintenance

✓ Inventory Usage

✓ Operations Dashboard

✓ Operations Management Platform
</code>

----

====== Architecture cible ======

<code>
Reservation

↓

Operations Engine

├── Housekeeping
├── Room Status
├── Maintenance
├── Preventive Maintenance
├── Inventory
└── Operations Dashboard

↓

Property Operations

↓

Analytics
</code>

----

====== Sprint 5-D.2-A ======

===== Extension Prisma =====

----

====== Étape 1 — HousekeepingTask ======

===== Ajouter dans schema.prisma =====

<code prisma>
model HousekeepingTask {

id                    String
                        @id
                        @default(uuid())

tenantId              String

propertyId            String

reservationId         String?

assignedUserId        String?

taskType              HousekeepingTaskType

status                HousekeepingStatus

priority              TaskPriority

scheduledAt           DateTime?

startedAt             DateTime?

completedAt           DateTime?

notes                 String?

createdAt             DateTime
                        @default(now())

updatedAt             DateTime
                        @updatedAt

@@index([tenantId])

@@index([propertyId])

@@index([status])

@@index([assignedUserId])
}
</code>

----

====== Étape 2 — PropertyRoomStatus ======

===== Ajouter =====

<code prisma>
model PropertyRoomStatus {

propertyId            String
                        @id

status                RoomStatus

lastUpdatedAt         DateTime
                        @updatedAt

notes                 String?

property              Property
                        @relation(
                          fields:[propertyId],
                          references:[id],
                          onDelete:Cascade
                        )
}
</code>

----

====== Étape 3 — MaintenanceWorkOrder ======

===== Ajouter =====

<code prisma>
model MaintenanceWorkOrder {

id                    String
                        @id
                        @default(uuid())

tenantId              String

propertyId            String

assignedUserId        String?

category              MaintenanceCategory

priority              TaskPriority

status                WorkOrderStatus

title                 String

description           String?

estimatedCost         Decimal?
                        @db.Decimal(12,2)

actualCost            Decimal?
                        @db.Decimal(12,2)

scheduledAt           DateTime?

completedAt           DateTime?

createdAt             DateTime
                        @default(now())

updatedAt             DateTime
                        @updatedAt

@@index([tenantId])

@@index([propertyId])

@@index([status])

@@index([priority])
}
</code>

----

====== Étape 4 — PreventiveMaintenance ======

===== Ajouter =====

<code prisma>
model PreventiveMaintenance {

id                    String
                        @id
                        @default(uuid())

tenantId              String

propertyId            String

title                 String

frequencyDays         Int

nextDueDate           DateTime

active                Boolean
                        @default(true)

lastCompletedAt       DateTime?

createdAt             DateTime
                        @default(now())

@@index([tenantId])

@@index([propertyId])

@@index([nextDueDate])
}
</code>

----

====== Étape 5 — InventoryUsage ======

===== Ajouter =====

<code prisma>
model InventoryUsage {

id                    String
                        @id
                        @default(uuid())

tenantId              String

propertyId            String

itemName              String

quantity              Decimal
                        @db.Decimal(10,2)

unit                  String

usedAt                DateTime
                        @default(now())

referenceType         String?

referenceId           String?

@@index([tenantId])

@@index([propertyId])

@@index([usedAt])
}
</code>

----

====== Étape 6 — Enums ======

===== Ajouter =====

<code prisma>
enum HousekeepingTaskType {

CHECKOUT_CLEANING

DEEP_CLEANING

INSPECTION

LINEN_CHANGE

RESTOCK

OTHER
}

enum HousekeepingStatus {

PENDING

ASSIGNED

IN_PROGRESS

COMPLETED

CANCELLED
}

enum RoomStatus {

AVAILABLE

OCCUPIED

DIRTY

CLEANING

INSPECTING

OUT_OF_SERVICE
}

enum MaintenanceCategory {

HVAC

ELECTRICAL

PLUMBING

FURNITURE

SECURITY

APPLIANCE

GENERAL
}

enum WorkOrderStatus {

OPEN

ASSIGNED

IN_PROGRESS

COMPLETED

CANCELLED
}

enum TaskPriority {

LOW

MEDIUM

HIGH

URGENT
}
</code>

----

====== Étape 7 — Migration ======

===== Générer =====

<code bash>
npx prisma migrate dev \
--name operations_management
</code>

----

====== Sprint 5-D.2-B ======

===== Operations Module =====

----

====== Étape 8 — Création ======

<code>
src/modules/operations

├── housekeeping
│
├── room-status
│
├── maintenance
│
├── preventive-maintenance
│
├── inventory
│
├── dashboard
│
└── operations.module.ts
</code>

----

====== Étape 9 — Services ======

===== Créer =====

<code>
HousekeepingService

RoomStatusService

MaintenanceWorkOrderService

PreventiveMaintenanceService

InventoryUsageService

OperationsDashboardService
</code>

----

====== Sprint 5-D.2-C ======

===== Housekeeping =====

----

====== Étape 10 — HousekeepingService ======

===== Créer =====

<code>
housekeeping.service.ts
</code>

----

===== Méthodes =====

<code ts>
createCleaningTask()

assignTask()

startCleaning()

completeCleaning()
</code>

----

====== Étape 11 — Automatisation ======

===== Générer automatiquement =====

<code>
Check-Out

↓

Cleaning Task
</code>

----

====== Étape 12 — Workflow ======

<code>
DIRTY

↓

CLEANING

↓

INSPECTING

↓

AVAILABLE
</code>

----

====== Sprint 5-D.2-D ======

===== Room Status =====

----

====== Étape 13 — RoomStatusService ======

===== Créer =====

<code>
room-status.service.ts
</code>

----

===== Méthodes =====

<code ts>
updateStatus()

getStatus()

transitionStatus()
</code>

----

====== Étape 14 — Synchronisation ======

===== Alimenter =====

à partir de :

<code>
Reservation

CheckIn

CheckOut

Housekeeping
</code>

----

====== Étape 15 — Temps Réel ======

===== Afficher =====

<code>
Occupé

Disponible

En ménage

Hors service
</code>

----

====== Sprint 5-D.2-E ======

===== Maintenance =====

----

====== Étape 16 — MaintenanceWorkOrderService ======

===== Créer =====

<code>
maintenance-work-order.service.ts
</code>

----

===== Méthodes =====

<code ts>
createWorkOrder()

assignTechnician()

completeWorkOrder()

calculateCosts()
</code>

----

====== Étape 17 — Origines ======

===== Supporter =====

<code>
Incident

Inspection

Preventive Maintenance

Manual Request
</code>

----

====== Étape 18 — Escalade ======

===== Automatique =====

si :

<code>
Priority = URGENT
</code>

----

====== Sprint 5-D.2-F ======

===== Maintenance Préventive =====

----

====== Étape 19 — PreventiveMaintenanceService ======

===== Créer =====

<code>
preventive-maintenance.service.ts
</code>

----

===== Méthodes =====

<code ts>
scheduleMaintenance()

generateWorkOrders()

markCompleted()
</code>

----

====== Étape 20 — Exemples ======

<code>
Climatisation

90 jours

↓

Work Order auto
</code>

----

<code>
Détecteur fumée

180 jours

↓

Inspection auto
</code>

----

====== Sprint 5-D.2-G ======

===== Inventaire =====

----

====== Étape 21 — InventoryUsageService ======

===== Créer =====

<code>
inventory-usage.service.ts
</code>

----

===== Suivre =====

<code>
Produits ménage

Linge

Consommables

Produits accueil
</code>

----

====== Étape 22 — Méthodes =====

<code ts>
registerUsage()

calculateConsumption()

forecastInventory()
</code>

----

====== Étape 23 — Alertes ======

===== Déclencher =====

sur :

<code>
Stock faible

Surconsommation

Rupture
</code>

----

====== Sprint 5-D.2-H ======

===== Operations Dashboard =====

----

====== Étape 24 — OperationsDashboardService ======

===== Créer =====

<code>
operations-dashboard.service.ts
</code>

----

===== Afficher =====

<code>
Nettoyages en attente

Logements sales

Work Orders ouverts

Maintenances prévues

Consommation inventaire
</code>

----

====== Étape 25 — KPI ======

===== Mesurer =====

<code>
Cleaning Time

Room Turnover Time

Maintenance SLA

Inventory Cost

Operational Efficiency
</code>

----

====== Étape 26 — Endpoint ======

===== Ajouter =====

<code http>
GET /operations/dashboard
</code>

----

====== Sprint 5-D.2-I ======

===== API Operations =====

----

====== Étape 27 — Endpoints ======

===== Ajouter =====

<code http>
GET    /housekeeping/tasks

POST   /housekeeping/tasks

PUT    /housekeeping/tasks/{id}

GET    /room-status

PUT    /room-status/{propertyId}

GET    /maintenance/work-orders

POST   /maintenance/work-orders

PUT    /maintenance/work-orders/{id}

GET    /preventive-maintenance

POST   /preventive-maintenance

GET    /inventory/usage
</code>

----

====== Étape 28 — Exemple ======

===== Work Order =====

<code json>
{
  "category":"HVAC",
  "priority":"HIGH",
  "title":"Réparation climatisation"
}
</code>

----

====== Sprint 5-D.2-J ======

===== Gouvernance =====

----

====== Étape 29 — Permissions ======

===== Ajouter =====

<code>
operations.read

operations.housekeeping

operations.maintenance

operations.inventory

operations.dashboard

operations.admin
</code>

----

====== Étape 30 — Audit ======

===== Journaliser =====

<code>
HOUSEKEEPING_CREATED

HOUSEKEEPING_COMPLETED

ROOM_STATUS_UPDATED

WORK_ORDER_CREATED

WORK_ORDER_COMPLETED

PREVENTIVE_MAINTENANCE_EXECUTED
</code>

----

====== Étape 31 — Jobs ======

===== Ajouter =====

<code>
Toutes les heures

Maintenance Scheduler

Toutes les nuits

Inventory Forecast

Operations KPIs Refresh
</code>

----

====== Clôture Domaine Opérations ======

À la fin du Sprint 5-D.2 :

<code>
✓ Service Desk

✓ Guest Requests

✓ Incidents

✓ Housekeeping

✓ Maintenance

✓ Inventory

✓ Operations Dashboard
</code>

sont entièrement opérationnels.

----

====== Sprint 5-E.1 — Reservation Analytics & Revenue KPIs ======

===== Objectif =====

Mettre en place le cockpit analytique des réservations.

Cette couche fournit une vision complète de :

<code>
Réservations

Revenus

Annulations

Voyageurs

Performance

Conversion
</code>

afin de piloter l'activité commerciale et opérationnelle.

À l'issue de cette étape :

<code>
✓ Reservation Dashboard

✓ Booking Analytics

✓ Revenue KPIs

✓ Cancellation Analytics

✓ Guest Analytics

✓ Reservation Performance

✓ Reservation Intelligence Dashboard
</code>

----

====== Architecture cible ======

<code>
Reservations

↓

Reservation Analytics

├── Booking Analytics
├── Revenue Analytics
├── Cancellation Analytics
├── Guest Analytics
├── Conversion Analytics
└── KPI Dashboard

↓

Revenue Management

↓

Executive Reporting
</code>

----

====== Sprint 5-E.1-A ======

===== Extension Prisma =====

----

====== Étape 1 — ReservationAnalyticsSnapshot ======

===== Ajouter dans schema.prisma =====

<code prisma>
model ReservationAnalyticsSnapshot {

id                    String
                        @id
                        @default(uuid())

tenantId              String

snapshotDate          DateTime

reservationsCount     Int
                        @default(0)

confirmedBookings     Int
                        @default(0)

cancelledBookings     Int
                        @default(0)

revenue               Decimal
                        @db.Decimal(14,2)

averageBookingValue   Decimal
                        @db.Decimal(14,2)

averageLengthOfStay   Float?

occupancyImpact       Float?

createdAt             DateTime
                        @default(now())

@@index([tenantId])

@@index([snapshotDate])
}
</code>

----

====== Étape 2 — ReservationKPI ======

===== Ajouter =====

<code prisma>
model ReservationKPI {

tenantId              String
                        @id

bookingConversionRate Float?

cancellationRate      Float?

averageBookingValue   Float?

averageStayLength     Float?

repeatGuestRate       Float?

revenuePerBooking     Float?

updatedAt             DateTime
                        @updatedAt
}
</code>

----

====== Étape 3 — Migration ======

===== Générer =====

<code bash>
npx prisma migrate dev \
--name reservation_analytics
</code>

----

====== Sprint 5-E.1-B ======

===== Reservation Analytics Module =====

----

====== Étape 4 — Création ======

<code>
src/modules/reservation-analytics

├── dashboard
│
├── bookings
│
├── revenue
│
├── cancellations
│
├── guests
│
├── performance
│
└── reservation-analytics.module.ts
</code>

----

====== Étape 5 — Services ======

===== Créer =====

<code>
ReservationDashboardService

BookingAnalyticsService

RevenueKPIService

CancellationAnalyticsService

GuestAnalyticsService

ReservationPerformanceService
</code>

----

====== Sprint 5-E.1-C ======

===== Booking Analytics =====

----

====== Étape 6 — BookingAnalyticsService ======

===== Créer =====

<code>
booking-analytics.service.ts
</code>

----

===== Méthodes =====

<code ts>
calculateBookings()

calculateBookingTrend()

analyzeBookingSources()

analyzeLeadTime()
</code>

----

====== Étape 7 — Mesurer ======

<code>
Total Reservations

Confirmed Reservations

Pending Reservations

No Shows

Lead Time
</code>

----

====== Étape 8 — Sources ======

===== Analyser =====

<code>
Direct

Website

Mobile App

Airbnb

Booking

Expedia
</code>

----

====== Sprint 5-E.1-D ======

===== Revenue KPIs =====

----

====== Étape 9 — RevenueKPIService ======

===== Créer =====

<code>
revenue-kpi.service.ts
</code>

----

===== Calculer =====

<code>
Gross Revenue

Net Revenue

Average Booking Value

Revenue Per Booking

Revenue Growth
</code>

----

====== Étape 10 — Exemple ======

<code>
Revenue

125 000 €

↑ 14%
</code>

----

====== Étape 11 — Intégration ======

===== Utiliser =====

<code>
Reservation

Payments

Invoices

Refunds
</code>

----

====== Sprint 5-E.1-E ======

===== Cancellation Analytics =====

----

====== Étape 12 — CancellationAnalyticsService ======

===== Créer =====

<code>
cancellation-analytics.service.ts
</code>

----

===== Méthodes =====

<code ts>
calculateCancellationRate()

analyzeCancellationReasons()

forecastCancellationRisk()
</code>

----

====== Étape 13 — Mesurer ======

<code>
Cancellation Rate

Refund Rate

No Show Rate

Cancellation Cost
</code>

----

====== Étape 14 — Segmentation ======

===== Analyser =====

par :

<code>
Property

Source

Country

Season
</code>

----

====== Sprint 5-E.1-F ======

===== Guest Analytics =====

----

====== Étape 15 — GuestAnalyticsService ======

===== Créer =====

<code>
guest-analytics.service.ts
</code>

----

===== Mesurer =====

<code>
Repeat Guests

New Guests

Average Group Size

Countries

Guest Lifetime Value
</code>

----

====== Étape 16 — Méthodes ======

<code ts>
calculateRepeatGuestRate()

analyzeGuestOrigins()

calculateGuestLTV()
</code>

----

====== Étape 17 — CRM ======

===== Alimenter =====

<code>
Customer Score

Customer Segment

Loyalty Program
</code>

----

====== Sprint 5-E.1-G ======

===== Reservation Performance =====

----

====== Étape 18 — ReservationPerformanceService ======

===== Créer =====

<code>
reservation-performance.service.ts
</code>

----

===== Calculer =====

<code>
Booking Conversion

Booking Velocity

Reservation Growth

Channel Performance

Forecast Accuracy
</code>

----

====== Étape 19 — Classements ======

===== Identifier =====

<code>
Best Performing Properties

Best Channels

Best Markets
</code>

----

====== Étape 20 — KPI Score ======

===== Construire =====

<code>
Booking Score

Revenue Score

Guest Score

Cancellation Score

Global Reservation Score
</code>

----

====== Sprint 5-E.1-H ======

===== Dashboard Principal =====

----

====== Étape 21 — ReservationDashboardService ======

===== Créer =====

<code>
reservation-dashboard.service.ts
</code>

----

===== Agréger =====

<code>
Bookings

Revenue

Guests

Cancellations

Performance
</code>

----

====== Étape 22 — Endpoint ======

===== Ajouter =====

<code http>
GET /reservations/dashboard
</code>

----

====== Étape 23 — Exemple ======

===== Réponse =====

<code json>
{
  "bookings":842,
  "revenue":125000,
  "cancellationRate":4.2,
  "repeatGuests":31,
  "bookingScore":89
}
</code>

----

====== Sprint 5-E.1-I ======

===== API Analytics =====

----

====== Étape 24 — Endpoints ======

===== Ajouter =====

<code http>
GET /reservations/dashboard

GET /reservations/analytics/bookings

GET /reservations/analytics/revenue

GET /reservations/analytics/cancellations

GET /reservations/analytics/guests

GET /reservations/analytics/performance
</code>

----

====== Étape 25 — Filtres ======

===== Supporter =====

<code>
Today

7 Days

30 Days

90 Days

12 Months

Custom Range
</code>

----

====== Étape 26 — Export ======

===== Ajouter =====

<code http>
GET /reservations/analytics/export
</code>

Formats :

<code>
CSV

Excel

PDF
</code>

----

====== Sprint 5-E.1-J ======

===== Gouvernance =====

----

====== Étape 27 — Permissions ======

===== Ajouter =====

<code>
reservation.analytics.read

reservation.analytics.export

reservation.analytics.kpi

reservation.analytics.admin
</code>

----

====== Étape 28 — Audit ======

===== Journaliser =====

<code>
RESERVATION_DASHBOARD_VIEWED

BOOKING_ANALYTICS_VIEWED

REVENUE_KPI_CALCULATED

CANCELLATION_ANALYTICS_VIEWED

ANALYTICS_EXPORTED
</code>

----

====== Étape 29 — Jobs ======

===== Ajouter =====

<code>
Toutes les heures

KPI Refresh

Toutes les nuits

Analytics Snapshot

Forecast Refresh
</code>

----

====== Préparation Sprint 5-E.2 ======

Compatible avec :

<code>
Fraud Detection

Revenue Forecast

Reservation Intelligence

Predictive Booking
</code>

----

====== Définition de terminé ======

Le Sprint 5-E.1 est terminé lorsque :

<code>
✓ Reservation Dashboard

✓ Booking Analytics

✓ Revenue KPIs

✓ Cancellation Analytics

✓ Guest Analytics

✓ Reservation Performance

✓ Export Analytics

✓ Audit intégré
</code>

----

====== Livrables ======

<code>
ReservationAnalyticsSnapshot

ReservationKPI

ReservationDashboardService

BookingAnalyticsService

RevenueKPIService

CancellationAnalyticsService

GuestAnalyticsService

ReservationPerformanceService

Reservation Analytics Platform
</code>

----

====== Sprint 5-E.2 — Reservation Intelligence & Analytics Prédictifs ======

===== Objectif =====

Transformer le moteur analytique de réservation en plateforme Reservation Intelligence Enterprise.

Cette couche permet :

<code>
Prévision

Détection de fraude

Prédiction d'annulation

Analyse de risque

Optimisation des revenus

Pilotage intelligent
</code>

À l'issue de cette étape :

<code>
✓ Prévision réservations

✓ Prévision revenus

✓ Fraud Detection

✓ Cancellation Prediction

✓ Guest Risk Score

✓ Reservation Health Score

✓ Reservation Intelligence Platform
</code>

----

====== Architecture cible ======

<code>
Reservation Analytics

↓

Reservation Intelligence Engine

├── Booking Forecast
├── Revenue Forecast
├── Cancellation Prediction
├── Fraud Detection
├── Guest Risk Scoring
├── Health Scoring
└── AI Recommendations

↓

Revenue Management

↓

Executive Intelligence
</code>

----

====== Sprint 5-E.2-A ======

===== Extension Prisma =====

----

====== Étape 1 — ReservationForecast ======

===== Ajouter dans schema.prisma =====

<code prisma>
model ReservationForecast {

id                    String
                        @id
                        @default(uuid())

tenantId              String

forecastType          ReservationForecastType

forecastDate          DateTime

predictedValue        Float

confidenceScore       Float?

generatedAt           DateTime
                        @default(now())

@@index([tenantId])

@@index([forecastType])

@@index([forecastDate])
}
</code>

----

====== Étape 2 — ReservationInsight ======

===== Ajouter =====

<code prisma>
model ReservationInsight {

id                    String
                        @id
                        @default(uuid())

tenantId              String

category              ReservationInsightCategory

severity              InsightSeverity

title                 String

description           String

recommendation        String?

impactScore           Float?

resolved              Boolean
                        @default(false)

createdAt             DateTime
                        @default(now())

@@index([tenantId])

@@index([category])

@@index([resolved])
}
</code>

----

====== Étape 3 — GuestRiskScore ======

===== Ajouter =====

<code prisma>
model GuestRiskScore {

guestId               String
                        @id

overallRisk           Float

fraudRisk             Float

cancellationRisk      Float

paymentRisk           Float

behaviorRisk          Float

calculatedAt          DateTime
                        @updatedAt
}
</code>

----

====== Étape 4 — ReservationHealthScore ======

===== Ajouter =====

<code prisma>
model ReservationHealthScore {

reservationId         String
                        @id

overallScore          Float

paymentScore          Float

guestScore            Float

fraudScore            Float

completionScore       Float

calculatedAt          DateTime
                        @updatedAt
}
</code>

----

====== Étape 5 — Enums ======

===== Ajouter =====

<code prisma>
enum ReservationForecastType {

BOOKINGS

REVENUE

CANCELLATIONS

OCCUPANCY
}

enum ReservationInsightCategory {

BOOKINGS

REVENUE

CANCELLATION

FRAUD

GUEST
}
</code>

----

====== Étape 6 — Migration ======

===== Générer =====

<code bash>
npx prisma migrate dev \
--name reservation_intelligence
</code>

----

====== Sprint 5-E.2-B ======

===== Intelligence Module =====

----

====== Étape 7 — Création ======

<code>
src/modules/reservation-intelligence

├── forecasts
│
├── fraud
│
├── cancellation
│
├── risk
│
├── insights
│
├── health-score
│
└── reservation-intelligence.module.ts
</code>

----

====== Étape 8 — Services ======

===== Créer =====

<code>
BookingForecastService

RevenueForecastService

CancellationPredictionService

FraudDetectionService

GuestRiskScoreService

ReservationHealthScoreService

ReservationInsightService
</code>

----

====== Sprint 5-E.2-C ======

===== Prévision des Réservations =====

----

====== Étape 9 — BookingForecastService ======

===== Créer =====

<code>
booking-forecast.service.ts
</code>

----

===== Méthodes =====

<code ts>
forecastBookings()

forecastOccupancyImpact()

forecastSeasonality()
</code>

----

====== Étape 10 — Sources ======

===== Utiliser =====

<code>
Reservations

Property Analytics

Seasonality

Events

Historical Trends
</code>

----

====== Étape 11 — Exemple ======

<code>
30 prochains jours

Prévision

+18%

Réservations
</code>

----

====== Sprint 5-E.2-D ======

===== Prévision des Revenus =====

----

====== Étape 12 — RevenueForecastService ======

===== Créer =====

<code>
revenue-forecast.service.ts
</code>

----

===== Méthodes =====

<code ts>
forecastRevenue()

forecastADR()

forecastRevPAR()

forecastCashFlow()
</code>

----

====== Étape 13 — Alimenter ======

avec :

<code>
Reservations

Invoices

Payments

Refunds
</code>

----

====== Étape 14 — Exemple ======

<code>
Revenue Forecast

145 000 €

+11%
</code>

----

====== Sprint 5-E.2-E ======

===== Prédiction d'Annulation =====

----

====== Étape 15 — CancellationPredictionService ======

===== Créer =====

<code>
cancellation-prediction.service.ts
</code>

----

===== Méthodes =====

<code ts>
predictCancellation()

calculateCancellationRisk()

recommendRetentionAction()
</code>

----

====== Étape 16 — Variables ======

===== Utiliser =====

<code>
Lead Time

Country

Booking Source

Past Behavior

Price Sensitivity
</code>

----

====== Étape 17 — Exemple ======

<code>
Reservation

#RSV-1001

Cancellation Risk

72%
</code>

----

====== Étape 18 — Actions ======

===== Recommander =====

<code>
Reminder

Special Offer

Deposit Request
</code>

----

====== Sprint 5-E.2-F ======

===== Fraud Detection =====

----

====== Étape 19 — FraudDetectionService ======

===== Créer =====

<code>
fraud-detection.service.ts
</code>

----

===== Détecter =====

<code>
Card Fraud

Identity Fraud

Chargeback Risk

Multi Account Abuse

Bot Activity
</code>

----

====== Étape 20 — Méthodes ======

<code ts>
calculateFraudRisk()

detectSuspiciousPatterns()

triggerFraudAlert()
</code>

----

====== Étape 21 — Sources ======

===== Utiliser =====

<code>
Payments

Guest Verification

Connection History

Behavior Analysis
</code>

----

====== Étape 22 — Alertes ======

===== Générer =====

<code>
LOW

MEDIUM

HIGH

CRITICAL
</code>

----

====== Sprint 5-E.2-G ======

===== Guest Risk Score =====

----

====== Étape 23 — GuestRiskScoreService ======

===== Créer =====

<code>
guest-risk-score.service.ts
</code>

----

===== Calcul =====

<code>
Fraude

Paiement

Historique

Annulations

Incidents
</code>

----

====== Étape 24 — Classification ======

<code>
0-25    Low Risk

26-50   Moderate

51-75   High

76-100  Critical
</code>

----

====== Étape 25 — Exemple ======

<code>
Guest Risk

18

Low Risk
</code>

----

====== Sprint 5-E.2-H ======

===== Reservation Health Score =====

----

====== Étape 26 — ReservationHealthScoreService ======

===== Créer =====

<code>
reservation-health-score.service.ts
</code>

----

===== Calcul =====

<code>
Payment Status      30%

Guest Risk          25%

Fraud Risk          20%

Workflow Progress   15%

Communication       10%
</code>

----

====== Étape 27 — Classification ======

<code>
90-100 Excellent

75-89 Healthy

50-74 At Risk

0-49 Critical
</code>

----

====== Étape 28 — Exemple ======

<code>
Reservation Health

91

Excellent
</code>

----

====== Sprint 5-E.2-I ======

===== Insights IA =====

----

====== Étape 29 — ReservationInsightService ======

===== Créer =====

<code>
reservation-insight.service.ts
</code>

----

===== Générer =====

<code>
Opportunités revenus

Risques annulation

Segments performants

Canaux performants

Alertes fraude
</code>

----

====== Étape 30 — Exemple ======

<code>
Les réservations Airbnb

↑ 24%

↓

Renforcer ce canal
</code>

----

====== Étape 31 — Exemple ======

<code>
Les annulations augmentent

sur les réservations >60 jours

↓

Adapter la politique
</code>

----

====== Sprint 5-E.2-J ======

===== Dashboard Intelligence =====

----

====== Étape 32 — Endpoints ======

===== Ajouter =====

<code http>
GET /reservations/intelligence

GET /reservations/forecasts

GET /reservations/insights

GET /reservations/fraud

GET /reservations/health-score

GET /guests/{id}/risk-score
</code>

----

====== Étape 33 — Réponse ======

===== Exemple =====

<code json>
{
  "bookingForecast":1240,
  "revenueForecast":145000,
  "cancellationRisk":12,
  "fraudAlerts":2,
  "healthScore":91
}
</code>

----

====== Étape 34 — Analytics IA ======

===== Mesurer =====

<code>
Forecast Accuracy

Fraud Detection Rate

Cancellation Prediction Accuracy

Health Score Trends

Insight Adoption
</code>

----

====== Gouvernance ======

----

====== Étape 35 — Permissions ======

===== Ajouter =====

<code>
reservation.intelligence.read

reservation.intelligence.forecast

reservation.intelligence.fraud

reservation.intelligence.health

reservation.intelligence.admin
</code>

----

====== Étape 36 — Audit ======

===== Journaliser =====

<code>
FORECAST_GENERATED

FRAUD_ALERT_TRIGGERED

CANCELLATION_RISK_CALCULATED

GUEST_RISK_UPDATED

HEALTH_SCORE_UPDATED

INTELLIGENCE_DASHBOARD_VIEWED
</code>

----

====== Étape 37 — Jobs ======

===== Ajouter =====

<code>
Toutes les heures

Fraud Detection

Toutes les nuits

Forecast Generation

Risk Recalculation

Insight Generation
</code>

----

====== Clôture Sprint 5 ======

À la fin du Sprint 5, la plateforme dispose désormais de :

<code>
✓ Reservation Engine

✓ Booking Workflow

✓ Payment Platform

✓ Invoicing Platform

✓ Digital Check-In

✓ Digital Check-Out

✓ Service Desk

✓ Housekeeping

✓ Maintenance

✓ Reservation Analytics

✓ Reservation Intelligence
</code>

----

====== Préparation Sprint 6 ======

Compatible avec :

<code>
Multi Property Management

Portfolio Management

Owners

Operators

Asset Management
</code>

----

====== Préparation Sprint 20 ======

Compatible avec :

<code>
Enterprise Hospitality OS

AI Revenue Platform

Predictive Operations

Global Reservation Intelligence
</code>

----

====== Définition de terminé ======

Le Sprint 5-E.2 est terminé lorsque :

<code>
✓ Prévision réservations

✓ Prévision revenus

✓ Fraud Detection

✓ Cancellation Prediction

✓ Guest Risk Score

✓ Reservation Health Score

✓ Insights IA

✓ Dashboard Intelligence
</code>

----

====== Livrables ======

<code>
ReservationForecast

ReservationInsight

GuestRiskScore

ReservationHealthScore

BookingForecastService

RevenueForecastService

CancellationPredictionService

FraudDetectionService

GuestRiskScoreService

ReservationHealthScoreService

ReservationInsightService

Reservation Intelligence Platform
</code>

Résumé

Note : En modifiant cette page, vous acceptez que le contenu soit placé sous les termes de la licence suivante : CC Attribution-Share Alike 4.0 International