diff --git a/README.md b/README.md
new file mode 100644
index 0000000000000000000000000000000000000000..68515e26eedf4492e4eb2cf5539331816f38a688
--- /dev/null
+++ b/README.md
@@ -0,0 +1,52 @@
+# VILLENEUVE CHAT
+
+## Déscription de l'application
+
+L'application VilleneuveChat permet de discuter au travers de "fils". Chaque utilisateur peut créer son fil et tout le monde peut rejoindre chaque fil.
+
+## Configuration
+Afin de modifier la configuration du serveur pour utiliser votre propre base de données,
+Il faut modifier le fichier `./WEB-INF/config.prop`. Il faut également initialiser
+la base de données en utilisant le script `./baseDeDonnee/init.sql`.
+
+## MCD et MLD
+Voici le MCD et le MLD que nous avons utilisé pour la base de donnée de notre application
+![](./baseDeDonnee/ScreenMCDv3.PNG)
+
+![](./baseDeDonnee/ScreenMLDv3.PNG)
+
+## Requete de base en SQL
+Voici quelques requetes que nous avons créé au début.
+
+La requête permettant de récuperer tous les messages du fil 5:
+```
+SELECT sender, message, time 
+FROM messages
+WHERE id_thread = 5
+ORDER BY time ASC;
+```
+
+La requête permettant de récuperer tous les utilisateurs du fil 5:
+```
+SELECT username, firstname, lastname 
+FROM users JOIN followers USING (username)
+WHERE id_thread = 5;
+```
+
+La requête permettant de créer un thread par l'utilisatrice Florine, avec le nom 'Chats et Douceur'
+```
+INSERT INTO threads (creator, name, date)
+VALUES ('florine', 'Chats et douceur', '2005-06-08');
+```
+
+La requête permettant d'envoyer un message
+```
+INSERT INTO messages (sender, id_thread, message, time)
+VALUES ('maxime', 5, 'Je suis une fleur', now());
+```
+
+Le reste des requêtes se trouve dans le dossier `./baseDeDonnee/requetes`.
+
+
+
+## Arborescence globale du projet
\ No newline at end of file