Rôle : Données métier principales — lu à chaque requête authentifiée. Contient les entreprises, utilisateurs (5 rôles), certifications, résultats de quiz, tokens d'accès stagiaires et historique des tokens.
⚠️ Colonnes piège : companies.token_balance (PAS tokens_remaining) · companies.contact_email/phone (PAS email/phone) · certifications.trainee_id (PAS user_id) · certifications.is_valid (PAS status)

Rôle : Référentiel pédagogique — rarement modifié, très souvent lu. Contient les 4 784 questions, 20 normes (NFC18-510, CNAM R482…), grilles pratiques et modules e-learning. Préfixer toutes les requêtes : content.habilitation_types, content.quizzes, etc.

💡 Usage : Ce schéma est lu à chaque génération de quiz (token stagiaire) et à chaque soumission. Ne jamais modifier directement en production sans recalculer les statistiques habilitation_types.

Rôle : Sessions de formation présentiel — créées par les formateurs 2D+, lues par les clients et l'admin. Contient aussi les données ARGALIS (import déclaratif OPCO). Toujours préfixer : sess.sessions, sess.argalis_sessions, etc.

💡 Doublons ARGALIS : Si plusieurs imports successifs, utiliser DISTINCT ON (formaleo_session_id) dans les JOIN pour éviter la multiplication des lignes. La clé de dédup est argalis_ref (unique par session OPCO).

Rôle : Infrastructure et sécurité — tables techniques invisibles des utilisateurs finaux. Journaux d'audit, métriques monitoring, smoke tests, codes 2FA, configuration applicative et intégration LTI. Toujours préfixer : sys.audit_logs, sys.monitoring_snapshots, etc.

💡 Usage diagnostique : SELECT COUNT(*) FROM sys.audit_logs WHERE created_at > NOW() - INTERVAL '1 hour' pour voir l'activité récente. SELECT metrics_json FROM sys.monitoring_snapshots ORDER BY captured_at DESC LIMIT 1 pour l'état actuel du pool PG.