# nopleasenorbi/arkheia architecture

> Architecture diagram of the GitHub repository nopleasenorbi/arkheia, 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/nopleasenorbi/arkheia
- Repository: https://github.com/nopleasenorbi/arkheia

## Overview

Arkheia is a web application for analyzing simulation runs and their results. Users can browse runs, inspect a run’s parameters, stimuli, experimental protocols and results, and explore parameter searches; the UI also exposes result inspection and documentation. The backend routes requests to controllers, which manage simulation and associated domain records in MongoDB, while figures and stimulus movies use GridFS. The graph follows documented routes and indexed imports; frontend-to-API request wiring is not shown in the excerpts, so that connection is omitted.

Main entry points: [`frontend/src/App.js`](https://github.com/nopleasenorbi/arkheia/blob/main/frontend/src/App.js) (Page router), [`server/server.js`](https://github.com/nopleasenorbi/arkheia/blob/main/server/server.js) (Express server), [`server/controllers/simulationRunsController.js`](https://github.com/nopleasenorbi/arkheia/blob/main/server/controllers/simulationRunsController.js) (Run controller), [`server/models/simulation_run_model.js`](https://github.com/nopleasenorbi/arkheia/blob/main/server/models/simulation_run_model.js) (Simulation records)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web client"]
  node_app["Page router<br/>[App.js]"]
  node_navbar["Navigation<br/>[NavBar.js]"]
  node_simulations["Simulation browser<br/>[Simulations.js]"]
  node_simulation_details["Run details"]
  node_lone_simulation["Run detail links<br/>[LoneSimulation.js]"]
  node_parameters_page["Parameters view<br/>[ParametersById.js]"]
  node_stimuli_page["Stimuli view<br/>[StimuliById.js]"]
  node_protocols_page["Protocol view"]
  node_results_page["Results view<br/>[ResultsById.js]"]
  node_inspect_results["Result inspection<br/>[InspectResults.js]"]
  node_parameter_search["Parameter search<br/>[ParameterSearch.js]"]
  node_search_detail["Search details"]
end

subgraph group_api["API routing"]
  node_server["Express server<br/>[server.js]"]
  node_simulation_routes["Simulation routes<br/>[simulation_runs.js]"]
  node_stimuli_routes["Stimuli routes<br/>[stimuli.js]"]
  node_protocol_routes["Protocol routes<br/>[exp_protocols.js]"]
  node_records_routes["Record routes<br/>[records.js]"]
  node_results_routes["Result routes<br/>[results.js]"]
  node_search_routes["Search routes"]
end

subgraph group_domain["Simulation domain"]
  node_simulation_controller["Run controller"]
  node_stimuli_controller["Stimulus controller"]
  node_protocol_controller["Protocol controller"]
  node_records_controller["Record controller"]
  node_results_controller["Result controller"]
  node_search_controller["Search controller"]
  node_simulation_model[("Simulation records")]
  node_stimuli_model[("Stimulus records<br/>[stimuli_model.js]")]
  node_protocol_model[("Protocol records")]
  node_records_model[("Record entries<br/>[records_model.js]")]
  node_results_model[("Result entries<br/>[results_model.js]")]
  node_search_model[("Search records")]
end

subgraph group_assets["File assets"]
  node_file_controller["GridFS file access"]
  node_gridfs[("MongoDB GridFS")]
end

node_user(("Analyst"))

node_user -.->|"uses"| node_app
node_app -->|"renders"| node_navbar
node_app -->|"routes to"| node_simulations
node_app -->|"routes to"| node_lone_simulation
node_app -->|"routes to"| node_parameters_page
node_app -->|"routes to"| node_stimuli_page
node_app -->|"routes to"| node_protocols_page
node_app -->|"routes to"| node_results_page
node_app -->|"routes to"| node_inspect_results
node_app -->|"routes to"| node_parameter_search
node_simulations -->|"renders"| node_simulation_details
node_lone_simulation -->|"links to"| node_parameters_page
node_lone_simulation -->|"links to"| node_stimuli_page
node_lone_simulation -->|"links to"| node_protocols_page
node_lone_simulation -->|"links to"| node_results_page
node_stimuli_page -->|"renders table"| node_app
node_protocols_page -->|"renders tables"| node_app
node_results_page -->|"renders table"| node_app
node_parameter_search -->|"renders"| node_search_detail
node_server -->|"mounts"| node_simulation_routes
node_server -->|"mounts"| node_stimuli_routes
node_server -->|"mounts"| node_protocol_routes
node_server -->|"mounts"| node_records_routes
node_server -->|"mounts"| node_results_routes
node_server -->|"mounts"| node_search_routes
node_simulation_routes -->|"dispatches"| node_simulation_controller
node_stimuli_routes -->|"dispatches"| node_stimuli_controller
node_protocol_routes -->|"dispatches"| node_protocol_controller
node_records_routes -->|"dispatches"| node_records_controller
node_results_routes -->|"dispatches"| node_results_controller
node_results_routes -->|"dispatches"| node_file_controller
node_stimuli_routes -->|"dispatches"| node_file_controller
node_search_routes -->|"dispatches"| node_search_controller
node_simulation_controller -->|"reads/writes"| node_simulation_model
node_simulation_controller -->|"reads/deletes"| node_stimuli_model
node_simulation_controller -->|"reads/deletes"| node_protocol_model
node_simulation_controller -->|"reads/deletes"| node_records_model
node_simulation_controller -->|"reads/deletes"| node_results_model
node_stimuli_controller -->|"populates"| node_simulation_model
node_stimuli_controller -->|"reads/writes"| node_stimuli_model
node_protocol_controller -->|"reads"| node_simulation_model
node_protocol_controller -->|"reads"| node_protocol_model
node_records_controller -->|"reads"| node_simulation_model
node_records_controller -->|"reads"| node_records_model
node_results_controller -->|"populates"| node_simulation_model
node_results_controller -->|"reads/writes"| node_results_model
node_search_controller -->|"reads/writes"| node_search_model
node_search_controller -->|"reads/writes"| node_simulation_model

click node_app "https://github.com/nopleasenorbi/arkheia/blob/main/frontend/src/App.js"
click node_navbar "https://github.com/nopleasenorbi/arkheia/blob/main/frontend/src/components/NavBar.js"
click node_simulations "https://github.com/nopleasenorbi/arkheia/blob/main/frontend/src/pages/Simulations.js"
click node_simulation_details "https://github.com/nopleasenorbi/arkheia/blob/main/frontend/src/components/SimulationDetails.js"
click node_lone_simulation "https://github.com/nopleasenorbi/arkheia/blob/main/frontend/src/pages/LoneSimulation.js"
click node_parameters_page "https://github.com/nopleasenorbi/arkheia/blob/main/frontend/src/pages/ParametersById.js"
click node_stimuli_page "https://github.com/nopleasenorbi/arkheia/blob/main/frontend/src/pages/StimuliById.js"
click node_protocols_page "https://github.com/nopleasenorbi/arkheia/blob/main/frontend/src/pages/ExpProtocolsById.js"
click node_results_page "https://github.com/nopleasenorbi/arkheia/blob/main/frontend/src/pages/ResultsById.js"
click node_inspect_results "https://github.com/nopleasenorbi/arkheia/blob/main/frontend/src/pages/InspectResults.js"
click node_parameter_search "https://github.com/nopleasenorbi/arkheia/blob/main/frontend/src/pages/ParameterSearch.js"
click node_search_detail "https://github.com/nopleasenorbi/arkheia/blob/main/frontend/src/components/ParameterSearchDetail.js"
click node_server "https://github.com/nopleasenorbi/arkheia/blob/main/server/server.js"
click node_simulation_routes "https://github.com/nopleasenorbi/arkheia/blob/main/server/routes/simulation_runs.js"
click node_stimuli_routes "https://github.com/nopleasenorbi/arkheia/blob/main/server/routes/stimuli.js"
click node_protocol_routes "https://github.com/nopleasenorbi/arkheia/blob/main/server/routes/exp_protocols.js"
click node_records_routes "https://github.com/nopleasenorbi/arkheia/blob/main/server/routes/records.js"
click node_results_routes "https://github.com/nopleasenorbi/arkheia/blob/main/server/routes/results.js"
click node_search_routes "https://github.com/nopleasenorbi/arkheia/blob/main/server/routes/parameter_searches.js"
click node_simulation_controller "https://github.com/nopleasenorbi/arkheia/blob/main/server/controllers/simulationRunsController.js"
click node_stimuli_controller "https://github.com/nopleasenorbi/arkheia/blob/main/server/controllers/stimuliController.js"
click node_protocol_controller "https://github.com/nopleasenorbi/arkheia/blob/main/server/controllers/ExpProtocolController.js"
click node_records_controller "https://github.com/nopleasenorbi/arkheia/blob/main/server/controllers/recordsController.js"
click node_results_controller "https://github.com/nopleasenorbi/arkheia/blob/main/server/controllers/resultsController.js"
click node_search_controller "https://github.com/nopleasenorbi/arkheia/blob/main/server/controllers/parameterSearchController.js"
click node_simulation_model "https://github.com/nopleasenorbi/arkheia/blob/main/server/models/simulation_run_model.js"
click node_stimuli_model "https://github.com/nopleasenorbi/arkheia/blob/main/server/models/stimuli_model.js"
click node_protocol_model "https://github.com/nopleasenorbi/arkheia/blob/main/server/models/exp_protocol_model.js"
click node_records_model "https://github.com/nopleasenorbi/arkheia/blob/main/server/models/records_model.js"
click node_results_model "https://github.com/nopleasenorbi/arkheia/blob/main/server/models/results_model.js"
click node_search_model "https://github.com/nopleasenorbi/arkheia/blob/main/server/models/parameter_search_model.js"
click node_file_controller "https://github.com/nopleasenorbi/arkheia/blob/main/server/controllers/fileGridfsController.js"

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_navbar,node_simulations,node_simulation_details,node_lone_simulation,node_parameters_page,node_stimuli_page,node_protocols_page,node_results_page,node_inspect_results,node_parameter_search,node_search_detail toneBlue
class node_server,node_simulation_routes,node_stimuli_routes,node_protocol_routes,node_records_routes,node_results_routes,node_search_routes toneAmber
class node_simulation_controller,node_stimuli_controller,node_protocol_controller,node_records_controller,node_results_controller,node_search_controller,node_simulation_model,node_stimuli_model,node_protocol_model,node_records_model,node_results_model,node_search_model toneMint
class node_file_controller,node_gridfs toneRose
class node_user toneIndigo
```

## Components

### Web client

- [Page router](https://github.com/nopleasenorbi/arkheia/blob/main/frontend/src/App.js): `frontend/src/App.js`
- [Navigation](https://github.com/nopleasenorbi/arkheia/blob/main/frontend/src/components/NavBar.js): `frontend/src/components/NavBar.js`
- [Simulation browser](https://github.com/nopleasenorbi/arkheia/blob/main/frontend/src/pages/Simulations.js): `frontend/src/pages/Simulations.js`
- [Run details](https://github.com/nopleasenorbi/arkheia/blob/main/frontend/src/components/SimulationDetails.js): `frontend/src/components/SimulationDetails.js`
- [Run detail links](https://github.com/nopleasenorbi/arkheia/blob/main/frontend/src/pages/LoneSimulation.js): `frontend/src/pages/LoneSimulation.js`
- [Parameters view](https://github.com/nopleasenorbi/arkheia/blob/main/frontend/src/pages/ParametersById.js): `frontend/src/pages/ParametersById.js`
- [Stimuli view](https://github.com/nopleasenorbi/arkheia/blob/main/frontend/src/pages/StimuliById.js): `frontend/src/pages/StimuliById.js`
- [Protocol view](https://github.com/nopleasenorbi/arkheia/blob/main/frontend/src/pages/ExpProtocolsById.js): `frontend/src/pages/ExpProtocolsById.js`
- [Results view](https://github.com/nopleasenorbi/arkheia/blob/main/frontend/src/pages/ResultsById.js): `frontend/src/pages/ResultsById.js`
- [Result inspection](https://github.com/nopleasenorbi/arkheia/blob/main/frontend/src/pages/InspectResults.js): `frontend/src/pages/InspectResults.js`
- [Parameter search](https://github.com/nopleasenorbi/arkheia/blob/main/frontend/src/pages/ParameterSearch.js): `frontend/src/pages/ParameterSearch.js`
- [Search details](https://github.com/nopleasenorbi/arkheia/blob/main/frontend/src/components/ParameterSearchDetail.js): `frontend/src/components/ParameterSearchDetail.js`

### API routing

- [Express server](https://github.com/nopleasenorbi/arkheia/blob/main/server/server.js): `server/server.js`
- [Simulation routes](https://github.com/nopleasenorbi/arkheia/blob/main/server/routes/simulation_runs.js): `server/routes/simulation_runs.js`
- [Stimuli routes](https://github.com/nopleasenorbi/arkheia/blob/main/server/routes/stimuli.js): `server/routes/stimuli.js`
- [Protocol routes](https://github.com/nopleasenorbi/arkheia/blob/main/server/routes/exp_protocols.js): `server/routes/exp_protocols.js`
- [Record routes](https://github.com/nopleasenorbi/arkheia/blob/main/server/routes/records.js): `server/routes/records.js`
- [Result routes](https://github.com/nopleasenorbi/arkheia/blob/main/server/routes/results.js): `server/routes/results.js`
- [Search routes](https://github.com/nopleasenorbi/arkheia/blob/main/server/routes/parameter_searches.js): `server/routes/parameter_searches.js`

### Simulation domain

- [Run controller](https://github.com/nopleasenorbi/arkheia/blob/main/server/controllers/simulationRunsController.js): `server/controllers/simulationRunsController.js`
- [Stimulus controller](https://github.com/nopleasenorbi/arkheia/blob/main/server/controllers/stimuliController.js): `server/controllers/stimuliController.js`
- [Protocol controller](https://github.com/nopleasenorbi/arkheia/blob/main/server/controllers/ExpProtocolController.js): `server/controllers/ExpProtocolController.js`
- [Record controller](https://github.com/nopleasenorbi/arkheia/blob/main/server/controllers/recordsController.js): `server/controllers/recordsController.js`
- [Result controller](https://github.com/nopleasenorbi/arkheia/blob/main/server/controllers/resultsController.js): `server/controllers/resultsController.js`
- [Search controller](https://github.com/nopleasenorbi/arkheia/blob/main/server/controllers/parameterSearchController.js): `server/controllers/parameterSearchController.js`
- [Simulation records](https://github.com/nopleasenorbi/arkheia/blob/main/server/models/simulation_run_model.js): `server/models/simulation_run_model.js`
- [Stimulus records](https://github.com/nopleasenorbi/arkheia/blob/main/server/models/stimuli_model.js): `server/models/stimuli_model.js`
- [Protocol records](https://github.com/nopleasenorbi/arkheia/blob/main/server/models/exp_protocol_model.js): `server/models/exp_protocol_model.js`
- [Record entries](https://github.com/nopleasenorbi/arkheia/blob/main/server/models/records_model.js): `server/models/records_model.js`
- [Result entries](https://github.com/nopleasenorbi/arkheia/blob/main/server/models/results_model.js): `server/models/results_model.js`
- [Search records](https://github.com/nopleasenorbi/arkheia/blob/main/server/models/parameter_search_model.js): `server/models/parameter_search_model.js`

### File assets

- [GridFS file access](https://github.com/nopleasenorbi/arkheia/blob/main/server/controllers/fileGridfsController.js): `server/controllers/fileGridfsController.js`
- **MongoDB GridFS**

### Other components

- **Analyst**

## Connections

- Analyst → Page router: uses
- Page router → Navigation: renders (evidence: `frontend/src/App.js`)
- Page router → Simulation browser: routes to (evidence: `frontend/src/App.js`)
- Page router → Run detail links: routes to (evidence: `frontend/src/App.js`)
- Page router → Parameters view: routes to (evidence: `frontend/src/App.js`)
- Page router → Stimuli view: routes to (evidence: `frontend/src/App.js`)
- Page router → Protocol view: routes to (evidence: `frontend/src/App.js`)
- Page router → Results view: routes to (evidence: `frontend/src/App.js`)
- Page router → Result inspection: routes to (evidence: `frontend/src/App.js`)
- Page router → Parameter search: routes to (evidence: `frontend/src/App.js`)
- Simulation browser → Run details: renders (evidence: `frontend/src/pages/Simulations.js`)
- Run detail links → Parameters view: links to (evidence: `frontend/src/pages/LoneSimulation.js`)
- Run detail links → Stimuli view: links to (evidence: `frontend/src/pages/LoneSimulation.js`)
- Run detail links → Protocol view: links to (evidence: `frontend/src/pages/LoneSimulation.js`)
- Run detail links → Results view: links to (evidence: `frontend/src/pages/LoneSimulation.js`)
- Stimuli view → Page router: renders table (evidence: `frontend/src/pages/StimuliById.js`)
- Protocol view → Page router: renders tables (evidence: `frontend/src/pages/ExpProtocolsById.js`)
- Results view → Page router: renders table (evidence: `frontend/src/pages/ResultsById.js`)
- Parameter search → Search details: renders (evidence: `frontend/src/pages/ParameterSearch.js`)
- Express server → Simulation routes: mounts (evidence: `server/server.js`)
- Express server → Stimuli routes: mounts (evidence: `server/server.js`)
- Express server → Protocol routes: mounts (evidence: `server/server.js`)
- Express server → Record routes: mounts (evidence: `server/server.js`)
- Express server → Result routes: mounts (evidence: `server/server.js`)
- Express server → Search routes: mounts (evidence: `server/server.js`)
- Simulation routes → Run controller: dispatches (evidence: `server/routes/simulation_runs.js`)
- Stimuli routes → Stimulus controller: dispatches (evidence: `server/routes/stimuli.js`)
- Protocol routes → Protocol controller: dispatches (evidence: `server/routes/exp_protocols.js`)
- Record routes → Record controller: dispatches (evidence: `server/routes/records.js`)
- Result routes → Result controller: dispatches (evidence: `server/routes/results.js`)
- Result routes → GridFS file access: dispatches (evidence: `server/routes/results.js`)
- Stimuli routes → GridFS file access: dispatches (evidence: `server/routes/stimuli.js`)
- Search routes → Search controller: dispatches (evidence: `server/routes/parameter_searches.js`)
- Run controller → Simulation records: reads/writes (evidence: `server/controllers/simulationRunsController.js`)
- Run controller → Stimulus records: reads/deletes (evidence: `server/controllers/simulationRunsController.js`)
- Run controller → Protocol records: reads/deletes (evidence: `server/controllers/simulationRunsController.js`)
- Run controller → Record entries: reads/deletes (evidence: `server/controllers/simulationRunsController.js`)
- Run controller → Result entries: reads/deletes (evidence: `server/controllers/simulationRunsController.js`)
- Stimulus controller → Simulation records: populates (evidence: `server/controllers/stimuliController.js`)
- Stimulus controller → Stimulus records: reads/writes (evidence: `server/controllers/stimuliController.js`)
- Protocol controller → Simulation records: reads (evidence: `server/controllers/ExpProtocolController.js`)
- Protocol controller → Protocol records: reads (evidence: `server/controllers/ExpProtocolController.js`)
- Record controller → Simulation records: reads (evidence: `server/controllers/recordsController.js`)
- Record controller → Record entries: reads (evidence: `server/controllers/recordsController.js`)
- Result controller → Simulation records: populates (evidence: `server/controllers/resultsController.js`)
- Result controller → Result entries: reads/writes (evidence: `server/controllers/resultsController.js`)
- Search controller → Search records: reads/writes (evidence: `server/controllers/parameterSearchController.js`)
- Search controller → Simulation records: reads/writes (evidence: `server/controllers/parameterSearchController.js`)
