# ketz7/aoc architecture

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

- Interactive diagram: https://gitdiagram.com/ketz7/aoc
- Repository: https://github.com/ketz7/aoc

## Overview

This project is a collection of Python solutions for the Advent of Code 2024 challenges. The overall purpose is to solve each day’s puzzle with its own script, and common functionalities might be shared across these scripts using a dedicated helper module.

##### Main Components
- Advent of Code Project: Represent the overall project container.
- Daily Solution Modules: Each file named “day_01.py” through “day_25.py” is an independent component that implements the solution for that day.
- Common Helper Module: “aoc_helper.py” is a shared module likely used by various daily solution files.

##### Relationships and Interactions
- That all these modules are part of one project repository dedicated to solving Advent of Code puzzles.

##### Architectural Patterns and Design Principles
- Modularity: Clear separation of each day’s solution into its own module.
- Reusability: A common helper module that serves as a utility library for repeated or shared functionality.
- Simplicity: Straightforward structure with one folder that contains all the solution scripts; you do not have a multi-tier architecture like a full-stack application.

## Diagram (Mermaid)

```mermaid
flowchart TD
    project["Advent of Code 2024"]:::project
    interpreter["Python Interpreter"]:::runtime

    subgraph "Daily Solution Modules"
        day01["day_01.py"]:::daily
        day02["day_02.py"]:::daily
        day03["day_03.py"]:::daily
        day04["day_04.py"]:::daily
        day05["day_05.py"]:::daily
        day06["day_06.py"]:::daily
        day07["day_07.py"]:::daily
        day08["day_08.py"]:::daily
        day09["day_09.py"]:::daily
        day10["day_10.py"]:::daily
        day11["day_11.py"]:::daily
        day12["day_12.py"]:::daily
        day13["day_13.py"]:::daily
        day14["day_14.py"]:::daily
        day15["day_15.py"]:::daily
        day16["day_16.py"]:::daily
        day17["day_17.py"]:::daily
        day18["day_18.py"]:::daily
        day19["day_19.py"]:::daily
        day20["day_20.py"]:::daily
        day21["day_21.py"]:::daily
        day22["day_22.py"]:::daily
        day23["day_23.py"]:::daily
        day24["day_24.py"]:::daily
        day25["day_25.py"]:::daily
    end

    helper["aoc_helper.py"]:::helper

    %% Relationships
    project --> interpreter
    project --> day01
    project --> day02
    project --> day03
    project --> day04
    project --> day05
    project --> day06
    project --> day07
    project --> day08
    project --> day09
    project --> day10
    project --> day11
    project --> day12
    project --> day13
    project --> day14
    project --> day15
    project --> day16
    project --> day17
    project --> day18
    project --> day19
    project --> day20
    project --> day21
    project --> day22
    project --> day23
    project --> day24
    project --> day25
    project --> helper

    %% Each Daily Module imports the common helper
    day01 -->|"imports"| helper
    day02 -->|"imports"| helper
    day03 -->|"imports"| helper
    day04 -->|"imports"| helper
    day05 -->|"imports"| helper
    day06 -->|"imports"| helper
    day07 -->|"imports"| helper
    day08 -->|"imports"| helper
    day09 -->|"imports"| helper
    day10 -->|"imports"| helper
    day11 -->|"imports"| helper
    day12 -->|"imports"| helper
    day13 -->|"imports"| helper
    day14 -->|"imports"| helper
    day15 -->|"imports"| helper
    day16 -->|"imports"| helper
    day17 -->|"imports"| helper
    day18 -->|"imports"| helper
    day19 -->|"imports"| helper
    day20 -->|"imports"| helper
    day21 -->|"imports"| helper
    day22 -->|"imports"| helper
    day23 -->|"imports"| helper
    day24 -->|"imports"| helper
    day25 -->|"imports"| helper

    %% Click Events
    click project "https://github.com/ketz7/aoc/tree/main/aoc 2024"
    click day01 "https://github.com/ketz7/aoc/blob/main/aoc 2024/day_01.py"
    click day02 "https://github.com/ketz7/aoc/blob/main/aoc 2024/day_02.py"
    click day03 "https://github.com/ketz7/aoc/blob/main/aoc 2024/day_03.py"
    click day04 "https://github.com/ketz7/aoc/blob/main/aoc 2024/day_04.py"
    click day05 "https://github.com/ketz7/aoc/blob/main/aoc 2024/day_05.py"
    click day06 "https://github.com/ketz7/aoc/blob/main/aoc 2024/day_06.py"
    click day07 "https://github.com/ketz7/aoc/blob/main/aoc 2024/day_07.py"
    click day08 "https://github.com/ketz7/aoc/blob/main/aoc 2024/day_08.py"
    click day09 "https://github.com/ketz7/aoc/blob/main/aoc 2024/day_09.py"
    click day10 "https://github.com/ketz7/aoc/blob/main/aoc 2024/day_10.py"
    click day11 "https://github.com/ketz7/aoc/blob/main/aoc 2024/day_11.py"
    click day12 "https://github.com/ketz7/aoc/blob/main/aoc 2024/day_12.py"
    click day13 "https://github.com/ketz7/aoc/blob/main/aoc 2024/day_13.py"
    click day14 "https://github.com/ketz7/aoc/blob/main/aoc 2024/day_14.py"
    click day15 "https://github.com/ketz7/aoc/blob/main/aoc 2024/day_15.py"
    click day16 "https://github.com/ketz7/aoc/blob/main/aoc 2024/day_16.py"
    click day17 "https://github.com/ketz7/aoc/blob/main/aoc 2024/day_17.py"
    click day18 "https://github.com/ketz7/aoc/blob/main/aoc 2024/day_18.py"
    click day19 "https://github.com/ketz7/aoc/blob/main/aoc 2024/day_19.py"
    click day20 "https://github.com/ketz7/aoc/blob/main/aoc 2024/day_20.py"
    click day21 "https://github.com/ketz7/aoc/blob/main/aoc 2024/day_21.py"
    click day22 "https://github.com/ketz7/aoc/blob/main/aoc 2024/day_22.py"
    click day23 "https://github.com/ketz7/aoc/blob/main/aoc 2024/day_23.py"
    click day24 "https://github.com/ketz7/aoc/blob/main/aoc 2024/day_24.py"
    click day25 "https://github.com/ketz7/aoc/blob/main/aoc 2024/day_25.py"
    click helper "https://github.com/ketz7/aoc/blob/main/aoc 2024/aoc_helper.py"

    %% Styles
    classDef project fill:#FFD700,stroke:#333,stroke-width:2px;
    classDef daily fill:#87CEEB,stroke:#333,stroke-width:2px;
    classDef helper fill:#90EE90,stroke:#333,stroke-width:2px;
    classDef runtime fill:#FFB6C1,stroke:#333,stroke-width:2px;
```
