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 4 — Gestion des Propriétés ======

===== Objectif =====

Construire le domaine métier principal de la plateforme :

<code>
Property
PropertyType
PropertyAmenity
PropertyImage
PropertyAvailability
PropertyPricing
PropertyPolicy
PropertyReview
</code>

afin de permettre :

<code>
Catalogue de propriétés

Gestion des disponibilités

Gestion tarifaire

Avis clients

Moteur de réservation

Recherche avancée

Revenue Management

Channel Management Ready
</code>

----

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

<code>
Property

├── PropertyType
├── PropertyAmenity
├── PropertyImage
├── PropertyAvailability
├── PropertyPricing
├── PropertyPolicy
└── PropertyReview

↓

Reservation Engine

↓

CRM

↓

Revenue Engine
</code>

----

====== Sous-domaines du Sprint 4 ======

===== Sprint 4-A =====

Modèle Property Core

<code>
Property

PropertyType

PropertyAmenity

Relations

Multi-tenant
</code>

----

===== Sprint 4-B =====

Catalogue des Propriétés

<code>
PropertyModule

CRUD

Recherche

Pagination

Filtres
</code>

----

===== Sprint 4-C =====

Gestion des Équipements

<code>
Amenities

Catégories

Recherche

Attribution
</code>

----

===== Sprint 4-D =====

Gestion des Images

<code>
PropertyImage

Upload

Galerie

Ordonnancement

MinIO/S3
</code>

----

===== Sprint 4-E =====

Disponibilités

<code>
PropertyAvailability

Calendrier

Blocages

Inventaire
</code>

----

===== Sprint 4-F =====

Tarification

<code>
PropertyPricing

Tarifs saisonniers

Tarifs dynamiques

Revenue Ready
</code>

----

===== Sprint 4-G =====

Politiques

<code>
PropertyPolicy

Annulation

Check-in

Check-out

Règlement
</code>

----

===== Sprint 4-H =====

Avis Clients

<code>
PropertyReview

Notation

Modération

Réputation
</code>

----

===== Sprint 4-I =====

Recherche Avancée

<code>
Recherche géographique

Disponibilités

Prix

Filtres avancés
</code>

----

===== Sprint 4-J =====

Analytics & Intelligence

<code>
Performance propriétés

Occupation

Revenue

Recommandations
</code>

----

====== Architecture technique cible ======

<code>
src/modules

property
property-types
property-amenities
property-images
property-availability
property-pricing
property-policies
property-reviews

property-search
property-analytics
</code>

----

====== Modèles principaux à livrer ======

<code>
Property

PropertyType

PropertyAmenity

PropertyImage

PropertyAvailability

PropertyPricing

PropertyPolicy

PropertyReview
</code>

----

====== Capacités Enterprise attendues ======

<code>
✓ Multi-tenant

✓ AuditLog

✓ CRM Integration

✓ Reservation Ready

✓ Revenue Ready

✓ Analytics Ready

✓ Search Ready

✓ AI Ready

✓ Channel Manager Ready
</code>

----

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

Le Sprint 4 est terminé lorsque :

<code>
✓ Catalogue complet

✓ Disponibilités

✓ Tarification

✓ Politiques

✓ Avis

✓ Recherche

✓ Analytics

✓ Réservation Ready
</code>

----

====== Sprint 4-A.1 — Implémentation Prisma Property Core ======

===== Objectif =====

Créer les fondations du domaine métier Property.

À l'issue de cette étape :

<code>
✓ Property

✓ PropertyType

✓ PropertyAmenity

✓ Multi-tenant

✓ Catalogue Ready

✓ Reservation Ready

✓ CRM Ready

✓ Analytics Ready
</code>

----

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

<code>
Property

├── PropertyType
├── PropertyAmenity
├── PropertyImage
├── PropertyAvailability
├── PropertyPricing
├── PropertyPolicy
└── PropertyReview

↓

Reservation Engine

↓

Revenue Engine
</code>

----

====== Sprint 4-A.1-A ======

===== PropertyType =====

----

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

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

<code prisma>
model PropertyType {

id                    String
                        @id
                        @default(uuid())

tenantId              String

code                  String

name                  String

description           String?

icon                  String?

active                Boolean
                        @default(true)

displayOrder          Int
                        @default(0)

createdAt             DateTime
                        @default(now())

updatedAt             DateTime
                        @updatedAt

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

properties            Property[]

@@unique([
    tenantId,
    code
  ])

@@index([tenantId])

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

----

====== Étape 2 — Types par défaut ======

===== Prévoir =====

<code>
HOTEL_ROOM

APARTMENT

HOUSE

VILLA

STUDIO

HOSTEL

RESORT

CHALET

CAMPING

OTHER
</code>

----

====== Sprint 4-A.1-B ======

===== PropertyAmenity =====

----

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

===== Ajouter =====

<code prisma>
model PropertyAmenity {

id                    String
                        @id
                        @default(uuid())

tenantId              String

code                  String

name                  String

description           String?

category              String?

icon                  String?

active                Boolean
                        @default(true)

createdAt             DateTime
                        @default(now())

updatedAt             DateTime
                        @updatedAt

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

properties            PropertyAmenityAssignment[]

@@unique([
    tenantId,
    code
  ])

@@index([tenantId])

@@index([category])

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

----

====== Étape 4 — Relation M:N ======

===== Ajouter =====

<code prisma>
model PropertyAmenityAssignment {

id                    String
                        @id
                        @default(uuid())

propertyId            String

amenityId             String

createdAt             DateTime
                        @default(now())

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

amenity               PropertyAmenity
                        @relation(
                          fields:[amenityId],
                          references:[id],
                          onDelete:Cascade
                        )

@@unique([
    propertyId,
    amenityId
  ])

@@index([propertyId])

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

----

====== Étape 5 — Catégories standards ======

===== Prévoir =====

<code>
GENERAL

KITCHEN

BATHROOM

BEDROOM

CONNECTIVITY

SECURITY

ACCESSIBILITY

ENTERTAINMENT

OUTDOOR

PARKING
</code>

----

====== Sprint 4-A.1-C ======

===== Property =====

----

====== Étape 6 — Création ======

===== Ajouter =====

<code prisma>
model Property {

id                    String
                        @id
                        @default(uuid())

tenantId              String

propertyTypeId        String

propertyNumber        String

externalReference     String?

name                  String

slug                  String

description           String?

shortDescription      String?

active                Boolean
                        @default(true)

featured              Boolean
                        @default(false)

published             Boolean
                        @default(false)

maxGuests             Int
                        @default(1)

bedrooms              Int
                        @default(0)

bathrooms             Int
                        @default(0)

beds                  Int
                        @default(1)

floorArea             Decimal?
                        @db.Decimal(10,2)

floorAreaUnit         String?
                        @default("m²")

createdAt             DateTime
                        @default(now())

updatedAt             DateTime
                        @updatedAt

deletedAt             DateTime?

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

propertyType          PropertyType
                        @relation(
                          fields:[propertyTypeId],
                          references:[id]
                        )

amenities             PropertyAmenityAssignment[]

@@unique([
    tenantId,
    propertyNumber
  ])

@@unique([
    tenantId,
    slug
  ])

@@index([tenantId])

@@index([propertyTypeId])

@@index([active])

@@index([published])

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

----

====== Étape 7 — Capacités réservation ======

===== Ajouter =====

<code prisma>
minimumStay           Int?
                      @default(1)

maximumStay           Int?

advanceBookingDays    Int?

instantBooking        Boolean
                      @default(false)
</code>

----

====== Étape 8 — Capacités CRM ======

===== Ajouter =====

<code prisma>
ownerName             String?

ownerEmail            String?

ownerPhone            String?
</code>

----

====== Étape 9 — Capacités Analytics ======

===== Ajouter =====

<code prisma>
viewCount             Int
                      @default(0)

bookingCount          Int
                      @default(0)

averageRating         Float?
</code>

----

====== Sprint 4-A.1-D ======

===== Adresse Property =====

----

====== Étape 10 — Création ======

===== Ajouter =====

<code prisma>
model PropertyAddress {

id                    String
                        @id
                        @default(uuid())

propertyId            String
                        @unique

addressLine1          String

addressLine2          String?

postalCode            String?

city                  String

region                String?

country               String

latitude              Decimal?
                        @db.Decimal(10,7)

longitude             Decimal?
                        @db.Decimal(10,7)

timezone              String?

geoValidated          Boolean
                        @default(false)

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

@@index([city])

@@index([country])

@@index([latitude])

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

----

====== Étape 11 — Relation ======

===== Ajouter dans Property =====

<code prisma>
address PropertyAddress?
</code>

----

====== Sprint 4-A.1-E ======

===== SEO & Catalogue =====

----

====== Étape 12 — SEO ======

===== Ajouter dans Property =====

<code prisma>
seoTitle             String?

seoDescription       String?

seoKeywords          String?
</code>

----

====== Étape 13 — Publication ======

===== Ajouter =====

<code prisma>
publishedAt          DateTime?

publishedBy          String?
</code>

----

====== Étape 14 — Visibilité ======

===== Ajouter =====

<code prisma>
visibility           PropertyVisibility
                      @default(PRIVATE)
</code>

----

====== Étape 15 — Enum ======

===== Ajouter =====

<code prisma>
enum PropertyVisibility {

PRIVATE

INTERNAL

PUBLIC
}
</code>

----

====== Sprint 4-A.1-F ======

===== Audit & Historisation =====

----

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

Compatible avec :

<code>
AuditLog

PropertyHistory

Reservation

ChannelManager
</code>

----

====== Étape 17 — Champs métier ======

===== Ajouter =====

<code prisma>
metadata Json?
</code>

----

====== Sprint 4-A.1-G ======

===== Seed Initial =====

----

====== Étape 18 — Property Types ======

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

Dans le seed :

<code>
HOTEL_ROOM

APARTMENT

HOUSE

VILLA

STUDIO
</code>

----

====== Étape 19 — Amenities ======

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

<code>
WIFI

AIR_CONDITIONING

PARKING

POOL

TV

KITCHEN

WASHING_MACHINE

BREAKFAST

PET_FRIENDLY
</code>

----

====== Sprint 4-A.1-H ======

===== Migration =====

----

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

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

----

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

<code bash>
npx prisma generate
</code>

----

====== Étape 21 — Vérification ======

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

<code>
Property

PropertyType

PropertyAmenity

PropertyAmenityAssignment

PropertyAddress
</code>

présents dans Prisma Client.

----

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

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

<code>
✓ Property créé

✓ PropertyType créé

✓ PropertyAmenity créé

✓ PropertyAmenityAssignment créé

✓ PropertyAddress créé

✓ Multi-tenant prêt

✓ Catalogue prêt

✓ Réservation prête

✓ Analytics prêt
</code>

----

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

<code>
Property

PropertyType

PropertyAmenity

PropertyAmenityAssignment

PropertyAddress

PropertyVisibility
</code>

----

====== Sprint 4-A.2 — Extension Enterprise du modèle Property ======

===== Objectif =====

Transformer le modèle Property en véritable référentiel immobilier Enterprise.

À l'issue de cette étape :

<code>
✓ PropertyStatus

✓ PropertyCategory

✓ PropertyOwner

✓ PropertyManager

✓ PropertyFeatures

✓ PropertyCompliance

✓ PropertyScore

✓ PropertyLifecycle

✓ Revenue Ready

✓ Enterprise Ready
</code>

----

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

<code>
Property

├── PropertyType
├── PropertyCategory
├── PropertyOwner
├── PropertyManager
├── PropertyFeatures
├── PropertyCompliance
├── PropertyScore
└── PropertyLifecycle

↓

Reservation

↓

Revenue

↓

Analytics

↓

Compliance
</code>

----

====== Sprint 4-A.2-A ======

===== Property Status =====

----

====== Étape 1 — Enum PropertyStatus ======

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

<code prisma>
enum PropertyStatus {

DRAFT

PENDING_REVIEW

ACTIVE

INACTIVE

SUSPENDED

ARCHIVED
}
</code>

----

====== Étape 2 — Ajouter dans Property ======

<code prisma>
status PropertyStatus
       @default(DRAFT)
</code>

----

====== Étape 3 — Dates de cycle ======

===== Ajouter =====

<code prisma>
activatedAt          DateTime?

deactivatedAt        DateTime?

archivedAt           DateTime?
</code>

----

====== Sprint 4-A.2-B ======

===== Property Category =====

----

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

===== Ajouter =====

<code prisma>
model PropertyCategory {

id                    String
                        @id
                        @default(uuid())

tenantId              String

code                  String

name                  String

description           String?

parentCategoryId      String?

active                Boolean
                        @default(true)

createdAt             DateTime
                        @default(now())

updatedAt             DateTime
                        @updatedAt

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

parentCategory        PropertyCategory?
                        @relation(
                          "PropertyCategoryTree",
                          fields:[parentCategoryId],
                          references:[id]
                        )

children              PropertyCategory[]
                        @relation(
                          "PropertyCategoryTree"
                        )

properties            Property[]

@@unique([
    tenantId,
    code
  ])

@@index([tenantId])

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

----

====== Étape 5 — Relation ======

===== Ajouter dans Property =====

<code prisma>
propertyCategoryId String?

propertyCategory PropertyCategory?
                 @relation(
                   fields:[propertyCategoryId],
                   references:[id]
                 )
</code>

----

====== Étape 6 — Catégories ======

===== Prévoir =====

<code>
LUXURY

BUSINESS

FAMILY

BUDGET

LONG_STAY

SHORT_STAY

PREMIUM

CORPORATE
</code>

----

====== Sprint 4-A.2-C ======

===== Property Owner =====

----

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

===== Ajouter =====

<code prisma>
model PropertyOwner {

id                    String
                        @id
                        @default(uuid())

tenantId              String

code                  String

companyName           String?

firstName             String?

lastName              String?

email                 String?

phone                 String?

taxNumber             String?

active                Boolean
                        @default(true)

metadata              Json?

createdAt             DateTime
                        @default(now())

updatedAt             DateTime
                        @updatedAt

properties            Property[]

@@unique([
    tenantId,
    code
  ])

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

----

====== Étape 8 — Relation ======

===== Ajouter dans Property =====

<code prisma>
propertyOwnerId String?

propertyOwner PropertyOwner?
              @relation(
                fields:[propertyOwnerId],
                references:[id]
              )
</code>

----

====== Sprint 4-A.2-D ======

===== Property Manager =====

----

====== Étape 9 — Création ======

===== Ajouter =====

<code prisma>
model PropertyManager {

id                    String
                        @id
                        @default(uuid())

tenantId              String

userId                String?

code                  String

name                  String

email                 String?

phone                 String?

active                Boolean
                        @default(true)

createdAt             DateTime
                        @default(now())

updatedAt             DateTime
                        @updatedAt

properties            Property[]

@@unique([
    tenantId,
    code
  ])

@@index([tenantId])

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

----

====== Étape 10 — Relation ======

===== Ajouter dans Property =====

<code prisma>
propertyManagerId String?

propertyManager PropertyManager?
                @relation(
                  fields:[propertyManagerId],
                  references:[id]
                )
</code>

----

====== Sprint 4-A.2-E ======

===== Property Features =====

----

====== Étape 11 — Création ======

===== Ajouter =====

<code prisma>
model PropertyFeature {

id                    String
                        @id
                        @default(uuid())

tenantId              String

code                  String

name                  String

category              String?

active                Boolean
                        @default(true)

createdAt             DateTime
                        @default(now())

properties            PropertyFeatureAssignment[]

@@unique([
    tenantId,
    code
  ])

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

----

====== Étape 12 — Affectation ======

===== Ajouter =====

<code prisma>
model PropertyFeatureAssignment {

id                    String
                        @id
                        @default(uuid())

propertyId            String

featureId             String

value                 String?

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

feature               PropertyFeature
                        @relation(
                          fields:[featureId],
                          references:[id],
                          onDelete:Cascade
                        )

@@unique([
    propertyId,
    featureId
  ])
}
</code>

----

====== Étape 13 — Exemples ======

<code>
SEA_VIEW

MOUNTAIN_VIEW

BALCONY

TERRACE

PRIVATE_POOL

JACUZZI

SMART_LOCK

EV_CHARGER
</code>

----

====== Sprint 4-A.2-F ======

===== Property Compliance =====

----

====== Étape 14 — Création ======

===== Ajouter =====

<code prisma>
model PropertyCompliance {

id                    String
                        @id
                        @default(uuid())

propertyId            String
                        @unique

licenseNumber         String?

registrationNumber    String?

insurancePolicy       String?

insuranceExpiresAt    DateTime?

fireSafetyValidated   Boolean
                        @default(false)

accessibilityValidated Boolean
                         @default(false)

complianceScore       Int
                        @default(0)

lastAuditAt           DateTime?

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

----

====== Étape 15 — Relation ======

===== Ajouter dans Property =====

<code prisma>
compliance PropertyCompliance?
</code>

----

====== Sprint 4-A.2-G ======

===== Property Score =====

----

====== Étape 16 — Création ======

===== Ajouter =====

<code prisma>
model PropertyScore {

id                    String
                        @id
                        @default(uuid())

propertyId            String
                        @unique

qualityScore          Int
                        @default(0)

reviewScore           Int
                        @default(0)

occupancyScore        Int
                        @default(0)

revenueScore          Int
                        @default(0)

complianceScore       Int
                        @default(0)

globalScore           Int
                        @default(0)

calculatedAt          DateTime
                        @default(now())

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

----

====== Étape 17 — Relation ======

===== Ajouter dans Property =====

<code prisma>
score PropertyScore?
</code>

----

====== Sprint 4-A.2-H ======

===== Property Lifecycle =====

----

====== Étape 18 — Création ======

===== Ajouter =====

<code prisma>
model PropertyLifecycle {

id                    String
                        @id
                        @default(uuid())

propertyId            String
                        @unique

onboardingCompleted   Boolean
                        @default(false)

contentCompleted      Boolean
                        @default(false)

pricingCompleted      Boolean
                        @default(false)

availabilityCompleted Boolean
                        @default(false)

complianceCompleted   Boolean
                        @default(false)

publishedCompleted    Boolean
                        @default(false)

launchDate            DateTime?

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

----

====== Étape 19 — Relation ======

===== Ajouter dans Property =====

<code prisma>
lifecycle PropertyLifecycle?
</code>

----

====== Sprint 4-A.2-I ======

===== Analytics & Revenue Ready =====

----

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

===== Ajouter dans Property =====

<code prisma>
occupancyRate         Float?

revenueYtd            Decimal?
                      @db.Decimal(14,2)

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

revPar                Decimal?
                      @db.Decimal(12,2)
</code>

----

====== Étape 21 — Revenue Metrics ======

Compatible avec :

<code>
ADR

RevPAR

Occupancy

Yield Management
</code>

----

====== Sprint 4-A.2-J ======

===== Migration & Seed =====

----

====== Étape 22 — Seed ======

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

Catégories :

<code>
LUXURY

BUSINESS

FAMILY

PREMIUM

LONG_STAY
</code>

----

====== Étape 23 — Migration ======

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

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

----

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

<code bash>
npx prisma generate
</code>

----

====== Étape 24 — Audit Ready ======

===== Préparer =====

Compatible avec :

<code>
PropertyHistory

AuditLog

Reservation

ChannelManager

RevenueManagement
</code>

----

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

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

<code>
✓ PropertyStatus

✓ PropertyCategory

✓ PropertyOwner

✓ PropertyManager

✓ PropertyFeature

✓ PropertyCompliance

✓ PropertyScore

✓ PropertyLifecycle

✓ Revenue KPI

✓ Analytics Ready
</code>

----

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

<code>
PropertyCategory

PropertyOwner

PropertyManager

PropertyFeature

PropertyFeatureAssignment

PropertyCompliance

PropertyScore

PropertyLifecycle

PropertyStatus
</code>

----

====== Sprint 4-B.1 — Création du PropertyModule ======

===== Objectif =====

Implémenter le premier module métier complet du domaine Property.

À l'issue de cette étape :

<code>
✓ PropertyModule

✓ PropertyController

✓ PropertyService

✓ CRUD Property

✓ Recherche

✓ Pagination

✓ Multi-Tenant Security

✓ Swagger
</code>

----

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

<code>
PropertyModule

├── PropertyController
├── PropertyService
├── PropertyRepository
├── DTOs
├── Validators
└── Policies

↓

Prisma

↓

Property
</code>

----

====== Sprint 4-B.1-A ======

===== Structure du module =====

----

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

<code>
src/modules/property

├── application
│
│   └── dto
│
│       ├── create-property.dto.ts
│
│       ├── update-property.dto.ts
│
│       ├── property-query.dto.ts
│
│       └── property-response.dto.ts
│
├── domain
│
│   └── services
│
│       └── property.service.ts
│
├── presentation
│
│   └── controllers
│
│       └── property.controller.ts
│
├── property.module.ts
│
└── property.constants.ts
</code>

----

====== Étape 2 — Déclaration Module ======

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

<code ts>
@Module({

imports: [
    PrismaModule,
    AuthModule,
    AuditModule
  ],

controllers: [
    PropertyController
  ],

providers: [
    PropertyService
  ],

exports: [
    PropertyService
  ]
})
export class PropertyModule {}
</code>

----

====== Sprint 4-B.1-B ======

===== DTOs =====

----

====== Étape 3 — CreatePropertyDto ======

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

<code>
create-property.dto.ts
</code>

----

===== Implémentation =====

<code ts>
export class CreatePropertyDto {

propertyTypeId: string;

propertyNumber: string;

name: string;

slug: string;

description?: string;

shortDescription?: string;

maxGuests?: number;

bedrooms?: number;

bathrooms?: number;

beds?: number;

instantBooking?: boolean;

ownerName?: string;

ownerEmail?: string;

ownerPhone?: string;
}
</code>

----

====== Étape 4 — UpdatePropertyDto ======

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

<code ts>
export class UpdatePropertyDto
  extends PartialType(
    CreatePropertyDto
  ) {}
</code>

----

====== Étape 5 — PropertyQueryDto ======

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

<code ts>
export class PropertyQueryDto {

search?: string;

propertyTypeId?: string;

propertyCategoryId?: string;

status?: string;

published?: boolean;

featured?: boolean;

page?: number = 1;

limit?: number = 25;

sortBy?: string = 'createdAt';

sortOrder?: 'asc' | 'desc'
    = 'desc';
}
</code>

----

====== Sprint 4-B.1-C ======

===== PropertyService =====

----

====== Étape 6 — Création ======

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

<code>
property.service.ts
</code>

----

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

<code ts>
findAll()

findById()

create()

update()

remove()
</code>

----

====== Étape 7 — Create ======

===== Exemple =====

<code ts>
async create(
  tenantId: string,
  dto: CreatePropertyDto,
  userId: string,
) {

return this.prisma.property.create({

data: {

tenantId,

...dto
    }
  });
}
</code>

----

====== Étape 8 — Lecture ======

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

<code>
tenantId
</code>

sur toutes les requêtes.

----

===== Exemple =====

<code ts>
return this.prisma.property.findFirst({

where: {

id,

tenantId
  }
});
</code>

----

====== Étape 9 — Mise à jour ======

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

<code>
Property

Tenant

Permissions
</code>

avant modification.

----

====== Étape 10 — Suppression ======

===== Soft Delete =====

<code ts>
deletedAt:
  new Date()

status:
  PropertyStatus.ARCHIVED
</code>

----

====== Sprint 4-B.1-D ======

===== Recherche =====

----

====== Étape 11 — Recherche texte ======

===== Champs =====

<code>
name

description

propertyNumber

slug
</code>

----

===== Prisma =====

<code ts>
OR: [

{
    name: {
      contains: search,
      mode: 'insensitive'
    }
  },

{
    propertyNumber: {
      contains: search,
      mode: 'insensitive'
    }
  }
]
</code>

----

====== Étape 12 — Filtres ======

===== Supporter =====

<code>
PropertyType

Most Viewed Images
</code>

----

====== Étape 29 — Endpoint ======

===== Ajouter =====

<code http>
GET /media/analytics
</code>

----

====== Sprint 4-D.2-J ======

===== API Enterprise =====

----

====== Étape 30 — Endpoints ======

===== Ajouter =====

<code http>
POST /media/process

POST /media/watermark

POST /media/analyze

GET  /media/analytics

GET  /media/storage
</code>

----

====== Étape 31 — AuditLog ======

===== Journaliser =====

<code>
IMAGE_UPLOADED

IMAGE_PROCESSED

IMAGE_ANALYZED

IMAGE_WATERMARKED

IMAGE_OPTIMIZED
</code>

----

====== Étape 32 — Permissions ======

===== Ajouter =====

<code>
media.read

media.upload

media.process

media.analyze

media.admin
</code>

----

====== Préparation Sprint 4-H ======

Compatible avec :

<code>
Review Images

User Uploads

Moderation
</code>

----

====== Préparation Sprint 4-I ======

Compatible avec :

<code>
Property Search

AI Ranking

Visual Search
</code>

----

====== Préparation Sprint 13 ======

Compatible avec :

<code>
Computer Vision

Property Intelligence

AI Classification

Knowledge Graph
</code>

----

====== Préparation Sprint 20 ======

Compatible avec :

<code>
Enterprise Media Platform

Global CDN

AI Vision

Digital Asset Management
</code>

----

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

Le Sprint 4-D.2 est terminé lorsque :

<code>
✓ MinIO/S3 intégré

✓ CDN intégré

✓ Variantes d'images

✓ WebP

✓ Compression

✓ Watermark

✓ Vision IA

✓ Détection qualité

✓ Analytics média

✓ Audit intégré
</code>

----

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

<code>
StorageService

ImageProcessingService

CDNService

WatermarkService

VisionAnalysisService

MediaAnalyticsService

ImageVisionAnalysis

Enterprise Media Platform
</code>

----

====== Sprint 4-E.1 — Gestion des Disponibilités ======

===== Objectif =====

Implémenter le moteur de disponibilités des propriétés.

Cette couche constitue la fondation du futur moteur de réservation.

À l'issue de cette étape :

<code>
✓ PropertyAvailability

✓ PropertyAvailabilityModule

✓ PropertyAvailabilityController

✓ PropertyAvailabilityService

✓ Calendrier

✓ Blocages

✓ Inventaire

✓ Reservation Ready
</code>

----

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

<code>
Property

↓

PropertyAvailability

↓

Calendar Engine

↓

Inventory Engine

↓

Reservation Engine
</code>

----

====== Sprint 4-E.1-A ======

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

----

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

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

<code prisma>
model PropertyAvailability {

id                    String
                        @id
                        @default(uuid())

tenantId              String

propertyId            String

startDate             DateTime

endDate               DateTime

status                AvailabilityStatus

inventory             Int
                        @default(1)

availableUnits        Int
                        @default(1)

reason                String?

notes                 String?

createdAt             DateTime
                        @default(now())

updatedAt             DateTime
                        @updatedAt

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

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

@@index([tenantId])

@@index([propertyId])

@@index([startDate])

@@index([endDate])

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

----

====== Étape 2 — Enum ======

===== Ajouter =====

<code prisma>
enum AvailabilityStatus {

AVAILABLE

BLOCKED

RESERVED

MAINTENANCE

CLOSED
}
</code>

----

====== Étape 3 — Relation ======

===== Ajouter dans Property =====

<code prisma>
availabilities PropertyAvailability[]
</code>

----

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

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

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

----

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

<code bash>
npx prisma generate
</code>

----

====== Sprint 4-E.1-B ======

===== Module =====

----

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

<code>
src/modules/property-availability

├── application
│
│   └── dto
│
│       ├── create-property-availability.dto.ts
│
│       ├── update-property-availability.dto.ts
│
│       ├── availability-query.dto.ts
│
│       └── calendar-response.dto.ts
│
├── domain
│
│   └── services
│
│       └── property-availability.service.ts
│
├── presentation
│
│   └── controllers
│
│       └── property-availability.controller.ts
│
└── property-availability.module.ts
</code>

----

====== Étape 6 — Module ======

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

<code ts>
@Module({

imports: [
    PrismaModule,
    AuthModule,
    AuditModule
  ],

controllers: [
    PropertyAvailabilityController
  ],

providers: [
    PropertyAvailabilityService
  ],

exports: [
    PropertyAvailabilityService
  ]
})
export class PropertyAvailabilityModule {}
</code>

----

====== Sprint 4-E.1-C ======

===== DTOs =====

----

====== Étape 7 — CreatePropertyAvailabilityDto ======

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

<code ts>
export class CreatePropertyAvailabilityDto {

startDate: Date;

endDate: Date;

status: AvailabilityStatus;

inventory?: number;

availableUnits?: number;

reason?: string;

notes?: string;
}
</code>

----

====== Étape 8 — UpdatePropertyAvailabilityDto ======

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

<code ts>
export class UpdatePropertyAvailabilityDto
  extends PartialType(
    CreatePropertyAvailabilityDto
  ) {}
</code>

----

====== Étape 9 — AvailabilityQueryDto ======

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

<code ts>
export class AvailabilityQueryDto {

startDate?: Date;

endDate?: Date;

status?: AvailabilityStatus;
}
</code>

----

====== Sprint 4-E.1-D ======

===== PropertyAvailabilityService =====

----

====== Étape 10 — Création ======

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

<code>
property-availability.service.ts
</code>

----

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

<code ts>
findAll()

findCalendar()

create()

update()

remove()

checkAvailability()
</code>

----

====== Étape 11 — Création ======

===== Exemple =====

<code ts>
async create(
  tenantId: string,
  propertyId: string,
  dto: CreatePropertyAvailabilityDto,
) {

return this.prisma.propertyAvailability.create({

data: {

tenantId,

propertyId,

...dto
    }
  });
}
</code>

----

====== Étape 12 — Validation ======

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

<code>
startDate < endDate
</code>

et absence de conflits.

----

====== Étape 13 — Détection de chevauchement ======

===== Refuser =====

<code>
Périodes
superposées
</code>

pour les statuts incompatibles.

----

===== Prisma =====

<code ts>
where: {

propertyId,

startDate: {
    lte: dto.endDate
  },

endDate: {
    gte: dto.startDate
  }
}
</code>

----

====== Sprint 4-E.1-E ======

===== Calendrier =====

----

====== Étape 14 — Endpoint ======

===== Ajouter =====

<code http>
GET /properties/{id}/availability
</code>

----

====== Étape 15 — Vue calendrier ======

===== Retour =====

<code json>
[
  {
    "startDate":"2026-07-01",
    "endDate":"2026-07-10",
    "status":"AVAILABLE"
  }
]
</code>

----

====== Étape 16 — Vue mensuelle ======

===== Ajouter =====

<code http>
GET /properties/{id}/availability/calendar
</code>

----

===== Paramètres =====

<code>
month

year
</code>

----

====== Sprint 4-E.1-F ======

===== Blocages =====

----

====== Étape 17 — Supporter =====

<code>
Maintenance

Travaux

Usage privé

Fermeture saisonnière
</code>

----

====== Étape 18 — Exemple ======

<code json>
{
  "status":"MAINTENANCE",
  "reason":"Pool renovation"
}
</code>

----

====== Étape 19 — Endpoint ======

===== Ajouter =====

<code http>
POST /properties/{id}/availability/block
</code>

----

====== Sprint 4-E.1-G ======

===== Inventaire =====

----

====== Étape 20 — Support Multi-unités ======

===== Utiliser =====

<code>
inventory

availableUnits
</code>

----

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

<code>
Inventaire : 10

Disponibles : 7

Réservées : 3
</code>

----

====== Étape 22 — Vérification ======

===== Empêcher =====

<code>
availableUnits
>
inventory
</code>

----

====== Sprint 4-E.1-H ======

===== Contrôleur =====

----

====== Étape 23 — Création ======

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

<code>
property-availability.controller.ts
</code>

----

===== Déclaration =====

<code ts>
@ApiTags(
  'Property Availability'
)

@ApiBearerAuth()

@Controller(
  'properties/:id/availability'
)

@UseGuards(
  JwtAuthGuard
)
</code>

----

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

===== Ajouter =====

<code http>
GET    /properties/{id}/availability

GET    /properties/{id}/availability/calendar

POST   /properties/{id}/availability

PUT    /properties/{id}/availability/{availabilityId}

DELETE /properties/{id}/availability/{availabilityId}

POST   /properties/{id}/availability/block
</code>

----

====== Sprint 4-E.1-I ======

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

----

====== Étape 25 — Multi-Tenant ======

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

<code>
tenantId

propertyId
</code>

sur toutes les opérations.

----

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

===== Ajouter =====

<code>
property.availability.read

property.availability.create

property.availability.update

property.availability.delete

property.availability.manage
</code>

----

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

===== Journaliser =====

<code>
PROPERTY_AVAILABILITY_CREATED

PROPERTY_AVAILABILITY_UPDATED

PROPERTY_AVAILABILITY_DELETED

PROPERTY_BLOCKED

PROPERTY_UNBLOCKED
</code>

----

====== Sprint 4-E.1-J ======

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

----

====== Étape 28 — Compatibilité ======

Préparer :

<code>
Reservation

Booking Engine

Inventory Engine

Channel Manager
</code>

----

====== Étape 29 — Préparer ======

Compatible avec :

<code>
iCal

Airbnb

Booking.com

Expedia
</code>

----

====== Étape 30 — Préparer ======

Compatible avec :

<code>
Dynamic Pricing

Yield Management

Revenue Engine
</code>

----

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

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

<code>
✓ PropertyAvailability créé

✓ PropertyAvailabilityModule créé

✓ PropertyAvailabilityController créé

✓ PropertyAvailabilityService créé

✓ Calendrier opérationnel

✓ Blocages opérationnels

✓ Inventaire opérationnel

✓ Multi-tenant Security

✓ AuditLog intégré
</code>

----

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

<code>
PropertyAvailability

AvailabilityStatus

PropertyAvailabilityModule

PropertyAvailabilityController

PropertyAvailabilityService

Availability Calendar API
</code>

----

====== Sprint 4-E.2 — Disponibilités Enterprise & Synchronisation Multi-Canaux ======

===== Objectif =====

Transformer le moteur de disponibilités en véritable plateforme Channel Manager Enterprise.

À l'issue de cette étape :

<code>
✓ iCal

✓ Airbnb Sync

✓ Booking.com Sync

✓ Expedia Sync

✓ Channel Manager

✓ Availability Intelligence

✓ Conflict Resolution

✓ Multi-Channel Inventory
</code>

----

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

<code>
Property Availability

↓

Channel Manager

├── iCal
├── Airbnb
├── Booking.com
├── Expedia
├── Direct Booking
└── Future OTA Connectors

↓

Availability Intelligence

↓

Reservation Engine
</code>

----

====== Sprint 4-E.2-A ======

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

----

====== Étape 1 — ChannelConnection ======

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

<code prisma>
model ChannelConnection {

id                    String
                        @id
                        @default(uuid())

tenantId              String

propertyId            String

channelType           ChannelType

externalPropertyId    String?

syncEnabled           Boolean
                        @default(true)

lastSyncAt            DateTime?

syncStatus            SyncStatus
                        @default(PENDING)

configuration         Json?

createdAt             DateTime
                        @default(now())

updatedAt             DateTime
                        @updatedAt

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

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

@@index([tenantId])

@@index([propertyId])

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

----

====== Étape 2 — AvailabilitySyncLog ======

===== Ajouter =====

<code prisma>
model AvailabilitySyncLog {

id                    String
                        @id
                        @default(uuid())

channelConnectionId   String

syncType              SyncType

status                SyncStatus

startedAt             DateTime

completedAt           DateTime?

recordsProcessed      Int
                        @default(0)

errorMessage          String?

payload               Json?

@@index([status])

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

----

====== Étape 3 — AvailabilityConflict ======

===== Ajouter =====

<code prisma>
model AvailabilityConflict {

id                    String
                        @id
                        @default(uuid())

propertyId            String

channelType           ChannelType

conflictType          ConflictType

localData             Json

externalData          Json

resolved              Boolean
                        @default(false)

resolvedAt            DateTime?

resolvedBy            String?

createdAt             DateTime
                        @default(now())

@@index([propertyId])

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

----

====== Étape 4 — Enums ======

===== Ajouter =====

<code prisma>
enum ChannelType {

ICAL

AIRBNB

BOOKING

EXPEDIA

DIRECT
}

enum SyncStatus {

PENDING

RUNNING

SUCCESS

FAILED

PARTIAL
}

enum SyncType {

IMPORT

EXPORT

BIDIRECTIONAL
}

enum ConflictType {

INVENTORY

BOOKING

AVAILABILITY

PRICE
}
</code>

----

====== Étape 5 — Migration ======

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

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

----

====== Sprint 4-E.2-B ======

===== Channel Manager Module =====

----

====== Étape 6 — Création ======

<code>
src/modules/channel-manager

├── connectors
│
│   ├── ical
│
│   ├── airbnb
│
│   ├── booking
│
│   └── expedia
│
├── synchronization
│
├── conflict-resolution
│
├── intelligence
│
└── channel-manager.module.ts
</code>

----

====== Étape 7 — Services ======

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

<code>
ChannelManagerService

AvailabilitySyncService

ConflictResolutionService

AvailabilityIntelligenceService
</code>

----

====== Sprint 4-E.2-C ======

===== Synchronisation iCal =====

----

====== Étape 8 — IcalConnection ======

===== Ajouter =====

<code prisma>
icalUrl              String?
icalExportUrl        String?
</code>

dans :

<code>
ChannelConnection
</code>

----

====== Étape 9 — IcalSyncService ======

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

<code>
ical-sync.service.ts
</code>

----

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

<code ts>
importCalendar()

exportCalendar()

syncCalendar()
</code>

----

====== Étape 10 — Endpoints ======

===== Ajouter =====

<code http>
POST /channels/ical/connect

POST /channels/ical/sync

GET  /channels/ical/status
</code>

----

====== Sprint 4-E.2-D ======

===== Airbnb Connector =====

----

====== Étape 11 — AirbnbConnector ======

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

<code>
airbnb-connector.service.ts
</code>

----

===== Fonctions =====

<code ts>
syncAvailability()

syncInventory()

syncReservations()
</code>

----

====== Étape 12 — Mapping ======

===== Synchroniser =====

<code>
Property

Availability

Inventory

Reservations
</code>

----

====== Étape 13 — Endpoint ======

===== Ajouter =====

<code http>
POST /channels/airbnb/connect

POST /channels/airbnb/sync
</code>

----

====== Sprint 4-E.2-E ======

===== Booking.com Connector =====

----

====== Étape 14 — BookingConnector ======

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

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

----

===== Fonctions =====

<code ts>
syncAvailability()

syncInventory()

syncRates()
</code>

----

====== Étape 15 — Endpoint ======

===== Ajouter =====

<code http>
POST /channels/booking/connect

POST /channels/booking/sync
</code>

----

====== Sprint 4-E.2-F ======

===== Expedia Connector =====

----

====== Étape 16 — ExpediaConnector ======

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

<code>
expedia-connector.service.ts
</code>

----

===== Fonctions =====

<code ts>
syncAvailability()

syncInventory()

syncRates()
</code>

----

====== Étape 17 — Endpoint ======

===== Ajouter =====

<code http>
POST /channels/expedia/connect

POST /channels/expedia/sync
</code>

----

====== Sprint 4-E.2-G ======

===== Résolution de Conflits =====

----

====== Étape 18 — ConflictResolutionService ======

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

<code>
conflict-resolution.service.ts
</code>

----

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

<code ts>
detectConflicts()

resolveConflict()

autoResolve()
</code>

----

====== Étape 19 — Types ======

===== Détecter =====

<code>
Double réservation

Inventaire incohérent

Disponibilité divergente

Tarif divergent
</code>

----

====== Étape 20 — Politique ======

===== Priorité =====

<code>
Reservation Engine

↓

Direct Booking

↓

OTA
</code>

----

====== Sprint 4-E.2-H ======

===== Availability Intelligence =====

----

====== Étape 21 — AvailabilityIntelligenceService ======

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

<code>
availability-intelligence.service.ts
</code>

----

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

<code ts>
detectGaps()

forecastOccupancy()

recommendAvailabilityRules()
</code>

----

====== Étape 22 — Détections ======

===== Identifier =====

<code>
Dates non ouvertes

Blocages anormaux

Fenêtres d'opportunité

Périodes sous-occupées
</code>

----

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

<code>
Weekend libre

Taux occupation élevé

↓

Suggestion ouverture
</code>

----

====== Sprint 4-E.2-I ======

===== Dashboard Channel Manager =====

----

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

===== Ajouter =====

<code http>
GET /channels/dashboard
</code>

----

===== Retour =====

<code json>
{
  "connectedChannels":4,
  "lastSync":"2026-07-01T10:00:00Z",
  "pendingConflicts":2,
  "occupancyForecast":84
}
</code>

----

====== Étape 25 — Monitoring ======

===== Afficher =====

<code>
Canaux actifs

Derniers syncs

Erreurs

Conflits

Performance OTA
</code>

----

====== Sprint 4-E.2-J ======

===== Sécurité & Gouvernance =====

----

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

===== Ajouter =====

<code>
channel.read

channel.manage

channel.sync

channel.resolve

channel.admin
</code>

----

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

===== Journaliser =====

<code>
CHANNEL_CONNECTED

CHANNEL_SYNC_STARTED

CHANNEL_SYNC_COMPLETED

CHANNEL_CONFLICT_DETECTED

CHANNEL_CONFLICT_RESOLVED
</code>

----

====== Étape 28 — Jobs ======

===== Ajouter =====

Cron :

<code>
Toutes les 15 min

iCal Sync

OTA Sync

Conflict Detection
</code>

----

====== Étape 29 — Compatibilité Sprint 5 ======

Préparer :

<code>
Reservation

Booking Engine

Inventory Locking

Overbooking Protection
</code>

----

====== Étape 30 — Compatibilité Sprint 20 ======

Préparer :

<code>
Enterprise Channel Manager

Multi OTA

Revenue Management

Enterprise Inventory
</code>

----

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

Le Sprint 4-E.2 est terminé lorsque :

<code>
✓ iCal Sync

✓ Airbnb Connector

✓ Booking Connector

✓ Expedia Connector

✓ Channel Manager

✓ Conflict Resolution

✓ Availability Intelligence

✓ Dashboard

✓ Audit intégré
</code>

----

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

<code>
ChannelConnection

AvailabilitySyncLog

AvailabilityConflict

ChannelManagerService

AvailabilitySyncService

ConflictResolutionService

AvailabilityIntelligenceService

Enterprise Channel Manager
</code>

----

====== Sprint 4-F.1 — Gestion de la Tarification ======

===== Objectif =====

Implémenter le moteur tarifaire des propriétés.

Cette couche constitue la fondation du futur Revenue Management System.

À l'issue de cette étape :

<code>
✓ PropertyPricing

✓ PropertyPricingModule

✓ PropertyPricingController

✓ PropertyPricingService

✓ Tarifs de base

✓ Tarifs saisonniers

✓ Tarifs par période

✓ Inventaire tarifaire

✓ Revenue Ready
</code>

----

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

<code>
Property

↓

PropertyPricing

↓

Pricing Engine

↓

Reservation Engine

↓

Revenue Management
</code>

----

====== Sprint 4-F.1-A ======

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

----

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

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

<code prisma>
model PropertyPricing {

id                    String
                        @id
                        @default(uuid())

tenantId              String

propertyId            String

pricingType           PricingType

name                  String

startDate             DateTime?

endDate               DateTime?

basePrice             Decimal
                        @db.Decimal(12,2)

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

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

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

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

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

minimumStay           Int?
                        @default(1)

maximumStay           Int?

priority              Int
                        @default(0)

active                Boolean
                        @default(true)

createdAt             DateTime
                        @default(now())

updatedAt             DateTime
                        @updatedAt

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

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

@@index([tenantId])

@@index([propertyId])

@@index([pricingType])

@@index([startDate])

@@index([endDate])

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

----

====== Étape 2 — Enum PricingType ======

===== Ajouter =====

<code prisma>
enum PricingType {

BASE

SEASONAL

SPECIAL_EVENT

PROMOTIONAL

LAST_MINUTE

LONG_STAY
}
</code>

----

====== Étape 3 — Relation ======

===== Ajouter dans Property =====

<code prisma>
pricingRules PropertyPricing[]
</code>

----

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

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

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

----

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

<code bash>
npx prisma generate
</code>

----

====== Sprint 4-F.1-B ======

===== Module =====

----

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

<code>
src/modules/property-pricing

├── application
│
│   └── dto
│
│       ├── create-property-pricing.dto.ts
│
│       ├── update-property-pricing.dto.ts
│
│       ├── pricing-query.dto.ts
│
│       └── pricing-calculation.dto.ts
│
├── domain
│
│   └── services
│
│       ├── property-pricing.service.ts
│
│       └── pricing-calculation.service.ts
│
├── presentation
│
│   └── controllers
│
│       └── property-pricing.controller.ts
│
└── property-pricing.module.ts
</code>

----

====== Étape 6 — Module ======

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

<code ts>
@Module({

imports: [
    PrismaModule,
    AuthModule,
    AuditModule
  ],

controllers: [
    PropertyPricingController
  ],

providers: [
    PropertyPricingService,
    PricingCalculationService
  ],

exports: [
    PropertyPricingService,
    PricingCalculationService
  ]
})
export class PropertyPricingModule {}
</code>

----

====== Sprint 4-F.1-C ======

===== DTOs =====

----

====== Étape 7 — CreatePropertyPricingDto ======

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

<code ts>
export class CreatePropertyPricingDto {

pricingType: PricingType;

name: string;

startDate?: Date;

endDate?: Date;

basePrice: number;

weekendPrice?: number;

extraGuestPrice?: number;

cleaningFee?: number;

serviceFee?: number;

securityDeposit?: number;

minimumStay?: number;

maximumStay?: number;

priority?: number;
}
</code>

----

====== Étape 8 — UpdatePropertyPricingDto ======

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

<code ts>
export class UpdatePropertyPricingDto
  extends PartialType(
    CreatePropertyPricingDto
  ) {}
</code>

----

====== Étape 9 — PricingQueryDto ======

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

<code ts>
export class PricingQueryDto {

startDate?: Date;

endDate?: Date;

pricingType?: PricingType;

active?: boolean;
}
</code>

----

====== Sprint 4-F.1-D ======

===== PropertyPricingService =====

----

====== Étape 10 — Création ======

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

<code>
property-pricing.service.ts
</code>

----

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

<code ts>
findAll()

findById()

create()

update()

remove()

findApplicablePricing()
</code>

----

====== Étape 11 — Validation ======

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

<code>
basePrice > 0

minimumStay >= 1

startDate <= endDate
</code>

----

====== Étape 12 — Gestion des conflits ======

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

Chevauchements de périodes.

----

===== Priorité =====

<code>
LAST_MINUTE

↓

PROMOTIONAL

↓

SPECIAL_EVENT

↓

SEASONAL

↓

BASE
</code>

----

====== Étape 13 — Tarification applicable ======

===== Sélection =====

Règle active :

<code>
plus haute priorité
</code>

pour une période donnée.

----

====== Sprint 4-F.1-E ======

===== Tarifs de Base =====

----

====== Étape 14 — Règle par défaut ======

===== Exiger =====

Une règle :

<code>
PricingType.BASE
</code>

par propriété.

----

====== Étape 15 — Exemple ======

<code json>
{
  "pricingType":"BASE",
  "name":"Tarif Standard",
  "basePrice":120
}
</code>

----

====== Sprint 4-F.1-F ======

===== Tarifs Saisonniers =====

----

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

===== Supporter =====

<code>
Haute saison

Basse saison

Vacances

Événements
</code>

----

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

<code json>
{
  "pricingType":"SEASONAL",
  "name":"Été 2027",
  "startDate":"2027-06-01",
  "endDate":"2027-09-01",
  "basePrice":180
}
</code>

----

====== Étape 18 — Calendrier ======

===== Préparer =====

Compatible avec :

<code>
PropertyAvailability
</code>

----

====== Sprint 4-F.1-G ======

===== Calcul Tarifaire =====

----

====== Étape 19 — PricingCalculationService ======

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

<code>
pricing-calculation.service.ts
</code>

----

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

<code ts>
calculatePrice()

calculateStayPrice()

calculateFees()

calculateDeposit()
</code>

----

====== Étape 20 — Calcul ======

===== Exemple =====

<code>
3 nuits

Base : 120 €

↓

360 €
</code>

----

====== Étape 21 — Frais ======

===== Ajouter =====

<code>
Cleaning Fee

Service Fee

Security Deposit

Extra Guests
</code>

----

====== Étape 22 — Retour ======

===== Exemple =====

<code json>
{
  "baseAmount":360,
  "cleaningFee":30,
  "serviceFee":15,
  "total":405
}
</code>

----

====== Sprint 4-F.1-H ======

===== Contrôleur =====

----

====== Étape 23 — Création ======

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

<code>
property-pricing.controller.ts
</code>

----

===== Déclaration =====

<code ts>
@ApiTags(
  'Property Pricing'
)

@ApiBearerAuth()

@Controller(
  'properties/:id/pricing'
)

@UseGuards(
  JwtAuthGuard
)
</code>

----

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

===== Ajouter =====

<code http>
GET    /properties/{id}/pricing

POST   /properties/{id}/pricing

PUT    /properties/{id}/pricing/{pricingId}

DELETE /properties/{id}/pricing/{pricingId}

POST   /properties/{id}/pricing/calculate
</code>

----

====== Étape 25 — Endpoint calcul ======

===== Exemple =====

<code json>
{
  "checkIn":"2027-07-10",
  "checkOut":"2027-07-15",
  "guests":4
}
</code>

----

====== Sprint 4-F.1-I ======

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

----

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

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

<code>
tenantId

propertyId
</code>

sur toutes les opérations.

----

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

===== Ajouter =====

<code>
property.pricing.read

property.pricing.create

property.pricing.update

property.pricing.delete

property.pricing.calculate
</code>

----

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

===== Journaliser =====

<code>
PROPERTY_PRICING_CREATED

PROPERTY_PRICING_UPDATED

PROPERTY_PRICING_DELETED

PROPERTY_PRICE_CALCULATED
</code>

----

====== Sprint 4-F.1-J ======

===== Préparation Sprint 4-F.2 =====

----

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

Préparer :

<code>
Dynamic Pricing

Yield Management

Revenue Forecast

Competitor Rates
</code>

----

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

Préparer :

<code>
Reservation

Booking Engine

Channel Manager

Revenue Management
</code>

----

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

Le Sprint 4-F.1 est terminé lorsque :

<code>
✓ PropertyPricing créé

✓ PropertyPricingModule créé

✓ PropertyPricingController créé

✓ PropertyPricingService créé

✓ Tarifs de base

✓ Tarifs saisonniers

✓ Tarifs par période

✓ Calcul tarifaire

✓ Audit intégré
</code>

----

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

<code>
PropertyPricing

PricingType

PropertyPricingModule

PropertyPricingController

PropertyPricingService

PricingCalculationService

Property Pricing API
</code>

----

====== Sprint 4-F.2 — Revenue Management & Tarification Dynamique ======

===== Objectif =====

Transformer le moteur tarifaire en véritable Revenue Management System Enterprise.

À l'issue de cette étape :

<code>
✓ Dynamic Pricing

✓ Yield Management

✓ Occupancy Pricing

✓ Competitor Pricing

✓ Demand Forecast

✓ Revenue Intelligence

✓ Revenue Optimization Engine
</code>

----

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

<code>
Property Pricing

↓

Revenue Engine

├── Dynamic Pricing
├── Yield Management
├── Occupancy Analysis
├── Competitor Intelligence
├── Demand Forecast
└── Revenue Optimization

↓

Reservation Engine

↓

Channel Manager
</code>

----

====== Sprint 4-F.2-A ======

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

----

====== Étape 1 — DynamicPricingRule ======

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

<code prisma>
model DynamicPricingRule {

id                    String
                        @id
                        @default(uuid())

tenantId              String

propertyId            String

name                  String

active                Boolean
                        @default(true)

triggerType           DynamicPricingTrigger

triggerValue          Float

adjustmentType        PriceAdjustmentType

adjustmentValue       Float

priority              Int
                        @default(0)

createdAt             DateTime
                        @default(now())

updatedAt             DateTime
                        @updatedAt

@@index([tenantId])

@@index([propertyId])

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

----

====== Étape 2 — RevenueSnapshot ======

===== Ajouter =====

<code prisma>
model RevenueSnapshot {

id                    String
                        @id
                        @default(uuid())

propertyId            String

snapshotDate          DateTime

occupancyRate         Float

averageDailyRate      Decimal
                        @db.Decimal(12,2)

revPar                Decimal
                        @db.Decimal(12,2)

projectedRevenue      Decimal
                        @db.Decimal(14,2)

createdAt             DateTime
                        @default(now())

@@index([propertyId])

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

----

====== Étape 3 — CompetitorRate ======

===== Ajouter =====

<code prisma>
model CompetitorRate {

id                    String
                        @id
                        @default(uuid())

propertyId            String

competitorName        String

competitorPropertyId  String?

stayDate              DateTime

nightlyRate           Decimal
                        @db.Decimal(12,2)

source                String?

collectedAt           DateTime
                        @default(now())

@@index([propertyId])

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

----

====== Étape 4 — Enums ======

===== Ajouter =====

<code prisma>
enum DynamicPricingTrigger {

OCCUPANCY

DEMAND

BOOKING_WINDOW

COMPETITOR_RATE

EVENT

SEASON
}

enum PriceAdjustmentType {

PERCENTAGE

FIXED_AMOUNT
}
</code>

----

====== Étape 5 — Migration ======

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

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

----

====== Sprint 4-F.2-B ======

===== Revenue Management Module =====

----

====== Étape 6 — Création ======

<code>
src/modules/revenue-management

├── dynamic-pricing
│
├── yield-management
│
├── occupancy-pricing
│
├── competitor-pricing
│
├── demand-forecast
│
├── revenue-intelligence
│
└── revenue-management.module.ts
</code>

----

====== Étape 7 — Services ======

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

<code>
DynamicPricingService

YieldManagementService

OccupancyPricingService

CompetitorPricingService

DemandForecastService

RevenueIntelligenceService
</code>

----

====== Sprint 4-F.2-C ======

===== Dynamic Pricing =====

----

====== Étape 8 — DynamicPricingService ======

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

<code>
dynamic-pricing.service.ts
</code>

----

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

<code ts>
calculateDynamicPrice()

applyPricingRules()

simulatePricing()
</code>

----

====== Étape 9 — Exemple ======

===== Règle =====

<code>
Occupation > 85%

↓

+15%
</code>

----

===== Résultat =====

<code>
120 €

↓

138 €
</code>

----

====== Étape 10 — Endpoint ======

===== Ajouter =====

<code http>
POST /revenue/dynamic-pricing/calculate
</code>

----

====== Sprint 4-F.2-D ======

===== Yield Management =====

----

====== Étape 11 — YieldManagementService ======

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

<code>
yield-management.service.ts
</code>

----

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

<code ts>
calculateOptimalRate()

calculateYield()

optimizeRevenue()
</code>

----

====== Étape 12 — Facteurs ======

<code>
Occupation

Historique réservations

Saisonnalité

Demande

Concurrence
</code>

----

====== Étape 13 — KPI ======

===== Calculer =====

<code>
ADR

RevPAR

Revenue per Stay

Yield Index
</code>

----

====== Sprint 4-F.2-E ======

===== Occupancy Pricing =====

----

====== Étape 14 — OccupancyPricingService ======

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

<code>
occupancy-pricing.service.ts
</code>

----

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

<code ts>
adjustByOccupancy()

predictOccupancyImpact()
</code>

----

====== Étape 15 — Exemple ======

<code>
Occupation

95%

↓

+20%
</code>

----

<code>
Occupation

30%

↓

-15%
</code>

----

====== Étape 16 — Paliers ======

<code>
0-30%

31-60%

61-85%

86-100%
</code>

----

====== Sprint 4-F.2-F ======

===== Competitor Pricing =====

----

====== Étape 17 — CompetitorPricingService ======

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

<code>
competitor-pricing.service.ts
</code>

----

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

<code ts>
collectCompetitorRates()

compareRates()

recommendAdjustment()
</code>

----

====== Étape 18 — Comparaison ======

===== Exemple =====

<code>
Votre prix

120 €

Concurrence

145 €
</code>

----

===== Recommandation =====

<code>
Augmenter à 132 €
</code>

----

====== Étape 19 — Endpoint ======

===== Ajouter =====

<code http>
GET /revenue/competitors
</code>

----

====== Sprint 4-F.2-G ======

===== Demand Forecast =====

----

====== Étape 20 — DemandForecastService ======

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

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

----

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

<code ts>
forecastDemand()

forecastRevenue()

forecastOccupancy()
</code>

----

====== Étape 21 — Sources ======

<code>
Réservations

Historique

Événements

Saisonnalité

Recherche
</code>

----

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

<code>
Juillet

Demande

+24%
</code>

----

===== Action =====

<code>
Augmenter tarifs
</code>

----

====== Sprint 4-F.2-H ======

===== Revenue Intelligence =====

----

====== Étape 23 — RevenueIntelligenceService ======

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

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

----

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

<code ts>
generateInsights()

detectRevenueOpportunities()

recommendStrategies()
</code>

----

====== Étape 24 — Exemples ======

===== Insight =====

<code>
Week-end

Taux réservation

96%
</code>

----

===== Recommandation =====

<code>
+12% tarif
</code>

----

===== Insight =====

<code>
Sous-performance

Août

↓

Promotion ciblée
</code>

----

====== Étape 25 — Revenue Insight ======

===== Ajouter =====

<code prisma>
model RevenueInsight {

id                    String
                        @id
                        @default(uuid())

propertyId            String

severity              String

title                 String

description           String

recommendation        String?

createdAt             DateTime
                        @default(now())

resolved              Boolean
                        @default(false)

@@index([propertyId])

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

----

====== Sprint 4-F.2-I ======

===== Dashboard Revenue =====

----

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

===== Ajouter =====

<code http>
GET /revenue/dashboard
</code>

----

===== KPI =====

<code>
Revenue

ADR

RevPAR

Occupation

Forecast

Opportunités
</code>

----

====== Étape 27 — Exemple ======

<code json>
{
  "adr":142,
  "revPar":121,
  "occupancy":85,
  "forecastRevenue":42000
}
</code>

----

====== Étape 28 — Snapshot ======

===== Alimenter =====

<code>
RevenueSnapshot
</code>

quotidiennement.

----

====== Sprint 4-F.2-J ======

===== Gouvernance & Sécurité =====

----

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

===== Ajouter =====

<code>
revenue.read

revenue.manage

revenue.optimize

revenue.forecast

revenue.admin
</code>

----

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

===== Journaliser =====

<code>
REVENUE_RULE_CREATED

DYNAMIC_PRICE_CALCULATED

REVENUE_FORECAST_GENERATED

REVENUE_INSIGHT_CREATED

REVENUE_OPTIMIZATION_APPLIED
</code>

----

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

===== Ajouter =====

<code>
Toutes les heures

Dynamic Pricing

Toutes les nuits

Revenue Forecast

Revenue Insights
</code>

----

====== Préparation Sprint 5 ======

Compatible avec :

<code>
Reservation

Booking Engine

Upsell

Promotion Engine
</code>

----

====== Préparation Sprint 17 ======

Compatible avec :

<code>
Financial Forecast

Profitability Analysis

Business Intelligence
</code>

----

====== Préparation Sprint 20 ======

Compatible avec :

<code>
Enterprise Revenue Management

AI Pricing

Predictive Revenue

Revenue Intelligence
</code>

----

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

Le Sprint 4-F.2 est terminé lorsque :

<code>
✓ Dynamic Pricing

✓ Yield Management

✓ Occupancy Pricing

✓ Competitor Pricing

✓ Demand Forecast

✓ Revenue Intelligence

✓ Revenue Dashboard

✓ Audit intégré
</code>

----

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

<code>
DynamicPricingRule

RevenueSnapshot

CompetitorRate

RevenueInsight

DynamicPricingService

YieldManagementService

DemandForecastService

RevenueIntelligenceService

Revenue Dashboard
</code>

----

====== Sprint 4-G.1 — Gestion des Politiques des Propriétés ======

===== Objectif =====

Implémenter le moteur de politiques métier des propriétés.

Cette couche constitue la fondation des règles de réservation, d'annulation et d'exploitation.

À l'issue de cette étape :

<code>
✓ PropertyPolicy

✓ PropertyPolicyModule

✓ PropertyPolicyController

✓ PropertyPolicyService

✓ Check-in

✓ Check-out

✓ Annulation

✓ Règlement intérieur

✓ Reservation Ready
</code>

----

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

<code>
Property

↓

PropertyPolicy

├── Check-in
├── Check-out
├── Cancellation
├── House Rules
├── Guest Rules
└── Booking Restrictions

↓

Reservation Engine

↓

Revenue Engine
</code>

----

====== Sprint 4-G.1-A ======

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

----

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

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

<code prisma>
model PropertyPolicy {

id                    String
                        @id
                        @default(uuid())

tenantId              String

propertyId            String
                        @unique

cancellationPolicy    CancellationPolicyType

checkInFrom           String?

checkInTo             String?

checkOutFrom          String?

checkOutTo            String?

minimumGuestAge       Int?

petsAllowed           Boolean
                        @default(false)

smokingAllowed        Boolean
                        @default(false)

partiesAllowed        Boolean
                        @default(false)

childrenAllowed       Boolean
                        @default(true)

eventsAllowed         Boolean
                        @default(false)

quietHoursStart       String?

quietHoursEnd         String?

houseRules            String?

guestInstructions     String?

createdAt             DateTime
                        @default(now())

updatedAt             DateTime
                        @updatedAt

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

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

@@index([tenantId])

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

----

====== Étape 2 — Enum ======

===== Ajouter =====

<code prisma>
enum CancellationPolicyType {

FLEXIBLE

MODERATE

STRICT

NON_REFUNDABLE

CUSTOM
}
</code>

----

====== Étape 3 — Relation ======

===== Ajouter dans Property =====

<code prisma>
policy PropertyPolicy?
</code>

----

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

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

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

----

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

<code bash>
npx prisma generate
</code>

----

====== Sprint 4-G.1-B ======

===== Politiques d'Annulation =====

----

====== Étape 5 — Règles Standards ======

===== FLEXIBLE =====

<code>
Annulation gratuite

jusqu'à 24h avant arrivée
</code>

----

===== MODERATE =====

<code>
Annulation gratuite

jusqu'à 5 jours avant arrivée
</code>

----

===== STRICT =====

<code>
Remboursement partiel

selon conditions
</code>

----

===== NON_REFUNDABLE =====

<code>
Aucun remboursement
</code>

----

====== Étape 6 — Politique personnalisée ======

===== Ajouter =====

<code prisma>
customCancellationPolicy String?
</code>

pour :

<code>
CancellationPolicyType.CUSTOM
</code>

----

====== Sprint 4-G.1-C ======

===== Check-in & Check-out =====

----

====== Étape 7 — Gestion horaires ======

===== Supporter =====

<code>
Check-in From

Check-in To

Check-out From

Check-out To
</code>

----

====== Étape 8 — Exemples ======

<code>
Check-in

15:00 → 22:00
</code>

----

<code>
Check-out

08:00 → 11:00
</code>

----

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

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

Format :

sur tous les horaires.

----

====== Sprint 4-G.1-D ======

===== Règlement Intérieur =====

----

====== Étape 10 — Gestion ======

===== Supporter =====

<code>
Animaux

Fumeurs

Fêtes

Enfants

Événements
</code>

----

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

<code json>
{
  "petsAllowed":true,
  "smokingAllowed":false,
  "partiesAllowed":false
}
</code>

----

====== Étape 12 — Texte libre ======

===== Utiliser =====

<code>
houseRules

guestInstructions
</code>

pour les consignes détaillées.

----

====== Sprint 4-G.1-E ======

===== Module =====

----

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

<code>
src/modules/property-policy

├── application
│
│   └── dto
│
│       ├── update-property-policy.dto.ts
│
│       └── property-policy-response.dto.ts
│
├── domain
│
│   └── services
│
│       └── property-policy.service.ts
│
├── presentation
│
│   └── controllers
│
│       └── property-policy.controller.ts
│
└── property-policy.module.ts
</code>

----

====== Étape 14 — Module ======

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

<code ts>
@Module({

imports: [
    PrismaModule,
    AuthModule,
    AuditModule
  ],

controllers: [
    PropertyPolicyController
  ],

providers: [
    PropertyPolicyService
  ],

exports: [
    PropertyPolicyService
  ]
})
export class PropertyPolicyModule {}
</code>

----

====== Sprint 4-G.1-F ======

===== DTOs =====

----

====== Étape 15 — UpdatePropertyPolicyDto ======

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

<code ts>
export class UpdatePropertyPolicyDto {

cancellationPolicy:
    CancellationPolicyType;

customCancellationPolicy?: string;

checkInFrom?: string;

checkInTo?: string;

checkOutFrom?: string;

checkOutTo?: string;

minimumGuestAge?: number;

petsAllowed?: boolean;

smokingAllowed?: boolean;

partiesAllowed?: boolean;

childrenAllowed?: boolean;

eventsAllowed?: boolean;

quietHoursStart?: string;

quietHoursEnd?: string;

houseRules?: string;

guestInstructions?: string;
}
</code>

----

====== Sprint 4-G.1-G ======

===== PropertyPolicyService =====

----

====== Étape 16 — Création ======

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

<code>
property-policy.service.ts
</code>

----

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

<code ts>
getPolicy()

updatePolicy()

validatePolicy()

initializePolicy()
</code>

----

====== Étape 17 — Initialisation ======

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

lors de la création d'une propriété :

<code>
MODERATE

15:00-22:00

08:00-11:00
</code>

comme valeurs par défaut.

----

====== Étape 18 — Validation ======

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

<code>
Check-in

Check-out

Âge minimum

Règles cohérentes
</code>

avant sauvegarde.

----

====== Sprint 4-G.1-H ======

===== Contrôleur =====

----

====== Étape 19 — Création ======

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

<code>
property-policy.controller.ts
</code>

----

===== Déclaration =====

<code ts>
@ApiTags(
  'Property Policies'
)

@ApiBearerAuth()

@Controller(
  'properties/:id/policies'
)

@UseGuards(
  JwtAuthGuard
)
</code>

----

====== Étape 20 — Endpoints ======

===== Ajouter =====

<code http>
GET /properties/{id}/policies

PUT /properties/{id}/policies
</code>

----

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

===== Retour =====

<code json>
{
  "cancellationPolicy":"MODERATE",
  "checkInFrom":"15:00",
  "checkInTo":"22:00",
  "petsAllowed":true
}
</code>

----

====== Sprint 4-G.1-I ======

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

----

====== Étape 22 — Multi-Tenant ======

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

<code>
tenantId

propertyId
</code>

sur toutes les opérations.

----

====== Étape 23 — Permissions ======

===== Ajouter =====

<code>
property.policy.read

property.policy.update

property.policy.manage
</code>

----

====== Étape 24 — Audit ======

===== Journaliser =====

<code>
PROPERTY_POLICY_VIEWED

PROPERTY_POLICY_UPDATED

PROPERTY_CANCELLATION_UPDATED

PROPERTY_RULES_UPDATED
</code>

----

====== Sprint 4-G.1-J ======

===== Préparation Sprint 5 =====

----

====== Étape 25 — Compatible =====

Préparer :

<code>
Reservation

Booking Workflow

Refund Engine

Guest Management
</code>

----

====== Étape 26 — Compatible =====

Préparer :

<code>
Revenue Management

Legal Compliance

Terms & Conditions

Insurance Rules
</code>

----

====== Étape 27 — Préparer =====

Compatible avec :

<code>
Airbnb

Booking.com

Expedia

OTA Mapping
</code>

----

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

Le Sprint 4-G.1 est terminé lorsque :

<code>
✓ PropertyPolicy créé

✓ PropertyPolicyModule créé

✓ PropertyPolicyController créé

✓ PropertyPolicyService créé

✓ Check-in géré

✓ Check-out géré

✓ Annulation gérée

✓ Règlement intérieur géré

✓ Audit intégré
</code>

----

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

<code>
PropertyPolicy

CancellationPolicyType

PropertyPolicyModule

PropertyPolicyController

PropertyPolicyService

Property Policy API
</code>

----

====== Sprint 4-G.2 — Politiques Enterprise & Conformité Juridique ======

===== Objectif =====

Transformer le moteur de politiques en véritable couche de gouvernance juridique Enterprise.

À l'issue de cette étape :

<code>
✓ Conditions contractuelles

✓ Dépôts de garantie

✓ Conformité locale

✓ RGPD

✓ Documents légaux

✓ Signature électronique

✓ Gestion des exceptions

✓ Legal Compliance Engine
</code>

----

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

<code>
Property Policy

↓

Legal Engine

├── Contracts
├── Deposits
├── Compliance
├── GDPR
├── Legal Documents
├── E-Signature
└── Exceptions

↓

Reservation Engine

↓

Governance Layer
</code>

----

====== Sprint 4-G.2-A ======

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

----

====== Étape 1 — PropertyLegalPolicy ======

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

<code prisma>
model PropertyLegalPolicy {

id                    String
                        @id
                        @default(uuid())

tenantId              String

propertyId            String
                        @unique

termsAndConditions    String?

privacyPolicy         String?

liabilityWaiver       String?

cancellationTerms     String?

localComplianceNotes  String?

createdAt             DateTime
                        @default(now())

updatedAt             DateTime
                        @updatedAt

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

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

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

----

====== Étape 2 — SecurityDepositPolicy ======

===== Ajouter =====

<code prisma>
model SecurityDepositPolicy {

id                    String
                        @id
                        @default(uuid())

propertyId            String
                        @unique

depositRequired       Boolean
                        @default(false)

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

depositCurrency       String?
                        @default("EUR")

refundDelayDays       Int?
                        @default(7)

refundConditions      String?

createdAt             DateTime
                        @default(now())

updatedAt             DateTime
                        @updatedAt

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

----

====== Étape 3 — LegalDocument ======

===== Ajouter =====

<code prisma>
model LegalDocument {

id                    String
                        @id
                        @default(uuid())

tenantId              String

propertyId            String?

documentType          LegalDocumentType

version               String

title                 String

storagePath           String

published             Boolean
                        @default(false)

effectiveDate         DateTime

createdAt             DateTime
                        @default(now())

@@index([tenantId])

@@index([documentType])

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

----

====== Étape 4 — Enums ======

===== Ajouter =====

<code prisma>
enum LegalDocumentType {

TERMS

PRIVACY_POLICY

HOUSE_RULES

RENTAL_CONTRACT

LIABILITY_WAIVER

GDPR_NOTICE
}
</code>

----

====== Étape 5 — Migration ======

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

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

----

====== Sprint 4-G.2-B ======

===== Gestion Contractuelle =====

----

====== Étape 6 — ContractModule ======

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

<code>
src/modules/legal

├── contracts
│
├── compliance
│
├── gdpr
│
├── signatures
│
└── documents
</code>

----

====== Étape 7 — ContractService ======

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

<code>
contract.service.ts
</code>

----

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

<code ts>
generateContract()

validateContract()

publishContract()

archiveContract()
</code>

----

====== Étape 8 — Contrat réservation ======

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

à partir de :

<code>
Property

Reservation

Policies

Guest
</code>

----

====== Sprint 4-G.2-C ======

===== Dépôts de Garantie =====

----

====== Étape 9 — SecurityDepositService ======

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

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

----

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

<code ts>
calculateDeposit()

reserveDeposit()

releaseDeposit()

claimDeposit()
</code>

----

====== Étape 10 — Types ======

===== Supporter =====

<code>
Montant fixe

Pourcentage réservation

Selon catégorie
</code>

----

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

<code>
Réservation

1 000 €

Dépôt

20 %

↓

200 €
</code>

----

====== Sprint 4-G.2-D ======

===== Conformité Locale =====

----

====== Étape 12 — LocalComplianceRule ======

===== Ajouter =====

<code prisma>
model LocalComplianceRule {

id                    String
                        @id
                        @default(uuid())

countryCode           String

regionCode            String?

ruleType              String

title                 String

description           String

active                Boolean
                        @default(true)

createdAt             DateTime
                        @default(now())

@@index([countryCode])

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

----

====== Étape 13 — ComplianceService ======

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

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

----

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

<code ts>
validatePropertyCompliance()

getApplicableRules()

generateComplianceReport()
</code>

----

====== Étape 14 — Contrôles ======

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

<code>
Taxe séjour

Déclaration hébergement

Assurance

Capacité légale

Sécurité incendie
</code>

----

====== Sprint 4-G.2-E ======

===== RGPD =====

----

====== Étape 15 — GDPRConsent ======

===== Ajouter =====

<code prisma>
model GDPRConsent {

id                    String
                        @id
                        @default(uuid())

userId                String

consentType           String

accepted              Boolean

acceptedAt            DateTime?

revokedAt             DateTime?

ipAddress             String?

createdAt             DateTime
                        @default(now())

@@index([userId])

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

----

====== Étape 16 — GDPRService ======

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

<code>
gdpr.service.ts
</code>

----

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

<code ts>
recordConsent()

revokeConsent()

exportUserData()

anonymizeUserData()
</code>

----

====== Étape 17 — Supporter =====

<code>
Consentement

Portabilité

Rectification

Droit à l'oubli
</code>

----

====== Sprint 4-G.2-F ======

===== Signature Électronique =====

----

====== Étape 18 — ElectronicSignature ======

===== Ajouter =====

<code prisma>
model ElectronicSignature {

id                    String
                        @id
                        @default(uuid())

documentId            String

signerId              String

signedAt              DateTime?

ipAddress             String?

status                SignatureStatus

signatureHash         String?

@@index([documentId])

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

----

====== Étape 19 — Enum ======

===== Ajouter =====

<code prisma>
enum SignatureStatus {

PENDING

SIGNED

REJECTED

EXPIRED
}
</code>

----

====== Étape 20 — SignatureService ======

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

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

----

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

<code ts>
requestSignature()

signDocument()

verifySignature()
</code>

----

====== Sprint 4-G.2-G ======

===== Gestion des Exceptions =====

----

====== Étape 21 — PolicyException ======

===== Ajouter =====

<code prisma>
model PolicyException {

id                    String
                        @id
                        @default(uuid())

propertyId            String

exceptionType         String

reason                String

approvedBy            String?

validFrom             DateTime?

validUntil            DateTime?

active                Boolean
                        @default(true)

createdAt             DateTime
                        @default(now())

@@index([propertyId])

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

----

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

===== Supporter =====

<code>
Animal exceptionnel

Check-in tardif

Annulation exceptionnelle

Remise exceptionnelle
</code>

----

====== Étape 23 — Validation ======

===== Exiger =====

Approbation selon RBAC.

----

====== Sprint 4-G.2-H ======

===== API Enterprise =====

----

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

===== Ajouter =====

<code http>
GET  /properties/{id}/legal

PUT  /properties/{id}/legal

GET  /properties/{id}/compliance

POST /properties/{id}/compliance/validate

POST /contracts/generate

POST /contracts/sign

GET  /gdpr/export

POST /gdpr/delete-request
</code>

----

====== Étape 25 — Documents ======

===== Ajouter =====

<code http>
GET    /legal-documents

POST   /legal-documents

PUT    /legal-documents/{id}

DELETE /legal-documents/{id}
</code>

----

====== Sprint 4-G.2-I ======

===== Gouvernance =====

----

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

===== Ajouter =====

<code>
legal.read

legal.manage

legal.contracts

legal.compliance

legal.gdpr

legal.signatures
</code>

----

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

===== Journaliser =====

<code>
LEGAL_DOCUMENT_CREATED

CONTRACT_GENERATED

CONTRACT_SIGNED

GDPR_EXPORT_REQUESTED

GDPR_DELETE_REQUESTED

COMPLIANCE_VALIDATED

POLICY_EXCEPTION_CREATED
</code>

----

====== Étape 28 — Reporting ======

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

<code>
Compliance Score

GDPR Status

Pending Signatures

Legal Risks
</code>

----

====== Sprint 4-G.2-J ======

===== Préparation Future =====

----

====== Étape 29 — Compatible Sprint 5 ======

Préparer :

<code>
Reservation Contract

Guest Agreements

Refund Workflow
</code>

----

====== Étape 30 — Compatible Sprint 19 ======

Préparer :

<code>
Governance

Risk Management

Audit Framework

Compliance Dashboard
</code>

----

====== Étape 31 — Compatible Sprint 20 ======

Préparer :

<code>
Enterprise Compliance

Legal Automation

Contract Intelligence

Global Regulations
</code>

----

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

Le Sprint 4-G.2 est terminé lorsque :

<code>
✓ Contrats gérés

✓ Dépôts de garantie gérés

✓ Conformité locale gérée

✓ RGPD géré

✓ Documents légaux gérés

✓ Signature électronique gérée

✓ Exceptions gérées

✓ Audit intégré
</code>

----

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

<code>
PropertyLegalPolicy

SecurityDepositPolicy

LegalDocument

ElectronicSignature

GDPRConsent

PolicyException

ComplianceService

GDPRService

SignatureService

Enterprise Legal Engine
</code>

----

====== Sprint 4-H.1 — Gestion des Avis Clients ======

===== Objectif =====

Implémenter le système d'avis clients des propriétés.

Cette couche constitue la fondation de la réputation, de la confiance et du classement des biens.

À l'issue de cette étape :

<code>
✓ PropertyReview

✓ PropertyReviewModule

✓ PropertyReviewController

✓ PropertyReviewService

✓ Avis

✓ Notes

✓ Commentaires

✓ Réponses propriétaires

✓ Reputation Ready
</code>

----

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

<code>
Reservation

↓

Review Eligibility

↓

PropertyReview

├── Rating
├── Comment
├── Owner Response
├── Moderation
└── Analytics

↓

Property Score

↓

Search Ranking
</code>

----

====== Sprint 4-H.1-A ======

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

----

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

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

<code prisma>
model PropertyReview {

id                    String
                        @id
                        @default(uuid())

tenantId              String

propertyId            String

customerId            String

reservationId         String?

overallRating         Int

cleanlinessRating     Int?

communicationRating   Int?

locationRating        Int?

valueRating           Int?

checkInRating         Int?

title                 String?

comment               String?

verifiedStay          Boolean
                        @default(false)

published             Boolean
                        @default(true)

createdAt             DateTime
                        @default(now())

updatedAt             DateTime
                        @updatedAt

deletedAt             DateTime?

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

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

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

responses             PropertyReviewResponse[]

@@index([tenantId])

@@index([propertyId])

@@index([customerId])

@@index([overallRating])

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

----

====== Étape 2 — Réponse propriétaire ======

===== Ajouter =====

<code prisma>
model PropertyReviewResponse {

id                    String
                        @id
                        @default(uuid())

reviewId              String

userId                String

response              String

createdAt             DateTime
                        @default(now())

updatedAt             DateTime
                        @updatedAt

review                PropertyReview
                        @relation(
                          fields:[reviewId],
                          references:[id],
                          onDelete:Cascade
                        )

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

----

====== Étape 3 — Relation Property ======

===== Ajouter dans Property =====

<code prisma>
reviews PropertyReview[]
</code>

----

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

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

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

----

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

<code bash>
npx prisma generate
</code>

----

====== Sprint 4-H.1-B ======

===== Module =====

----

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

<code>
src/modules/property-reviews

├── application
│
│   └── dto
│
│       ├── create-review.dto.ts
│
│       ├── update-review.dto.ts
│
│       ├── review-response.dto.ts
│
│       └── review-query.dto.ts
│
├── domain
│
│   └── services
│
│       └── property-review.service.ts
│
├── presentation
│
│   └── controllers
│
│       └── property-review.controller.ts
│
└── property-review.module.ts
</code>

----

====== Étape 6 — Module ======

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

<code ts>
@Module({

imports: [
    PrismaModule,
    AuthModule,
    AuditModule
  ],

controllers: [
    PropertyReviewController
  ],

providers: [
    PropertyReviewService
  ],

exports: [
    PropertyReviewService
  ]
})
export class PropertyReviewModule {}
</code>

----

====== Sprint 4-H.1-C ======

===== DTOs =====

----

====== Étape 7 — CreateReviewDto ======

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

<code ts>
export class CreateReviewDto {

reservationId?: string;

overallRating: number;

cleanlinessRating?: number;

communicationRating?: number;

locationRating?: number;

valueRating?: number;

checkInRating?: number;

title?: string;

comment?: string;
}
</code>

----

====== Étape 8 — Validation ======

===== Contraindre =====

sur toutes les notes.

----

====== Étape 9 — ReviewResponseDto ======

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

<code ts>
export class ReviewResponseDto {

response: string;
}
</code>

----

====== Sprint 4-H.1-D ======

===== PropertyReviewService =====

----

====== Étape 10 — Création ======

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

<code>
property-review.service.ts
</code>

----

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

<code ts>
findAll()

findById()

create()

update()

remove()

respond()

calculatePropertyRating()
</code>

----

====== Étape 11 — Vérification séjour ======

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

Le client doit :

<code>
Posséder réservation

ET

Réservation terminée
</code>

pour déposer un avis.

----

====== Étape 12 — Verified Stay ======

===== Activer =====

<code>
verifiedStay = true
</code>

si réservation validée.

----

====== Étape 13 — Un avis par réservation ======

===== Refuser =====

plusieurs avis :

<code>
reservationId
</code>

identique.

----

====== Sprint 4-H.1-E ======

===== Notes & Commentaires =====

----

====== Étape 14 — Notes supportées ======

<code>
Global

Propreté

Communication

Emplacement

Rapport qualité/prix

Check-in
</code>

----

====== Étape 15 — Calcul ======

===== Note moyenne =====

<code>
AVG(overallRating)
</code>

par propriété.

----

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

===== Alimenter =====

<code>
PropertyScore.reviewScore
</code>

automatiquement.

----

====== Sprint 4-H.1-F ======

===== Réponses Propriétaires =====

----

====== Étape 17 — Endpoint ======

===== Ajouter =====

<code http>
POST /reviews/{id}/response
</code>

----

====== Étape 18 — Autoriser ======

<code>
Property Manager

Tenant Admin

Owner
</code>

uniquement.

----

====== Étape 19 — Exemple ======

<code json>
{
  "response":"Merci pour votre séjour."
}
</code>

----

====== Sprint 4-H.1-G ======

===== Contrôleur =====

----

====== Étape 20 — Création ======

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

<code>
property-review.controller.ts
</code>

----

===== Déclaration =====

<code ts>
@ApiTags(
  'Property Reviews'
)

@ApiBearerAuth()
</code>

----

====== Étape 21 — Endpoints ======

===== Ajouter =====

<code http>
GET    /properties/{id}/reviews

POST   /properties/{id}/reviews

PUT    /reviews/{id}

DELETE /reviews/{id}

POST   /reviews/{id}/response
</code>

----

====== Étape 22 — Recherche ======

===== Supporter =====

<code>
Rating

Verified

Date

Published
</code>

----

====== Sprint 4-H.1-H ======

===== Modération =====

----

====== Étape 23 — ReviewModeration ======

===== Ajouter =====

<code prisma>
model ReviewModeration {

id                    String
                        @id
                        @default(uuid())

reviewId              String
                        @unique

flagged               Boolean
                        @default(false)

reason                String?

reviewedBy            String?

reviewedAt            DateTime?

createdAt             DateTime
                        @default(now())
}
</code>

----

====== Étape 24 — Contrôles ======

===== Détecter =====

<code>
Spam

Abus

Langage interdit

Fraude
</code>

----

====== Étape 25 — Actions ======

<code>
Publish

Hide

Delete

Escalate
</code>

----

====== Sprint 4-H.1-I ======

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

----

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

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

<code>
tenantId

propertyId
</code>

sur toutes les opérations.

----

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

===== Ajouter =====

<code>
property.review.read

property.review.create

property.review.update

property.review.delete

property.review.respond

property.review.moderate
</code>

----

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

===== Journaliser =====

<code>
PROPERTY_REVIEW_CREATED

PROPERTY_REVIEW_UPDATED

PROPERTY_REVIEW_DELETED

PROPERTY_REVIEW_RESPONDED

PROPERTY_REVIEW_MODERATED
</code>

----

====== Sprint 4-H.1-J ======

===== Préparation Sprint 4-H.2 =====

----

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

Préparer :

<code>
Review Images

Review Sentiment

AI Moderation

Review Analytics
</code>

----

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

Préparer :

<code>
Search Ranking

Property Score

Recommendation Engine

Trust Score
</code>

----

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

Le Sprint 4-H.1 est terminé lorsque :

<code>
✓ PropertyReview créé

✓ PropertyReviewModule créé

✓ PropertyReviewController créé

✓ PropertyReviewService créé

✓ Avis opérationnels

✓ Notes opérationnelles

✓ Commentaires opérationnels

✓ Réponses propriétaires opérationnelles

✓ Modération intégrée
</code>

----

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

<code>
PropertyReview

PropertyReviewResponse

ReviewModeration

PropertyReviewModule

PropertyReviewController

PropertyReviewService

Property Reviews API
</code>

----

====== Sprint 4-H.2 — Review Intelligence & Réputation Enterprise ======

===== Objectif =====

Transformer le système d'avis en plateforme de réputation intelligente Enterprise.

À l'issue de cette étape :

<code>
✓ Analyse de sentiment

✓ IA de modération

✓ Review Images

✓ Détection fraude

✓ Trust Score

✓ Réputation globale

✓ Insights clients

✓ Reputation Intelligence Platform
</code>

----

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

<code>
Property Reviews

↓

Review Intelligence Engine

├── Sentiment Analysis
├── AI Moderation
├── Review Images
├── Fraud Detection
├── Trust Scoring
├── Reputation Analytics
└── Customer Insights

↓

Property Score

↓

Search Ranking

↓

Recommendation Engine
</code>

----

====== Sprint 4-H.2-A ======

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

----

====== Étape 1 — ReviewSentiment ======

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

<code prisma>
model ReviewSentiment {

id                    String
                        @id
                        @default(uuid())

reviewId              String
                        @unique

sentiment             SentimentType

score                 Float

positiveKeywords      Json?

negativeKeywords      Json?

emotions              Json?

analyzedAt            DateTime
                        @default(now())

review                PropertyReview
                        @relation(
                          fields:[reviewId],
                          references:[id],
                          onDelete:Cascade
                        )
}
</code>

----

====== Étape 2 — ReviewTrustScore ======

===== Ajouter =====

<code prisma>
model ReviewTrustScore {

id                    String
                        @id
                        @default(uuid())

reviewId              String
                        @unique

trustScore            Float

fraudRisk             Float

authenticityScore     Float

behaviorScore         Float

calculatedAt          DateTime
                        @default(now())

review                PropertyReview
                        @relation(
                          fields:[reviewId],
                          references:[id],
                          onDelete:Cascade
                        )
}
</code>

----

====== Étape 3 — ReviewImage ======

===== Ajouter =====

<code prisma>
model ReviewImage {

id                    String
                        @id
                        @default(uuid())

reviewId              String

imageUrl              String

thumbnailUrl          String?

moderationStatus      ModerationStatus
                        @default(PENDING)

uploadedAt            DateTime
                        @default(now())

review                PropertyReview
                        @relation(
                          fields:[reviewId],
                          references:[id],
                          onDelete:Cascade
                        )

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

----

====== Étape 4 — Enums ======

===== Ajouter =====

<code prisma>
enum SentimentType {

VERY_POSITIVE

POSITIVE

NEUTRAL

NEGATIVE

VERY_NEGATIVE
}

enum ModerationStatus {

PENDING

APPROVED

REJECTED

FLAGGED
}
</code>

----

====== Étape 5 — Migration ======

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

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

----

====== Sprint 4-H.2-B ======

===== Analyse de Sentiment =====

----

====== Étape 6 — ReviewSentimentService ======

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

<code>
review-sentiment.service.ts
</code>

----

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

<code ts>
analyzeSentiment()

extractKeywords()

detectEmotions()

generateSummary()
</code>

----

====== Étape 7 — Classification ======

<code>
Très positif

Positif

Neutre

Négatif

Très négatif
</code>

----

====== Étape 8 — Exemple ======

===== Avis =====

<code>
Appartement magnifique,
très propre,
hôte exceptionnel
</code>

----

===== Résultat =====

<code>
Sentiment:
VERY_POSITIVE

Score:
94
</code>

----

====== Sprint 4-H.2-C ======

===== IA de Modération =====

----

====== Étape 9 — ReviewModerationAIService ======

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

<code>
review-moderation-ai.service.ts
</code>

----

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

<code ts>
detectSpam()

detectAbuse()

detectToxicity()

detectFakeReview()
</code>

----

====== Étape 10 — Contrôles ======

===== Détecter =====

<code>
Spam

Insultes

Contenu haineux

Fraude

Bots
</code>

----

====== Étape 11 — Actions ======

<code>
Approve

Flag

Reject

Escalate
</code>

----

====== Sprint 4-H.2-D ======

===== Gestion des Images d'Avis =====

----

====== Étape 12 — Upload ======

===== Ajouter =====

<code http>
POST /reviews/{id}/images
</code>

----

====== Étape 13 — Validation ======

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

<code>
Format

Poids

Qualité

Contenu interdit
</code>

----

====== Étape 14 — Analyse IA ======

===== Détecter =====

<code>
Chambre

Salle de bain

Piscine

Cuisine

Animaux

Personnes
</code>

----

====== Étape 15 — Auto-tagging ======

===== Associer =====

aux équipements détectés.

----

====== Sprint 4-H.2-E ======

===== Détection de Fraude =====

----

====== Étape 16 — FraudDetectionService ======

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

<code>
review-fraud-detection.service.ts
</code>

----

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

<code ts>
detectFraud()

calculateRisk()

detectReviewFarm()

detectDuplicatePatterns()
</code>

----

====== Étape 17 — Signaux ======

===== Analyser =====

<code>
IP

Device

Timing

Texte

Historique
</code>

----

====== Étape 18 — Alertes ======

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

<code>
Suspicious Review

Fake Review

Mass Review Activity
</code>

----

====== Sprint 4-H.2-F ======

===== Trust Score =====

----

====== Étape 19 — TrustScoreService ======

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

<code>
review-trust-score.service.ts
</code>

----

===== Calcul =====

<code>
Verified Stay

Historique client

Fraud Risk

Sentiment Consistency

Review Completeness
</code>

----

====== Étape 20 — Classification ======

<code>
90-100 Trusted

75-89 Reliable

50-74 Medium

0-49 Suspicious
</code>

----

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

<code>
Trust Score

96

Trusted
</code>

----

====== Sprint 4-H.2-G ======

===== Réputation Globale =====

----

====== Étape 22 — ReputationService ======

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

<code>
reputation.service.ts
</code>

----

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

<code ts>
calculatePropertyReputation()

calculateTenantReputation()

calculateBrandReputation()
</code>

----

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

===== Calculer =====

<code>
Average Rating

Review Volume

Trust Score

Response Rate

Response Time
</code>

----

====== Étape 24 — Reputation Index ======

===== Exemple =====

<code>
Property Reputation

92

Excellent
</code>

----

====== Sprint 4-H.2-H ======

===== Customer Insights =====

----

====== Étape 25 — ReviewInsight ======

===== Ajouter =====

<code prisma>
model ReviewInsight {

id                    String
                        @id
                        @default(uuid())

propertyId            String

category              String

title                 String

description           String

severity              String?

createdAt             DateTime
                        @default(now())

resolved              Boolean
                        @default(false)

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

----

====== Étape 26 — Génération ======

===== Identifier =====

<code>
Forces

Faiblesses

Opportunités

Problèmes récurrents
</code>

----

====== Étape 27 — Exemple ======

<code>
32% des avis

mentionnent

Wifi lent
</code>

----

===== Action =====

<code>
Améliorer réseau
</code>

----

====== Sprint 4-H.2-I ======

===== Dashboard Réputation =====

----

====== Étape 28 — Endpoint ======

===== Ajouter =====

<code http>
GET /reviews/reputation/dashboard
</code>

----

===== Retour =====

<code json>
{
  "averageRating":4.7,
  "trustScore":91,
  "responseRate":96,
  "sentiment":"POSITIVE"
}
</code>

----

====== Étape 29 — Analytics ======

===== Afficher =====

<code>
Sentiment Trends

Review Trends

Trust Trends

Customer Insights
</code>

----

====== Sprint 4-H.2-J ======

===== Gouvernance & Sécurité =====

----

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

===== Ajouter =====

<code>
property.review.analytics

property.review.moderate

property.review.trust

property.review.reputation
</code>

----

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

===== Journaliser =====

<code>
REVIEW_ANALYZED

REVIEW_FLAGGED

REVIEW_FRAUD_DETECTED

REPUTATION_UPDATED

TRUST_SCORE_UPDATED
</code>

----

====== Étape 32 — Jobs ======

===== Ajouter =====

<code>
Toutes les heures

Sentiment Analysis

Fraud Detection

Toutes les nuits

Reputation Calculation

Insights Generation
</code>

----

====== Préparation Sprint 4-I ======

Compatible avec :

<code>
Search Ranking

Property Score

Recommendation Engine
</code>

----

====== Préparation Sprint 13 ======

Compatible avec :

<code>
LLM Analytics

AI Insights

Customer Intelligence

Knowledge Graph
</code>

----

====== Préparation Sprint 20 ======

Compatible avec :

<code>
Enterprise Reputation Platform

AI Moderation

Fraud Prevention

Brand Intelligence
</code>

----

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

Le Sprint 4-H.2 est terminé lorsque :

<code>
✓ Analyse de sentiment

✓ IA de modération

✓ Review Images

✓ Détection fraude

✓ Trust Score

✓ Réputation globale

✓ Insights clients

✓ Dashboard réputation

✓ Audit intégré
</code>

----

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

<code>
ReviewSentiment

ReviewTrustScore

ReviewImage

ReviewInsight

ReviewSentimentService

ReviewModerationAIService

FraudDetectionService

ReputationService

Enterprise Reputation Platform
</code>

----

====== Sprint 4-I.1 — Moteur de Recherche Immobilier ======

===== Objectif =====

Construire le moteur de recherche central de la plateforme.

Cette couche unifie :

<code>
Property

Amenities

Availability

Pricing

Reviews

Scores

Analytics
</code>

dans une expérience de recherche Enterprise unique.

À l'issue de cette étape :

<code>
✓ PropertySearchEngine

✓ Faceted Search

✓ Geo Search

✓ Availability Search

✓ Ranking Engine

✓ Search Analytics

✓ Search API Enterprise
</code>

----

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

<code>
Property Search Engine

├── Catalog Search
├── Availability Search
├── Geo Search
├── Pricing Search
├── Review Search
├── Faceted Search
├── Ranking Engine
└── Search Analytics

↓

Booking Engine

↓

Recommendation Engine
</code>

----

====== Sprint 4-I.1-A ======

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

----

====== Étape 1 — SearchQueryLog ======

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

<code prisma>
model SearchQueryLog {

id                    String
                        @id
                        @default(uuid())

tenantId              String?

userId                String?

query                 String?

filters               Json?

resultCount           Int
                        @default(0)

executionTimeMs       Int?

createdAt             DateTime
                        @default(now())

@@index([tenantId])

@@index([userId])

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

----

====== Étape 2 — PropertySearchIndex ======

===== Ajouter =====

<code prisma>
model PropertySearchIndex {

propertyId            String
                        @id

searchableText        String

amenities             Json?

city                  String?

country               String?

averageRating         Float?

reviewCount           Int?

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

maxGuests             Int?

searchScore           Float?
                        @default(0)

updatedAt             DateTime
                        @updatedAt

@@index([city])

@@index([country])

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

----

====== Étape 3 — SavedSearch ======

===== Ajouter =====

<code prisma>
model SavedPropertySearch {

id                    String
                        @id
                        @default(uuid())

userId                String

tenantId              String

name                  String

filters               Json

createdAt             DateTime
                        @default(now())

@@index([userId])

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

----

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

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

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

----

====== Sprint 4-I.1-B ======

===== Search Engine Module =====

----

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

<code>
src/modules/property-search

├── search
│
├── ranking
│
├── analytics
│
├── facets
│
├── geo
│
└── property-search.module.ts
</code>

----

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

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

<code>
PropertySearchEngineService

FacetedSearchService

GeoSearchService

AvailabilitySearchService

RankingEngineService

SearchAnalyticsService
</code>

----

====== Sprint 4-I.1-C ======

===== Recherche Unifiée =====

----

====== Étape 7 — PropertySearchDto ======

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

<code ts>
export class PropertySearchDto {

query?: string;

city?: string;

country?: string;

latitude?: number;

longitude?: number;

radiusKm?: number;

checkIn?: Date;

checkOut?: Date;

guests?: number;

minPrice?: number;

maxPrice?: number;

minRating?: number;

amenities?: string[];

propertyTypeId?: string;

page?: number = 1;

limit?: number = 25;
}
</code>

----

====== Étape 8 — Search Engine ======

===== Méthode =====

<code ts>
search()
</code>

----

===== Agrège =====

<code>
Property

Availability

Pricing

Reviews

Amenities
</code>

dans une requête unique.

----

====== Étape 9 — Recherche texte ======

===== Champs =====

<code>
Name

Description

Location

Amenities

Reviews
</code>

----

====== Sprint 4-I.1-D ======

===== Faceted Search =====

----

====== Étape 10 — FacetedSearchService ======

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

<code>
faceted-search.service.ts
</code>

----

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

<code>
Cities

Countries

Amenities

Ratings

Price Ranges

Property Types
</code>

----

====== Étape 11 — Endpoint ======

===== Ajouter =====

<code http>
GET /search/facets
</code>

----

====== Étape 12 — Exemple ======

<code json>
{
  "cities": {
    "Paris": 132
  },
  "amenities": {
    "Wifi": 218
  }
}
</code>

----

====== Sprint 4-I.1-E ======

===== Recherche Géographique =====

----

====== Étape 13 — GeoSearchService ======

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

<code>
geo-search.service.ts
</code>

----

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

<code ts>
searchByRadius()

calculateDistance()

sortByDistance()
</code>

----

====== Étape 14 — Utiliser =====

<code>
Latitude

Longitude

Haversine
</code>

----

====== Étape 15 — Exemple ======

<code>
Rayon

10 km

autour de Paris
</code>

----

====== Sprint 4-I.1-F ======

===== Recherche de Disponibilités =====

----

====== Étape 16 — AvailabilitySearchService ======

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

<code>
availability-search.service.ts
</code>

----

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

<code>
Check-In

Check-Out

Inventory

Blocks
</code>

----

====== Étape 17 — Endpoint ======

===== Ajouter =====

<code http>
GET /search/availability
</code>

----

====== Étape 18 — Retour ======

Uniquement les biens :

<code>
Disponibles
</code>

sur la période demandée.

----

====== Sprint 4-I.1-G ======

===== Ranking Engine =====

----

====== Étape 19 — RankingEngineService ======

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

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

----

===== Facteurs =====

<code>
Review Score

Trust Score

Price Score

Availability Score

Popularity

Revenue Score
</code>

----

====== Étape 20 — Pondération ======

<code>
Reviews       30%

Popularity    20%

Availability  20%

Price         15%

Revenue       15%
</code>

----

====== Étape 21 — Search Score ======

===== Alimenter =====

<code>
PropertySearchIndex.searchScore
</code>

automatiquement.

----

====== Sprint 4-I.1-H ======

===== Search Analytics =====

----

====== Étape 22 — SearchAnalyticsService ======

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

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

----

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

<code ts>
trackSearch()

getPopularSearches()

getZeroResultsQueries()

getConversionRate()
</code>

----

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

===== Mesurer =====

<code>
Search Volume

CTR

Bookings

Search Conversion

Top Filters
</code>

----

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

===== Ajouter =====

<code http>
GET /search/analytics
</code>

----

====== Sprint 4-I.1-I ======

===== API Enterprise =====

----

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

===== Ajouter =====

<code http>
GET /search

GET /search/facets

GET /search/availability

GET /search/analytics

POST /search/saved

GET /search/saved

DELETE /search/saved/{id}
</code>

----

====== Étape 26 — Exemple ======

===== Requête =====

<code>
Paris

4 personnes

Wifi

Piscine

14-20 juillet
</code>

----

===== Retour =====

<code json>
{
  "items": [],
  "facets": {},
  "meta": {}
}
</code>

----

====== Étape 27 — Pagination ======

===== Supporter =====

<code>
Offset

Cursor

Infinite Scroll
</code>

----

====== Sprint 4-I.1-J ======

===== Gouvernance =====

----

====== Étape 28 — Permissions ======

===== Ajouter =====

<code>
property.search

property.search.saved

property.search.analytics

property.search.admin
</code>

----

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

===== Journaliser =====

<code>
PROPERTY_SEARCH_EXECUTED

PROPERTY_SEARCH_SAVED

PROPERTY_SEARCH_ANALYTICS_VIEWED
</code>

----

====== Étape 30 — Jobs ======

===== Ajouter =====

<code>
Toutes les heures

Search Index Refresh

Toutes les nuits

Ranking Rebuild

Analytics Aggregation
</code>

----

====== Préparation Sprint 4-I.2 ======

Compatible avec :

<code>
Semantic Search

AI Search

Recommendations

Personalization
</code>

----

====== Préparation Sprint 13 ======

Compatible avec :

<code>
Vector Search

LLM Search

Knowledge Graph

RAG
</code>

----

====== Préparation Sprint 20 ======

Compatible avec :

<code>
Enterprise Search Platform

Global Catalog

AI Discovery

Unified Search
</code>

----

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

Le Sprint 4-I.1 est terminé lorsque :

<code>
✓ PropertySearchEngine

✓ Faceted Search

✓ Geo Search

✓ Availability Search

✓ Ranking Engine

✓ Search Analytics

✓ Search API Enterprise

✓ Audit intégré
</code>

----

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

<code>
PropertySearchEngineService

FacetedSearchService

GeoSearchService

AvailabilitySearchService

RankingEngineService

SearchAnalyticsService

PropertySearchIndex

Enterprise Search Platform
</code>

----

====== Sprint 4-I.2 — Recherche IA & Discovery Platform ======

===== Objectif =====

Transformer le moteur de recherche immobilier en plateforme de découverte intelligente alimentée par l'IA.

À l'issue de cette étape :

<code>
✓ Recherche sémantique

✓ Vector Search

✓ Recommandations

✓ Personnalisation

✓ Intent Detection

✓ AI Discovery

✓ Property Intelligence Graph
</code>

----

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

<code>
User Query

↓

AI Discovery Platform

├── Intent Detection
├── Semantic Search
├── Vector Search
├── Recommendation Engine
├── Personalization Engine
├── Property Intelligence Graph
└── Ranking AI

↓

Search Engine

↓

Booking Engine
</code>

----

====== Sprint 4-I.2-A ======

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

----

====== Étape 1 — PropertyEmbedding ======

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

<code prisma>
model PropertyEmbedding {

propertyId            String
                        @id

embeddingModel        String

embeddingVersion      String

vectorId              String

generatedAt           DateTime
                        @default(now())

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

----

====== Étape 2 — SearchIntent ======

===== Ajouter =====

<code prisma>
model SearchIntent {

id                    String
                        @id
                        @default(uuid())

query                 String

detectedIntent        String

confidence            Float

entities              Json?

createdAt             DateTime
                        @default(now())

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

----

====== Étape 3 — RecommendationProfile ======

===== Ajouter =====

<code prisma>
model RecommendationProfile {

id                    String
                        @id
                        @default(uuid())

userId                String
                        @unique

preferences           Json?

interests             Json?

travelPatterns        Json?

preferredAmenities    Json?

preferredLocations    Json?

updatedAt             DateTime
                        @updatedAt

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

----

====== Étape 4 — PropertyRecommendation ======

===== Ajouter =====

<code prisma>
model PropertyRecommendation {

id                    String
                        @id
                        @default(uuid())

userId                String

propertyId            String

recommendationScore   Float

reason                String?

generatedAt           DateTime
                        @default(now())

clicked               Boolean
                        @default(false)

booked                Boolean
                        @default(false)

@@index([userId])

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

----

====== Étape 5 — Migration ======

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

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

----

====== Sprint 4-I.2-B ======

===== AI Discovery Module =====

----

====== Étape 6 — Création ======

<code>
src/modules/ai-discovery

├── semantic-search
│
├── vector-search
│
├── recommendations
│
├── personalization
│
├── intent-detection
│
├── intelligence-graph
│
└── ai-discovery.module.ts
</code>

----

====== Étape 7 — Services ======

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

<code>
SemanticSearchService

VectorSearchService

RecommendationEngineService

PersonalizationService

IntentDetectionService

PropertyIntelligenceGraphService
</code>

----

====== Sprint 4-I.2-C ======

===== Recherche Sémantique =====

----

====== Étape 8 — SemanticSearchService ======

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

<code>
semantic-search.service.ts
</code>

----

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

<code ts>
semanticSearch()

expandQuery()

extractConcepts()

rankSemanticResults()
</code>

----

====== Étape 9 — Exemples ======

===== Requête =====

<code>
Appartement calme pour télétravail
près de la mer
</code>

----

===== Compréhension =====

<code>
Remote Work

Wifi

Workspace

Sea View

Quiet Area
</code>

----

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

===== Indexer =====

<code>
Property

Amenities

Reviews

Descriptions

Policies
</code>

----

====== Sprint 4-I.2-D ======

===== Vector Search =====

----

====== Étape 11 — VectorSearchService ======

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

<code>
vector-search.service.ts
</code>

----

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

<code ts>
generateEmbedding()

searchSimilarProperties()

findNearestNeighbors()
</code>

----

====== Étape 12 — Infrastructure ======

===== Préparer =====

<code>
pgvector

Qdrant

Weaviate

Pinecone
</code>

----

====== Étape 13 — Embeddings ======

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

<code>
Properties

Reviews

Amenities

Policies

Locations
</code>

----

====== Étape 14 — Similarité ======

===== Exemple =====

<code>
Villa luxe avec piscine

↓

Biens similaires
</code>

----

====== Sprint 4-I.2-E ======

===== Recommandations =====

----

====== Étape 15 — RecommendationEngineService ======

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

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

----

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

<code ts>
recommendForUser()

recommendSimilarProperties()

recommendTrending()
</code>

----

====== Étape 16 — Facteurs ======

<code>
Historique recherches

Réservations

Favoris

Reviews

Préférences
</code>

----

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

===== Supporter =====

<code>
Similar

Trending