Sar_Tron/dockezr
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 2 Wiki Activity

🚀 Release v1.1.0 - Application en Production avec Monitoring

Browse Source 
✨ Nouvelles fonctionnalités:
- 🌐 Application déployée et accessible en ligne (http://141.253.118.141:3000)
- 📊 Dashboard Grafana complet avec métriques en temps réel
- 🚀 Configuration de production avec docker-compose.prod.yml
- 🏗️ Infrastructure robuste avec monitoring Prometheus + Grafana
- 📈 Métriques personnalisées (CPU, mémoire, requêtes, réservations)

🔧 Améliorations techniques:
- Backend FastAPI avec métriques Prometheus intégrées
- Configuration Docker optimisée pour la production
- Health checks pour tous les services
- Variables d'environnement sécurisées
- Configuration Ansible pour déploiement automatisé

📚 Documentation:
- README complet mis à jour avec liens de production
- CHANGELOG détaillé pour la version 1.1.0
- Notes de release complètes
- Guide de déploiement en production

🎯 Statut: Stable, déployé et accessible en ligne
This commit is contained in:
Rassaby Ludovic
2025-10-17 15:05:09 +04:00
parent 5a879b7db1
commit 35cad7998d
17 changed files with 1223 additions and 761 deletions
Download Patch File Download Diff File Expand all files Collapse all files
README.md
+235 -300
View File
@@ -1,28 +1,39 @@
# Expernet - Système de Réservation de Salles
# 🏢 Dockezr - Système de Réservation de Salles
Système complet de réservation de salles pour le centre de formation **Expernet**, développé avec **FastAPI** (Backend), **Next.js** (Frontend) et **PostgreSQL** (Base de données), orchestré avec Docker Compose.
[![Release](https://img.shields.io/badge/release-v1.0.0-blue.svg)](https://github.com/SarTron-NorthBlue/dockezr/releases/tag/v1.0.0)
[![Tests](https://github.com/SarTron-NorthBlue/dockezr/workflows/Tests%20API%20-%20TP4/badge.svg)](https://github.com/SarTron-NorthBlue/dockezr/actions)
[![Release](https://img.shields.io/badge/release-v1.1.0-blue.svg)](https://github.com/SarTron-NorthBlue/dockezr/releases/tag/v1.1.0)
[![Docker](https://img.shields.io/badge/docker-compose-blue.svg)](https://docs.docker.com/compose/)
[![Monitoring](https://img.shields.io/badge/monitoring-prometheus%20%2B%20grafana-orange.svg)](https://prometheus.io/)
[![Production](https://img.shields.io/badge/production-ready-green.svg)](http://141.253.118.141:3000)
## Stack Technique
Système complet de réservation de salles pour le centre de formation **Expernet**, développé avec **FastAPI** (Backend), **Next.js** (Frontend), **PostgreSQL** (Base de données) et **Prometheus + Grafana** (Monitoring), orchestré avec Docker Compose.
- **Backend**: FastAPI (Python) avec AsyncPG
- **Frontend**: Next.js 14 + TypeScript + Tailwind CSS
- **Base de données**: PostgreSQL 16
- **Containerisation**: Docker & Docker Compose
- **Tests**: Pytest avec GitHub Actions CI/CD
- **Versioning**: Git tags avec releases GitHub
## 🌐 **Application en Production**
## Fonctionnalités
**🚀 Accès direct à l'application :**
- **Frontend (Interface utilisateur)** : http://141.253.118.141:3000
- **Backend API** : http://141.253.118.141:8001
- **Documentation API** : http://141.253.118.141:8001/docs
- **Monitoring Grafana** : http://141.253.118.141:3001 (admin/Grafana2025!Secure)
- **Prometheus** : http://141.253.118.141:9090
### Gestion des Salles
## 🛠️ **Stack Technique**
- **Backend** : FastAPI (Python 3.11) avec AsyncPG
- **Frontend** : Next.js 14 + TypeScript + Tailwind CSS
- **Base de données** : PostgreSQL 16
- **Monitoring** : Prometheus + Grafana + Node Exporter
- **Containerisation** : Docker & Docker Compose
- **Tests** : Pytest avec GitHub Actions CI/CD
- **Déploiement** : Production sur serveur Oracle Cloud
## ✨ **Fonctionnalités**
### 🏛️ **Gestion des Salles**
- 5 salles pré-configurées (Atlas, Horizon, Innovation, Connect, Digital)
- Affichage des capacités et équipements
- Interface intuitive de sélection
### Réservations
### 📅 **Réservations**
- Formulaire de réservation complet
- Champ email optionnel
- Sélection de date et horaires
@@ -32,7 +43,7 @@ Système complet de réservation de salles pour le centre de formation **Experne
- Validation des créneaux disponibles
- Annulation de réservations
### Planning Visuel
### 📊 **Planning Visuel**
- **Grille de planning par jour** (8h-22h)
- Vue d'ensemble de toutes les salles
- Code couleur : ✅ Disponible / ❌ Réservé
@@ -40,27 +51,28 @@ Système complet de réservation de salles pour le centre de formation **Experne
- Navigation par date
- Liste détaillée des réservations du jour
### Suivi
- Vue d'ensemble de toutes les réservations
- Filtrage par salle et par date
- Historique complet
### 📈 **Monitoring et Observabilité**
- **Dashboard Grafana** complet avec métriques en temps réel
- **Métriques Prometheus** : CPU, mémoire, requêtes HTTP
- **Surveillance des performances** : temps de réponse, taux d'erreur
- **Métriques personnalisées** : réservations, accès aux salles
- **Alertes automatiques** en cas de problème
## Démarrage Rapide
## 🚀 **Démarrage Rapide**
### Prérequis
### **Prérequis**
- Docker et Docker Compose installés
- Ports 3000, 8001, 5432, 9090, 3001 disponibles
- Docker et Docker Compose installés sur votre machine
- Ports 3000, 8000 et 5432 disponibles
### **Installation et lancement**
### Installation et lancement
1. **Cloner le projet** (si applicable)
1. **Cloner le projet**
```bash
git clone <votre-repo>
git clone https://github.com/SarTron-NorthBlue/dockezr.git
cd dockezr
```
2. **Lancer tous les services avec Docker Compose**
2. **Lancer tous les services**
```bash
docker-compose up -d
```
@@ -70,29 +82,22 @@ ou utilisez le script Windows :
scripts/start.bat
```
Cette commande va :
- Créer le réseau Docker `dockezr_network`
- Démarrer PostgreSQL sur le port 5432
- Créer automatiquement les tables et les 5 salles par défaut
- Démarrer le backend FastAPI sur le port 8000
- Démarrer le frontend Next.js sur le port 3000
3. **Accéder à l'application**
- **Frontend (Interface de réservation)**: http://localhost:3000
- **Backend API**: http://localhost:8000
- **Documentation API (Swagger)**: http://localhost:8000/docs
- **Documentation API (ReDoc)**: http://localhost:8000/redoc
- **Prometheus (Monitoring)**: http://localhost:9090
- **Grafana (Tableaux de bord)**: http://localhost:3001 (admin/admin123)
- **Frontend** : http://localhost:3000
- **Backend API** : http://localhost:8001
- **Documentation API** : http://localhost:8001/docs
- **Prometheus** : http://localhost:9090
- **Grafana** : http://localhost:3001 (admin/Grafana2025!Secure)
## 📁 Structure du Projet
## 📁 **Structure du Projet**
```
dockezr/
├── backend/ # API FastAPI
│ ├── main.py # Point d'entrée de l'API
│ ├── main.py # Point d'entrée avec métriques Prometheus
│ ├── requirements.txt # Dépendances Python
│ └── Dockerfile # Configuration Docker
│ ├── Dockerfile # Configuration Docker
│ └── test_*.py # Tests automatisés
│
├── frontend/ # Application Next.js
│ ├── app/ # Pages et composants Next.js 14
@@ -110,67 +115,23 @@ dockezr/
│ ├── provisioning/ # Datasources et dashboards
│ └── dashboards/ # Tableaux de bord
│
├── ansible/ # Déploiement automatisé
│ ├── deploy.yml # Playbook Ansible
│ ├── inventory.ini # Inventaire des serveurs
│ └── group_vars/ # Variables de configuration
│
├── scripts/ # Scripts d'administration
│ ├── start.bat # Démarrage
│ ├── stop.bat # Arrêt
│ └── test.bat # Tests
│
├── docker-compose.yml # Orchestration des services
├── .dockerignore # Fichiers ignorés par Docker
├── .gitignore # Fichiers ignorés par Git
├── docker-compose.prod.yml # Configuration production
├── CHANGELOG.md # Historique des versions
└── README.md # Ce fichier
```
## 🔧 Commandes Utiles
### Démarrer les services
```bash
docker-compose up -d
```
### Arrêter les services
```bash
docker-compose down
```
ou utilisez le script Windows :
```bash
scripts/stop.bat
```
### Voir les logs
```bash
# Tous les services
docker-compose logs -f
# Service spécifique
docker-compose logs -f backend
docker-compose logs -f frontend
docker-compose logs -f db
docker-compose logs -f prometheus
docker-compose logs -f grafana
```
### Reconstruire les images
```bash
docker-compose up -d --build
```
### Arrêter et supprimer les volumes (⚠️ supprime les données)
```bash
docker-compose down -v
```
### Accéder à un conteneur
```bash
# Backend
docker exec -it dockezr_backend sh
# Frontend
docker exec -it dockezr_frontend sh
# Base de données
docker exec -it dockezr_db psql -U user -d dockezr
```
## 🏛️ Salles Pré-configurées
Le système est livré avec 5 salles de formation :
## 🏛️ **Salles Pré-configurées**
| Salle | Capacité | Équipements |
|-------|----------|-------------|
@@ -180,45 +141,137 @@ Le système est livré avec 5 salles de formation :
| **Salle Connect** | 8 personnes | Écran TV, Visioconférence, WiFi |
| **Salle Digital** | 20 personnes | 20 postes informatiques, Vidéoprojecteur, WiFi |
## 🌐 API Endpoints
### Routes des Salles
## 🌐 **API Endpoints**
### **Routes des Salles**
- `GET /rooms` - Liste toutes les salles
- `GET /rooms/{room_id}` - Récupère une salle spécifique
- `POST /rooms` - Crée une nouvelle salle
- `DELETE /rooms/{room_id}` - Supprime une salle
### Routes des Réservations
### **Routes des Réservations**
- `GET /reservations` - Liste toutes les réservations
- `GET /reservations/room/{room_id}` - Réservations d'une salle spécifique
- `GET /reservations/date/{date}` - Réservations pour une date donnée
- `POST /reservations` - Crée une nouvelle réservation
- `DELETE /reservations/{reservation_id}` - Annule une réservation
### Validation automatique
### **Monitoring**
- `GET /health` - Vérification de l'état de l'API
- `GET /metrics` - Métriques Prometheus
L'API vérifie automatiquement :
- ✅ La disponibilité de la salle
- ✅ Les conflits d'horaires
- ✅ La cohérence des horaires (début < fin)
- ✅ L'existence de la salle
### **Documentation interactive**
- **Swagger UI** : http://localhost:8001/docs
- **ReDoc** : http://localhost:8001/redoc
### Documentation interactive
- **Swagger UI**: http://localhost:8000/docs
- **ReDoc**: http://localhost:8000/redoc
## 📊 **Monitoring et Observabilité**
## 🗄️ Base de Données
### **Dashboard Grafana**
Le système inclut un dashboard Grafana complet avec :
### Configuration
- **Host**: localhost (ou `db` depuis les conteneurs)
- **Port**: 5432
- **Utilisateur**: user
- **Mot de passe**: password
- **Base de données**: dockezr
- **Status des Services** : Backend, Prometheus, Node Exporter
- **Métriques CPU** : Utilisation CPU du processus backend
- **Métriques Mémoire** : Utilisation mémoire en temps réel
- **Performance HTTP** : Requêtes par seconde, temps de réponse
- **Métriques Métier** : Nombre de réservations, accès aux salles
### Structure des tables
### **Métriques Prometheus**
- `http_requests_total` : Nombre total de requêtes HTTP
- `http_request_duration_seconds` : Durée des requêtes
- `reservations_total` : Nombre de réservations créées
- `room_access_total` : Nombre d'accès aux salles
- `process_cpu_seconds_total` : Utilisation CPU
- `process_resident_memory_bytes` : Utilisation mémoire
### **Accès au Monitoring**
- **Grafana** : http://141.253.118.141:3001
- **Identifiants** : `admin` / `Grafana2025!Secure`
- **Dashboard** : "Dockezr - Monitoring Complet"
## 🔧 **Commandes Utiles**
### **Démarrer les services**
```bash
docker-compose up -d
```
### **Arrêter les services**
```bash
docker-compose down
```
### **Voir les logs**
```bash
# Tous les services
docker-compose logs -f
# Service spécifique
docker-compose logs -f backend
docker-compose logs -f frontend
docker-compose logs -f prometheus
docker-compose logs -f grafana
```
### **Reconstruire les images**
```bash
docker-compose up -d --build
```
### **Tests automatisés**
```bash
scripts/test.bat
```
## 🚀 **Déploiement en Production**
### **Déploiement Automatisé avec Ansible**
Le projet inclut une configuration Ansible complète pour le déploiement automatisé :
```bash
# Déploiement automatique
cd ansible
./deploy-auto.ps1
# Déploiement manuel
./deploy-manuel.ps1
```
### **Configuration de Production**
Le fichier `docker-compose.prod.yml` est configuré pour la production avec :
- Variables d'environnement sécurisées
- Health checks pour tous les services
- Volumes persistants pour les données
- Réseaux Docker dédiés
- Configuration monitoring complète
### **Variables d'environnement de production**
```bash
# Base de données
POSTGRES_USER=dockezr_user
POSTGRES_PASSWORD=Dockezr2025!Secure
POSTGRES_DB=dockezr_prod
# Frontend
NEXT_PUBLIC_API_URL=http://141.253.118.141:8001
# Grafana
GF_SECURITY_ADMIN_USER=admin
GF_SECURITY_ADMIN_PASSWORD=Grafana2025!Secure
```
## 🗄️ **Base de Données**
### **Configuration**
- **Host** : localhost (ou `db` depuis les conteneurs)
- **Port** : 5432
- **Utilisateur** : `dockezr_user`
- **Mot de passe** : `Dockezr2025!Secure`
- **Base de données** : `dockezr_prod`
### **Structure des tables**
**Table `rooms`**
- id (SERIAL PRIMARY KEY)
@@ -238,12 +291,7 @@ L'API vérifie automatiquement :
- purpose (TEXT)
- created_at (TIMESTAMP)
### Connexion à PostgreSQL
```bash
docker exec -it dockezr_db psql -U user -d dockezr
```
## 🎨 Frontend
## 🎨 **Frontend**
L'interface utilise :
- **Next.js 14** avec App Router
@@ -251,7 +299,7 @@ L'interface utilise :
- **Tailwind CSS** pour le styling moderne et responsive
- **Axios** pour les requêtes HTTP vers l'API
### Fonctionnalités de l'interface
### **Fonctionnalités de l'interface**
**Onglet Planning (par défaut)**
- 📊 Grille de planning visuelle (8h-22h)
@@ -259,7 +307,6 @@ L'interface utilise :
- 📅 Sélecteur de date
- 👤 Affichage du nom de l'utilisateur sur les créneaux
- 📋 Liste détaillée des réservations du jour sélectionné
- 🖱️ Info-bulle au survol des créneaux réservés
**Onglet Réservation**
- Liste visuelle des salles disponibles avec détails
@@ -275,52 +322,46 @@ L'interface utilise :
- Informations détaillées (salle, date, horaire, objet)
- Possibilité d'annuler une réservation
## 🔄 Développement
## 🧪 **Tests et Qualité**
### Mode développement avec hot-reload
### **Tests automatisés**
- **Tests API** : Validation des endpoints avec Pytest
- **Tests de connectivité** : Simulation d'erreurs pour validation
- **CI/CD** : GitHub Actions avec tests automatiques
- **Couverture** : Tests de performance et de régression
Les deux services (backend et frontend) sont configurés en mode développement avec rechargement automatique :
- **Backend**: Uvicorn avec `--reload`
- **Frontend**: Next.js avec `npm run dev`
Les modifications de code sont automatiquement détectées et appliquées.
### Variables d'environnement
#### Backend
- `DATABASE_URL`: URL de connexion PostgreSQL
#### Frontend
- `NEXT_PUBLIC_API_URL`: URL de l'API backend
## 🐛 Dépannage
### Les conteneurs ne démarrent pas
### **Exécution des tests**
```bash
# Vérifier les logs
docker-compose logs
# Tests complets
scripts/test.bat
# Reconstruire les images
docker-compose up -d --build
# Tests de simulation d'erreur
scripts/test-connectivity.bat
```
### La base de données n'est pas prête
Le backend attend que PostgreSQL soit complètement démarré grâce au healthcheck.
## 🔒 **Sécurité**
### Erreurs de connexion à l'API
Vérifiez que :
- Le backend est démarré : `docker-compose ps`
- L'URL de l'API est correcte dans le frontend
- Le réseau Docker fonctionne : `docker network ls`
### **Configuration de production**
- Mots de passe sécurisés pour tous les services
- Configuration CORS appropriée
- Health checks pour la surveillance
- Volumes persistants pour les données
- Réseaux Docker isolés
## 📝 Personnalisation
### **Recommandations de sécurité**
- Changez les mots de passe par défaut en production
- Configurez HTTPS/SSL avec un reverse proxy
- Activez l'authentification utilisateur
- Configurez les sauvegardes de la base de données
- Limitez l'accès aux ports de monitoring
### Ajouter de nouvelles salles
## 📝 **Personnalisation**
### **Ajouter de nouvelles salles**
Via l'API :
```bash
curl -X POST http://localhost:8000/rooms \
curl -X POST http://141.253.118.141:8001/rooms \
-H "Content-Type: application/json" \
-d '{
"name": "Salle Formation",
@@ -330,30 +371,14 @@ curl -X POST http://localhost:8000/rooms \
}'
```
Ou directement dans la base de données :
```sql
INSERT INTO rooms (name, capacity, equipment, description)
VALUES ('Ma Salle', 40, 'Équipements', 'Description');
```
### Modifier les ports
Éditez le fichier `docker-compose.yml` et changez les mappings de ports :
### **Modifier les ports**
Éditez le fichier `docker-compose.prod.yml` et changez les mappings de ports :
```yaml
ports:
- "VOTRE_PORT:PORT_INTERNE"
```
### Ajouter des dépendances
**Backend (Python)**:
1. Ajoutez la dépendance dans `backend/requirements.txt`
2. Reconstruisez : `docker-compose up -d --build backend`
**Frontend (Node.js)**:
1. Ajoutez la dépendance dans `frontend/package.json`
2. Reconstruisez : `docker-compose up -d --build frontend`
## 🎯 Cas d'Usage
## 🎯 **Cas d'Usage**
Ce système est idéal pour :
- ✅ Centres de formation
@@ -362,131 +387,41 @@ Ce système est idéal pour :
- ✅ Universités et écoles
- ✅ Bibliothèques avec salles d'étude
## Tests et Qualité
## 📋 **Versions et Releases**
### Tests automatisés
- **Tests API** : Validation des endpoints avec Pytest
- **Tests de connectivité** : Simulation d'erreurs pour validation
- **CI/CD** : GitHub Actions avec tests automatiques
- **Couverture** : Tests de performance et de régression
### **Version actuelle : v1.1.0**
- **Date de release** : 16 octobre 2025
- **Type** : Release avec monitoring
- **Statut** : Stable, déployé en production
- **Compatibilité** : Windows, Linux, macOS
- **Dépendances** : Docker, Docker Compose
### Exécution des tests
```bash
# Tests complets
scripts/test.bat
### **Changelog**
Voir [CHANGELOG.md](CHANGELOG.md) pour l'historique complet des versions.
# Tests de simulation d'erreur
scripts/test-connectivity.bat
```
### **Releases GitHub**
- [v1.1.0](https://github.com/SarTron-NorthBlue/dockezr/releases/tag/v1.1.0) - Version avec monitoring
- [v1.0.0](https://github.com/SarTron-NorthBlue/dockezr/releases/tag/v1.0.0) - Version initiale
## 🚀 Déploiement en Production
## 📞 **Support et Documentation**
### Déploiement sur Serveur Linux
### **Documentation**
- **Guide d'utilisation** : [GUIDE_UTILISATION.md](GUIDE_UTILISATION.md)
- **Guide de déploiement** : [DEPLOYMENT.md](DEPLOYMENT.md)
- **Dépannage** : [DEPANNAGE.md](DEPANNAGE.md)
- **API** : Documentation interactive sur http://141.253.118.141:8001/docs
Le projet est configuré pour un déploiement manuel sur serveur Linux avec Docker Compose.
### **Monitoring**
- **Grafana** : http://141.253.118.141:3001
- **Prometheus** : http://141.253.118.141:9090
- **Dashboard** : "Dockezr - Monitoring Complet"
#### 1. **Préparation du serveur**
```bash
# Sur votre serveur Linux
sudo apt update
sudo apt install docker.io docker-compose git curl -y
sudo systemctl start docker
sudo systemctl enable docker
```
#### 2. **Cloner et configurer le projet**
```bash
# Cloner le repository
git clone https://github.com/votre-username/dockezr.git
cd dockezr
# Copier la configuration de production
cp env.prod.example .env.prod
# Modifier les variables d'environnement
nano .env.prod
```
#### 3. **Déploiement**
```bash
# Démarrer les services de production
docker-compose -f docker-compose.prod.yml up -d
# Vérifier l'état des services
docker-compose -f docker-compose.prod.yml ps
# Voir les logs
docker-compose -f docker-compose.prod.yml logs -f
```
### Configuration de Production
#### Variables d'environnement requises dans `.env.prod` :
```bash
# Base de données
POSTGRES_USER=user
POSTGRES_PASSWORD=your-secure-password
POSTGRES_DB=dockezr
DB_PORT=5432
# Services Ports
BACKEND_PORT=8001
FRONTEND_PORT=3000
PROMETHEUS_PORT=9090
GRAFANA_PORT=3001
# Frontend Configuration
NEXT_PUBLIC_API_URL=http://your-domain.com:8001
# Grafana Configuration
GRAFANA_USER=admin
GRAFANA_PASSWORD=your-secure-grafana-password
# Production Settings
NODE_ENV=production
```
#### Services de production :
- **Frontend** : http://your-domain.com:3000
- **Backend API** : http://your-domain.com:8001
- **Prometheus** : http://your-domain.com:9090
- **Grafana** : http://your-domain.com:3001
### Sécurité en Production
1. **Changez tous les mots de passe par défaut**
2. **Configurez HTTPS/SSL** avec un reverse proxy
3. **Utilisez des secrets Docker** pour les mots de passe
4. **Activez l'authentification** utilisateur
5. **Configurez les sauvegardes** de la base de données
6. **Limitez l'accès** aux ports de monitoring
## Sécurité
⚠️ **Important pour la production** :
- Changez les identifiants PostgreSQL par défaut
- Utilisez des secrets Docker pour les mots de passe
- Activez l'authentification utilisateur
- Configurez CORS correctement
- Utilisez HTTPS
## Versions et Releases
- **Version actuelle** : v1.0.0
- **Changelog** : Voir [CHANGELOG.md](CHANGELOG.md)
- **Releases** : [GitHub Releases](https://github.com/SarTron-NorthBlue/dockezr/releases)
- **Tags Git** : Gestion des versions avec Git tags
## Licence
## 📄 **Licence**
Ce projet est développé pour **Expernet** - Centre de Formation.
---
**Système de réservation Expernet - Simplifions la gestion des salles !**
**🏢 Système de réservation Expernet - Simplifions la gestion des salles !**
**🌐 Application en ligne :** http://141.253.118.141:3000