# About Page & Brand Management System — Implementation Notes This document provides a comprehensive technical overview of the implementation of the dynamic, database-driven **About Kevron Suites and Apartments Page** at `/about`. --- ## 1. Architectural Design The brand information, sections, promises, values, and expansion plans are managed dynamically from the database. The system allows administrators to control content block parameters, visibility, and sorting, while ensuring high performance and SEO crawlability. --- ## 2. Database Schema & Migration ### Migration File: `2026_06_01_180000_create_about_page_tables.php` The migration defines 8 new database tables: 1. **`brand_profiles`**: Holds core brand data (story, mission, promises, positioning, primary location, active status). 2. **`about_sections`**: Manages section headers, subtitles, and CTAs (e.g. Hero, Brand Story, Philosophy, Expansion). 3. **`hospitality_promises`**: Stores our 5 key guest promises (Comfort, Convenience, Smart Living, Security, Service). 4. **`brand_values`**: Holds 7 brand values (Comfort, Trust, Service, Quality, Convenience, Smart Living, Growth). 5. **`quality_standards`**: Manages 7 quality standard commitments. 6. **`expansion_plans`**: Holds roadmap plans for future branches. 7. **`team_profiles`**: Setup for team members (disabled/hidden from navigation by default). 8. **`about_media`**: Links section keys to `media_assets` or custom file paths. --- ## 3. Dynamic Database Seeder ### Seeder File: `AboutDatabaseSeeder.php` Populates the database with realistic business facts: * **Brand Story & Positioning Statements**: Clear, transparent, and non-exaggerated narrative. * **Why Choose Kevron Cards**: 8 dynamic cards with routing pivots. * **Quality Standards**: Meticulous details on Cleanliness, Maintenance, and Security. * **About page FAQs**: 8 dynamic accordions under the dedicated category `About Kevron FAQs` (slug `about-faqs`). * **SEO & Breadcrumb List / LocalBusiness Schema**: Polymorphic metadata bound to the About Page. --- ## 4. Filament Admin Dashboard CRUD Resources Admin CRUD capabilities have been registered in `/admin` for all brand management nodes using the project's `Filament\Schemas\Schema` builder: 1. `BrandProfileResource.php` 2. `AboutSectionResource.php` 3. `HospitalityPromiseResource.php` 4. `BrandValueResource.php` 5. `QualityStandardResource.php` 6. `ExpansionPlanResource.php` 7. `TeamProfileResource.php` (Disabled from navigation sidebar: `$shouldRegisterNavigation = false`) 8. `AboutMediaResource.php` --- ## 5. Web Routing & public Controller ### Controller File: `AboutController.php` * **`index()`**: Fetches all dynamic entities from the database, resolves polymorphic SEO & LocalBusiness / AboutPage structured JSON-LD schemas, and outputs the view. Logs page views to application logs. * **`trackEvent()`**: A secure API endpoint (`POST /about/track`) to record customer interactions (smooth scrolls, WhatsApp clicks, FAQ expansion, etc.) for analytics. --- ## 6. Premium, Mobile-First, & Accessible Blade View ### View File: `resources/views/about.blade.php` * **Luxury Accents & Typography**: Styled using Marcellus headings, Inter body text, HSL tailored soft-blue backdrops, and Midnight Navy primary blocks. * **Font Capping Compliance**: Hard capped at H1 max `1.8rem`, H2-H6 under `1.625rem`, and body `0.875rem`. * **Kevron Design Tokens**: Flat `0.1rem` border radius cards with outline shadows (`rgba(0, 0, 0, 0.05) 0px 0px 0px 1px`) and `50px` pill-shaped bouncy micro-animated buttons. * **Responsive Layouts**: Designed mobile-first, using alternating section colors and lazy loading responsive images from `pictures`. * **AI Search & Geo-Targeting Index Paragraph**: High-density natural semantic entity block for search engines and LLM models. * **Interactive FAQs**: Fully accessible using `