Merge pull request #8 from MouktarKimba/finalisation/readme-et-correctifs
Finalisation: Mise à jour du README et dernières corrections
This commit is contained in:
Mouktar KimBA
140
README.md
140
README.md
@ -1,92 +1,132 @@
|
|||||||
# Gestionnaire de Tâches - Projet Académique
|
# Gestionnaire de Tâches
|
||||||
|
|
||||||
Bienvenue sur mon projet de Gestionnaire de Tâches, une application web moderne et complète développée dans le cadre de mon cursus académique. L'application permet de gérer des tâches quotidiennes de manière simple et intuitive.
|
Une application web full-stack conteneurisée pour la gestion de tâches, développée avec un workflow de développement professionnel et collaboratif.
|
||||||
|
|
||||||
Ce projet démontre la mise en place d'une architecture web complète avec un frontend en React, un backend en Node.js, et une base de données MySQL, le tout orchestré dans un environnement de développement professionnel avec Docker.
|
[](https://opensource.org/licenses/MIT)
|
||||||
|
|
||||||
|
[](https://reactjs.org/)
|
||||||
*NOTE : Je te conseille de faire une vraie capture d'écran de ton application finale et de remplacer le lien ci-dessus.*
|
|
||||||
|
[](https://nodejs.org/)
|
||||||
|
|
||||||
|
[](https://www.docker.com/)
|
||||||
|
|
||||||
|
[](https://www.mysql.com/)
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## ✨ Fonctionnalités
|
### Table des matières
|
||||||
|
|
||||||
* **Ajout, Modification et Suppression** de tâches.
|
1. [À propos du projet](#à-propos-du-projet)
|
||||||
* **Dates d'échéance** pour chaque tâche.
|
|
||||||
* Marquer une tâche comme **terminée** et consulter l'historique.
|
2. [Stack Technique](#stack-technique)
|
||||||
* **Filtres dynamiques** pour afficher les tâches : "Aujourd'hui", "À venir" et "En retard".
|
|
||||||
* Interface utilisateur **moderne et responsive** avec un fond vidéo animé pour une expérience utilisateur agréable.
|
3. [Démarrage Rapide](#démarrage-rapide)
|
||||||
|
|
||||||
|
4. [Utilisation](#utilisation)
|
||||||
|
|
||||||
|
5. [Workflow Git](#workflow-git)
|
||||||
|
|
||||||
|
6. [Licence](#licence)
|
||||||
|
|
||||||
|
7. [Contact](#contact)
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 🛠️ Technologies Utilisées
|
## À propos du projet
|
||||||
|
|
||||||
Ce projet a été construit avec les technologies suivantes :
|
Ce projet est une application web de type "ToDo List" robuste et complète. Il permet aux utilisateurs de gérer leurs tâches quotidiennes de manière efficace, avec des fonctionnalités d'ajout, de modification, de suppression et de suivi par date d'échéance.
|
||||||
|
|
||||||
* **Frontend :**
|
L'objectif était de mettre en œuvre une solution technique complète, de l'infrastructure au développement applicatif, en utilisant des pratiques professionnelles de gestion de version avec Git et une architecture entièrement conteneurisée.
|
||||||
* [React](https://reactjs.org/)
|
|
||||||
* [Vite](https://vitejs.dev/)
|
|
||||||
* [Sass](https://sass-lang.com/)
|
|
||||||
* [React-Bootstrap](https://react-bootstrap.github.io/)
|
|
||||||
* [date-fns](https://date-fns.org/) pour la manipulation des dates.
|
|
||||||
|
|
||||||
* **Backend :**
|
### Fonctionnalités
|
||||||
* [Node.js](https://nodejs.org/)
|
|
||||||
* [Express.js](https://expressjs.com/)
|
|
||||||
|
|
||||||
* **Base de Données :**
|
* **Gestion complète du cycle de vie des tâches** (CRUD).
|
||||||
* [MySQL](https://www.mysql.com/)
|
|
||||||
|
|
||||||
* **Environnement & Déploiement :**
|
* **Suivi par date d'échéance** pour une meilleure organisation.
|
||||||
* [Docker](https://www.docker.com/) & [Docker Compose](https://docs.docker.com/compose/)
|
|
||||||
* [Traefik](https://traefik.io/traefik/) comme reverse proxy.
|
* **Statut de complétion** avec un historique des tâches terminées.
|
||||||
|
|
||||||
|
* **Filtres dynamiques** pour trier les tâches par "Aujourd'hui", "À venir" et "En retard".
|
||||||
|
|
||||||
|
* **Persistance des données** dans une base de données MySQL.
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 🚀 Installation et Lancement
|
## Stack Technique
|
||||||
|
|
||||||
Pour lancer ce projet en local, vous aurez besoin de **Docker Desktop** installé sur votre machine.
|
| Catégorie | Technologies |
|
||||||
|
| -------------- | --------------------------------------------------------------------------------------------- |
|
||||||
|
| **Frontend** | React, Vite, Sass, React-Bootstrap, date-fns |
|
||||||
|
| **Backend** | Node.js, Express.js |
|
||||||
|
| **Base de Données** | MySQL |
|
||||||
|
| **Infrastructure** | Docker, Docker Compose, Traefik (Reverse Proxy) |
|
||||||
|
|
||||||
1. **Clonez ce dépôt GitHub :**
|
---
|
||||||
|
|
||||||
|
## Démarrage Rapide
|
||||||
|
|
||||||
|
Pour lancer ce projet en local, **Docker Desktop** doit être installé et en cours d'exécution.
|
||||||
|
|
||||||
|
### Prérequis
|
||||||
|
|
||||||
|
* [Docker Desktop](https://www.docker.com/products/docker-desktop/)
|
||||||
|
|
||||||
|
### Installation
|
||||||
|
|
||||||
|
1. **Clonez le dépôt :**
|
||||||
```bash
|
```bash
|
||||||
# Remplace avec l'URL de TON propre dépôt GitHub
|
git clone [https://github.com/MouktarKimba/Todo-App-Projet.git](https://github.com/MouktarKimba/Todo-App-Projet.git)
|
||||||
git clone [https://github.com/TonNom/TonRepo.git](https://github.com/TonNom/TonRepo.git)
|
|
||||||
```
|
```
|
||||||
|
|
||||||
2. **Naviguez dans le dossier du projet :**
|
2. **Naviguez dans le dossier du projet :**
|
||||||
```bash
|
```bash
|
||||||
cd TonRepo
|
cd Todo-App-Projet
|
||||||
```
|
```
|
||||||
|
|
||||||
3. **Construisez et lancez les conteneurs Docker :**
|
3. **Construisez et lancez l'environnement :**
|
||||||
Cette commande va construire les images du backend et du frontend, télécharger MySQL et le proxy, et démarrer tous les services.
|
Cette commande unique va construire les images, installer les dépendances et démarrer tous les services.
|
||||||
```bash
|
```bash
|
||||||
docker-compose up --build
|
docker-compose up --build
|
||||||
```
|
```
|
||||||
La première fois, cela peut prendre quelques minutes.
|
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 🌐 Comment Utiliser l'Application
|
## Utilisation
|
||||||
|
|
||||||
Une fois les conteneurs démarrés, vous pouvez accéder aux différents services :
|
Une fois les conteneurs démarrés, les services suivants sont disponibles :
|
||||||
|
|
||||||
* **Application Principale :**
|
* **Application Principale :** ➡️ **[http://localhost:8000](http://localhost:8000)**
|
||||||
* Ouvrez votre navigateur et allez à l'adresse : **[http://localhost:8000](http://localhost:8000)**
|
|
||||||
|
|
||||||
* **Gestion de la Base de Données (phpMyAdmin) :**
|
* **Admin Base de Données (phpMyAdmin) :** ➡️ **[http://db.localhost:8000](http://db.localhost:8000)**
|
||||||
* Pour visualiser directement les données dans la base MySQL, allez à : **[http://db.localhost:8000](http://db.localhost:8000)**
|
|
||||||
* *(Note: Cette adresse est routée par le proxy, d'où le port 8000)*
|
|
||||||
|
|
||||||
* **Tableau de Bord du Proxy (Traefik) :**
|
* **Tableau de Bord du Proxy (Traefik) :** ➡️ **[http://localhost:8080](http://localhost:8080)**
|
||||||
* Pour voir l'état du routage et des services, allez à : **[http://localhost:8080](http://localhost:8080)**
|
|
||||||
|
Pourarrêter tous les services, retournez dans votre terminal et lancez `docker-compose down`.
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 🛑 Arrêter l'Application
|
## Workflow Git
|
||||||
|
|
||||||
Pour arrêter tous les services et supprimer les conteneurs, retournez dans votre terminal et lancez la commande :
|
Ce projet adhère à un modèle Git structuré pour garantir un travail d'équipe organisé et un code de qualité.
|
||||||
|
|
||||||
```bash
|
* `main` : Branche de production. Contient la version finale et validée du code. Elle est protégée.
|
||||||
docker-compose down
|
|
||||||
```
|
* `develop` : Branche d'intégration où toutes les fonctionnalités sont fusionnées et testées.
|
||||||
|
|
||||||
|
* `infrastructure` : Branche dédiée à la configuration des conteneurs (Dockerfile, compose.yml).
|
||||||
|
|
||||||
|
Toutes les contributions sont gérées via des **Pull Requests** et requièrent une révision, assurant ainsi la traçabilité et la qualité des modifications.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Licence
|
||||||
|
|
||||||
|
Ce projet est distribué sous la licence MIT. Voir le fichier `LICENSE` pour plus d'informations.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Contact
|
||||||
|
|
||||||
|
**Mouktar Kimba** - [GitHub](https://github.com/MouktarKimba)
|
||||||
|
|
||||||
|
Lien du Projet : [https://github.com/MouktarKimba/Todo-App-Projet](https://github.com/MouktarKimba/Todo-App-Projet)
|
||||||
@ -2,7 +2,7 @@
|
|||||||
"name": "gestionnaire-taches-api",
|
"name": "gestionnaire-taches-api",
|
||||||
"version": "1.0.0",
|
"version": "1.0.0",
|
||||||
"description": "API backend pour l'application de gestion de tâches.",
|
"description": "API backend pour l'application de gestion de tâches.",
|
||||||
"author": "Ton Nom <ton.email@example.com>",
|
"author": "MSSI-1 <info@sahelcyber.com>",
|
||||||
"license": "MIT",
|
"license": "MIT",
|
||||||
"main": "index.js",
|
"main": "index.js",
|
||||||
"repository": {
|
"repository": {
|
||||||
|
|||||||
@ -3,7 +3,7 @@
|
|||||||
"private": true,
|
"private": true,
|
||||||
"version": "1.0.0",
|
"version": "1.0.0",
|
||||||
"description": "Interface utilisateur pour l'application de gestion de tâches.",
|
"description": "Interface utilisateur pour l'application de gestion de tâches.",
|
||||||
"author": "Ton Nom <ton.email@example.com>",
|
"author": "MSSI-1 <info@sahelcyber.com>",
|
||||||
"license": "MIT",
|
"license": "MIT",
|
||||||
"type": "module",
|
"type": "module",
|
||||||
"repository": {
|
"repository": {
|
||||||
|
|||||||
Reference in New Issue
Block a user