Crealcs Development DokuWiki

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

====== Sprint 6 — Multi-Propriétés & Gestion du Parc ======

===== Objectif =====

Faire évoluer la plateforme d'un modèle mono-propriété vers une plateforme Enterprise multi-sites.

Cette couche permet de gérer :

<code>
Portefeuilles

Groupes de propriétés

Propriétaires

Exploitants

Actifs

Performance globale
</code>

sur plusieurs centaines ou milliers de propriétés.

À l'issue du Sprint 6 :

<code>
✓ Portfolio Management

✓ Property Groups

✓ Owners

✓ Operators

✓ Asset Management

✓ Portfolio Analytics

✓ Enterprise Multi-Property Platform
</code>

----

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

<code>
Tenant

↓

Portfolio

├── Property Groups
├── Properties
├── Owners
├── Operators
├── Assets
└── Portfolio Analytics

↓

Reservations

↓

Finance

↓

Operations
</code>

----

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

Le Sprint 6 introduit :

<code>
Portfolio

PropertyGroup

Owner

Operator

Asset

AssetAssignment

PortfolioAnalytics

PortfolioKPI
</code>

----

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

===== Sprint 6-A =====

Fondation Multi-Propriétés

<code>
Portfolio

Property Groups

Owners

Operators
</code>

----

===== Sprint 6-B =====

Asset Management

<code>
Assets

Lifecycle

Assignments

Maintenance Integration
</code>

----

===== Sprint 6-C =====

Portfolio Analytics

<code>
Portfolio KPIs

Revenue

Occupancy

Benchmarking

Forecasting
</code>

----

===== Sprint 6-D =====

Enterprise Governance

<code>
Multi-Site RBAC

Approvals

Compliance

Delegation
</code>

----

====== Livrables fin Sprint 6 ======

<code>
Portfolio Engine

Property Group Management

Owner Management

Operator Management

Asset Platform

Portfolio Analytics

Enterprise Multi-Site Platform
</code>

----

====== Sprint 6-A.1 — Implémentation Prisma Portfolio Core ======

===== Objectif =====

Créer la fondation Multi-Propriétés Enterprise.

Cette couche permet de regrouper plusieurs propriétés dans des structures hiérarchiques :

<code>
Tenant

↓

Portfolio

↓

Property Group

↓

Properties
</code>

avec gestion des :

<code>
Propriétaires

Exploitants

Groupes

Portefeuilles
</code>

À l'issue de cette étape :

<code>
✓ Portfolio

✓ PropertyGroup

✓ Owner

✓ Operator

✓ Multi-Property Ready

✓ Finance Ready

✓ Reservation Ready

✓ Analytics Ready
</code>

----

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

<code>
Tenant

↓

Portfolio

├── Property Groups
│
├── Owners
│
├── Operators
│
└── Properties

↓

Reservations

↓

Finance

↓

Analytics
</code>

----

====== Sprint 6-A.1-A ======

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

----

====== Étape 1 — Portfolio ======

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

<code prisma>
model Portfolio {

id                    String
                        @id
                        @default(uuid())

tenantId              String

name                  String

code                  String
                        @unique

description           String?

active                Boolean
                        @default(true)

createdAt             DateTime
                        @default(now())

updatedAt             DateTime
                        @updatedAt

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

propertyGroups        PropertyGroup[]

properties            Property[]

@@index([tenantId])

@@index([active])

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

----

====== Étape 2 — PropertyGroup ======

===== Ajouter =====

<code prisma>
model PropertyGroup {

id                    String
                        @id
                        @default(uuid())

tenantId              String

portfolioId           String

name                  String

code                  String

description           String?

active                Boolean
                        @default(true)

createdAt             DateTime
                        @default(now())

updatedAt             DateTime
                        @updatedAt

portfolio             Portfolio
                        @relation(
                          fields:[portfolioId],
                          references:[id],
                          onDelete:Cascade
                        )

properties            Property[]

@@unique([
    portfolioId,
    code
  ])

@@index([tenantId])

@@index([portfolioId])

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

----

====== Étape 3 — Owner ======

===== Ajouter =====

<code prisma>
model Owner {

id                    String
                        @id
                        @default(uuid())

tenantId              String

ownerCode             String
                        @unique

type                  OwnerType

companyName           String?

firstName             String?

lastName              String?

email                 String?

phone                 String?

taxIdentifier         String?

active                Boolean
                        @default(true)

createdAt             DateTime
                        @default(now())

updatedAt             DateTime
                        @updatedAt

properties            Property[]

@@index([tenantId])

@@index([ownerCode])

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

----

====== Étape 4 — Operator ======

===== Ajouter =====

<code prisma>
model Operator {

id                    String
                        @id
                        @default(uuid())

tenantId              String

operatorCode          String
                        @unique

companyName           String

email                 String?

phone                 String?

active                Boolean
                        @default(true)

createdAt             DateTime
                        @default(now())

updatedAt             DateTime
                        @updatedAt

properties            Property[]

@@index([tenantId])

@@index([operatorCode])

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

----

====== Étape 5 — OwnerType ======

===== Ajouter =====

<code prisma>
enum OwnerType {

INDIVIDUAL

COMPANY

INVESTMENT_FUND

REIT

GOVERNMENT
}
</code>

----

====== Sprint 6-A.1-B ======

===== Extension du modèle Property =====

----

====== Étape 6 — Ajouter Portfolio ======

===== Dans Property =====

<code prisma>
portfolioId            String?

portfolio              Portfolio?
                        @relation(
                          fields:[portfolioId],
                          references:[id]
                        )
</code>

----

====== Étape 7 — Ajouter Property Group ======

===== Dans Property =====

<code prisma>
propertyGroupId        String?

propertyGroup          PropertyGroup?
                        @relation(
                          fields:[propertyGroupId],
                          references:[id]
                        )
</code>

----

====== Étape 8 — Ajouter Owner ======

===== Dans Property =====

<code prisma>
ownerId                String?

owner                  Owner?
                        @relation(
                          fields:[ownerId],
                          references:[id]
                        )
</code>

----

====== Étape 9 — Ajouter Operator ======

===== Dans Property =====

<code prisma>
operatorId             String?

operator               Operator?
                        @relation(
                          fields:[operatorId],
                          references:[id]
                        )
</code>

----

====== Étape 10 — Ajouter Index ======

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

@@index([propertyGroupId])

@@index([ownerId])

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

----

====== Sprint 6-A.1-C ======

===== Relations Tenant =====

----

====== Étape 11 — Ajouter ======

===== Dans Tenant =====

<code prisma>
portfolios Portfolio[]

owners Owner[]

operators Operator[]
</code>

----

====== Étape 12 — Multi-Tenant ======

===== Garantir =====

que :

<code>
Portfolio

PropertyGroup

Owner

Operator
</code>

appartiennent toujours au même :

<code>
tenantId
</code>

----

====== Sprint 6-A.1-D ======

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

----

====== Étape 13 — Portfolio ======

===== Supporter =====

<code>
1 Tenant

↓

N Portfolios
</code>

----

====== Étape 14 — Property Group ======

===== Supporter =====

<code>
1 Portfolio

↓

N Property Groups
</code>

----

====== Étape 15 — Owner ======

===== Supporter =====

<code>
1 Owner

↓

N Properties
</code>

----

====== Étape 16 — Operator ======

===== Supporter =====

<code>
1 Operator

↓

N Properties
</code>

----

====== Sprint 6-A.1-E ======

===== Finance Ready =====

----

====== Étape 17 — Préparer =====

Compatible avec :

<code>
Revenue Sharing

Owner Statements

Commission Engine

Asset Accounting
</code>

----

====== Étape 18 — Préparer =====

Compatible avec :

<code>
Multi-Owner Properties

Operator Contracts

Portfolio Finance
</code>

----

====== Sprint 6-A.1-F ======

===== Reservation Ready =====

----

====== Étape 19 — Préparer =====

Compatible avec :

<code>
Portfolio Occupancy

Group Reservations

Multi-Site Reporting
</code>

----

====== Étape 20 — Préparer =====

Compatible avec :

<code>
Cross Property Search

Portfolio Analytics

Enterprise Reporting
</code>

----

====== Sprint 6-A.1-G ======

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

----

====== Étape 21 — Préparer =====

Compatible avec :

<code>
Portfolio Revenue

Portfolio Occupancy

Benchmarking

Forecasting

Asset Performance
</code>

----

====== Étape 22 — Préparer =====

Compatible avec :

<code>
Executive Dashboard

Owner Dashboard

Operator Dashboard
</code>

----

====== Sprint 6-A.1-H ======

===== Migration =====

----

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

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

----

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

<code bash>
npx prisma generate
</code>

----

====== Étape 25 — Vérifier =====

<code bash>
npx prisma studio
</code>

Présence de :

<code>
Portfolio

PropertyGroup

Owner

Operator
</code>

----

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

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

<code>
✓ Portfolio créé

✓ PropertyGroup créé

✓ Owner créé

✓ Operator créé

✓ Relations Property créées

✓ Relations Tenant créées

✓ Multi-Tenant Ready

✓ Finance Ready

✓ Analytics Ready

✓ Migration exécutée
</code>

----

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

<code>
Portfolio

PropertyGroup

Owner

Operator

OwnerType

Portfolio Core Schema
</code>

----

====== Sprint 6-A.2 — Gestion Multi-Propriétés Enterprise ======

===== Objectif =====

Construire la couche métier Multi-Propriétés Enterprise.

Cette couche permet de gérer :

<code>
Portefeuilles

Groupes de propriétés

Propriétaires

Exploitants

Hiérarchie multi-sites

Sécurité multi-niveaux
</code>

à partir d'une interface unique.

À l'issue de cette étape :

<code>
✓ PortfolioModule

✓ PropertyGroupModule

✓ OwnerModule

✓ OperatorModule

✓ Portfolio Hierarchy

✓ Portfolio Security

✓ Portfolio Dashboard

✓ Enterprise Multi-Site Management
</code>

----

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

<code>
Portfolio

├── Property Groups
│
├── Properties
│
├── Owners
│
├── Operators
│
└── Portfolio Dashboard

↓

Reservations

↓

Finance

↓

Analytics
</code>

----

====== Sprint 6-A.2-A ======

===== Modules Métier =====

----

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

<code>
src/modules/portfolio

├── portfolio
│
├── property-groups
│
├── owners
│
├── operators
│
├── dashboard
│
└── portfolio.module.ts
</code>

----

====== Étape 2 — Services ======

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

<code>
PortfolioService

PropertyGroupService

OwnerService

OperatorService

PortfolioHierarchyService

PortfolioDashboardService
</code>

----

====== Étape 3 — Controllers ======

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

<code>
PortfolioController

PropertyGroupController

OwnerController

OperatorController

PortfolioDashboardController
</code>

----

====== Sprint 6-A.2-B ======

===== Gestion des Portefeuilles =====

----

====== Étape 4 — PortfolioService ======

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

<code>
portfolio.service.ts
</code>

----

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

<code ts>
createPortfolio()

updatePortfolio()

archivePortfolio()

getPortfolio()

getPortfolioSummary()
</code>

----

====== Étape 5 — Endpoints ======

===== Ajouter =====

<code http>
GET    /portfolios

GET    /portfolios/{id}

POST   /portfolios

PUT    /portfolios/{id}

DELETE /portfolios/{id}
</code>

----

====== Étape 6 — Validation ======

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

<code>
tenantId

unicité code

ownership
</code>

sur chaque opération.

----

====== Sprint 6-A.2-C ======

===== Gestion des Groupes =====

----

====== Étape 7 — PropertyGroupService ======

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

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

----

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

<code ts>
createGroup()

assignProperty()

removeProperty()

moveProperty()
</code>

----

====== Étape 8 — Structure ======

===== Supporter =====

<code>
Portfolio

↓

Region

↓

City

↓

Properties
</code>

----

====== Étape 9 — Endpoints ======

===== Ajouter =====

<code http>
GET    /property-groups

POST   /property-groups

PUT    /property-groups/{id}

DELETE /property-groups/{id}

POST   /property-groups/{id}/properties
</code>

----

====== Sprint 6-A.2-D ======

===== Gestion des Propriétaires =====

----

====== Étape 10 — OwnerService ======

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

<code>
owner.service.ts
</code>

----

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

<code ts>
createOwner()

updateOwner()

assignProperty()

getOwnerPortfolio()
</code>

----

====== Étape 11 — Informations ======

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

<code>
Personne physique

Société

Coordonnées

Fiscalité

Contrats
</code>

----

====== Étape 12 — Endpoints ======

===== Ajouter =====

<code http>
GET    /owners

GET    /owners/{id}

POST   /owners

PUT    /owners/{id}

DELETE /owners/{id}
</code>

----

====== Sprint 6-A.2-E ======

===== Gestion des Exploitants =====

----

====== Étape 13 — OperatorService ======

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

<code>
operator.service.ts
</code>

----

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

<code ts>
createOperator()

updateOperator()

assignProperty()

getOperatorPerformance()
</code>

----

====== Étape 14 — Endpoints ======

===== Ajouter =====

<code http>
GET    /operators

GET    /operators/{id}

POST   /operators

PUT    /operators/{id}

DELETE /operators/{id}
</code>

----

====== Sprint 6-A.2-F ======

===== Hiérarchie Enterprise =====

----

====== Étape 15 — PortfolioHierarchyService ======

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

<code>
portfolio-hierarchy.service.ts
</code>

----

===== Construire =====

<code>
Portfolio

↓

PropertyGroup

↓

Property
</code>

----

====== Étape 16 — Fonctions ======

===== Supporter =====

<code ts>
getTree()

getChildren()

getAncestors()

calculateAggregates()
</code>

----

====== Étape 17 — Agrégations ======

===== Calculer =====

<code>
Properties Count

Revenue

Occupancy

Reservations

Reviews
</code>

par niveau.

----

====== Sprint 6-A.2-G ======

===== Portfolio Security =====

----

====== Étape 18 — Portfolio Scope ======

===== Ajouter =====

<code>
portfolioId

propertyGroupId

propertyId
</code>

comme scopes de sécurité.

----

====== Étape 19 — RBAC ======

===== Supporter =====

<code>
Portfolio Admin

Portfolio Manager

Group Manager

Property Manager

Owner Viewer
</code>

----

====== Étape 20 — Filtrage ======

===== Imposer =====

sur toutes les requêtes :

<code>
tenantId

portfolioId
</code>

afin d'éviter toute fuite de données.

----

====== Étape 21 — Decorators ======

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

<code ts>
@PortfolioScope()

@PropertyGroupScope()
</code>

pour les futurs modules.

----

====== Sprint 6-A.2-H ======

===== Dashboard Portfolio =====

----

====== Étape 22 — PortfolioDashboardService ======

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

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

----

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

<code>
Properties

Reservations

Revenue

Occupancy

Reviews

Incidents
</code>

----

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

===== Ajouter =====

<code http>
GET /portfolios/{id}/dashboard
</code>

----

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

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

<code json>
{
  "properties":124,
  "occupancy":81.4,
  "revenue":2450000,
  "reservations":8421,
  "rating":4.7
}
</code>

----

====== Étape 25 — KPIs ======

===== Mesurer =====

<code>
Revenue

Occupancy

ADR

RevPAR

Reservations

Guest Satisfaction
</code>

----

====== Sprint 6-A.2-I ======

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

----

====== Étape 26 — Recherche ======

===== Ajouter =====

<code http>
GET /portfolios/search

GET /owners/search

GET /operators/search
</code>

----

====== Étape 27 — Pagination ======

===== Supporter =====

<code>
Page

Limit

Sort

Filters
</code>

sur tous les endpoints.

----

====== Étape 28 — Export ======

===== Ajouter =====

<code http>
GET /portfolios/{id}/export
</code>

Formats :

<code>
CSV

Excel

PDF
</code>

----

====== Sprint 6-A.2-J ======

===== Gouvernance =====

----

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

===== Ajouter =====

<code>
portfolio.read

portfolio.create

portfolio.update

portfolio.delete

portfolio.dashboard

owner.manage

operator.manage
</code>

----

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

===== Journaliser =====

<code>
PORTFOLIO_CREATED

PORTFOLIO_UPDATED

PROPERTY_ASSIGNED

OWNER_ASSIGNED

OPERATOR_ASSIGNED

PORTFOLIO_DASHBOARD_VIEWED
</code>

----

====== Étape 31 — Préparation Sprint 6-B =====

Compatible avec :

<code>
Assets

Equipment

Lifecycle

Depreciation

Capital Expenditure
</code>

----

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

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

<code>
✓ PortfolioModule créé

✓ PropertyGroupModule créé

✓ OwnerModule créé

✓ OperatorModule créé

✓ Portfolio Hierarchy créée

✓ Portfolio Security créée

✓ Portfolio Dashboard créé

✓ Audit intégré
</code>

----

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

<code>
PortfolioModule

PropertyGroupModule

OwnerModule

OperatorModule

PortfolioHierarchyService

PortfolioDashboardService

Portfolio Security Layer

Enterprise Multi-Property Platform
</code>

----

Résumé

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