# titarek/diu-nest architecture

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

- Interactive diagram: https://gitdiagram.com/titarek/diu-nest
- Repository: https://github.com/titarek/diu-nest

## Overview

DIU-NEST is a React hall-information and seat-application portal for DIU students. The visible user journey is to browse hall and process information, inspect available hall details, then move to login or registration; the landing page also provides sample application tracking. The repository includes mock application, payment, request, cycle, audit, and hall state plus seat-map UI, but the sampled app does not wire those into its public page tree. The graph reflects those separate capabilities without assuming persistence or a backend; unsampled feature connections are omitted.

Main entry points: [`src/App.jsx`](https://github.com/titarek/diu-nest/blob/main/src/App.jsx) (Public app router), [`src/pages/public/LandingPage.jsx`](https://github.com/titarek/diu-nest/blob/main/src/pages/public/LandingPage.jsx) (Landing and tracking), [`src/context/ApplicationContext.jsx`](https://github.com/titarek/diu-nest/blob/main/src/context/ApplicationContext.jsx) (Application state/actions), [`src/components/common/Badge.jsx`](https://github.com/titarek/diu-nest/blob/main/src/components/common/Badge.jsx) (Status badge)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_public["Public portal"]
  node_app["Public app router<br/>[App.jsx]"]
  node_landing["Landing and tracking<br/>[LandingPage.jsx]"]
  node_hallinfo["Hall directory<br/>[HallInfoPage.jsx]"]
  node_about["About page<br/>[AboutPage.jsx]"]
  node_howitworks["Process guide<br/>[HowItWorksPage.jsx]"]
  node_faq["FAQ<br/>[FaqPage.jsx]"]
  node_contact["Contact page<br/>[ContactPage.jsx]"]
  node_login["Login<br/>[LoginPage.jsx]"]
  node_register["Registration<br/>[RegisterPage.jsx]"]
end

subgraph group_application["Application state"]
  node_applicationcontext["Application state/actions"]
  node_applications["Applications and status"]
  node_cycles["Application cycles<br/>[mockCycles.js]"]
  node_payments["Payment records<br/>[mockPayments.js]"]
  node_requests["Requests and notices<br/>[mockRequests.js]"]
  node_audit["Audit log data<br/>[mockAuditLogs.js]"]
  node_auth["Authentication context<br/>[AuthContext.jsx]"]
  node_users["Mock users<br/>[mockUsers.js]"]
end

subgraph group_hallops["Hall operations"]
  node_halls["Hall inventory data<br/>[mockHalls.js]"]
  node_seatmap["Visual seat map<br/>[VisualSeatMap.jsx]"]
end

subgraph group_shared["Shared UI and feedback"]
  node_toast["Toast feedback<br/>[ToastContext.jsx]"]
  node_badge["Status badge<br/>[Badge.jsx]"]
  node_button["Button<br/>[Button.jsx]"]
  node_card["Card<br/>[Card.jsx]"]
  node_modal["Modal<br/>[Modal.jsx]"]
end

node_student(("Student / visitor"))

node_student -->|"visits"| node_app
node_app -->|"routes to"| node_landing
node_app -->|"routes to"| node_hallinfo
node_app -->|"routes to"| node_about
node_app -->|"routes to"| node_howitworks
node_app -->|"routes to"| node_faq
node_app -->|"routes to"| node_contact
node_app -->|"routes to"| node_login
node_app -->|"routes to"| node_register
node_app -->|"provides"| node_toast
node_landing -->|"reads"| node_halls
node_landing -->|"reads sample tracking"| node_applications
node_hallinfo -->|"reads"| node_halls
node_applicationcontext -->|"loads"| node_halls
node_applicationcontext -->|"loads"| node_applications
node_applicationcontext -->|"loads"| node_cycles
node_applicationcontext -->|"loads"| node_payments
node_applicationcontext -->|"loads"| node_requests
node_applicationcontext -->|"loads"| node_audit
node_auth -->|"loads"| node_users
node_seatmap -->|"uses actions"| node_applicationcontext
node_seatmap -->|"uses feedback"| node_toast
node_seatmap -->|"renders"| node_badge
node_seatmap -->|"renders"| node_button
node_seatmap -->|"renders"| node_modal
node_about -->|"renders"| node_card
node_about -->|"renders"| node_badge
node_about -->|"renders"| node_button
node_howitworks -->|"renders"| node_card
node_howitworks -->|"renders"| node_badge
node_howitworks -->|"renders"| node_button
node_hallinfo -->|"renders"| node_badge
node_hallinfo -->|"renders"| node_button
node_hallinfo -->|"renders"| node_modal
node_contact -->|"uses feedback"| node_toast
node_contact -->|"renders"| node_card
node_contact -->|"renders"| node_button
node_contact -->|"renders"| node_badge
node_faq -->|"renders"| node_badge
node_login -->|"uses feedback"| node_toast
node_login -->|"renders"| node_button
node_login -->|"renders"| node_badge
node_register -->|"uses feedback"| node_toast
node_register -->|"renders"| node_button
node_landing -->|"renders"| node_button
node_landing -->|"renders"| node_badge
node_landing -->|"renders"| node_card
node_landing -->|"renders"| node_modal

click node_app "https://github.com/titarek/diu-nest/blob/main/src/App.jsx"
click node_landing "https://github.com/titarek/diu-nest/blob/main/src/pages/public/LandingPage.jsx"
click node_hallinfo "https://github.com/titarek/diu-nest/blob/main/src/pages/public/HallInfoPage.jsx"
click node_about "https://github.com/titarek/diu-nest/blob/main/src/pages/public/AboutPage.jsx"
click node_howitworks "https://github.com/titarek/diu-nest/blob/main/src/pages/public/HowItWorksPage.jsx"
click node_faq "https://github.com/titarek/diu-nest/blob/main/src/pages/public/FaqPage.jsx"
click node_contact "https://github.com/titarek/diu-nest/blob/main/src/pages/public/ContactPage.jsx"
click node_login "https://github.com/titarek/diu-nest/blob/main/src/pages/public/LoginPage.jsx"
click node_register "https://github.com/titarek/diu-nest/blob/main/src/pages/public/RegisterPage.jsx"
click node_halls "https://github.com/titarek/diu-nest/blob/main/src/data/mockHalls.js"
click node_seatmap "https://github.com/titarek/diu-nest/blob/main/src/components/specific/VisualSeatMap.jsx"
click node_applicationcontext "https://github.com/titarek/diu-nest/blob/main/src/context/ApplicationContext.jsx"
click node_applications "https://github.com/titarek/diu-nest/blob/main/src/data/mockApplications.js"
click node_cycles "https://github.com/titarek/diu-nest/blob/main/src/data/mockCycles.js"
click node_payments "https://github.com/titarek/diu-nest/blob/main/src/data/mockPayments.js"
click node_requests "https://github.com/titarek/diu-nest/blob/main/src/data/mockRequests.js"
click node_audit "https://github.com/titarek/diu-nest/blob/main/src/data/mockAuditLogs.js"
click node_auth "https://github.com/titarek/diu-nest/blob/main/src/context/AuthContext.jsx"
click node_users "https://github.com/titarek/diu-nest/blob/main/src/data/mockUsers.js"
click node_toast "https://github.com/titarek/diu-nest/blob/main/src/context/ToastContext.jsx"
click node_badge "https://github.com/titarek/diu-nest/blob/main/src/components/common/Badge.jsx"
click node_button "https://github.com/titarek/diu-nest/blob/main/src/components/common/Button.jsx"
click node_card "https://github.com/titarek/diu-nest/blob/main/src/components/common/Card.jsx"
click node_modal "https://github.com/titarek/diu-nest/blob/main/src/components/common/Modal.jsx"

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_landing,node_hallinfo,node_about,node_howitworks,node_faq,node_contact,node_login,node_register toneBlue
class node_applicationcontext,node_applications,node_cycles,node_payments,node_requests,node_audit,node_auth,node_users toneAmber
class node_halls,node_seatmap toneMint
class node_toast,node_badge,node_button,node_card,node_modal toneRose
class node_student toneIndigo
```

## Components

### Public portal

- [Public app router](https://github.com/titarek/diu-nest/blob/main/src/App.jsx): `src/App.jsx`
- [Landing and tracking](https://github.com/titarek/diu-nest/blob/main/src/pages/public/LandingPage.jsx): `src/pages/public/LandingPage.jsx`
- [Hall directory](https://github.com/titarek/diu-nest/blob/main/src/pages/public/HallInfoPage.jsx): `src/pages/public/HallInfoPage.jsx`
- [About page](https://github.com/titarek/diu-nest/blob/main/src/pages/public/AboutPage.jsx): `src/pages/public/AboutPage.jsx`
- [Process guide](https://github.com/titarek/diu-nest/blob/main/src/pages/public/HowItWorksPage.jsx): `src/pages/public/HowItWorksPage.jsx`
- [FAQ](https://github.com/titarek/diu-nest/blob/main/src/pages/public/FaqPage.jsx): `src/pages/public/FaqPage.jsx`
- [Contact page](https://github.com/titarek/diu-nest/blob/main/src/pages/public/ContactPage.jsx): `src/pages/public/ContactPage.jsx`
- [Login](https://github.com/titarek/diu-nest/blob/main/src/pages/public/LoginPage.jsx): `src/pages/public/LoginPage.jsx`
- [Registration](https://github.com/titarek/diu-nest/blob/main/src/pages/public/RegisterPage.jsx): `src/pages/public/RegisterPage.jsx`

### Application state

- [Application state/actions](https://github.com/titarek/diu-nest/blob/main/src/context/ApplicationContext.jsx): `src/context/ApplicationContext.jsx`
- [Applications and status](https://github.com/titarek/diu-nest/blob/main/src/data/mockApplications.js): `src/data/mockApplications.js`
- [Application cycles](https://github.com/titarek/diu-nest/blob/main/src/data/mockCycles.js): `src/data/mockCycles.js`
- [Payment records](https://github.com/titarek/diu-nest/blob/main/src/data/mockPayments.js): `src/data/mockPayments.js`
- [Requests and notices](https://github.com/titarek/diu-nest/blob/main/src/data/mockRequests.js): `src/data/mockRequests.js`
- [Audit log data](https://github.com/titarek/diu-nest/blob/main/src/data/mockAuditLogs.js): `src/data/mockAuditLogs.js`
- [Authentication context](https://github.com/titarek/diu-nest/blob/main/src/context/AuthContext.jsx): `src/context/AuthContext.jsx`
- [Mock users](https://github.com/titarek/diu-nest/blob/main/src/data/mockUsers.js): `src/data/mockUsers.js`

### Hall operations

- [Hall inventory data](https://github.com/titarek/diu-nest/blob/main/src/data/mockHalls.js): `src/data/mockHalls.js`
- [Visual seat map](https://github.com/titarek/diu-nest/blob/main/src/components/specific/VisualSeatMap.jsx): `src/components/specific/VisualSeatMap.jsx`

### Shared UI and feedback

- [Toast feedback](https://github.com/titarek/diu-nest/blob/main/src/context/ToastContext.jsx): `src/context/ToastContext.jsx`
- [Status badge](https://github.com/titarek/diu-nest/blob/main/src/components/common/Badge.jsx): `src/components/common/Badge.jsx`
- [Button](https://github.com/titarek/diu-nest/blob/main/src/components/common/Button.jsx): `src/components/common/Button.jsx`
- [Card](https://github.com/titarek/diu-nest/blob/main/src/components/common/Card.jsx): `src/components/common/Card.jsx`
- [Modal](https://github.com/titarek/diu-nest/blob/main/src/components/common/Modal.jsx): `src/components/common/Modal.jsx`

### Other components

- **Student / visitor**

## Connections

- Student / visitor → Public app router: visits (evidence: `src/App.jsx`)
- Public app router → Landing and tracking: routes to (evidence: `src/App.jsx`)
- Public app router → Hall directory: routes to (evidence: `src/App.jsx`)
- Public app router → About page: routes to (evidence: `src/App.jsx`)
- Public app router → Process guide: routes to (evidence: `src/App.jsx`)
- Public app router → FAQ: routes to (evidence: `src/App.jsx`)
- Public app router → Contact page: routes to (evidence: `src/App.jsx`)
- Public app router → Login: routes to (evidence: `src/App.jsx`)
- Public app router → Registration: routes to (evidence: `src/App.jsx`)
- Public app router → Toast feedback: provides (evidence: `src/App.jsx`)
- Landing and tracking → Hall inventory data: reads (evidence: `src/pages/public/LandingPage.jsx`)
- Landing and tracking → Applications and status: reads sample tracking (evidence: `src/pages/public/LandingPage.jsx`)
- Hall directory → Hall inventory data: reads (evidence: `src/pages/public/HallInfoPage.jsx`)
- Application state/actions → Hall inventory data: loads (evidence: `src/context/ApplicationContext.jsx`)
- Application state/actions → Applications and status: loads (evidence: `src/context/ApplicationContext.jsx`)
- Application state/actions → Application cycles: loads (evidence: `src/context/ApplicationContext.jsx`)
- Application state/actions → Payment records: loads (evidence: `src/context/ApplicationContext.jsx`)
- Application state/actions → Requests and notices: loads (evidence: `src/context/ApplicationContext.jsx`)
- Application state/actions → Audit log data: loads (evidence: `src/context/ApplicationContext.jsx`)
- Authentication context → Mock users: loads (evidence: `src/context/AuthContext.jsx`)
- Visual seat map → Application state/actions: uses actions (evidence: `src/components/specific/VisualSeatMap.jsx`)
- Visual seat map → Toast feedback: uses feedback (evidence: `src/components/specific/VisualSeatMap.jsx`)
- Visual seat map → Status badge: renders (evidence: `src/components/specific/VisualSeatMap.jsx`)
- Visual seat map → Button: renders (evidence: `src/components/specific/VisualSeatMap.jsx`)
- Visual seat map → Modal: renders (evidence: `src/components/specific/VisualSeatMap.jsx`)
- About page → Card: renders (evidence: `src/pages/public/AboutPage.jsx`)
- About page → Status badge: renders (evidence: `src/pages/public/AboutPage.jsx`)
- About page → Button: renders (evidence: `src/pages/public/AboutPage.jsx`)
- Process guide → Card: renders (evidence: `src/pages/public/HowItWorksPage.jsx`)
- Process guide → Status badge: renders (evidence: `src/pages/public/HowItWorksPage.jsx`)
- Process guide → Button: renders (evidence: `src/pages/public/HowItWorksPage.jsx`)
- Hall directory → Status badge: renders (evidence: `src/pages/public/HallInfoPage.jsx`)
- Hall directory → Button: renders (evidence: `src/pages/public/HallInfoPage.jsx`)
- Hall directory → Modal: renders (evidence: `src/pages/public/HallInfoPage.jsx`)
- Contact page → Toast feedback: uses feedback (evidence: `src/pages/public/ContactPage.jsx`)
- Contact page → Card: renders (evidence: `src/pages/public/ContactPage.jsx`)
- Contact page → Button: renders (evidence: `src/pages/public/ContactPage.jsx`)
- Contact page → Status badge: renders (evidence: `src/pages/public/ContactPage.jsx`)
- FAQ → Status badge: renders (evidence: `src/pages/public/FaqPage.jsx`)
- Login → Toast feedback: uses feedback (evidence: `src/pages/public/LoginPage.jsx`)
- Login → Button: renders (evidence: `src/pages/public/LoginPage.jsx`)
- Login → Status badge: renders (evidence: `src/pages/public/LoginPage.jsx`)
- Registration → Toast feedback: uses feedback (evidence: `src/pages/public/RegisterPage.jsx`)
- Registration → Button: renders (evidence: `src/pages/public/RegisterPage.jsx`)
- Landing and tracking → Button: renders (evidence: `src/pages/public/LandingPage.jsx`)
- Landing and tracking → Status badge: renders (evidence: `src/pages/public/LandingPage.jsx`)
- Landing and tracking → Card: renders (evidence: `src/pages/public/LandingPage.jsx`)
- Landing and tracking → Modal: renders (evidence: `src/pages/public/LandingPage.jsx`)
