Vérification & Maintenance

Assistant de maintenance des bases de données OMAG. Exécute en un seul lancement les opérations de vérification d'intégrité, de mise à niveau de schéma (migrations), de recalculs et de nettoyage sur une ou plusieurs sociétés. Affiche un journal en temps réel avec codes couleur.

Menu : Dossier > Vérification & Maintenance

Quand exécuter la maintenance ?

• Après une mise à jour OMAG (les migrations s'appliquent automatiquement)
• Après une restauration d'une sauvegarde ancienne
• En cas de comportement anormal (totaux incorrects, doublons suspects)
• Périodiquement (1× par trimestre) en préventif

Assistant en 3 étapes

Étape 1 — Bienvenue

Page d'introduction présentant le rôle de la maintenance et invitant à faire une sauvegarde préalable.

Bouton Suivant.

Étape 2 — Sélection des bases

Grille listant toutes les sociétés du dossier. Pour chaque société :

• Case à cocher en début de ligne (sélection multi)
• Nom de la société
• Filtre texte au-dessus pour rechercher
• Compteur « X / Y sélectionnés »

Option spéciale commun6

Une case à cocher distincte permet de traiter uniquement la base commun6 (base globale du dossier qui contient utilisateurs, droits, sociétés, web_page…). Si cochée, elle remplace la sélection des sociétés.

Que choisir ?

• Maintenance d'urgence sur 1 société → cocher uniquement la société concernée
• Après une mise à jour OMAG → cocher toutes les sociétés + commun6
• Problème de connexion / droits → cocher uniquement commun6

Bouton Suivant pour lancer.

Étape 3 — Maintenance et journal

• Spinner de progression global
• Journal en temps réel déroulant (max 300 px de hauteur, scroll auto)
• Codes couleur :
  • 🟢 Vert : succès, opération terminée
  • 🔵 Bleu : information, opération en cours
  • 🔴 Rouge : erreur, opération à investiguer

Pour chaque base, le journal affiche :

• Démarrage de la maintenance
• Liste des migrations exécutées (script SQL appliqué)
• Recalculs effectués (totaux, soldes, stocks)
• Statut final (OK ou ERREUR)

Fin de l'opération

À la fin, deux possibilités selon le contexte :

Bouton	Action
Recommencer	Revient à l'étape 2 pour une nouvelle sélection
Fermer	Ferme l'assistant

Reconnexion automatique

Si la maintenance a modifié la base sur laquelle l'utilisateur est connecté, un compte à rebours s'affiche avant de forcer la reconnexion (les modifications de schéma nécessitent un rechargement de la session).

Que fait la maintenance ?

Vérifications

• Cohérence des totaux factures (HT + TVA = TTC, ligne × quantité = total)
• Cohérence des soldes comptables par compte
• Recherche de doublons (clients avec même ICE, articles avec même code…)
• Vérification des index SQL (fragmentation)
• Détection de données orphelines (lignes sans entête, écritures sans pièce…)

Mises à niveau (migrations)

• Application des scripts de migration SQL (database/migrations/)
• Création des nouvelles colonnes / tables introduites par les versions récentes
• Mise à jour des valeurs par défaut
• Recréation des procédures stockées (SP) à chaque maintenance

Recalculs

• PMP (Prix Moyen Pondéré) sur les articles
• Soldes clients / fournisseurs
• Stocks par dépôt
• Cumuls d'exercice

Nettoyage

• Suppression des verrous orphelins (équivalent à Documents bloqués)
• Nettoyage des fichiers temporaires
• Compactage des logs SQL anciens

Cas d'usage

Après une mise à jour OMAG

1. Connexion à OMAG après la mise à jour
2. Si un message « Une maintenance est requise » apparaît → cliquer sur le lien
3. Sinon → Dossier > Vérification & Maintenance
4. Cocher toutes les sociétés + commun6
5. Suivant → la maintenance applique les migrations sur chaque base
6. Vérifier le journal : tout en vert
7. Reconnexion → l'application utilise la nouvelle version

Diagnostic d'un problème de totaux

Symptôme : un client affiche un solde incohérent avec ses factures.

1. Sauvegarde préalable (par sécurité)
2. Vérification & Maintenance → cocher la société concernée
3. Lancer → consulter le journal
4. Si des erreurs apparaissent → noter les références et contacter le support
5. Si recalcul des soldes : le solde client devrait redevenir cohérent

Maintenance préventive trimestrielle

1. Programmer un créneau hors heures de saisie
2. Sauvegarde > Base seule sur chaque société
3. Vérification & Maintenance → toutes les sociétés
4. Laisser tourner (peut prendre de quelques minutes à 1h selon volumétrie)
5. Vérifier que tout est en vert dans le journal
6. Reconnecter les utilisateurs

Lecture du journal

Quelques messages courants :

Message	Signification
Application de la migration N°123...	Une migration de schéma est en cours
Recreation des procedures stockees...	Les SP sont rechargées (à chaque maintenance)
Recalcul du PMP : N articles traites	Recalcul des prix moyens pondérés
Verrous orphelins supprimes : N	Nettoyage des verrous abandonnés
ERREUR : ...	À reporter au support OMAG avec une capture du journal

Voir aussi

• Sauvegarde — à exécuter avant la maintenance
• Documents bloqués — déblocage manuel ciblé (alternative au nettoyage global)
• Restauration — souvent suivie d'une maintenance pour migrer le schéma