# xceed-nitj/xceed-backend architecture

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

- Interactive diagram: https://gitdiagram.com/xceed-nitj/xceed-backend
- Repository: https://github.com/xceed-nitj/xceed-backend

## Overview

This is a conference-management backend exposing Express APIs for conference content and related records, plus certificate management, faculty profiles, and spreadsheet imports. The main workflow is an HTTP request routed to a feature handler, which performs CRUD operations against MongoDB and returns a response. The source excerpts show this clearly for certificates, committees, speakers, and faculty; many other conference endpoints are present in the tree but their implementation details were not sampled, so those are represented at subsystem level.

Main entry points: [`src/index.js`](https://github.com/xceed-nitj/xceed-backend/blob/main/src/index.js) (Express application), [`src/confrenceModule/crud`](https://github.com/xceed-nitj/xceed-backend/tree/main/src/confrenceModule/crud) (Conference CRUD), [`src/confrenceModule/models`](https://github.com/xceed-nitj/xceed-backend/tree/main/src/confrenceModule/models) (Conference models), [`src/confrenceModule/routes`](https://github.com/xceed-nitj/xceed-backend/tree/main/src/confrenceModule/routes) (Conference routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["API runtime"]
  node_app["Express application<br/>[index.js]"]
end

subgraph group_conference["Conference management"]
  node_conference_routes["Conference routes"]
  node_conference_crud["Conference CRUD"]
  node_http_errors["HTTP exceptions<br/>[http-exception.js]"]
end

subgraph group_related["Related services"]
  node_certificate_routes["Certificate routes<br/>[certificate.js]"]
  node_certificate_controller["Certificate controller<br/>[certificate.js]"]
  node_faculty_routes["Faculty routes<br/>[faculty.js]"]
  node_faculty_controller["Faculty controller<br/>[facultyprofile.js]"]
  node_upload_api["Spreadsheet upload<br/>[upload.js]"]
end

subgraph group_persistence["Persistence"]
  node_conference_models[("Conference models")]
  node_certificate_model[("Certificate model<br/>[certificate.js]")]
  node_faculty_model[("Faculty model<br/>[faculty.js]")]
  node_mongo[("MongoDB")]
end

node_client(("API client"))

node_client -->|"sends request"| node_app
node_app -->|"mounts routes"| node_conference_routes
node_app -->|"mounts routes"| node_certificate_routes
node_app -->|"mounts routes"| node_faculty_routes
node_app -->|"mounts route"| node_upload_api
node_conference_routes -->|"dispatches requests"| node_conference_crud
node_conference_crud -->|"queries"| node_conference_models
node_conference_crud -->|"raises errors"| node_http_errors
node_certificate_routes -->|"calls controller"| node_certificate_controller
node_certificate_controller -->|"CRUD operations"| node_certificate_model
node_faculty_routes -->|"calls controller"| node_faculty_controller
node_faculty_controller -->|"queries"| node_faculty_model
node_app -->|"connects to"| node_mongo
node_upload_api -->|"saves imported rows"| node_conference_models
node_conference_models -.->|"persists records"| node_mongo
node_certificate_model -.->|"persists records"| node_mongo
node_faculty_model -.->|"persists records"| node_mongo

click node_app "https://github.com/xceed-nitj/xceed-backend/blob/main/src/index.js"
click node_conference_routes "https://github.com/xceed-nitj/xceed-backend/tree/main/src/confrenceModule/routes"
click node_conference_crud "https://github.com/xceed-nitj/xceed-backend/tree/main/src/confrenceModule/crud"
click node_conference_models "https://github.com/xceed-nitj/xceed-backend/tree/main/src/confrenceModule/models"
click node_http_errors "https://github.com/xceed-nitj/xceed-backend/blob/main/src/confrenceModule/models/http-exception.js"
click node_certificate_routes "https://github.com/xceed-nitj/xceed-backend/blob/main/src/certificateModule/routes/certificate.js"
click node_certificate_controller "https://github.com/xceed-nitj/xceed-backend/blob/main/src/certificateModule/controllers/certificate.js"
click node_certificate_model "https://github.com/xceed-nitj/xceed-backend/blob/main/src/certificateModule/models/certificate.js"
click node_faculty_routes "https://github.com/xceed-nitj/xceed-backend/blob/main/src/timetableModule/routes/faculty.js"
click node_faculty_controller "https://github.com/xceed-nitj/xceed-backend/blob/main/src/timetableModule/controllers/facultyprofile.js"
click node_faculty_model "https://github.com/xceed-nitj/xceed-backend/blob/main/src/timetableModule/models/faculty.js"
click node_upload_api "https://github.com/xceed-nitj/xceed-backend/blob/main/src/uploadModule/upload.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_app,node_client toneBlue
class node_conference_routes,node_conference_crud,node_http_errors toneAmber
class node_certificate_routes,node_certificate_controller,node_faculty_routes,node_faculty_controller,node_upload_api toneMint
class node_conference_models,node_certificate_model,node_faculty_model,node_mongo toneRose
```

## Components

### API runtime

- [Express application](https://github.com/xceed-nitj/xceed-backend/blob/main/src/index.js): `src/index.js`

### Conference management

- [Conference routes](https://github.com/xceed-nitj/xceed-backend/tree/main/src/confrenceModule/routes): `src/confrenceModule/routes`
- [Conference CRUD](https://github.com/xceed-nitj/xceed-backend/tree/main/src/confrenceModule/crud): `src/confrenceModule/crud`
- [HTTP exceptions](https://github.com/xceed-nitj/xceed-backend/blob/main/src/confrenceModule/models/http-exception.js): `src/confrenceModule/models/http-exception.js`

### Related services

- [Certificate routes](https://github.com/xceed-nitj/xceed-backend/blob/main/src/certificateModule/routes/certificate.js): `src/certificateModule/routes/certificate.js`
- [Certificate controller](https://github.com/xceed-nitj/xceed-backend/blob/main/src/certificateModule/controllers/certificate.js): `src/certificateModule/controllers/certificate.js`
- [Faculty routes](https://github.com/xceed-nitj/xceed-backend/blob/main/src/timetableModule/routes/faculty.js): `src/timetableModule/routes/faculty.js`
- [Faculty controller](https://github.com/xceed-nitj/xceed-backend/blob/main/src/timetableModule/controllers/facultyprofile.js): `src/timetableModule/controllers/facultyprofile.js`
- [Spreadsheet upload](https://github.com/xceed-nitj/xceed-backend/blob/main/src/uploadModule/upload.js): `src/uploadModule/upload.js`

### Persistence

- [Conference models](https://github.com/xceed-nitj/xceed-backend/tree/main/src/confrenceModule/models): `src/confrenceModule/models`
- [Certificate model](https://github.com/xceed-nitj/xceed-backend/blob/main/src/certificateModule/models/certificate.js): `src/certificateModule/models/certificate.js`
- [Faculty model](https://github.com/xceed-nitj/xceed-backend/blob/main/src/timetableModule/models/faculty.js): `src/timetableModule/models/faculty.js`
- **MongoDB**

### Other components

- **API client**

## Connections

- API client → Express application: sends request (evidence: `src/index.js`)
- Express application → Conference routes: mounts routes (evidence: `src/index.js`)
- Express application → Certificate routes: mounts routes (evidence: `src/index.js`)
- Express application → Faculty routes: mounts routes (evidence: `src/index.js`)
- Express application → Spreadsheet upload: mounts route (evidence: `src/index.js`)
- Conference routes → Conference CRUD: dispatches requests (evidence: `src/confrenceModule/routes/committee.js`)
- Conference CRUD → Conference models: queries (evidence: `src/confrenceModule/crud/committees.js`)
- Conference CRUD → HTTP exceptions: raises errors (evidence: `src/confrenceModule/crud/committees.js`)
- Certificate routes → Certificate controller: calls controller (evidence: `src/certificateModule/routes/certificate.js`)
- Certificate controller → Certificate model: CRUD operations (evidence: `src/certificateModule/controllers/certificate.js`)
- Faculty routes → Faculty controller: calls controller (evidence: `src/timetableModule/routes/faculty.js`)
- Faculty controller → Faculty model: queries (evidence: `src/timetableModule/controllers/facultyprofile.js`)
- Express application → MongoDB: connects to (evidence: `src/index.js`)
- Spreadsheet upload → Conference models: saves imported rows (evidence: `src/uploadModule/upload.js`)
- Conference models → MongoDB: persists records
- Certificate model → MongoDB: persists records
- Faculty model → MongoDB: persists records
