# shriiraam008/portfolio architecture

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

- Interactive diagram: https://gitdiagram.com/shriiraam008/portfolio
- Repository: https://github.com/shriiraam008/portfolio

## Overview

This is a multi-project portfolio rather than one integrated application. Its clearest user workflows are operating the EdgeSense factory twin through a dashboard and controlling or monitoring the RoomPulse indoor-environment twin. The README also identifies robotics, street-light monitoring, and Samkriya as separate products; their internals are only partly represented in the supplied evidence. Edges cite shown source references or documented capabilities; uncertain integration details are omitted.

Main entry points: [`MBA/Operations/ICIDTSM/DT IITM Sim/backend/app/main.py`](https://github.com/shriiraam008/portfolio/blob/main/MBA/Operations/ICIDTSM/DT%20IITM%20Sim/backend/app/main.py) (RoomPulse API), [`MBA/Operations/Edgesense Digital Twin/frontend/src/App.jsx`](https://github.com/shriiraam008/portfolio/blob/main/MBA/Operations/Edgesense%20Digital%20Twin/frontend/src/App.jsx) (Factory Dashboard), [`MBA/Operations/Edgesense Digital Twin/app/services/simulation_service.py`](https://github.com/shriiraam008/portfolio/blob/main/MBA/Operations/Edgesense%20Digital%20Twin/app/services/simulation_service.py) (Simulation Service), [`MBA/Operations/Edgesense Digital Twin/app/api/routes.py`](https://github.com/shriiraam008/portfolio/blob/main/MBA/Operations/Edgesense%20Digital%20Twin/app/api/routes.py) (API Routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_edgesense["EdgeSense Twin"]
  node_edge_ui["Factory Dashboard<br/>[App.jsx]"]
  node_edge_api["API Routes<br/>[routes.py]"]
  node_edge_service["Simulation Service"]
  node_factory_engine["Factory Engine<br/>[engine.py]"]
  node_domain_models["Factory Models<br/>[models.py]"]
  node_run_store[("Run Repository")]
  node_scenario_controls["Scenario Controls"]
  node_factory_views["Factory Views<br/>[FactoryView3D.jsx]"]
  node_factory_insights["Twin Insights"]
end

subgraph group_roompulse["RoomPulse Twin"]
  node_room_ui["RoomPulse Dashboard<br/>[App.tsx]"]
  node_room_api["RoomPulse API<br/>[main.py]"]
  node_room_engine["Room Simulation<br/>[simulation.py]"]
  node_room_analytics["Room Analytics<br/>[analytics.py]"]
  node_room_store[("Session Store<br/>[database.py]")]
  node_room_hardware["Sensor Hardware"]
end

subgraph group_engineering["Engineering Systems"]
  node_robot_platform["Mobile Robot"]
  node_street_lights["Street Light Monitor<br/>[app.py]"]
end

subgraph group_operations["Operations Work"]
  node_samkriya["Samkriya Work<br/>[app.py]"]
end

node_operator(("Operator"))
node_portfolio_reader(("Portfolio Reader"))

node_operator -->|"operates"| node_edge_ui
node_edge_ui -->|"requests data"| node_edge_api
node_edge_api -->|"dispatches"| node_edge_service
node_edge_service -->|"runs simulation"| node_factory_engine
node_edge_service -->|"persists runs"| node_run_store
node_factory_engine -->|"uses models"| node_domain_models
node_edge_ui -->|"renders"| node_scenario_controls
node_edge_ui -->|"renders"| node_factory_views
node_edge_service -->|"uses twin modules"| node_factory_insights
node_operator -->|"controls"| node_room_ui
node_room_ui -.->|"streams and requests"| node_room_api
node_room_api -->|"steps and controls"| node_room_engine
node_room_api -->|"queries sessions"| node_room_store
node_room_api -->|"serves analytics"| node_room_analytics
node_room_hardware -.->|"sends readings"| node_room_api
node_portfolio_reader -->|"explores"| node_robot_platform
node_portfolio_reader -->|"explores"| node_street_lights
node_portfolio_reader -->|"explores"| node_samkriya

click node_edge_ui "https://github.com/shriiraam008/portfolio/blob/main/MBA/Operations/Edgesense%20Digital%20Twin/frontend/src/App.jsx"
click node_edge_api "https://github.com/shriiraam008/portfolio/blob/main/MBA/Operations/Edgesense%20Digital%20Twin/app/api/routes.py"
click node_edge_service "https://github.com/shriiraam008/portfolio/blob/main/MBA/Operations/Edgesense%20Digital%20Twin/app/services/simulation_service.py"
click node_factory_engine "https://github.com/shriiraam008/portfolio/blob/main/MBA/Operations/Edgesense%20Digital%20Twin/edgesense_twin/engine.py"
click node_domain_models "https://github.com/shriiraam008/portfolio/blob/main/MBA/Operations/Edgesense%20Digital%20Twin/edgesense_twin/models.py"
click node_run_store "https://github.com/shriiraam008/portfolio/blob/main/MBA/Operations/Edgesense%20Digital%20Twin/app/services/simulation_repository.py"
click node_scenario_controls "https://github.com/shriiraam008/portfolio/blob/main/MBA/Operations/Edgesense%20Digital%20Twin/frontend/src/components/ScenarioManager.jsx"
click node_factory_views "https://github.com/shriiraam008/portfolio/blob/main/MBA/Operations/Edgesense%20Digital%20Twin/frontend/src/components/FactoryView3D.jsx"
click node_factory_insights "https://github.com/shriiraam008/portfolio/tree/main/MBA/Operations/Edgesense%20Digital%20Twin/edgesense_twin"
click node_room_ui "https://github.com/shriiraam008/portfolio/blob/main/MBA/Operations/ICIDTSM/DT%20IITM%20Sim/frontend/src/App.tsx"
click node_room_api "https://github.com/shriiraam008/portfolio/blob/main/MBA/Operations/ICIDTSM/DT%20IITM%20Sim/backend/app/main.py"
click node_room_engine "https://github.com/shriiraam008/portfolio/blob/main/MBA/Operations/ICIDTSM/DT%20IITM%20Sim/backend/app/simulation.py"
click node_room_analytics "https://github.com/shriiraam008/portfolio/blob/main/MBA/Operations/ICIDTSM/DT%20IITM%20Sim/backend/app/analytics.py"
click node_room_store "https://github.com/shriiraam008/portfolio/blob/main/MBA/Operations/ICIDTSM/DT%20IITM%20Sim/backend/app/database.py"
click node_room_hardware "https://github.com/shriiraam008/portfolio/tree/main/MBA/Operations/ICIDTSM/DT%20IITM%20Sim/hardware/esp32_room_node"
click node_robot_platform "https://github.com/shriiraam008/portfolio/tree/main/Engineering/Autonomous%20Mobile%20Platform/articubot_one-new_gazebo/launch"
click node_street_lights "https://github.com/shriiraam008/portfolio/blob/main/Engineering/Centralized%20Street%20Light%20Monitoring%20System/Street%20Light%20Monitoring%20Server/app.py"
click node_samkriya "https://github.com/shriiraam008/portfolio/blob/main/MBA/Operations/Samkriya/app.py"

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_edge_ui,node_edge_api,node_edge_service,node_factory_engine,node_domain_models,node_run_store,node_scenario_controls,node_factory_views,node_factory_insights toneBlue
class node_room_ui,node_room_api,node_room_engine,node_room_analytics,node_room_store,node_room_hardware toneAmber
class node_robot_platform,node_street_lights toneMint
class node_samkriya toneRose
class node_operator,node_portfolio_reader toneIndigo
```

## Components

### EdgeSense Twin

- [Factory Dashboard](https://github.com/shriiraam008/portfolio/blob/main/MBA/Operations/Edgesense%20Digital%20Twin/frontend/src/App.jsx): `MBA/Operations/Edgesense Digital Twin/frontend/src/App.jsx`
- [API Routes](https://github.com/shriiraam008/portfolio/blob/main/MBA/Operations/Edgesense%20Digital%20Twin/app/api/routes.py): `MBA/Operations/Edgesense Digital Twin/app/api/routes.py`
- [Simulation Service](https://github.com/shriiraam008/portfolio/blob/main/MBA/Operations/Edgesense%20Digital%20Twin/app/services/simulation_service.py): `MBA/Operations/Edgesense Digital Twin/app/services/simulation_service.py`
- [Factory Engine](https://github.com/shriiraam008/portfolio/blob/main/MBA/Operations/Edgesense%20Digital%20Twin/edgesense_twin/engine.py): `MBA/Operations/Edgesense Digital Twin/edgesense_twin/engine.py`
- [Factory Models](https://github.com/shriiraam008/portfolio/blob/main/MBA/Operations/Edgesense%20Digital%20Twin/edgesense_twin/models.py): `MBA/Operations/Edgesense Digital Twin/edgesense_twin/models.py`
- [Run Repository](https://github.com/shriiraam008/portfolio/blob/main/MBA/Operations/Edgesense%20Digital%20Twin/app/services/simulation_repository.py): `MBA/Operations/Edgesense Digital Twin/app/services/simulation_repository.py`
- [Scenario Controls](https://github.com/shriiraam008/portfolio/blob/main/MBA/Operations/Edgesense%20Digital%20Twin/frontend/src/components/ScenarioManager.jsx): `MBA/Operations/Edgesense Digital Twin/frontend/src/components/ScenarioManager.jsx`
- [Factory Views](https://github.com/shriiraam008/portfolio/blob/main/MBA/Operations/Edgesense%20Digital%20Twin/frontend/src/components/FactoryView3D.jsx): `MBA/Operations/Edgesense Digital Twin/frontend/src/components/FactoryView3D.jsx`
- [Twin Insights](https://github.com/shriiraam008/portfolio/tree/main/MBA/Operations/Edgesense%20Digital%20Twin/edgesense_twin): `MBA/Operations/Edgesense Digital Twin/edgesense_twin`

### RoomPulse Twin

- [RoomPulse Dashboard](https://github.com/shriiraam008/portfolio/blob/main/MBA/Operations/ICIDTSM/DT%20IITM%20Sim/frontend/src/App.tsx): `MBA/Operations/ICIDTSM/DT IITM Sim/frontend/src/App.tsx`
- [RoomPulse API](https://github.com/shriiraam008/portfolio/blob/main/MBA/Operations/ICIDTSM/DT%20IITM%20Sim/backend/app/main.py): `MBA/Operations/ICIDTSM/DT IITM Sim/backend/app/main.py`
- [Room Simulation](https://github.com/shriiraam008/portfolio/blob/main/MBA/Operations/ICIDTSM/DT%20IITM%20Sim/backend/app/simulation.py): `MBA/Operations/ICIDTSM/DT IITM Sim/backend/app/simulation.py`
- [Room Analytics](https://github.com/shriiraam008/portfolio/blob/main/MBA/Operations/ICIDTSM/DT%20IITM%20Sim/backend/app/analytics.py): `MBA/Operations/ICIDTSM/DT IITM Sim/backend/app/analytics.py`
- [Session Store](https://github.com/shriiraam008/portfolio/blob/main/MBA/Operations/ICIDTSM/DT%20IITM%20Sim/backend/app/database.py): `MBA/Operations/ICIDTSM/DT IITM Sim/backend/app/database.py`
- [Sensor Hardware](https://github.com/shriiraam008/portfolio/tree/main/MBA/Operations/ICIDTSM/DT%20IITM%20Sim/hardware/esp32_room_node): `MBA/Operations/ICIDTSM/DT IITM Sim/hardware/esp32_room_node`

### Engineering Systems

- [Mobile Robot](https://github.com/shriiraam008/portfolio/tree/main/Engineering/Autonomous%20Mobile%20Platform/articubot_one-new_gazebo/launch): `Engineering/Autonomous Mobile Platform/articubot_one-new_gazebo/launch`
- [Street Light Monitor](https://github.com/shriiraam008/portfolio/blob/main/Engineering/Centralized%20Street%20Light%20Monitoring%20System/Street%20Light%20Monitoring%20Server/app.py): `Engineering/Centralized Street Light Monitoring System/Street Light Monitoring Server/app.py`

### Operations Work

- [Samkriya Work](https://github.com/shriiraam008/portfolio/blob/main/MBA/Operations/Samkriya/app.py): `MBA/Operations/Samkriya/app.py`

### Other components

- **Operator**
- **Portfolio Reader**

## Connections

- Operator → Factory Dashboard: operates
- Factory Dashboard → API Routes: requests data (evidence: `MBA/Operations/Edgesense Digital Twin/frontend/src/App.jsx`)
- API Routes → Simulation Service: dispatches (evidence: `MBA/Operations/Edgesense Digital Twin/app/api/routes.py`)
- Simulation Service → Factory Engine: runs simulation (evidence: `MBA/Operations/Edgesense Digital Twin/app/services/simulation_service.py`)
- Simulation Service → Run Repository: persists runs (evidence: `MBA/Operations/Edgesense Digital Twin/app/services/simulation_service.py`)
- Factory Engine → Factory Models: uses models (evidence: `MBA/Operations/Edgesense Digital Twin/edgesense_twin/engine.py`)
- Factory Dashboard → Scenario Controls: renders (evidence: `MBA/Operations/Edgesense Digital Twin/frontend/src/App.jsx`)
- Factory Dashboard → Factory Views: renders (evidence: `MBA/Operations/Edgesense Digital Twin/frontend/src/App.jsx`)
- Simulation Service → Twin Insights: uses twin modules (evidence: `MBA/Operations/Edgesense Digital Twin/app/services/simulation_service.py`)
- Operator → RoomPulse Dashboard: controls
- RoomPulse Dashboard → RoomPulse API: streams and requests
- RoomPulse API → Room Simulation: steps and controls (evidence: `MBA/Operations/ICIDTSM/DT IITM Sim/backend/app/main.py`)
- RoomPulse API → Session Store: queries sessions (evidence: `MBA/Operations/ICIDTSM/DT IITM Sim/backend/app/main.py`)
- RoomPulse API → Room Analytics: serves analytics (evidence: `MBA/Operations/ICIDTSM/DT IITM Sim/backend/app/main.py`)
- Sensor Hardware → RoomPulse API: sends readings
- Portfolio Reader → Mobile Robot: explores
- Portfolio Reader → Street Light Monitor: explores
- Portfolio Reader → Samkriya Work: explores
