Upload folder using huggingface_hub

ARCHITECTURE.md

@@ -11,108 +11,63 @@ By aggressively decoupling the presentation layer (Client), the orchestration an
 ## 🏗 High-Level Architecture Diagram
 
 ```mermaid
-%% Generated by https://gitdiagram.com/idkhowtocodefr/heartflow_os
-flowchart TD
-
-subgraph group_client["Telemetry interface"]
-  node_dashboard["Live dashboard<br/>[page.tsx]"]
-  node_telemetry_context["Telemetry context"]
-  node_history_ui["History view<br/>[page.tsx]"]
-  node_analytics["Analytics view<br/>[page.tsx]"]
-  node_simulator_ui["Simulator view<br/>[page.tsx]"]
-  node_mlops_ui["MLOps view<br/>[page.tsx]"]
-  node_edge_ui["Edge export view<br/>[page.tsx]"]
-  node_architecture_ui["Architecture view<br/>[page.tsx]"]
-  node_shap_chart["SHAP chart<br/>[ShapChart.tsx]"]
-end
-
-subgraph group_api["API orchestration"]
-  node_api["FastAPI routes<br/>[main.py]"]
-  node_simulator["Vitals simulator<br/>[simulator.py]"]
-end
-
-subgraph group_ml["Prediction and MLOps"]
-  node_inference["Inference pipeline<br/>[inference.py]"]
-  node_preprocessing["Feature preprocessing<br/>[preprocessing.py]"]
-  node_ensemble["Soft-voting ensemble<br/>[ensemble.py]"]
-  node_training["Model training<br/>[models.py]"]
-  node_export["C code exporter<br/>[export.py]"]
-  node_model_files["Trained model files"]
-  node_dataset["Patient dataset"]
-end
-
-subgraph group_state["Persistence and sync"]
-  node_database[("Prediction history<br/>[database.py]")]
-  node_sqlite[("SQLite history store<br/>[patient_history.db]")]
-end
-
-node_clinician(("Clinical user"))
-node_hub["Hugging Face Hub"]
-
-node_clinician -.->|"monitors"| node_dashboard
-node_clinician -.->|"reviews"| node_history_ui
-node_clinician -.->|"explores"| node_analytics
-node_clinician -.->|"uses"| node_simulator_ui
-node_clinician -.->|"manages"| node_mlops_ui
-node_clinician -.->|"exports"| node_edge_ui
-node_clinician -.->|"views"| node_architecture_ui
-node_dashboard -->|"uses"| node_telemetry_context
-node_clinician -.->|"submits vitals"| node_api
-node_dashboard -.->|"streams telemetry"| node_api
-node_history_ui -.->|"requests history"| node_api
-node_analytics -.->|"requests data"| node_api
-node_mlops_ui -.->|"uploads retraining data"| node_api
-node_edge_ui -.->|"requests C export"| node_api
-node_api -->|"initializes and queries"| node_database
-node_api -->|"streams generated vitals"| node_simulator
-node_api -->|"evaluates vitals"| node_inference
-node_api -->|"prepares explanations"| node_preprocessing
-node_api -->|"generates C code"| node_export
-node_api -->|"loads and refreshes"| node_ensemble
-node_api -->|"starts background retraining"| node_training
-node_inference -->|"transforms features"| node_preprocessing
-node_inference -.->|"predicts probabilities"| node_ensemble
-node_ensemble -->|"resolves model directory"| node_preprocessing
-node_training -->|"splits and transforms data"| node_preprocessing
-node_training -->|"reads training data"| node_dataset
-node_training -->|"writes trained models"| node_model_files
-node_ensemble -->|"loads model artifacts"| node_model_files
-node_database -->|"reads and writes"| node_sqlite
-node_database -->|"syncs history"| node_hub
-
-click node_dashboard "https://github.com/idkhowtocodefr/heartflow_os/blob/main/frontend/src/app/dashboard/page.tsx"
-click node_telemetry_context "https://github.com/idkhowtocodefr/heartflow_os/blob/main/frontend/src/context/TelemetryContext.tsx"
-click node_history_ui "https://github.com/idkhowtocodefr/heartflow_os/blob/main/frontend/src/app/history/page.tsx"
-click node_analytics "https://github.com/idkhowtocodefr/heartflow_os/blob/main/frontend/src/app/analytics/page.tsx"
-click node_simulator_ui "https://github.com/idkhowtocodefr/heartflow_os/blob/main/frontend/src/app/simulator/page.tsx"
-click node_mlops_ui "https://github.com/idkhowtocodefr/heartflow_os/blob/main/frontend/src/app/mlops/page.tsx"
-click node_edge_ui "https://github.com/idkhowtocodefr/heartflow_os/blob/main/frontend/src/app/edge/page.tsx"
-click node_architecture_ui "https://github.com/idkhowtocodefr/heartflow_os/blob/main/frontend/src/app/architecture/page.tsx"
-click node_shap_chart "https://github.com/idkhowtocodefr/heartflow_os/blob/main/frontend/src/components/ShapChart.tsx"
-click node_api "https://github.com/idkhowtocodefr/heartflow_os/blob/main/backend/main.py"
-click node_simulator "https://github.com/idkhowtocodefr/heartflow_os/blob/main/backend/simulator.py"
-click node_inference "https://github.com/idkhowtocodefr/heartflow_os/blob/main/backend/inference.py"
-click node_preprocessing "https://github.com/idkhowtocodefr/heartflow_os/blob/main/backend/preprocessing.py"
-click node_ensemble "https://github.com/idkhowtocodefr/heartflow_os/blob/main/backend/ensemble.py"
-click node_training "https://github.com/idkhowtocodefr/heartflow_os/blob/main/backend/models.py"
-click node_export "https://github.com/idkhowtocodefr/heartflow_os/blob/main/backend/export.py"
-click node_model_files "https://github.com/idkhowtocodefr/heartflow_os/tree/main/model"
-click node_dataset "https://github.com/idkhowtocodefr/heartflow_os/blob/main/data/patient_dataset.csv"
-click node_database "https://github.com/idkhowtocodefr/heartflow_os/blob/main/backend/database.py"
-click node_sqlite "https://github.com/idkhowtocodefr/heartflow_os/blob/main/backend/patient_history.db"
-
-classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
-classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
-classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
-classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
-classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
-classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
-classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
-class node_dashboard,node_telemetry_context,node_history_ui,node_analytics,node_simulator_ui,node_mlops_ui,node_edge_ui,node_architecture_ui,node_shap_chart,node_clinician toneBlue
-class node_api,node_simulator toneAmber
-class node_inference,node_preprocessing,node_ensemble,node_training,node_export,node_model_files,node_dataset toneMint
-class node_database,node_sqlite toneRose
-class node_hub toneIndigo
+graph TD
+    %% Define styles
+    classDef frontend fill:#111,stroke:#111,stroke-width:2px,color:#fff,font-family:monospace;
+    classDef backend fill:#fff,stroke:#111,stroke-width:2px,color:#111,font-family:monospace;
+    classDef ml_node fill:#e61919,stroke:#e61919,stroke-width:2px,color:#fff,font-family:monospace;
+    classDef edge_tech fill:#f3f3f2,stroke:#111,stroke-width:2px,color:#111,font-family:monospace;
+    classDef data fill:#94a3b8,stroke:#475569,stroke-width:2px,color:#fff,font-family:monospace;
+
+    subgraph Client [Client Application / Next.js 16]
+        direction TB
+        UI["React 19 Views<br/>[dashboard/page.tsx, etc]"]:::frontend
+        WS_Client["WebSocket Context<br/>[TelemetryContext.tsx]"]:::frontend
+        HTTP_Client["HTTP Data Fetching"]:::frontend
+    end
+
+    subgraph Core [FastAPI Core / Python 3.10+]
+        direction TB
+        WS_Server["Async WebSocket Broker<br/>[main.py]"]:::backend
+        REST_API["REST API Router<br/>[main.py]"]:::backend
+        Simulator["Vitals Simulator<br/>[simulator.py]"]:::backend
+        DB["SQLite DB & aiosqlite<br/>[database.py]"]:::backend
+    end
+
+    subgraph ML_Layer [Intelligence Pipeline / Scikit-Learn]
+        direction TB
+        Inference["Inference & Preprocessing<br/>[inference.py, preprocessing.py]"]:::ml_node
+        Ensemble["Soft-Voting Ensemble<br/>[ensemble.py]"]:::ml_node
+        Training["Model Training<br/>[models.py]"]:::ml_node
+        EdgeCompiler["C-Code Exporter<br/>[export.py]"]:::ml_node
+    end
+
+    subgraph Storage [Persistence & Hardware]
+        direction TB
+        ModelWeights["Model Artifacts<br/>[model/ directory]"]:::data
+        CSV["Patient Dataset<br/>[patient_dataset.csv]"]:::data
+        MCU["Edge Silicon / Header<br/>[tinyml_model.h]"]:::edge_tech
+    end
+
+    %% Flows
+    UI --> WS_Client
+    UI --> HTTP_Client
+    
+    WS_Client <--> WS_Server
+    HTTP_Client --> REST_API
+    
+    WS_Server --> Inference
+    Simulator --> WS_Server
+    REST_API --> DB
+    REST_API --> Training
+    REST_API --> EdgeCompiler
+    
+    Inference --> Ensemble
+    Training --> ModelWeights
+    Training --> CSV
+    Ensemble --> ModelWeights
+    EdgeCompiler --> Ensemble
+    EdgeCompiler -.-> MCU
 ```
 
 ---