Refactor: Standardisation complète de l'architecture REST

🔧 RESTRUCTURATION
- UserResource déplacé de adapter.http vers application.rest
- FournisseurResource déplacé vers application.rest
- Suppression des contrôleurs obsolètes (presentation.controller)
- Suppression de MaterielFournisseurService en doublon

📝 STANDARDISATION DOCUMENTATION
- Annotations OpenAPI uniformes (@Operation, @APIResponse, @Parameter)
- Descriptions concises et cohérentes pour tous les endpoints
- Codes de réponse HTTP standards (200, 201, 400, 404, 500)

🛠️ ENDPOINTS USERS STANDARDISÉS
- GET /api/v1/users - Liste tous les utilisateurs
- GET /api/v1/users/{id} - Détails d'un utilisateur
- GET /api/v1/users/stats - Statistiques globales
- GET /api/v1/users/count - Comptage
- GET /api/v1/users/pending - Utilisateurs en attente
- POST /api/v1/users - Création
- PUT /api/v1/users/{id} - Mise à jour
- DELETE /api/v1/users/{id} - Suppression
- POST /api/v1/users/{id}/approve - Approbation
- POST /api/v1/users/{id}/reject - Rejet
- PUT /api/v1/users/{id}/status - Changement de statut
- PUT /api/v1/users/{id}/role - Changement de rôle

⚠️ GESTION D'ERREURS
- Format uniforme: Map.of("error", "message")
- Codes HTTP cohérents avec les autres ressources
- Validation des entrées standardisée

✅ VALIDATION
- Compilation réussie: mvn clean compile -DskipTests
- Pattern conforme aux autres ressources (PhaseTemplate, Fournisseur)
- Documentation OpenAPI/Swagger complète et cohérente

env.example

@@ -0,0 +1,22 @@
+# Configuration d'environnement pour BTPXpress Backend
+# Copiez ce fichier vers .env et remplissez les valeurs
+
+# Base de données PostgreSQL
+DB_URL=jdbc:postgresql://localhost:5434/btpxpress
+DB_USERNAME=btpxpress
+DB_PASSWORD=your-secure-password-here
+DB_GENERATION=update
+
+# Configuration serveur
+SERVER_PORT=8080
+CORS_ORIGINS=http://localhost:3000,http://localhost:5173
+
+# Keycloak (Production)
+KEYCLOAK_AUTH_SERVER_URL=https://security.lions.dev/realms/btpxpress
+KEYCLOAK_CLIENT_ID=btpxpress-backend
+KEYCLOAK_CLIENT_SECRET=your-keycloak-client-secret-here
+
+# Logging
+LOG_LEVEL=INFO
+LOG_SQL=false
+LOG_BIND_PARAMS=false