# ranahaqnawaz634-design/physical-road-condition- architecture

> Architecture diagram of the GitHub repository ranahaqnawaz634-design/physical-road-condition-, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-17). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ranahaqnawaz634-design/physical-road-condition-
- Repository: https://github.com/ranahaqnawaz634-design/physical-road-condition-

## Overview

This is a browser-based PINN platform for assessing self-sensing asphalt under mechanical and climate stress. Users choose a synthetic strain-regime dataset or upload experimental CSV data, then explore condition, damage, benchmark, microstructure, analytics, and PINN views, with an engineering report available in the interface. The graph preserves the documented assessment capabilities and the indexed feature modules. Some component internals and the DeepXDE implementation were not excerpted, so their internal connections are not inferred.

Main entry points: [`src/App.tsx`](https://github.com/ranahaqnawaz634-design/physical-road-condition-/blob/main/src/App.tsx) (Application shell), [`src/utils/benchmarkDatasets.ts`](https://github.com/ranahaqnawaz634-design/physical-road-condition-/blob/main/src/utils/benchmarkDatasets.ts) (Benchmark datasets), [`src/components/CsvUploader.tsx`](https://github.com/ranahaqnawaz634-design/physical-road-condition-/blob/main/src/components/CsvUploader.tsx) (CSV ingestion), [`src/utils/csvParser.ts`](https://github.com/ranahaqnawaz634-design/physical-road-condition-/blob/main/src/utils/csvParser.ts) (CSV parser)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Platform Shell"]
  node_app["Application shell<br/>[App.tsx]"]
end

subgraph group_data["Data and Physics"]
  node_sensor["Sensor data types<br/>[pinn.ts]"]
  node_datasets["Benchmark datasets"]
  node_csv["CSV ingestion<br/>[CsvUploader.tsx]"]
  node_parser["CSV parser<br/>[csvParser.ts]"]
  node_physics["Physics engine<br/>[physicsEngine.ts]"]
end

subgraph group_assessment["Assessment Views"]
  node_architecture["Architecture flow"]
  node_intelligence["Condition intelligence"]
  node_condition["Condition assessment"]
  node_microstructure["Microstructure view"]
  node_playback["Simulation playback"]
end

subgraph group_analysis["Analysis and Reporting"]
  node_benchmark["Benchmark comparison"]
  node_plots["Analytics plots"]
  node_training["PINN training lab"]
  node_model["PINN model<br/>[pinnModel.ts]"]
  node_deepxde["DeepXDE lab<br/>[DeepXdeLab.tsx]"]
  node_report["Engineering report"]
end

node_user(("Engineer"))

node_user -->|"uses"| node_app
node_app -->|"selects dataset"| node_datasets
node_app -->|"opens ingestion"| node_csv
node_csv -->|"parses CSV"| node_parser
node_parser -->|"calculates resistance"| node_physics
node_app -->|"shows view"| node_architecture
node_app -->|"shows view"| node_intelligence
node_app -->|"shows view"| node_condition
node_app -->|"shows view"| node_microstructure
node_app -->|"shows view"| node_benchmark
node_app -->|"shows view"| node_plots
node_app -->|"shows view"| node_training
node_app -->|"shows view"| node_deepxde
node_app -->|"opens report"| node_report
node_training -->|"uses model"| node_model
node_datasets -->|"calculates resistance"| node_physics

click node_app "https://github.com/ranahaqnawaz634-design/physical-road-condition-/blob/main/src/App.tsx"
click node_sensor "https://github.com/ranahaqnawaz634-design/physical-road-condition-/blob/main/src/types/pinn.ts"
click node_datasets "https://github.com/ranahaqnawaz634-design/physical-road-condition-/blob/main/src/utils/benchmarkDatasets.ts"
click node_csv "https://github.com/ranahaqnawaz634-design/physical-road-condition-/blob/main/src/components/CsvUploader.tsx"
click node_parser "https://github.com/ranahaqnawaz634-design/physical-road-condition-/blob/main/src/utils/csvParser.ts"
click node_physics "https://github.com/ranahaqnawaz634-design/physical-road-condition-/blob/main/src/utils/physicsEngine.ts"
click node_architecture "https://github.com/ranahaqnawaz634-design/physical-road-condition-/blob/main/src/components/ArchitectureFlowDiagram.tsx"
click node_intelligence "https://github.com/ranahaqnawaz634-design/physical-road-condition-/blob/main/src/components/ConditionIntelligenceGap.tsx"
click node_condition "https://github.com/ranahaqnawaz634-design/physical-road-condition-/blob/main/src/components/ConditionAssessmentDashboard.tsx"
click node_microstructure "https://github.com/ranahaqnawaz634-design/physical-road-condition-/blob/main/src/components/MicrostructureCanvas.tsx"
click node_playback "https://github.com/ranahaqnawaz634-design/physical-road-condition-/blob/main/src/components/SimulationPlaybackBar.tsx"
click node_benchmark "https://github.com/ranahaqnawaz634-design/physical-road-condition-/blob/main/src/components/BenchmarkComparisonLab.tsx"
click node_plots "https://github.com/ranahaqnawaz634-design/physical-road-condition-/blob/main/src/components/DataAnalyticsPlots.tsx"
click node_training "https://github.com/ranahaqnawaz634-design/physical-road-condition-/blob/main/src/components/PinnTrainingLab.tsx"
click node_model "https://github.com/ranahaqnawaz634-design/physical-road-condition-/blob/main/src/utils/pinnModel.ts"
click node_deepxde "https://github.com/ranahaqnawaz634-design/physical-road-condition-/blob/main/src/components/DeepXdeLab.tsx"
click node_report "https://github.com/ranahaqnawaz634-design/physical-road-condition-/blob/main/src/components/AiEngineeringReportModal.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 toneBlue
class node_sensor,node_datasets,node_csv,node_parser,node_physics toneAmber
class node_architecture,node_intelligence,node_condition,node_microstructure,node_playback toneMint
class node_benchmark,node_plots,node_training,node_model,node_deepxde,node_report toneRose
class node_user toneIndigo
```

## Components

### Platform Shell

- [Application shell](https://github.com/ranahaqnawaz634-design/physical-road-condition-/blob/main/src/App.tsx): `src/App.tsx`

### Data and Physics

- [Sensor data types](https://github.com/ranahaqnawaz634-design/physical-road-condition-/blob/main/src/types/pinn.ts): `src/types/pinn.ts`
- [Benchmark datasets](https://github.com/ranahaqnawaz634-design/physical-road-condition-/blob/main/src/utils/benchmarkDatasets.ts): `src/utils/benchmarkDatasets.ts`
- [CSV ingestion](https://github.com/ranahaqnawaz634-design/physical-road-condition-/blob/main/src/components/CsvUploader.tsx): `src/components/CsvUploader.tsx`
- [CSV parser](https://github.com/ranahaqnawaz634-design/physical-road-condition-/blob/main/src/utils/csvParser.ts): `src/utils/csvParser.ts`
- [Physics engine](https://github.com/ranahaqnawaz634-design/physical-road-condition-/blob/main/src/utils/physicsEngine.ts): `src/utils/physicsEngine.ts`

### Assessment Views

- [Architecture flow](https://github.com/ranahaqnawaz634-design/physical-road-condition-/blob/main/src/components/ArchitectureFlowDiagram.tsx): `src/components/ArchitectureFlowDiagram.tsx`
- [Condition intelligence](https://github.com/ranahaqnawaz634-design/physical-road-condition-/blob/main/src/components/ConditionIntelligenceGap.tsx): `src/components/ConditionIntelligenceGap.tsx`
- [Condition assessment](https://github.com/ranahaqnawaz634-design/physical-road-condition-/blob/main/src/components/ConditionAssessmentDashboard.tsx): `src/components/ConditionAssessmentDashboard.tsx`
- [Microstructure view](https://github.com/ranahaqnawaz634-design/physical-road-condition-/blob/main/src/components/MicrostructureCanvas.tsx): `src/components/MicrostructureCanvas.tsx`
- [Simulation playback](https://github.com/ranahaqnawaz634-design/physical-road-condition-/blob/main/src/components/SimulationPlaybackBar.tsx): `src/components/SimulationPlaybackBar.tsx`

### Analysis and Reporting

- [Benchmark comparison](https://github.com/ranahaqnawaz634-design/physical-road-condition-/blob/main/src/components/BenchmarkComparisonLab.tsx): `src/components/BenchmarkComparisonLab.tsx`
- [Analytics plots](https://github.com/ranahaqnawaz634-design/physical-road-condition-/blob/main/src/components/DataAnalyticsPlots.tsx): `src/components/DataAnalyticsPlots.tsx`
- [PINN training lab](https://github.com/ranahaqnawaz634-design/physical-road-condition-/blob/main/src/components/PinnTrainingLab.tsx): `src/components/PinnTrainingLab.tsx`
- [PINN model](https://github.com/ranahaqnawaz634-design/physical-road-condition-/blob/main/src/utils/pinnModel.ts): `src/utils/pinnModel.ts`
- [DeepXDE lab](https://github.com/ranahaqnawaz634-design/physical-road-condition-/blob/main/src/components/DeepXdeLab.tsx): `src/components/DeepXdeLab.tsx`
- [Engineering report](https://github.com/ranahaqnawaz634-design/physical-road-condition-/blob/main/src/components/AiEngineeringReportModal.tsx): `src/components/AiEngineeringReportModal.tsx`

### Other components

- **Engineer**

## Connections

- Engineer → Application shell: uses (evidence: `README.md`)
- Application shell → Benchmark datasets: selects dataset (evidence: `src/App.tsx`)
- Application shell → CSV ingestion: opens ingestion (evidence: `src/App.tsx`)
- CSV ingestion → CSV parser: parses CSV (evidence: `src/components/CsvUploader.tsx`)
- CSV parser → Physics engine: calculates resistance (evidence: `src/utils/csvParser.ts`)
- Application shell → Architecture flow: shows view (evidence: `src/App.tsx`)
- Application shell → Condition intelligence: shows view (evidence: `src/App.tsx`)
- Application shell → Condition assessment: shows view (evidence: `src/App.tsx`)
- Application shell → Microstructure view: shows view (evidence: `src/App.tsx`)
- Application shell → Benchmark comparison: shows view (evidence: `src/App.tsx`)
- Application shell → Analytics plots: shows view (evidence: `src/App.tsx`)
- Application shell → PINN training lab: shows view (evidence: `src/App.tsx`)
- Application shell → DeepXDE lab: shows view (evidence: `src/App.tsx`)
- Application shell → Engineering report: opens report (evidence: `src/App.tsx`)
- PINN training lab → PINN model: uses model (evidence: `src/components/PinnTrainingLab.tsx`)
- Benchmark datasets → Physics engine: calculates resistance (evidence: `src/utils/benchmarkDatasets.ts`)
