# abduiwahid/fa24-bai architecture

> Architecture diagram of the GitHub repository abduiwahid/fa24-bai, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/abduiwahid/fa24-bai
- Repository: https://github.com/abduiwahid/fa24-bai

## Overview

FA24-BAI 5th Semester Study Hub is a document library with an AI study assistant. Students browse course-organized resources, search and filter the catalog, then open documents or request summaries, quizzes, viva questions, or answers. Admins can upload and delete resources. The GitHub repository serves as both catalog source and file store; serverless API handlers mediate catalog and admin operations, while the AI handler extracts PDF text and calls Gemini. README-documented features such as favorites, recents, and PWA support are included; their detailed implementation was not sampled.

Main entry points: [`js/script.js`](https://github.com/abduiwahid/fa24-bai/blob/main/js/script.js) (Browser Logic), [`index.html`](https://github.com/abduiwahid/fa24-bai/blob/main/index.html) (Study Hub), [`api/ask.js`](https://github.com/abduiwahid/fa24-bai/blob/main/api/ask.js) (Document AI Handler), [`api/files.js`](https://github.com/abduiwahid/fa24-bai/blob/main/api/files.js) (File Catalog API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Study Hub UI"]
  node_webapp["Study Hub<br/>[index.html]"]
  node_ui_logic["Browser Logic<br/>[script.js]"]
  node_pwa["Installable App<br/>[manifest.json]"]
  node_styles["Interface Styling<br/>[style.css]"]
end

subgraph group_catalog["Resource Catalog"]
  node_catalog_api["File Catalog API<br/>[files.js]"]
  node_resource_store[("Repository Resources")]
  node_course_browse["Course Browsing<br/>[script.js]"]
  node_search_filters["Search and Filters<br/>[script.js]"]
  node_favorites_recents["Favorites and Recents<br/>[script.js]"]
end

subgraph group_management["Admin Management"]
  node_admin_controls["Admin Controls<br/>[script.js]"]
  node_upload_api["Upload API<br/>[upload.js]"]
  node_delete_api["Delete API<br/>[delete.js]"]
end

subgraph group_assistant["AI Assistant"]
  node_ai_controls["AI Study Controls<br/>[script.js]"]
  node_document_ai["Document AI Handler<br/>[ask.js]"]
end

node_student(("Student"))
node_admin(("Administrator"))
node_gemini["Gemini AI"]

node_student -->|"uses"| node_webapp
node_admin -->|"uses admin controls"| node_webapp
node_webapp -->|"runs"| node_ui_logic
node_webapp -->|"styled by"| node_styles
node_webapp -->|"installable via"| node_pwa
node_ui_logic -->|"fetches catalog"| node_catalog_api
node_catalog_api -->|"reads tree"| node_resource_store
node_ui_logic -->|"renders courses"| node_course_browse
node_ui_logic -->|"filters resources"| node_search_filters
node_student -->|"tracks resources"| node_favorites_recents
node_ui_logic -.->|"maintains"| node_favorites_recents
node_admin_controls -->|"uploads to"| node_upload_api
node_upload_api -->|"writes files"| node_resource_store
node_admin_controls -->|"requests deletion"| node_delete_api
node_delete_api -->|"deletes files"| node_resource_store
node_student -->|"requests study help"| node_ai_controls
node_ai_controls -->|"sends document requests"| node_document_ai
node_document_ai -->|"fetches PDF"| node_resource_store
node_document_ai -->|"generates response"| node_gemini

click node_webapp "https://github.com/abduiwahid/fa24-bai/blob/main/index.html"
click node_ui_logic "https://github.com/abduiwahid/fa24-bai/blob/main/js/script.js"
click node_pwa "https://github.com/abduiwahid/fa24-bai/blob/main/manifest.json"
click node_styles "https://github.com/abduiwahid/fa24-bai/blob/main/css/style.css"
click node_catalog_api "https://github.com/abduiwahid/fa24-bai/blob/main/api/files.js"
click node_course_browse "https://github.com/abduiwahid/fa24-bai/blob/main/js/script.js"
click node_search_filters "https://github.com/abduiwahid/fa24-bai/blob/main/js/script.js"
click node_favorites_recents "https://github.com/abduiwahid/fa24-bai/blob/main/js/script.js"
click node_admin_controls "https://github.com/abduiwahid/fa24-bai/blob/main/js/script.js"
click node_upload_api "https://github.com/abduiwahid/fa24-bai/blob/main/api/upload.js"
click node_delete_api "https://github.com/abduiwahid/fa24-bai/blob/main/api/delete.js"
click node_ai_controls "https://github.com/abduiwahid/fa24-bai/blob/main/js/script.js"
click node_document_ai "https://github.com/abduiwahid/fa24-bai/blob/main/api/ask.js"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_webapp,node_ui_logic,node_pwa,node_styles toneBlue
class node_catalog_api,node_resource_store,node_course_browse,node_search_filters,node_favorites_recents toneAmber
class node_admin_controls,node_upload_api,node_delete_api toneMint
class node_ai_controls,node_document_ai toneRose
class node_student,node_admin,node_gemini toneIndigo
```

## Components

### Study Hub UI

- [Study Hub](https://github.com/abduiwahid/fa24-bai/blob/main/index.html): `index.html`
- [Browser Logic](https://github.com/abduiwahid/fa24-bai/blob/main/js/script.js): `js/script.js`
- [Installable App](https://github.com/abduiwahid/fa24-bai/blob/main/manifest.json): `manifest.json`
- [Interface Styling](https://github.com/abduiwahid/fa24-bai/blob/main/css/style.css): `css/style.css`

### Resource Catalog

- [File Catalog API](https://github.com/abduiwahid/fa24-bai/blob/main/api/files.js): `api/files.js`
- **Repository Resources**
- [Course Browsing](https://github.com/abduiwahid/fa24-bai/blob/main/js/script.js): `js/script.js`
- [Search and Filters](https://github.com/abduiwahid/fa24-bai/blob/main/js/script.js): `js/script.js`
- [Favorites and Recents](https://github.com/abduiwahid/fa24-bai/blob/main/js/script.js): `js/script.js`

### Admin Management

- [Admin Controls](https://github.com/abduiwahid/fa24-bai/blob/main/js/script.js): `js/script.js`
- [Upload API](https://github.com/abduiwahid/fa24-bai/blob/main/api/upload.js): `api/upload.js`
- [Delete API](https://github.com/abduiwahid/fa24-bai/blob/main/api/delete.js): `api/delete.js`

### AI Assistant

- [AI Study Controls](https://github.com/abduiwahid/fa24-bai/blob/main/js/script.js): `js/script.js`
- [Document AI Handler](https://github.com/abduiwahid/fa24-bai/blob/main/api/ask.js): `api/ask.js`

### Other components

- **Student**
- **Administrator**
- **Gemini AI**

## Connections

- Student → Study Hub: uses (evidence: `README.md`)
- Administrator → Study Hub: uses admin controls (evidence: `README.md`)
- Study Hub → Browser Logic: runs (evidence: `README.md`)
- Study Hub → Interface Styling: styled by (evidence: `README.md`)
- Study Hub → Installable App: installable via (evidence: `README.md`)
- Browser Logic → File Catalog API: fetches catalog (evidence: `js/script.js`)
- File Catalog API → Repository Resources: reads tree (evidence: `api/files.js`)
- Browser Logic → Course Browsing: renders courses (evidence: `js/script.js`)
- Browser Logic → Search and Filters: filters resources (evidence: `js/script.js`)
- Student → Favorites and Recents: tracks resources (evidence: `README.md`)
- Browser Logic → Favorites and Recents: maintains (evidence: `js/script.js`)
- Admin Controls → Upload API: uploads to (evidence: `js/script.js`)
- Upload API → Repository Resources: writes files (evidence: `api/upload.js`)
- Admin Controls → Delete API: requests deletion (evidence: `js/script.js`)
- Delete API → Repository Resources: deletes files (evidence: `api/delete.js`)
- Student → AI Study Controls: requests study help (evidence: `README.md`)
- AI Study Controls → Document AI Handler: sends document requests (evidence: `README.md`)
- Document AI Handler → Repository Resources: fetches PDF (evidence: `api/ask.js`)
- Document AI Handler → Gemini AI: generates response (evidence: `api/ask.js`)
