# dr-skaragiannis/meshcrowd architecture

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

- Interactive diagram: https://gitdiagram.com/dr-skaragiannis/meshcrowd
- Repository: https://github.com/dr-skaragiannis/meshcrowd

## Overview

MeshCrowd’s repository combines a React research-report website with a reproducible evaluation harness and Android evaluation-data capture/export code. The web workflow routes visitors through report pages; the evaluation workflow generates scenes, replays them through the model, and computes statistics. The README documents sensing, ranging, epochs, transit counting, mesh federation, and reliability incentives as product capabilities, but the supplied tree does not include the Android sensing engine itself. The graph therefore distinguishes documented report content from implemented evaluation machinery.

Main entry points: [`src/pages/Subpages.tsx`](https://github.com/dr-skaragiannis/meshcrowd/blob/master/src/pages/Subpages.tsx) (Report pages), [`src/App.tsx`](https://github.com/dr-skaragiannis/meshcrowd/blob/master/src/App.tsx) (Web app shell), [`src/pages/Home.tsx`](https://github.com/dr-skaragiannis/meshcrowd/blob/master/src/pages/Home.tsx) (Home report), [`evaluation/src/suites.mjs`](https://github.com/dr-skaragiannis/meshcrowd/blob/master/evaluation/src/suites.mjs) (Evaluation suites)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Research website"]
  node_app["Web app shell<br/>[App.tsx]"]
  node_router["Hash router<br/>[router.ts]"]
  node_home["Home report<br/>[Home.tsx]"]
  node_subpages["Report pages<br/>[Subpages.tsx]"]
  node_method["Method and epochs<br/>[Method.tsx]"]
  node_ranging["Range explorer<br/>[RangeExplorer.tsx]"]
  node_evaluationview["Results report<br/>[Evaluation.tsx]"]
  node_community["Community report<br/>[Club.tsx]"]
  node_phone["App screen mockups<br/>[screens.tsx]"]
  node_reportdata["Report data<br/>[data.ts]"]
end

subgraph group_eval["Evaluation harness"]
  node_scenegen["Scene generation<br/>[random.mjs]"]
  node_suites["Evaluation suites<br/>[suites.mjs]"]
  node_model["Signal model<br/>[model.mjs]"]
  node_stats["Result statistics<br/>[stats.mjs]"]
  node_runner["Evaluation runner<br/>[run.mjs]"]
end

subgraph group_android["Android evaluation capture"]
  node_hooks["Evaluation hooks"]
  node_recorder["Session recorder"]
  node_dataactivity["Session data activity"]
  node_exporter["JSON export controller"]
end

node_visitor(("Site visitor"))
node_fileexport["User-chosen JSON file"]

node_visitor -.->|"opens"| node_app
node_app -->|"reads route"| node_router
node_app -->|"renders home"| node_home
node_app -->|"renders pages"| node_subpages
node_subpages -->|"renders"| node_method
node_subpages -->|"renders"| node_ranging
node_subpages -->|"renders"| node_evaluationview
node_subpages -->|"renders"| node_community
node_home -->|"renders mockup"| node_phone
node_home -->|"reads stats"| node_reportdata
node_method -->|"reads band data"| node_reportdata
node_evaluationview -->|"reads results"| node_reportdata
node_runner -->|"uses generator"| node_scenegen
node_runner -->|"runs suites"| node_suites
node_suites -->|"replays scenes"| node_model
node_suites -->|"computes metrics"| node_stats
node_hooks -->|"records through"| node_recorder
node_dataactivity -->|"uses recorder"| node_recorder
node_dataactivity -->|"uses controller"| node_exporter
node_exporter -->|"exports sessions"| node_recorder
node_exporter -->|"writes JSON"| node_fileexport

click node_app "https://github.com/dr-skaragiannis/meshcrowd/blob/master/src/App.tsx"
click node_router "https://github.com/dr-skaragiannis/meshcrowd/blob/master/src/router.ts"
click node_home "https://github.com/dr-skaragiannis/meshcrowd/blob/master/src/pages/Home.tsx"
click node_subpages "https://github.com/dr-skaragiannis/meshcrowd/blob/master/src/pages/Subpages.tsx"
click node_method "https://github.com/dr-skaragiannis/meshcrowd/blob/master/src/components/Method.tsx"
click node_ranging "https://github.com/dr-skaragiannis/meshcrowd/blob/master/src/components/RangeExplorer.tsx"
click node_evaluationview "https://github.com/dr-skaragiannis/meshcrowd/blob/master/src/components/Evaluation.tsx"
click node_community "https://github.com/dr-skaragiannis/meshcrowd/blob/master/src/components/Club.tsx"
click node_phone "https://github.com/dr-skaragiannis/meshcrowd/blob/master/src/components/phone/screens.tsx"
click node_reportdata "https://github.com/dr-skaragiannis/meshcrowd/blob/master/src/data.ts"
click node_scenegen "https://github.com/dr-skaragiannis/meshcrowd/blob/master/evaluation/src/random.mjs"
click node_suites "https://github.com/dr-skaragiannis/meshcrowd/blob/master/evaluation/src/suites.mjs"
click node_model "https://github.com/dr-skaragiannis/meshcrowd/blob/master/evaluation/src/model.mjs"
click node_stats "https://github.com/dr-skaragiannis/meshcrowd/blob/master/evaluation/src/stats.mjs"
click node_runner "https://github.com/dr-skaragiannis/meshcrowd/blob/master/evaluation/run.mjs"
click node_hooks "https://github.com/dr-skaragiannis/meshcrowd/blob/master/evaluation/android/src/main/java/org/meshcrowd/evaluation/MeshCrowdEvaluationHooks.kt"
click node_recorder "https://github.com/dr-skaragiannis/meshcrowd/blob/master/evaluation/android/src/main/java/org/meshcrowd/evaluation/EvaluationRecorder.kt"
click node_dataactivity "https://github.com/dr-skaragiannis/meshcrowd/blob/master/evaluation/android/src/main/java/org/meshcrowd/evaluation/EvaluationDataActivity.kt"
click node_exporter "https://github.com/dr-skaragiannis/meshcrowd/blob/master/evaluation/android/src/main/java/org/meshcrowd/evaluation/EvaluationExportController.kt"

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_router,node_home,node_subpages,node_method,node_ranging,node_evaluationview,node_community,node_phone,node_reportdata,node_fileexport toneBlue
class node_scenegen,node_suites,node_model,node_stats,node_runner toneAmber
class node_hooks,node_recorder,node_dataactivity,node_exporter toneMint
class node_visitor toneIndigo
```

## Components

### Research website

- [Web app shell](https://github.com/dr-skaragiannis/meshcrowd/blob/master/src/App.tsx): `src/App.tsx`
- [Hash router](https://github.com/dr-skaragiannis/meshcrowd/blob/master/src/router.ts): `src/router.ts`
- [Home report](https://github.com/dr-skaragiannis/meshcrowd/blob/master/src/pages/Home.tsx): `src/pages/Home.tsx`
- [Report pages](https://github.com/dr-skaragiannis/meshcrowd/blob/master/src/pages/Subpages.tsx): `src/pages/Subpages.tsx`
- [Method and epochs](https://github.com/dr-skaragiannis/meshcrowd/blob/master/src/components/Method.tsx): `src/components/Method.tsx`
- [Range explorer](https://github.com/dr-skaragiannis/meshcrowd/blob/master/src/components/RangeExplorer.tsx): `src/components/RangeExplorer.tsx`
- [Results report](https://github.com/dr-skaragiannis/meshcrowd/blob/master/src/components/Evaluation.tsx): `src/components/Evaluation.tsx`
- [Community report](https://github.com/dr-skaragiannis/meshcrowd/blob/master/src/components/Club.tsx): `src/components/Club.tsx`
- [App screen mockups](https://github.com/dr-skaragiannis/meshcrowd/blob/master/src/components/phone/screens.tsx): `src/components/phone/screens.tsx`
- [Report data](https://github.com/dr-skaragiannis/meshcrowd/blob/master/src/data.ts): `src/data.ts`

### Evaluation harness

- [Scene generation](https://github.com/dr-skaragiannis/meshcrowd/blob/master/evaluation/src/random.mjs): `evaluation/src/random.mjs`
- [Evaluation suites](https://github.com/dr-skaragiannis/meshcrowd/blob/master/evaluation/src/suites.mjs): `evaluation/src/suites.mjs`
- [Signal model](https://github.com/dr-skaragiannis/meshcrowd/blob/master/evaluation/src/model.mjs): `evaluation/src/model.mjs`
- [Result statistics](https://github.com/dr-skaragiannis/meshcrowd/blob/master/evaluation/src/stats.mjs): `evaluation/src/stats.mjs`
- [Evaluation runner](https://github.com/dr-skaragiannis/meshcrowd/blob/master/evaluation/run.mjs): `evaluation/run.mjs`

### Android evaluation capture

- [Evaluation hooks](https://github.com/dr-skaragiannis/meshcrowd/blob/master/evaluation/android/src/main/java/org/meshcrowd/evaluation/MeshCrowdEvaluationHooks.kt): `evaluation/android/src/main/java/org/meshcrowd/evaluation/MeshCrowdEvaluationHooks.kt`
- [Session recorder](https://github.com/dr-skaragiannis/meshcrowd/blob/master/evaluation/android/src/main/java/org/meshcrowd/evaluation/EvaluationRecorder.kt): `evaluation/android/src/main/java/org/meshcrowd/evaluation/EvaluationRecorder.kt`
- [Session data activity](https://github.com/dr-skaragiannis/meshcrowd/blob/master/evaluation/android/src/main/java/org/meshcrowd/evaluation/EvaluationDataActivity.kt): `evaluation/android/src/main/java/org/meshcrowd/evaluation/EvaluationDataActivity.kt`
- [JSON export controller](https://github.com/dr-skaragiannis/meshcrowd/blob/master/evaluation/android/src/main/java/org/meshcrowd/evaluation/EvaluationExportController.kt): `evaluation/android/src/main/java/org/meshcrowd/evaluation/EvaluationExportController.kt`

### Other components

- **Site visitor**
- **User-chosen JSON file**

## Connections

- Site visitor → Web app shell: opens
- Web app shell → Hash router: reads route (evidence: `src/App.tsx`)
- Web app shell → Home report: renders home (evidence: `src/App.tsx`)
- Web app shell → Report pages: renders pages (evidence: `src/App.tsx`)
- Report pages → Method and epochs: renders (evidence: `src/pages/Subpages.tsx`)
- Report pages → Range explorer: renders (evidence: `src/pages/Subpages.tsx`)
- Report pages → Results report: renders (evidence: `src/pages/Subpages.tsx`)
- Report pages → Community report: renders (evidence: `src/pages/Subpages.tsx`)
- Home report → App screen mockups: renders mockup (evidence: `src/pages/Home.tsx`)
- Home report → Report data: reads stats (evidence: `src/pages/Home.tsx`)
- Method and epochs → Report data: reads band data (evidence: `src/components/Method.tsx`)
- Results report → Report data: reads results (evidence: `src/components/Evaluation.tsx`)
- Evaluation runner → Scene generation: uses generator (evidence: `evaluation/run.mjs`)
- Evaluation runner → Evaluation suites: runs suites (evidence: `evaluation/run.mjs`)
- Evaluation suites → Signal model: replays scenes (evidence: `evaluation/src/suites.mjs`)
- Evaluation suites → Result statistics: computes metrics (evidence: `evaluation/src/suites.mjs`)
- Evaluation hooks → Session recorder: records through (evidence: `evaluation/android/src/main/java/org/meshcrowd/evaluation/MeshCrowdEvaluationHooks.kt`)
- Session data activity → Session recorder: uses recorder (evidence: `evaluation/android/src/main/java/org/meshcrowd/evaluation/EvaluationDataActivity.kt`)
- Session data activity → JSON export controller: uses controller (evidence: `evaluation/android/src/main/java/org/meshcrowd/evaluation/EvaluationDataActivity.kt`)
- JSON export controller → Session recorder: exports sessions (evidence: `evaluation/android/src/main/java/org/meshcrowd/evaluation/EvaluationExportController.kt`)
- JSON export controller → User-chosen JSON file: writes JSON (evidence: `evaluation/android/src/main/java/org/meshcrowd/evaluation/EvaluationExportController.kt`)
