# adityasinha-1988/coa_2025 architecture

> Architecture diagram of the GitHub repository adityasinha-1988/coa_2025, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-02-26). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/adityasinha-1988/coa_2025
- Repository: https://github.com/adityasinha-1988/coa_2025

## Overview

From the file tree + README, this is a **static educational web portal** hosted on **GitHub Pages** (live at `adityasinha-1988.github.io/COA_2025`). It serves **course content for Computer Organization & Architecture**, organized by units and topics, and includes **VAK (Visual/Auditory/Kinesthetic)** learning-oriented pages/resources.

There is **no backend**, **no database**, and no obvious build system (no `package.json`, no `src/`, no bundler configs). The “system” is essentially:
- static HTML pages
- static assets (PDFs, PPTs, link to handwritten notes)
- a hosting + delivery layer (GitHub Pages / GitHub repository)
- the user’s browser rendering and navigation

##### File-structure analysis (how to derive components)
Top-level indicates a simple static site:
- `index.html` → likely homepage / entrypoint
- `Unit1.html`, `Unit2.html` → unit landing pages (also duplicates exist in `/pages`)
- `/pages/*.html` → topic pages and sub-unit pages
- examples: `2.2_TestScores.html`, `2.3_Shifts.html`, `3_IO.html`, `4_Cache.html`, `DMA.html`, `IO_Interrups.html`, `VAK.html`
- `PPT/` → lecture slides (`.pptx`)
- PDFs: `Unit1_Notes.pdf`, `Unit2 Hamacher Notes.pdf`
- `HandwrittenNotesLink.txt` → external link reference (likely Google Drive/OneDrive/etc.)

This implies the primary internal relationships are **hyperlink navigation** between:
`index.html` → `Unit*.html` → `pages/*.html` → downloadable resources (`PPT/*.pptx`, PDFs) and/or external links.

The README emphasizes:
- “Structured content” (units/topics)
- “Easy navigation”
- “VAK integration”

- **content hierarchy** (Unit → Topics)
- **VAK page / VAK mapping** (where VAK is presented or applied)
- **delivery path** (GitHub repo → GitHub Pages CDN → Browser)

##### GitHub Repository (source of truth for content)
5. **External Resource Host(s)** (only if `HandwrittenNotesLink.txt` points to outside content)

**Key interactions**
- Browser requests `index.html` and other HTML under `/` and `/pages`
- Browser requests static assets: PDFs and PPTX under root and `/PPT`
- Optional: Browser navigates to external handwritten notes link

**What to label**
- “HTTPS GET static content”
- “Git push / PR → deployment (Pages)”
- “Direct download (PPTX/PDF)”

This answers: “How is the learning portal organized and navigated?”

**Main components to include**
- `index.html` (Home)
- Unit landing pages: `Unit1.html`, `Unit2.html` (and/or `/pages/Unit1.html`, `/pages/Unit2.html`—call out duplicates if real)
- Topic pages in `/pages`:
- Unit 2 topics: `2.2_TestScores`, `2.3_Shifts`, `2.4_Vector`, `2.5_Byte`, `Unit2.1`, `Unit2_Tutorials`, etc.
- Unit 3 I/O: `3_IO`, `DMA`, `IO_Interrups`
- Unit 4: `4_Cache`
- `VAK.html` as cross-cutting page
- Resources:
- PDFs: `Unit1_Notes.pdf`, `Unit2 Hamacher Notes.pdf`
- Slides: `PPT/*.pptx`
- External link: `HandwrittenNotesLink.txt` target

**Key interactions**
- Hyperlinks from unit pages to topics
- Download links from topic pages to PDFs/PPT
- Cross-links to VAK material (if present)

##### Architectural patterns / principles present
Even though it’s static, there are still architectural “choices” worth diagramming:

- **Static-site architecture**: no server-side compute, no DB, content served as files.
- **Content-first modularization**: separate topic pages in `/pages`, separate “assets” in `/PPT` and PDFs at root.
- **Navigation-driven UX**: the primary “runtime behavior” is hyperlink navigation and file downloads.
- **Cross-cutting learning model (VAK)**: represent as a cross-linking concern (e.g., VAK page or VAK tags per topic if implemented).

- User ↔ Browser ↔ GitHub Pages ↔ GitHub Repo
- External notes host (if applicable)
- `index.html` → `Unit1.html`, `Unit2.html` → `/pages/*topic*.html`
- topic pages → PDFs/PPTs
- `VAK.html` shown as cross-cutting link target
- `/pages`, `/PPT`, root PDFs, and how those map to the site map

This combination is “very detailed” without overthinking: it separates the project into as many real components as exist (pages, assets, hosting, repo, external links) and shows the actual flows that matter (navigation + delivery + publishing).

## Diagram (Mermaid)

```mermaid
flowchart TD
  %% =======================
  %% Diagram A: System Context / Delivery (Static Site)
  %% =======================
  subgraph "System Context: Static-Site Delivery (GitHub Pages)"
    U["Student / Learner"]:::external
    B["Web Browser"]:::client

    subgraph "GitHub Platform"
      GHRepo["GitHub Repository (source content)"]:::repo
      GHPages["GitHub Pages (static hosting + CDN)"]:::hosting
    end

    Ext["External Notes Host (Drive/OneDrive/etc.)"]:::external
  end

  U -->|"uses"| B
  B -->|"HTTPS_GET_static_HTML"| GHPages
  B -->|"HTTPS_GET_assets_(PDF/PPTX)"| GHPages
  B -.->|"external_link_redirect"| Ext

  GHRepo -.->|"git_push_PR_publish"| GHPages

  %% =======================
  %% Diagram B: Information Architecture / Site Map (Content)
  %% =======================
  subgraph "Information Architecture: Site Map / Navigation"
    Home["index.html (Home)"]:::html

    subgraph "Unit Landing Pages (root)"
      U1["Unit1.html (Unit 1)"]:::html
      U2["Unit2.html (Unit 2)"]:::html
    end

    subgraph "Topic Pages Directory: /pages"
      PagesDir["pages/ (topics + duplicates)"]:::dir

      subgraph "Unit 2 Topics"
        U21["Unit2.1 (Intro)"]:::html
        T22["2.2 Test Scores"]:::html
        T23["2.3 Shifts"]:::html
        T24["2.4 Vector"]:::html
        T25["2.5 Byte"]:::html
        UTut["Unit2 Tutorials"]:::html
        U1dup["Unit1 (duplicate in /pages)"]:::html
        U2dup["Unit2 (duplicate in /pages)"]:::html
      end

      subgraph "Unit 3: I/O"
        IO3["3 I/O Overview"]:::html
        DMA["DMA"]:::html
        IOInt["I/O Interrupts"]:::html
      end

      subgraph "Unit 4"
        Cache["4 Cache"]:::html
      end

      subgraph "Cross-cutting Learning Model"
        VAK["VAK (Visual/Auditory/Kinesthetic)"]:::vak
      end
    end

    subgraph "Static Resources"
      subgraph "PDF Notes (root)"
        PDF1["Unit 1 Notes (PDF)"]:::pdf
        PDF2["Unit 2 Hamacher Notes (PDF)"]:::pdf
      end

      subgraph "Slides Directory: /PPT"
        PPTDir["PPT/ (slides)"]:::dir
        U1L0["Unit1 Lecture 0 (PPTX)"]:::ppt
        U1L2["Unit1 Lecture 2 (PPTX)"]:::ppt
        U1L3["Unit1 Lecture 3 (PPTX)"]:::ppt
        U1L4["Unit1 Lecture 4 (PPTX)"]:::ppt
        U1L5["Unit1 Lecture 5 (PPTX)"]:::ppt
        U2L711["Unit2 Lecture 7-11 (PPTX)"]:::ppt
      end

      HN["Handwritten Notes Link (txt pointer)"]:::link
      Readme["README (portal description)"]:::doc
    end
  end

  %% Navigation hierarchy
  Home -->|"navigate_to_unit"| U1
  Home -->|"navigate_to_unit"| U2
  Home -->|"about_portal"| Readme

  %% Unit pages to topics (representative links)
  U1 -->|"topics_in_pages"| PagesDir
  U2 -->|"topics_in_pages"| PagesDir

  PagesDir -->|"unit2_topics"| U21
  PagesDir -->|"unit2_topics"| T22
  PagesDir -->|"unit2_topics"| T23
  PagesDir -->|"unit2_topics"| T24
  PagesDir -->|"unit2_topics"| T25
  PagesDir -->|"unit2_topics"| UTut
  PagesDir -->|"dup_unit_pages"| U1dup
  PagesDir -->|"dup_unit_pages"| U2dup

  PagesDir -->|"unit3_topics"| IO3
  PagesDir -->|"unit3_topics"| DMA
  PagesDir -->|"unit3_topics"| IOInt

  PagesDir -->|"unit4_topics"| Cache
  PagesDir -->|"vak_material"| VAK

  %% Topic pages to resources (downloads / references)
  U1 -->|"download_pdf"| PDF1
  U2 -->|"download_pdf"| PDF2

  T22 -->|"download_assets"| PDF2
  T23 -->|"download_assets"| PDF2
  T24 -->|"download_assets"| PDF2
  T25 -->|"download_assets"| PDF2
  UTut -->|"download_assets"| PDF2

  U1 -->|"download_slides"| PPTDir
  U2 -->|"download_slides"| PPTDir
  PPTDir -->|"unit1_slides"| U1L0
  PPTDir -->|"unit1_slides"| U1L2
  PPTDir -->|"unit1_slides"| U1L3
  PPTDir -->|"unit1_slides"| U1L4
  PPTDir -->|"unit1_slides"| U1L5
  PPTDir -->|"unit2_slides"| U2L711

  Home -->|"handwritten_notes_link"| HN
  HN -.->|"external_url"| Ext

  %% Cross-cutting VAK links (representative)
  U1 -.->|"vak_guidance"| VAK
  U2 -.->|"vak_guidance"| VAK
  IO3 -.->|"vak_guidance"| VAK
  Cache -.->|"vak_guidance"| VAK

  %% =======================
  %% Click Events (from component mapping)
  %% =======================
  click Home "https://github.com/adityasinha-1988/coa_2025/blob/main/index.html"
  click U1 "https://github.com/adityasinha-1988/coa_2025/blob/main/Unit1.html"
  click U2 "https://github.com/adityasinha-1988/coa_2025/blob/main/Unit2.html"
  click PagesDir "https://github.com/adityasinha-1988/coa_2025/tree/main/pages/"
  click T22 "https://github.com/adityasinha-1988/coa_2025/blob/main/pages/2.2_TestScores.html"
  click T23 "https://github.com/adityasinha-1988/coa_2025/blob/main/pages/2.3_Shifts.html"
  click T24 "https://github.com/adityasinha-1988/coa_2025/blob/main/pages/2.4_Vector.html"
  click T25 "https://github.com/adityasinha-1988/coa_2025/blob/main/pages/2.5_Byte.html"
  click U21 "https://github.com/adityasinha-1988/coa_2025/blob/main/pages/Unit2.1.html"
  click UTut "https://github.com/adityasinha-1988/coa_2025/blob/main/pages/Unit2_Tutorials.html"
  click IO3 "https://github.com/adityasinha-1988/coa_2025/blob/main/pages/3_IO.html"
  click DMA "https://github.com/adityasinha-1988/coa_2025/blob/main/pages/DMA.html"
  click IOInt "https://github.com/adityasinha-1988/coa_2025/blob/main/pages/IO_Interrups.html"
  click Cache "https://github.com/adityasinha-1988/coa_2025/blob/main/pages/4_Cache.html"
  click VAK "https://github.com/adityasinha-1988/coa_2025/blob/main/pages/VAK.html"
  click PPTDir "https://github.com/adityasinha-1988/coa_2025/tree/main/PPT/"
  click U1L0 "https://github.com/adityasinha-1988/coa_2025/blob/main/PPT/Unit1_Lecture0.pptx"
  click U1L2 "https://github.com/adityasinha-1988/coa_2025/blob/main/PPT/Unit1_Lecture2.pptx"
  click U1L3 "https://github.com/adityasinha-1988/coa_2025/blob/main/PPT/Unit1_Lecture3.pptx"
  click U1L4 "https://github.com/adityasinha-1988/coa_2025/blob/main/PPT/Unit1_Lecture4.pptx"
  click U1L5 "https://github.com/adityasinha-1988/coa_2025/blob/main/PPT/Unit1_Lecture5.pptx"
  click U2L711 "https://github.com/adityasinha-1988/coa_2025/blob/main/PPT/Unit2_Lecture7-11.pptx"
  click PDF1 "https://github.com/adityasinha-1988/coa_2025/blob/main/Unit1_Notes.pdf"
  click PDF2 "https://github.com/adityasinha-1988/coa_2025/blob/main/Unit2 Hamacher Notes.pdf"
  click HN "https://github.com/adityasinha-1988/coa_2025/blob/main/HandwrittenNotesLink.txt"
  click Readme "https://github.com/adityasinha-1988/coa_2025/blob/main/README.md"
  click U1dup "https://github.com/adityasinha-1988/coa_2025/blob/main/pages/Unit1.html"
  click U2dup "https://github.com/adityasinha-1988/coa_2025/blob/main/pages/Unit2.html"

  %% =======================
  %% Styles (color is critical)
  %% =======================
  classDef external fill:#FCE7F3,stroke:#BE185D,stroke-width:1px,color:#111827;
  classDef client fill:#E0F2FE,stroke:#0369A1,stroke-width:1px,color:#0B1220;
  classDef hosting fill:#DCFCE7,stroke:#166534,stroke-width:1px,color:#0B1220;
  classDef repo fill:#FEF9C3,stroke:#A16207,stroke-width:1px,color:#0B1220;

  classDef html fill:#EEF2FF,stroke:#4338CA,stroke-width:1px,color:#0B1220;
  classDef pdf fill:#FFEDD5,stroke:#9A3412,stroke-width:1px,color:#0B1220;
  classDef ppt fill:#FFE4E6,stroke:#9F1239,stroke-width:1px,color:#0B1220;
  classDef link fill:#F3F4F6,stroke:#374151,stroke-width:1px,color:#0B1220;
  classDef dir fill:#ECFDF5,stroke:#047857,stroke-width:1px,stroke-dasharray:5 3,color:#0B1220;
  classDef doc fill:#E5E7EB,stroke:#4B5563,stroke-width:1px,color:#0B1220;
  classDef vak fill:#FAE8FF,stroke:#7E22CE,stroke-width:1px,color:#0B1220;
```
