Rapports synchrones (DuckDB)

Dokos introduit une architecture synchrone pour les principaux rapports comptables, utilisant DuckDB comme moteur d'analyse pour offrir des performances optimisées. Cette fonctionnalité permet d'exécuter les rapports jusqu'à 10 fois plus rapidement que la méthode traditionnelle, particulièrement utile pour les entreprises avec un grand volume de données.

Rapports concernés

Les rapports suivants bénéficient de l'exécution synchrone :

• Grand Livre
• Balance Générale
• Compte de résultat
• Balance auxiliaire (à venir)

      
graph TD
    A[Écriture comptable sauvegardée] --> B[Synchronisation automatique avec DuckDB]
    B --> C[Exécution du rapport]
    C --> D[Résultats affichés en temps réel]
    E[Activation dans Paramètres comptables] --> C

    

Activation des rapports synchrones

Prérequis

• Dokos version 4.0 ou supérieure
• Droits d'administrateur système
• Espace disque suffisant pour la base DuckDB (environ 10% de la taille de la base MariaDB)

Procédure d'activation

1. Allez dans Comptabilité > Configuration > Paramètres comptables
2. Dans la section Performances, cochez la case Activer les rapports synchrones
3. Sauvegardez les paramètres
4. Un message confirmera l'activation : « Les rapports synchrones sont maintenant activés »

Note : La première synchronisation peut prendre quelques minutes selon le volume de données. Les synchronisations suivantes s'effectuent automatiquement à chaque sauvegarde d'écriture comptable.

Configuration avancée

Paramètres disponibles

Pour modifier ces paramètres :

1. Allez dans Développeur > Fichier de configuration
2. Créez ou modifiez le fichier site_config.json
3. Ajoutez la section suivante :

"dokos": {
    "sync_reports": {
        "sync_frequency": 2,
        "max_sync_records": 2000,
        "duckdb_memory_limit": 2048
    }
}

4. Sauvegardez et redémarrez le site (bench restart)

Bonnes pratiques

Pour les grandes entreprises

• Planifiez les synchronisations pendant les périodes de faible activité (nuit, week-end)
• Surveillez l'espace disque : DuckDB peut occuper jusqu'à 30% de l'espace de la base principale
• Testez en environnement de staging avant de déployer en production

Pour les petites entreprises

• Activez la synchronisation automatique pour bénéficier des performances optimisées
• Vérifiez la cohérence des rapports synchrones avec les rapports traditionnels lors de la première utilisation
• Formez les utilisateurs aux nouveaux temps de réponse améliorés

Résolution des problèmes

Erreurs courantes

Synchronisation manuelle

Pour forcer une synchronisation immédiate :

1. Allez dans Comptabilité > Outils > Synchroniser les données DuckDB
2. Cliquez sur Lancer la synchronisation
3. Un message confirmera la fin de la synchronisation

Voir aussi

• Grand Livre
• Balance Générale
• Compte de résultat