# yagnik-patel-47/admission-spider-site architecture

> Architecture diagram of the GitHub repository yagnik-patel-47/admission-spider-site, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-05-26). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/yagnik-patel-47/admission-spider-site
- Repository: https://github.com/yagnik-patel-47/admission-spider-site

## Overview

##### Project type and purpose
- Admission Spider (Frontend) is a static, multi‐page frontend web application built with HTML, CSS, and vanilla JavaScript.
- Its purpose is to present admission opportunities and educational announcements scraped from various college/university websites in India.

##### Main components
a. Client Browser
- Loads HTML pages (index.html, details.html, announcements.html, feedback.html)
- Applies CSS (from css-files/*.css) for layout and styling
- Runs JavaScript (from js-files/*.js) to implement UI logic, search/filter, and dynamic rendering of data
b. Web Server (Static Asset Host)
- Serves the HTML, CSS, and JS assets over HTTP/HTTPS
- Could be a simple web server (e.g., Nginx, Apache, GitHub Pages) or CDN
c. Admission Data API (External Service)
- Could be a RESTful service that the JS code fetches at runtime
d. External Data Sources (Colleges/Universities Websites)
- The actual content is scraped from these sites by a separate backend/scraper service before being exposed via the Admission Data API

##### Relationships and interactions
- [Browser] → HTTP GET → [Web Server] to fetch HTML/CSS/JS
- [Browser-JS] → AJAX/Fetch → [Admission Data API] to retrieve admissions and announcements data (JSON)
- [Admission Data API] → Scrapes or queries → [External Data Sources] (periodic or on-demand)
- [Browser] ← Renders ← Dynamic data returned from the API

##### Architectural patterns and design principles
- Separation of concerns
- Presentation layer: HTML + CSS
- Client logic layer: JavaScript controllers handling events, fetching data, and updating the DOM
- Data layer: External Admission Data API exposing a clean JSON interface
- Progressive enhancement and responsive design (per README’s mobile/desktop support)
- Static asset pipeline: keeps frontend deployment simple and scalable (can host on any static file server or CDN)

##### Technologies and frameworks to annotate
- HTML5 (semantic markup for each page template)
- CSS3 (custom layout, grid/flex utility classes, media queries for responsiveness)
- Vanilla JavaScript (ES6 modules or script files handling UI state, fetch calls, event listeners)
- (Optional) Web server/CDN name, and the Admission Data API technology (e.g., Node.js/Express, Python/Flask)

## Diagram (Mermaid)

```mermaid
flowchart TB
    subgraph "Client Browser"
        direction TB
        CB_Index("index.html"):::browser
        CB_Details("details.html"):::browser
        CB_Announcements("announcements.html"):::browser
        CB_Feedback("feedback.html"):::browser
        CB_Styles("css-files/styles.css"):::browser
        CSS_Details("css-files/details.css"):::browser
        CSS_Announcements("css-files/announcements.css"):::browser
        CSS_Feedback("css-files/feedback.css"):::browser
        JS_Script("js-files/script.js"):::browser
        JS_DetailJS("js-files/details.js"):::browser
        JS_Announcements("js-files/announcements.js"):::browser
    end

    WebServer["Web Server\n(Static Asset Host)\nServes HTML/CSS/JS"]:::server
    AdmissionAPI["Admission Data API\n(JSON REST Service)"]:::api
    ExternalSources["External Data Sources\n(College/University Websites)"]:::external

    CB_Index -->|"HTTP GET HTML"| WebServer
    CB_Details -->|"HTTP GET HTML"| WebServer
    CB_Announcements -->|"HTTP GET HTML"| WebServer
    CB_Feedback -->|"HTTP GET HTML"| WebServer
    CB_Styles -->|"HTTP GET CSS"| WebServer
    CSS_Details -->|"HTTP GET CSS"| WebServer
    CSS_Announcements -->|"HTTP GET CSS"| WebServer
    CSS_Feedback -->|"HTTP GET CSS"| WebServer
    JS_Script -->|"HTTP GET JS"| WebServer
    JS_DetailJS -->|"HTTP GET JS"| WebServer
    JS_Announcements -->|"HTTP GET JS"| WebServer

    JS_Script -->|"fetch JSON"| AdmissionAPI
    JS_DetailJS -->|"fetch JSON"| AdmissionAPI
    JS_Announcements -->|"fetch JSON"| AdmissionAPI

    AdmissionAPI -->|"scrapes/queries"| ExternalSources

    click CB_Index "https://github.com/yagnik-patel-47/admission-spider-site/blob/main/index.html"
    click CB_Details "https://github.com/yagnik-patel-47/admission-spider-site/blob/main/details.html"
    click CB_Announcements "https://github.com/yagnik-patel-47/admission-spider-site/blob/main/announcements.html"
    click CB_Feedback "https://github.com/yagnik-patel-47/admission-spider-site/blob/main/feedback.html"
    click CB_Styles "https://github.com/yagnik-patel-47/admission-spider-site/blob/main/css-files/styles.css"
    click CSS_Details "https://github.com/yagnik-patel-47/admission-spider-site/blob/main/css-files/details.css"
    click CSS_Announcements "https://github.com/yagnik-patel-47/admission-spider-site/blob/main/css-files/announcements.css"
    click CSS_Feedback "https://github.com/yagnik-patel-47/admission-spider-site/blob/main/css-files/feedback.css"
    click JS_Script "https://github.com/yagnik-patel-47/admission-spider-site/blob/main/js-files/script.js"
    click JS_DetailJS "https://github.com/yagnik-patel-47/admission-spider-site/blob/main/js-files/details.js"
    click JS_Announcements "https://github.com/yagnik-patel-47/admission-spider-site/blob/main/js-files/announcements.js"

    classDef browser fill:#E0F7FA,stroke:#006064,color:#000;
    classDef server fill:#C8E6C9,stroke:#1B5E20,color:#000;
    classDef api fill:#FFE0B2,stroke:#E65100,color:#000;
    classDef external fill:#E1BEE7,stroke:#4A148C,color:#000;
```
