Checklist de Vérification Cette checklist vous permet de vérifier que votre installation CSWeb Community Platform est complète et fonctionnelle.

1. Services Docker

Vérifier que tous les containers tournent

docker compose ps

Résultat attendu :

Tous les services doivent être "Up" csweb-app, csweb-mysql-metadata, csweb-postgres-breakout doivent être "healthy"

2. Accès Web

CSWeb Application

curl http://localhost:8080

Doit retourner du HTML (page d'accueil CSWeb)

Ou dans votre navigateur :

http://localhost:8080

La page d'accueil CSWeb doit s'afficher

phpMyAdmin (Développement)

http://localhost:8081

Interface de connexion phpMyAdmin visible Se connecter avec :

• Server : mysql
• Username : csweb_user
• Password : [MYSQL_PASSWORD depuis .env]

pgAdmin (Développement)

http://localhost:8082

Interface de connexion pgAdmin visible Se connecter avec :

• Email : admin@csweb.local (défini dans docker compose)
• Password : [PGADMIN_PASSWORD depuis .env]

3. Connexion Admin CSWeb

Login Admin

1. Aller sur http://localhost:8080 (opens in a new tab)
2. Cliquer sur "Login" ou "Admin"
3. Se connecter avec :

• Username : admin
• Password : [CSWEB_ADMIN_PASSWORD défini lors du setup]

Connexion réussie Dashboard admin accessible

4. Drivers de Base de Données

Vérifier les drivers disponibles

docker compose exec csweb php bin/console csweb:check-database-drivers

Résultat attendu :

Database Drivers Check
======================

 PDO Driver: Available PostgreSQL (pdo_pgsql): Available MySQL (pdo_mysql): Available SQL Server (pdo_sqlsrv): Available All required database drivers are installed!

Tous les drivers doivent être "Available"

5. Connexions Bases de Données

Tester PostgreSQL

# Depuis votre machine hôte
docker compose exec postgres psql -U csweb_analytics -d csweb_analytics -c "SELECT version();"

Doit afficher la version PostgreSQL (ex: PostgreSQL 16.1)

Ou depuis pgAdmin :

1. Ouvrir http://localhost:8082 (opens in a new tab)
2. Ajouter serveur :

• Name : CSWeb PostgreSQL
• Host : postgres
• Port : 5432
• Database : csweb_analytics
• Username : csweb_analytics
• Password : [POSTGRES_PASSWORD]

Connexion réussie

Tester MySQL

# Depuis votre machine hôte
docker compose exec mysql mysql -u csweb_user -p -e "SELECT VERSION();"

Doit afficher la version MySQL (ex: 8.0.35)

Ou depuis phpMyAdmin :

1. Ouvrir http://localhost:8081 (opens in a new tab)
2. Se connecter (voir section 2)
3. Vérifier que la base csweb_metadata existe Base csweb_metadata présente

6. Premier Breakout

Vérifier qu'un dictionnaire a été uploadé

Via l'interface web :

1. Aller sur http://localhost:8080 (opens in a new tab)
2. Menu : Data Dictionaries

Au moins 1 dictionnaire visible dans la liste

Lancer le breakout

docker compose exec csweb php bin/console csweb:process-cases-by-dict [NOM_DICTIONNAIRE]

Breakout se termine sans erreur Message "Breakout terminé avec succès !"

Vérifier les tables créées

PostgreSQL :

docker compose exec postgres psql -U csweb_analytics -d csweb_analytics -c "\dt [SCHEMA].*"

Tables créées dans le schéma spécifié

MySQL :

docker compose exec mysql mysql -u csweb_user -p -e "USE [DATABASE]; SHOW TABLES;"

Tables créées dans la base spécifiée

7. Volumes Persistants

Vérifier que les volumes existent

docker volume ls | grep csweb

Résultat attendu :

local csweb-community_csweb_files
local csweb-community_csweb_logs
local csweb-community_mysql_data
local csweb-community_postgres_data
local csweb-community_pgadmin_data

5 volumes présents

Vérifier le contenu des volumes

# Inspecter le volume PostgreSQL
docker volume inspect csweb-community_postgres_data
 
# Vérifier l'emplacement
# Mountpoint: /var/lib/docker/volumes/csweb-community_postgres_data/_data

Chaque volume a un "Mountpoint" valide

8. Logs et Monitoring

Vérifier les logs CSWeb

# Logs en temps réel
docker compose logs -f csweb
 
# Dernières 50 lignes
docker compose logs --tail=50 csweb

Pas d'erreurs critiques (ERROR, CRITICAL) Logs affichent les requêtes HTTP

Vérifier les logs PostgreSQL

docker compose logs --tail=50 postgres

Pas d'erreurs de connexion Messages de démarrage normaux

Vérifier les logs MySQL

docker compose logs --tail=50 mysql

Pas d'erreurs de connexion Messages de démarrage normaux

9. Ressources Système

Vérifier l'utilisation des ressources

docker stats --no-stream

Résultat attendu :

CPU < 20% (idle) MEM < 2GB total

10. Sécurité

Vérifier les mots de passe

# Vérifier que les secrets ne sont PAS les valeurs par défaut
docker compose exec csweb env | grep -E "PASSWORD|SECRET"

NE DOIT PAS contenir :

• changeme
• password
• secret
• 123456

DOIT contenir : Des valeurs aléatoires de 32+ caractères

Vérifier que setup.php est désactivé

# En production, setup.php doit être supprimé ou renommé
docker compose exec csweb ls public/setup/

Doit retourner "No such file or directory" (ou renommé en setup_disabled/)

11. Performance

Test de charge basique

# Installer Apache Bench (si pas déjà installé)
# Ubuntu/Debian
sudo apt-get install apache2-utils
 
# macOS (inclus par défaut)
# Windows : télécharger ab.exe
 
# Test : 100 requêtes, 10 concurrentes
ab -n 100 -c 10 http://localhost:8080/

Résultat attendu :

Requests per second: > 50 [#/sec]
Time per request: < 200 [ms]
Failed requests: 0

Pas de requêtes échouées Temps de réponse < 500ms

12. Backup et Restore

Tester un backup PostgreSQL

# Créer un backup
docker compose exec postgres pg_dump -U csweb_analytics csweb_analytics > backup_test.sql
 
# Vérifier que le fichier n'est pas vide
ls -lh backup_test.sql

Fichier backup_test.sql créé Taille > 0 bytes

Tester un backup MySQL

# Créer un backup
docker compose exec mysql mysqldump -u csweb_user -p csweb_metadata > backup_mysql_test.sql
 
# Vérifier
ls -lh backup_mysql_test.sql

Fichier backup_mysql_test.sql créé Taille > 0 bytes

Guide complet Backup & Restore

Récapitulatif

Troubleshooting Si certains tests échouent, consultez :

• Common Issues - 50+ problèmes courants
• FAQ - Questions fréquentes
• Error Codes - Référence des codes d'erreur Ou rejoignez notre Discord (opens in a new tab) pour obtenir de l'aide.

Prochaines Étapes Votre installation est vérifiée, voici ce que vous pouvez faire :

1. Prochaines Étapes - Aller plus loin avec CSWeb
2. Guides Breakout - Automatiser les breakouts
3. Admin Panel - Configurer des jobs cron
4. Déploiement Production - Best practices production