Premier Breakout - Tutorial Step-by-Step Ce tutorial vous guide pas à pas pour réaliser votre premier breakout avec CSWeb Community Platform.

 Base CSWeb (MySQL) 

 cases.csdb (binaire) 
 - Case 1 
 - Case 2 
 - Case 3 
 ... 

 Base Analytics (PostgreSQL) 

 eval_producteurs (table) 
 - id, nom, region, ... 
 eval_observations (table) 
 - id, producteur_id, ... 
 eval_photos (table) 
 - id, observation_id, ... 

http://localhost:8080

# Upload via API (avancé)
curl -X POST http://localhost:8080/api/dictionaries/upload \
 -H "Authorization: Bearer YOUR_TOKEN" \
 -F "file=@EVAL_PRODUCTEURS_USAID.dcf"

# Se connecter à PostgreSQL
docker compose exec postgres psql -U csweb_analytics -d csweb_analytics
 
# Créer un schéma pour le dictionnaire
CREATE SCHEMA IF NOT EXISTS eval_producteurs;
 
# Vérifier
\dn

# Se connecter à MySQL
docker compose exec mysql mysql -u csweb_user -p
 
# Créer une base pour le dictionnaire
CREATE DATABASE IF NOT EXISTS eval_producteurs;
 
# Vérifier
SHOW DATABASES;

# Base par défaut pour le breakout
POSTGRES_HOST=postgres
POSTGRES_PORT=5432
POSTGRES_DATABASE=csweb_analytics
POSTGRES_USER=csweb_analytics
POSTGRES_PASSWORD=VOTRE_MOT_DE_PASSE

curl -X POST http://localhost:8080/api/dictionaries/3/breakout-config \
 -H "Authorization: Bearer YOUR_TOKEN" \
 -H "Content-Type: application/json" \
 -d '{
 "dbType": "postgresql",
 "host": "postgres",
 "port": 5432,
 "database": "csweb_analytics",
 "schema": "eval_producteurs",
 "user": "csweb_analytics",
 "password": "VOTRE_MOT_DE_PASSE"
 }'

# Se connecter au container CSWeb
docker compose exec csweb bash
 
# Lancer le breakout sélectif
php bin/console csweb:process-cases-by-dict EVAL_PRODUCTEURS_USAID
 
# Ou avec l'ID du dictionnaire
php bin/console csweb:process-cases-by-dict --dict-id=3

Breakout Sélectif CSWeb
=======================

Dictionnaire: EVAL_PRODUCTEURS_USAID (ID: 3)
Base cible: PostgreSQL (postgres:5432)
Schéma: eval_producteurs

[1/5] Création des tables... 
[2/5] Extraction des cases... (125 cases)
[3/5] Transformation des données... 
[4/5] Insertion dans PostgreSQL... (125 lignes)
[5/5] Création des index... 

Breakout terminé avec succès !
Durée: 12.5 secondes

# Déclencher le breakout via API
curl -X POST http://localhost:8080/api/breakout/EVAL_PRODUCTEURS_USAID/trigger \
 -H "Authorization: Bearer YOUR_TOKEN"
 
# Vérifier le statut
curl http://localhost:8080/api/breakout/EVAL_PRODUCTEURS_USAID/status \
 -H "Authorization: Bearer YOUR_TOKEN"

http://localhost:8082

-- Lister les tables du schéma
SELECT table_name
FROM information_schema.tables
WHERE table_schema = 'eval_producteurs';
 
-- Compter les lignes
SELECT COUNT(*) FROM eval_producteurs.producteurs;
 
-- Voir un échantillon de données
SELECT * FROM eval_producteurs.producteurs LIMIT 10;

-- Lister les tables
SHOW TABLES FROM eval_producteurs;
 
-- Compter les lignes
SELECT COUNT(*) FROM eval_producteurs.producteurs;
 
-- Voir un échantillon
SELECT * FROM eval_producteurs.producteurs LIMIT 10;

SELECT region,
 COUNT(*) as total_producteurs
FROM eval_producteurs.producteurs
GROUP BY region
ORDER BY total_producteurs DESC;

SELECT p.nom_producteur,
 p.region,
 o.type_culture,
 o.rendement
FROM eval_producteurs.producteurs p
JOIN eval_producteurs.observations o ON p.producteur_id = o.producteur_id
WHERE p.region = 'Dakar';

SELECT p.nom_producteur,
 COUNT(ph.photo_id) as nombre_photos
FROM eval_producteurs.producteurs p
LEFT JOIN eval_producteurs.photos ph ON p.producteur_id = ph.producteur_id
GROUP BY p.nom_producteur
HAVING COUNT(ph.photo_id) > 0;

# Déployer Metabase avec Docker
docker run -d -p 3001:3000 --name metabase metabase/metabase
 
# Accéder à Metabase
http://localhost:3001
 
# Connecter à PostgreSQL CSWeb
Database type: PostgreSQL
Host: host.docker.internal (macOS/Windows) ou [IP_MACHINE] (Linux)
Port: 5432
Database name: csweb_analytics
Username: csweb_analytics
Password: [POSTGRES_PASSWORD]

# Lister tous les dictionnaires disponibles
docker compose exec csweb php bin/console csweb:list-dictionaries
 
# Utiliser le nom exact
php bin/console csweb:process-cases-by-dict [NOM_EXACT]

# Vérifier que PostgreSQL tourne
docker compose ps postgres
 
# Tester la connexion
docker compose exec postgres psql -U csweb_analytics -d csweb_analytics
 
# Vérifier les variables .env
docker compose exec csweb env | grep POSTGRES

# Vérifier les drivers disponibles
docker compose exec csweb php bin/console csweb:check-database-drivers
 
# Si pdo_pgsql est manquant, rebuild le container
docker compose up -d --build csweb

# Créer des index pour accélérer les requêtes
CREATE INDEX idx_producteur_region ON eval_producteurs.producteurs(region);
CREATE INDEX idx_observation_producteur ON eval_producteurs.observations(producteur_id);