# obolensky-dev/go_education architecture

> Architecture diagram of the GitHub repository obolensky-dev/go_education, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-11-29). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/obolensky-dev/go_education
- Repository: https://github.com/obolensky-dev/go_education

## Overview

##### Project type and purpose
- This repository is an educational “Learn Go in 21 Days” course. It is not a running application or service but a structured set of lessons and accompanying exercise code.
- The README and Lessons.md define the curriculum; the Exercise folder contains day-wise code samples that learners compile and run.

##### File structure
- Top-level files:
- Readme.md – course overview and navigation
- Lessons.md – detailed syllabus and links to exercises
- .gitignore
- The “Exercise” directory has subfolders “1” through “14” (and beyond) containing Go source files (.go), compiled binaries (.exe), and helper scripts (play.cmd).
- Each numbered folder corresponds to a lesson/day, and within each, implementational examples target a single language feature.

##### README for additional insights
- The README explains day-by-day topics (variables, loops, structs, interfaces, goroutines, HTTP, databases, etc.).

a. Main components:
– Course Content Layer: Readme.md, Lessons.md, documentation files
– Examples Layer: Exercise/1, Exercise/2, … Exercise/21 folders with Go source, binaries, scripts
– Tooling Layer: Go compiler & runtime, optional IDEs (VS Code, GoLand)
– Learner Workflow: local machine where the learner runs ‘go build’, ‘go run’, or executes the provided .exe and .cmd
b. Relationships & interactions:
c. Architectural patterns & design principles:
– Modular organization by lesson (clear separation of concerns: each folder a self-contained exercise)
– Documentation-first approach (README and Lessons.md are primary entry points)
d. Key technologies/frameworks:
– Go language toolchain (go compiler, go modules if used)
– Windows batch script (play.cmd)
– Git for version control

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Filesystem
    Repo["Cloned Repository"]:::fs

    %% Course Content Layer
    subgraph "Course Content Layer"
        Readme["Readme.md"]:::doc
        Lessons["Lessons.md"]:::doc
    end

    %% Examples Layer
    subgraph "Examples Layer"
        subgraph "Exercises"
            E["Exercise/"]:::code
            subgraph "Day 1"
                D1main["main.go"]:::code
                D1years["years.go"]:::code
                D1cmd["play.cmd"]:::code
            end
            subgraph "Day 2"
                D2years["years.go"]:::code
            end
            subgraph "Day 3"
                D3if["ifelse.go"]:::code
                D3sw["swichcase.go"]:::code
            end
            subgraph "Day 4"
                D4fn["function.go"]:::code
            end
            subgraph "Day 5"
                D5for["for.go"]:::code
            end
            subgraph "Day 6"
                D6calc["calc.go"]:::code
            end
        end
    end

    %% Tooling Layer
    subgraph "Tooling Layer"
        GoTool["Go Compiler & Runtime"]:::tool
    end

    %% Learner Machine
    LearnerMachine["Learner Machine"]:::external

    %% Connections
    Repo --> Readme
    Repo --> Lessons
    Repo --> E
    Readme -->|references example code| E
    Lessons -->|links to exercises| E
    E -->|compiled with| GoTool
    GoTool -->|executes on| LearnerMachine
    LearnerMachine -->|cloned/pulled from| Repo

    %% Click Events
    click Readme "https://github.com/obolensky-dev/go_education/blob/master/Readme.md"
    click Lessons "https://github.com/obolensky-dev/go_education/blob/master/Lessons.md"
    click E "https://github.com/obolensky-dev/go_education/tree/master/Exercise/"
    click D1main "https://github.com/obolensky-dev/go_education/blob/master/Exercise/1/main.go"
    click D1years "https://github.com/obolensky-dev/go_education/blob/master/Exercise/1/years.go"
    click D1cmd "https://github.com/obolensky-dev/go_education/blob/master/Exercise/1/play.cmd"
    click D2years "https://github.com/obolensky-dev/go_education/blob/master/Exercise/2/years.go"
    click D3if "https://github.com/obolensky-dev/go_education/blob/master/Exercise/3/ifelse.go"
    click D3sw "https://github.com/obolensky-dev/go_education/blob/master/Exercise/3/swichcase.go"
    click D4fn "https://github.com/obolensky-dev/go_education/blob/master/Exercise/4/function.go"
    click D5for "https://github.com/obolensky-dev/go_education/blob/master/Exercise/5/for.go"
    click D6calc "https://github.com/obolensky-dev/go_education/blob/master/Exercise/6/calc.go"

    %% Styles
    classDef doc fill:#D0E8FF,stroke:#0366d6,color:#0366d6;
    classDef code fill:#E6FFED,stroke:#28a745,color:#22863a;
    classDef tool fill:#FFF5B1,stroke:#d73a49,color:#d73a49;
    classDef external fill:#F0F0F0,stroke:#666,color:#333;
    classDef fs fill:#F7F7F7,stroke:#999,color:#555,stroke-dasharray: 5 5;
```
