# azusalina/someproducts architecture

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

- Interactive diagram: https://gitdiagram.com/azusalina/someproducts
- Repository: https://github.com/azusalina/someproducts

## Overview

This repository is a portfolio of independent browser learning tools, planning and discovery apps, and local system utilities—not one connected runtime. The clearest user workflows are interactive algebra lessons, repository exploration, programme-path simulation, port discovery, and a desktop telemetry dashboard. Edges below are limited to relationships visible in the supplied source index or excerpts; most other project README content and source was not supplied, so those components are shown without guessed internal wiring.

Main entry points: [`d-la/js/app.js`](https://github.com/azusalina/someproducts/blob/master/d-la/js/app.js) (Algebra course app), [`d-la/js/lab.js`](https://github.com/azusalina/someproducts/blob/master/d-la/js/lab.js) (Interactive labs), [`monitor/core/backend/monitor_service.py`](https://github.com/azusalina/someproducts/blob/master/monitor/core/backend/monitor_service.py) (Telemetry service), [`d-gitpop/src/app.js`](https://github.com/azusalina/someproducts/blob/master/d-gitpop/src/app.js) (Repository explorer)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_learning["Learning apps"]
  node_ba_app["Business lessons app<br/>[app.js]"]
  node_ba_lessons["Business lessons<br/>[lessons.js]"]
  node_ict_app["ICT learning app<br/>[app.js]"]
  node_ict_lessons["ICT lessons<br/>[lessons.js]"]
  node_la_app["Algebra course app<br/>[app.js]"]
  node_la_lessons["Lesson content<br/>[lessons.js]"]
  node_la_lab["Interactive labs<br/>[lab.js]"]
  node_la_math["Math operations<br/>[math.js]"]
  node_la_plots["Lab plots<br/>[plots.js]"]
  node_la_3d["3D visualisation<br/>[three-view.js]"]
  node_la_notes["Field notes<br/>[notes.js]"]
  node_la_ui["Shared UI helpers<br/>[ui.js]"]
end

subgraph group_explore["Discovery tools"]
  node_gitpop_app["Repository explorer<br/>[app.js]"]
  node_gitpop_repos["Repository catalogue<br/>[repos.js]"]
  node_gitpop_visuals["Repository visuals<br/>[visuals.js]"]
end

subgraph group_planning["Planning tools"]
  node_jupas_app["Programme path explorer<br/>[app.js]"]
  node_jupas_model["Path simulation model<br/>[model.mjs]"]
end

subgraph group_system["System utilities"]
  node_mediator_server["Mediator HTTP service<br/>[server.mjs]"]
  node_mediator_discovery["Port discovery<br/>[discovery.mjs]"]
  node_monitor_service["Telemetry service<br/>[monitor_service.py]"]
  node_monitor_usage["Usage collection<br/>[usage.py]"]
  node_monitor_news["Reset announcements<br/>[reset_news.py]"]
  node_monitor_connectivity["Connectivity checks<br/>[connectivity.py]"]
  node_monitor_ui["Plasma dashboard"]
end

node_user(("Learner / visitor"))

node_user -.->|"uses"| node_ba_app
node_user -.->|"uses"| node_ict_app
node_user -.->|"explores"| node_la_app
node_user -.->|"explores"| node_gitpop_app
node_user -.->|"simulates"| node_jupas_app
node_la_app -->|"loads lessons"| node_la_lessons
node_la_app -->|"mounts labs"| node_la_lab
node_la_app -->|"renders notes"| node_la_notes
node_la_app -->|"uses helpers"| node_la_ui
node_la_lab -->|"uses operations"| node_la_math
node_la_lab -->|"uses plots"| node_la_plots
node_la_lab -->|"uses views"| node_la_3d
node_la_lab -->|"renders math"| node_la_ui
node_la_notes -->|"uses helpers"| node_la_ui
node_la_plots -->|"uses operations"| node_la_math
node_gitpop_app -->|"selects repositories"| node_gitpop_repos
node_gitpop_app -->|"creates visuals"| node_gitpop_visuals
node_jupas_app -->|"simulates paths"| node_jupas_model
node_mediator_server -->|"requests discovery"| node_mediator_discovery
node_monitor_service -->|"collects usage"| node_monitor_usage
node_monitor_service -->|"collects news"| node_monitor_news
node_monitor_service -->|"checks connectivity"| node_monitor_connectivity

click node_ba_app "https://github.com/azusalina/someproducts/blob/master/d-ba/app.js"
click node_ba_lessons "https://github.com/azusalina/someproducts/blob/master/d-ba/lessons.js"
click node_ict_app "https://github.com/azusalina/someproducts/blob/master/d-ict/app.js"
click node_ict_lessons "https://github.com/azusalina/someproducts/blob/master/d-ict/lessons.js"
click node_la_app "https://github.com/azusalina/someproducts/blob/master/d-la/js/app.js"
click node_la_lessons "https://github.com/azusalina/someproducts/blob/master/d-la/js/lessons.js"
click node_la_lab "https://github.com/azusalina/someproducts/blob/master/d-la/js/lab.js"
click node_la_math "https://github.com/azusalina/someproducts/blob/master/d-la/js/math.js"
click node_la_plots "https://github.com/azusalina/someproducts/blob/master/d-la/js/plots.js"
click node_la_3d "https://github.com/azusalina/someproducts/blob/master/d-la/js/three-view.js"
click node_la_notes "https://github.com/azusalina/someproducts/blob/master/d-la/js/notes.js"
click node_la_ui "https://github.com/azusalina/someproducts/blob/master/d-la/js/ui.js"
click node_gitpop_app "https://github.com/azusalina/someproducts/blob/master/d-gitpop/src/app.js"
click node_gitpop_repos "https://github.com/azusalina/someproducts/blob/master/d-gitpop/src/repos.js"
click node_gitpop_visuals "https://github.com/azusalina/someproducts/blob/master/d-gitpop/src/visuals.js"
click node_jupas_app "https://github.com/azusalina/someproducts/blob/master/d-jupasanalysis/app.js"
click node_jupas_model "https://github.com/azusalina/someproducts/blob/master/d-jupasanalysis/model.mjs"
click node_mediator_server "https://github.com/azusalina/someproducts/blob/master/mediator/server.mjs"
click node_mediator_discovery "https://github.com/azusalina/someproducts/blob/master/mediator/lib/discovery.mjs"
click node_monitor_service "https://github.com/azusalina/someproducts/blob/master/monitor/core/backend/monitor_service.py"
click node_monitor_usage "https://github.com/azusalina/someproducts/blob/master/monitor/core/backend/usage.py"
click node_monitor_news "https://github.com/azusalina/someproducts/blob/master/monitor/core/backend/reset_news.py"
click node_monitor_connectivity "https://github.com/azusalina/someproducts/blob/master/monitor/core/backend/connectivity.py"
click node_monitor_ui "https://github.com/azusalina/someproducts/tree/master/monitor/core/plasmoid/contents/ui"

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_ba_app,node_ba_lessons,node_ict_app,node_ict_lessons,node_la_app,node_la_lessons,node_la_lab,node_la_math,node_la_plots,node_la_3d,node_la_notes,node_la_ui toneBlue
class node_gitpop_app,node_gitpop_repos,node_gitpop_visuals toneAmber
class node_jupas_app,node_jupas_model toneMint
class node_mediator_server,node_mediator_discovery,node_monitor_service,node_monitor_usage,node_monitor_news,node_monitor_connectivity,node_monitor_ui toneRose
class node_user toneIndigo
```

## Components

### Learning apps

- [Business lessons app](https://github.com/azusalina/someproducts/blob/master/d-ba/app.js): `d-ba/app.js`
- [Business lessons](https://github.com/azusalina/someproducts/blob/master/d-ba/lessons.js): `d-ba/lessons.js`
- [ICT learning app](https://github.com/azusalina/someproducts/blob/master/d-ict/app.js): `d-ict/app.js`
- [ICT lessons](https://github.com/azusalina/someproducts/blob/master/d-ict/lessons.js): `d-ict/lessons.js`
- [Algebra course app](https://github.com/azusalina/someproducts/blob/master/d-la/js/app.js): `d-la/js/app.js`
- [Lesson content](https://github.com/azusalina/someproducts/blob/master/d-la/js/lessons.js): `d-la/js/lessons.js`
- [Interactive labs](https://github.com/azusalina/someproducts/blob/master/d-la/js/lab.js): `d-la/js/lab.js`
- [Math operations](https://github.com/azusalina/someproducts/blob/master/d-la/js/math.js): `d-la/js/math.js`
- [Lab plots](https://github.com/azusalina/someproducts/blob/master/d-la/js/plots.js): `d-la/js/plots.js`
- [3D visualisation](https://github.com/azusalina/someproducts/blob/master/d-la/js/three-view.js): `d-la/js/three-view.js`
- [Field notes](https://github.com/azusalina/someproducts/blob/master/d-la/js/notes.js): `d-la/js/notes.js`
- [Shared UI helpers](https://github.com/azusalina/someproducts/blob/master/d-la/js/ui.js): `d-la/js/ui.js`

### Discovery tools

- [Repository explorer](https://github.com/azusalina/someproducts/blob/master/d-gitpop/src/app.js): `d-gitpop/src/app.js`
- [Repository catalogue](https://github.com/azusalina/someproducts/blob/master/d-gitpop/src/repos.js): `d-gitpop/src/repos.js`
- [Repository visuals](https://github.com/azusalina/someproducts/blob/master/d-gitpop/src/visuals.js): `d-gitpop/src/visuals.js`

### Planning tools

- [Programme path explorer](https://github.com/azusalina/someproducts/blob/master/d-jupasanalysis/app.js): `d-jupasanalysis/app.js`
- [Path simulation model](https://github.com/azusalina/someproducts/blob/master/d-jupasanalysis/model.mjs): `d-jupasanalysis/model.mjs`

### System utilities

- [Mediator HTTP service](https://github.com/azusalina/someproducts/blob/master/mediator/server.mjs): `mediator/server.mjs`
- [Port discovery](https://github.com/azusalina/someproducts/blob/master/mediator/lib/discovery.mjs): `mediator/lib/discovery.mjs`
- [Telemetry service](https://github.com/azusalina/someproducts/blob/master/monitor/core/backend/monitor_service.py): `monitor/core/backend/monitor_service.py`
- [Usage collection](https://github.com/azusalina/someproducts/blob/master/monitor/core/backend/usage.py): `monitor/core/backend/usage.py`
- [Reset announcements](https://github.com/azusalina/someproducts/blob/master/monitor/core/backend/reset_news.py): `monitor/core/backend/reset_news.py`
- [Connectivity checks](https://github.com/azusalina/someproducts/blob/master/monitor/core/backend/connectivity.py): `monitor/core/backend/connectivity.py`
- [Plasma dashboard](https://github.com/azusalina/someproducts/tree/master/monitor/core/plasmoid/contents/ui): `monitor/core/plasmoid/contents/ui`

### Other components

- **Learner / visitor**

## Connections

- Learner / visitor → Business lessons app: uses
- Learner / visitor → ICT learning app: uses
- Learner / visitor → Algebra course app: explores
- Learner / visitor → Repository explorer: explores
- Learner / visitor → Programme path explorer: simulates
- Algebra course app → Lesson content: loads lessons (evidence: `d-la/js/app.js`)
- Algebra course app → Interactive labs: mounts labs (evidence: `d-la/js/app.js`)
- Algebra course app → Field notes: renders notes (evidence: `d-la/js/app.js`)
- Algebra course app → Shared UI helpers: uses helpers (evidence: `d-la/js/app.js`)
- Interactive labs → Math operations: uses operations (evidence: `d-la/js/lab.js`)
- Interactive labs → Lab plots: uses plots (evidence: `d-la/js/lab.js`)
- Interactive labs → 3D visualisation: uses views (evidence: `d-la/js/lab.js`)
- Interactive labs → Shared UI helpers: renders math (evidence: `d-la/js/lab.js`)
- Field notes → Shared UI helpers: uses helpers (evidence: `d-la/js/notes.js`)
- Lab plots → Math operations: uses operations (evidence: `d-la/js/plots.js`)
- Repository explorer → Repository catalogue: selects repositories (evidence: `d-gitpop/src/app.js`)
- Repository explorer → Repository visuals: creates visuals (evidence: `d-gitpop/src/app.js`)
- Programme path explorer → Path simulation model: simulates paths (evidence: `d-jupasanalysis/app.js`)
- Mediator HTTP service → Port discovery: requests discovery (evidence: `mediator/server.mjs`)
- Telemetry service → Usage collection: collects usage (evidence: `monitor/core/backend/monitor_service.py`)
- Telemetry service → Reset announcements: collects news (evidence: `monitor/core/backend/monitor_service.py`)
- Telemetry service → Connectivity checks: checks connectivity (evidence: `monitor/core/backend/monitor_service.py`)
