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 2 — Gestion Utilisateurs ======

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

Compléter le domaine Utilisateurs afin de disposer d'un référentiel utilisateur exploitable par tous les modules métiers.

À l'issue du Sprint 2 :

* Les utilisateurs disposent d'un profil complet
  * Les adresses sont gérées
  * Les documents sont téléversables
  * Les sessions sont historisées
  * Les connexions sont tracées
  * Les préférences utilisateur sont configurables
  * Les notifications sont personnalisables
  * Les fondations KYC sont prêtes

Ce sprint clôture le domaine Utilisateurs avant le démarrage du cœur métier immobilier.

----

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

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

<code>
UsersModule

ProfilesModule

DocumentsModule

SessionsModule

NotificationsModule
</code>

----

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

===== US-201 : Consulter son profil =====

**En tant qu'utilisateur**

Je souhaite consulter mes informations

Afin de vérifier leur exactitude.

----

===== Endpoint =====

<code http>
GET /users/me
</code>

----

===== Critères =====

* Profil complet affiché
  * Données à jour
  * Temps de réponse < 500 ms

----

====== US-202 : Modifier son profil ======

===== Endpoint =====

<code http>
PUT /users/me
</code>

----

===== Champs =====

<code>
Prénom

Nom

Téléphone

Date de naissance

Nationalité
</code>

----

====== US-203 : Gérer ses adresses ======

===== Endpoints =====

<code http>
GET    /users/me/addresses

POST   /users/me/addresses

PUT    /users/me/addresses/{id}

DELETE /users/me/addresses/{id}
</code>

----

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

<code>
Adresse

Complément

Code Postal

Ville

Pays

Adresse principale
</code>

----

====== US-204 : Déposer un document ======

===== Objectif =====

Préparer la vérification d'identité.

----

===== Types =====

<code>
IDENTITY_CARD

PASSPORT

DRIVING_LICENSE

PROOF_OF_ADDRESS

OTHER
</code>

----

===== Endpoint =====

<code http>
POST /users/me/documents
</code>

----

===== Critères =====

* Upload sécurisé
  * Virus Scan futur compatible
  * Stockage MinIO/S3

----

====== US-205 : Consulter ses documents ======

===== Endpoint =====

<code http>
GET /users/me/documents
</code>

----

====== US-206 : Vérification identité ======

===== Statuts =====

<code>
PENDING

UNDER_REVIEW

VALIDATED

REJECTED
</code>

----

===== Endpoint =====

<code http>
POST /users/me/identity-verification
</code>

----

===== Évolution future =====

Intégration :

<code>
FranceConnect

Onfido

Stripe Identity
</code>

----

====== US-207 : Consulter ses sessions ======

===== Endpoint =====

<code http>
GET /users/me/sessions
</code>

----

===== Informations =====

<code>
Date

Adresse IP

Navigateur

Pays

Statut
</code>

----

====== US-208 : Révoquer une session ======

===== Endpoint =====

<code http>
DELETE /users/me/sessions/{id}
</code>

----

===== Critères =====

* Déconnexion immédiate
  * Token invalidé

----

====== US-209 : Historique de connexion ======

===== Endpoint =====

<code http>
GET /users/me/login-history
</code>

----

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

<code>
Date

IP

Navigateur

Résultat

Pays
</code>

----

====== US-210 : Préférences utilisateur ======

===== Endpoint =====

<code http>
GET /users/me/preferences

PUT /users/me/preferences
</code>

----

===== Préférences =====

<code>
Langue

Fuseau horaire

Devise

Format date

Format heure
</code>

----

====== US-211 : Notifications ======

===== Endpoint =====

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

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

----

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

<code>
Email

SMS

Push

Marketing

Paiements

Réservations

Contrats
</code>

----

====== Architecture Prisma ======

===== UserAddress =====

<code prisma>
model UserAddress {

id            String @id @default(uuid())

userId        String

address1      String

address2      String?

postalCode    String

city          String

country       String

isDefault     Boolean @default(false)

user          User @relation(
                   fields: [userId],
                   references: [id]
                 )
}
</code>

----

===== UserDocument =====

<code prisma>
model UserDocument {

id            String @id @default(uuid())

userId        String

documentType  String

fileName      String

storagePath   String

status        String

uploadedAt    DateTime

}
</code>

----

===== UserSession =====

<code prisma>
model UserSession {

id            String @id @default(uuid())

userId        String

refreshToken  String

ipAddress     String

userAgent     String

expiresAt     DateTime

}
</code>

----

===== LoginHistory =====

<code prisma>
model LoginHistory {

id            String @id @default(uuid())

userId        String

ipAddress     String

userAgent     String

success       Boolean

createdAt     DateTime
}
</code>

----

===== UserPreference =====

<code prisma>
model UserPreference {

id            String @id @default(uuid())

userId        String @unique

language      String

timezone      String

currency      String

}
</code>

----

====== Structure Backend ======

<code>
src/modules/users

├── profile
│
├── addresses
│
├── documents
│
├── sessions
│
├── preferences
│
├── notifications
│
└── login-history
</code>

----

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

===== Nouveaux tags =====

<code>
Profiles

Addresses

Documents

Sessions

Preferences

Notifications
</code>

----

===== Nouveaux endpoints =====

Environ :

<code>
20 endpoints REST
</code>

----

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

===== Pages =====

<code>
/profile

/profile/personal

/profile/addresses

/profile/documents

/profile/preferences

/profile/security

/profile/sessions
</code>

----

===== Composants =====

<code>
ProfileCard

AddressForm

DocumentUploader

SessionTable

PreferencesForm

NotificationSettings
</code>

----

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

===== Unitaires =====

<code>
UserProfileService

AddressService

DocumentService

SessionService
</code>

----

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

<code>
Upload document

↓

Consultation document

↓

Suppression document
</code>

----

===== E2E =====

<code>
Login

↓

Modifier profil

↓

Ajouter adresse

↓

Uploader document

↓

Modifier préférences

↓

Consulter sessions
</code>

----

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

Le Sprint 2 est terminé lorsque :

* Profil complet opérationnel
  * Adresses opérationnelles
  * Documents opérationnels
  * Sessions opérationnelles
  * Historique opérationnel
  * Préférences opérationnelles
  * Swagger à jour
  * Tests verts
  * CI verte

----

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

* UserProfileModule
  * UserAddressModule
  * UserDocumentModule
  * UserSessionModule
  * UserPreferenceModule
  * NotificationPreferenceModule
  * DTO
  * Migrations Prisma
  * Swagger
  * Tests

----

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

Scénario complet :

<code>
1. Création compte

2. Connexion

3. Modification profil

4. Ajout adresse

5. Upload document

6. Modification préférences

7. Consultation sessions

8. Déconnexion d'une session
</code>

----

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

===== Sprint 3 — Catalogue Immobilier =====

Objectif :

Construire le premier domaine métier cœur de la plateforme.

Modules concernés :

<code>
PropertiesModule

PropertyMediaModule

PropertyFeaturesModule

PropertyAvailabilityModule

PropertyRatesModule
</code>

Fonctionnalités :

* Création d'un bien
  * Modification d'un bien
  * Publication d'un bien
  * Gestion des photos
  * Gestion des équipements
  * Gestion des disponibilités
  * Gestion des tarifs
  * Consultation publique

À l'issue du Sprint 3, la plateforme sera capable de publier et administrer ses premiers biens immobiliers.

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