# alekzandev/12w-py-training architecture

> Architecture diagram of the GitHub repository alekzandev/12w-py-training, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-05-22). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/alekzandev/12w-py-training
- Repository: https://github.com/alekzandev/12w-py-training

## Overview

##### Project type and purpose
- Type: An educational curriculum “system” comprising sequential learning modules, practice components, and projects.
- Purpose: Take a learner from zero to a full-fledged Python application over 12 weeks.

##### Main components
a. Learning Modules (Weeks 1–2, 3–4, 5–6, 7–8, 9–10, 11–12)
– Each module encapsulates Topics, Daily Time Allocation, and an End-of-Week Project.
b. Daily Workflow Blocks
– Study/Practice block (2h), Coding Challenges block (1h), Project/Review block (1h)
c. External Resources
– Codecademy, Coursera, Python.org, HackerRank, LeetCode, Real Python, etc.
d. Feedback & Validation
– Code Reviews (GitHub), Automated Testing (unittest/pytest), Documentation
e. Capstone Project System
– Web app (Flask/Django), Database (SQLite), REST API layer

##### Relationships and Data Flows
- Within each Module, dependencies:
– Study → Challenges → End-of-Week Project → Review/Feedback → Next Module.
- Feedback loop from Reviews/Tests back into the learner’s code artifacts.

##### Architectural patterns and design principles
- Layered Architecture:
– Presentation Layer: Learning content/resources
– Application Layer: Practice exercises & mini-projects
– Persistence Layer: Code submissions, project artifacts, tests
- Iterative Feedback Loop: Emphasize the “Review → Improve” cycle each week.
- Modular Breakdown: Six self-contained modules that can be rearranged or extended.

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% External Resources
    subgraph "External Resources"
        direction TB
        E1("Codecademy"):::cloud
        E2("Coursera"):::cloud
        E3("Python.org"):::cloud
        E4("HackerRank"):::cloud
        E5("LeetCode"):::cloud
        E6("Real Python"):::cloud
    end

    %% Module Week 1-2
    subgraph "Week 1–2: Basics & Syntax"
        direction TB
        M1_Study("Study (2h)"):::study
        M1_Challenges("Coding Challenges (1h)"):::practice
        M1_Project("End-of-Week Project"):::project
        M1_Review("Review & Feedback"):::review
        M1_Study-->M1_Challenges-->M1_Project-->M1_Review
    end

    %% Module Week 3-4
    subgraph "Week 3–4: Data Structures & File I/O"
        direction TB
        M2_Study("Study (2h)"):::study
        M2_Challenges("Coding Challenges (1h)"):::practice
        M2_Project("End-of-Week Project"):::project
        M2_Review("Review & Feedback"):::review
        M2_Study-->M2_Challenges-->M2_Project-->M2_Review
    end

    %% Module Week 5-6
    subgraph "Week 5–6: OOP & Modules"
        direction TB
        M3_Study("Study (2h)"):::study
        M3_Challenges("Coding Challenges (1h)"):::practice
        M3_Project("End-of-Week Project"):::project
        M3_Review("Review & Feedback"):::review
        M3_Study-->M3_Challenges-->M3_Project-->M3_Review
    end

    %% Module Week 7-8
    subgraph "Week 7–8: Web Basics (Flask/Django)"
        direction TB
        M4_Study("Study (2h)"):::study
        M4_Challenges("Coding Challenges (1h)"):::practice
        M4_Project("End-of-Week Project"):::project
        M4_Review("Review & Feedback"):::review
        M4_Study-->M4_Challenges-->M4_Project-->M4_Review
    end

    %% Module Week 9-10
    subgraph "Week 9–10: SOLID & Design Patterns"
        direction TB
        M5_Study("Study (2h)"):::study
        M5_Challenges("Coding Challenges (1h)"):::practice
        M5_Project("End-of-Week Project"):::project
        M5_Review("Review & Feedback"):::review
        M5_Study-->M5_Challenges-->M5_Project-->M5_Review
    end

    %% Module Week 11-12
    subgraph "Week 11–12: Final Project & Integration"
        direction TB
        M6_Study("Study (2h)"):::study
        M6_Challenges("Coding Challenges (1h)"):::practice
        M6_Project("End-of-Week Project"):::project
        M6_Review("Review & Feedback"):::review
        M6_Study-->M6_Challenges-->M6_Project-->M6_Review
    end

    %% Workflow Connections
    M1_Review-->|"Knowledge →"|M2_Study
    M2_Review-->|"Knowledge →"|M3_Study
    M3_Review-->|"Knowledge →"|M4_Study
    M4_Review-->|"Knowledge →"|M5_Study
    M5_Review-->|"Knowledge →"|M6_Study

    %% External Resources to Studies
    E1-->M1_Study
    E2-->M1_Study
    E3-->M2_Study
    E4-->M3_Study
    E5-->M4_Study
    E6-->M5_Study

    %% Capstone Project
    subgraph "Capstone Project"
        direction TB
        UI("Flask/Django UI"):::frontend
        API("REST API Layer"):::backend
        DB("SQLite Database"):::database
        UI-->API-->DB
    end

    %% Final Integration
    M6_Review-->|"Deliverable →"|UI

    %% Styles
    classDef study fill:#FFD700,stroke:#333,stroke-width:1px
    classDef practice fill:#ADFF2F,stroke:#333,stroke-width:1px
    classDef project fill:#87CEFA,stroke:#333,stroke-width:1px
    classDef review fill:#FFB6C1,stroke:#333,stroke-width:1px
    classDef cloud fill:#B0E0E6,stroke:#333,stroke-width:1px
    classDef frontend fill:#ADD8E6,stroke:#333,stroke-width:1px
    classDef backend fill:#D3D3D3,stroke:#333,stroke-width:1px
    classDef database fill:#FFE4C4,stroke:#333,stroke-width:1px
```
