# sahana-652/ssm architecture

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

- Interactive diagram: https://gitdiagram.com/sahana-652/ssm
- Repository: https://github.com/sahana-652/ssm

## Overview

SSM is a discrete-event simulation of a fast-food drive-through, comparing one to three service windows under normal and peak arrivals. Users configure a run through either the Streamlit interface or CLI; both invoke the shared six-scenario runner, which executes the customer/queue simulation and produces KPIs and queue timelines. Results are presented as tables, CSV, and comparison plots. The sampled sources show these calls and data flows; the README gives no additional capability details.

Main entry points: [`main.py`](https://github.com/sahana-652/ssm/blob/main/main.py) (Command line), [`app.py`](https://github.com/sahana-652/ssm/blob/main/app.py) (Web interface), [`simulation.py`](https://github.com/sahana-652/ssm/blob/main/simulation.py) (DES engine), [`scenario_runner.py`](https://github.com/sahana-652/ssm/blob/main/scenario_runner.py) (Six-scenario batch)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interfaces["Run interfaces"]
  node_streamlit["Web interface<br/>[app.py]"]
  node_cli["Command line<br/>[main.py]"]
end

subgraph group_experiments["Scenario experiments"]
  node_configuration["Run configuration<br/>[config.py]"]
  node_scenario_batch["Six-scenario batch<br/>[scenario_runner.py]"]
end

subgraph group_model["Simulation model"]
  node_des_engine["DES engine<br/>[simulation.py]"]
  node_customer_entities["Customer entities<br/>[customer.py]"]
  node_queue_tracking["FIFO queue tracking<br/>[queue_manager.py]"]
end

subgraph group_reporting["Results and reporting"]
  node_kpi_tracking["KPI tracking<br/>[metrics.py]"]
  node_plotting["Charts<br/>[visualization.py]"]
  node_csv_file["Scenario results CSV"]
end

node_user(("User"))

node_user -->|"sets parameters"| node_streamlit
node_user -->|"starts run"| node_cli
node_streamlit -->|"builds config"| node_configuration
node_cli -->|"creates config"| node_configuration
node_streamlit -->|"runs scenarios"| node_scenario_batch
node_cli -->|"runs scenarios"| node_scenario_batch
node_scenario_batch -->|"runs replications"| node_des_engine
node_des_engine -->|"creates customers"| node_customer_entities
node_des_engine -->|"updates queue"| node_queue_tracking
node_des_engine -->|"records outcomes"| node_kpi_tracking
node_scenario_batch -->|"accepts config"| node_configuration
node_streamlit -->|"formats results"| node_kpi_tracking
node_cli -->|"formats and exports"| node_kpi_tracking
node_streamlit -->|"renders charts"| node_plotting
node_cli -->|"generates figures"| node_plotting
node_cli -->|"writes CSV"| node_csv_file

click node_streamlit "https://github.com/sahana-652/ssm/blob/main/app.py"
click node_cli "https://github.com/sahana-652/ssm/blob/main/main.py"
click node_configuration "https://github.com/sahana-652/ssm/blob/main/config.py"
click node_scenario_batch "https://github.com/sahana-652/ssm/blob/main/scenario_runner.py"
click node_des_engine "https://github.com/sahana-652/ssm/blob/main/simulation.py"
click node_customer_entities "https://github.com/sahana-652/ssm/blob/main/customer.py"
click node_queue_tracking "https://github.com/sahana-652/ssm/blob/main/queue_manager.py"
click node_kpi_tracking "https://github.com/sahana-652/ssm/blob/main/metrics.py"
click node_plotting "https://github.com/sahana-652/ssm/blob/main/visualization.py"
click node_csv_file "https://github.com/sahana-652/ssm/blob/main/outputs/scenario_results.csv"

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_streamlit,node_cli,node_user toneBlue
class node_configuration,node_scenario_batch toneAmber
class node_des_engine,node_customer_entities,node_queue_tracking toneMint
class node_kpi_tracking,node_plotting,node_csv_file toneRose
```

## Components

### Run interfaces

- [Web interface](https://github.com/sahana-652/ssm/blob/main/app.py): `app.py`
- [Command line](https://github.com/sahana-652/ssm/blob/main/main.py): `main.py`

### Scenario experiments

- [Run configuration](https://github.com/sahana-652/ssm/blob/main/config.py): `config.py`
- [Six-scenario batch](https://github.com/sahana-652/ssm/blob/main/scenario_runner.py): `scenario_runner.py`

### Simulation model

- [DES engine](https://github.com/sahana-652/ssm/blob/main/simulation.py): `simulation.py`
- [Customer entities](https://github.com/sahana-652/ssm/blob/main/customer.py): `customer.py`
- [FIFO queue tracking](https://github.com/sahana-652/ssm/blob/main/queue_manager.py): `queue_manager.py`

### Results and reporting

- [KPI tracking](https://github.com/sahana-652/ssm/blob/main/metrics.py): `metrics.py`
- [Charts](https://github.com/sahana-652/ssm/blob/main/visualization.py): `visualization.py`
- [Scenario results CSV](https://github.com/sahana-652/ssm/blob/main/outputs/scenario_results.csv): `outputs/scenario_results.csv`

### Other components

- **User**

## Connections

- User → Web interface: sets parameters (evidence: `app.py`)
- User → Command line: starts run (evidence: `main.py`)
- Web interface → Run configuration: builds config (evidence: `app.py`)
- Command line → Run configuration: creates config (evidence: `main.py`)
- Web interface → Six-scenario batch: runs scenarios (evidence: `app.py`)
- Command line → Six-scenario batch: runs scenarios (evidence: `main.py`)
- Six-scenario batch → DES engine: runs replications (evidence: `scenario_runner.py`)
- DES engine → Customer entities: creates customers (evidence: `simulation.py`)
- DES engine → FIFO queue tracking: updates queue (evidence: `simulation.py`)
- DES engine → KPI tracking: records outcomes (evidence: `simulation.py`)
- Six-scenario batch → Run configuration: accepts config (evidence: `scenario_runner.py`)
- Web interface → KPI tracking: formats results (evidence: `app.py`)
- Command line → KPI tracking: formats and exports (evidence: `main.py`)
- Web interface → Charts: renders charts (evidence: `app.py`)
- Command line → Charts: generates figures (evidence: `main.py`)
- Command line → Scenario results CSV: writes CSV (evidence: `main.py`)
