# cultura15/jsrc architecture

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

- Interactive diagram: https://gitdiagram.com/cultura15/jsrc
- Repository: https://github.com/cultura15/jsrc

## Overview

This repository supports a JavaScript self-study plan: learners work through five topic sections, track completion, create topic scaffolds, and record learning notes. The sampled source confirms progress reporting, topic creation, and note logging; the section README contents were not provided, so their learning stages are represented only by their directory names.

Main entry points: [`package.json`](https://github.com/cultura15/jsrc/blob/main/package.json) (Command entrypoints), [`tools/new-topic.js`](https://github.com/cultura15/jsrc/blob/main/tools/new-topic.js) (Topic creator), [`tools/progress.js`](https://github.com/cultura15/jsrc/blob/main/tools/progress.js) (Progress reporter), [`tools/learning-log.js`](https://github.com/cultura15/jsrc/blob/main/tools/learning-log.js) (Learning logger)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_curriculum["Learning curriculum"]
  node_language["Language<br/>[README.md]"]
  node_async["Async runtime<br/>[README.md]"]
  node_browser["Browser<br/>[README.md]"]
  node_frontend["Frontend<br/>[README.md]"]
  node_backend["Node backend<br/>[README.md]"]
end

subgraph group_tracking["Progress tracking"]
  node_progress_data[("Topic progress<br/>[progress.json]")]
  node_progress_output["Progress report"]
  node_learning_notes["Learning notes"]
end

subgraph group_tools["Learner tools"]
  node_commands["Command entrypoints<br/>[package.json]"]
  node_progress_tool["Progress reporter<br/>[progress.js]"]
  node_topic_tool["Topic creator<br/>[new-topic.js]"]
  node_log_tool["Learning logger<br/>[learning-log.js]"]
end

node_learner(("Learner"))

node_learner -->|"runs commands"| node_commands
node_commands -->|"runs progress"| node_progress_tool
node_commands -->|"creates topic"| node_topic_tool
node_commands -->|"logs lesson"| node_log_tool
node_commands -->|"studies"| node_language
node_commands -->|"studies"| node_async
node_commands -->|"studies"| node_browser
node_commands -->|"studies"| node_frontend
node_commands -->|"studies"| node_backend
node_progress_tool -->|"reads"| node_progress_data
node_progress_tool -->|"writes"| node_progress_output
node_topic_tool -->|"creates topics in"| node_language
node_topic_tool -->|"creates topics in"| node_async
node_topic_tool -->|"creates topics in"| node_browser
node_topic_tool -->|"creates topics in"| node_frontend
node_topic_tool -->|"creates topics in"| node_backend
node_log_tool -->|"appends notes"| node_learning_notes

click node_language "https://github.com/cultura15/jsrc/blob/main/01-language/README.md"
click node_async "https://github.com/cultura15/jsrc/blob/main/02-runtime-async/README.md"
click node_browser "https://github.com/cultura15/jsrc/blob/main/03-browser/README.md"
click node_frontend "https://github.com/cultura15/jsrc/blob/main/04-frontend/README.md"
click node_backend "https://github.com/cultura15/jsrc/blob/main/05-node-backend/README.md"
click node_commands "https://github.com/cultura15/jsrc/blob/main/package.json"
click node_progress_tool "https://github.com/cultura15/jsrc/blob/main/tools/progress.js"
click node_topic_tool "https://github.com/cultura15/jsrc/blob/main/tools/new-topic.js"
click node_log_tool "https://github.com/cultura15/jsrc/blob/main/tools/learning-log.js"
click node_progress_data "https://github.com/cultura15/jsrc/blob/main/.masterplan/progress.json"

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_language,node_async,node_browser,node_frontend,node_backend toneBlue
class node_progress_data,node_progress_output,node_learning_notes toneAmber
class node_commands,node_progress_tool,node_topic_tool,node_log_tool toneMint
class node_learner toneIndigo
```

## Components

### Learning curriculum

- [Language](https://github.com/cultura15/jsrc/blob/main/01-language/README.md): `01-language/README.md`
- [Async runtime](https://github.com/cultura15/jsrc/blob/main/02-runtime-async/README.md): `02-runtime-async/README.md`
- [Browser](https://github.com/cultura15/jsrc/blob/main/03-browser/README.md): `03-browser/README.md`
- [Frontend](https://github.com/cultura15/jsrc/blob/main/04-frontend/README.md): `04-frontend/README.md`
- [Node backend](https://github.com/cultura15/jsrc/blob/main/05-node-backend/README.md): `05-node-backend/README.md`

### Progress tracking

- [Topic progress](https://github.com/cultura15/jsrc/blob/main/.masterplan/progress.json): `.masterplan/progress.json`
- **Progress report**
- **Learning notes**

### Learner tools

- [Command entrypoints](https://github.com/cultura15/jsrc/blob/main/package.json): `package.json`
- [Progress reporter](https://github.com/cultura15/jsrc/blob/main/tools/progress.js): `tools/progress.js`
- [Topic creator](https://github.com/cultura15/jsrc/blob/main/tools/new-topic.js): `tools/new-topic.js`
- [Learning logger](https://github.com/cultura15/jsrc/blob/main/tools/learning-log.js): `tools/learning-log.js`

### Other components

- **Learner**

## Connections

- Learner → Command entrypoints: runs commands
- Command entrypoints → Progress reporter: runs progress
- Command entrypoints → Topic creator: creates topic
- Command entrypoints → Learning logger: logs lesson
- Command entrypoints → Language: studies
- Command entrypoints → Async runtime: studies
- Command entrypoints → Browser: studies
- Command entrypoints → Frontend: studies
- Command entrypoints → Node backend: studies
- Progress reporter → Topic progress: reads
- Progress reporter → Progress report: writes
- Topic creator → Language: creates topics in
- Topic creator → Async runtime: creates topics in
- Topic creator → Browser: creates topics in
- Topic creator → Frontend: creates topics in
- Topic creator → Node backend: creates topics in
- Learning logger → Learning notes: appends notes
