Upload folder using huggingface_hub

ARCHITECTURE.md

@@ -11,67 +11,108 @@ By aggressively decoupling the presentation layer (Client), the orchestration an
 ## 🏗 High-Level Architecture Diagram
 
 ```mermaid
-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]
-        UI[React 19 Dashboard]:::frontend
-        WS_Client[WebSocket Context]:::frontend
-        HTTP_Client[Axios/Fetch HTTP]:::frontend
-    end
-
-    subgraph Core [FastAPI Core / Python 3.10+]
-        WS_Server[Async WebSocket Broker]:::backend
-        REST_API[RESTful API Router]:::backend
-        Inference[Stateful Inference Preprocessor]:::backend
-        MLOps[Background MLOps Engine]:::backend
-        DB[(aiosqlite Asynchronous DB)]:::backend
-    end
-
-    subgraph ML_Layer [Intelligence Pipeline / Scikit-Learn]
-        Ensemble{Soft-Voting Aggregator}:::ml_node
-        Models[RF, SVM, KNN, LogReg, MLP]:::ml_node
-        SHAP[SHAP Feature Explainer]:::ml_node
-        EdgeCompiler[INT8 AST C-Compiler]:::ml_node
-    end
-
-    subgraph Hardware [Edge Target / Embedded Silicon]
-        HEADER((tinyml_model.h)):::edge_tech
-        MCU[ESP32 / Cortex-M Node]:::edge_tech
-    end
-
-    subgraph Storage [Persistent Persistence Layer]
-        ModelWeights[Serialized Weights / LRU .pkl]:::data
-        CSV[Immutable Patient Dataset .csv]:::data
-    end
-
-    %% Edge Flows
-    UI -->|Framer Motion Layouts| WS_Client
-    UI -->|Config / Retrain Requests| HTTP_Client
-    
-    WS_Client <-->|ws:// 60Hz Telemetry Stream| WS_Server
-    HTTP_Client -->|POST /retrain, GET /export| REST_API
-    
-    WS_Server -->|Event Loop Execution| Inference
-    REST_API -->|Threaded Task| MLOps
-    REST_API -->|Triggers Generation| EdgeCompiler
-    
-    Inference -->|Standardized Vector| Ensemble
-    Ensemble --> Models
-    Ensemble --> SHAP
-    
-    MLOps -->|LRU State Override| ModelWeights
-    MLOps -->|Append Only| CSV
-    EdgeCompiler -->|Parses Structure| Models
-    Inference -->|Reads Memory-Mapped| ModelWeights
-    
-    EdgeCompiler -->|Emits Dependency-Free C| HEADER
-    HEADER -.->|Flash via UART| MCU
+%% 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
 ```
 
 ---