# renzcy31/ursb-scholarship architecture

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

- Interactive diagram: https://gitdiagram.com/renzcy31/ursb-scholarship
- Repository: https://github.com/renzcy31/ursb-scholarship

## Overview

This is a PHP scholarship-management application for student applicants and administrators. Applicants register and verify accounts, submit scholarship applications and supporting documents, then follow status and profile information; administrators manage applications, academic and financial records, notifications, and system settings. Shared PHP helpers and MySQL support the application, while PHPMailer handles email and FPDF supports document export. The README is empty, so capability coverage comes from the tree and source index; unsampled pages are represented only at subsystem level, and their internal relationships are not inferred.

Main entry points: [`config/db.php`](https://github.com/renzcy31/ursb-scholarship/blob/main/config/db.php) (MySQL database), [`includes/schema_helpers.php`](https://github.com/renzcy31/ursb-scholarship/blob/main/includes/schema_helpers.php) (Schema and workflow helpers), [`user/documents.php`](https://github.com/renzcy31/ursb-scholarship/blob/main/user/documents.php) (Application submission), [`pages/settings.php`](https://github.com/renzcy31/ursb-scholarship/blob/main/pages/settings.php) (Administration settings)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_accounts["Accounts and applicants"]
  node_login["Account access<br/>[login.php]"]
  node_registration["Account registration<br/>[register.php]"]
  node_email_verify["Email verification<br/>[verify-email.php]"]
  node_applicant_home["Applicant dashboard<br/>[dashboard.php]"]
  node_application["Application submission<br/>[documents.php]"]
  node_applicant_records["Student records<br/>[studentrecord.php]"]
  node_applicant_verification["Student verification<br/>[verification.php]"]
  node_application_status["Application status<br/>[status.php]"]
end

subgraph group_admin["Administration"]
  node_admin_applications["Application review"]
  node_admin_records["Academic records"]
  node_financial_aid["Financial assistance"]
  node_notifications["Notifications<br/>[notifications.php]"]
  node_admin_settings["Administration settings<br/>[settings.php]"]
  node_reference_data["Registration options<br/>[crud_courses.php]"]
end

subgraph group_shared["Shared services"]
  node_database[("MySQL database<br/>[db.php]")]
  node_schema_helpers["Schema and workflow helpers<br/>[schema_helpers.php]"]
  node_user_navigation["Applicant navigation<br/>[sidebar.php]"]
  node_admin_navigation["Admin navigation<br/>[sidebar2.php]"]
end

subgraph group_integrations["Exports and messaging"]
  node_verification_service["Verification mail service"]
  node_phpmailer["PHPMailer transport<br/>[PHPMailer.php]"]
  node_pdf_exports["PDF exports<br/>[fpdf.php]"]
  node_export_pages["PDF export pages<br/>[export_pdf.php]"]
end

node_student(("Student applicant"))
node_administrator(("Administrator"))

node_student -->|"registers"| node_registration
node_student -->|"signs in"| node_login
node_registration -->|"stores account"| node_database
node_registration -->|"uses helpers"| node_schema_helpers
node_login -->|"checks account"| node_database
node_login -->|"uses helpers"| node_schema_helpers
node_login -->|"routes verification"| node_email_verify
node_email_verify -->|"checks token"| node_database
node_email_verify -->|"uses helpers"| node_schema_helpers
node_student -->|"views dashboard"| node_applicant_home
node_applicant_home -->|"reads profile"| node_database
node_applicant_home -->|"uses helpers"| node_schema_helpers
node_applicant_home -->|"renders navigation"| node_user_navigation
node_student -->|"submits application"| node_application
node_application -->|"reads and writes"| node_database
node_application -->|"uses helpers"| node_schema_helpers
node_application -->|"renders navigation"| node_user_navigation
node_application -->|"creates alert"| node_notifications
node_student -->|"views records"| node_applicant_records
node_student -->|"submits verification"| node_applicant_verification
node_applicant_verification -->|"reads and writes"| node_database
node_applicant_verification -->|"uses helpers"| node_schema_helpers
node_applicant_verification -->|"renders navigation"| node_user_navigation
node_student -->|"checks status"| node_application_status
node_administrator -->|"reviews applications"| node_admin_applications
node_admin_applications -->|"reads and writes"| node_database
node_admin_applications -->|"uses helpers"| node_schema_helpers
node_admin_applications -->|"renders navigation"| node_admin_navigation
node_administrator -->|"manages records"| node_admin_records
node_admin_records -->|"reads and writes"| node_database
node_admin_records -->|"renders navigation"| node_admin_navigation
node_administrator -->|"manages assistance"| node_financial_aid
node_financial_aid -->|"reads and writes"| node_database
node_financial_aid -->|"renders navigation"| node_admin_navigation
node_administrator -->|"manages alerts"| node_notifications
node_notifications -->|"reads and writes"| node_database
node_notifications -->|"renders navigation"| node_admin_navigation
node_administrator -->|"configures system"| node_admin_settings
node_admin_settings -->|"reads and writes"| node_database
node_admin_settings -->|"uses helpers"| node_schema_helpers
node_admin_settings -->|"renders navigation"| node_admin_navigation
node_admin_settings -->|"requests course changes"| node_reference_data
node_email_verify -->|"sends verification"| node_verification_service
node_verification_service -->|"constructs mail"| node_phpmailer
node_administrator -.->|"exports reports"| node_export_pages
node_export_pages -.->|"uses PDF library"| node_pdf_exports

click node_login "https://github.com/renzcy31/ursb-scholarship/blob/main/auth/login.php"
click node_registration "https://github.com/renzcy31/ursb-scholarship/blob/main/auth/register.php"
click node_email_verify "https://github.com/renzcy31/ursb-scholarship/blob/main/auth/verify-email.php"
click node_applicant_home "https://github.com/renzcy31/ursb-scholarship/blob/main/user/dashboard.php"
click node_application "https://github.com/renzcy31/ursb-scholarship/blob/main/user/documents.php"
click node_applicant_records "https://github.com/renzcy31/ursb-scholarship/blob/main/user/studentrecord.php"
click node_applicant_verification "https://github.com/renzcy31/ursb-scholarship/blob/main/user/verification.php"
click node_application_status "https://github.com/renzcy31/ursb-scholarship/blob/main/user/status.php"
click node_admin_applications "https://github.com/renzcy31/ursb-scholarship/blob/main/pages/recent_application.php"
click node_admin_records "https://github.com/renzcy31/ursb-scholarship/blob/main/pages/academic_records.php"
click node_financial_aid "https://github.com/renzcy31/ursb-scholarship/blob/main/pages/financial_assistance.php"
click node_notifications "https://github.com/renzcy31/ursb-scholarship/blob/main/pages/notifications.php"
click node_admin_settings "https://github.com/renzcy31/ursb-scholarship/blob/main/pages/settings.php"
click node_reference_data "https://github.com/renzcy31/ursb-scholarship/blob/main/api/crud_courses.php"
click node_database "https://github.com/renzcy31/ursb-scholarship/blob/main/config/db.php"
click node_schema_helpers "https://github.com/renzcy31/ursb-scholarship/blob/main/includes/schema_helpers.php"
click node_user_navigation "https://github.com/renzcy31/ursb-scholarship/blob/main/includes/sidebar.php"
click node_admin_navigation "https://github.com/renzcy31/ursb-scholarship/blob/main/includes/sidebar2.php"
click node_verification_service "https://github.com/renzcy31/ursb-scholarship/blob/main/mailer/send_verification.php"
click node_phpmailer "https://github.com/renzcy31/ursb-scholarship/blob/main/mailer/PHPMailer/src/PHPMailer.php"
click node_pdf_exports "https://github.com/renzcy31/ursb-scholarship/blob/main/libs/fpdf/fpdf.php"
click node_export_pages "https://github.com/renzcy31/ursb-scholarship/blob/main/pages/export_pdf.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_login,node_registration,node_email_verify,node_applicant_home,node_application,node_applicant_records,node_applicant_verification,node_application_status toneBlue
class node_admin_applications,node_admin_records,node_financial_aid,node_notifications,node_admin_settings,node_reference_data toneAmber
class node_database,node_schema_helpers,node_user_navigation,node_admin_navigation toneMint
class node_verification_service,node_phpmailer,node_pdf_exports,node_export_pages toneRose
class node_student,node_administrator toneIndigo
```

## Components

### Accounts and applicants

- [Account access](https://github.com/renzcy31/ursb-scholarship/blob/main/auth/login.php): `auth/login.php`
- [Account registration](https://github.com/renzcy31/ursb-scholarship/blob/main/auth/register.php): `auth/register.php`
- [Email verification](https://github.com/renzcy31/ursb-scholarship/blob/main/auth/verify-email.php): `auth/verify-email.php`
- [Applicant dashboard](https://github.com/renzcy31/ursb-scholarship/blob/main/user/dashboard.php): `user/dashboard.php`
- [Application submission](https://github.com/renzcy31/ursb-scholarship/blob/main/user/documents.php): `user/documents.php`
- [Student records](https://github.com/renzcy31/ursb-scholarship/blob/main/user/studentrecord.php): `user/studentrecord.php`
- [Student verification](https://github.com/renzcy31/ursb-scholarship/blob/main/user/verification.php): `user/verification.php`
- [Application status](https://github.com/renzcy31/ursb-scholarship/blob/main/user/status.php): `user/status.php`

### Administration

- [Application review](https://github.com/renzcy31/ursb-scholarship/blob/main/pages/recent_application.php): `pages/recent_application.php`
- [Academic records](https://github.com/renzcy31/ursb-scholarship/blob/main/pages/academic_records.php): `pages/academic_records.php`
- [Financial assistance](https://github.com/renzcy31/ursb-scholarship/blob/main/pages/financial_assistance.php): `pages/financial_assistance.php`
- [Notifications](https://github.com/renzcy31/ursb-scholarship/blob/main/pages/notifications.php): `pages/notifications.php`
- [Administration settings](https://github.com/renzcy31/ursb-scholarship/blob/main/pages/settings.php): `pages/settings.php`
- [Registration options](https://github.com/renzcy31/ursb-scholarship/blob/main/api/crud_courses.php): `api/crud_courses.php`

### Shared services

- [MySQL database](https://github.com/renzcy31/ursb-scholarship/blob/main/config/db.php): `config/db.php`
- [Schema and workflow helpers](https://github.com/renzcy31/ursb-scholarship/blob/main/includes/schema_helpers.php): `includes/schema_helpers.php`
- [Applicant navigation](https://github.com/renzcy31/ursb-scholarship/blob/main/includes/sidebar.php): `includes/sidebar.php`
- [Admin navigation](https://github.com/renzcy31/ursb-scholarship/blob/main/includes/sidebar2.php): `includes/sidebar2.php`

### Exports and messaging

- [Verification mail service](https://github.com/renzcy31/ursb-scholarship/blob/main/mailer/send_verification.php): `mailer/send_verification.php`
- [PHPMailer transport](https://github.com/renzcy31/ursb-scholarship/blob/main/mailer/PHPMailer/src/PHPMailer.php): `mailer/PHPMailer/src/PHPMailer.php`
- [PDF exports](https://github.com/renzcy31/ursb-scholarship/blob/main/libs/fpdf/fpdf.php): `libs/fpdf/fpdf.php`
- [PDF export pages](https://github.com/renzcy31/ursb-scholarship/blob/main/pages/export_pdf.php): `pages/export_pdf.php`

### Other components

- **Student applicant**
- **Administrator**

## Connections

- Student applicant → Account registration: registers (evidence: `auth/register.php`)
- Student applicant → Account access: signs in (evidence: `auth/login.php`)
- Account registration → MySQL database: stores account (evidence: `auth/register.php`)
- Account registration → Schema and workflow helpers: uses helpers (evidence: `auth/register.php`)
- Account access → MySQL database: checks account (evidence: `auth/login.php`)
- Account access → Schema and workflow helpers: uses helpers (evidence: `auth/login.php`)
- Account access → Email verification: routes verification (evidence: `auth/login.php`)
- Email verification → MySQL database: checks token (evidence: `auth/verify-email.php`)
- Email verification → Schema and workflow helpers: uses helpers (evidence: `auth/verify-email.php`)
- Student applicant → Applicant dashboard: views dashboard
- Applicant dashboard → MySQL database: reads profile (evidence: `user/dashboard.php`)
- Applicant dashboard → Schema and workflow helpers: uses helpers (evidence: `user/dashboard.php`)
- Applicant dashboard → Applicant navigation: renders navigation (evidence: `user/dashboard.php`)
- Student applicant → Application submission: submits application (evidence: `user/documents.php`)
- Application submission → MySQL database: reads and writes (evidence: `user/documents.php`)
- Application submission → Schema and workflow helpers: uses helpers (evidence: `user/documents.php`)
- Application submission → Applicant navigation: renders navigation (evidence: `user/documents.php`)
- Application submission → Notifications: creates alert (evidence: `user/documents.php`)
- Student applicant → Student records: views records
- Student applicant → Student verification: submits verification (evidence: `user/verification.php`)
- Student verification → MySQL database: reads and writes (evidence: `user/verification.php`)
- Student verification → Schema and workflow helpers: uses helpers (evidence: `user/verification.php`)
- Student verification → Applicant navigation: renders navigation (evidence: `user/verification.php`)
- Student applicant → Application status: checks status
- Administrator → Application review: reviews applications
- Application review → MySQL database: reads and writes (evidence: `pages/recent_application.php`)
- Application review → Schema and workflow helpers: uses helpers (evidence: `pages/recent_application.php`)
- Application review → Admin navigation: renders navigation (evidence: `pages/recent_application.php`)
- Administrator → Academic records: manages records
- Academic records → MySQL database: reads and writes (evidence: `pages/academic_records.php`)
- Academic records → Admin navigation: renders navigation (evidence: `pages/academic_records.php`)
- Administrator → Financial assistance: manages assistance
- Financial assistance → MySQL database: reads and writes (evidence: `pages/financial_assistance.php`)
- Financial assistance → Admin navigation: renders navigation (evidence: `pages/financial_assistance.php`)
- Administrator → Notifications: manages alerts
- Notifications → MySQL database: reads and writes (evidence: `pages/notifications.php`)
- Notifications → Admin navigation: renders navigation (evidence: `pages/notifications.php`)
- Administrator → Administration settings: configures system
- Administration settings → MySQL database: reads and writes (evidence: `pages/settings.php`)
- Administration settings → Schema and workflow helpers: uses helpers (evidence: `pages/settings.php`)
- Administration settings → Admin navigation: renders navigation (evidence: `pages/settings.php`)
- Administration settings → Registration options: requests course changes (evidence: `pages/settings.php`)
- Email verification → Verification mail service: sends verification
- Verification mail service → PHPMailer transport: constructs mail (evidence: `mailer/send_verification.php`)
- Administrator → PDF export pages: exports reports
- PDF export pages → PDF exports: uses PDF library
