diff --git a/README.md b/README.md
index e86da91..25234d6 100644
--- a/README.md
+++ b/README.md
@@ -1,45 +1,301 @@
-# Projet gesthub
+# 📘 Gesthub
+
-## Membres
+Construit avec les outils et les technologies nécessaires :
-- Lajus Erika
-- Lemoule Duparc Nathan
-- LABAT Nino
-
-## Présentation du projet
-Ce projet vise à créer une interface fait pour faciliter la gestion et communication au sein d'un projet ou d'une entreprise.
-
-On y retrouve deux roles distints :
-
-**1. Admin :**
-Gestion des utilisateurs : Création et suppression de comptes par les admins.
-
- Authentification sécurisée:Avec nom, prénom et mot de passe.
-
- Gestion des annonces : Les admins peuvent publier des annonces sous forme de post-it qui apparait dans une zone défini sur l'interface des membres.
-Chaque annonce a une date limite et disparaît automatiquement une fois la date dépassée.
-
- Gestion agenda : ajoute les évènement globaux
-
- Gestionnaire des taches : Création de tableaux, listes et cartes pour l'organisation des tâches.
-
-**2. Membre :**
- Agenda/Planning partagé :
-Visibilité des événements globaux ajouté par les admins.
-Possibilité d'ajouter des événements personnels.
-
- Gestion de projets façon Trello :
-Possibilité d'ajouter des cartes
-Suivi de l'avancement des projets.
-Visibilité sur les différents tableaux.
-
-Messagerie interne :
-Système de chat pour la communication en temps réel entre membres.
-
-Liens vers outils externes :
-Boutons pour accéder rapidement à des outils comme Discord, etc.
+
+
+
+
+
+
+
+
+
+## 🧱 Objectif
+
+Créer un site web multi-services (extranet/intranet) avec :
+- Authentification centralisée via **Keycloak**
+- Reverse proxy **Caddy**
+- Frontend/backend **Flask**
+- Chat & Gestion de tâches via **Mattermost**
+- Gestion d’annonces via JSON avec droits `/admin` (a faire)
+
+---
+
+## 🐳 Démarrage du projet
+
+### 1. **Structure Docker**
+
+Les services sont définis dans `docker-compose.yml` :
+- `caddy`: Reverse proxy + HTTPS automatique
+- `flask`: Application web backend
+- `mariadb`: Base de données
+- `keycloak`: SSO + gestion utilisateurs
+- `mattermost`: Chat et gestion de tâches (type Trello)
+
+Réseau utilisé : `gesthub_gesthub`
+
+---
+
+## 🔐 Authentification Keycloak
+
+### ✅ Étapes :
+
+1. Création du **realm `Gesthub`**
+2. Ajout des clients (Flask et Mattermost)
+3. Activation `OpenID Connect`
+4. Configuration des **Redirect URIs**
+ - Exemples :
+ - Flask → `https://dashboard.ninolbt.com/login/callback`
+ - Mattermost → `https://mattermost.ninolbt.com/signup/openid/complete`
+
+5. Pour les utilisateurs `/admin`, on utilise le **groupe `/admin`** dans Keycloak.
+
+---
+
+## 🌐 Reverse Proxy Caddy
+
+### 🛠️ `Caddyfile` :
+
+```caddyfile
+https://dashboard.ninolbt.com {
+ reverse_proxy flask:5000
+}
+
+https://keycloak.ninolbt.com {
+ reverse_proxy keycloak:8080
+}
+
+https://mattermost.ninolbt.com {
+ reverse_proxy mattermost:8065
+}
+```
+
+**Volumes persistants** :
+`caddy_data` et `caddy_config` montés dans `/data` et `/config`
+
+---
+
+## 🧩 Flask
+- back du dashboard
+- Permet la création/modification/suppression d’annonces en JSON (en test)
+- Accessible uniquement pour les utilisateurs avec le rôle `/admin` (via token) (en test)
+- Chargement des assets statiques corrigé avec Caddy
+
+---
+
+## 🗂️ Gestion des droits
+
+- Auth via Keycloak pour Flask, Mattermost, Wekan
+- Vérification des groupes dans Flask (`/admin`)
+- Redirections correctes avec URLs HTTPS Caddy
+
+---
+
+## 📌 Bugs et corrections
+
+- ⚠️ Redirection Keycloak incorrecte → Corrigé avec bon `redirect_uri`
+- ⚠️ Assets statiques Flask → corrigé via URL absolue en HTTPS
+- ✅ Reverse proxy fonctionne avec tous les services
+- ✅ HTTPS opérationnel via Caddy avec certificats Let's Encrypt
+
+---
+
+## 🚀 Démarrage
+
+```bash
+docker compose up --build -d
+```
+
+Si besoin :
+```bash
+docker compose logs -f [service]
+```
+
+---
+
+## 📤 Export complet
+
+Pour rendre le projet exportable :
+- Tout est containerisé (Docker)
+- Config Keycloak exporté (JSON disponible dans le dossier `export_keycloak`)
+- `docker-compose.yml`, `Caddyfile`, fichier disponible dans le repo
+
+
+
+
+Built with the tools and technologies:
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+---
+
+## Table of Contents
+
+- [Overview](#overview)
+- [Getting Started](#getting-started)
+ - [Prerequisites](#prerequisites)
+ - [Installation](#installation)
+ - [Usage](#usage)
+ - [Testing](#testing)
+- [Contributing](#contributing)
+- [Acknowledgment](#acknowledgment)
+
+---
+
+## Overview
+
+Gesthub is a powerful developer tool designed to streamline the setup and management of full-stack applications by integrating essential services into a cohesive environment.
+
+**Why Gesthub?**
+
+This project simplifies the development process, allowing developers to focus on building features rather than managing infrastructure. The core features include:
+
+- 🚀 **Docker Compose Configuration:** Simplifies orchestration of multiple services, reducing setup complexity.
+- 🌐 **Local Domain Management:** Scripts to add local domain entries streamline access to services, enhancing the development experience.
+- 🔒 **Integrated User Authentication:** Utilizes Keycloak for secure user management, addressing security concerns.
+- ⚙️ **Seamless Routing and Load Balancing:** Caddyfile configuration ensures efficient request handling, improving performance.
+- 🎨 **User-Friendly Interface:** Responsive design enhances collaboration and user experience.
+- 📊 **Centralized Data Management:** Structured storage for advertisements improves data handling capabilities.
+
+---
+
+## Getting Started
+
+### Prerequisites
+
+This project requires the following dependencies:
+
+- **Programming Language:** Shell
+- **Package Manager:** Bash
+- **Container Runtime:** Docker
+
+### Installation
+
+Build gesthub from the source and intsall dependencies:
+
+1. **Clone the repository:**
+
+ ```sh
+ ❯ git clone https://github.com/M1n-0/gesthub
+ ```
+
+2. **Navigate to the project directory:**
+
+ ```sh
+ ❯ cd gesthub
+ ```
+
+3. **Install the dependencies:**
+
+**Using [docker](https://www.docker.com/):**
+
+```sh
+❯ docker build -t M1n-0/gesthub .
+```
+**Using [bash](https://www.gnu.org/software/bash/):**
+
+```sh
+❯ chmod +x {entrypoint}
+```
+
+### Usage
+
+Run the project with:
+
+**Using [docker](https://www.docker.com/):**
+
+```sh
+docker run -it {image_name}
+```
+**Using [bash](https://www.gnu.org/software/bash/):**
+
+```sh
+./{entrypoint}
+```
+
+### Testing
+
+Gesthub uses the {__test_framework__} test framework. Run the test suite with:
+
+**Using [docker](https://www.docker.com/):**
+
+```sh
+echo 'INSERT-TEST-COMMAND-HERE'
+```
+**Using [bash](https://www.gnu.org/software/bash/):**
+
+```sh
+bats *.bats
+```
+
+---
+
+## Contributing
+
+- **💬 [Join the Discussions](https://github.com/M1n-0/gesthub/discussions)**: Share your insights, provide feedback, or ask questions.
+- **🐛 [Report Issues](https://github.com/M1n-0/gesthub/issues)**: Submit bugs found or log feature requests for the `gesthub` project.
+- **💡 [Submit Pull Requests](https://github.com/M1n-0/gesthub/blob/main/CONTRIBUTING.md)**: Review open PRs, and submit your own PRs.
+
+Contributing Guidelines
+
+1. **Fork the Repository**: Start by forking the project repository to your github account.
+2. **Clone Locally**: Clone the forked repository to your local machine using a git client.
+ ```sh
+ git clone https://github.com/M1n-0/gesthub
+ ```
+3. **Create a New Branch**: Always work on a new branch, giving it a descriptive name.
+ ```sh
+ git checkout -b new-feature-x
+ ```
+4. **Make Your Changes**: Develop and test your changes locally.
+5. **Commit Your Changes**: Commit with a clear message describing your updates.
+ ```sh
+ git commit -m 'Implemented new feature x.'
+ ```
+6. **Push to github**: Push the changes to your forked repository.
+ ```sh
+ git push origin new-feature-x
+ ```
+7. **Submit a Pull Request**: Create a PR against the original project repository. Clearly describe the changes and their motivations.
+8. **Review**: Once your PR is reviewed and approved, it will be merged into the main branch. Congratulations on your contribution!
+