PhilexScholar Introduction

What is PhilexScholar?

PhilexScholar is a Scholarship Management System (SMS) that bridges the gap between students seeking financial aid and administrators managing scholarship programs. It provides a seamless experience for:

• Students: To find relevant scholarships, apply easily, track their status, and manage requirements like community service.

• Administrators: To configure programs, review applications, verify documents, and process disbursements efficiently.

Core Philosophy

The system is built around a strict Application Lifecycle State Machine. This ensures that every application moves through a predictable and secure flow:

1. Draft/Application

2. Document Verification

3. Eligibility Check

4. Enrollment

5. Community Service

6. Disbursement

Technology Stack

This project leverages a modern, robust, and type-safe stack:

Backend

• Framework: Laravel 10/11 - The PHP framework for web artisans.

• Database: PostgreSQL or MySQL.

• Quality Assurance: PHPStan (Static Analysis), Pest (Testing), Rector (Refactoring).

Frontend

• Framework: React 19 - For building interactive user interfaces.

• Language: TypeScript - For type safety and better developer experience.

• Glue: Inertia.js - Allows building single-page apps using classic server-side routing concepts.

• Styling: Tailwind CSS - Utility-first CSS framework.

• Components: Shadcn UI & Radix UI.

Who is this documentation for?

• Developers: Who want to set up the project, contribute code, or understand the architecture.

• System Administrators: Who need to deploy and maintain the application.

• Users: Who want to understand the features and workflow of the system.

Next, explore the Features of the system.