# elvintaghizade14/java-course-turing-1-classes architecture

> Architecture diagram of the GitHub repository elvintaghizade14/java-course-turing-1-classes, 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/elvintaghizade14/java-course-turing-1-classes
- Repository: https://github.com/elvintaghizade14/java-course-turing-1-classes

## Overview

##### Project Type & Purpose
- This is not a standard production system but rather an educational repository. It contains multiple sample applications illustrating various Java concepts as well as full-fledged Spring Boot sample applications.
- The “spring-boot-01” and “spring-boot-03” directories are complete Spring Boot applications (using both Gradle and Maven in different parts). They demonstrate a typical web/MVC architecture.
- The “src” folder further holds a series of educational modules (module01, module02, …, module05, as well as _general and _reading folders) that provide lesson materials, code examples, and even some mini-project or step-project tasks.

##### Analyzing the File Structure
- Top-Level Files:
- Files like .gitignore, pom.xml (suggesting Maven support for at least part of the project), and the IntelliJ reference indicate IDE setup and build configuration.
- Spring Boot Applications:
- Under “spring-boot-01” and “spring-boot-03”, you see common components:
▸ A “src/main/java/…” structure with packages for controllers, models/domain, configurations, services, and repositories.
▸ For example, “HelloController.java”, “StudentController.java”, and corresponding service/repository classes show classic MVC separation.
▸ Configuration files (application.properties) and Gradle build scripts indicate how these applications are deployed.
- Educational Content:
- The “src/main/java/az/edu/turing/” directory holds folders named “module01”, “module02”, etc., and each module is organized by lessons (lesson01, lesson02, …). There are also folders for additional resources (_general, _reading) and tasks.
- There are plenty of README.md files spread across these modules, which likely provide context and instructions for the lessons.

##### Main Components
- Overall Container: Label it “java-course-turing-1-classes” (the project name) as the main boundary.
- Spring Boot Sample Applications:
▸ Presentation Layer (Controllers): e.g., HelloController and StudentController.
▸ Service Layer: StudentService (and its implementation).
▸ Data Access Layer: Repositories (InMemoryStudentRepository, StudentRepository) and entity/model classes.
▸ Configuration: Application configurations (DataSourceConfig, application.properties).
▸ Testing: Test directories as separate subcomponents connected to the main app.
- Educational Modules & Lessons:
- A general resource block for “_general” and “_reading” which hold syllabus PDFs, remote resource lists, and technical reading material.
- Testing & Utility Components:
- A separate component for “src/test” illustrating test cases and unit/integration tests.
- External resources like the IntelliJ PDF reference in a utility/documentation component.

##### Relationships & Interactions
- For the Spring Boot applications:
- For the educational modules:
- A one-to-many relation (or segmented block) indicating multiple lessons within each module that are independent code samples or slightly evolving examples.
- The teaching resources (_general and _reading) connect to all modules as reference material.
- Testing components should be drawn as parallel or overlay layers that feed into the respective application modules.

##### Architectural Patterns & Design Principles
- The Spring Boot apps illustrate the MVC pattern clearly, and in “spring-boot-03” you also see a layered structure (configurations, domain, repository, and services).
- Many modules display procedural or basic object-oriented principles. They might not interact in the same way a production system does but are organized to show code organizational best practices.
- That the design is modular to support both full application examples and “lesson-based” examples that can be explored in isolation.

## Diagram (Mermaid)

```mermaid
flowchart TD
    A["java-course-turing-1-classes"]:::container

    subgraph "Spring Boot Applications"
        subgraph "spring-boot-01"
            S1_E["Application Entry"]:::spring
            S1_C["Controllers"]:::spring
            S1_M["Domain/Model"]:::spring
            S1_CR["Configuration & Resources"]:::spring
            S1_T["Testing"]:::spring
            S1_E -->|"calls"| S1_C
            S1_C -->|"processes"| S1_M
            S1_M -->|"configured_by"| S1_CR
            S1_CR -->|"verified_by"| S1_T
        end
        subgraph "spring-boot-03"
            S3_E["Application Entry"]:::spring
            S3_C["Controllers"]:::spring
            S3_CFG["Configuration"]:::spring
            S3_S["Service Layer"]:::spring
            S3_DR["Domain & Repository"]:::spring
            S3_RT["Resources & Testing"]:::spring
            S3_E -->|"calls"| S3_C
            S3_C -->|"delegates_to"| S3_S
            S3_S -->|"manages"| S3_DR
            S3_CFG -->|"applies_to"| S3_RT
        end
    end

    subgraph "Educational Modules & Lessons"
        EM["Modules Container"]:::module
        M1["Module 01"]:::module
        M2["Module 02"]:::module
        M3["Module 03"]:::module
        M4["Module 04"]:::module
        M5["Module 05"]:::module
        GR["General Resources (_general)"]:::module
        RD["Reading Materials (_reading)"]:::module
        EM --> M1
        EM --> M2
        EM --> M3
        EM --> M4
        EM --> M5
        EM --> GR
        EM --> RD
    end

    subgraph "Testing & Utility Components"
        T["General Tests"]:::util
        D["IntelliJ IDEA Reference Card"]:::util
        T --> D
    end

    A -->|"contains"| S1_E
    A -->|"contains"| S3_E
    A -->|"contains"| EM
    A -->|"contains"| T

    click A "https://github.com/elvintaghizade14/java-course-turing-1-classes/tree/main/java-course-turing-1-classes"

    %% Click events for spring-boot-01 components
    click S1_E "https://github.com/elvintaghizade14/java-course-turing-1-classes/blob/main/spring-boot-01/src/main/java/az/edu/turing/springboot01/SpringBootApplication.java"
    click S1_C "https://github.com/elvintaghizade14/java-course-turing-1-classes/tree/main/spring-boot-01/src/main/java/az/edu/turing/springboot01/controller"
    click S1_M "https://github.com/elvintaghizade14/java-course-turing-1-classes/tree/main/spring-boot-01/src/main/java/az/edu/turing/springboot01/model"
    click S1_CR "https://github.com/elvintaghizade14/java-course-turing-1-classes/tree/main/spring-boot-01/src/main/resources"
    click S1_T "https://github.com/elvintaghizade14/java-course-turing-1-classes/tree/main/spring-boot-01/src/test/java/az/edu/turing/springboot01"

    %% Click events for spring-boot-03 components
    click S3_E "https://github.com/elvintaghizade14/java-course-turing-1-classes/blob/main/spring-boot-03/src/main/java/az/edu/turing/springboot03/SpringBoot03Application.java"
    click S3_C "https://github.com/elvintaghizade14/java-course-turing-1-classes/tree/main/spring-boot-03/src/main/java/az/edu/turing/springboot03/controller"
    click S3_CFG "https://github.com/elvintaghizade14/java-course-turing-1-classes/tree/main/spring-boot-03/src/main/java/az/edu/turing/springboot03/config"
    click S3_S "https://github.com/elvintaghizade14/java-course-turing-1-classes/tree/main/spring-boot-03/src/main/java/az/edu/turing/springboot03/service"
    click S3_DR "https://github.com/elvintaghizade14/java-course-turing-1-classes/tree/main/spring-boot-03/src/main/java/az/edu/turing/springboot03/domain"
    click S3_RT "https://github.com/elvintaghizade14/java-course-turing-1-classes/tree/main/spring-boot-03/src/test/java/az/edu/turing/springboot03"

    %% Click events for Educational Modules & Lessons
    click EM "https://github.com/elvintaghizade14/java-course-turing-1-classes/tree/main/src/main/java/az/edu/turing/"
    click M1 "https://github.com/elvintaghizade14/java-course-turing-1-classes/tree/main/src/main/java/az/edu/turing/module01"
    click M2 "https://github.com/elvintaghizade14/java-course-turing-1-classes/tree/main/src/main/java/az/edu/turing/module02"
    click M3 "https://github.com/elvintaghizade14/java-course-turing-1-classes/tree/main/src/main/java/az/edu/turing/module03"
    click M4 "https://github.com/elvintaghizade14/java-course-turing-1-classes/tree/main/src/main/java/az/edu/turing/module04"
    click M5 "https://github.com/elvintaghizade14/java-course-turing-1-classes/tree/main/src/main/java/az/edu/turing/module05"
    click GR "https://github.com/elvintaghizade14/java-course-turing-1-classes/tree/main/src/main/java/az/edu/turing/_general"
    click RD "https://github.com/elvintaghizade14/java-course-turing-1-classes/tree/main/src/main/java/az/edu/turing/_reading"

    %% Click events for Testing & Utility Components
    click T "https://github.com/elvintaghizade14/java-course-turing-1-classes/tree/main/src/test/java/az/edu/turing"
    click D "https://github.com/elvintaghizade14/java-course-turing-1-classes/blob/main/IntelliJIDEA_ReferenceCard.pdf"

    classDef container fill:#FADBD8,stroke:#C0392B,stroke-width:2px;
    classDef spring fill:#AED6F1,stroke:#34495E,stroke-width:2px;
    classDef module fill:#F9E79F,stroke:#7D6608,stroke-width:2px;
    classDef util fill:#D5F5E3,stroke:#229954,stroke-width:2px;
```
