Vue d'ensemble

Le module PCC transforme le modèle topologique (StraightBlock / SwitchBlock) en un graphe logique indépendant des coordonnées GPS, positionnable en schéma gauche → droite pour l'affichage TCO.

TopologyRepository      Modules/PCC       HMI/PCCPanel
  StraightBlock  ────┬─►  PCCNode  ────►  TCORenderer
  SwitchBlock    ────┘       │
                          PCCEdge
                             │
                          PCCGraph

Règle de dépendance :

Modules/PCC lit TopologyRepository — seul point de couplage vers le GeoParser.
HMI/PCCPanel consomme PCCGraph uniquement — jamais TopologyRepository directement.

Classe	Responsabilité unique
PCCNode	Représenter un bloc ferroviaire dans le graphe
PCCStraightNode	Exposer les données spécifiques d'une voie droite
PCCSwitchNode	Exposer les données spécifiques d'un aiguillage
PCCEdge	Représenter une connexion orientée entre deux nœuds
PCCGraph	Posséder et indexer les nœuds et arêtes
PCCGraphBuilder	Construire le graphe depuis TopologyRepository
PCCLayout	Calculer les positions logiques X/Y

Nœuds et arêtes

PCCEdge          — connexion orientée (from → to) + rôle sémantique
PCCNode          — nœud abstrait (bloc ferroviaire + position logique)
PCCStraightNode  — nœud voie droite → getStraightSource() : StraightBlock*
PCCSwitchNode    — nœud aiguillage  → getSwitchSource()   : SwitchBlock*
                                      getRootEdge() / getNormalEdge() / getDeviationEdge()

Hiérarchie :

PCCNode  (abstrait)
  ├── PCCStraightNode
  └── PCCSwitchNode

**Rôles d'arête (PCCEdgeRole) :**

Valeur	Description
`STRAIGHT`	Connexion entre deux blocs adjacents sans switch
`ROOT`	Connexion sur la branche root d'un SwitchBlock
`NORMAL`	Connexion sur la branche normale d'un SwitchBlock
`DEVIATION`	Connexion sur la branche déviée d'un SwitchBlock

PCCGraph — Conteneur

PCCGraph possède l'ensemble des nœuds et arêtes via unique_ptr et expose un index de lookup O(1) par sourceId.

PCCGraph
  ├── m_nodes  : vector<unique_ptr<PCCNode>>      propriétaire
  ├── m_edges  : vector<unique_ptr<PCCEdge>>      propriétaire
  └── m_index  : unordered_map<string, PCCNode*>  lookup O(1)

Méthode	Rôle
addStraightNode()	Crée, stocke et indexe un PCCStraightNode
addSwitchNode()	Crée, stocke et indexe un PCCSwitchNode
addEdge()	Crée, stocke et câble une PCCEdge sur les deux nœuds
findNode()	Lookup O(1) — retourne `nullptr` si absent
clear()	Vide nœuds, arêtes et index

PCCGraphBuilder — Construction

Classe statique. Seule classe du module qui connaît TopologyRepository.

**Pipeline interne de PCCGraphBuilder::build() :**

Passe 1 — buildNodes() : crée un nœud PCC par bloc (index complet)

Passe 2 — buildEdges() : résout les connexions via les IDs de voisins/branches

Les deux passes sont séparées — toutes les arêtes référencent des nœuds par ID, l'index doit être complet avant la résolution.

PCCLayout — Positionnement

Classe statique. Calcule les positions logiques X/Y par parcours BFS.

Avant PCCLayout          Après PCCLayout
 
s/0  sw/0  s/1           s/0(x=0,y=0) ─ sw/0(x=1,y=0) ─┬─ s/1(x=2,y=0)
                                                       └─ s/2(x=2,y=1)  ← déviation

Règles de positionnement :

Arête empruntée	Effet sur Y
ROOT / NORMAL / STRAIGHT	Y inchangé
DEVIATION	Y + 1 (bifurcation vers le haut)

Méthode	Rôle
compute()	Point d'entrée — orchestre BFS multi-sources
findTermini()	Détecte les nœuds de départ (1 seul voisin, non-cible de switch)
runBFS()	BFS depuis un terminus, assigne PCCPosition