# vedantpachauri84/university-resource-website architecture

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

- Interactive diagram: https://gitdiagram.com/vedantpachauri84/university-resource-website
- Repository: https://github.com/vedantpachauri84/university-resource-website

## Overview

University Resource Website is a Django application for students to find academic materials, manage accounts, and use AI study tools. The main workflow routes a browser request to a view, which validates input or queries content records, then renders a page; paper analysis additionally retrieves a PDF and calls Gemini. Major branches include accounts, notes/papers/resources, contact and blog content, and the AI chatbot. Source excerpts support the view, model, form, and AI links; some deployment and template wiring is documented only at a high level.

Main entry points: [`blog/views.py`](https://github.com/vedantpachauri84/university-resource-website/blob/main/blog/views.py) (Request views), [`blog/models.py`](https://github.com/vedantpachauri84/university-resource-website/blob/main/blog/models.py) (Profiles and accounts), [`blog/utils.py`](https://github.com/vedantpachauri84/university-resource-website/blob/main/blog/utils.py) (PDF and AI helpers), [`blogs/settings.py`](https://github.com/vedantpachauri84/university-resource-website/blob/main/blogs/settings.py) (Application database)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web entry and UI"]
  node_routes["URL routes<br/>[urls.py]"]
  node_views["Request views<br/>[views.py]"]
  node_pages["Website pages"]
end

subgraph group_accounts["Accounts and profiles"]
  node_forms["Account and contact forms<br/>[forms.py]"]
  node_profiles["Profiles and accounts<br/>[models.py]"]
  node_profile_signal["Profile creation signal<br/>[signals.py]"]
  node_app_setup["App initialization<br/>[apps.py]"]
end

subgraph group_content["Academic content"]
  node_academic["Notes, papers, resources<br/>[models.py]"]
  node_blog_contact["Blog and contact records<br/>[models.py]"]
end

subgraph group_ai["AI study tools"]
  node_pdf_analysis["Paper analysis<br/>[views.py]"]
  node_chat_assistant["AI chatbot<br/>[views.py]"]
  node_ai_helpers["PDF and AI helpers<br/>[utils.py]"]
end

subgraph group_platform["Persistence and services"]
  node_db[("Application database<br/>[settings.py]")]
  node_cloudinary[("Cloudinary storage")]
  node_gemini["Gemini API"]
end

node_student(("Student"))

node_student -->|"requests pages"| node_routes
node_routes -->|"dispatches to"| node_views
node_views -->|"renders"| node_pages
node_views -->|"validates with"| node_forms
node_views -->|"queries"| node_academic
node_views -->|"queries and saves"| node_blog_contact
node_views -->|"loads and updates"| node_profiles
node_views -->|"handles analysis"| node_pdf_analysis
node_views -->|"handles chat"| node_chat_assistant
node_pdf_analysis -->|"extracts and asks"| node_ai_helpers
node_chat_assistant -->|"asks"| node_ai_helpers
node_ai_helpers -->|"generates content"| node_gemini
node_app_setup -->|"loads"| node_profile_signal
node_profile_signal -->|"creates profile"| node_profiles
node_academic -.->|"persists records"| node_db
node_profiles -.->|"persists accounts"| node_db
node_blog_contact -.->|"persists records"| node_db
node_academic -.->|"stores files"| node_cloudinary
node_profiles -.->|"stores images"| node_cloudinary

click node_routes "https://github.com/vedantpachauri84/university-resource-website/blob/main/blog/urls.py"
click node_views "https://github.com/vedantpachauri84/university-resource-website/blob/main/blog/views.py"
click node_pages "https://github.com/vedantpachauri84/university-resource-website/tree/main/blog/templates"
click node_forms "https://github.com/vedantpachauri84/university-resource-website/blob/main/blog/forms.py"
click node_profiles "https://github.com/vedantpachauri84/university-resource-website/blob/main/blog/models.py"
click node_profile_signal "https://github.com/vedantpachauri84/university-resource-website/blob/main/blog/signals.py"
click node_app_setup "https://github.com/vedantpachauri84/university-resource-website/blob/main/blog/apps.py"
click node_academic "https://github.com/vedantpachauri84/university-resource-website/blob/main/blog/models.py"
click node_blog_contact "https://github.com/vedantpachauri84/university-resource-website/blob/main/blog/models.py"
click node_pdf_analysis "https://github.com/vedantpachauri84/university-resource-website/blob/main/blog/views.py"
click node_chat_assistant "https://github.com/vedantpachauri84/university-resource-website/blob/main/blog/views.py"
click node_ai_helpers "https://github.com/vedantpachauri84/university-resource-website/blob/main/blog/utils.py"
click node_db "https://github.com/vedantpachauri84/university-resource-website/blob/main/blogs/settings.py"

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_routes,node_views,node_pages toneBlue
class node_forms,node_profiles,node_profile_signal,node_app_setup toneAmber
class node_academic,node_blog_contact toneMint
class node_pdf_analysis,node_chat_assistant,node_ai_helpers toneRose
class node_db,node_cloudinary,node_gemini,node_student toneIndigo
```

## Components

### Web entry and UI

- [URL routes](https://github.com/vedantpachauri84/university-resource-website/blob/main/blog/urls.py): `blog/urls.py`
- [Request views](https://github.com/vedantpachauri84/university-resource-website/blob/main/blog/views.py): `blog/views.py`
- [Website pages](https://github.com/vedantpachauri84/university-resource-website/tree/main/blog/templates): `blog/templates`

### Accounts and profiles

- [Account and contact forms](https://github.com/vedantpachauri84/university-resource-website/blob/main/blog/forms.py): `blog/forms.py`
- [Profiles and accounts](https://github.com/vedantpachauri84/university-resource-website/blob/main/blog/models.py): `blog/models.py`
- [Profile creation signal](https://github.com/vedantpachauri84/university-resource-website/blob/main/blog/signals.py): `blog/signals.py`
- [App initialization](https://github.com/vedantpachauri84/university-resource-website/blob/main/blog/apps.py): `blog/apps.py`

### Academic content

- [Notes, papers, resources](https://github.com/vedantpachauri84/university-resource-website/blob/main/blog/models.py): `blog/models.py`
- [Blog and contact records](https://github.com/vedantpachauri84/university-resource-website/blob/main/blog/models.py): `blog/models.py`

### AI study tools

- [Paper analysis](https://github.com/vedantpachauri84/university-resource-website/blob/main/blog/views.py): `blog/views.py`
- [AI chatbot](https://github.com/vedantpachauri84/university-resource-website/blob/main/blog/views.py): `blog/views.py`
- [PDF and AI helpers](https://github.com/vedantpachauri84/university-resource-website/blob/main/blog/utils.py): `blog/utils.py`

### Persistence and services

- [Application database](https://github.com/vedantpachauri84/university-resource-website/blob/main/blogs/settings.py): `blogs/settings.py`
- **Cloudinary storage**
- **Gemini API**

### Other components

- **Student**

## Connections

- Student → URL routes: requests pages (evidence: `blog/urls.py`)
- URL routes → Request views: dispatches to (evidence: `blog/urls.py`)
- Request views → Website pages: renders (evidence: `blog/views.py`)
- Request views → Account and contact forms: validates with (evidence: `blog/views.py`)
- Request views → Notes, papers, resources: queries (evidence: `blog/views.py`)
- Request views → Blog and contact records: queries and saves (evidence: `blog/views.py`)
- Request views → Profiles and accounts: loads and updates (evidence: `blog/views.py`)
- Request views → Paper analysis: handles analysis (evidence: `blog/urls.py`)
- Request views → AI chatbot: handles chat (evidence: `blog/urls.py`)
- Paper analysis → PDF and AI helpers: extracts and asks (evidence: `blog/views.py`)
- AI chatbot → PDF and AI helpers: asks (evidence: `blog/views.py`)
- PDF and AI helpers → Gemini API: generates content (evidence: `blog/utils.py`)
- App initialization → Profile creation signal: loads (evidence: `blog/apps.py`)
- Profile creation signal → Profiles and accounts: creates profile (evidence: `blog/signals.py`)
- Notes, papers, resources → Application database: persists records
- Profiles and accounts → Application database: persists accounts
- Blog and contact records → Application database: persists records
- Notes, papers, resources → Cloudinary storage: stores files
- Profiles and accounts → Cloudinary storage: stores images
