# morsilli-timeo-25002755/p301 architecture

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

- Interactive diagram: https://gitdiagram.com/morsilli-timeo-25002755/p301
- Repository: https://github.com/morsilli-timeo-25002755/p301

## Overview

This PHP application provides account access and a survey dashboard. The visible workflow routes browser requests to controllers; registration/login use user persistence, and authenticated dashboard requests load survey and answer statistics for rendering. The tree and dashboard show survey creation and management UI, but no corresponding write workflow was sampled. Password recovery and username checking are present as routed capabilities, though their controller implementations were not sampled. Relationships below are limited to route declarations, sampled calls, and SOURCE INDEX references.

Main entry points: [`public/index.php`](https://github.com/morsilli-timeo-25002755/p301/blob/main/public/index.php) (HTTP router), [`src/Controllers/DashboardController.php`](https://github.com/morsilli-timeo-25002755/p301/blob/main/src/Controllers/DashboardController.php) (Dashboard handler), [`src/Models/UserRepository.php`](https://github.com/morsilli-timeo-25002755/p301/blob/main/src/Models/UserRepository.php) (User queries), [`src/Controllers/RegisterController.php`](https://github.com/morsilli-timeo-25002755/p301/blob/main/src/Controllers/RegisterController.php) (Registration)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web entry and pages"]
  node_front["HTTP router<br/>[index.php]"]
  node_home["Homepage<br/>[Homepage.php]"]
  node_error["Error page<br/>[Error.php]"]
end

subgraph group_account["Account access"]
  node_login["Sign in"]
  node_loginview["Login form<br/>[Login.php]"]
  node_register["Registration"]
  node_registerview["Registration form<br/>[Register.php]"]
  node_recovery["Password recovery"]
  node_usernamecheck["Username check"]
  node_logout["Sign out"]
end

subgraph group_survey["Survey dashboard"]
  node_dashboard["Dashboard handler"]
  node_dashview["Dashboard page<br/>[Dashboard.php]"]
  node_forms["Survey queries<br/>[FormRepository.php]"]
  node_answers["Answer queries"]
end

subgraph group_data["Persistence and session"]
  node_users["User queries<br/>[UserRepository.php]"]
  node_userentity["User record<br/>[Users.php]"]
  node_sessions["Session guard"]
  node_dbcontroller["Database controller"]
  node_connection["MySQL connection"]
end

node_visitor(("Visitor"))
node_captcha{{"Google reCAPTCHA"}}
node_database[("Application database")]

node_visitor -->|"sends request"| node_front
node_front -->|"routes home"| node_home
node_front -->|"routes login"| node_login
node_front -->|"routes registration"| node_register
node_front -->|"routes recovery"| node_recovery
node_front -->|"routes dashboard"| node_dashboard
node_front -->|"routes logout"| node_logout
node_front -->|"routes check"| node_usernamecheck
node_front -->|"renders errors"| node_error
node_login -->|"checks credentials"| node_users
node_login -->|"renders form"| node_loginview
node_login -->|"renders failure"| node_error
node_register -->|"inserts account"| node_users
node_register -->|"renders form"| node_registerview
node_register -->|"verifies response"| node_captcha
node_register -->|"renders failure"| node_error
node_usernamecheck -->|"checks username"| node_users
node_dashboard -->|"requires session"| node_sessions
node_dashboard -->|"loads account"| node_users
node_dashboard -->|"loads surveys"| node_forms
node_dashboard -->|"loads answer count"| node_answers
node_dashboard -->|"renders dashboard"| node_dashview
node_dashboard -->|"renders failure"| node_error
node_sessions -->|"validates account"| node_users
node_dbcontroller -->|"creates connection"| node_connection
node_users -->|"queries through"| node_connection
node_users -->|"builds record"| node_userentity
node_forms -->|"queries through"| node_connection
node_answers -->|"queries through"| node_connection
node_connection -->|"connects"| node_database

click node_front "https://github.com/morsilli-timeo-25002755/p301/blob/main/public/index.php"
click node_home "https://github.com/morsilli-timeo-25002755/p301/blob/main/src/Views/Homepage.php"
click node_error "https://github.com/morsilli-timeo-25002755/p301/blob/main/src/Views/Error.php"
click node_login "https://github.com/morsilli-timeo-25002755/p301/blob/main/src/Controllers/LoginController.php"
click node_loginview "https://github.com/morsilli-timeo-25002755/p301/blob/main/src/Views/Login.php"
click node_register "https://github.com/morsilli-timeo-25002755/p301/blob/main/src/Controllers/RegisterController.php"
click node_registerview "https://github.com/morsilli-timeo-25002755/p301/blob/main/src/Views/Register.php"
click node_recovery "https://github.com/morsilli-timeo-25002755/p301/blob/main/src/Controllers/ForgotPasswordController.php"
click node_usernamecheck "https://github.com/morsilli-timeo-25002755/p301/blob/main/src/Controllers/CheckUsernameController.php"
click node_logout "https://github.com/morsilli-timeo-25002755/p301/blob/main/src/Controllers/LogoutController.php"
click node_dashboard "https://github.com/morsilli-timeo-25002755/p301/blob/main/src/Controllers/DashboardController.php"
click node_dashview "https://github.com/morsilli-timeo-25002755/p301/blob/main/src/Views/Dashboard.php"
click node_forms "https://github.com/morsilli-timeo-25002755/p301/blob/main/src/Models/FormRepository.php"
click node_answers "https://github.com/morsilli-timeo-25002755/p301/blob/main/src/Models/AnswerRepository.php"
click node_users "https://github.com/morsilli-timeo-25002755/p301/blob/main/src/Models/UserRepository.php"
click node_userentity "https://github.com/morsilli-timeo-25002755/p301/blob/main/src/Models/Users.php"
click node_sessions "https://github.com/morsilli-timeo-25002755/p301/blob/main/src/_assets/Includes/HandleSessionActive.php"
click node_dbcontroller "https://github.com/morsilli-timeo-25002755/p301/blob/main/src/Controllers/DatabaseController.php"
click node_connection "https://github.com/morsilli-timeo-25002755/p301/blob/main/src/_assets/Includes/DatabaseConnection.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_home,node_error toneBlue
class node_login,node_loginview,node_register,node_registerview,node_recovery,node_usernamecheck,node_logout,node_database toneAmber
class node_dashboard,node_dashview,node_forms,node_answers toneMint
class node_users,node_userentity,node_sessions,node_dbcontroller,node_connection toneRose
class node_visitor,node_captcha toneIndigo
```

## Components

### Web entry and pages

- [HTTP router](https://github.com/morsilli-timeo-25002755/p301/blob/main/public/index.php): `public/index.php`
- [Homepage](https://github.com/morsilli-timeo-25002755/p301/blob/main/src/Views/Homepage.php): `src/Views/Homepage.php`
- [Error page](https://github.com/morsilli-timeo-25002755/p301/blob/main/src/Views/Error.php): `src/Views/Error.php`

### Account access

- [Sign in](https://github.com/morsilli-timeo-25002755/p301/blob/main/src/Controllers/LoginController.php): `src/Controllers/LoginController.php`
- [Login form](https://github.com/morsilli-timeo-25002755/p301/blob/main/src/Views/Login.php): `src/Views/Login.php`
- [Registration](https://github.com/morsilli-timeo-25002755/p301/blob/main/src/Controllers/RegisterController.php): `src/Controllers/RegisterController.php`
- [Registration form](https://github.com/morsilli-timeo-25002755/p301/blob/main/src/Views/Register.php): `src/Views/Register.php`
- [Password recovery](https://github.com/morsilli-timeo-25002755/p301/blob/main/src/Controllers/ForgotPasswordController.php): `src/Controllers/ForgotPasswordController.php`
- [Username check](https://github.com/morsilli-timeo-25002755/p301/blob/main/src/Controllers/CheckUsernameController.php): `src/Controllers/CheckUsernameController.php`
- [Sign out](https://github.com/morsilli-timeo-25002755/p301/blob/main/src/Controllers/LogoutController.php): `src/Controllers/LogoutController.php`

### Survey dashboard

- [Dashboard handler](https://github.com/morsilli-timeo-25002755/p301/blob/main/src/Controllers/DashboardController.php): `src/Controllers/DashboardController.php`
- [Dashboard page](https://github.com/morsilli-timeo-25002755/p301/blob/main/src/Views/Dashboard.php): `src/Views/Dashboard.php`
- [Survey queries](https://github.com/morsilli-timeo-25002755/p301/blob/main/src/Models/FormRepository.php): `src/Models/FormRepository.php`
- [Answer queries](https://github.com/morsilli-timeo-25002755/p301/blob/main/src/Models/AnswerRepository.php): `src/Models/AnswerRepository.php`

### Persistence and session

- [User queries](https://github.com/morsilli-timeo-25002755/p301/blob/main/src/Models/UserRepository.php): `src/Models/UserRepository.php`
- [User record](https://github.com/morsilli-timeo-25002755/p301/blob/main/src/Models/Users.php): `src/Models/Users.php`
- [Session guard](https://github.com/morsilli-timeo-25002755/p301/blob/main/src/_assets/Includes/HandleSessionActive.php): `src/_assets/Includes/HandleSessionActive.php`
- [Database controller](https://github.com/morsilli-timeo-25002755/p301/blob/main/src/Controllers/DatabaseController.php): `src/Controllers/DatabaseController.php`
- [MySQL connection](https://github.com/morsilli-timeo-25002755/p301/blob/main/src/_assets/Includes/DatabaseConnection.php): `src/_assets/Includes/DatabaseConnection.php`

### Other components

- **Visitor**
- **Google reCAPTCHA**
- **Application database**

## Connections

- Visitor → HTTP router: sends request (evidence: `public/index.php`)
- HTTP router → Homepage: routes home (evidence: `public/index.php`)
- HTTP router → Sign in: routes login (evidence: `public/index.php`)
- HTTP router → Registration: routes registration (evidence: `public/index.php`)
- HTTP router → Password recovery: routes recovery (evidence: `public/index.php`)
- HTTP router → Dashboard handler: routes dashboard (evidence: `public/index.php`)
- HTTP router → Sign out: routes logout (evidence: `public/index.php`)
- HTTP router → Username check: routes check (evidence: `public/index.php`)
- HTTP router → Error page: renders errors (evidence: `public/index.php`)
- Sign in → User queries: checks credentials (evidence: `src/Controllers/LoginController.php`)
- Sign in → Login form: renders form (evidence: `src/Controllers/LoginController.php`)
- Sign in → Error page: renders failure (evidence: `src/Controllers/LoginController.php`)
- Registration → User queries: inserts account (evidence: `src/Controllers/RegisterController.php`)
- Registration → Registration form: renders form (evidence: `src/Controllers/RegisterController.php`)
- Registration → Google reCAPTCHA: verifies response (evidence: `src/Controllers/RegisterController.php`)
- Registration → Error page: renders failure (evidence: `src/Controllers/RegisterController.php`)
- Username check → User queries: checks username (evidence: `src/Controllers/CheckUsernameController.php`)
- Dashboard handler → Session guard: requires session (evidence: `src/Controllers/DashboardController.php`)
- Dashboard handler → User queries: loads account (evidence: `src/Controllers/DashboardController.php`)
- Dashboard handler → Survey queries: loads surveys (evidence: `src/Controllers/DashboardController.php`)
- Dashboard handler → Answer queries: loads answer count (evidence: `src/Controllers/DashboardController.php`)
- Dashboard handler → Dashboard page: renders dashboard (evidence: `src/Controllers/DashboardController.php`)
- Dashboard handler → Error page: renders failure (evidence: `src/Controllers/DashboardController.php`)
- Session guard → User queries: validates account (evidence: `src/_assets/Includes/HandleSessionActive.php`)
- Database controller → MySQL connection: creates connection (evidence: `src/Controllers/DatabaseController.php`)
- User queries → MySQL connection: queries through (evidence: `src/Models/UserRepository.php`)
- User queries → User record: builds record (evidence: `src/Models/UserRepository.php`)
- Survey queries → MySQL connection: queries through (evidence: `src/Models/FormRepository.php`)
- Answer queries → MySQL connection: queries through (evidence: `src/Models/AnswerRepository.php`)
- MySQL connection → Application database: connects (evidence: `src/_assets/Includes/DatabaseConnection.php`)
