Page bloquée

Cette page est actuellement bloquée pour modification par un autre utilisateur. Vous devez attendre que cet utilisateur ait terminé ou que le blocage de la page expire.
Actuellement bloqué par : 192.168.0.100,216.73.217.175
Le blocage expire à : 2026/06/07 08:06 (14 min)
Cette page est en lecture seule. Vous pouvez afficher le texte source, mais ne pourrez pas le modifier. Contactez votre administrateur si vous pensez qu'il s'agit d'une erreur.
====== Phase 2 — Prisma Schema ======

===== Objectif =====

Construire le schéma Prisma qui deviendra la source de vérité unique du système.

À partir de ce schéma seront générés :

  * PostgreSQL
  * Prisma Client
  * DTO
  * Entités NestJS
  * OpenAPI
  * SDK TypeScript
  * Migrations SQL

Le schéma doit refléter l'intégralité des domaines définis dans les 20 sprints.

----

====== Objectifs techniques ======

Le schéma Prisma doit supporter :

<code>
Multi-tenant

Audit

Historisation

Soft Delete

RBAC

CRM

Catalogue

Réservations

Paiements

Contrats

OTA

IA

Revenue Management

Internationalisation

Sécurité Enterprise
</code>

----

====== Ordre de construction recommandé ======

Ne jamais commencer par les 80 tables.

Construire par couches.

----

===== Couche 1 — Fondations =====

Construire en premier :

<code>
Tenant

User

Role

Permission

UserRole

RolePermission
</code>

Ces tables sont nécessaires partout.

----

===== Couche 2 — Référentiels =====

Créer :

<code>
Address

Country

Language

Currency

Timezone
</code>

----

===== Couche 3 — Catalogue =====

Créer :

<code>
Property

PropertyType

PropertyMedia

PropertyFeature

PropertyAvailability

PropertyRate
</code>

----

===== Couche 4 — Réservations =====

Créer :

<code>
Reservation

ReservationGuest

ReservationStatus

ReservationEvent
</code>

----

===== Couche 5 — Contrats =====

Créer :

<code>
Contract

ContractTemplate

ContractSignature

Document
</code>

----

===== Couche 6 — Paiements =====

Créer :

<code>
Payment

Invoice

Refund

AccountingEntry
</code>

----

===== Couche 7 — CRM =====

Créer :

<code>
Lead

Customer

Activity

Task

Pipeline
</code>

----

===== Couche 8 — Propriétaires =====

Créer :

<code>
Owner

OwnerProperty

OwnerDocument
</code>

----

===== Couche 9 — Notifications =====

Créer :

<code>
Notification

NotificationTemplate

Message

Campaign
</code>

----

===== Couche 10 — Administration =====

Créer :

<code>
AuditLog

FeatureFlag

CustomField

Workflow
</code>

----

===== Couche 11 — IA =====

Créer :

<code>
AiConversation

AiMessage

KnowledgeDocument

AutomationRule
</code>

----

===== Couche 12 — OTA =====

Créer :

<code>
Channel

ChannelConnection

PropertyDistribution

ChannelReservation
</code>

----

===== Couche 13 — Revenue Management =====

Créer :

<code>
PricingRule

DynamicPrice

RevenueSimulation

CompetitorSnapshot
</code>

----

===== Couche 14 — Sécurité =====

Créer :

<code>
Consent

SecurityPolicy

Risk

ComplianceAudit
</code>

----

===== Couche 15 — Internationalisation =====

Créer :

<code>
Translation

CurrencyRate

Region

EnterpriseLicense
</code>

----

====== Organisation du dossier Prisma ======

Au lieu d'un unique fichier géant :

<code>
prisma/

├── schema.prisma
│
├── models/
│
│   ├── tenant.prisma
│   ├── user.prisma
│   ├── property.prisma
│   ├── reservation.prisma
│   ├── contract.prisma
│   ├── payment.prisma
│   ├── crm.prisma
│   ├── owner.prisma
│   ├── notification.prisma
│   ├── audit.prisma
│   ├── ai.prisma
│   ├── channel.prisma
│   ├── revenue.prisma
│   ├── security.prisma
│   └── localization.prisma
</code>

----

====== Configuration initiale ======

===== schema.prisma =====

Version minimale :

<code prisma>
generator client {
  provider = "prisma-client-js"
}

datasource db {
  provider = "postgresql"
  url      = env("DATABASE_URL")
}
</code>

----

====== Première implémentation ======

===== Étape 1 =====

Créer :

<code>
prisma/models/tenant.prisma
</code>

----

===== Tenant =====

<code prisma>
model Tenant {

  id            String   @id @default(uuid())

  code          String   @unique

  name          String

  status        TenantStatus

  createdAt     DateTime @default(now())

  updatedAt     DateTime @updatedAt

  users         User[]

  properties    Property[]

}
</code>

----

===== Enum =====

<code prisma>
enum TenantStatus {

  ACTIVE

  SUSPENDED

  TRIAL

  ARCHIVED
}
</code>

----

====== Étape 2 ======

Créer :

<code>
prisma/models/user.prisma
</code>

----

===== User =====

<code prisma>
model User {

  id              String @id @default(uuid())

  tenantId        String

  email           String @unique

  passwordHash    String

  firstName       String

  lastName        String

  active          Boolean @default(true)

  createdAt       DateTime @default(now())

  updatedAt       DateTime @updatedAt

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

  roles           UserRole[]

}
</code>

----

===== Role =====

<code prisma>
model Role {

  id            String @id @default(uuid())

  code          String @unique

  name          String

  userRoles     UserRole[]

  permissions   RolePermission[]
}
</code>

----

===== Permission =====

<code prisma>
model Permission {

  id            String @id @default(uuid())

  code          String @unique

  name          String

  rolePermissions RolePermission[]
}
</code>

----

===== UserRole =====

<code prisma>
model UserRole {

  userId        String

  roleId        String

  assignedAt    DateTime @default(now())

  user          User @relation(
                  fields:[userId],
                  references:[id]
                )

  role          Role @relation(
                  fields:[roleId],
                  references:[id]
                )

  @@id([userId, roleId])
}
</code>

----

===== RolePermission =====

<code prisma>
model RolePermission {

  roleId        String

  permissionId  String

  role          Role @relation(
                  fields:[roleId],
                  references:[id]
                )

  permission    Permission @relation(
                  fields:[permissionId],
                  references:[id]
                )

  @@id([roleId, permissionId])
}
</code>

----

====== Génération ======

Après chaque bloc important :

<code bash>
npx prisma format
</code>

----

===== Validation =====

<code bash>
npx prisma validate
</code>

----

===== Génération Client =====

<code bash>
npx prisma generate
</code>

----

===== Migration =====

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

----

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

Ouvrir :

<code bash>
npx prisma studio
</code>

Vérifier la présence :

<code>
Tenant

User

Role

Permission

UserRole

RolePermission
</code>

----

====== Phase 2-A — Fondation complète (Tenant + RBAC + Propriétés de sécurité) ======

Vous avez raison.

La version précédente contient :

  * Tenant
  * User
  * Role
  * Permission
  * UserRole
  * RolePermission

mais il manque plusieurs éléments indispensables pour un véritable système Enterprise :

  * propriétés du compte utilisateur
  * préférences utilisateur
  * sessions
  * refresh tokens
  * MFA
  * audit de connexion
  * catalogue complet des permissions

Sans ces éléments, le Sprint 1 (Authentification) et le Sprint 19 (Sécurité Enterprise) ne pourront pas être implémentés proprement.

----

====== Modèle User complet ======

===== User =====

<code prisma>
model User {

  id                String      @id @default(uuid())

  tenantId          String

  email             String      @unique

  passwordHash      String

  firstName         String

  lastName          String

  phone             String?

  avatarUrl         String?

  languageCode      String?

  timezoneCode      String?

  active            Boolean     @default(true)

  emailVerified     Boolean     @default(false)

  lastLoginAt       DateTime?

  createdAt         DateTime    @default(now())

  updatedAt         DateTime    @updatedAt

  deletedAt         DateTime?

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

  roles             UserRole[]

  sessions          UserSession[]

  refreshTokens     RefreshToken[]

  preferences       UserPreference?

  loginHistory      LoginHistory[]

  mfaMethods        UserMfaMethod[]
}
</code>

----

====== Préférences utilisateur ======

===== UserPreference =====

<code prisma>
model UserPreference {

  id                String      @id @default(uuid())

  userId            String      @unique

  theme             String?

  language          String?

  timezone          String?

  notifications     Json?

  createdAt         DateTime    @default(now())

  updatedAt         DateTime    @updatedAt

  user              User @relation(
                        fields:[userId],
                        references:[id]
                      )
}
</code>

----

====== Gestion des sessions ======

===== UserSession =====

<code prisma>
model UserSession {

  id                String      @id @default(uuid())

  userId            String

  ipAddress         String?

  userAgent         String?

  country           String?

  city              String?

  lastActivityAt    DateTime

  expiresAt         DateTime

  revokedAt         DateTime?

  createdAt         DateTime    @default(now())

  user              User @relation(
                        fields:[userId],
                        references:[id]
                      )
}
</code>

----

====== Refresh Tokens ======

===== RefreshToken =====

<code prisma>
model RefreshToken {

  id                String      @id @default(uuid())

  userId            String

  tokenHash         String

  expiresAt         DateTime

  revokedAt         DateTime?

  createdAt         DateTime    @default(now())

  user              User @relation(
                        fields:[userId],
                        references:[id]
                      )
}
</code>

----

====== Historique des connexions ======

===== LoginHistory =====

<code prisma>
model LoginHistory {

  id                String      @id @default(uuid())

  userId            String

  success           Boolean

  ipAddress         String?

  userAgent         String?

  country           String?

  city              String?

  createdAt         DateTime @default(now())

  user              User @relation(
                        fields:[userId],
                        references:[id]
                      )
}
</code>

----

====== MFA ======

===== UserMfaMethod =====

<code prisma>
model UserMfaMethod {

  id                String      @id @default(uuid())

  userId            String

  methodType        String

  secret            String?

  enabled           Boolean     @default(true)

  createdAt         DateTime    @default(now())

  user              User @relation(
                        fields:[userId],
                        references:[id]
                      )
}
</code>

----

====== RBAC Enterprise ======

===== Role =====

<code prisma>
model Role {

  id                String      @id @default(uuid())

  code              String      @unique

  name              String

  description       String?

  systemRole        Boolean     @default(false)

  createdAt         DateTime    @default(now())

  updatedAt         DateTime    @updatedAt

  userRoles         UserRole[]

  permissions       RolePermission[]
}
</code>

----

===== Permission =====

<code prisma>
model Permission {

  id                String      @id @default(uuid())

  code              String      @unique

  name              String

  description       String?

  module            String

  createdAt         DateTime    @default(now())

  rolePermissions   RolePermission[]
}
</code>

----

====== Catalogue initial des permissions ======

===== Auth =====

<code>
AUTH_LOGIN

AUTH_REGISTER

AUTH_RESET_PASSWORD

AUTH_MANAGE_USERS
</code>

----

===== Users =====

<code>
USER_READ

USER_CREATE

USER_UPDATE

USER_DELETE
</code>

----

===== Properties =====

<code>
PROPERTY_READ

PROPERTY_CREATE

PROPERTY_UPDATE

PROPERTY_DELETE

PROPERTY_PUBLISH
</code>

----

===== Reservations =====

<code>
RESERVATION_READ

RESERVATION_CREATE

RESERVATION_UPDATE

RESERVATION_CANCEL
</code>

----

===== Contracts =====

<code>
CONTRACT_READ

CONTRACT_CREATE

CONTRACT_SIGN
</code>

----

===== Payments =====

<code>
PAYMENT_READ

PAYMENT_CREATE

PAYMENT_REFUND
</code>

----

===== CRM =====

<code>
CRM_READ

CRM_WRITE

CRM_EXPORT
</code>

----

===== Administration =====

<code>
ADMIN_READ

ADMIN_WRITE

ADMIN_AUDIT

ADMIN_TENANT
</code>

----

====== Rôles système ======

===== SUPER_ADMIN =====

Accès complet plateforme.

----

===== TENANT_ADMIN =====

Administration d'agence.

----

===== AGENCY_MANAGER =====

Gestion opérationnelle.

----

===== OWNER =====

Extranet propriétaire.

----

===== AGENT =====

Collaborateur.

----

===== CUSTOMER =====

Client final.

----

====== Indexes recommandés ======

===== User =====

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

@@index([email])

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

----

===== LoginHistory =====

<code prisma>
@@index([userId])

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

----

===== UserSession =====

<code prisma>
@@index([userId])

@@index([expiresAt])
</code>

----

====== Architecture du domaine Property ======

===== Entités =====

<code>
Property

PropertyType

PropertyStatus

PropertyAddress

PropertyFeature

PropertyMedia

PropertyAvailability

PropertyRate

PropertyOwner
</code>

----

====== Property ======

===== Table principale =====

<code prisma>
model Property {

  id                    String @id @default(uuid())

  tenantId              String

  propertyTypeId        String

  code                  String @unique

  reference             String?

  title                 String

  slug                  String @unique

  description           String?

  shortDescription      String?

  maxGuests             Int

  bedrooms              Int

  bathrooms             Int

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

  floor                 Int?

  constructionYear      Int?

  checkInTime           String?

  checkOutTime          String?

  active                Boolean @default(true)

  published             Boolean @default(false)

  createdAt             DateTime @default(now())

  updatedAt             DateTime @updatedAt

  deletedAt             DateTime?

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

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

  address               PropertyAddress?

  features              PropertyFeature[]

  media                 PropertyMedia[]

  availabilities        PropertyAvailability[]

  rates                 PropertyRate[]

  owners                PropertyOwner[]

  reservations         Reservation[]

}
</code>

----

====== PropertyType ======

===== Référentiel =====

<code prisma>
model PropertyType {

  id                String @id @default(uuid())

  code              String @unique

  name              String

  properties        Property[]
}
</code>

----

===== Valeurs =====

<code>
HOUSE

APARTMENT

VILLA

STUDIO

LOFT

CHALET

COTTAGE

MOBILE_HOME
</code>

----

====== PropertyAddress ======

===== Adresse du bien =====

<code prisma>
model PropertyAddress {

  id                String @id @default(uuid())

  propertyId        String @unique

  addressLine1      String

  addressLine2      String?

  postalCode        String

  city              String

  state             String?

  countryCode       String

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

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

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

----

====== PropertyFeature ======

===== Équipements =====

<code prisma>
model PropertyFeature {

  id                String @id @default(uuid())

  propertyId        String

  featureCode       String

  featureValue      String?

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

----

===== Exemples =====

<code>
POOL

WIFI

PARKING

AIR_CONDITIONING

TERRACE

SEA_VIEW

PET_ALLOWED
</code>

----

====== PropertyMedia ======

===== Médias =====

<code prisma>
model PropertyMedia {

  id                String @id @default(uuid())

  propertyId        String

  fileName          String

  fileUrl           String

  mediaType         String

  position          Int

  isCover           Boolean @default(false)

  createdAt         DateTime @default(now())

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

----

===== MediaType =====

<code>
IMAGE

VIDEO

VIRTUAL_TOUR

DOCUMENT
</code>

----

====== PropertyAvailability ======

===== Calendrier =====

<code prisma>
model PropertyAvailability {

  id                String @id @default(uuid())

  propertyId        String

  startDate         DateTime

  endDate           DateTime

  status            AvailabilityStatus

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

----

===== Enum =====

<code prisma>
enum AvailabilityStatus {

  AVAILABLE

  RESERVED

  BLOCKED

  MAINTENANCE
}
</code>

----

====== PropertyRate ======

===== Tarification =====

<code prisma>
model PropertyRate {

  id                String @id @default(uuid())

  propertyId        String

  startDate         DateTime

  endDate           DateTime

  nightlyRate       Decimal @db.Decimal(10,2)

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

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

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

  currencyCode      String

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

----

====== PropertyOwner ======

===== Association propriétaire =====

<code prisma>
model PropertyOwner {

  propertyId        String

  ownerId           String

  ownershipRate     Decimal @db.Decimal(5,2)

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

  owner             Owner @relation(
                      fields:[ownerId],
                      references:[id]
                    )

  @@id([propertyId, ownerId])
}
</code>

----

====== Indexes ======

===== Property =====

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

@@index([propertyTypeId])

@@index([published])

@@index([active])

@@index([title])

@@index([slug])
</code>

----

===== PropertyAvailability =====

<code prisma>
@@index([propertyId])

@@index([startDate])

@@index([endDate])
</code>

----

===== PropertyRate =====

<code prisma>
@@index([propertyId])

@@index([startDate])

@@index([endDate])
</code>

----

====== Évolution future ======

Ces tables seront enrichies dans les prochains domaines :

===== Sprint 4 =====

<code>
Reservation
</code>

ajoutera :

<code>
Property

↓

Reservations
</code>

----

===== Sprint 7 =====

<code>
Owner
</code>

ajoutera :

<code>
PropertyOwner

OwnerDocuments

OwnerRevenue
</code>

----

===== Sprint 17 =====

ajoutera :

<code>
DynamicPrice

PricingRule

RevenueSimulation
</code>

----

===== Sprint 18 =====

ajoutera :

<code>
PropertyDistribution

OTA Mapping

Channel Publication
</code>

----

====== Validation ======

<code bash>
npx prisma format

npx prisma validate

npx prisma generate
</code>

----

====== Migration ======

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

----

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

À ce stade, vous disposez enfin du premier domaine métier central de la plateforme :

<code>
Tenant

User

Role

Permission

Property

PropertyAddress

PropertyFeature

PropertyMedia

PropertyAvailability

PropertyRate
</code>

Toutes les futures fonctionnalités métier pourront désormais s'appuyer sur ce socle immobilier.