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 4-A — Consolidation Finale du Prisma Schema ======

===== Objectif =====

Fusionner l'ensemble des modèles construits durant :

<code>
Phase 2-A à Phase 2-N
</code>

dans un unique schéma Prisma cohérent :

<code>
apps/api/prisma/schema.prisma
</code>

Ce schéma deviendra :

<code>
Source de vérité de la base PostgreSQL
</code>

et servira à générer :

<code>
Prisma Client

Repositories

Services NestJS

DTO

OpenAPI

SDK Frontend
</code>

----

====== Étape 4-A.1 — Consolidation des Enums ======

===== Créer les enums globaux =====

<code prisma>
enum UserStatus

enum ReservationStatus

enum PaymentStatus

enum ContractStatus

enum LeadStatus

enum OpportunityStatus

enum TaskStatus

enum TaskPriority

enum PropertyStatus

enum RiskLevel

enum NotificationType

enum CampaignStatus

enum ChannelType

enum SyncStatus

enum CurrencyCode

enum LanguageCode

enum DataClassificationLevel
</code>

----

===== Exemple =====

<code prisma>
enum UserStatus {

ACTIVE

INACTIVE

BLOCKED

PENDING
}
</code>

----

====== Étape 4-A.2 — Consolidation Authentification & RBAC ======

===== Modèles concernés =====

<code>
User

Role

Permission

UserRole

RolePermission

Session

RefreshToken
</code>

----

===== Relations attendues =====

<code>
User

↓

UserRole

↓

Role

↓

RolePermission

↓

Permission
</code>

----

===== Contraintes =====

<code prisma>
@@unique([userId, roleId])

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

----

====== Étape 4-A.3 — Consolidation CRM ======

===== Modèles =====

<code>
Lead

Opportunity

Pipeline

PipelineStage

Activity

Task

CustomerNote

Tag

Segment
</code>

----

===== Corrections =====

Ajouter :

<code prisma>
assignedUserId String?
</code>

sur :

<code>
Lead

Opportunity

Task
</code>

----

===== Relation =====

<code prisma>
assignedUser User?
  @relation(fields:[assignedUserId], references:[id])
</code>

----

====== Étape 4-A.4 — Consolidation Immobilier ======

===== Modèles =====

<code>
Owner

Property

PropertyMedia

PropertyFeature

PropertyAvailability

PropertyRate

PropertyDistribution
</code>

----

===== Champs supplémentaires =====

<code prisma>
slug String @unique

reference String @unique

publicUrl String?
</code>

----

===== Index =====

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

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

----

====== Étape 4-A.5 — Consolidation Réservations ======

===== Modèles =====

<code>
Reservation

ReservationGuest

ReservationPricing

ReservationEvent

ReservationStatusHistory
</code>

----

===== Champ métier =====

<code prisma>
reservationNumber String @unique
</code>

----

===== Index =====

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

----

====== Étape 4-A.6 — Consolidation Finance ======

===== Modèles =====

<code>
Payment

Refund

Invoice

AccountingEntry
</code>

----

===== Contraintes =====

<code prisma>
paymentReference String @unique

invoiceNumber String @unique
</code>

----

===== Index =====

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

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

----

====== Étape 4-A.7 — Consolidation Communication ======

===== Modèles =====

<code>
Conversation

Message

Notification

Email

Sms

Template

Campaign

CampaignRecipient

CampaignExecution
</code>

----

===== Multi-tenant =====

Ajouter :

<code prisma>
tenantId String
</code>

sur tous les modèles.

----

====== Étape 4-A.8 — Consolidation IA ======

===== Modèles =====

<code>
AiConversation

AiMessage

KnowledgeDocument

KnowledgeChunk

Recommendation

AutomationScenario

AutomationExecution
</code>

----

===== Support Vector Search =====

Si pgvector est utilisé :

<code prisma>
embedding Unsupported("vector")?
</code>

----

===== Fallback =====

Sinon :

<code prisma>
embedding Json?
</code>

----

====== Étape 4-A.9 — Consolidation Gouvernance ======

===== Modèles =====

<code>
AuditLog

EntityHistory

FeatureFlag

Workflow

WorkflowStep

WorkflowInstance

WorkflowExecution
</code>

----

===== Multi-tenant =====

Ajouter :

<code prisma>
tenantId String
</code>

sur l'ensemble des modèles.

----

====== Étape 4-A.10 — Mise en place du Multi-Tenant ======

===== Modèle central =====

<code prisma>
model Tenant {

id          String   @id @default(uuid())

code        String   @unique

name        String

active      Boolean  @default(true)

createdAt   DateTime @default(now())

updatedAt   DateTime @updatedAt
}
</code>

----

===== Relation standard =====

Ajouter sur tous les modèles métier :

<code prisma>
tenantId String

tenant Tenant
  @relation(fields:[tenantId], references:[id])
</code>

----

===== Index =====

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

----

====== Étape 4-A.11 — Soft Delete Global ======

===== Ajouter sur tous les modèles métier =====

<code prisma>
deletedAt DateTime?
</code>

----

===== Bénéfices =====

<code>
Suppression logique

Restauration possible

Audit complet

Conformité RGPD
</code>

----

====== Étape 4-A.12 — Audit Global ======

===== Ajouter sur tous les modèles métier =====

<code prisma>
createdAt DateTime @default(now())

updatedAt DateTime @updatedAt

createdBy String?

updatedBy String?
</code>

----

===== Objectif =====

Tracer :

<code>
Création

Modification

Historique utilisateur
</code>

sur l'ensemble du système.

----

====== Étape 4-A.13 — Indexation Enterprise ======

===== Ajouter systématiquement =====

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

@@index([updatedAt])

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

sur tous les modèles volumineux :

<code>
Reservation

Payment

Invoice

Lead

Activity

AuditLog

Notification

Message

CampaignExecution

AutomationExecution
</code>

----

====== Étape 4-A.14 — Validation du schéma ======

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

<code bash>
npx prisma validate
</code>

----

===== Formatage =====

<code bash>
npx prisma format
</code>

----

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

<code bash>
npx prisma generate
</code>

----

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

À la fin de la Phase 4-A :

<code>
1 schema.prisma consolidé

≈ 110 modèles

≈ 350 relations

≈ 150 enums

≈ 500 index

100 % cohérent

Prêt pour migration
</code>

----

====== Livrable ======

<code>
apps/api/prisma/schema.prisma
</code>

----

====== Phase 4-B — Migrations Prisma ======

===== Objectif =====

Transformer le schéma Prisma consolidé :

<code>
apps/api/prisma/schema.prisma
</code>

en une véritable base PostgreSQL opérationnelle.

À l'issue de cette phase :

<code>
✓ Base PostgreSQL créée

✓ Tables générées

✓ Index générés

✓ Contraintes générées

✓ Prisma Client généré

✓ Prisma Studio disponible
</code>

----

====== Prérequis ======

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

<code bash>
docker ps
</code>

Vous devez voir :

<code>
postgres
</code>

en cours d'exécution.

----

===== Tester la connexion =====

<code bash>
psql -h localhost -U postgres
</code>

ou

<code bash>
docker exec -it postgres psql -U postgres
</code>

----

====== Étape 4-B.1 — Création du fichier .env ======

===== apps/api/.env =====

<code bash>
touch apps/api/.env
</code>

----

===== Contenu =====

<code>
DATABASE_URL="postgresql://postgres:postgres@localhost:5432/rental_platform?schema=public"
</code>

----

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

----

====== Étape 4-B.2 — Validation Prisma ======

===== Vérification du schéma =====

<code bash>
cd apps/api

npx prisma validate
</code>

----

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

<code>
The schema at prisma/schema.prisma is valid
</code>

----

===== Si erreur =====

Corriger :

<code>
relations

enum

index

syntaxe Prisma
</code>

avant de continuer.

----

====== Étape 4-B.3 — Formatage Prisma ======

===== Formatage =====

<code bash>
npx prisma format
</code>

----

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

<code>
Prisma schema loaded

Formatted prisma/schema.prisma
</code>

----

====== Étape 4-B.4 — Création de la première migration ======

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

<code bash>
npx prisma migrate dev --name init
</code>

----

===== Prisma va créer =====

<code>
prisma/

└── migrations/

└── xxxxxxxxx_init/

└── migration.sql
</code>

----

===== Exemple =====

<code>
CREATE TABLE "User"

CREATE TABLE "Role"

CREATE TABLE "Property"

CREATE TABLE "Reservation"

CREATE TABLE "Invoice"

CREATE TABLE "Payment"
</code>

etc.

----

====== Étape 4-B.5 — Vérification des tables ======

===== Ouvrir PostgreSQL =====

<code bash>
docker exec -it postgres psql -U postgres
</code>

----

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

<code sql>
\c rental_platform
</code>

----

===== Lister les tables =====

----

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

<code>
Tenant

User

Role

Permission

Owner

Property

Customer

Reservation

Contract

Invoice

Payment

...
</code>

≈ 110 tables.

----

====== Étape 4-B.6 — Génération Prisma Client ======

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

<code bash>
npx prisma generate
</code>

----

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

<code>
node_modules/.prisma/client
</code>

----

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

<code bash>
ls node_modules/.prisma/client
</code>

----

====== Étape 4-B.7 — Test Prisma Client ======

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

<code>
apps/api/src/test-prisma.ts
</code>

----

===== Contenu =====

<code ts>
import { PrismaClient } from '@prisma/client';

const prisma = new PrismaClient();

async function main() {

const tenants = await prisma.tenant.findMany();

console.log(tenants);
}

main();
</code>

----

===== Exécuter =====

<code bash>
npx ts-node src/test-prisma.ts
</code>

----

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

ou une liste de tenants.

----

====== Étape 4-B.8 — Seed Initial ======

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

<code>
prisma/seed.ts
</code>

----

===== Tenant principal =====

<code ts>
await prisma.tenant.create({

data: {

code: 'MAIN',

name: 'Main Tenant'
  }
});
</code>

----

===== Rôle Admin =====

<code ts>
await prisma.role.create({

data: {

code: 'SUPER_ADMIN',

name: 'Super Administrateur'
  }
});
</code>

----

===== Permissions =====

<code ts>
await prisma.permission.createMany({

data: [

{
      code: 'users.read',
      name: 'Users Read'
    },

{
      code: 'users.create',
      name: 'Users Create'
    }
  ]
});
</code>

----

===== Exécuter =====

<code bash>
npx prisma db seed
</code>

----

====== Étape 4-B.9 — Prisma Studio ======

===== Lancer =====

<code bash>
npx prisma studio
</code>

----

===== URL =====

<code>
http://localhost:5555
</code>

----

===== Vérifications =====

<code>
Tenant

User

Role

Permission

Property

Reservation

Payment

Invoice
</code>

doivent être visibles.

----

====== Étape 4-B.10 — Snapshot SQL ======

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

<code bash>
pg_dump \
-U postgres \
-d rental_platform \
-s \
> schema.sql
</code>

----

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

<code>
schema.sql
</code>

Ce fichier servira :

<code>
Audit

Review

Backup

Documentation
</code>

----

====== Contrôles qualité ======

===== Nombre de tables =====

<code sql>
SELECT count(*)

FROM information_schema.tables

WHERE table_schema='public';
</code>

----

===== Nombre d'index =====

<code sql>
SELECT count(*)

FROM pg_indexes

WHERE schemaname='public';
</code>

----

===== Nombre de contraintes =====

<code sql>
SELECT count(*)

FROM information_schema.table_constraints;
</code>

----

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

La Phase 4-B est terminée lorsque :

<code>
✓ Migration init exécutée

✓ PostgreSQL fonctionnel

✓ 110+ tables créées

✓ Prisma Client généré

✓ Seed exécuté

✓ Prisma Studio fonctionnel

✓ Snapshot SQL généré
</code>

----

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

<code>
prisma/schema.prisma

prisma/migrations/*

prisma/seed.ts

schema.sql
</code>

----

====== Étape suivante ======

===== Phase 4-C — DTO & Contrats TypeScript =====

Objectif :

Générer l'ensemble des contrats applicatifs :

<code>
DTO NestJS

Types TypeScript

Zod Schemas

OpenAPI Models

Validation Classes
</code>

à partir du Prisma Schema consolidé.

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