# 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.