# sugumaranj/nexus-core architecture

> Architecture diagram of the GitHub repository sugumaranj/nexus-core, 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/sugumaranj/nexus-core
- Repository: https://github.com/sugumaranj/nexus-core

## Overview

NexusCore is a PHP MVC platform for academic symposium administration. Its central user journey is managing symposiums and events, then supporting student registration, scheduling, attendance, evaluation/results, and certificates. The graph shows the documented product stages and the sampled routing and service boundaries; several feature implementations are represented at their exact controller or service paths because their source was not excerpted. Arrows are limited to visible route registrations, source-index references, or README-documented capabilities.

Main entry points: [`public/index.php`](https://github.com/sugumaranj/nexus-core/blob/main/public/index.php) (HTTP front controller), [`app/Controllers/SymposiumController.php`](https://github.com/sugumaranj/nexus-core/blob/main/app/Controllers/SymposiumController.php) (Symposium management), [`app/Controllers/AttendanceController.php`](https://github.com/sugumaranj/nexus-core/blob/main/app/Controllers/AttendanceController.php) (Attendance tracking), [`app/Controllers/StudentRegistrationController.php`](https://github.com/sugumaranj/nexus-core/blob/main/app/Controllers/StudentRegistrationController.php) (Student registration)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Web entry"]
  node_front["HTTP front controller<br/>[index.php]"]
  node_router["Route dispatch<br/>[Router.php]"]
  node_views["Page rendering<br/>[View.php]"]
end

subgraph group_planning["Symposium planning"]
  node_symposium["Symposium management"]
  node_eventadmin["Event administration"]
  node_schedule["Event scheduling"]
  node_allocation["Staff and judge allocation"]
end

subgraph group_participation["Student participation"]
  node_studentportal["Student portal"]
  node_registration["Student registration"]
  node_teams["Team management"]
  node_chatbot["Chatbot queries"]
end

subgraph group_operations["Event operations"]
  node_attendance["Attendance tracking"]
  node_evaluation["Evaluation and ranking"]
  node_results["Result viewing"]
  node_certificates["Certificate generation"]
  node_verification["Certificate verification"]
end

subgraph group_platform["Shared platform"]
  node_service["Business services"]
  node_models["Domain models"]
  node_db[("MySQL database<br/>[Database.php]")]
  node_session["Session state<br/>[Session.php]"]
end

node_admin(("Administrators and staff"))
node_students(("Students"))

node_admin -.->|"uses platform"| node_front
node_students -.->|"uses portal"| node_front
node_front -.->|"dispatches routes"| node_router
node_front -->|"routes to"| node_symposium
node_front -->|"routes to"| node_schedule
node_front -->|"routes to"| node_registration
node_front -->|"routes to"| node_attendance
node_symposium -->|"calls"| node_service
node_allocation -->|"calls"| node_service
node_attendance -->|"calls"| node_service
node_symposium -->|"renders"| node_views
node_studentportal -.->|"supports registration"| node_registration
node_registration -.->|"resolves teams"| node_teams
node_attendance -->|"reads and writes"| node_models
node_evaluation -.->|"provides rankings"| node_results
node_certificates -.->|"supports verification"| node_verification
node_chatbot -->|"queries"| node_models
node_models -->|"uses connection"| node_db
node_front -->|"starts session"| node_session

click node_front "https://github.com/sugumaranj/nexus-core/blob/main/public/index.php"
click node_router "https://github.com/sugumaranj/nexus-core/blob/main/app/Core/Router.php"
click node_symposium "https://github.com/sugumaranj/nexus-core/blob/main/app/Controllers/SymposiumController.php"
click node_eventadmin "https://github.com/sugumaranj/nexus-core/blob/main/app/Controllers/SymposiumEventController.php"
click node_schedule "https://github.com/sugumaranj/nexus-core/blob/main/app/Controllers/SchedulingController.php"
click node_allocation "https://github.com/sugumaranj/nexus-core/blob/main/app/Controllers/ResourceAllocationController.php"
click node_studentportal "https://github.com/sugumaranj/nexus-core/blob/main/app/Controllers/StudentPortalController.php"
click node_registration "https://github.com/sugumaranj/nexus-core/blob/main/app/Controllers/StudentRegistrationController.php"
click node_teams "https://github.com/sugumaranj/nexus-core/blob/main/app/Services/TeamResolverService.php"
click node_attendance "https://github.com/sugumaranj/nexus-core/blob/main/app/Controllers/AttendanceController.php"
click node_evaluation "https://github.com/sugumaranj/nexus-core/blob/main/app/Services/Evaluation/EvaluationEngine.php"
click node_results "https://github.com/sugumaranj/nexus-core/blob/main/app/Controllers/ResultViewerController.php"
click node_certificates "https://github.com/sugumaranj/nexus-core/blob/main/app/Controllers/CertificateController.php"
click node_verification "https://github.com/sugumaranj/nexus-core/blob/main/app/Services/CertificateVerificationService.php"
click node_chatbot "https://github.com/sugumaranj/nexus-core/blob/main/app/Services/Chatbot/ChatbotQueryService.php"
click node_views "https://github.com/sugumaranj/nexus-core/blob/main/app/Core/View.php"
click node_service "https://github.com/sugumaranj/nexus-core/tree/main/app/Services"
click node_models "https://github.com/sugumaranj/nexus-core/tree/main/app/Models"
click node_db "https://github.com/sugumaranj/nexus-core/blob/main/app/Database/Database.php"
click node_session "https://github.com/sugumaranj/nexus-core/blob/main/app/Core/Session.php"

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_front,node_router,node_views toneBlue
class node_symposium,node_eventadmin,node_schedule,node_allocation toneAmber
class node_studentportal,node_registration,node_teams,node_chatbot toneMint
class node_attendance,node_evaluation,node_results,node_certificates,node_verification toneRose
class node_service,node_models,node_db,node_session,node_admin,node_students toneIndigo
```

## Components

### Web entry

- [HTTP front controller](https://github.com/sugumaranj/nexus-core/blob/main/public/index.php): `public/index.php`
- [Route dispatch](https://github.com/sugumaranj/nexus-core/blob/main/app/Core/Router.php): `app/Core/Router.php`
- [Page rendering](https://github.com/sugumaranj/nexus-core/blob/main/app/Core/View.php): `app/Core/View.php`

### Symposium planning

- [Symposium management](https://github.com/sugumaranj/nexus-core/blob/main/app/Controllers/SymposiumController.php): `app/Controllers/SymposiumController.php`
- [Event administration](https://github.com/sugumaranj/nexus-core/blob/main/app/Controllers/SymposiumEventController.php): `app/Controllers/SymposiumEventController.php`
- [Event scheduling](https://github.com/sugumaranj/nexus-core/blob/main/app/Controllers/SchedulingController.php): `app/Controllers/SchedulingController.php`
- [Staff and judge allocation](https://github.com/sugumaranj/nexus-core/blob/main/app/Controllers/ResourceAllocationController.php): `app/Controllers/ResourceAllocationController.php`

### Student participation

- [Student portal](https://github.com/sugumaranj/nexus-core/blob/main/app/Controllers/StudentPortalController.php): `app/Controllers/StudentPortalController.php`
- [Student registration](https://github.com/sugumaranj/nexus-core/blob/main/app/Controllers/StudentRegistrationController.php): `app/Controllers/StudentRegistrationController.php`
- [Team management](https://github.com/sugumaranj/nexus-core/blob/main/app/Services/TeamResolverService.php): `app/Services/TeamResolverService.php`
- [Chatbot queries](https://github.com/sugumaranj/nexus-core/blob/main/app/Services/Chatbot/ChatbotQueryService.php): `app/Services/Chatbot/ChatbotQueryService.php`

### Event operations

- [Attendance tracking](https://github.com/sugumaranj/nexus-core/blob/main/app/Controllers/AttendanceController.php): `app/Controllers/AttendanceController.php`
- [Evaluation and ranking](https://github.com/sugumaranj/nexus-core/blob/main/app/Services/Evaluation/EvaluationEngine.php): `app/Services/Evaluation/EvaluationEngine.php`
- [Result viewing](https://github.com/sugumaranj/nexus-core/blob/main/app/Controllers/ResultViewerController.php): `app/Controllers/ResultViewerController.php`
- [Certificate generation](https://github.com/sugumaranj/nexus-core/blob/main/app/Controllers/CertificateController.php): `app/Controllers/CertificateController.php`
- [Certificate verification](https://github.com/sugumaranj/nexus-core/blob/main/app/Services/CertificateVerificationService.php): `app/Services/CertificateVerificationService.php`

### Shared platform

- [Business services](https://github.com/sugumaranj/nexus-core/tree/main/app/Services): `app/Services`
- [Domain models](https://github.com/sugumaranj/nexus-core/tree/main/app/Models): `app/Models`
- [MySQL database](https://github.com/sugumaranj/nexus-core/blob/main/app/Database/Database.php): `app/Database/Database.php`
- [Session state](https://github.com/sugumaranj/nexus-core/blob/main/app/Core/Session.php): `app/Core/Session.php`

### Other components

- **Administrators and staff**
- **Students**

## Connections

- Administrators and staff → HTTP front controller: uses platform
- Students → HTTP front controller: uses portal
- HTTP front controller → Route dispatch: dispatches routes (evidence: `public/index.php`)
- HTTP front controller → Symposium management: routes to (evidence: `public/index.php`)
- HTTP front controller → Event scheduling: routes to (evidence: `public/index.php`)
- HTTP front controller → Student registration: routes to (evidence: `public/index.php`)
- HTTP front controller → Attendance tracking: routes to (evidence: `public/index.php`)
- Symposium management → Business services: calls (evidence: `app/Controllers/SymposiumController.php`)
- Staff and judge allocation → Business services: calls (evidence: `app/Controllers/ResourceAllocationController.php`)
- Attendance tracking → Business services: calls (evidence: `app/Controllers/AttendanceController.php`)
- Symposium management → Page rendering: renders (evidence: `app/Controllers/SymposiumController.php`)
- Student portal → Student registration: supports registration
- Student registration → Team management: resolves teams
- Attendance tracking → Domain models: reads and writes (evidence: `app/Controllers/AttendanceController.php`)
- Evaluation and ranking → Result viewing: provides rankings
- Certificate generation → Certificate verification: supports verification
- Chatbot queries → Domain models: queries (evidence: `app/Services/Chatbot/ChatbotQueryService.php`)
- Domain models → MySQL database: uses connection (evidence: `app/Models/UserModel.php`)
- HTTP front controller → Session state: starts session
