# yashwanth2307/vignan_connect architecture

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

- Interactive diagram: https://gitdiagram.com/yashwanth2307/vignan_connect
- Repository: https://github.com/yashwanth2307/vignan_connect

## Overview

V-Connect is a campus-management portal serving students, faculty, administrators, HODs, the TPO, and Exam Cell. Users enter through role-specific dashboards; protected backend endpoints then handle academic, attendance, assessment, community, event, or placement operations, with Prisma-backed persistence. The graph preserves the README’s major capabilities and the sampled service/controller boundaries. Frontend-to-API wiring and several unsampled feature implementations are not shown in the excerpts, so those connections are marked unverified rather than asserted.

Main entry points: [`backend/src/app.module.ts`](https://github.com/yashwanth2307/vignan_connect/blob/main/backend/src/app.module.ts) (Nest application), [`backend/src/prisma/prisma.service.ts`](https://github.com/yashwanth2307/vignan_connect/blob/main/backend/src/prisma/prisma.service.ts) (PostgreSQL data), [`backend/src/auth/auth.service.ts`](https://github.com/yashwanth2307/vignan_connect/blob/main/backend/src/auth/auth.service.ts) (Authentication), [`backend/src/attendance/attendance.service.ts`](https://github.com/yashwanth2307/vignan_connect/blob/main/backend/src/attendance/attendance.service.ts) (Attendance)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["Portal experience"]
  node_web["Role dashboards"]
  node_login["Sign-in page<br/>[page.tsx]"]
end

subgraph group_identity["Identity and access"]
  node_auth["Authentication<br/>[auth.service.ts]"]
  node_access["JWT and role guards"]
  node_users["User management<br/>[users.service.ts]"]
end

subgraph group_academics["Academic operations"]
  node_academic["Academic structure"]
  node_timetable["Timetables and calendar"]
  node_attendance["Attendance"]
  node_assignments["Assignments and groups"]
  node_exam["Exams and results<br/>[exam.service.ts]"]
  node_promotion["Semester promotion"]
end

subgraph group_campus["Campus and activities"]
  node_placements["Placement drives"]
  node_code["Code Arena"]
  node_online["Online classes"]
  node_events["Events and clubs"]
  node_media["Gallery and magazine"]
  node_notices["Announcements"]
  node_requests["Service requests"]
end

subgraph group_platform["Runtime services"]
  node_api["Nest application<br/>[app.module.ts]"]
  node_db[("PostgreSQL data<br/>[prisma.service.ts]")]
  node_cache[("Redis sessions<br/>[redis.service.ts]")]
  node_email["Email alerts<br/>[email.service.ts]"]
  node_webhooks["Webhook service<br/>[webhook.service.ts]"]
end

node_people(("Campus users"))

node_people -->|"signs in"| node_login
node_people -->|"uses portal"| node_web
node_login -.->|"submits credentials"| node_auth
node_web -.->|"requests operations"| node_api
node_api -->|"registers module"| node_auth
node_api -->|"registers module"| node_users
node_auth -->|"reads users"| node_db
node_auth -->|"stores refresh tokens"| node_cache
node_access -.->|"validates requests"| node_auth
node_access -->|"protects routes"| node_users
node_users -.->|"persists profiles"| node_db
node_api -->|"registers module"| node_academic
node_api -->|"registers module"| node_timetable
node_api -->|"registers module"| node_attendance
node_api -->|"registers module"| node_assignments
node_api -->|"registers module"| node_exam
node_api -.->|"registers module"| node_promotion
node_attendance -->|"reads and writes"| node_db
node_attendance -->|"notifies"| node_webhooks
node_assignments -->|"persists work"| node_db
node_exam -->|"persists results"| node_db
node_api -->|"registers module"| node_placements
node_api -->|"registers module"| node_code
node_api -->|"registers module"| node_online
node_api -.->|"registers module"| node_events
node_api -.->|"registers module"| node_media
node_api -->|"registers module"| node_notices
node_api -.->|"registers module"| node_requests
node_placements -.->|"persists drives"| node_db
node_code -->|"persists challenges"| node_db
node_online -->|"persists classes"| node_db
node_events -.->|"persists events"| node_db
node_media -.->|"stores media"| node_db
node_notices -.->|"sends alerts"| node_email
node_api -->|"registers module"| node_email
node_api -->|"registers module"| node_webhooks

click node_web "https://github.com/yashwanth2307/vignan_connect/tree/main/web/src/app/dashboard"
click node_login "https://github.com/yashwanth2307/vignan_connect/blob/main/web/src/app/login/page.tsx"
click node_auth "https://github.com/yashwanth2307/vignan_connect/blob/main/backend/src/auth/auth.service.ts"
click node_access "https://github.com/yashwanth2307/vignan_connect/tree/main/backend/src/auth/guards"
click node_users "https://github.com/yashwanth2307/vignan_connect/blob/main/backend/src/users/users.service.ts"
click node_academic "https://github.com/yashwanth2307/vignan_connect/tree/main/backend/src/subjects"
click node_timetable "https://github.com/yashwanth2307/vignan_connect/blob/main/backend/src/timetable/timetable.service.ts"
click node_attendance "https://github.com/yashwanth2307/vignan_connect/blob/main/backend/src/attendance/attendance.service.ts"
click node_assignments "https://github.com/yashwanth2307/vignan_connect/blob/main/backend/src/assignments/assignments.service.ts"
click node_exam "https://github.com/yashwanth2307/vignan_connect/blob/main/backend/src/exam/exam.service.ts"
click node_promotion "https://github.com/yashwanth2307/vignan_connect/tree/main/backend/src/semester-promotion"
click node_placements "https://github.com/yashwanth2307/vignan_connect/blob/main/backend/src/placements/placements.service.ts"
click node_code "https://github.com/yashwanth2307/vignan_connect/blob/main/backend/src/code-arena/code-arena.service.ts"
click node_online "https://github.com/yashwanth2307/vignan_connect/blob/main/backend/src/online-classes/online-classes.service.ts"
click node_events "https://github.com/yashwanth2307/vignan_connect/tree/main/backend/src/events"
click node_media "https://github.com/yashwanth2307/vignan_connect/tree/main/backend/src/college-gallery"
click node_notices "https://github.com/yashwanth2307/vignan_connect/tree/main/backend/src/announcements"
click node_requests "https://github.com/yashwanth2307/vignan_connect/blob/main/backend/src/requests/requests.controller.ts"
click node_api "https://github.com/yashwanth2307/vignan_connect/blob/main/backend/src/app.module.ts"
click node_db "https://github.com/yashwanth2307/vignan_connect/blob/main/backend/src/prisma/prisma.service.ts"
click node_cache "https://github.com/yashwanth2307/vignan_connect/blob/main/backend/src/redis/redis.service.ts"
click node_email "https://github.com/yashwanth2307/vignan_connect/blob/main/backend/src/email/email.service.ts"
click node_webhooks "https://github.com/yashwanth2307/vignan_connect/blob/main/backend/src/webhooks/webhook.service.ts"

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_web,node_login,node_people toneBlue
class node_auth,node_access,node_users toneAmber
class node_academic,node_timetable,node_attendance,node_assignments,node_exam,node_promotion toneMint
class node_placements,node_code,node_online,node_events,node_media,node_notices,node_requests toneRose
class node_api,node_db,node_cache,node_email,node_webhooks toneIndigo
```

## Components

### Portal experience

- [Role dashboards](https://github.com/yashwanth2307/vignan_connect/tree/main/web/src/app/dashboard): `web/src/app/dashboard`
- [Sign-in page](https://github.com/yashwanth2307/vignan_connect/blob/main/web/src/app/login/page.tsx): `web/src/app/login/page.tsx`

### Identity and access

- [Authentication](https://github.com/yashwanth2307/vignan_connect/blob/main/backend/src/auth/auth.service.ts): `backend/src/auth/auth.service.ts`
- [JWT and role guards](https://github.com/yashwanth2307/vignan_connect/tree/main/backend/src/auth/guards): `backend/src/auth/guards`
- [User management](https://github.com/yashwanth2307/vignan_connect/blob/main/backend/src/users/users.service.ts): `backend/src/users/users.service.ts`

### Academic operations

- [Academic structure](https://github.com/yashwanth2307/vignan_connect/tree/main/backend/src/subjects): `backend/src/subjects`
- [Timetables and calendar](https://github.com/yashwanth2307/vignan_connect/blob/main/backend/src/timetable/timetable.service.ts): `backend/src/timetable/timetable.service.ts`
- [Attendance](https://github.com/yashwanth2307/vignan_connect/blob/main/backend/src/attendance/attendance.service.ts): `backend/src/attendance/attendance.service.ts`
- [Assignments and groups](https://github.com/yashwanth2307/vignan_connect/blob/main/backend/src/assignments/assignments.service.ts): `backend/src/assignments/assignments.service.ts`
- [Exams and results](https://github.com/yashwanth2307/vignan_connect/blob/main/backend/src/exam/exam.service.ts): `backend/src/exam/exam.service.ts`
- [Semester promotion](https://github.com/yashwanth2307/vignan_connect/tree/main/backend/src/semester-promotion): `backend/src/semester-promotion`

### Campus and activities

- [Placement drives](https://github.com/yashwanth2307/vignan_connect/blob/main/backend/src/placements/placements.service.ts): `backend/src/placements/placements.service.ts`
- [Code Arena](https://github.com/yashwanth2307/vignan_connect/blob/main/backend/src/code-arena/code-arena.service.ts): `backend/src/code-arena/code-arena.service.ts`
- [Online classes](https://github.com/yashwanth2307/vignan_connect/blob/main/backend/src/online-classes/online-classes.service.ts): `backend/src/online-classes/online-classes.service.ts`
- [Events and clubs](https://github.com/yashwanth2307/vignan_connect/tree/main/backend/src/events): `backend/src/events`
- [Gallery and magazine](https://github.com/yashwanth2307/vignan_connect/tree/main/backend/src/college-gallery): `backend/src/college-gallery`
- [Announcements](https://github.com/yashwanth2307/vignan_connect/tree/main/backend/src/announcements): `backend/src/announcements`
- [Service requests](https://github.com/yashwanth2307/vignan_connect/blob/main/backend/src/requests/requests.controller.ts): `backend/src/requests/requests.controller.ts`

### Runtime services

- [Nest application](https://github.com/yashwanth2307/vignan_connect/blob/main/backend/src/app.module.ts): `backend/src/app.module.ts`
- [PostgreSQL data](https://github.com/yashwanth2307/vignan_connect/blob/main/backend/src/prisma/prisma.service.ts): `backend/src/prisma/prisma.service.ts`
- [Redis sessions](https://github.com/yashwanth2307/vignan_connect/blob/main/backend/src/redis/redis.service.ts): `backend/src/redis/redis.service.ts`
- [Email alerts](https://github.com/yashwanth2307/vignan_connect/blob/main/backend/src/email/email.service.ts): `backend/src/email/email.service.ts`
- [Webhook service](https://github.com/yashwanth2307/vignan_connect/blob/main/backend/src/webhooks/webhook.service.ts): `backend/src/webhooks/webhook.service.ts`

### Other components

- **Campus users**

## Connections

- Campus users → Sign-in page: signs in
- Campus users → Role dashboards: uses portal
- Sign-in page → Authentication: submits credentials
- Role dashboards → Nest application: requests operations
- Nest application → Authentication: registers module (evidence: `backend/src/app.module.ts`)
- Nest application → User management: registers module (evidence: `backend/src/app.module.ts`)
- Authentication → PostgreSQL data: reads users (evidence: `backend/src/auth/auth.service.ts`)
- Authentication → Redis sessions: stores refresh tokens (evidence: `backend/src/auth/auth.service.ts`)
- JWT and role guards → Authentication: validates requests
- JWT and role guards → User management: protects routes (evidence: `backend/src/users/users.controller.ts`)
- User management → PostgreSQL data: persists profiles
- Nest application → Academic structure: registers module (evidence: `backend/src/app.module.ts`)
- Nest application → Timetables and calendar: registers module (evidence: `backend/src/app.module.ts`)
- Nest application → Attendance: registers module (evidence: `backend/src/app.module.ts`)
- Nest application → Assignments and groups: registers module (evidence: `backend/src/app.module.ts`)
- Nest application → Exams and results: registers module (evidence: `backend/src/app.module.ts`)
- Nest application → Semester promotion: registers module (evidence: `backend/src/app.module.ts`)
- Attendance → PostgreSQL data: reads and writes (evidence: `backend/src/attendance/attendance.service.ts`)
- Attendance → Webhook service: notifies (evidence: `backend/src/attendance/attendance.service.ts`)
- Assignments and groups → PostgreSQL data: persists work (evidence: `backend/src/assignments/assignments.service.ts`)
- Exams and results → PostgreSQL data: persists results (evidence: `backend/src/exam/exam.service.ts`)
- Nest application → Placement drives: registers module (evidence: `backend/src/app.module.ts`)
- Nest application → Code Arena: registers module (evidence: `backend/src/app.module.ts`)
- Nest application → Online classes: registers module (evidence: `backend/src/app.module.ts`)
- Nest application → Events and clubs: registers module (evidence: `backend/src/app.module.ts`)
- Nest application → Gallery and magazine: registers module (evidence: `backend/src/app.module.ts`)
- Nest application → Announcements: registers module (evidence: `backend/src/app.module.ts`)
- Nest application → Service requests: registers module
- Placement drives → PostgreSQL data: persists drives
- Code Arena → PostgreSQL data: persists challenges (evidence: `backend/src/code-arena/code-arena.service.ts`)
- Online classes → PostgreSQL data: persists classes (evidence: `backend/src/online-classes/online-classes.service.ts`)
- Events and clubs → PostgreSQL data: persists events
- Gallery and magazine → PostgreSQL data: stores media
- Announcements → Email alerts: sends alerts
- Nest application → Email alerts: registers module (evidence: `backend/src/app.module.ts`)
- Nest application → Webhook service: registers module (evidence: `backend/src/app.module.ts`)
