# phillipai/100-days-of-code-python architecture

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

- Interactive diagram: https://gitdiagram.com/phillipai/100-days-of-code-python
- Repository: https://github.com/phillipai/100-days-of-code-python

## Overview

##### Overall Project Type and Purpose
- This repository is not a single unified application—it is a curated collection of individual projects/exercises developed over 100 days. Each “dayXX” directory contains its own mini-project that covers different technical topics ranging from basic Python scripting to full-stack web development and data science.
- The README categorizes projects into Beginner, Intermediate, Intermediate+, Advanced, and Professional Portfolio Projects. This categorization along with the diversity of technologies (from simple scripts to Flask applications, data science notebooks, and web scraping tools) should be clearly conveyed.

##### Analyzing the File Structure
- The top-level file tree is organized by “dayXX” directories, each representing a separate coding challenge with its own README and main script (and sometimes extra modules, assets, or data files).
- Some directories (e.g., day56, day57, day61, day62, etc.) have subdirectories like “static”, “templates”, or even additional documentation/PDFs. This indicates that some exercises employ web frameworks (mostly Flask) and even design patterns for organizing client-side and server-side concerns.
- Other days include Jupyter notebooks (notebooks, CSV, or data files) and even a few projects with external CSVs and configuration files.

##### Using Insights from the README
- It also outlines the evergreen themes: core Python concepts, object-oriented programming, GUI development (using Tkinter), web development (HTML, CSS, Flask), and data science techniques (using Pandas, NumPy, Matplotlib, etc.).

a. Main Components:
- The Repository Backbone: A high-level component that represents the organization of projects by day.
- Categories of Projects: Separate nodes for Beginner, Intermediate, Intermediate+, Advanced, and Portfolio Projects.
- Individual Project Modules: Within each category, each “dayXX” can be represented as a subcomponent. For example:
- “Day 07 – Hangman” (console game)
- “Day 15/16 – Coffee Machine and OOP practice”
- “Day 56/57 – Flask applications with static files and templates”
- “Day 71, 72, etc. – Data Science notebooks”
- Technology/Framework Specific Components: In projects where the structure is more layered, mark out:
- Frontend elements (HTML, CSS, JavaScript in Flask projects),
- Backend logic (main.py, server.py, etc.),
- Static assets (assets, static, templates directories),
- Data sources (CSV files, SQLite databases, etc.).

b. Relationships and Interactions:
- For data science projects, highlight the interaction between raw data (CSV files, databases) and analytical notebooks where processing and visualization occur.

c. Architectural Patterns and Design Principles:
- For Flask-based projects, explain that they generally adhere to a Model-View-Controller (MVC) or similar templating pattern.
- In gaming or GUI projects (Tkinter or Turtle), note that the design is event-driven.
- Importance of modularity as each “day” works as an independent, self-contained module that reinforces a particular programming concept.

d. Mention Key Technologies:
- Python 3 as the core language.
- For web development: Flask, Jinja templating, HTML5, CSS3, and Bootstrap (for styling).
- For data science: Jupyter Notebooks, Pandas, NumPy, Matplotlib, Plotly, Seaborn.
- Additional tools: Selenium, Beautiful Soup, Tkinter, and SQL (with SQLite/PostgreSQL in applicable days).

##### Elements
- Clear labels for each main component (e.g., “Day 07: Hangman Game”, “Day 61: Advanced Forms with Flask”, “Day 100: Multivariable Regression”).

- The overall structure of the repository as a compilation of multiple, independent projects.
- Grouping projects based on difficulty/technology (as per the README’s categories).
- For each project, show its component layers (code logic, UI, data source) as applicable.

## Diagram (Mermaid)

```mermaid
graph TD
    Repo["Repository Backbone"]:::repository

    %% Categories
    BeginnerCat["Beginner Projects"]:::category
    OOPCat["Coffee Machine & OOP"]:::category
    GUICat["GUI/Tkinter Projects"]:::category
    FlaskCat["Flask/Web Applications"]:::category
    DSCat["Data Science Notebooks"]:::category
    DPCat["Data Processing Projects"]:::category
    OtherCat["Other Standalone Projects"]:::category

    %% Beginner Projects
    CP["Console Projects (Days 01-10)"]:::beginner
    Hangman["Day 07: Hangman Game"]:::beginner

    %% Coffee Machine & OOP Projects
    Day15["Day 15: Coffee Machine"]:::oop
    Day16["Day 16: Coffee Machine & OOP"]:::oop

    %% GUI/Tkinter Project
    Day18["Day 18: GUI/Tkinter Project"]:::gui

    %% Flask/Web Applications
    Day56["Day 56: Flask App"]:::flask
    Day56Server["Day56: Server"]:::flaskDetail
    Day56Templates["Day56: Templates"]:::flaskDetail
    Day56Static["Day56: Static Assets"]:::flaskDetail
    Day57["Day 57: Flask App"]:::flask
    Day61["Day 61: Flask App"]:::flask
    Day62["Day 62: Flask App"]:::flask

    %% Data Science Notebooks
    Day71["Day 71: Data Science Notebook"]:::datasci
    Day72["Day 72: Data Notebook"]:::datasci
    Day100["Day 100: Data Science Notebook"]:::datasci

    %% Data Processing Projects
    Day24MM["Day 24: Mail Merge"]:::dataProc
    Day24Snake["Day 24: Snake Game"]:::dataProc

    %% Other Standalone Projects
    Day13["Day 13: Debugging Exercises"]:::other

    %% Connections from Repository to Categories
    Repo -->|"contains"| BeginnerCat
    Repo -->|"contains"| OOPCat
    Repo -->|"contains"| GUICat
    Repo -->|"contains"| FlaskCat
    Repo -->|"contains"| DSCat
    Repo -->|"contains"| DPCat
    Repo -->|"contains"| OtherCat

    %% Connections within Beginner Projects
    BeginnerCat -->|"includes"| CP
    BeginnerCat -->|"includes"| Hangman

    %% Connections within Coffee Machine & OOP Projects
    OOPCat -->|"includes"| Day15
    OOPCat -->|"includes"| Day16

    %% Connection within GUI/Tkinter Projects
    GUICat -->|"includes"| Day18

    %% Connections within Flask/Web Applications
    FlaskCat -->|"includes"| Day56
    FlaskCat -->|"includes"| Day57
    FlaskCat -->|"includes"| Day61
    FlaskCat -->|"includes"| Day62

    %% Detailed structure for Day56 Flask App
    Day56 -->|"core"| Day56Server
    Day56Server -->|"renders"| Day56Templates
    Day56Server -->|"serves"| Day56Static

    %% Connections within Data Science Notebooks
    DSCat -->|"includes"| Day71
    DSCat -->|"includes"| Day72
    DSCat -->|"includes"| Day100

    %% Connections within Data Processing Projects
    DPCat -->|"includes"| Day24MM
    DPCat -->|"includes"| Day24Snake

    %% Connection within Other Standalone Projects
    OtherCat -->|"includes"| Day13

    %% Click Events
    click Repo "https://github.com/phillipai/100-days-of-code-python/blob/main/README.md"
    click Hangman "https://github.com/phillipai/100-days-of-code-python/blob/main/day07/main.py"
    click Day15 "https://github.com/phillipai/100-days-of-code-python/blob/main/day15/main.py"
    click Day16 "https://github.com/phillipai/100-days-of-code-python/blob/main/day16/main.py"
    click Day18 "https://github.com/phillipai/100-days-of-code-python/blob/main/day18/main.py"
    click Day56Server "https://github.com/phillipai/100-days-of-code-python/blob/main/day56/server.py"
    click Day56Static "https://github.com/phillipai/100-days-of-code-python/tree/main/day56/static/"
    click Day56Templates "https://github.com/phillipai/100-days-of-code-python/blob/main/day56/templates/index.html"
    click Day57 "https://github.com/phillipai/100-days-of-code-python/blob/main/day57/main.py"
    click Day61 "https://github.com/phillipai/100-days-of-code-python/blob/main/day61/main.py"
    click Day62 "https://github.com/phillipai/100-days-of-code-python/blob/main/day62/main.py"
    click Day71 "https://github.com/phillipai/100-days-of-code-python/blob/main/day71/day71.ipynb"
    click Day72 "https://github.com/phillipai/100-days-of-code-python/blob/main/day72/day72.ipynb"
    click Day100 "https://github.com/phillipai/100-days-of-code-python/blob/main/day100/day100.ipynb"
    click Day24MM "https://github.com/phillipai/100-days-of-code-python/tree/main/day24/mail_merge/"
    click Day24Snake "https://github.com/phillipai/100-days-of-code-python/blob/main/day24/snake_game/main.py"
    click Day13 "https://github.com/phillipai/100-days-of-code-python/blob/main/day13/Exercise 1 - Debugging Odd or Even/main.py"

    %% Style Definitions
    classDef repository fill:#FFD700,stroke:#333,stroke-width:2px;
    classDef category fill:#87CEFA,stroke:#333,stroke-width:2px;
    classDef beginner fill:#90EE90,stroke:#333,stroke-width:1px;
    classDef oop fill:#ADD8E6,stroke:#333,stroke-width:1px;
    classDef gui fill:#FFA07A,stroke:#333,stroke-width:1px;
    classDef flask fill:#FFB6C1,stroke:#333,stroke-width:1px;
    classDef flaskDetail fill:#FFC0CB,stroke:#333,stroke-width:1px;
    classDef datasci fill:#DA70D6,stroke:#333,stroke-width:1px;
    classDef dataProc fill:#D3D3D3,stroke:#333,stroke-width:1px;
    classDef other fill:#AFEEEE,stroke:#333,stroke-width:1px;
```
