🎯 SOLUTION V2 : Regroupement Intelligent des PRM par C68 + Rattachements ENEDIS

📌 Résumé Exécutif

Problème Identifié

Des PRM qui devraient être regroupés ensemble se retrouvent dans des sites différents, créant une organisation incorrecte de la hiérarchie Société → Sites → PRM. Exemple concret LINEX :

Site #134 "LINEX USINE" → PRM 30000230176430

Site #135 "LINEX PROD" → PRM 50088783673630

Même adresse (76190 ALLOUVILLE BELLEFOSSE) mais 2 sites séparés ❌

Pourtant : rattachement RI officiel ENEDIS entre ces 2 PRM ! ✅

Solution Déployée

Système de regroupement intelligent V2 utilisant 3 niveaux de critères hiérarchisés pour recréer une structure optimale basée sur les données officielles ENEDIS C68 et les rattachements RI. ---

🔑 Critères de Regroupement (Par Ordre de Priorité)

1️⃣ Rattachements ENEDIS RI ⭐ PRIORITÉ MAXIMALE

Source : Table c68_rattachements Critère : type_rattachement = 'RI' (Raccordement Interne) Badge : ✅ Vert (validé automatiquement) Principe :

ENEDIS déclare officiellement des liens entre PRM (ex: PRM principal ↔ PRM secondaire)

Ces PRM doivent absolument être dans le même site

Identifiant de groupe : PRM de tête (celui qui est dans prm_id_rattache)

Exemple LINEX :

Table c68_rattachements:
┌─────────────────┬──────────────────┬──────────────────┬──────────────────────┐
│ idPrm           │ prm_id_rattache  │ type_rattachement│ type_point_rattache  │
├─────────────────┼──────────────────┼──────────────────┼──────────────────────┤
│ 30000230176430  │ 50088783673630   │ RI               │ INT                  │
└─────────────────┴──────────────────┴──────────────────┴──────────────────────┘

Résultat V2:
→ Clé de regroupement: RATT_523_50088783673630
→ Les 2 PRM dans LE MÊME site V2
→ validation_status = 'validé_auto'

Avantages :

✅ Donnée officielle ENEDIS

✅ Lien technique certifié

✅ Fiabilité maximale (pas besoin de vérification manuelle)

Logique technique :

Récupérer tous les PRM rattachés → identifier le prm_id_rattache (PRM de tête)

Ajouter aussi les PRM de tête avec eux-mêmes comme groupe

Clé unique : RATT_{ID_SOCIETE}_{PRM_TETE}

Résultat : PRM principal + tous ses rattachés = 1 seul site V2

---

2️⃣ Adresse Complète C68 ⚠️ PRIORITÉ MOYENNE

Source : Table c68 Critère : numeroNomVoie + codePostal + commune (tous non vides) Badge : ⚠️ Orange (à vérifier) Principe :

Si pas de rattachement RI, on regroupe par adresse exacte

Distingue les bâtiments différents sur une même commune

Exemple :

PRM A : "ZA Caux Multipoles Bâtiment A" - 76190 ALLOUVILLE BELLEFOSSE
PRM B : "ZA Caux Multipoles Bâtiment B" - 76190 ALLOUVILLE BELLEFOSSE
→ Clé ADR_523_ZA Caux Multipoles Bâtiment A_76190_ALLOUVILLE BELLEFOSSE
→ 2 sites V2 distincts (adresses différentes)

Avantages :

✅ Précision : Distingue les bâtiments/adresses

✅ Données C68 ENEDIS structurées

Limites :

⚠️ Qualité variable selon la saisie C68

⚠️ Nécessite vérification manuelle

---

3️⃣ C68 Basique (CP + Commune) ⚠️ FALLBACK - PRIORITÉ FAIBLE

Source : Table c68 ou tbl_gpt_societe_site Critère : codePostal + commune uniquement Badge : ⚠️ ROUGE - ATTENTION : Regroupement imprécis, vérification OBLIGATOIRE Exemple :

PRM A : "Rue du Moulin" - 76190 ALLOUVILLE BELLEFOSSE
PRM B : "Avenue de la Gare" - 76190 ALLOUVILLE BELLEFOSSE
→ ⚠️ RISQUE : Regroupés dans 1 site V2 alors que ce sont 2 adresses différentes !
→ Clé C68_76190_ALLOUVILLE BELLEFOSSE

Avantages :

✅ Toujours disponible

Limites CRITIQUES :

❌ IMPRÉCIS : Regroupe TOUTES les adresses d'une même commune

❌ Risque élevé de regroupements incorrects

⚠️ NÉCESSITE VÉRIFICATION MANUELLE OBLIGATOIRE

---

🏗️ Architecture Technique V2

Nouvelles Tables V2

tbl_gpt_societe_site_v2
├── ID_SITE_V2 (PK AUTO_INCREMENT)
├── ID_SOCIETE (FK → tbl_gpt_societes)
├── nom_site_v2 VARCHAR(255) -- Format: "NOM_SOCIETE - CP VILLE"
├── cle_regroupement VARCHAR(255) -- RATT_/ADR_/C68_ + identifiant unique
├── CP VARCHAR(10)
├── ville VARCHAR(100)
├── adresse VARCHAR(255)
├── id_site_source INT -- ID du site V1 d'origine
├── nom_site_source VARCHAR(255) -- Nom du site V1 d'origine
├── nb_prm_groupes INT -- Nombre de PRM regroupés
├── puissance_totale DECIMAL(10,2) -- Somme des puissances souscrites
├── verification_status ENUM('pending', 'auto_validated', 'manually_validated', 'conflict')
├── date_creation TIMESTAMP
└── INDEX(ID_SOCIETE), INDEX(cle_regroupement)

tbl_gpt_societe_site_prm_v2
├── ID_PRM_V2 (PK AUTO_INCREMENT)
├── ID_SITE_V2 (FK → tbl_gpt_societe_site_v2)
├── idPrm VARCHAR(14) -- Identifiant PRM ENEDIS
├── cle_regroupement VARCHAR(255) -- Même clé que le site parent
├── nom_site_source VARCHAR(255) -- Nom du site V1 d'origine
├── id_site_source INT -- ID du site V1 d'origine
├── puissance_souscrite DECIMAL(10,2)
├── rattachement_info TEXT -- Infos rattachements ENEDIS (JSON ou texte)
├── validate_regroupement TINYINT(1) DEFAULT 0 -- 0=non validé, 1=validé
├── date_ajout TIMESTAMP
└── UNIQUE KEY(idPrm), INDEX(ID_SITE_V2), INDEX(cle_regroupement)

tbl_gpt_societe_site_regroupement_log
├── ID_LOG (PK AUTO_INCREMENT)
├── ID_SOCIETE INT
├── action VARCHAR(50) -- 'migration', 'validation', 'modification'
├── details TEXT -- Détails de l'opération
├── nb_sites_crees INT
├── nb_prm_regroupes INT
└── date_action TIMESTAMP

Clés de Regroupement (Format)

Format : {PRIORITE}_{ID_SOCIETE}_{IDENTIFIANT_UNIQUE} Exemples :

RATT_523_50088783673630 → Priorité 1 (RI), société 523, PRM de tête 50088783673630

ADR_523_ZA Caux Multipoles_76190_ALLOUVILLE → Priorité 2 (adresse complète)

C68_523_76190_ALLOUVILLE BELLEFOSSE → Priorité 3 (CP + commune)

---

Procédures Stockées V2

#### 1. sp_regrouper_prm_par_c68 - Procédure Principale

CALL sp_regrouper_prm_par_c68(
    @id_societe,         -- ID société à traiter
    @nb_sites_v2,        -- OUT: Nombre sites V2 créés
    @nb_prm_groupes,     -- OUT: Nombre PRM regroupés
    @nb_conflits         -- OUT: Nombre conflits détectés
);

Logique : Étape 1 : Récupérer les PRM rattachés

INSERT INTO tmp_groupes_rattachement (idPrm, groupe_prm)
SELECT r.idPrm, MIN(r.prm_id_rattache)
FROM c68_rattachements r
WHERE r.type_rattachement = 'RI'
GROUP BY r.idPrm;

Étape 2 : ⚠️ CRITIQUE - Ajouter le PRM de tête

-- Sans cette étape, le PRM de tête ne serait PAS dans tmp_groupes_rattachement !
INSERT INTO tmp_groupes_rattachement (idPrm, groupe_prm)
SELECT DISTINCT r.prm_id_rattache, r.prm_id_rattache
FROM c68_rattachements r
WHERE r.type_rattachement = 'RI'
AND NOT EXISTS (
    SELECT 1 FROM tmp_groupes_rattachement t
    WHERE t.idPrm = r.prm_id_rattache
);

Étape 3 : Construire les clés de regroupement (3 priorités)

Priorité 1 : RATT_{ID_SOCIETE}_{groupe_prm} pour les PRM rattachés

Priorité 2 : ADR_{ID_SOCIETE}_{adresse_complète} si adresse disponible

Priorité 3 : C68_{ID_SOCIETE}_{CP}_{commune} en fallback

Étape 4 : Créer les sites V2 - ⚠️ GROUP BY UNIQUEMENT cle_regroupement

-- ✅ Crucial : GROUP BY seulement la clé pour fusionner les sites
GROUP BY tmp.cle_regroupement;

-- ❌ Ancienne version causait des sites multiples :
-- GROUP BY cle_regroupement, nom_site_source, id_site_source

Étape 5 : Associer les PRM aux sites V2 #### 2. sp_transfert_prm_site_v2 - Transfert de PRM Permet de déplacer un PRM d'un site V2 à un autre avec traçabilité complète. #### 3. sp_detecter_conflits_c68 - Détection des Conflits Identifie les PRM avec données C68 manquantes ou incohérentes. #### 4. sp_migration_complete_v2 - Migration Globale Exécute la migration complète pour toutes les sociétés avec logging. ---

🖥️ Interface Utilisateur V2

`interface_regroupement_v2.php` - Dashboard Principal

URL : http://localhost/PAM_light_P15/interface_regroupement_v2.php Features :

📊 Statistiques Globales par Société

- Nombre total de sites V2 - Nombre total de PRM regroupés - PRM validés vs en attente - Moyenne PRM par site

🎯 Filtres Avancés

- Par société (dropdown) - Par statut de validation (tous, validés, non validés) - Conflits uniquement (checkbox) - Recherche par nom/CP/ville

🎨 Badges de Priorité

- ✅ VERT : Rattachement ENEDIS (RATT_) - Auto-validé, haute confiance - ⚠️ ORANGE : Adresse complète (ADR_) - Vérification recommandée - ⚠️ ROUGE : C68 basique (C68_) - ⚠️ ATTENTION : Vérification OBLIGATOIRE

📋 Cartes Expandables

- Cliquer "👁️ Détails" pour déplier - Affiche tous les PRM du site - Pour chaque PRM : - Nom du site V1 d'origine - Puissance souscrite - 🔗 Rattachements ENEDIS (si applicables) avec GROUP_CONCAT - Statut validation (✓ validé ou ⏳ en attente)

✓ Validation en 1 Clic

- Bouton "✓ Valider ce site" sur chaque carte - Post/Redirect/Get : Pas de warning de resoumission - Message de confirmation

🏠 Navigation

- Bouton "🏠 Accueil" vers index.php - Lien "📖 Documentation" vers SOLUTION_REGROUPEMENT_C68.md ---

`lancer_migration_v2.php` + `api_migration_v2.php`

Migration initiale ou re-regroupement pour une société Affiche pour un site V2 :

Infos générales : Nom, adresse, CP, ville, puissance

🔗 Rattachements ENEDIS : Section spéciale RI

Liste des PRM : Avec site original, validation, rattachements

📜 Historique : Timeline des modifications

---

📊 Exemple Concret : LINEX PANNEAUX

Avant (Tables V1)

tbl_gpt_societe_site:
├── ID_SITE: 134 - "LINEX USINE" - 76190 ALLOUVILLE BELLEFOSSE
│   └── PRM: 30000230176430 (Usine)
└── ID_SITE: 135 - "LINEX PROD" - 76190 ALLOUVILLE BELLEFOSSE
    └── PRM: 50088783673630 (Production - PRM de tête)

Problème : Même adresse exacte, mais 2 sites séparés ! ---

Analyse C68 + Rattachements

c68_rattachements:
├── PRM: 30000230176430 (Usine)
│   └── prm_id_rattache: 50088783673630
│       Type: RI (Rattachement Interne)
│       Point: INT (Point Intermédiaire)
│
└── PRM: 50088783673630 (Production)
    └── PRM de tête (pas de rattachement - c'est lui le point principal)

🔑 Découverte : Le PRM 30000230176430 est officiellement rattaché au PRM 50088783673630 selon ENEDIS ! 💡 Logique V2 :

PRM rattaché 30000230176430 → récupéré avec son lien vers 50088783673630

PRM de tête 50088783673630 → DOIT aussi être inclus avec lui-même comme groupe

Les 2 PRM reçoivent la même clé de regroupement : RATT_523_50088783673630

Résultat : 1 seul site V2 contenant les 2 PRM

---

Après (Tables V2)

tbl_gpt_societe_site_v2:
└── ID_SITE_V2: 1 - "LINEX - 76190 ALLOUVILLE BELLEFOSSE"
    ├── cle_regroupement: RATT_523_50088783673630
    ├── nb_prm_groupes: 2
    ├── puissance_totale: 250 kW (136 + 114)
    ├── verification_status: auto_validated ✅
    └── Badge: ✅ VERT (Priorité 1 - Rattachement ENEDIS)

tbl_gpt_societe_site_prm_v2:
├── PRM: 30000230176430
│   ├── ID_SITE_V2: 1
│   ├── cle_regroupement: RATT_523_50088783673630
│   ├── nom_site_source: "LINEX USINE" (site #134)
│   ├── puissance_souscrite: 136 kW
│   ├── rattachement_info: "Rattaché à 50088783673630 (RI-INT)"
│   └── validate_regroupement: 1 ✓ (auto RI)
│
└── PRM: 50088783673630
    ├── ID_SITE_V2: 1
    ├── cle_regroupement: RATT_523_50088783673630
    ├── nom_site_source: "LINEX PROD" (site #135)
    ├── puissance_souscrite: 114 kW
    ├── rattachement_info: "PRM de tête"
    └── validate_regroupement: 1 ✓ (auto RI)

Résultat : ✅ 2 sites V1 → 1 seul site V2 avec badge vert ! Gain : Regroupement automatique avec validation ENEDIS officielle ---

� Corrections Techniques Critiques V2

Fix 1 : Inclusion du PRM de Tête

Problème Initial :

-- ❌ Ancienne version : seuls les PRM rattachés étaient inclus
INSERT INTO tmp_groupes_rattachement (idPrm, groupe_prm)
SELECT DISTINCT r.idPrm, r.prm_id_rattache
FROM c68_rattachements r;

Résultat : Le PRM de tête (50088783673630) n'était PAS dans la table temporaire ! Solution :

-- ✅ V2 : 2 étapes
-- Étape 1 : Récupérer les PRM rattachés
INSERT INTO tmp_groupes_rattachement (idPrm, groupe_prm)
SELECT r.idPrm, MIN(r.prm_id_rattache)
FROM c68_rattachements r
WHERE r.type_rattachement = 'RI'
GROUP BY r.idPrm;

-- Étape 2 : Ajouter le PRM de tête avec lui-même
INSERT INTO tmp_groupes_rattachement (idPrm, groupe_prm)
SELECT DISTINCT r.prm_id_rattache, r.prm_id_rattache
FROM c68_rattachements r
WHERE r.type_rattachement = 'RI'
AND NOT EXISTS (
    SELECT 1 FROM tmp_groupes_rattachement t
    WHERE t.idPrm = r.prm_id_rattache
);

Résultat : Le PRM de tête reçoit la même clé que ses rattachés → regroupement correct ! ---

Fix 2 : GROUP BY Uniquement sur Clé de Regroupement

Problème Initial :

-- ❌ Ancienne version : GROUP BY multiple colonnes
GROUP BY cle_regroupement, nom_site_source, id_site_source

Résultat : Même avec la même clé RATT_523_50088783673630, LINEX avait 2 sites car :

Site 1 : cle=RATT_523_..., nom="LINEX USINE", id=134

Site 2 : cle=RATT_523_..., nom="LINEX PROD", id=135

Solution :

-- ✅ V2 : GROUP BY seulement la clé + agrégations MIN()
INSERT INTO tbl_gpt_societe_site_v2 (
    ID_SOCIETE,
    nom_site_v2,
    cle_regroupement,
    CP, ville, adresse,
    id_site_source, nom_site_source,
    nb_prm_groupes,
    puissance_totale,
    verification_status
)
SELECT 
    c.ID_SOCIETE,
    CONCAT(s.nom, ' - ', c.codePostal, ' ', c.commune) as nom_site_v2,
    tmp.cle_regroupement,
    c.codePostal, c.commune, c.numeroNomVoie,
    MIN(tsp.ID_SITE) as id_site_source,
    MIN(tgs.site_NOM) as nom_site_source,
    COUNT(DISTINCT c.idPrm) as nb_prm_groupes,
    SUM(c.ps_valeur) as puissance_totale,
    CASE 
        WHEN tmp.cle_regroupement LIKE 'RATT_%' THEN 'auto_validated'
        ELSE 'pending'
    END as verification_status
FROM tmp_sites_regroupement tmp
-- ... JOINs ...
GROUP BY tmp.cle_regroupement;  -- ✅ UNIQUEMENT la clé !

Résultat : Les 2 PRM avec cle=RATT_523_... sont fusionnés en 1 seul site V2 ! ---

Fix 3 : Élimination des Doublons d'Affichage

Problème : Un PRM avec plusieurs rattachements apparaissait plusieurs fois Solution Interface :

// ✅ GROUP BY tous les champs du PRM + GROUP_CONCAT pour rattachements
GROUP BY 
    sp.idPrm, sp.ID_SITE_V2, sp.cle_regroupement,
    sp.nom_site_source, sp.id_site_source,
    sp.puissance_souscrite, sp.validate_regroupement
HAVING rattachement_count > 0

---

�🚀 Guide d'Utilisation Rapide

Installation (1 fois)

1. Créer les tables

mysql -u root -p appros < create_tables_v2_regroupement.sql

2. Créer les procédures stockées

mysql -u root -p appros < create_stored_procedures_v2.sql

---

Migration Initiale (1 fois)

http://localhost/PAM_light_P15/migration_regroupement_c68.php

Attendre la fin → Consulter le rapport ---

Gestion Quotidienne

http://localhost/PAM_light_P15/interface_regroupement_v2.php

Interface Features :

Dashboard : Statistiques globales par société

Filtres : Par société, par statut de validation, conflits uniquement

Badges de Priorité :

- ✅ VERT : Rattachement ENEDIS (priorité 1) - Auto-validé - ⚠️ ORANGE : Adresse complète (priorité 2) - Vérification recommandée - ⚠️ ROUGE : C68 basique (priorité 3) - ⚠️ ATTENTION : Vérification OBLIGATOIRE

Navigation : Bouton 🏠 Accueil vers index.php

Documentation : Lien direct vers ce document

Workflow de Validation :

Filtrer "Conflits uniquement" ou par badge rouge ⚠️

Pour chaque site :

- Cliquer "👁️ Détails" pour déplier la carte - Vérifier les PRM regroupés - Vérifier les rattachements ENEDIS (colonne 🔗) - Si badge vert ✅ : Déjà auto-validé, juste vérifier - Si badge orange ⚠️ : Vérifier l'adresse complète, puis "✓ Valider" - Si badge rouge ⚠️ : ATTENTION - Vérifier attentivement avant validation

Post/Redirect/Get : Pas de warning de resoumission de formulaire

---

📈 Métriques Attendues

D'après l'analyse initiale : | Métrique | Valeur | |----------|--------| | Cas de conflits détectés | ~60 | | Validation automatique (RI) | ~30-40% | | Nécessitant vérification manuelle | ~60-70% | | Gain de précision | +++++ | ---

✅ Avantages de la Solution

1. Précision Maximale

Utilise les données officielles ENEDIS

Priorité aux rattachements techniques validés

2. Flexibilité

3 niveaux de critères (fallback automatique)

Gestion des cas incomplets

3. Traçabilité Complète

Conservation des sites originaux

Historique de toutes les modifications

Possibilité de rollback

4. Interface Intuitive

Dashboard avec statistiques

Filtres avancés

Validation en 1 clic

5. Évolutif

Procédures stockées (performances)

Structure modulaire

Facilement extensible

---

🎯 Prochaines Étapes Recommandées

✅ Exécuter la migration initiale

✅ Valider les regroupements avec rattachements RI (auto-validés)

⚠️ Vérifier manuellement les conflits (~60 cas)

📊 Analyser les statistiques par société

🔄 Ajuster si nécessaire via l'interface

---

📞 Ressources

Documentation complète : README_REGROUPEMENT_V2.md

Analyse C68 : http://localhost/PAM_light_P15/analyze_c68_structure.php

Interface V2 : http://localhost/PAM_light_P15/interface_regroupement_v2.php

Migration : http://localhost/PAM_light_P15/migration_regroupement_c68.php

--- 🎉 Résultat Final : Une structure Société → Sites V2 → PRM parfaitement alignée avec les données officielles ENEDIS, avec traçabilité complète et validation facilitée !

📖 Documentation Technique V2

🎯 SOLUTION V2 : Regroupement Intelligent des PRM par C68 + Rattachements ENEDIS

📌 Résumé Exécutif

Problème Identifié

Solution Déployée

🔑 Critères de Regroupement (Par Ordre de Priorité)

1️⃣ Rattachements ENEDIS RI ⭐ PRIORITÉ MAXIMALE

2️⃣ Adresse Complète C68 ⚠️ PRIORITÉ MOYENNE

3️⃣ C68 Basique (CP + Commune) ⚠️ FALLBACK - PRIORITÉ FAIBLE

🏗️ Architecture Technique V2

Nouvelles Tables V2

Clés de Regroupement (Format)

Procédures Stockées V2

🖥️ Interface Utilisateur V2

interface_regroupement_v2.php - Dashboard Principal

lancer_migration_v2.php + api_migration_v2.php

📊 Exemple Concret : LINEX PANNEAUX

Avant (Tables V1)

Analyse C68 + Rattachements

Après (Tables V2)

� Corrections Techniques Critiques V2

Fix 1 : Inclusion du PRM de Tête

Fix 2 : GROUP BY Uniquement sur Clé de Regroupement

Fix 3 : Élimination des Doublons d'Affichage

�🚀 Guide d'Utilisation Rapide

Installation (1 fois)

1. Créer les tables

2. Créer les procédures stockées

Migration Initiale (1 fois)

Gestion Quotidienne

📈 Métriques Attendues

✅ Avantages de la Solution

1. Précision Maximale

2. Flexibilité

3. Traçabilité Complète

4. Interface Intuitive

5. Évolutif

🎯 Prochaines Étapes Recommandées

📞 Ressources

`interface_regroupement_v2.php` - Dashboard Principal

`lancer_migration_v2.php` + `api_migration_v2.php`