# ragavryan365/student-tracker-backend architecture

> Architecture diagram of the GitHub repository ragavryan365/student-tracker-backend, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-22). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ragavryan365/student-tracker-backend
- Repository: https://github.com/ragavryan365/student-tracker-backend

## Overview

This is a small Express backend for student tracking. Its main workflow fetches a class code and that class’s students, then supports subject listing, attendance verification, and attendance marking through PostgreSQL repositories. The route handlers and repository calls are shown in the sampled source; the README documents the database domain tables. No separate authentication or faculty-facing client is evidenced, so the initiating actor is represented generically.

Main entry points: [`src/repositories/readDBRepo.js`](https://github.com/ragavryan365/student-tracker-backend/blob/main/src/repositories/readDBRepo.js) (Read operations), [`src/config/connectDB.js`](https://github.com/ragavryan365/student-tracker-backend/blob/main/src/config/connectDB.js) (Connection pool), [`src/server.js`](https://github.com/ragavryan365/student-tracker-backend/blob/main/src/server.js) (Class students), [`src/repositories/writeDBRepo.js`](https://github.com/ragavryan365/student-tracker-backend/blob/main/src/repositories/writeDBRepo.js) (Write operation)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["API routes"]
  node_students_route["Class students<br/>[server.js]"]
  node_subjects_route["Subject list<br/>[server.js]"]
  node_verify_route["Verify attendance<br/>[server.js]"]
  node_mark_route["Mark attendance<br/>[server.js]"]
end

subgraph group_repositories["Database repositories"]
  node_read_repo["Read operations<br/>[readDBRepo.js]"]
  node_write_repo["Write operation<br/>[writeDBRepo.js]"]
end

subgraph group_persistence["Persistence"]
  node_pool["Connection pool<br/>[connectDB.js]"]
end

node_client(("API client"))
node_postgres[("PostgreSQL")]

node_client -->|"requests students"| node_students_route
node_client -->|"requests subjects"| node_subjects_route
node_client -->|"checks attendance"| node_verify_route
node_client -->|"submits attendance"| node_mark_route
node_students_route -->|"looks up class and students"| node_read_repo
node_subjects_route -->|"loads subjects"| node_read_repo
node_verify_route -->|"checks records"| node_read_repo
node_mark_route -->|"inserts attendance"| node_write_repo
node_read_repo -->|"queries"| node_pool
node_write_repo -->|"inserts through"| node_pool
node_pool -->|"connects to"| node_postgres

click node_students_route "https://github.com/ragavryan365/student-tracker-backend/blob/main/src/server.js"
click node_subjects_route "https://github.com/ragavryan365/student-tracker-backend/blob/main/src/server.js"
click node_verify_route "https://github.com/ragavryan365/student-tracker-backend/blob/main/src/server.js"
click node_mark_route "https://github.com/ragavryan365/student-tracker-backend/blob/main/src/server.js"
click node_read_repo "https://github.com/ragavryan365/student-tracker-backend/blob/main/src/repositories/readDBRepo.js"
click node_write_repo "https://github.com/ragavryan365/student-tracker-backend/blob/main/src/repositories/writeDBRepo.js"
click node_pool "https://github.com/ragavryan365/student-tracker-backend/blob/main/src/config/connectDB.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_students_route,node_subjects_route,node_verify_route,node_mark_route,node_client toneBlue
class node_read_repo,node_write_repo,node_postgres toneAmber
class node_pool toneMint
```

## Components

### API routes

- [Class students](https://github.com/ragavryan365/student-tracker-backend/blob/main/src/server.js): `src/server.js`
- [Subject list](https://github.com/ragavryan365/student-tracker-backend/blob/main/src/server.js): `src/server.js`
- [Verify attendance](https://github.com/ragavryan365/student-tracker-backend/blob/main/src/server.js): `src/server.js`
- [Mark attendance](https://github.com/ragavryan365/student-tracker-backend/blob/main/src/server.js): `src/server.js`

### Database repositories

- [Read operations](https://github.com/ragavryan365/student-tracker-backend/blob/main/src/repositories/readDBRepo.js): `src/repositories/readDBRepo.js`
- [Write operation](https://github.com/ragavryan365/student-tracker-backend/blob/main/src/repositories/writeDBRepo.js): `src/repositories/writeDBRepo.js`

### Persistence

- [Connection pool](https://github.com/ragavryan365/student-tracker-backend/blob/main/src/config/connectDB.js): `src/config/connectDB.js`

### Other components

- **API client**
- **PostgreSQL**

## Connections

- API client → Class students: requests students (evidence: `src/server.js`)
- API client → Subject list: requests subjects (evidence: `src/server.js`)
- API client → Verify attendance: checks attendance (evidence: `src/server.js`)
- API client → Mark attendance: submits attendance (evidence: `src/server.js`)
- Class students → Read operations: looks up class and students (evidence: `src/server.js`)
- Subject list → Read operations: loads subjects (evidence: `src/server.js`)
- Verify attendance → Read operations: checks records (evidence: `src/server.js`)
- Mark attendance → Write operation: inserts attendance (evidence: `src/server.js`)
- Read operations → Connection pool: queries (evidence: `src/repositories/readDBRepo.js`)
- Write operation → Connection pool: inserts through (evidence: `src/repositories/writeDBRepo.js`)
- Connection pool → PostgreSQL: connects to (evidence: `src/config/connectDB.js`)
