Crealcs Development DokuWiki

Vous affichez une ancienne révision du document ! Si vous l'enregistrez, vous créerez une nouvelle version avec ce contenu.

====== 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>

----
====== Phase 2-C — Domaine Catalogue Immobilier (Properties) ======

Effectivement.

Dans le modèle précédent, la relation suivante existait :

<code prisma>
properties Property[]
</code>

dans la table :

<code prisma>
Tenant
</code>

mais la table :

<code prisma>
Property
</code>

n'avait pas encore été définie.

Or le domaine "Property" est le cœur de toute la plateforme.

Toutes les fonctionnalités suivantes en dépendent :

* Réservations
  * Disponibilités
  * Tarification
  * Contrats
  * OTA
  * Revenue Management
  * CRM
  * Extranet propriétaire

La table Property doit donc être construite très tôt.

----

====== 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.

Résumé

Note : En modifiant cette page, vous acceptez que le contenu soit placé sous les termes de la licence suivante : CC Attribution-Share Alike 4.0 International