AI-Powered Student Scholarship Finder, Eligibility Engine, & Application Management Portal
- Official Repository Link: https://github.com/Prince-Rim/eScholar
- Team: [FakeBitz]
- Project Name:
eScholar
eScholar is a unified digital platform built to revolutionize how Filipino students discover, apply for, and maintain academic grants and scholarships. By integrating cutting-edge GovTech services—such as NIDAS eVerify Face Liveness eKYC and eGov PH eMessage SMS 2FA—together with an AI Document Extractor (OCR & NLP engine), eScholar streamlines application workflows for students, grant providers, and government administrators.
┌─────────────────────────────────────────────────────────────────────────────┐
│ eScholar │
├──────────────────────┬─────────────────────────────┬────────────────────────┤
│ 🎓 Student Portal │ 🏢 Provider Portal │ 🛡️ Admin Portal │
├──────────────────────┼─────────────────────────────┼────────────────────────┤
│ • AI TOR/COR Parser │ • Program Creation Wizard │ • Provider Governance │
│ • Smart Matching │ • Applicant Pipeline Review │ • User Account Mgmt │
│ • 1-Click Apply │ • Active Scholar Tracking │ • Audit Trail & Logs │
│ • Compliance Tracker │ • Disbursement Analytics │ • System Analytics │
├──────────────────────┴─────────────────────────────┴────────────────────────┤
│ GovTech & AI Layer │
│ • NIDAS Face Liveness eKYC • eGov SMS 2FA • AI OCR Extractor Engine │
└─────────────────────────────────────────────────────────────────────────────┘
- Intelligent Scholarship Discovery: Search and filter government (DOST, CHED), presidential, foundation, and corporate scholarship programs by STEM/Non-STEM tracks, GWA cutoffs, and household income limits.
- AI Document Extractor (TOR / COR): Students can upload their Transcript of Records or Grade Sheets. The AI engine automatically parses Student Name, Student ID, School, Academic Term, General Weighted Average (GWA), Cumulative GWA, and detects failure/DRP marks for automated compliance scoring.
- Streamlined Application Workflow: Auto-populates application forms using extracted credentials and biometric identity details.
- My Applications & Compliance Hub: Real-time tracking of application statuses (
Submitted,Under Review,Approved,Disbursed) and recurring compliance submission deadlines (semestral grade sheets, Certificate of Registration, community service records). - Saved Bookmarks: Save and compare scholarship opportunities.
- Program Creation Wizard: Multi-step wizard allowing scholarship providers to configure funding amounts, living allowances, eligible courses/schools, GWA thresholds, household income requirements, and required documentary proofs.
- Applicant Pipeline Management: Filter, review, approve, or reject student submissions with inline document verification previews.
- Active Scholar & Renewal Monitoring: Track active grantees per academic term, monitor disbursements, and verify ongoing academic standing.
- Provider Dashboard & Analytics: High-level metrics on funding allocation, applicant demographics, and compliance rates.
- Provider Onboarding & Verification: Review legal credentials, SEC/DTI registrations, and verify provider organizations.
- User & Role Governance: Audit student and provider accounts, manage account states (Active, Suspended, Disabled), and trigger security actions.
- Comprehensive Audit Trail: Immutable system logs capturing authentication events, identity verifications, status modifications, and grant disbursements.
- Platform Metrics: Aggregate reports on registered users, active programs, and total financial aid facilitated.
| Category | Technology | Version | Purpose |
|---|---|---|---|
| Frontend Framework | React | ^19.2.7 |
UI component library with concurrent rendering |
| DOM Renderer | React DOM | ^19.2.7 |
Web rendering layer for React |
| Build Tool / Bundler | Vite | ^8.1.1 |
Next-generation frontend tooling with lightning-fast HMR |
| Compiler Plugin | @vitejs/plugin-react | ^6.0.3 |
Babel/Oxc fast refresh React integration for Vite |
| Icons | Lucide React | ^1.25.0 |
Crisp, modern SVG icons across all portals |
| Linter | Oxlint | ^1.71.0 |
High-performance JavaScript/JSX linter |
| Deployment / Routing | Vercel | Standard | Single-Page Application (SPA) rewrite and hosting configuration |
- eGov Face Liveness:
- eGov SMS API:
- eGov Document Extractor AI API:
Follow these steps to clone, configure, and run eScholar locally.
- Node.js: Version
18.x,20.x, or higher installed. (Download Node.js) - npm: Version
9.xor10.x(comes bundled with Node.js) - Git: Installed and configured on your machine. (Download Git)
git clone https://github.com/Prince-Rim/eScholar.git
cd eScholarYou can install all dependencies from the root directory (which automatically delegates to Front-End):
npm installAlternatively, you can install directly within the Front-End directory:
cd Front-End
npm install
cd ..Copy the provided .env.example to .env (or Front-End/.env):
cp .env.example Front-End/.envStart the Vite local development server:
npm run devOr directly inside Front-End/:
cd Front-End
npm run devOnce started, open your browser and navigate to:
http://localhost:5173/
To generate optimized production bundles:
npm run buildThe compiled static assets will be output to Front-End/dist/.
To test the production build locally:
npm run previewRun Oxlint to check code quality across the codebase:
npm run lintFor rapid testing and evaluation, pre-configured test accounts are available on the login page:
| Role | Email / Username | Password | Default View |
|---|---|---|---|
| 🎓 Student | student@example.com |
student123 |
Student Dashboard (/dashboard) |
| 🏢 Provider | provider@example.com (or provider123) |
provider123 (or admin123) |
Provider Programs (/my-programs) |
| 🛡️ Admin | admin@example.com (or admin123) |
admin123 |
Admin Dashboard (/admin) |
/or/landing— Landing Page with public scholarship catalog/login— Login screen with SMS OTP verification/register— Student Registration with NIDAS Face Liveness eKYC/provider— Direct shortcut to Provider Portal/admin— Direct shortcut to Admin Portal