# adityamalu/build-lab architecture

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

## Overview

Build Lab is a browser-based backend-practice lab: learners choose a project and language, edit starter code, run selected or complete test suites, and review results and per-language progress. The server also supports local workspace files and a hosted mode that runs submissions in a sandbox; a Redis-backed worker fleet is documented in the server excerpt. The map emphasizes those user-facing capabilities and the execution path. Several project-specific source files and parts of the server were not sampled, so unsampled internals are represented only where the README documents them.

Main entry points: [`server/LabServer.java`](https://github.com/adityamalu/build-lab/blob/main/server/LabServer.java) (HTTP server), [`web/app.js`](https://github.com/adityamalu/build-lab/blob/main/web/app.js) (Browser UI), [`testkit`](https://github.com/adityamalu/build-lab/tree/main/testkit) (Language test harnesses), [`projects`](https://github.com/adityamalu/build-lab/tree/main/projects) (Starter and solution code)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_learning["Learning UI"]
  node_webui["Browser UI<br/>[app.js]"]
  node_codeintel["Code navigation<br/>[codeintel.js]"]
end

subgraph group_server["Lab server"]
  node_labserver["HTTP server<br/>[LabServer.java]"]
end

subgraph group_execution["Test execution"]
  node_testrunner["Java test runner<br/>[TestRunner.java]"]
  node_languageharness["Language test harnesses"]
  node_sandbox["Hosted sandbox"]
end

subgraph group_project["Project content"]
  node_catalog["Project catalog and specs<br/>[catalog.json]"]
  node_starter["Starter and solution code"]
  node_workspace[("Local workspace")]
end

subgraph group_operations["Hosted operations"]
  node_redis["Redis queue"]
  node_workers["Run workers<br/>[LabServer.java]"]
end

node_learner(("Learner"))
node_browserstate[("Browser code and progress")]
node_toolchains["Language toolchains"]
node_hostedprogress[("Hosted browser progress")]

node_learner -->|"uses"| node_webui
node_webui -->|"browses"| node_catalog
node_webui -->|"edits"| node_starter
node_webui -->|"requests navigation"| node_codeintel
node_webui -->|"saves hosted state"| node_browserstate
node_webui -->|"requests runs"| node_labserver
node_labserver -->|"reads local code"| node_workspace
node_labserver -->|"restores starter"| node_starter
node_labserver -->|"runs Java tests"| node_testrunner
node_labserver -->|"runs language tests"| node_languageharness
node_languageharness -.->|"compiles code"| node_toolchains
node_labserver -->|"sandboxes hosted runs"| node_sandbox
node_labserver -->|"queues jobs"| node_redis
node_workers -->|"claims jobs"| node_redis
node_workers -->|"runs submissions"| node_sandbox
node_workers -->|"returns results"| node_redis
node_labserver -.->|"returns results"| node_webui
node_learner -->|"keeps progress"| node_hostedprogress

click node_webui "https://github.com/adityamalu/build-lab/blob/main/web/app.js"
click node_codeintel "https://github.com/adityamalu/build-lab/blob/main/web/codeintel.js"
click node_labserver "https://github.com/adityamalu/build-lab/blob/main/server/LabServer.java"
click node_catalog "https://github.com/adityamalu/build-lab/blob/main/projects/catalog.json"
click node_starter "https://github.com/adityamalu/build-lab/tree/main/projects"
click node_testrunner "https://github.com/adityamalu/build-lab/blob/main/testkit/java/src/testkit/TestRunner.java"
click node_languageharness "https://github.com/adityamalu/build-lab/tree/main/testkit"
click node_sandbox "https://github.com/adityamalu/build-lab/tree/main/testkit"
click node_workers "https://github.com/adityamalu/build-lab/blob/main/server/LabServer.java"

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_webui,node_codeintel toneBlue
class node_labserver,node_browserstate,node_hostedprogress toneAmber
class node_testrunner,node_languageharness,node_sandbox toneMint
class node_catalog,node_starter,node_workspace toneRose
class node_redis,node_workers,node_learner,node_toolchains toneIndigo
```

## Components

### Learning UI

- [Browser UI](https://github.com/adityamalu/build-lab/blob/main/web/app.js): `web/app.js`
- [Code navigation](https://github.com/adityamalu/build-lab/blob/main/web/codeintel.js): `web/codeintel.js`

### Lab server

- [HTTP server](https://github.com/adityamalu/build-lab/blob/main/server/LabServer.java): `server/LabServer.java`

### Test execution

- [Java test runner](https://github.com/adityamalu/build-lab/blob/main/testkit/java/src/testkit/TestRunner.java): `testkit/java/src/testkit/TestRunner.java`
- [Language test harnesses](https://github.com/adityamalu/build-lab/tree/main/testkit): `testkit`
- [Hosted sandbox](https://github.com/adityamalu/build-lab/tree/main/testkit): `testkit`

### Project content

- [Project catalog and specs](https://github.com/adityamalu/build-lab/blob/main/projects/catalog.json): `projects/catalog.json`
- [Starter and solution code](https://github.com/adityamalu/build-lab/tree/main/projects): `projects`
- **Local workspace**

### Hosted operations

- **Redis queue**
- [Run workers](https://github.com/adityamalu/build-lab/blob/main/server/LabServer.java): `server/LabServer.java`

### Other components

- **Learner**
- **Browser code and progress**
- **Language toolchains**
- **Hosted browser progress**

## Connections

- Learner → Browser UI: uses (evidence: `README.md`)
- Browser UI → Project catalog and specs: browses (evidence: `README.md`)
- Browser UI → Starter and solution code: edits (evidence: `README.md`)
- Browser UI → Code navigation: requests navigation (evidence: `README.md`)
- Browser UI → Browser code and progress: saves hosted state (evidence: `README.md`)
- Browser UI → HTTP server: requests runs (evidence: `README.md`)
- HTTP server → Local workspace: reads local code (evidence: `README.md`)
- HTTP server → Starter and solution code: restores starter (evidence: `README.md`)
- HTTP server → Java test runner: runs Java tests (evidence: `server/LabServer.java`)
- HTTP server → Language test harnesses: runs language tests (evidence: `README.md`)
- Language test harnesses → Language toolchains: compiles code
- HTTP server → Hosted sandbox: sandboxes hosted runs (evidence: `README.md`)
- HTTP server → Redis queue: queues jobs (evidence: `server/LabServer.java`)
- Run workers → Redis queue: claims jobs (evidence: `server/LabServer.java`)
- Run workers → Hosted sandbox: runs submissions (evidence: `server/LabServer.java`)
- Run workers → Redis queue: returns results (evidence: `server/LabServer.java`)
- HTTP server → Browser UI: returns results
- Learner → Hosted browser progress: keeps progress (evidence: `README.md`)
