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 15 — Multi-sites, Marque Blanche & Réseau d'Agences ======

===== Objectif du Sprint =====

Transformer la plateforme en solution SaaS multi-marques capable de gérer :

* Plusieurs agences
  * Plusieurs enseignes
  * Plusieurs sites web
  * Plusieurs domaines
  * Plusieurs catalogues
  * Plusieurs chartes graphiques

depuis une infrastructure unique.

À l'issue du Sprint 15 :

* Une agence peut exploiter plusieurs sites web
  * Chaque site dispose de son identité graphique
  * Les domaines personnalisés sont supportés
  * Les réseaux d'agences sont gérés nativement
  * Les biens peuvent être mutualisés
  * Les réservations inter-agences sont possibles

Ce sprint marque le passage d'un SaaS mono-agence à une plateforme multi-enseignes.

----

====== Vision Architecture ======

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

<code>
Plateforme SaaS

├── Réseau A
│   ├── Agence A1
│   ├── Agence A2
│   └── Agence A3
│
├── Réseau B
│   ├── Agence B1
│   └── Agence B2
│
└── Réseau C
</code>

----

===== Exploitation =====

Chaque agence peut disposer :

<code>
Site Web

Logo

Couleurs

Domaine

Catalogue

Pages CMS

Emails
</code>

----

====== Périmètre ======

===== Modules concernés =====

<code>
MultiSiteModule

WhiteLabelModule

BrandingModule

AgencyNetworkModule

DomainManagementModule

CatalogSharingModule
</code>

----

====== User Stories ======

===== US-1501 : Créer un site =====

**En tant qu'administrateur réseau**

Je souhaite créer un site

Afin de publier une nouvelle marque.

----

===== Endpoint =====

<code http>
POST /sites
</code>

----

===== Informations =====

<code>
Nom

Code

Langue

Agence

Domaine principal
</code>

----

====== US-1502 : Configurer un domaine ======

===== Endpoint =====

<code http>
POST /sites/{id}/domains
</code>

----

===== Exemple =====

<code>
www.agence-a.fr

locations.agence-a.fr

booking.agence-a.fr
</code>

----

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

<code>
DNS

SSL

Redirections
</code>

----

====== US-1503 : Gérer plusieurs domaines ======

===== Cas d'usage =====

<code>
1 Site

↓

N Domaines
</code>

----

====== Marque Blanche ======

===== US-1504 : Personnaliser l'identité visuelle =====

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

<code>
Logo

Couleurs

Typographie

Favicon

Images
</code>

----

===== Endpoint =====

<code http>
PUT /sites/{id}/branding
</code>

----

====== US-1505 : Personnaliser les emails ======

===== Éléments =====

<code>
Expéditeur

Logo

Couleurs

Signature
</code>

----

====== Thèmes ======

===== US-1506 : Gérer les thèmes =====

===== Endpoint =====

<code http>
GET /themes

POST /themes
</code>

----

===== Composants configurables =====

<code>
Header

Footer

Cartes biens

Pages recherche

Pages détail
</code>

----

===== Structure =====

<code>
Theme

↓

Tokens

↓

Composants

↓

Pages
</code>

----

====== Réseau d'agences ======

===== US-1507 : Créer un réseau =====

===== Endpoint =====

<code http>
POST /agency-networks
</code>

----

===== Informations =====

<code>
Nom

Code

Description
</code>

----

====== US-1508 : Associer une agence =====

===== Endpoint =====

<code http>
POST /agency-networks/{id}/agencies
</code>

----

====== Mutualisation ======

===== US-1509 : Mutualiser les biens =====

===== Objectif =====

Partager des biens entre agences.

----

===== Exemple =====

<code>
Agence Montpellier

↓

Bien visible

↓

Agence Nîmes

↓

Bien visible
</code>

----

===== Endpoint =====

<code http>
POST /properties/{id}/sharing
</code>

----

====== US-1510 : Définir les règles de partage =====

===== Règles =====

<code>
Visible

Réservable

Commissionnable
</code>

----

====== Réservations inter-agences ======

===== US-1511 : Réserver un bien partagé =====

===== Workflow =====

<code>
Agence A

↓

Réservation

↓

Bien Agence B

↓

Commission
</code>

----

====== US-1512 : Calcul des commissions =====

===== Données =====

<code>
Agence source

Agence propriétaire

Montant

Pourcentage
</code>

----

===== Calcul =====

:contentReference[oaicite:0]{index=0}

----

====== Catalogue multi-sites ======

===== US-1513 : Affecter un bien à plusieurs sites =====

===== Endpoint =====

<code http>
POST /properties/{id}/sites
</code>

----

===== Exemple =====

<code>
Bien

↓

Site A

Site B

Site C
</code>

----

====== US-1514 : Gérer la visibilité =====

===== Modes =====

<code>
PUBLIC

PRIVATE

NETWORK

AGENCY_ONLY
</code>

----

====== CMS léger ======

===== US-1515 : Gérer les pages =====

===== Endpoint =====

<code http>
GET /sites/{id}/pages

POST /sites/{id}/pages
</code>

----

===== Pages =====

<code>
Accueil

À propos

Services

Contact

Mentions légales
</code>

----

====== US-1516 : Gérer les menus =====

===== Configuration =====

<code>
Navigation

Footer

Liens externes
</code>

----

====== Modèle Prisma ======

===== Site =====

<code prisma>
model Site {

id              String @id @default(uuid())

tenantId        String

code            String @unique

name            String

active          Boolean

createdAt       DateTime @default(now())
}
</code>

----

===== SiteDomain =====

<code prisma>
model SiteDomain {

id              String @id @default(uuid())

siteId          String

domain          String

isPrimary       Boolean
}
</code>

----

===== Branding =====

<code prisma>
model Branding {

id              String @id @default(uuid())

siteId          String

logoUrl         String?

primaryColor    String?

secondaryColor  String?
}
</code>

----

===== AgencyNetwork =====

<code prisma>
model AgencyNetwork {

id              String @id @default(uuid())

code            String @unique

name            String
}
</code>

----

===== PropertySharing =====

<code prisma>
model PropertySharing {

id              String @id @default(uuid())

propertyId      String

agencyId        String

visibility      String
}
</code>

----

====== Architecture Backend ======

<code>
src/modules/network

├── sites
│
├── branding
│
├── domains
│
├── networks
│
├── sharing
│
└── cms
</code>

----

====== Domain Services ======

<code>
SiteService

BrandingService

DomainService

AgencyNetworkService

PropertySharingService

CmsService
</code>

----

====== Événements métier ======

===== SiteCreated =====

<code>
SiteCreated
</code>

----

===== DomainValidated =====

<code>
DomainValidated
</code>

----

===== PropertyShared =====

<code>
PropertyShared
</code>

----

====== Frontend ======

===== Back Office =====

Pages :

<code>
/admin/sites

/admin/sites/[id]

/admin/branding

/admin/networks

/admin/sharing

/admin/cms
</code>

----

===== Front Office =====

Génération dynamique :

<code>
www.agence-a.fr

www.agence-b.fr

www.agence-c.fr
</code>

----

===== Composants =====

<code>
ThemeEditor

BrandingManager

DomainManager

NetworkExplorer

SharingRulesEditor

CmsPageEditor
</code>

----

====== Swagger ======

===== Tags =====

<code>
Sites

Branding

Domains

Networks

Sharing

CMS
</code>

----

===== Volume API =====

Environ :

<code>
50 endpoints
</code>

----

====== Tests ======

===== Unitaires =====

<code>
SiteService

BrandingService

DomainService

AgencyNetworkService
</code>

----

===== Intégration =====

<code>
Création site

↓

Branding

↓

Domaine

↓

Publication
</code>

----

===== E2E =====

<code>
Création réseau

↓

Création agence

↓

Création site

↓

Publication bien

↓

Réservation inter-agence
</code>

----

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

Le Sprint 15 est terminé lorsque :

* Multi-sites opérationnel
  * Marque blanche opérationnelle
  * Domaines personnalisés opérationnels
  * Réseaux d'agences opérationnels
  * Mutualisation opérationnelle
  * Réservations inter-agences opérationnelles
  * CMS opérationnel
  * Swagger à jour
  * Tests verts
  * CI verte

----

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

* MultiSiteModule
  * WhiteLabelModule
  * BrandingModule
  * AgencyNetworkModule
  * DomainManagementModule
  * CatalogSharingModule
  * CMSModule
  * DTO
  * Swagger
  * Tests
  * Migrations Prisma

----

====== Bilan Release 3.1 ======

À l'issue du Sprint 15 :

* SaaS multi-tenant avancé
  * Réseaux d'agences
  * Multi-sites
  * Marque blanche
  * Mutualisation des catalogues
  * Réservations inter-agences

La plateforme devient commercialisable auprès de groupes immobiliers, franchises, réseaux de conciergeries et opérateurs multi-marques.

----

====== Sprint suivant ======

===== Sprint 16 — Mobile, PWA & Expérience Terrain =====

Objectif :

Permettre aux utilisateurs, propriétaires et équipes terrain d'utiliser la plateforme depuis mobile avec ou sans connexion.

Modules concernés :

<code>
MobileModule

PWAModule

OfflineModule

CheckInModule

CheckOutModule

FieldOperationsModule
</code>

Fonctionnalités :

* Progressive Web App
  * Mode hors ligne
  * Check-in mobile
  * Check-out mobile
  * États des lieux numériques
  * Signature sur mobile
  * Photos terrain
  * Synchronisation différée

À l'issue du Sprint 16, la plateforme sera pleinement exploitable sur le terrain.

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