# hemanth2607-cyber/aiml-website architecture

> Architecture diagram of the GitHub repository hemanth2607-cyber/aiml-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/hemanth2607-cyber/aiml-website
- Repository: https://github.com/hemanth2607-cyber/aiml-website

## Overview

This is a college AI & ML department portal. Visitors browse the home page; authenticated users access events, announcements, or academic updates, while administrators manage accounts and registrations. Sign-in includes Google OAuth and password recovery. The Express application in server.js owns routing, access checks, database queries, and rendering. The excerpts show these routes and some database operations, but omit much of the server; unsampled feature connections are therefore not inferred.

Main entry points: [`server.js`](https://github.com/hemanth2607-cyber/aiml-website/blob/main/server.js) (Express portal), [`views/index.ejs`](https://github.com/hemanth2607-cyber/aiml-website/blob/main/views/index.ejs) (Home page), [`views/events.ejs`](https://github.com/hemanth2607-cyber/aiml-website/blob/main/views/events.ejs) (Events page), [`views/academics.ejs`](https://github.com/hemanth2607-cyber/aiml-website/blob/main/views/academics.ejs) (Academics page)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Portal pages"]
  node_home["Home page<br/>[index.ejs]"]
  node_eventspage["Events page<br/>[events.ejs]"]
  node_academicspage["Academics page<br/>[academics.ejs]"]
  node_announcementspage["Announcements page<br/>[announcements.ejs]"]
end

subgraph group_identity["Identity and access"]
  node_loginpage["Login page<br/>[login.ejs]"]
  node_recovery["Password recovery"]
  node_reset["Password reset<br/>[reset-password.ejs]"]
  node_google_setup["Google setup<br/>[google-setup.ejs]"]
  node_google["Google OAuth"]
end

subgraph group_content["Portal content"]
end

subgraph group_management["Administration"]
  node_adminpage["Admin console<br/>[admin.ejs]"]
  node_admin_ops["Admin operations<br/>[server.js]"]
end

node_visitor(("Visitor or user"))
node_app["Express portal<br/>[server.js]"]
node_postgres[("PostgreSQL")]
node_email["Email service"]

node_visitor -->|"requests pages"| node_app
node_app -->|"renders"| node_home
node_app -->|"renders"| node_eventspage
node_app -->|"renders"| node_academicspage
node_app -->|"renders"| node_announcementspage
node_app -->|"queries content"| node_postgres
node_app -->|"renders"| node_loginpage
node_app -->|"renders"| node_recovery
node_app -->|"renders"| node_reset
node_app -->|"renders"| node_google_setup
node_app -->|"redirects and exchanges code"| node_google
node_app -->|"manages accounts"| node_postgres
node_app -.->|"sends recovery link"| node_email
node_app -->|"routes admin actions"| node_admin_ops
node_admin_ops -.->|"renders"| node_adminpage
node_admin_ops -->|"updates records"| node_postgres

click node_app "https://github.com/hemanth2607-cyber/aiml-website/blob/main/server.js"
click node_home "https://github.com/hemanth2607-cyber/aiml-website/blob/main/views/index.ejs"
click node_eventspage "https://github.com/hemanth2607-cyber/aiml-website/blob/main/views/events.ejs"
click node_academicspage "https://github.com/hemanth2607-cyber/aiml-website/blob/main/views/academics.ejs"
click node_announcementspage "https://github.com/hemanth2607-cyber/aiml-website/blob/main/views/announcements.ejs"
click node_loginpage "https://github.com/hemanth2607-cyber/aiml-website/blob/main/views/login.ejs"
click node_recovery "https://github.com/hemanth2607-cyber/aiml-website/blob/main/views/forgot-password.ejs"
click node_reset "https://github.com/hemanth2607-cyber/aiml-website/blob/main/views/reset-password.ejs"
click node_google_setup "https://github.com/hemanth2607-cyber/aiml-website/blob/main/views/google-setup.ejs"
click node_adminpage "https://github.com/hemanth2607-cyber/aiml-website/blob/main/views/admin.ejs"
click node_admin_ops "https://github.com/hemanth2607-cyber/aiml-website/blob/main/server.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_home,node_eventspage,node_academicspage,node_announcementspage,node_visitor toneBlue
class node_loginpage,node_recovery,node_reset,node_google_setup,node_google,node_postgres toneAmber
class node_adminpage,node_admin_ops toneRose
class node_app toneTeal
class node_email toneIndigo
```

## Components

### Portal pages

- [Home page](https://github.com/hemanth2607-cyber/aiml-website/blob/main/views/index.ejs): `views/index.ejs`
- [Events page](https://github.com/hemanth2607-cyber/aiml-website/blob/main/views/events.ejs): `views/events.ejs`
- [Academics page](https://github.com/hemanth2607-cyber/aiml-website/blob/main/views/academics.ejs): `views/academics.ejs`
- [Announcements page](https://github.com/hemanth2607-cyber/aiml-website/blob/main/views/announcements.ejs): `views/announcements.ejs`

### Identity and access

- [Login page](https://github.com/hemanth2607-cyber/aiml-website/blob/main/views/login.ejs): `views/login.ejs`
- [Password recovery](https://github.com/hemanth2607-cyber/aiml-website/blob/main/views/forgot-password.ejs): `views/forgot-password.ejs`
- [Password reset](https://github.com/hemanth2607-cyber/aiml-website/blob/main/views/reset-password.ejs): `views/reset-password.ejs`
- [Google setup](https://github.com/hemanth2607-cyber/aiml-website/blob/main/views/google-setup.ejs): `views/google-setup.ejs`
- **Google OAuth**

### Administration

- [Admin console](https://github.com/hemanth2607-cyber/aiml-website/blob/main/views/admin.ejs): `views/admin.ejs`
- [Admin operations](https://github.com/hemanth2607-cyber/aiml-website/blob/main/server.js): `server.js`

### Other components

- **Visitor or user**
- [Express portal](https://github.com/hemanth2607-cyber/aiml-website/blob/main/server.js): `server.js`
- **PostgreSQL**
- **Email service**

## Connections

- Visitor or user → Express portal: requests pages (evidence: `server.js`)
- Express portal → Home page: renders (evidence: `server.js`)
- Express portal → Events page: renders (evidence: `server.js`)
- Express portal → Academics page: renders (evidence: `server.js`)
- Express portal → Announcements page: renders (evidence: `server.js`)
- Express portal → PostgreSQL: queries content (evidence: `server.js`)
- Express portal → Login page: renders
- Express portal → Password recovery: renders (evidence: `server.js`)
- Express portal → Password reset: renders (evidence: `server.js`)
- Express portal → Google setup: renders (evidence: `server.js`)
- Express portal → Google OAuth: redirects and exchanges code (evidence: `server.js`)
- Express portal → PostgreSQL: manages accounts (evidence: `server.js`)
- Express portal → Email service: sends recovery link
- Express portal → Admin operations: routes admin actions (evidence: `server.js`)
- Admin operations → Admin console: renders
- Admin operations → PostgreSQL: updates records (evidence: `server.js`)
