# selyan-mhli/projet_natran architecture

> Architecture diagram of the GitHub repository selyan-mhli/projet_natran, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/selyan-mhli/projet_natran
- Repository: https://github.com/selyan-mhli/projet_natran

## Overview

NATRAN is a React demonstration of AI-assisted sorting of solid recovered fuel (CSR), framed around improving pyro-gasification feed quality. The user navigates an introduction, an interactive 3D sorting simulation, an architecture overview, and impact reporting. In the simulation, objects are generated and handled in a Babylon.js scene; the dashboard and impact view consume shared simulation statistics. The README also describes camera/IoT sensing, material detection, composition and pollutant prediction, and reactor optimization as the intended product pipeline. Those real-world stages are documented capabilities, not implemented integrations verified in the sampled code.

Main entry points: [`src/App.tsx`](https://github.com/selyan-mhli/projet_natran/blob/main/src/App.tsx) (Application Shell), [`src/context/SimulationContext.tsx`](https://github.com/selyan-mhli/projet_natran/blob/main/src/context/SimulationContext.tsx) (Simulation Statistics), [`src/components/FinalSimulation.tsx`](https://github.com/selyan-mhli/projet_natran/blob/main/src/components/FinalSimulation.tsx) (3D Sorting), [`src/components/Dashboard.tsx`](https://github.com/selyan-mhli/projet_natran/blob/main/src/components/Dashboard.tsx) (Live Dashboard)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Application UI"]
  node_app["Application Shell<br/>[App.tsx]"]
  node_navigation["Tab Navigation<br/>[Header.tsx]"]
  node_overview["CSR Introduction<br/>[AboutCSR.tsx]"]
  node_architecture["System Overview<br/>[Architecture.tsx]"]
end

subgraph group_sorting["Sorting Simulation"]
  node_simulation["3D Sorting"]
  node_arm["Robotic Arm Model"]
  node_v2["Alternate 3D Simulation"]
end

subgraph group_metrics["Metrics and Impact"]
  node_dashboard["Live Dashboard<br/>[Dashboard.tsx]"]
  node_context["Simulation Statistics"]
  node_impact["Impact Summary<br/>[Impact.tsx]"]
end

subgraph group_pipeline["Documented Process"]
  node_camera["Cameras and IoT Sensors"]
  node_vision["Material Detection"]
  node_prediction["Composition and Pollutant Prediction"]
  node_reactor["Pyro-gasification Reactor"]
  node_fuel["Improved Fuel Quality"]
end

node_user(("Operator"))

node_user -->|"selects view"| node_navigation
node_app -->|"renders"| node_navigation
node_app -->|"renders"| node_overview
node_app -->|"renders"| node_simulation
node_app -->|"renders"| node_architecture
node_app -->|"renders"| node_impact
node_app -->|"provides state"| node_context
node_simulation -->|"renders"| node_dashboard
node_simulation -->|"updates statistics"| node_context
node_dashboard -->|"reads statistics"| node_context
node_impact -->|"reads statistics"| node_context
node_v2 -->|"constructs arms"| node_arm
node_camera -.->|"captures materials"| node_vision
node_vision -.->|"detects and predicts"| node_prediction
node_prediction -.->|"guides optimization"| node_reactor
node_reactor -.->|"improves quality"| node_fuel

click node_app "https://github.com/selyan-mhli/projet_natran/blob/main/src/App.tsx"
click node_navigation "https://github.com/selyan-mhli/projet_natran/blob/main/src/components/Header.tsx"
click node_overview "https://github.com/selyan-mhli/projet_natran/blob/main/src/components/AboutCSR.tsx"
click node_architecture "https://github.com/selyan-mhli/projet_natran/blob/main/src/components/Architecture.tsx"
click node_simulation "https://github.com/selyan-mhli/projet_natran/blob/main/src/components/FinalSimulation.tsx"
click node_dashboard "https://github.com/selyan-mhli/projet_natran/blob/main/src/components/Dashboard.tsx"
click node_context "https://github.com/selyan-mhli/projet_natran/blob/main/src/context/SimulationContext.tsx"
click node_impact "https://github.com/selyan-mhli/projet_natran/blob/main/src/components/Impact.tsx"
click node_arm "https://github.com/selyan-mhli/projet_natran/blob/main/src/components/RealisticRoboticArm.tsx"
click node_v2 "https://github.com/selyan-mhli/projet_natran/blob/main/src/components/BabylonSimulationV2.tsx"

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_app,node_navigation,node_overview,node_architecture toneBlue
class node_simulation,node_arm,node_v2 toneAmber
class node_dashboard,node_context,node_impact toneMint
class node_camera,node_vision,node_prediction,node_reactor,node_fuel toneRose
class node_user toneIndigo
```

## Components

### Application UI

- [Application Shell](https://github.com/selyan-mhli/projet_natran/blob/main/src/App.tsx): `src/App.tsx`
- [Tab Navigation](https://github.com/selyan-mhli/projet_natran/blob/main/src/components/Header.tsx): `src/components/Header.tsx`
- [CSR Introduction](https://github.com/selyan-mhli/projet_natran/blob/main/src/components/AboutCSR.tsx): `src/components/AboutCSR.tsx`
- [System Overview](https://github.com/selyan-mhli/projet_natran/blob/main/src/components/Architecture.tsx): `src/components/Architecture.tsx`

### Sorting Simulation

- [3D Sorting](https://github.com/selyan-mhli/projet_natran/blob/main/src/components/FinalSimulation.tsx): `src/components/FinalSimulation.tsx`
- [Robotic Arm Model](https://github.com/selyan-mhli/projet_natran/blob/main/src/components/RealisticRoboticArm.tsx): `src/components/RealisticRoboticArm.tsx`
- [Alternate 3D Simulation](https://github.com/selyan-mhli/projet_natran/blob/main/src/components/BabylonSimulationV2.tsx): `src/components/BabylonSimulationV2.tsx`

### Metrics and Impact

- [Live Dashboard](https://github.com/selyan-mhli/projet_natran/blob/main/src/components/Dashboard.tsx): `src/components/Dashboard.tsx`
- [Simulation Statistics](https://github.com/selyan-mhli/projet_natran/blob/main/src/context/SimulationContext.tsx): `src/context/SimulationContext.tsx`
- [Impact Summary](https://github.com/selyan-mhli/projet_natran/blob/main/src/components/Impact.tsx): `src/components/Impact.tsx`

### Documented Process

- **Cameras and IoT Sensors**
- **Material Detection**
- **Composition and Pollutant Prediction**
- **Pyro-gasification Reactor**
- **Improved Fuel Quality**

### Other components

- **Operator**

## Connections

- Operator → Tab Navigation: selects view (evidence: `src/components/Header.tsx`)
- Application Shell → Tab Navigation: renders (evidence: `src/App.tsx`)
- Application Shell → CSR Introduction: renders (evidence: `src/App.tsx`)
- Application Shell → 3D Sorting: renders (evidence: `src/App.tsx`)
- Application Shell → System Overview: renders (evidence: `src/App.tsx`)
- Application Shell → Impact Summary: renders (evidence: `src/App.tsx`)
- Application Shell → Simulation Statistics: provides state (evidence: `src/App.tsx`)
- 3D Sorting → Live Dashboard: renders (evidence: `src/components/FinalSimulation.tsx`)
- 3D Sorting → Simulation Statistics: updates statistics (evidence: `src/components/FinalSimulation.tsx`)
- Live Dashboard → Simulation Statistics: reads statistics (evidence: `src/components/Dashboard.tsx`)
- Impact Summary → Simulation Statistics: reads statistics (evidence: `src/components/Impact.tsx`)
- Alternate 3D Simulation → Robotic Arm Model: constructs arms (evidence: `src/components/BabylonSimulationV2.tsx`)
- Cameras and IoT Sensors → Material Detection: captures materials (evidence: `README.md`)
- Material Detection → Composition and Pollutant Prediction: detects and predicts (evidence: `README.md`)
- Composition and Pollutant Prediction → Pyro-gasification Reactor: guides optimization (evidence: `README.md`)
- Pyro-gasification Reactor → Improved Fuel Quality: improves quality (evidence: `README.md`)
