# apodwikat/aydinuniversity-courses-projects architecture

> Architecture diagram of the GitHub repository apodwikat/aydinuniversity-courses-projects, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-06-07). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/apodwikat/aydinuniversity-courses-projects
- Repository: https://github.com/apodwikat/aydinuniversity-courses-projects

## Overview

##### Project types and purposes
- At the solution root you have two distinct projects:
a) SoftwareDesignApplication – a multi-layer .NET e-commerce/order management system, consisting of Data, Entities, Service, WebAPI (REST), and an ASP.NET MVC/WebUI front end.
b) UniTrack – a Java Swing-style desktop application for student/course/enrollment management with a local database backend.

##### File structures
- SoftwareDesignApplication
- Top-level Zips:
– SiparisYonetimiNetCore.Data.zip – data-access layer (Entity Framework or ADO.NET)
– …Entities.zip – domain/entity definitions
– …Service.zip – business logic layer
– …WebAPI.zip – REST API exposing service functionality
– …WebAPIUsing.zip – client code consuming the WebAPI
- SiparisYonetimiNetCore.WebUI – ASP.NET MVC app with Areas/Admin for back-office and Controllers/Views for public UI. Assets in wwwroot (Bootstrap, jQuery, custom CSS/JS).
- UniTrack
- Presentation folder with PDF documentation.
- Project folder: SQL script + Java source under src (panels for Student, Course, Department, etc.), DBConnection utility.

##### Key takeaways from the README
- These are course projects from Istanbul Aydın University Computer Engineering.

a. Main components
- For SoftwareDesignApplication:
1) Database (SQL Server or other)
2) Data Access Layer (SiparisYonetimiNetCore.Data)
3) Domain/Entities (SiparisYonetimiNetCore.Entities)
4) Business Logic/Service Layer (SiparisYonetimiNetCore.Service)
5) RESTful Web API (SiparisYonetimiNetCore.WebAPI)
6) API Client (SiparisYonetimiNetCore.WebAPIUsing)
7) Web UI (ASP.NET MVC) with two sub-areas: Public UI and Admin Area
8) External libraries/frameworks (Entity Framework, ASP.NET Core MVC, Bootstrap, jQuery)
- For UniTrack:
1) Desktop UI (Java Swing panels)
2) DBConnection utility
3) Local Database (MySQL/SQL Server via JDBC script)
4) Java business logic embedded in panel controllers

b. Relationships and interactions
- SoftwareDesignApplication:
- Web UI ↔ Web API via HTTP (JSON)
- Web API → Service layer calls business methods
- Service layer → Data Access for CRUD operations
- Data Access → Database
- WebUI also uses local session extensions and file helpers
- UniTrack:
- UI panels call DBConnection to execute SQL
- DBConnection ↔ Database directly
- Panels coordinate each other through common in-memory models

c. Architectural patterns and design principles
- SoftwareDesignApplication:
- N-Tier (Presentation, API, Business, Data)
- Separation of concerns (Entities vs. Service vs. Data vs. UI)
- RESTful API for decoupling front end and back end
- UniTrack:
- MVC-like within a desktop app; each panel handles its own view and controller logic
- Single point of database connectivity (DBConnection util)

d. Key technologies/frameworks
- SoftwareDesignApplication:
- .NET 7.0, ASP.NET Core MVC, Entity Framework Core (or ADO.NET)
- Bootstrap, jQuery on the client
- JSON REST API
- UniTrack:
- Java (JDK Swing), JDBC for DB connectivity
- SQL script for schema setup

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% SoftwareDesignApplication Solution
    subgraph "SoftwareDesignApplication" 
        direction TB
        SDASolution["SoftwareDesignApplication.sln"]:::external

        subgraph "Database Layer"
            direction TB
            SQLDB[(SQL Database)]:::data
        end

        subgraph "Data Access Layer" 
            direction TB
            DAL["SiparisYonetimiNetCore.Data"]:::data
        end

        subgraph "Domain/Entities Layer"
            direction TB
            Entities["SiparisYonetimiNetCore.Entities"]:::data
        end

        subgraph "Business Logic Layer"
            direction TB
            Service["SiparisYonetimiNetCore.Service"]:::service
        end

        subgraph "Web API Layer"
            direction TB
            WebAPI["SiparisYonetimiNetCore.WebAPI (REST)"]:::service
            WebAPIUsing["SiparisYonetimiNetCore.WebAPIUsing (API Client)"]:::external
        end

        subgraph "Web UI (ASP.NET MVC)" 
            direction TB
            subgraph "Public UI"
                direction TB
                Controllers["Controllers"]:::frontend
                Views["Views"]:::frontend
            end
            subgraph "Admin Area"
                direction TB
                AdminControllers["Areas/Admin/Controllers"]:::frontend
                AdminViews["Areas/Admin/Views"]:::frontend
            end
            Models["Models"]:::frontend
            ExtSession["SessionExtensions"]:::util
            FileUtil["FileHelper"]:::util
            ViewComp["ViewComponents"]:::frontend
            StaticAssets["wwwroot (CSS/JS)"]:::frontend
            Config["Program.cs & appsettings.json"]:::util
        end

        %% Connections
        SQLDB -->|CRUD| DAL -->|uses Entities| Entities -->|business calls| Service -->|exposed by| WebAPI -->|HTTP JSON| WebUI
        WebUI -->|HTTP JSON| WebAPIUsing
        WebAPIUsing -->|invokes| WebAPI

    end

    %% UniTrack Application
    subgraph "UniTrack Desktop Application"
        direction TB
        UniPanels["Java Swing UI Panels"]:::frontend
        DBConn["DBConnection"]:::util
        UniScript["UniTrack_Database_Script.sql"]:::external
        UniPDF["UniTrack-Presentation_compressed.pdf"]:::external
        LocalDB[(Local Database)]:::data

        UniPanels -->|JDBC calls| DBConn -->|SQL| LocalDB
    end

    %% Click Events
    click SDASolution "https://github.com/apodwikat/aydinuniversity-courses-projects/blob/main/SoftwareDesignApplication.sln"
    click DAL "https://github.com/apodwikat/aydinuniversity-courses-projects/blob/main/SoftwareDesignApplication/SiparisYonetimiNetCore.Data.zip"
    click Entities "https://github.com/apodwikat/aydinuniversity-courses-projects/blob/main/SoftwareDesignApplication/SiparisYonetimiNetCore.Entities.zip"
    click Service "https://github.com/apodwikat/aydinuniversity-courses-projects/blob/main/SoftwareDesignApplication/SiparisYonetimiNetCore.Service.zip"
    click WebAPI "https://github.com/apodwikat/aydinuniversity-courses-projects/blob/main/SoftwareDesignApplication/SiparisYonetimiNetCore.WebAPI.zip"
    click WebAPIUsing "https://github.com/apodwikat/aydinuniversity-courses-projects/blob/main/SoftwareDesignApplication/SiparisYonetimiNetCore.WebAPIUsing.zip"
    click Controllers "https://github.com/apodwikat/aydinuniversity-courses-projects/tree/main/SoftwareDesignApplication/SiparisYonetimiNetCore.WebUI/Controllers"
    click Views "https://github.com/apodwikat/aydinuniversity-courses-projects/tree/main/SoftwareDesignApplication/SiparisYonetimiNetCore.WebUI/Views"
    click AdminControllers "https://github.com/apodwikat/aydinuniversity-courses-projects/tree/main/SoftwareDesignApplication/SiparisYonetimiNetCore.WebUI/Areas/Admin/Controllers"
    click AdminViews "https://github.com/apodwikat/aydinuniversity-courses-projects/tree/main/SoftwareDesignApplication/SiparisYonetimiNetCore.WebUI/Areas/Admin/Views"
    click ExtSession "https://github.com/apodwikat/aydinuniversity-courses-projects/blob/main/SoftwareDesignApplication/SiparisYonetimiNetCore.WebUI/Extensions/SessionExtensions.cs"
    click FileUtil "https://github.com/apodwikat/aydinuniversity-courses-projects/blob/main/SoftwareDesignApplication/SiparisYonetimiNetCore.WebUI/Utils/FileHelper.cs"
    click StaticAssets "https://github.com/apodwikat/aydinuniversity-courses-projects/tree/main/SoftwareDesignApplication/SiparisYonetimiNetCore.WebUI/wwwroot"
    click Config "https://github.com/apodwikat/aydinuniversity-courses-projects/blob/main/SoftwareDesignApplication/SiparisYonetimiNetCore.WebUI/Program.cs"
    click Config "https://github.com/apodwikat/aydinuniversity-courses-projects/blob/main/SoftwareDesignApplication/SiparisYonetimiNetCore.WebUI/appsettings.json"
    click UniPanels "https://github.com/apodwikat/aydinuniversity-courses-projects/tree/main/UniTrack/Project/src/"
    click DBConn "https://github.com/apodwikat/aydinuniversity-courses-projects/blob/main/UniTrack/Project/src/DBConnection.java"
    click UniScript "https://github.com/apodwikat/aydinuniversity-courses-projects/blob/main/UniTrack/Project/UniTrack_Database_Script.sql"
    click UniPDF "https://github.com/apodwikat/aydinuniversity-courses-projects/blob/main/UniTrack/Presentation/UniTrack-Presentation_compressed.pdf"

    %% Styles
    classDef frontend fill:#B3DDF2,stroke:#036,stroke-width:1px;
    classDef service fill:#C8E6C9,stroke:#256029,stroke-width:1px;
    classDef data fill:#FFE0B2,stroke:#A64B00,stroke-width:1px;
    classDef util fill:#E1BEE7,stroke:#4A148C,stroke-width:1px;
    classDef external fill:#CFD8DC,stroke:#37474F,stroke-width:1px;
```
