# arishwaran27102007-ui/ajv-collegeconnect architecture

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

- Interactive diagram: https://gitdiagram.com/arishwaran27102007-ui/ajv-collegeconnect
- Repository: https://github.com/arishwaran27102007-ui/ajv-collegeconnect

## Overview

AJV CollegeConnect is a student, faculty, and administration academic portal with web, PWA, and Android access. The main workflow is user sign-in and role-based access, followed by portal requests for academic records, attendance, announcements, fees, or administrative actions; the API delegates data operations to a dual-mode database layer. The README documents the broader feature set, but frontend source was not sampled, so its internal routing and calls are not shown. Android login and backend-to-database calls are supported by excerpts.

Main entry points: [`backend/server.js`](https://github.com/arishwaran27102007-ui/ajv-collegeconnect/blob/main/backend/server.js) (Express API), [`backend/db.js`](https://github.com/arishwaran27102007-ui/ajv-collegeconnect/blob/main/backend/db.js) (Database Engine), [`frontend/assets/app.js`](https://github.com/arishwaran27102007-ui/ajv-collegeconnect/blob/main/frontend/assets/app.js) (Web Portal), [`android/app/src/main/java/com/ajv/collegeconnect/ui/LoginScreen.kt`](https://github.com/arishwaran27102007-ui/ajv-collegeconnect/blob/main/android/app/src/main/java/com/ajv/collegeconnect/ui/LoginScreen.kt) (Android Login)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_clients["Client Applications"]
  node_web["Web Portal<br/>[app.js]"]
  node_pwa["Offline PWA<br/>[sw.js]"]
  node_android["Android App<br/>[MainActivity.kt]"]
  node_androidlogin["Android Login<br/>[LoginScreen.kt]"]
  node_androidapi["Retrofit Client<br/>[RetrofitClient.kt]"]
  node_collegeapi["Android API<br/>[CollegeApi.kt]"]
  node_models["Android Models<br/>[Models.kt]"]
end

subgraph group_service["Backend Service"]
  node_api["Express API<br/>[server.js]"]
  node_auth["Authentication &amp; Roles<br/>[server.js]"]
  node_profiles["Profiles &amp; Onboarding<br/>[server.js]"]
end

subgraph group_academic["Academic Records"]
  node_academicengine["Grades &amp; CGPA<br/>[db.js]"]
  node_attendance["Attendance Alerts<br/>[db.js]"]
  node_marksheets["Results &amp; Marksheets<br/>[server.js]"]
end

subgraph group_campus["Campus Services"]
  node_admin["Staff Console Services<br/>[server.js]"]
  node_campusnews["Announcements<br/>[server.js]"]
  node_hallticket["Hall Tickets<br/>[server.js]"]
  node_fees["Fee Ledger &amp; Receipts<br/>[server.js]"]
end

subgraph group_persistence["Persistence"]
  node_dbengine["Database Engine<br/>[db.js]"]
  node_jsonstore[("Persistent JSON<br/>[db.json]")]
end

node_students(("Students"))
node_staff(("Faculty &amp; Admin"))
node_razorpay["Razorpay"]
node_postgres[("PostgreSQL")]

node_students -->|"use portal"| node_web
node_staff -->|"manage campus"| node_web
node_web -->|"request services"| node_api
node_android -->|"shows login"| node_androidlogin
node_androidlogin -->|"submits login"| node_androidapi
node_androidapi -->|"creates API"| node_collegeapi
node_collegeapi -->|"calls endpoints"| node_api
node_androidlogin -->|"uses request model"| node_models
node_api -->|"routes login"| node_auth
node_api -->|"routes profile"| node_profiles
node_api -->|"routes staff actions"| node_admin
node_api -->|"requests academic data"| node_academicengine
node_api -.->|"requests attendance data"| node_attendance
node_api -->|"serves semester results"| node_marksheets
node_api -->|"serves announcements"| node_campusnews
node_api -->|"serves hall tickets"| node_hallticket
node_api -->|"handles fee requests"| node_fees
node_fees -.->|"supports checkout"| node_razorpay
node_auth -->|"looks up users"| node_dbengine
node_profiles -->|"reads and updates"| node_dbengine
node_admin -->|"manages records"| node_dbengine
node_academicengine -.->|"uses persistence"| node_dbengine
node_attendance -.->|"uses persistence"| node_dbengine
node_marksheets -->|"loads records"| node_dbengine
node_campusnews -->|"loads notices"| node_dbengine
node_hallticket -->|"loads ticket data"| node_dbengine
node_fees -->|"handles fee data"| node_dbengine
node_dbengine -->|"persists JSON"| node_jsonstore
node_dbengine -->|"connects when configured"| node_postgres
node_web -->|"offline shell"| node_pwa

click node_web "https://github.com/arishwaran27102007-ui/ajv-collegeconnect/blob/main/frontend/assets/app.js"
click node_pwa "https://github.com/arishwaran27102007-ui/ajv-collegeconnect/blob/main/frontend/sw.js"
click node_android "https://github.com/arishwaran27102007-ui/ajv-collegeconnect/blob/main/android/app/src/main/java/com/ajv/collegeconnect/MainActivity.kt"
click node_androidlogin "https://github.com/arishwaran27102007-ui/ajv-collegeconnect/blob/main/android/app/src/main/java/com/ajv/collegeconnect/ui/LoginScreen.kt"
click node_androidapi "https://github.com/arishwaran27102007-ui/ajv-collegeconnect/blob/main/android/app/src/main/java/com/ajv/collegeconnect/api/RetrofitClient.kt"
click node_collegeapi "https://github.com/arishwaran27102007-ui/ajv-collegeconnect/blob/main/android/app/src/main/java/com/ajv/collegeconnect/api/CollegeApi.kt"
click node_models "https://github.com/arishwaran27102007-ui/ajv-collegeconnect/blob/main/android/app/src/main/java/com/ajv/collegeconnect/models/Models.kt"
click node_api "https://github.com/arishwaran27102007-ui/ajv-collegeconnect/blob/main/backend/server.js"
click node_auth "https://github.com/arishwaran27102007-ui/ajv-collegeconnect/blob/main/backend/server.js"
click node_profiles "https://github.com/arishwaran27102007-ui/ajv-collegeconnect/blob/main/backend/server.js"
click node_admin "https://github.com/arishwaran27102007-ui/ajv-collegeconnect/blob/main/backend/server.js"
click node_academicengine "https://github.com/arishwaran27102007-ui/ajv-collegeconnect/blob/main/backend/db.js"
click node_attendance "https://github.com/arishwaran27102007-ui/ajv-collegeconnect/blob/main/backend/db.js"
click node_marksheets "https://github.com/arishwaran27102007-ui/ajv-collegeconnect/blob/main/backend/server.js"
click node_campusnews "https://github.com/arishwaran27102007-ui/ajv-collegeconnect/blob/main/backend/server.js"
click node_hallticket "https://github.com/arishwaran27102007-ui/ajv-collegeconnect/blob/main/backend/server.js"
click node_fees "https://github.com/arishwaran27102007-ui/ajv-collegeconnect/blob/main/backend/server.js"
click node_dbengine "https://github.com/arishwaran27102007-ui/ajv-collegeconnect/blob/main/backend/db.js"
click node_jsonstore "https://github.com/arishwaran27102007-ui/ajv-collegeconnect/blob/main/data/db.json"

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_pwa,node_android,node_androidlogin,node_androidapi,node_collegeapi,node_models toneBlue
class node_api,node_auth,node_profiles,node_postgres toneAmber
class node_academicengine,node_attendance,node_marksheets toneMint
class node_admin,node_campusnews,node_hallticket,node_fees toneRose
class node_dbengine,node_jsonstore,node_students,node_staff,node_razorpay toneIndigo
```

## Components

### Client Applications

- [Web Portal](https://github.com/arishwaran27102007-ui/ajv-collegeconnect/blob/main/frontend/assets/app.js): `frontend/assets/app.js`
- [Offline PWA](https://github.com/arishwaran27102007-ui/ajv-collegeconnect/blob/main/frontend/sw.js): `frontend/sw.js`
- [Android App](https://github.com/arishwaran27102007-ui/ajv-collegeconnect/blob/main/android/app/src/main/java/com/ajv/collegeconnect/MainActivity.kt): `android/app/src/main/java/com/ajv/collegeconnect/MainActivity.kt`
- [Android Login](https://github.com/arishwaran27102007-ui/ajv-collegeconnect/blob/main/android/app/src/main/java/com/ajv/collegeconnect/ui/LoginScreen.kt): `android/app/src/main/java/com/ajv/collegeconnect/ui/LoginScreen.kt`
- [Retrofit Client](https://github.com/arishwaran27102007-ui/ajv-collegeconnect/blob/main/android/app/src/main/java/com/ajv/collegeconnect/api/RetrofitClient.kt): `android/app/src/main/java/com/ajv/collegeconnect/api/RetrofitClient.kt`
- [Android API](https://github.com/arishwaran27102007-ui/ajv-collegeconnect/blob/main/android/app/src/main/java/com/ajv/collegeconnect/api/CollegeApi.kt): `android/app/src/main/java/com/ajv/collegeconnect/api/CollegeApi.kt`
- [Android Models](https://github.com/arishwaran27102007-ui/ajv-collegeconnect/blob/main/android/app/src/main/java/com/ajv/collegeconnect/models/Models.kt): `android/app/src/main/java/com/ajv/collegeconnect/models/Models.kt`

### Backend Service

- [Express API](https://github.com/arishwaran27102007-ui/ajv-collegeconnect/blob/main/backend/server.js): `backend/server.js`
- [Authentication & Roles](https://github.com/arishwaran27102007-ui/ajv-collegeconnect/blob/main/backend/server.js): `backend/server.js`
- [Profiles & Onboarding](https://github.com/arishwaran27102007-ui/ajv-collegeconnect/blob/main/backend/server.js): `backend/server.js`

### Academic Records

- [Grades & CGPA](https://github.com/arishwaran27102007-ui/ajv-collegeconnect/blob/main/backend/db.js): `backend/db.js`
- [Attendance Alerts](https://github.com/arishwaran27102007-ui/ajv-collegeconnect/blob/main/backend/db.js): `backend/db.js`
- [Results & Marksheets](https://github.com/arishwaran27102007-ui/ajv-collegeconnect/blob/main/backend/server.js): `backend/server.js`

### Campus Services

- [Staff Console Services](https://github.com/arishwaran27102007-ui/ajv-collegeconnect/blob/main/backend/server.js): `backend/server.js`
- [Announcements](https://github.com/arishwaran27102007-ui/ajv-collegeconnect/blob/main/backend/server.js): `backend/server.js`
- [Hall Tickets](https://github.com/arishwaran27102007-ui/ajv-collegeconnect/blob/main/backend/server.js): `backend/server.js`
- [Fee Ledger & Receipts](https://github.com/arishwaran27102007-ui/ajv-collegeconnect/blob/main/backend/server.js): `backend/server.js`

### Persistence

- [Database Engine](https://github.com/arishwaran27102007-ui/ajv-collegeconnect/blob/main/backend/db.js): `backend/db.js`
- [Persistent JSON](https://github.com/arishwaran27102007-ui/ajv-collegeconnect/blob/main/data/db.json): `data/db.json`

### Other components

- **Students**
- **Faculty & Admin**
- **Razorpay**
- **PostgreSQL**

## Connections

- Students → Web Portal: use portal (evidence: `README.md`)
- Faculty & Admin → Web Portal: manage campus (evidence: `README.md`)
- Web Portal → Express API: request services (evidence: `README.md`)
- Android App → Android Login: shows login (evidence: `android/app/src/main/java/com/ajv/collegeconnect/MainActivity.kt`)
- Android Login → Retrofit Client: submits login (evidence: `android/app/src/main/java/com/ajv/collegeconnect/ui/LoginScreen.kt`)
- Retrofit Client → Android API: creates API (evidence: `android/app/src/main/java/com/ajv/collegeconnect/api/RetrofitClient.kt`)
- Android API → Express API: calls endpoints (evidence: `android/app/src/main/java/com/ajv/collegeconnect/api/CollegeApi.kt`)
- Android Login → Android Models: uses request model (evidence: `android/app/src/main/java/com/ajv/collegeconnect/ui/LoginScreen.kt`)
- Express API → Authentication & Roles: routes login (evidence: `backend/server.js`)
- Express API → Profiles & Onboarding: routes profile (evidence: `backend/server.js`)
- Express API → Staff Console Services: routes staff actions (evidence: `backend/server.js`)
- Express API → Grades & CGPA: requests academic data (evidence: `backend/server.js`)
- Express API → Attendance Alerts: requests attendance data (evidence: `backend/server.js`)
- Express API → Results & Marksheets: serves semester results (evidence: `backend/server.js`)
- Express API → Announcements: serves announcements (evidence: `backend/server.js`)
- Express API → Hall Tickets: serves hall tickets (evidence: `backend/server.js`)
- Express API → Fee Ledger & Receipts: handles fee requests (evidence: `backend/server.js`)
- Fee Ledger & Receipts → Razorpay: supports checkout (evidence: `README.md`)
- Authentication & Roles → Database Engine: looks up users (evidence: `backend/server.js`)
- Profiles & Onboarding → Database Engine: reads and updates (evidence: `backend/server.js`)
- Staff Console Services → Database Engine: manages records (evidence: `backend/server.js`)
- Grades & CGPA → Database Engine: uses persistence (evidence: `backend/db.js`)
- Attendance Alerts → Database Engine: uses persistence (evidence: `backend/db.js`)
- Results & Marksheets → Database Engine: loads records (evidence: `backend/server.js`)
- Announcements → Database Engine: loads notices (evidence: `backend/server.js`)
- Hall Tickets → Database Engine: loads ticket data (evidence: `backend/server.js`)
- Fee Ledger & Receipts → Database Engine: handles fee data (evidence: `backend/server.js`)
- Database Engine → Persistent JSON: persists JSON (evidence: `backend/db.js`)
- Database Engine → PostgreSQL: connects when configured (evidence: `backend/db.js`)
- Web Portal → Offline PWA: offline shell (evidence: `frontend/sw.js`)
