# spiroskrk/software-engineering-foundations architecture

> Architecture diagram of the GitHub repository spiroskrk/software-engineering-foundations, 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/spiroskrk/software-engineering-foundations
- Repository: https://github.com/spiroskrk/software-engineering-foundations

## Overview

This repository is a collection of Go learning projects, not one application. The main user-facing flows are ASCII-art rendering, file-based text transformation, and Sudoku solving or generation; Piscine Go is a broad collection of independent exercises and small command-line programs. The README documents capabilities beyond the sampled excerpts, so those are represented at subsystem level. Edges are limited to relationships shown in excerpts or described in the README; the exercise collection has no inferred internal pipeline.

Main entry points: [`ascii-art/internal/cli`](https://github.com/spiroskrk/software-engineering-foundations/tree/main/ascii-art/internal/cli) (CLI Modes), [`go-reloaded/main.go`](https://github.com/spiroskrk/software-engineering-foundations/blob/main/go-reloaded/main.go) (Application Entry), [`sudoku/main.go`](https://github.com/spiroskrk/software-engineering-foundations/blob/main/sudoku/main.go) (Sudoku CLI), [`go-reloaded/engine/processor.go`](https://github.com/spiroskrk/software-engineering-foundations/blob/main/go-reloaded/engine/processor.go) (Text Transformations)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ascii["ASCII Art"]
  node_ascii_cli["CLI Modes"]
  node_ascii_args["Argument Parsing<br/>[args.go]"]
  node_ascii_interactive["Interactive Mode<br/>[interactive.go]"]
  node_ascii_picker["Mode Picker<br/>[mode_picker.go]"]
  node_ascii_renderer["Banner Renderer"]
  node_ascii_fonts["Banner Parsing"]
end

subgraph group_reloaded["Go Reloaded"]
  node_reload_app["Application Entry<br/>[main.go]"]
  node_reload_cli["Argument Validation<br/>[cli.go]"]
  node_reload_input["File Input<br/>[fileio.go]"]
  node_reload_tokenizer["Tokenizer<br/>[tokenizer.go]"]
  node_reload_processor["Text Transformations<br/>[processor.go]"]
  node_reload_output["File Output<br/>[fileio.go]"]
end

subgraph group_piscine["Piscine Go"]
  node_piscine_algorithms["Algorithms"]
  node_piscine_strings["String Exercises"]
  node_piscine_lists["Linked Lists"]
  node_piscine_trees["Binary Trees"]
  node_piscine_cli["Standalone Commands"]
  node_quad_app["Quad CLI<br/>[main.go]"]
  node_quad_shapes["Quad Shapes"]
  node_quad_checker["Quad Checker<br/>[main.go]"]
end

subgraph group_sudoku["Sudoku"]
  node_sudoku_app["Sudoku CLI<br/>[main.go]"]
  node_sudoku_solver["Solver<br/>[solver.go]"]
  node_sudoku_generator["Generator<br/>[generator.go]"]
  node_sudoku_display["Board Display<br/>[display.go]"]
end

node_ascii_user(("CLI User"))
node_reload_user(("CLI User"))
node_sudoku_user(("CLI User"))

node_ascii_user -->|"provides input"| node_ascii_cli
node_ascii_cli -->|"validates arguments"| node_ascii_args
node_ascii_cli -->|"offers interaction"| node_ascii_interactive
node_ascii_cli -->|"selects mode"| node_ascii_picker
node_ascii_cli -->|"requests rendering"| node_ascii_renderer
node_ascii_renderer -->|"parses banners"| node_ascii_fonts
node_reload_user -->|"supplies paths"| node_reload_app
node_reload_app -->|"validates arguments"| node_reload_cli
node_reload_app -->|"reads file"| node_reload_input
node_reload_app -->|"processes text"| node_reload_processor
node_reload_app -->|"writes result"| node_reload_output
node_reload_processor -->|"uses tokens"| node_reload_tokenizer
node_reload_processor -->|"transforms text"| node_reload_processor
node_quad_app -->|"dispatches shape"| node_quad_shapes
node_sudoku_user -->|"chooses task"| node_sudoku_app
node_sudoku_app -->|"solves board"| node_sudoku_solver
node_sudoku_app -->|"generates boards"| node_sudoku_generator
node_sudoku_app -->|"prints board"| node_sudoku_display

click node_ascii_cli "https://github.com/spiroskrk/software-engineering-foundations/tree/main/ascii-art/internal/cli"
click node_ascii_args "https://github.com/spiroskrk/software-engineering-foundations/blob/main/ascii-art/internal/cli/args.go"
click node_ascii_interactive "https://github.com/spiroskrk/software-engineering-foundations/blob/main/ascii-art/internal/cli/interactive.go"
click node_ascii_picker "https://github.com/spiroskrk/software-engineering-foundations/blob/main/ascii-art/internal/cli/mode_picker.go"
click node_ascii_renderer "https://github.com/spiroskrk/software-engineering-foundations/tree/main/ascii-art"
click node_ascii_fonts "https://github.com/spiroskrk/software-engineering-foundations/tree/main/ascii-art"
click node_reload_app "https://github.com/spiroskrk/software-engineering-foundations/blob/main/go-reloaded/main.go"
click node_reload_cli "https://github.com/spiroskrk/software-engineering-foundations/blob/main/go-reloaded/engine/cli.go"
click node_reload_input "https://github.com/spiroskrk/software-engineering-foundations/blob/main/go-reloaded/engine/fileio.go"
click node_reload_tokenizer "https://github.com/spiroskrk/software-engineering-foundations/blob/main/go-reloaded/engine/tokenizer.go"
click node_reload_processor "https://github.com/spiroskrk/software-engineering-foundations/blob/main/go-reloaded/engine/processor.go"
click node_reload_output "https://github.com/spiroskrk/software-engineering-foundations/blob/main/go-reloaded/engine/fileio.go"
click node_piscine_algorithms "https://github.com/spiroskrk/software-engineering-foundations/tree/main/piscine-go/piscine-quests"
click node_piscine_strings "https://github.com/spiroskrk/software-engineering-foundations/tree/main/piscine-go/piscine-quests"
click node_piscine_lists "https://github.com/spiroskrk/software-engineering-foundations/tree/main/piscine-go/piscine-quests"
click node_piscine_trees "https://github.com/spiroskrk/software-engineering-foundations/tree/main/piscine-go/piscine-quests"
click node_piscine_cli "https://github.com/spiroskrk/software-engineering-foundations/tree/main/piscine-go/piscine-quests"
click node_quad_app "https://github.com/spiroskrk/software-engineering-foundations/blob/main/piscine-go/piscine-raids/quad/quad/main.go"
click node_quad_shapes "https://github.com/spiroskrk/software-engineering-foundations/tree/main/piscine-go/piscine-raids/quad/quad/piscine"
click node_quad_checker "https://github.com/spiroskrk/software-engineering-foundations/blob/main/piscine-go/piscine-raids/quadchecker/quadchecker/main.go"
click node_sudoku_app "https://github.com/spiroskrk/software-engineering-foundations/blob/main/sudoku/main.go"
click node_sudoku_solver "https://github.com/spiroskrk/software-engineering-foundations/blob/main/sudoku/utils/solver.go"
click node_sudoku_generator "https://github.com/spiroskrk/software-engineering-foundations/blob/main/sudoku/utils/generator.go"
click node_sudoku_display "https://github.com/spiroskrk/software-engineering-foundations/blob/main/sudoku/utils/display.go"

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_ascii_cli,node_ascii_args,node_ascii_interactive,node_ascii_picker,node_ascii_renderer,node_ascii_fonts,node_ascii_user,node_reload_user,node_sudoku_user toneBlue
class node_reload_app,node_reload_cli,node_reload_input,node_reload_tokenizer,node_reload_processor,node_reload_output toneAmber
class node_piscine_algorithms,node_piscine_strings,node_piscine_lists,node_piscine_trees,node_piscine_cli,node_quad_app,node_quad_shapes,node_quad_checker toneMint
class node_sudoku_app,node_sudoku_solver,node_sudoku_generator,node_sudoku_display toneRose
```

## Components

### ASCII Art

- [CLI Modes](https://github.com/spiroskrk/software-engineering-foundations/tree/main/ascii-art/internal/cli): `ascii-art/internal/cli`
- [Argument Parsing](https://github.com/spiroskrk/software-engineering-foundations/blob/main/ascii-art/internal/cli/args.go): `ascii-art/internal/cli/args.go`
- [Interactive Mode](https://github.com/spiroskrk/software-engineering-foundations/blob/main/ascii-art/internal/cli/interactive.go): `ascii-art/internal/cli/interactive.go`
- [Mode Picker](https://github.com/spiroskrk/software-engineering-foundations/blob/main/ascii-art/internal/cli/mode_picker.go): `ascii-art/internal/cli/mode_picker.go`
- [Banner Renderer](https://github.com/spiroskrk/software-engineering-foundations/tree/main/ascii-art): `ascii-art`
- [Banner Parsing](https://github.com/spiroskrk/software-engineering-foundations/tree/main/ascii-art): `ascii-art`

### Go Reloaded

- [Application Entry](https://github.com/spiroskrk/software-engineering-foundations/blob/main/go-reloaded/main.go): `go-reloaded/main.go`
- [Argument Validation](https://github.com/spiroskrk/software-engineering-foundations/blob/main/go-reloaded/engine/cli.go): `go-reloaded/engine/cli.go`
- [File Input](https://github.com/spiroskrk/software-engineering-foundations/blob/main/go-reloaded/engine/fileio.go): `go-reloaded/engine/fileio.go`
- [Tokenizer](https://github.com/spiroskrk/software-engineering-foundations/blob/main/go-reloaded/engine/tokenizer.go): `go-reloaded/engine/tokenizer.go`
- [Text Transformations](https://github.com/spiroskrk/software-engineering-foundations/blob/main/go-reloaded/engine/processor.go): `go-reloaded/engine/processor.go`
- [File Output](https://github.com/spiroskrk/software-engineering-foundations/blob/main/go-reloaded/engine/fileio.go): `go-reloaded/engine/fileio.go`

### Piscine Go

- [Algorithms](https://github.com/spiroskrk/software-engineering-foundations/tree/main/piscine-go/piscine-quests): `piscine-go/piscine-quests`
- [String Exercises](https://github.com/spiroskrk/software-engineering-foundations/tree/main/piscine-go/piscine-quests): `piscine-go/piscine-quests`
- [Linked Lists](https://github.com/spiroskrk/software-engineering-foundations/tree/main/piscine-go/piscine-quests): `piscine-go/piscine-quests`
- [Binary Trees](https://github.com/spiroskrk/software-engineering-foundations/tree/main/piscine-go/piscine-quests): `piscine-go/piscine-quests`
- [Standalone Commands](https://github.com/spiroskrk/software-engineering-foundations/tree/main/piscine-go/piscine-quests): `piscine-go/piscine-quests`
- [Quad CLI](https://github.com/spiroskrk/software-engineering-foundations/blob/main/piscine-go/piscine-raids/quad/quad/main.go): `piscine-go/piscine-raids/quad/quad/main.go`
- [Quad Shapes](https://github.com/spiroskrk/software-engineering-foundations/tree/main/piscine-go/piscine-raids/quad/quad/piscine): `piscine-go/piscine-raids/quad/quad/piscine`
- [Quad Checker](https://github.com/spiroskrk/software-engineering-foundations/blob/main/piscine-go/piscine-raids/quadchecker/quadchecker/main.go): `piscine-go/piscine-raids/quadchecker/quadchecker/main.go`

### Sudoku

- [Sudoku CLI](https://github.com/spiroskrk/software-engineering-foundations/blob/main/sudoku/main.go): `sudoku/main.go`
- [Solver](https://github.com/spiroskrk/software-engineering-foundations/blob/main/sudoku/utils/solver.go): `sudoku/utils/solver.go`
- [Generator](https://github.com/spiroskrk/software-engineering-foundations/blob/main/sudoku/utils/generator.go): `sudoku/utils/generator.go`
- [Board Display](https://github.com/spiroskrk/software-engineering-foundations/blob/main/sudoku/utils/display.go): `sudoku/utils/display.go`

### Other components

- **CLI User**
- **CLI User**
- **CLI User**

## Connections

- CLI User → CLI Modes: provides input (evidence: `README.md`)
- CLI Modes → Argument Parsing: validates arguments (evidence: `README.md`)
- CLI Modes → Interactive Mode: offers interaction (evidence: `README.md`)
- CLI Modes → Mode Picker: selects mode (evidence: `README.md`)
- CLI Modes → Banner Renderer: requests rendering (evidence: `README.md`)
- Banner Renderer → Banner Parsing: parses banners (evidence: `README.md`)
- CLI User → Application Entry: supplies paths (evidence: `README.md`)
- Application Entry → Argument Validation: validates arguments (evidence: `go-reloaded/main.go`)
- Application Entry → File Input: reads file (evidence: `go-reloaded/main.go`)
- Application Entry → Text Transformations: processes text (evidence: `go-reloaded/main.go`)
- Application Entry → File Output: writes result (evidence: `go-reloaded/main.go`)
- Text Transformations → Tokenizer: uses tokens (evidence: `README.md`)
- Text Transformations → Text Transformations: transforms text (evidence: `README.md`)
- Quad CLI → Quad Shapes: dispatches shape (evidence: `piscine-go/piscine-raids/quad/quad/main.go`)
- CLI User → Sudoku CLI: chooses task (evidence: `sudoku/main.go`)
- Sudoku CLI → Solver: solves board (evidence: `sudoku/main.go`)
- Sudoku CLI → Generator: generates boards (evidence: `sudoku/main.go`)
- Sudoku CLI → Board Display: prints board (evidence: `sudoku/main.go`)
