Revert "chore: Remove obsolete CLAUDE_NEXT_SESSION.md"

Restore CLAUDE_NEXT_SESSION.md as requested. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-23 12:19:01 +08:00 · 2025-11-23 12:19:01 +08:00 · 18a319768d
commit 18a319768d
parent 0b4ff5a946
1 changed files with 180 additions and 0 deletions
--- a/CLAUDE_NEXT_SESSION.md
+++ b/CLAUDE_NEXT_SESSION.md
@ -0,0 +1,180 @@
+# Session Suivante : Fix IO Routing
+
+## 🎯 Contexte
+Implémentation du scénario 11 (IO System Stress Test). Le test est créé et compile, mais le routing des messages entre modules IntraIO ne fonctionne pas.
+
+## 🐛 Problème Identifié
+**Bug Architecture** : `IntraIO::publish()` et `IntraIO::subscribe()` ne communiquent PAS avec `IntraIOManager` singleton.
+
+### Flux Actuel (Cassé)
+```
+Module A publish("test", data)
+  ↓
+IntraIO::publish() → messageQueue locale ❌
+  
+Module B subscribe("test")
+  ↓  
+IntraIO::subscribe() → subscriptions locales ❌
+
+Résultat: Aucun message routé entre modules !
+```
+
+### Flux Corrigé (Implémenté)
+```
+Module A publish("test", data)
+  ↓
+IntraIO::publish()
+  ↓ extract JSON from JsonDataNode
+  ↓
+IntraIOManager::routeMessage(instanceId, topic, json) ✅
+  ↓
+Pour chaque subscriber:
+  - Copy JSON
+  - Créer nouveau JsonDataNode
+  - deliverMessage() → queue du subscriber
+
+Module B subscribe("test")
+  ↓
+IntraIO::subscribe()
+  ↓
+IntraIOManager::registerSubscription(instanceId, pattern) ✅
+```
+
+## ✅ Modifications Effectuées
+
+### 1. IntraIOManager.h (ligne 74)
+```cpp
+// AVANT
+void routeMessage(const std::string& sourceid, const std::string& topic, std::unique_ptr<IDataNode> message);
+
+// APRÈS  
+void routeMessage(const std::string& sourceid, const std::string& topic, const json& messageData);
+```
+
+### 2. IntraIOManager.cpp
+- Ajout include: `#include <grove/JsonDataNode.h>`
+- Ligne 102-148: Nouvelle implémentation de `routeMessage()`:
+  - Prend `const json&` au lieu de `unique_ptr<IDataNode>`
+  - Pour chaque subscriber matching:
+    - `json dataCopy = messageData;` (copie JSON)
+    - `auto dataNode = std::make_unique<JsonDataNode>("message", dataCopy);`
+    - `deliverMessage(topic, std::move(dataNode), isLowFreq);`
+  - **Fix 1-to-many** : Continue la boucle au lieu de break (ligne 134)
+
+### 3. IntraIO.cpp
+- Ajout include: `#include <grove/IntraIOManager.h>`
+
+**publish()** (ligne 24-40):
+```cpp
+void IntraIO::publish(const std::string& topic, std::unique_ptr<IDataNode> message) {
+    std::lock_guard<std::mutex> lock(operationMutex);
+    totalPublished++;
+    
+    // Extract JSON
+    auto* jsonNode = dynamic_cast<JsonDataNode*>(message.get());
+    if (!jsonNode) throw std::runtime_error("Requires JsonDataNode");
+    
+    const nlohmann::json& jsonData = jsonNode->getJsonData();
+    
+    // Route via Manager ← NOUVEAU !
+    IntraIOManager::getInstance().routeMessage(instanceId, topic, jsonData);
+}
+```
+
+**subscribe()** (ligne 38-51):
+```cpp
+void IntraIO::subscribe(const std::string& topicPattern, const SubscriptionConfig& config) {
+    // ... existing code ...
+    highFreqSubscriptions.push_back(std::move(sub));
+    
+    // Register with Manager ← NOUVEAU !
+    IntraIOManager::getInstance().registerSubscription(instanceId, topicPattern, false);
+}
+```
+
+**subscribeLowFreq()** (ligne 53-66):
+```cpp
+void IntraIO::subscribeLowFreq(const std::string& topicPattern, const SubscriptionConfig& config) {
+    // ... existing code ...
+    lowFreqSubscriptions.push_back(std::move(sub));
+    
+    // Register with Manager ← NOUVEAU !
+    IntraIOManager::getInstance().registerSubscription(instanceId, topicPattern, true);
+}
+```
+
+## 🚀 Prochaines Étapes
+
+### 1. Build
+```bash
+cd /mnt/c/Users/alexi/Documents/projects/groveengine/build
+cmake --build . -j4
+```
+
+### 2. Run Test
+```bash
+cd /mnt/c/Users/alexi/Documents/projects/groveengine/build/tests
+./test_11_io_system
+```
+
+### 3. Résultats Attendus
+- ✅ TEST 1: Basic Pub/Sub → 100/100 messages reçus
+- ✅ TEST 2: Pattern Matching → patterns matchent correctement
+- ✅ TEST 3: Multi-Module → TOUS les subscribers reçoivent (1-to-many fixé!)
+- ✅ TEST 4-6: Autres tests passent
+
+### 4. Si Erreurs de Compilation
+Vérifier que tous les includes sont présents:
+- `IntraIOManager.cpp`: `#include <grove/JsonDataNode.h>`
+- `IntraIO.cpp`: `#include <grove/IntraIOManager.h>`
+
+### 5. Si Tests Échouent
+Activer les logs pour debug:
+```cpp
+IntraIOManager::getInstance().setLogLevel(spdlog::level::debug);
+```
+
+Vérifier dans les logs:
+- `📨 Routing message:` apparaît quand publish()
+- `📋 Registered subscription:` apparaît quand subscribe()
+- `↪️ Delivered to` apparaît pour chaque delivery
+
+## 📊 Architecture Finale
+
+```
+IDataNode (abstraction)
+    ↓
+JsonDataNode (implémentation avec nlohmann::json)
+    ↓
+IntraIO (instance par module)
+    - publish() → extrait JSON → routeMessage()
+    - subscribe() → registerSubscription()
+    - deliverMessage() ← reçoit de Manager
+    ↓
+IntraIOManager (singleton central)
+    - routeMessage() → copie JSON → deliverMessage() aux subscribers
+    - routingTable : patterns → instances
+```
+
+**Avantages de cette architecture**:
+- ✅ JSON est copiable (pas besoin de clone())
+- ✅ 1-to-many fonctionne (copie JSON pour chaque subscriber)
+- ✅ Compatible futur NetworkIO (JSON sérialisable)
+- ✅ Abstraction IDataNode préservée
+
+## 📝 Fichiers Modifiés
+1. `/include/grove/IntraIOManager.h` (signature routeMessage)
+2. `/src/IntraIOManager.cpp` (implémentation routing avec JSON)
+3. `/src/IntraIO.cpp` (publish/subscribe appellent Manager)
+
+## ✅ Todo List
+- [x] Modifier signature routeMessage() pour JSON
+- [x] Implémenter copie JSON et recreation DataNode
+- [x] Modifier subscribe() pour enregistrer au Manager
+- [x] Modifier subscribeLowFreq() pour enregistrer au Manager
+- [x] Modifier publish() pour router via Manager
+- [ ] **Build le projet**
+- [ ] **Run test_11_io_system**
+- [ ] **Vérifier que tous les tests passent**
+
+Bonne chance ! 🚀