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 9 — Messagerie & Notifications ======

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

Mettre en place un centre de communication unifié couvrant l'ensemble des échanges entre :

* Clients
  * Propriétaires
  * Gestionnaires
  * Commerciaux
  * Administrateurs

À l'issue du Sprint 9 :

* Une messagerie interne est disponible
  * Les emails transactionnels sont automatisés
  * Les SMS transactionnels sont opérationnels
  * Les notifications temps réel sont centralisées
  * Les modèles de communication sont administrables
  * Les campagnes marketing sont gérées depuis la plateforme

Ce sprint transforme la plateforme en outil omnicanal de communication.

----

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

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

<code>
MessagingModule

NotificationsModule

EmailModule

SmsModule

TemplatesModule

CampaignsModule

RealtimeModule
</code>

----

====== Workflow global ======

<code>
Événement métier

↓

Notification Engine

↓

Email

SMS

Notification In-App

WebSocket

↓

Historisation
</code>

----

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

===== US-901 : Envoyer un message interne =====

**En tant qu'utilisateur**

Je souhaite envoyer un message

Afin d'échanger avec l'agence.

----

===== Endpoint =====

<code http>
POST /messages
</code>

----

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

<code>
Destinataire

Sujet

Message

Pièces jointes
</code>

----

====== US-902 : Consulter ses conversations ======

===== Endpoint =====

<code http>
GET /messages/conversations
</code>

----

===== Informations =====

<code>
Participants

Dernier message

Date

Nombre non lus
</code>

----

====== US-903 : Répondre à une conversation ======

===== Endpoint =====

<code http>
POST /messages/conversations/{id}/messages
</code>

----

====== US-904 : Joindre un document =====

===== Types =====

<code>
PDF

Image

Document bureautique
</code>

----

===== Taille maximale =====

----

====== Emails transactionnels ======

===== US-905 : Notification réservation =====

===== Déclencheur =====

<code>
ReservationCreated
</code>

----

===== Destinataires =====

<code>
Client

Agence

Propriétaire
</code>

----

====== US-906 : Notification contrat =====

===== Déclencheur =====

<code>
ContractGenerated

ContractSigned
</code>

----

====== US-907 : Notification paiement =====

===== Déclencheur =====

<code>
PaymentSucceeded

PaymentFailed

RefundIssued
</code>

----

====== SMS transactionnels ======

===== US-908 : Envoyer un SMS =====

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

<code>
Confirmation réservation

Rappel arrivée

Paiement en attente

Signature en attente
</code>

----

===== Fournisseurs =====

<code>
Twilio

OVH SMS

SMSFactor
</code>

----

====== Notifications temps réel ======

===== US-909 : Notification In-App =====

===== Endpoint =====

<code http>
GET /notifications
</code>

----

===== Types =====

<code>
INFO

SUCCESS

WARNING

ERROR
</code>

----

====== US-910 : Marquer comme lu =====

===== Endpoint =====

<code http>
POST /notifications/{id}/read
</code>

----

====== US-911 : Notifications WebSocket =====

===== Événements =====

<code>
Nouveau message

Nouveau contrat

Paiement reçu

Nouvelle réservation
</code>

----

====== Templates ======

===== US-912 : Créer un template =====

===== Endpoint =====

<code http>
POST /templates
</code>

----

===== Canaux =====

<code>
EMAIL

SMS

PUSH
</code>

----

===== Variables =====

<code>
{{customer_name}}

{{amount}}
</code>

----

====== US-913 : Prévisualiser un template =====

===== Endpoint =====

<code http>
POST /templates/preview
</code>

----

====== Campagnes Marketing ======

===== US-914 : Créer une campagne =====

===== Endpoint =====

<code http>
POST /campaigns
</code>

----

===== Types =====

<code>
EMAIL

SMS
</code>

----

===== Cibles =====

<code>
Clients

Prospects

Propriétaires
</code>

----

====== US-915 : Programmer une campagne =====

===== Planification =====

<code>
Date

Heure

Fuseau horaire
</code>

----

====== Historique des communications ======

===== US-916 : Consulter l'historique =====

===== Endpoint =====

<code http>
GET /communications/history
</code>

----

===== Filtres =====

<code>
Utilisateur

Canal

Date

Statut
</code>

----

====== Préférences de communication ======

===== US-917 : Paramétrer les notifications =====

===== Endpoint =====

<code http>
PUT /users/me/notification-settings
</code>

----

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

<code>
Email

SMS

Push

Marketing

Réservations

Paiements

Contrats
</code>

----

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

===== Conversation =====

<code prisma>
model Conversation {

id              String @id @default(uuid())

subject         String?

createdAt       DateTime @default(now())

}
</code>

----

===== Message =====

<code prisma>
model Message {

id              String @id @default(uuid())

conversationId  String

senderId        String

content         String

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

----

===== Notification =====

<code prisma>
model Notification {

id              String @id @default(uuid())

userId          String

type            String

title           String

message         String

isRead          Boolean @default(false)

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

----

===== Template =====

<code prisma>
model Template {

id              String @id @default(uuid())

name            String

channel         String

subject         String?

content         String

active          Boolean
}
</code>

----

===== Campaign =====

<code prisma>
model Campaign {

id              String @id @default(uuid())

name            String

channel         String

scheduledAt     DateTime?

status          String
}
</code>

----

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

<code>
src/modules/communications

├── messaging
│
├── notifications
│
├── email
│
├── sms
│
├── templates
│
├── campaigns
│
└── realtime
</code>

----

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

<code>
MessagingService

NotificationService

EmailService

SmsService

TemplateService

CampaignService

RealtimeService
</code>

----

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

===== MessageSent =====

<code>
MessageSent
</code>

----

===== NotificationCreated =====

<code>
NotificationCreated
</code>

----

===== EmailSent =====

<code>
EmailSent
</code>

----

===== SmsSent =====

<code>
SmsSent
</code>

----

===== CampaignExecuted =====

<code>
CampaignExecuted
</code>

----

====== Intégrations externes ======

===== Email =====

<code>
Resend

SendGrid

Mailjet
</code>

----

===== SMS =====

<code>
Twilio

OVH SMS

SMSFactor
</code>

----

===== Temps réel =====

<code>
Socket.IO

WebSocket Gateway NestJS
</code>

----

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

===== Tags =====

<code>
Messaging

Notifications

Templates

Campaigns

Emails

Sms
</code>

----

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

Environ :

<code>
35 endpoints
</code>

----

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

===== Pages =====

<code>
/messages

/messages/[id]

/notifications

/templates

/campaigns

/campaigns/[id]
</code>

----

===== Composants =====

<code>
MessageCenter

ConversationList

NotificationBell

NotificationCenter

TemplateEditor

CampaignScheduler
</code>

----

====== Dashboard Communication ======

===== KPIs =====

<code>
Messages envoyés

Emails envoyés

SMS envoyés

Taux ouverture

Taux clic

Campagnes actives
</code>

----

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

===== Unitaires =====

<code>
MessagingService

NotificationService

EmailService

SmsService

CampaignService
</code>

----

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

<code>
Réservation

↓

Notification

↓

Email

↓

Historisation
</code>

----

===== E2E =====

<code>
Création réservation

↓

Notification automatique

↓

Email envoyé

↓

SMS envoyé

↓

Consultation historique
</code>

----

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

Le Sprint 9 est terminé lorsque :

* Messagerie interne opérationnelle
  * Emails transactionnels opérationnels
  * SMS opérationnels
  * Notifications opérationnelles
  * Templates opérationnels
  * Campagnes opérationnelles
  * Temps réel opérationnel
  * Swagger à jour
  * Tests verts
  * CI verte

----

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

* MessagingModule
  * NotificationsModule
  * EmailModule
  * SmsModule
  * TemplatesModule
  * CampaignsModule
  * RealtimeModule
  * DTO
  * Swagger
  * Tests
  * Migrations Prisma

----

====== Démonstration Sprint ======

Scénario métier :

<code>
1. Création réservation

2. Notification automatique

3. Envoi email

4. Envoi SMS

5. Message client

6. Réponse agence

7. Notification temps réel

8. Consultation historique
</code>

----

====== Bilan Release 1.3 ======

À l'issue du Sprint 9 :

* CRM complet
  * Communications centralisées
  * Emails automatisés
  * SMS automatisés
  * Notifications temps réel
  * Campagnes marketing

La plateforme couvre désormais l'ensemble du cycle relationnel avec les clients et les propriétaires.

----

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

===== Sprint 10 — Reporting & Business Intelligence =====

Objectif :

Fournir aux directions et gestionnaires les indicateurs de pilotage de l'activité.

Modules concernés :

<code>
ReportingModule

DashboardModule

AnalyticsModule

ExportsModule

ForecastModule
</code>

Fonctionnalités :

* Tableaux de bord
  * KPI financiers
  * KPI commerciaux
  * KPI d'occupation
  * Exports Excel/PDF
  * Prévisions de revenus
  * Statistiques propriétaires
  * Statistiques biens

À l'issue du Sprint 10, la plateforme disposera d'une couche décisionnelle complète permettant le pilotage de l'agence.

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