Métadonnées ISI — Documentation Fonctionnelle

Ensemble d'outils permettant à l'équipe ISI de maintenir la cohérence du référentiel interne de l'application lors de l'ajout de nouvelles tables ou de nouveaux champs en base de données.

Vue d'ensemble

ISI-APP s'appuie sur un système de métadonnées qui décrit la structure de l'application : chaque table, chaque champ, chaque formulaire et chaque grille d'affichage sont référencés dans des tables internes (appelées _part, _field, _form, etc.). Ce référentiel est utilisé en interne pour générer dynamiquement certaines interfaces, gérer les libellés, et piloter les fonctionnalités de personnalisation.

Lors du développement, chaque fois qu'une nouvelle table ou qu'un nouveau champ est ajouté à la base de données, il est nécessaire de mettre à jour ce référentiel de métadonnées pour que l'application continue à fonctionner correctement.

Des commandes dédiées automatisent cette synchronisation, réduisant le risque d'oubli et les erreurs manuelles.

Accès

• Ces outils sont réservés à l'équipe technique ISI (développeurs).
• Exécution en ligne de commande (php artisan) ou automatiquement lors des déploiements en production et pré-production.
• Aucune interface graphique dans l'application — usage développeur uniquement.

Fonctionnalités principales

• Générer les migrations : créer automatiquement les fichiers de migration Laravel pour des tables existantes, utile lors de la mise en conformité d'une base héritée.
• Synchroniser les métadonnées d'une nouvelle table : lors de la création d'une table, enregistrer automatiquement dans le référentiel interne toutes les informations nécessaires (définition de la table, de ses champs, d'un formulaire par défaut et d'une grille d'affichage).
• Synchroniser les nouveaux champs : lorsqu'une colonne est ajoutée à une table existante, mettre à jour le référentiel pour inclure ce nouveau champ dans les formulaires et grilles déjà configurés.
• Marquer des migrations comme exécutées : indiquer à Laravel que certaines migrations ont déjà été appliquées (utile lors de la mise en place initiale sur une base de données existante, sans réexécuter les migrations).

Ces opérations sont également intégrées dans le pipeline de déploiement automatique, garantissant que le référentiel reste toujours synchronisé avec la structure réelle de la base de données en production et en pré-production.

Points d'attention

• Les commandes sont conçues pour être idempotentes : les exécuter plusieurs fois ne provoque pas d'erreur ni de doublon.
• Il est possible de prévisualiser les changements qu'une commande va effectuer avant de les appliquer (mode "dry run").
• Les conventions de nommage des colonnes ISI (préfixes lb, dt, bl, tp, etc.) sont détectées automatiquement pour typer correctement les champs dans le référentiel.

Voir aussi

• Documentation technique : .claude/technical-docs/platform/isi-metadata-modernization.md