Administration des Référentiels

La page Administration (/pages/admin_referentiels.php) permet de gérer (créer, modifier, supprimer) toutes les données de référence utilisées par le système PIM.

---

Accès

Depuis la navigation principale, cliquez sur ** Administration**.

---

Référentiels disponibles

L'interface est organisée en 6 onglets :

Onglet	Table SQL	Description
Catégories	CATEGORIES	Catégories et sous-catégories produits
Plateformes	PLATEFORMES	Plateformes de distribution
Qualités	QUALITE	Niveaux de qualité (OE, IAM…)
Acteurs	ACTEURS	Marques, constructeurs, distributeurs
Contrats	CONTRATS	Contrats clients
Fournisseurs	FOURNISSEURS	Fournisseurs avec trigramme

---

Structure de chaque onglet

Chaque onglet suit la même disposition :

• Formulaire gauche : création d'un nouvel enregistrement
• Tableau droit : liste des enregistrements existants avec recherche et actions

---

Référentiel Catégories

Champs :

Champ	Obligatoire	Description
Catégorie		Nom de la catégorie (max 100 car.)
Sous-catégorie	Non	Subdivision de la catégorie (max 100 car.)
Description	Non	Texte libre (max 500 car.)
Code Tarif	Non	Code interne tarification (max 20 car.)
Statut		Actif / Inactif

---

Référentiel Plateformes

Champs :

Champ	Obligatoire	Description
Plateforme		Nom de la plateforme (max 100 car.)
Description	Non	Texte libre (max 500 car.)
Statut		Actif / Inactif

---

Référentiel Qualités

Champs :

Champ	Obligatoire	Description
Qualité		Code qualité (max 10 car.) ex: OE, IAM
Description	Non	Texte libre (max 500 car.)
Ordre d'affichage		Entier (1-999), 999 par défaut

note

L'ordre d'affichage contrôle le tri dans les dropdowns de filtres sur la page principale.

---

Référentiel Acteurs

Champs :

Champ	Obligatoire	Description
Nom Acteur		Nom complet (max 100 car.)
Type Acteur		Voir liste ci-dessous
Qualité	Non	Lien vers référentiel QUALITE
Site Web	Non	URL (max 255 car.)
Contact	Non	Nom/email de contact (max 100 car.)
Statut		Actif / Inactif

Types d'acteur disponibles :

• CONSTRUCTEUR
• EQUIPEMENTIER 1er RANG
• INDUSTRIEL
• LRC
• DISTRIBUTEUR INDEPENDANT
• DISTRIBUTEUR GROUPE
• TBD

---

Référentiel Contrats

Champs :

Champ	Obligatoire	Description
Nom Contrat		Intitulé du contrat (max 100 car.)
Client	Non	Nom du client (max 100 car.)
Type Contrat	Non	Ex: Cadre, Ponctuel
Numéro Contrat	Non	Référence interne (max 50 car.)
Date Début	Non	Format YYYY-MM-DD
Date Fin	Non	Format YYYY-MM-DD
Contact Client	Non	Nom du contact (max 100 car.)
Email Client	Non	Adresse email (max 100 car.)
Statut		Actif / Inactif
Consigne		Oui / Non
Détails Consigne	Non	Texte libre (max 500 car.)

---

Référentiel Fournisseurs

Champs :

Champ	Obligatoire	Description
Trigramme		Code 3 lettres uppercase (max 10 car.)
Raison Sociale	Non	Nom légal de la société (max 150 car.)
Acteur associé	Non	Lien vers ACTEURS (actifs uniquement)
Statut		Actif / Inactif

tip

Le trigramme est le code court utilisé dans les filtres de la page de consultation. Il est affiché en bleu dans le tableau principal.

---

Actions CRUD

Action	Comportement
Créer	Soumission du formulaire gauche → INSERT SQL
**Modifier **	Ouvre une modale pré-remplie avec les données de la ligne
**Supprimer **	Demande confirmation → DELETE SQL

Modale de modification

La modale est générée dynamiquement par JavaScript (editItem(type, data)). Elle reconstruit les champs du formulaire à partir de l'objet JSON passé en paramètre, puis soumet vers action = edit_[type].

---

Recherche dans les tableaux

Chaque tableau possède un champ "Rechercher..." qui filtre les lignes en temps réel côté client (JavaScript, fonction filterTable()).

---

Notifications

Après chaque action réussie, une notification verte s'affiche en haut de page. Les erreurs affichent une notification rouge avec le message de l'exception PHP.

Les succès déclenchent une redirection vers la même page avec le paramètre ?msg=... pour éviter la re-soumission du formulaire (pattern PRG — Post/Redirect/Get).