# ceejaydev1/igraph-it architecture

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

- Interactive diagram: https://gitdiagram.com/ceejaydev1/igraph-it
- Repository: https://github.com/ceejaydev1/igraph-it

## Overview

iGraph IT is documented as a learning-SDLC/UML-diagram app, but this repository snapshot contains only its Express authentication backend; the frontend and diagram workflows are absent. The visible user workflow is auth API request → route validation/protection → controller logic → Firebase-backed user/OTP/session state, with email OTP delivery and JWT session tokens. The graph represents only relationships shown in the sampled backend sources and README; the OTP model’s Firebase dependency is indexed but its implementation excerpt supports the storage role.

Main entry points: [`igraph-backend/controllers/authController.js`](https://github.com/ceejaydev1/igraph-it/blob/main/igraph-backend/controllers/authController.js) (Auth controller), [`igraph-backend/routes/authRoutes.js`](https://github.com/ceejaydev1/igraph-it/blob/main/igraph-backend/routes/authRoutes.js) (Auth routes), [`igraph-backend/config/firebase.js`](https://github.com/ceejaydev1/igraph-it/blob/main/igraph-backend/config/firebase.js) (Firebase Admin), [`igraph-backend/middleware/authMiddleware.js`](https://github.com/ceejaydev1/igraph-it/blob/main/igraph-backend/middleware/authMiddleware.js) (Access protection)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["HTTP API"]
  node_server["Express server<br/>[server.js]"]
  node_routes["Auth routes<br/>[authRoutes.js]"]
  node_validation["Request validation"]
end

subgraph group_identity["Identity workflows"]
  node_controller["Auth controller<br/>[authController.js]"]
  node_otpgen["OTP generation<br/>[generateOTP.js]"]
end

subgraph group_persistence["Firebase state"]
  node_users[("User records<br/>[userModel.js]")]
  node_otps[("OTP records<br/>[otpModel.js]")]
  node_sessions[("Session records<br/>[authController.js]")]
  node_firebase["Firebase Admin<br/>[firebase.js]"]
end

subgraph group_security["Auth security"]
  node_jwt["JWT utilities<br/>[generateJWT.js]"]
  node_protect["Access protection<br/>[authMiddleware.js]"]
end

subgraph group_messaging["Email delivery"]
  node_email["Email service<br/>[emailService.js]"]
end

node_client(("API client"))
node_firebase_auth["Firebase Auth"]
node_firestore[("Firestore")]
node_mail_provider["Gmail SMTP"]

node_client -->|"sends requests"| node_server
node_server -->|"mounts auth routes"| node_routes
node_routes -->|"validates inputs"| node_validation
node_routes -->|"protects logout"| node_protect
node_routes -->|"dispatches handlers"| node_controller
node_controller -->|"reads and updates"| node_users
node_controller -->|"manages codes"| node_otps
node_controller -->|"stores sessions"| node_sessions
node_controller -->|"creates and verifies"| node_firebase_auth
node_controller -->|"issues tokens"| node_jwt
node_controller -->|"generates codes"| node_otpgen
node_controller -->|"sends OTP mail"| node_email
node_protect -->|"verifies access tokens"| node_jwt
node_protect -->|"loads user"| node_users
node_users -->|"uses database client"| node_firebase
node_otps -->|"uses database client"| node_firebase
node_firebase -->|"provides Firestore"| node_firestore
node_firebase -->|"provides Admin Auth"| node_firebase_auth
node_email -->|"sends messages"| node_mail_provider

click node_server "https://github.com/ceejaydev1/igraph-it/blob/main/igraph-backend/server.js"
click node_routes "https://github.com/ceejaydev1/igraph-it/blob/main/igraph-backend/routes/authRoutes.js"
click node_validation "https://github.com/ceejaydev1/igraph-it/blob/main/igraph-backend/middleware/validationMiddleware.js"
click node_controller "https://github.com/ceejaydev1/igraph-it/blob/main/igraph-backend/controllers/authController.js"
click node_users "https://github.com/ceejaydev1/igraph-it/blob/main/igraph-backend/models/userModel.js"
click node_otps "https://github.com/ceejaydev1/igraph-it/blob/main/igraph-backend/models/otpModel.js"
click node_sessions "https://github.com/ceejaydev1/igraph-it/blob/main/igraph-backend/controllers/authController.js"
click node_firebase "https://github.com/ceejaydev1/igraph-it/blob/main/igraph-backend/config/firebase.js"
click node_jwt "https://github.com/ceejaydev1/igraph-it/blob/main/igraph-backend/utils/generateJWT.js"
click node_protect "https://github.com/ceejaydev1/igraph-it/blob/main/igraph-backend/middleware/authMiddleware.js"
click node_otpgen "https://github.com/ceejaydev1/igraph-it/blob/main/igraph-backend/utils/generateOTP.js"
click node_email "https://github.com/ceejaydev1/igraph-it/blob/main/igraph-backend/services/emailService.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_server,node_routes,node_validation,node_client toneBlue
class node_controller,node_otpgen,node_firestore toneAmber
class node_users,node_otps,node_sessions,node_firebase toneMint
class node_jwt,node_protect toneRose
class node_email,node_firebase_auth,node_mail_provider toneIndigo
```

## Components

### HTTP API

- [Express server](https://github.com/ceejaydev1/igraph-it/blob/main/igraph-backend/server.js): `igraph-backend/server.js`
- [Auth routes](https://github.com/ceejaydev1/igraph-it/blob/main/igraph-backend/routes/authRoutes.js): `igraph-backend/routes/authRoutes.js`
- [Request validation](https://github.com/ceejaydev1/igraph-it/blob/main/igraph-backend/middleware/validationMiddleware.js): `igraph-backend/middleware/validationMiddleware.js`

### Identity workflows

- [Auth controller](https://github.com/ceejaydev1/igraph-it/blob/main/igraph-backend/controllers/authController.js): `igraph-backend/controllers/authController.js`
- [OTP generation](https://github.com/ceejaydev1/igraph-it/blob/main/igraph-backend/utils/generateOTP.js): `igraph-backend/utils/generateOTP.js`

### Firebase state

- [User records](https://github.com/ceejaydev1/igraph-it/blob/main/igraph-backend/models/userModel.js): `igraph-backend/models/userModel.js`
- [OTP records](https://github.com/ceejaydev1/igraph-it/blob/main/igraph-backend/models/otpModel.js): `igraph-backend/models/otpModel.js`
- [Session records](https://github.com/ceejaydev1/igraph-it/blob/main/igraph-backend/controllers/authController.js): `igraph-backend/controllers/authController.js`
- [Firebase Admin](https://github.com/ceejaydev1/igraph-it/blob/main/igraph-backend/config/firebase.js): `igraph-backend/config/firebase.js`

### Auth security

- [JWT utilities](https://github.com/ceejaydev1/igraph-it/blob/main/igraph-backend/utils/generateJWT.js): `igraph-backend/utils/generateJWT.js`
- [Access protection](https://github.com/ceejaydev1/igraph-it/blob/main/igraph-backend/middleware/authMiddleware.js): `igraph-backend/middleware/authMiddleware.js`

### Email delivery

- [Email service](https://github.com/ceejaydev1/igraph-it/blob/main/igraph-backend/services/emailService.js): `igraph-backend/services/emailService.js`

### Other components

- **API client**
- **Firebase Auth**
- **Firestore**
- **Gmail SMTP**

## Connections

- API client → Express server: sends requests (evidence: `igraph-backend/server.js`)
- Express server → Auth routes: mounts auth routes (evidence: `igraph-backend/server.js`)
- Auth routes → Request validation: validates inputs (evidence: `igraph-backend/routes/authRoutes.js`)
- Auth routes → Access protection: protects logout (evidence: `igraph-backend/routes/authRoutes.js`)
- Auth routes → Auth controller: dispatches handlers (evidence: `igraph-backend/routes/authRoutes.js`)
- Auth controller → User records: reads and updates (evidence: `igraph-backend/controllers/authController.js`)
- Auth controller → OTP records: manages codes (evidence: `igraph-backend/controllers/authController.js`)
- Auth controller → Session records: stores sessions (evidence: `igraph-backend/controllers/authController.js`)
- Auth controller → Firebase Auth: creates and verifies (evidence: `igraph-backend/controllers/authController.js`)
- Auth controller → JWT utilities: issues tokens (evidence: `igraph-backend/controllers/authController.js`)
- Auth controller → OTP generation: generates codes (evidence: `igraph-backend/controllers/authController.js`)
- Auth controller → Email service: sends OTP mail (evidence: `igraph-backend/controllers/authController.js`)
- Access protection → JWT utilities: verifies access tokens (evidence: `igraph-backend/middleware/authMiddleware.js`)
- Access protection → User records: loads user (evidence: `igraph-backend/middleware/authMiddleware.js`)
- User records → Firebase Admin: uses database client (evidence: `igraph-backend/models/userModel.js`)
- OTP records → Firebase Admin: uses database client (evidence: `igraph-backend/models/otpModel.js`)
- Firebase Admin → Firestore: provides Firestore (evidence: `igraph-backend/config/firebase.js`)
- Firebase Admin → Firebase Auth: provides Admin Auth (evidence: `igraph-backend/config/firebase.js`)
- Email service → Gmail SMTP: sends messages (evidence: `igraph-backend/services/emailService.js`)
