# lab-algoritma-dan-pemrograman/algohub architecture

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

- Interactive diagram: https://gitdiagram.com/lab-algoritma-dan-pemrograman/algohub
- Repository: https://github.com/lab-algoritma-dan-pemrograman/algohub

## Overview

AlgoHub is a multi-domain university lab platform: SvelteKit frontends serve e-learning, practical coursework, campus administration, and a public landing page, backed by a Go API. The main learner workflow is using a domain app to request API-backed curriculum, coursework, or campus services; e-learning also supports running code in a browser runner. The README establishes the app/API split, while sampled sources show API-client and runner behavior. Many backend feature handlers and app routes are unsampled, so their internal call paths are not expanded.

Main entry points: [`packages/runner/src/index.ts`](https://github.com/lab-algoritma-dan-pemrograman/algohub/blob/main/packages/runner/src/index.ts) (Runner entry), [`backend/internal/delivery/http/router.go`](https://github.com/lab-algoritma-dan-pemrograman/algohub/blob/main/backend/internal/delivery/http/router.go) (HTTP API), [`packages/api-client/src/client.ts`](https://github.com/lab-algoritma-dan-pemrograman/algohub/blob/main/packages/api-client/src/client.ts) (HTTP client), [`apps/elearning/src/routes/(app)/dashboard/+page.svelte`](https://github.com/lab-algoritma-dan-pemrograman/algohub/blob/main/apps/elearning/src/routes/(app)/dashboard/%2Bpage.svelte) (E-learning app)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontends["Web apps"]
  node_portal["Portal<br/>[+page.svelte]"]
  node_elearning["E-learning app<br/>[+page.svelte]"]
  node_praktikum["Praktikum app<br/>[+page.svelte]"]
  node_siakad["SIAKAD app<br/>[+page.svelte]"]
end

subgraph group_backend["Go API"]
  node_api["HTTP API<br/>[router.go]"]
  node_el_handlers["E-learning handlers"]
  node_praktikum_handlers["Praktikum handlers"]
  node_siakad_handlers["SIAKAD handlers"]
  node_elearning_data[("E-learning persistence")]
  node_praktikum_data[("Praktikum persistence")]
  node_siakad_data[("SIAKAD persistence")]
end

subgraph group_shared["Shared packages"]
  node_api_base["HTTP client<br/>[client.ts]"]
  node_el_client["E-learning client<br/>[client.ts]"]
  node_praktikum_client["Praktikum client<br/>[client.ts]"]
  node_siakad_client["SIAKAD client<br/>[client.ts]"]
end

subgraph group_runner["Code runner"]
  node_runner_harness["Runner harness<br/>[App.svelte]"]
  node_runner_entry["Runner entry<br/>[index.ts]"]
  node_runner_runtime["Execution runtime<br/>[runtime.ts]"]
  node_runner_state["Runtime state<br/>[state.ts]"]
  node_runner_config["Runner config<br/>[config.ts]"]
  node_runner_messages["Runner messages<br/>[messages.ts]"]
  node_runner_report["Result formatting<br/>[report.ts]"]
end

node_learner(("Learner"))
node_staff(("Staff"))

node_learner -->|"uses"| node_elearning
node_learner -->|"uses"| node_praktikum
node_learner -->|"uses"| node_siakad
node_staff -->|"administers"| node_elearning
node_staff -->|"administers"| node_praktikum
node_staff -->|"administers"| node_siakad
node_elearning -.->|"uses"| node_el_client
node_praktikum -.->|"uses"| node_praktikum_client
node_siakad -.->|"uses"| node_siakad_client
node_el_client -->|"builds requests"| node_api_base
node_praktikum_client -->|"builds requests"| node_api_base
node_siakad_client -->|"builds requests"| node_api_base
node_api_base -->|"sends HTTP"| node_api
node_api -.->|"routes requests"| node_el_handlers
node_api -.->|"routes requests"| node_praktikum_handlers
node_api -.->|"routes requests"| node_siakad_handlers
node_runner_harness -->|"uses"| node_runner_entry
node_runner_entry -->|"exports"| node_runner_runtime
node_runner_entry -->|"exports"| node_runner_state
node_runner_entry -->|"exports"| node_runner_config
node_runner_entry -->|"exports"| node_runner_messages
node_runner_entry -->|"exports"| node_runner_report

click node_portal "https://github.com/lab-algoritma-dan-pemrograman/algohub/blob/main/apps/portal/src/routes/%2Bpage.svelte"
click node_elearning "https://github.com/lab-algoritma-dan-pemrograman/algohub/blob/main/apps/elearning/src/routes/(app)/dashboard/%2Bpage.svelte"
click node_praktikum "https://github.com/lab-algoritma-dan-pemrograman/algohub/blob/main/apps/praktikum/src/routes/praktikum/dashboard/%2Bpage.svelte"
click node_siakad "https://github.com/lab-algoritma-dan-pemrograman/algohub/blob/main/apps/siakad/src/routes/(app)/beranda/%2Bpage.svelte"
click node_api "https://github.com/lab-algoritma-dan-pemrograman/algohub/blob/main/backend/internal/delivery/http/router.go"
click node_el_handlers "https://github.com/lab-algoritma-dan-pemrograman/algohub/tree/main/backend/internal/delivery/http/handler/elearning"
click node_praktikum_handlers "https://github.com/lab-algoritma-dan-pemrograman/algohub/tree/main/backend/internal/delivery/http/handler/praktikum"
click node_siakad_handlers "https://github.com/lab-algoritma-dan-pemrograman/algohub/tree/main/backend/internal/delivery/http/handler/siakad"
click node_elearning_data "https://github.com/lab-algoritma-dan-pemrograman/algohub/tree/main/backend/internal/repository/elearning"
click node_praktikum_data "https://github.com/lab-algoritma-dan-pemrograman/algohub/tree/main/backend/internal/repository/praktikum"
click node_siakad_data "https://github.com/lab-algoritma-dan-pemrograman/algohub/tree/main/backend/internal/repository/siakad"
click node_api_base "https://github.com/lab-algoritma-dan-pemrograman/algohub/blob/main/packages/api-client/src/client.ts"
click node_el_client "https://github.com/lab-algoritma-dan-pemrograman/algohub/blob/main/packages/api-client/src/elearning/client.ts"
click node_praktikum_client "https://github.com/lab-algoritma-dan-pemrograman/algohub/blob/main/packages/api-client/src/praktikum/client.ts"
click node_siakad_client "https://github.com/lab-algoritma-dan-pemrograman/algohub/blob/main/packages/api-client/src/siakad/client.ts"
click node_runner_harness "https://github.com/lab-algoritma-dan-pemrograman/algohub/blob/main/packages/runner/harness/src/App.svelte"
click node_runner_entry "https://github.com/lab-algoritma-dan-pemrograman/algohub/blob/main/packages/runner/src/index.ts"
click node_runner_runtime "https://github.com/lab-algoritma-dan-pemrograman/algohub/blob/main/packages/runner/src/runtime.ts"
click node_runner_state "https://github.com/lab-algoritma-dan-pemrograman/algohub/blob/main/packages/runner/src/state.ts"
click node_runner_config "https://github.com/lab-algoritma-dan-pemrograman/algohub/blob/main/packages/runner/src/config.ts"
click node_runner_messages "https://github.com/lab-algoritma-dan-pemrograman/algohub/blob/main/packages/runner/src/messages.ts"
click node_runner_report "https://github.com/lab-algoritma-dan-pemrograman/algohub/blob/main/packages/runner/src/report.ts"

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_portal,node_elearning,node_praktikum,node_siakad toneBlue
class node_api,node_el_handlers,node_praktikum_handlers,node_siakad_handlers,node_elearning_data,node_praktikum_data,node_siakad_data toneAmber
class node_api_base,node_el_client,node_praktikum_client,node_siakad_client toneMint
class node_runner_harness,node_runner_entry,node_runner_runtime,node_runner_state,node_runner_config,node_runner_messages,node_runner_report toneRose
class node_learner,node_staff toneIndigo
```

## Components

### Web apps

- [Portal](https://github.com/lab-algoritma-dan-pemrograman/algohub/blob/main/apps/portal/src/routes/%2Bpage.svelte): `apps/portal/src/routes/+page.svelte`
- [E-learning app](https://github.com/lab-algoritma-dan-pemrograman/algohub/blob/main/apps/elearning/src/routes/(app)/dashboard/%2Bpage.svelte): `apps/elearning/src/routes/(app)/dashboard/+page.svelte`
- [Praktikum app](https://github.com/lab-algoritma-dan-pemrograman/algohub/blob/main/apps/praktikum/src/routes/praktikum/dashboard/%2Bpage.svelte): `apps/praktikum/src/routes/praktikum/dashboard/+page.svelte`
- [SIAKAD app](https://github.com/lab-algoritma-dan-pemrograman/algohub/blob/main/apps/siakad/src/routes/(app)/beranda/%2Bpage.svelte): `apps/siakad/src/routes/(app)/beranda/+page.svelte`

### Go API

- [HTTP API](https://github.com/lab-algoritma-dan-pemrograman/algohub/blob/main/backend/internal/delivery/http/router.go): `backend/internal/delivery/http/router.go`
- [E-learning handlers](https://github.com/lab-algoritma-dan-pemrograman/algohub/tree/main/backend/internal/delivery/http/handler/elearning): `backend/internal/delivery/http/handler/elearning`
- [Praktikum handlers](https://github.com/lab-algoritma-dan-pemrograman/algohub/tree/main/backend/internal/delivery/http/handler/praktikum): `backend/internal/delivery/http/handler/praktikum`
- [SIAKAD handlers](https://github.com/lab-algoritma-dan-pemrograman/algohub/tree/main/backend/internal/delivery/http/handler/siakad): `backend/internal/delivery/http/handler/siakad`
- [E-learning persistence](https://github.com/lab-algoritma-dan-pemrograman/algohub/tree/main/backend/internal/repository/elearning): `backend/internal/repository/elearning`
- [Praktikum persistence](https://github.com/lab-algoritma-dan-pemrograman/algohub/tree/main/backend/internal/repository/praktikum): `backend/internal/repository/praktikum`
- [SIAKAD persistence](https://github.com/lab-algoritma-dan-pemrograman/algohub/tree/main/backend/internal/repository/siakad): `backend/internal/repository/siakad`

### Shared packages

- [HTTP client](https://github.com/lab-algoritma-dan-pemrograman/algohub/blob/main/packages/api-client/src/client.ts): `packages/api-client/src/client.ts`
- [E-learning client](https://github.com/lab-algoritma-dan-pemrograman/algohub/blob/main/packages/api-client/src/elearning/client.ts): `packages/api-client/src/elearning/client.ts`
- [Praktikum client](https://github.com/lab-algoritma-dan-pemrograman/algohub/blob/main/packages/api-client/src/praktikum/client.ts): `packages/api-client/src/praktikum/client.ts`
- [SIAKAD client](https://github.com/lab-algoritma-dan-pemrograman/algohub/blob/main/packages/api-client/src/siakad/client.ts): `packages/api-client/src/siakad/client.ts`

### Code runner

- [Runner harness](https://github.com/lab-algoritma-dan-pemrograman/algohub/blob/main/packages/runner/harness/src/App.svelte): `packages/runner/harness/src/App.svelte`
- [Runner entry](https://github.com/lab-algoritma-dan-pemrograman/algohub/blob/main/packages/runner/src/index.ts): `packages/runner/src/index.ts`
- [Execution runtime](https://github.com/lab-algoritma-dan-pemrograman/algohub/blob/main/packages/runner/src/runtime.ts): `packages/runner/src/runtime.ts`
- [Runtime state](https://github.com/lab-algoritma-dan-pemrograman/algohub/blob/main/packages/runner/src/state.ts): `packages/runner/src/state.ts`
- [Runner config](https://github.com/lab-algoritma-dan-pemrograman/algohub/blob/main/packages/runner/src/config.ts): `packages/runner/src/config.ts`
- [Runner messages](https://github.com/lab-algoritma-dan-pemrograman/algohub/blob/main/packages/runner/src/messages.ts): `packages/runner/src/messages.ts`
- [Result formatting](https://github.com/lab-algoritma-dan-pemrograman/algohub/blob/main/packages/runner/src/report.ts): `packages/runner/src/report.ts`

### Other components

- **Learner**
- **Staff**

## Connections

- Learner → E-learning app: uses (evidence: `README.md`)
- Learner → Praktikum app: uses (evidence: `README.md`)
- Learner → SIAKAD app: uses (evidence: `README.md`)
- Staff → E-learning app: administers (evidence: `README.md`)
- Staff → Praktikum app: administers (evidence: `README.md`)
- Staff → SIAKAD app: administers (evidence: `README.md`)
- E-learning app → E-learning client: uses
- Praktikum app → Praktikum client: uses
- SIAKAD app → SIAKAD client: uses
- E-learning client → HTTP client: builds requests (evidence: `packages/api-client/src/elearning/client.ts`)
- Praktikum client → HTTP client: builds requests (evidence: `packages/api-client/src/praktikum/client.ts`)
- SIAKAD client → HTTP client: builds requests (evidence: `packages/api-client/src/siakad/client.ts`)
- HTTP client → HTTP API: sends HTTP (evidence: `packages/api-client/src/client.ts`)
- HTTP API → E-learning handlers: routes requests
- HTTP API → Praktikum handlers: routes requests
- HTTP API → SIAKAD handlers: routes requests
- Runner harness → Runner entry: uses (evidence: `packages/runner/harness/src/App.svelte`)
- Runner entry → Execution runtime: exports (evidence: `packages/runner/src/index.ts`)
- Runner entry → Runtime state: exports (evidence: `packages/runner/src/index.ts`)
- Runner entry → Runner config: exports (evidence: `packages/runner/src/index.ts`)
- Runner entry → Runner messages: exports (evidence: `packages/runner/src/index.ts`)
- Runner entry → Result formatting: exports (evidence: `packages/runner/src/index.ts`)
