dockezr/CHANGELOG.md

# Changelog

Toutes les modifications notables de ce projet seront documentées dans ce fichier.

Le format est basé sur [Keep a Changelog](https://keepachangelog.com/fr/1.0.0/),
et ce projet adhère au [Semantic Versioning](https://semver.org/lang/fr/).

## [1.1.0] - 2025-10-16

### Ajouté
- **Monitoring et Observabilité** : Intégration complète Prometheus + Grafana
  - Métriques automatiques pour le backend FastAPI
  - Tableaux de bord Grafana pour la surveillance
  - Endpoint `/metrics` pour la collecte de métriques
  - Surveillance des performances (CPU, mémoire, requêtes)
  - Métriques personnalisées (réservations, accès aux salles)

- **Déploiement en Production** : Configuration pour serveur Linux
  - Configuration de production avec docker-compose.prod.yml
  - Variables d'environnement pour la production
  - Guide de déploiement manuel sur serveur Linux
  - Support Docker Compose pour déploiement simplifié

- **Infrastructure de Production** :
  - Images Docker optimisées pour la production
  - Configuration de santé (healthchecks) pour tous les services
  - Réseaux Docker dédiés pour la production
  - Volumes persistants pour les données
  - Configuration sécurisée des mots de passe

### Modifié
- **Backend FastAPI** : Ajout des métriques Prometheus
  - Middleware de capture automatique des requêtes HTTP
  - Compteurs pour les réservations et accès aux salles
  - Histogrammes pour les temps de réponse
  - Endpoint `/metrics` pour l'exposition des métriques

- **Docker Compose** : Ajout des services de monitoring
  - Service Prometheus (port 9090)
  - Service Grafana (port 3001)
  - Configuration des volumes et réseaux

### Technique
- **Métriques exposées** :
  - `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

- **Services de monitoring** :
  - Prometheus : Collecte et stockage des métriques
  - Grafana : Visualisation et tableaux de bord
  - Dashboard "Dockezr - Vue d'ensemble" pré-configuré

- **Déploiement simplifié** :
  - Configuration Docker Compose pour production
  - Guide de déploiement manuel détaillé
  - Support serveur Linux avec Docker
  - Variables d'environnement sécurisées

## [1.0.0] - 2025-10-15

### Ajouté
- **TP1 - Architecture** : Système de réservation de salles avec Docker
  - Backend FastAPI avec endpoints complets
  - Frontend Next.js avec interface moderne
  - Base de données PostgreSQL
  - Configuration Docker Compose multi-services
  - 5 salles pré-configurées (Atlas, Horizon, Innovation, Connect, Digital)

- **TP2 - Développement** : Fonctionnalités avancées
  - Interface de planning visuel avec grille horaire
  - Système de réservation avec validation automatique
  - Gestion des conflits de réservation
  - Interface responsive avec Tailwind CSS
  - Validation en temps réel de la disponibilité

- **TP3 - Déploiement** : Configuration de production
  - Scripts de démarrage automatisés (start.bat, stop.bat)
  - Configuration CORS pour la communication frontend/backend
  - Variables d'environnement configurées
  - Documentation utilisateur complète

- **TP4 - Tests** : Système de tests automatisés
  - Tests Pytest pour validation des endpoints API
  - Intégration GitHub Actions pour CI/CD
  - Tests de simulation d'erreur pour validation de la détection automatique
  - Configuration Docker pour l'exécution des tests
  - Scripts de test automatisés

- **TP5 - Release** : Préparation à la mise en production
  - Gestion des versions avec Git tags
  - Release GitHub avec documentation
  - Changelog complet des modifications
  - Configuration CI pour les releases

### Fonctionnalités principales
- **Planning des salles** : Vue d'ensemble avec grille horaire 8h-22h
- **Réservation** : Interface intuitive avec validation automatique
- **Gestion des réservations** : Consultation et annulation des réservations
- **API REST** : Endpoints complets pour salles et réservations
- **Base de données** : Stockage PostgreSQL avec relations
- **Interface moderne** : Design responsive avec Tailwind CSS

### Endpoints API
- `GET /health` - Vérification de l'état de l'API
- `GET /rooms` - Liste des salles disponibles
- `GET /rooms/{id}` - Détails d'une salle spécifique
- `GET /reservations` - Liste des réservations
- `GET /reservations/date/{date}` - Réservations par date
- `POST /reservations` - Création d'une nouvelle réservation
- `DELETE /reservations/{id}` - Annulation d'une réservation

### Configuration technique
- **Backend** : FastAPI avec Python 3.11
- **Frontend** : Next.js 14 avec TypeScript
- **Base de données** : PostgreSQL 16
- **Conteneurisation** : Docker et Docker Compose
- **Tests** : Pytest avec couverture de code
- **CI/CD** : GitHub Actions

### Salles disponibles
1. **Salle Atlas** (30 personnes) - Vidéoprojecteur, Tableau blanc, WiFi
2. **Salle Horizon** (15 personnes) - Écran TV, Tableau blanc, WiFi
3. **Salle Innovation** (50 personnes) - Vidéoprojecteur, Sono, WiFi, Climatisation
4. **Salle Connect** (8 personnes) - Écran TV, Visioconférence, WiFi
5. **Salle Digital** (20 personnes) - 20 postes informatiques, Vidéoprojecteur, WiFi

### Scripts d'administration
- `scripts/start.bat` - Démarrage de l'application
- `scripts/stop.bat` - Arrêt de l'application
- `scripts/test.bat` - Exécution des tests automatisés
- `scripts/test-connectivity.bat` - Tests de simulation d'erreur

### Documentation
- Guide d'utilisation complet
- Documentation API interactive (Swagger UI)
- README avec instructions d'installation
- Changelog des versions

---

## Notes de version

### Version 1.0.0
- **Date de release** : 15 octobre 2025
- **Type** : Release initiale
- **Statut** : Stable, prêt pour la production
- **Compatibilité** : Windows, Linux, macOS
- **Dépendances** : Docker, Docker Compose

### Migration
Cette version est la première release stable. Aucune migration n'est nécessaire.

### Support
- **Documentation** : Disponible dans le README.md
- **API** : Documentation interactive sur http://localhost:8000/docs
- **Tests** : Suite de tests complète avec validation automatique