> ## Documentation Index
> Fetch the complete documentation index at: https://wl.macaly.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Bases de données

> Apprenez à stocker des données et à créer des fonctionnalités comme les formulaires et tableaux de bord

Une base de données est l'endroit où votre projet stocke les informations.

Chaque fois que votre site ou application a besoin de mémoriser quelque chose, il utilise une base de données. Cela peut être :

* Un message soumis via un formulaire
* Une adresse e-mail d'une inscription à une newsletter
* Un article de blog que vous publiez
* Une demande de réservation ou une inscription
* Un compte utilisateur ou un profil

Au lieu que les informations disparaissent après un rechargement de page, la base de données les enregistre pour que vous puissiez les consulter, les utiliser et agir dessus ultérieurement.

Vous pouvez considérer une base de données comme un tableur qui se trouve derrière votre site :

* Chaque **ligne** est un élément (par exemple, un abonné ou une soumission de formulaire)
* Chaque **colonne** est une information (comme l'e-mail, le nom ou la date)

Macaly utilise les bases de données pour alimenter tout ce qui implique des données, des listes, des formulaires ou du contenu dynamique.

## **Bases de données, intégrées par défaut**

Chaque projet Macaly est livré avec une base de données prête à l'emploi.

Vous n'avez pas besoin de configurer Supabase, de créer des identifiants ou de connecter une base de données tierce. La base de données est déjà là et prête à être utilisée.

La base de données de Macaly est alimentée par **Convex**, ce qui signifie :

* Des mises à jour en temps réel par défaut
* Un dimensionnement automatique
* Une interface d'administration claire qui ressemble à Airtable ou Notion

Vous pouvez visualiser, filtrer et gérer vos données directement dans Macaly.

## **Utilisations courantes des bases de données**

Les bases de données sont flexibles et peuvent prendre en charge de nombreux workflows différents. Voici les cas d'usage courants, accompagnés d'exemples de prompts que vous pouvez utiliser pour les configurer.

### **Formulaires de contact et prospects**

Un cas d'usage très courant est le stockage des soumissions de formulaires de contact.

Exemples typiques :

* Formulaires de contact
* Pages de capture de prospects
* Formulaires de feedback ou de demande

Chaque soumission est enregistrée comme un nouvel enregistrement dans la base de données, pour que rien ne soit perdu.

**Exemple de prompt**

> Ajoute une base de données appelée "Prospects" pour stocker les soumissions du formulaire de contact avec les champs Nom, E-mail, Téléphone et Message. Connecte le formulaire de contact pour que chaque nouvelle soumission soit automatiquement enregistrée dans la base de données.

### **Newsletter et abonnements**

Les bases de données sont souvent utilisées pour stocker les abonnés à une newsletter ou les listes d'attente.

Cela vous permet de :

* Collecter des adresses e-mail
* Suivre quand quelqu'un s'est abonné
* Exporter la liste ultérieurement si nécessaire

**Exemple de prompt**

> Crée une base de données appelée "Abonnés" pour stocker les inscriptions à la newsletter avec les champs E-mail et Date d'abonnement. Connecte le champ de saisie e-mail de la page pour que chaque inscription soit enregistrée automatiquement.

<img src="https://mintcdn.com/macalywl/j-Vf23AL_8eSkHUs/images/new-DATABASES2.png?fit=max&auto=format&n=j-Vf23AL_8eSkHUs&q=85&s=e37d7c08eaee3991e9f00416d35ef485" alt="New DATABASES2" width="2168" height="1410" data-path="images/new-DATABASES2.png" />

### **Gestion de contenu (CMS)**

Les bases de données peuvent servir de système de gestion de contenu pour le contenu dynamique.

Exemples courants :

* Articles de blog
* Cas d'usage
* Avis
* FAQ
* Répertoires et annuaires

<img src="https://mintcdn.com/macalywl/j-Vf23AL_8eSkHUs/images/new-DATABASES1.png?fit=max&auto=format&n=j-Vf23AL_8eSkHUs&q=85&s=6af5affad26282327b3fb02f247250f2" alt="New DATABASES1" width="2168" height="1410" data-path="images/new-DATABASES1.png" />

Au lieu de modifier le contenu directement sur la page, vous le gérez sous forme de données structurées.

**Exemple de prompt**

> Crée une base de données appelée "Articles" avec les champs Titre, Description, Contenu, Image et Date de publication. Utilise-la pour afficher une liste d'articles de blog sur le site web.

### **Systèmes de réservation et demandes**

Les bases de données peuvent stocker les informations de réservation ou de demande.

Exemples typiques :

* Demandes de rendez-vous
* Réservations de démonstration
* Inscriptions à des événements

Chaque demande est enregistrée pour que vous puissiez la consulter ou y donner suite ultérieurement.

**Exemple de prompt**

> Ajoute une base de données appelée "Réservations" pour stocker les demandes de rendez-vous avec les champs Nom, E-mail, Date et Message. Connecte-la au formulaire de réservation du site.

### **Tableaux de bord d'administration et outils internes**

Les bases de données sont souvent associées à des pages internes pour créer des outils d'administration simples.

Ceux-ci sont utiles pour :

* Examiner les soumissions de formulaires
* Gérer les abonnés
* Modérer le contenu
* Gérer les workflows internes

L'accès peut être restreint à l'aide de l'authentification.

**Exemple de prompt**

> Crée un tableau de bord d'administration à /admin avec authentification par e-mail et mot de passe. Affiche un tableau de tous les abonnés à la newsletter avec l'e-mail et la date d'abonnement, et permets l'export de la liste en CSV.

### **Notifications et e-mails automatisés**

Les bases de données peuvent déclencher des actions lorsque de nouvelles données sont créées.

Exemples courants :

* Notifier votre équipe lorsqu'un formulaire est soumis
* Envoyer des e-mails de confirmation aux utilisateurs

**Exemple de prompt**

> Lorsqu'une nouvelle soumission de formulaire est reçue, envoie une notification par e-mail à [my@email.com](mailto:my@email.com) avec les détails soumis.

**Exemple de prompt**

> Après la soumission d'un formulaire, envoie un e-mail de confirmation à l'utilisateur pour le remercier et confirmer la réception.

## **Comment penser les bases de données dans Macaly**

Si votre projet a besoin de :

* Stocker des informations
* Afficher des listes d'éléments
* Alimenter des formulaires ou du contenu
* Suivre les utilisateurs ou les soumissions

Vous aurez probablement besoin d'une base de données.

Macaly est conçu pour que vous n'ayez pas à comprendre la théorie des bases de données pour en utiliser une. Vous décrivez ce que vous souhaitez stocker et comment cela doit fonctionner, et Macaly gère la structure et les connexions pour vous.

## **Bases de données de test**

Par défaut, votre application Macaly utilise une seule **base de données de production** partagée entre votre site publié et votre environnement de chat/prévisualisation. Cela signifie que les modifications effectuées dans le chat ou la prévisualisation affectent immédiatement votre site en production.

<img src="https://mintcdn.com/macalywl/j-Vf23AL_8eSkHUs/images/Testingdatabase.png?fit=max&auto=format&n=j-Vf23AL_8eSkHUs&q=85&s=ea063d42dd79a5b9f801bf2547c1b360" alt="Testingdatabase" width="2168" height="1356" data-path="images/Testingdatabase.png" />

Les bases de données de test vous permettent de travailler dans un environnement sûr et isolé sans risquer vos données de production.

### **Comment ça fonctionne**

1. **Créer une base de données de test** - Copie toutes les données de votre base de données de production dans une instance séparée
2. **Effectuer des modifications en toute sécurité** - Travaillez dans le chat et la prévisualisation sans affecter votre site publié
3. **Tester minutieusement** - Vérifiez que tout fonctionne comme prévu
4. **Revenir à la production** - Vos modifications de schéma et de fonctions sont appliquées automatiquement
5. **Publier** - Déployez vos mises à jour pour les utilisateurs

### **Configurer une base de données de test**

1. Ouvrez l'onglet **Base de données** dans le chat
2. Cliquez sur **« Ajouter le mode test »**
3. Attendez que la configuration soit terminée

Une fois créée, vous pouvez basculer entre les environnements **Production** et **Test** en utilisant les boutons de l'onglet Base de données. La prévisualisation se met à jour pour afficher les données de la base de données sélectionnée.

<Note>
  Vous ne pouvez publier que lorsque vous utilisez la base de données de production. Si vous essayez de publier en utilisant la base de test, vous serez invité à basculer d'abord vers la production.
</Note>

## **Dupliquer un projet**

Lorsque vous dupliquez un projet qui possède une base de données, choisissez ce qui doit arriver à ses données :

* **Créer une nouvelle base de données** : crée une base indépendante et y copie les données actuelles du projet d'origine. Les modifications ultérieures de schéma ou de données dans un projet n'affectent pas l'autre.
* **Utiliser la même base de données** : maintient les deux projets connectés à une seule base, de sorte que les modifications de schéma ou de données de l'un sont visibles dans l'autre. Cette option n'est disponible que dans le même workspace.

Les duplicatas ordinaires commencent sans historique de conversation. Republiez le duplicata et reliez tout domaine personnalisé qu'il doit utiliser.

## **Questions fréquemment posées**

<AccordionGroup>
  <Accordion title="Quelle base de données utilise Macaly ?">
    Les projets Macaly utilisent Convex comme base de données backend. Vous pouvez consulter et gérer vos données via l'onglet **Base de données** dans l'éditeur Macaly.
  </Accordion>

  <Accordion title="Puis-je exporter ou importer la base de données de mon projet ?">
    Oui, directement depuis l'onglet **Base de données**. **Exporter** télécharge un instantané complet de vos données au format ZIP, utile comme sauvegarde ou pour migrer vers votre propre compte Convex. **Importer** restaure un instantané dans votre projet ; cela remplace toutes les données existantes, Macaly demande donc une confirmation explicite avant de continuer.
  </Accordion>

  <Accordion title="Puis-je migrer la base de données de mon projet vers mon propre compte Convex ?">
    Oui. Exportez un instantané de la base de données (ZIP) depuis l'onglet **Base de données**, créez votre propre compte Convex, importez l'instantané en suivant le guide sur docs.convex.dev, puis mettez à jour les secrets Convex dans les paramètres de votre projet Macaly. Il y aura une brève interruption pendant la transition.
  </Accordion>

  <Accordion title="Si je passe à ma propre base de données Convex, puis-je continuer à utiliser Macaly pour créer ?">
    Oui. Vous pouvez continuer à développer avec Macaly après avoir migré vers votre propre base de données Convex. L'onglet **Base de données** dans Macaly ne fonctionnera plus, mais toutes les autres fonctionnalités continuent normalement.
  </Accordion>
</AccordionGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.