# tanmay-singh12/nextgen-metallurgy architecture

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

- Interactive diagram: https://gitdiagram.com/tanmay-singh12/nextgen-metallurgy
- Repository: https://github.com/tanmay-singh12/nextgen-metallurgy

## Overview

This repository implements a symposium website and registration backend. Visitors browse event information, register, receive a conference ticket, and can submit an abstract with supporting files; the registration modal also checks an existing participant’s status. The frontend composes the public page and sends registration and abstract requests through an API client. The backend routes requests to controllers, which validate input and delegate persistence and ticket generation to services. The README is empty; backend route mounting and some frontend composition are supported by source-index references, while unsampled route wiring is not expanded.

Main entry points: [`frontend/src/pages/Home.jsx`](https://github.com/tanmay-singh12/nextgen-metallurgy/blob/main/frontend/src/pages/Home.jsx) (Home composition), [`backend/src/controllers/registration.controller.js`](https://github.com/tanmay-singh12/nextgen-metallurgy/blob/main/backend/src/controllers/registration.controller.js) (Registration handlers), [`frontend/src/components/Gallery/Gallery.jsx`](https://github.com/tanmay-singh12/nextgen-metallurgy/blob/main/frontend/src/components/Gallery/Gallery.jsx) (Gallery content), [`backend/src/services/registration.service.js`](https://github.com/tanmay-singh12/nextgen-metallurgy/blob/main/backend/src/services/registration.service.js) (Registration service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Public symposium site"]
  node_app["Page entry<br/>[App.jsx]"]
  node_home["Home composition<br/>[Home.jsx]"]
  node_event_content["Event sections<br/>[Events.jsx]"]
  node_hero["Hero section<br/>[Hero.jsx]"]
  node_gallery["Gallery content<br/>[Gallery.jsx]"]
  node_gallery_data["Gallery data<br/>[gallery.js]"]
  node_section_head["Section headings<br/>[SectionHead.jsx]"]
  node_registration_modal["Registration form"]
  node_abstract_modal["Abstract form"]
  node_api_client["API client<br/>[api.js]"]
end

subgraph group_backend["API request handling"]
  node_api_app["API application<br/>[app.js]"]
  node_route_index["API route mount<br/>[index.js]"]
  node_registration_routes["Registration routes"]
  node_abstract_routes["Abstract routes<br/>[abstract.routes.js]"]
  node_upload_middleware["Upload validation"]
end

subgraph group_domain["Registration and abstracts"]
  node_registration_controller["Registration handlers"]
  node_registration_validator["Registration validation"]
  node_registration_service["Registration service"]
  node_registration_model[("Registration records<br/>[Registration.js]")]
  node_abstract_controller["Abstract handlers"]
  node_abstract_validator["Abstract validation"]
  node_abstract_service["Abstract service"]
  node_abstract_model[("Abstract records")]
end

subgraph group_ticket["Ticket generation"]
  node_ticket_service["Ticket service<br/>[ticket.service.js]"]
  node_qr_utility["QR utility<br/>[qr.util.js]"]
end

node_visitor(("Visitor"))

node_visitor -->|"opens"| node_app
node_app -->|"renders"| node_home
node_home -->|"renders"| node_hero
node_home -->|"renders"| node_event_content
node_home -->|"renders"| node_gallery
node_home -->|"renders"| node_registration_modal
node_home -->|"renders"| node_abstract_modal
node_gallery -->|"reads"| node_gallery_data
node_event_content -->|"renders"| node_section_head
node_gallery -->|"renders"| node_section_head
node_registration_modal -->|"requests"| node_api_client
node_abstract_modal -->|"submits"| node_api_client
node_api_client -.->|"sends HTTP"| node_api_app
node_api_app -->|"mounts"| node_route_index
node_registration_routes -->|"routes"| node_registration_controller
node_abstract_routes -->|"routes"| node_abstract_controller
node_abstract_routes -->|"validates uploads"| node_upload_middleware
node_registration_controller -->|"validates"| node_registration_validator
node_registration_controller -->|"delegates"| node_registration_service
node_registration_controller -->|"generates ticket"| node_ticket_service
node_abstract_controller -->|"validates"| node_abstract_validator
node_abstract_controller -->|"delegates"| node_abstract_service
node_registration_service -->|"reads and writes"| node_registration_model
node_registration_service -->|"reads"| node_abstract_model
node_abstract_service -->|"checks registration"| node_registration_model
node_abstract_service -->|"reads and writes"| node_abstract_model
node_ticket_service -->|"uses"| node_qr_utility

click node_app "https://github.com/tanmay-singh12/nextgen-metallurgy/blob/main/frontend/src/App.jsx"
click node_home "https://github.com/tanmay-singh12/nextgen-metallurgy/blob/main/frontend/src/pages/Home.jsx"
click node_event_content "https://github.com/tanmay-singh12/nextgen-metallurgy/blob/main/frontend/src/components/Events/Events.jsx"
click node_hero "https://github.com/tanmay-singh12/nextgen-metallurgy/blob/main/frontend/src/components/Hero/Hero.jsx"
click node_gallery "https://github.com/tanmay-singh12/nextgen-metallurgy/blob/main/frontend/src/components/Gallery/Gallery.jsx"
click node_gallery_data "https://github.com/tanmay-singh12/nextgen-metallurgy/blob/main/frontend/src/data/gallery.js"
click node_section_head "https://github.com/tanmay-singh12/nextgen-metallurgy/blob/main/frontend/src/components/SectionHead.jsx"
click node_registration_modal "https://github.com/tanmay-singh12/nextgen-metallurgy/blob/main/frontend/src/components/RegistrationModal/RegistrationModal.jsx"
click node_abstract_modal "https://github.com/tanmay-singh12/nextgen-metallurgy/blob/main/frontend/src/components/abstract/AbstractSubmissionModal.jsx"
click node_api_client "https://github.com/tanmay-singh12/nextgen-metallurgy/blob/main/frontend/src/services/api.js"
click node_api_app "https://github.com/tanmay-singh12/nextgen-metallurgy/blob/main/backend/src/app.js"
click node_route_index "https://github.com/tanmay-singh12/nextgen-metallurgy/blob/main/backend/src/routes/index.js"
click node_registration_routes "https://github.com/tanmay-singh12/nextgen-metallurgy/blob/main/backend/src/routes/registration.routes.js"
click node_abstract_routes "https://github.com/tanmay-singh12/nextgen-metallurgy/blob/main/backend/src/routes/abstract.routes.js"
click node_upload_middleware "https://github.com/tanmay-singh12/nextgen-metallurgy/blob/main/backend/src/middleware/upload.middleware.js"
click node_registration_controller "https://github.com/tanmay-singh12/nextgen-metallurgy/blob/main/backend/src/controllers/registration.controller.js"
click node_registration_validator "https://github.com/tanmay-singh12/nextgen-metallurgy/blob/main/backend/src/validators/registration.validator.js"
click node_registration_service "https://github.com/tanmay-singh12/nextgen-metallurgy/blob/main/backend/src/services/registration.service.js"
click node_registration_model "https://github.com/tanmay-singh12/nextgen-metallurgy/blob/main/backend/src/models/Registration.js"
click node_abstract_controller "https://github.com/tanmay-singh12/nextgen-metallurgy/blob/main/backend/src/controllers/abstract.controller.js"
click node_abstract_validator "https://github.com/tanmay-singh12/nextgen-metallurgy/blob/main/backend/src/validators/abstract.validator.js"
click node_abstract_service "https://github.com/tanmay-singh12/nextgen-metallurgy/blob/main/backend/src/services/abstract.service.js"
click node_abstract_model "https://github.com/tanmay-singh12/nextgen-metallurgy/blob/main/backend/src/models/AbstractSubmission.js"
click node_ticket_service "https://github.com/tanmay-singh12/nextgen-metallurgy/blob/main/backend/src/services/ticket.service.js"
click node_qr_utility "https://github.com/tanmay-singh12/nextgen-metallurgy/blob/main/backend/src/utils/qr.util.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_home,node_event_content,node_hero,node_gallery,node_gallery_data,node_section_head,node_registration_modal,node_abstract_modal,node_api_client toneBlue
class node_api_app,node_route_index,node_registration_routes,node_abstract_routes,node_upload_middleware toneAmber
class node_registration_controller,node_registration_validator,node_registration_service,node_registration_model,node_abstract_controller,node_abstract_validator,node_abstract_service,node_abstract_model toneMint
class node_ticket_service,node_qr_utility toneRose
class node_visitor toneIndigo
```

## Components

### Public symposium site

- [Page entry](https://github.com/tanmay-singh12/nextgen-metallurgy/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Home composition](https://github.com/tanmay-singh12/nextgen-metallurgy/blob/main/frontend/src/pages/Home.jsx): `frontend/src/pages/Home.jsx`
- [Event sections](https://github.com/tanmay-singh12/nextgen-metallurgy/blob/main/frontend/src/components/Events/Events.jsx): `frontend/src/components/Events/Events.jsx`
- [Hero section](https://github.com/tanmay-singh12/nextgen-metallurgy/blob/main/frontend/src/components/Hero/Hero.jsx): `frontend/src/components/Hero/Hero.jsx`
- [Gallery content](https://github.com/tanmay-singh12/nextgen-metallurgy/blob/main/frontend/src/components/Gallery/Gallery.jsx): `frontend/src/components/Gallery/Gallery.jsx`
- [Gallery data](https://github.com/tanmay-singh12/nextgen-metallurgy/blob/main/frontend/src/data/gallery.js): `frontend/src/data/gallery.js`
- [Section headings](https://github.com/tanmay-singh12/nextgen-metallurgy/blob/main/frontend/src/components/SectionHead.jsx): `frontend/src/components/SectionHead.jsx`
- [Registration form](https://github.com/tanmay-singh12/nextgen-metallurgy/blob/main/frontend/src/components/RegistrationModal/RegistrationModal.jsx): `frontend/src/components/RegistrationModal/RegistrationModal.jsx`
- [Abstract form](https://github.com/tanmay-singh12/nextgen-metallurgy/blob/main/frontend/src/components/abstract/AbstractSubmissionModal.jsx): `frontend/src/components/abstract/AbstractSubmissionModal.jsx`
- [API client](https://github.com/tanmay-singh12/nextgen-metallurgy/blob/main/frontend/src/services/api.js): `frontend/src/services/api.js`

### API request handling

- [API application](https://github.com/tanmay-singh12/nextgen-metallurgy/blob/main/backend/src/app.js): `backend/src/app.js`
- [API route mount](https://github.com/tanmay-singh12/nextgen-metallurgy/blob/main/backend/src/routes/index.js): `backend/src/routes/index.js`
- [Registration routes](https://github.com/tanmay-singh12/nextgen-metallurgy/blob/main/backend/src/routes/registration.routes.js): `backend/src/routes/registration.routes.js`
- [Abstract routes](https://github.com/tanmay-singh12/nextgen-metallurgy/blob/main/backend/src/routes/abstract.routes.js): `backend/src/routes/abstract.routes.js`
- [Upload validation](https://github.com/tanmay-singh12/nextgen-metallurgy/blob/main/backend/src/middleware/upload.middleware.js): `backend/src/middleware/upload.middleware.js`

### Registration and abstracts

- [Registration handlers](https://github.com/tanmay-singh12/nextgen-metallurgy/blob/main/backend/src/controllers/registration.controller.js): `backend/src/controllers/registration.controller.js`
- [Registration validation](https://github.com/tanmay-singh12/nextgen-metallurgy/blob/main/backend/src/validators/registration.validator.js): `backend/src/validators/registration.validator.js`
- [Registration service](https://github.com/tanmay-singh12/nextgen-metallurgy/blob/main/backend/src/services/registration.service.js): `backend/src/services/registration.service.js`
- [Registration records](https://github.com/tanmay-singh12/nextgen-metallurgy/blob/main/backend/src/models/Registration.js): `backend/src/models/Registration.js`
- [Abstract handlers](https://github.com/tanmay-singh12/nextgen-metallurgy/blob/main/backend/src/controllers/abstract.controller.js): `backend/src/controllers/abstract.controller.js`
- [Abstract validation](https://github.com/tanmay-singh12/nextgen-metallurgy/blob/main/backend/src/validators/abstract.validator.js): `backend/src/validators/abstract.validator.js`
- [Abstract service](https://github.com/tanmay-singh12/nextgen-metallurgy/blob/main/backend/src/services/abstract.service.js): `backend/src/services/abstract.service.js`
- [Abstract records](https://github.com/tanmay-singh12/nextgen-metallurgy/blob/main/backend/src/models/AbstractSubmission.js): `backend/src/models/AbstractSubmission.js`

### Ticket generation

- [Ticket service](https://github.com/tanmay-singh12/nextgen-metallurgy/blob/main/backend/src/services/ticket.service.js): `backend/src/services/ticket.service.js`
- [QR utility](https://github.com/tanmay-singh12/nextgen-metallurgy/blob/main/backend/src/utils/qr.util.js): `backend/src/utils/qr.util.js`

### Other components

- **Visitor**

## Connections

- Visitor → Page entry: opens (evidence: `frontend/src/App.jsx`)
- Page entry → Home composition: renders (evidence: `frontend/src/App.jsx`)
- Home composition → Hero section: renders (evidence: `frontend/src/pages/Home.jsx`)
- Home composition → Event sections: renders (evidence: `frontend/src/pages/Home.jsx`)
- Home composition → Gallery content: renders (evidence: `frontend/src/pages/Home.jsx`)
- Home composition → Registration form: renders (evidence: `frontend/src/pages/Home.jsx`)
- Home composition → Abstract form: renders (evidence: `frontend/src/pages/Home.jsx`)
- Gallery content → Gallery data: reads (evidence: `frontend/src/components/Gallery/Gallery.jsx`)
- Event sections → Section headings: renders (evidence: `frontend/src/components/Events/Events.jsx`)
- Gallery content → Section headings: renders (evidence: `frontend/src/components/Gallery/Gallery.jsx`)
- Registration form → API client: requests (evidence: `frontend/src/components/RegistrationModal/RegistrationModal.jsx`)
- Abstract form → API client: submits (evidence: `frontend/src/components/abstract/AbstractSubmissionModal.jsx`)
- API client → API application: sends HTTP (evidence: `frontend/src/services/api.js`)
- API application → API route mount: mounts (evidence: `backend/src/app.js`)
- Registration routes → Registration handlers: routes (evidence: `backend/src/routes/registration.routes.js`)
- Abstract routes → Abstract handlers: routes (evidence: `backend/src/routes/abstract.routes.js`)
- Abstract routes → Upload validation: validates uploads (evidence: `backend/src/routes/abstract.routes.js`)
- Registration handlers → Registration validation: validates (evidence: `backend/src/controllers/registration.controller.js`)
- Registration handlers → Registration service: delegates (evidence: `backend/src/controllers/registration.controller.js`)
- Registration handlers → Ticket service: generates ticket (evidence: `backend/src/controllers/registration.controller.js`)
- Abstract handlers → Abstract validation: validates (evidence: `backend/src/controllers/abstract.controller.js`)
- Abstract handlers → Abstract service: delegates (evidence: `backend/src/controllers/abstract.controller.js`)
- Registration service → Registration records: reads and writes (evidence: `backend/src/services/registration.service.js`)
- Registration service → Abstract records: reads (evidence: `backend/src/services/registration.service.js`)
- Abstract service → Registration records: checks registration (evidence: `backend/src/services/abstract.service.js`)
- Abstract service → Abstract records: reads and writes (evidence: `backend/src/services/abstract.service.js`)
- Ticket service → QR utility: uses (evidence: `backend/src/services/ticket.service.js`)
