# mdtanjimrahman/aiub-course-suggestion-system architecture

> Architecture diagram of the GitHub repository mdtanjimrahman/aiub-course-suggestion-system, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-04-27). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/mdtanjimrahman/aiub-course-suggestion-system
- Repository: https://github.com/mdtanjimrahman/aiub-course-suggestion-system

## Overview

##### Project type and purpose
- This is a standalone desktop application built on .NET (C# WinForms).
- Purpose: recommend next-semester courses based on a student’s completed courses by scraping AIUB’s course listings (online/offline modes).

##### File structure
- Top-level: `AIUB Offered Course.sln` and a single project folder (`AIUB Offered Course/`).
- UI layer: `Offline.Designer.cs` & `Offline.cs`, `Online.Designer.cs` & `Online.cs`.
- Business logic / core: `Course.cs`, `CourseManager.cs`, `CourseAdviser.cs`, `CourseSearchEngine.cs`, `WebScraperInjector.cs`
- Configuration & resources: `App.config`, `Properties/`, `Resources/`, `Assets/`
- External dependencies under `packages/`:
- Guna.UI2.WinForms (UI controls)
- HtmlAgilityPack (HTML parsing for scraping)

##### README for additional insights
- Workflow: user selects department → enters completed course IDs → engine suggests next courses → UI displays results.
- Supports online (live web scrape) and offline (pre-bundled data) modes.

##### Key elements to capture
- UI Forms (OnlineForm, OfflineForm)
- CourseManager orchestrator
- CourseSearchEngine branching to WebScraperInjector or OfflineDataLoader
- External AIUB site and HtmlAgilityPack dependency
- CourseAdviser applying prerequisites & recommendation logic

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% User
    User["User"]:::external

    %% Presentation Layer
    subgraph "Presentation Layer"
        Program["Program (Entry Point)"]:::ui
        OnlineForm["OnlineForm"]:::ui
        OfflineForm["OfflineForm"]:::ui
    end

    %% Business Logic Layer
    subgraph "Business Logic Layer"
        CourseManager["CourseManager"]:::business
        CourseSearchEngine["CourseSearchEngine"]:::business
        CourseAdviser["CourseAdviser"]:::business
        Course["Course (Domain Model)"]:::business
    end

    %% Data Access Layer
    subgraph "Data Access Layer"
        WebScraperInjector["WebScraperInjector"]:::data
        OfflineDataStore["Offline Data Store"]:::data
    end

    %% External & Infrastructure
    subgraph "External & Infrastructure"
        AIUBSite["AIUB Course Catalog"]:::external
        HtmlAgilityPack["HtmlAgilityPack"]:::external
        GunaUI["Guna.UI2.WinForms"]:::external
    end

    %% Interactions
    User -->|uses| OnlineForm
    User -->|uses| OfflineForm

    Program -->|initializes| OnlineForm
    Program -->|initializes| OfflineForm

    OnlineForm -->|calls| CourseManager
    OfflineForm -->|calls| CourseManager
    OnlineForm -->|UI controls| GunaUI
    OfflineForm -->|UI controls| GunaUI

    CourseManager -->|orchestrates| CourseSearchEngine
    CourseSearchEngine -->|online mode| WebScraperInjector
    CourseSearchEngine -->|offline mode| OfflineDataStore
    WebScraperInjector -->|HTTP GET| AIUBSite
    WebScraperInjector -->|parses HTML| HtmlAgilityPack

    CourseManager -->|sends raw list| CourseAdviser
    CourseSearchEngine -->|provides data| CourseAdviser
    CourseAdviser -->|applies rules| Course

    CourseAdviser -->|returns recommendations| CourseManager
    CourseManager -->|displays| OnlineForm
    CourseManager -->|displays| OfflineForm

    %% Click Events
    click OnlineForm "https://github.com/mdtanjimrahman/aiub-course-suggestion-system/blob/master/AIUB Offered Course/Online.cs"
    click OfflineForm "https://github.com/mdtanjimrahman/aiub-course-suggestion-system/blob/master/AIUB Offered Course/Offline.cs"
    click Program "https://github.com/mdtanjimrahman/aiub-course-suggestion-system/blob/master/AIUB Offered Course/Program.cs"
    click CourseManager "https://github.com/mdtanjimrahman/aiub-course-suggestion-system/blob/master/AIUB Offered Course/CourseManager.cs"
    click CourseSearchEngine "https://github.com/mdtanjimrahman/aiub-course-suggestion-system/blob/master/AIUB Offered Course/CourseSearchEngine.cs"
    click CourseAdviser "https://github.com/mdtanjimrahman/aiub-course-suggestion-system/blob/master/AIUB Offered Course/CourseAdviser.cs"
    click WebScraperInjector "https://github.com/mdtanjimrahman/aiub-course-suggestion-system/blob/master/AIUB Offered Course/WebScraperInjector.cs"
    click OfflineDataStore "https://github.com/mdtanjimrahman/aiub-course-suggestion-system/tree/master/AIUB Offered Course/Resources/"
    click Course "https://github.com/mdtanjimrahman/aiub-course-suggestion-system/blob/master/AIUB Offered Course/Course.cs"
    click GunaUI "https://github.com/mdtanjimrahman/aiub-course-suggestion-system/tree/master/packages/Guna.UI2.WinForms.2.0.4.6/"
    click HtmlAgilityPack "https://github.com/mdtanjimrahman/aiub-course-suggestion-system/tree/master/packages/HtmlAgilityPack.1.11.65/"

    %% Styles
    classDef ui fill:#D6EAF8,stroke:#1B4F72,stroke-width:1px
    classDef business fill:#D4EFDF,stroke:#186A3B,stroke-width:1px
    classDef data fill:#FCF3CF,stroke:#7D6608,stroke-width:1px
    classDef external fill:#ECECEC,stroke:#424949,stroke-width:1px
```
