feat: update onboarding and application flows

2026-08-25 15:55:11 +02:00
parent 4fb8a3e1e0
commit bc7edcf3a7
38 changed files with 7234 additions and 289 deletions
@@ -0,0 +1,158 @@
+# Emails existants MusicLand
+
+Ce document liste uniquement les emails déjà présents comme emails dans l'application.
+
+Les notifications applicatives qui peuvent être transformées en emails via `notifications/{notificationId}` sont exclues volontairement.
+
+## Synthèse
+
+| # | Email | Service | Déclencheur | Destinataire | Contenu maîtrisé dans le code |
+|---|---|---|---|---|---|
+| 1 | Bienvenue | Resend | Création d'un utilisateur | Nouvel utilisateur | Oui |
+| 2 | Réinitialisation du mot de passe | Firebase Auth | Mot de passe oublié | Email saisi | Non, template Firebase |
+| 3 | Vérification de nouvelle adresse email | Firebase Auth | Changement d'adresse email | Nouvelle adresse | Non, template Firebase |
+
+## 1. Email de bienvenue
+
+**Service**  
+Resend.
+
+**Expéditeur**  
+`MusicLand <musicland@musicland.ai>`
+
+**Déclencheur**  
+Création d'un document utilisateur `users/{userID}`.
+
+**Pourquoi il est envoyé**  
+Accueillir l'utilisateur après son inscription sur MusicLand.
+
+**Destinataire**  
+L'adresse stockée dans `users.email`.
+
+**Sujet**  
+`Bienvenue sur MusicLand`
+
+**Contenu exact du template**
+
+| Zone | Contenu |
+|---|---|
+| Logo | Logo MusicLand en haut de l'email |
+| Salutation | `Salut {firstName} {lastName},` si le prénom ou le nom existent |
+| Salutation fallback | `Salut,` si aucun prénom/nom n'est disponible |
+| Titre principal | `Bienvenue sur MusicLand` |
+| Paragraphe 1 | `Nous sommes ravis de t'accueillir dans la communauté des artistes et passionnés de MusicLand.` |
+| Paragraphe 2 | `Explore les playlists collaboratives, dépose tes projets et découvre ce que prépare la scène émergente.` |
+| Signature | `L'équipe MusicLand` |
+| Footer | `minuit.app · Paris, France` |
+
+**Exemple de contenu**
+
+```text
+Salut Maya Durand,
+
+Bienvenue sur MusicLand
+
+Nous sommes ravis de t'accueillir dans la communauté des artistes et passionnés de MusicLand.
+
+Explore les playlists collaboratives, dépose tes projets et découvre ce que prépare la scène émergente.
+
+L'équipe MusicLand
+
+minuit.app · Paris, France
+```
+
+**Variables utilisées**
+
+| Variable | Source | Usage |
+|---|---|---|
+| `email` | Document utilisateur | Destinataire |
+| `firstName` | Document utilisateur | Salutation personnalisée |
+| `lastName` | Document utilisateur | Salutation personnalisée |
+
+**Fichiers source**
+
+- `functions/src/users.js`
+- `functions/helpers/email.js`
+
+## 2. Email de réinitialisation du mot de passe
+
+**Service**  
+Firebase Auth.
+
+**Déclencheur**  
+L'utilisateur renseigne son adresse email dans l'écran mot de passe oublié.
+
+**Pourquoi il est envoyé**  
+Permettre à l'utilisateur de réinitialiser son mot de passe.
+
+**Destinataire**  
+L'adresse email saisie par l'utilisateur.
+
+**Sujet**  
+Non défini dans le repo. Le sujet est géré par le template Firebase Auth du projet.
+
+**Contenu**
+
+Le contenu exact n'est pas dans le code de l'application. Il est configuré côté Firebase Auth.
+
+Le code déclenche seulement :
+
+```js
+firebase.auth().sendPasswordResetEmail(trimmedEmail)
+```
+
+Le contenu attendu du template Firebase est :
+
+- un message indiquant qu'une demande de réinitialisation a été faite ;
+- un lien de réinitialisation du mot de passe ;
+- les instructions standard définies dans Firebase ;
+- éventuellement le nom de l'application selon la configuration Firebase.
+
+**Fichier source**
+
+- `src/screens/ForgotPassword.js`
+
+## 3. Email de vérification de nouvelle adresse email
+
+**Service**  
+Firebase Auth.
+
+**Déclencheur**  
+L'utilisateur demande à modifier son adresse email depuis son profil.
+
+**Pourquoi il est envoyé**  
+Vérifier la nouvelle adresse email avant de finaliser le changement.
+
+**Destinataire**  
+La nouvelle adresse email saisie par l'utilisateur.
+
+**Sujet**  
+Non défini dans le repo. Le sujet est géré par le template Firebase Auth du projet.
+
+**Contenu**
+
+Le contenu exact n'est pas dans le code de l'application. Il est configuré côté Firebase Auth.
+
+Le code déclenche :
+
+```js
+user.verifyBeforeUpdateEmail(val)
+```
+
+Le contenu attendu du template Firebase est :
+
+- un message indiquant qu'une modification d'adresse email a été demandée ;
+- un lien de vérification ;
+- les instructions standard définies dans Firebase ;
+- éventuellement le nom de l'application selon la configuration Firebase.
+
+**Fichier source**
+
+- `src/screens/Profile/ChangeEmailAddress.js`
+
+## Point important
+
+À partir du code du repo, le seul email dont le contenu HTML est entièrement maîtrisé dans l'application est l'email de bienvenue.
+
+Les deux autres emails existent bien dans les parcours produit, mais leur sujet et leur contenu exact dépendent des templates configurés dans Firebase Auth.
+