BarangaySystem/ai-docs/modules/pages.md

Pages Module

Purpose

Handles page rendering and server-side Vue component delivery. Provides unified approach for both SPA (client-side) and traditional server-rendered pages.

Key Files

• app/Http/Controllers/viewHelperController.php - Main page controller
• resources/js/Pages/Fragments/Home/*.vue - Home page fragments
• app/Http/Controllers/PageMemoryController.php

Public APIs

• servePageFragment() - Render page without template
• servePageFragmentWithTemplate() - Render page with layout template
• getDefaultDataVariables() - Get default view variables
• getAllViews() - Get all available views

Dependencies

• App\Enums\UserTypes - Role enum
• App\Http\Controllers\Pages\Core\ApplicationController

Important Behavior

• Routes pages via /p/{page}/s/ pattern
• Uses viewMap config for page-to-view mapping
• Supports public and authenticated routes
• Returns base64-encoded HTML for SPA navigation