Volāre Documentation
Comprehensive technical documentation for the Volāre travel platform - the byvolare.com Web storefront and the Arkana back office.
One Platform, Two Products
Section titled “One Platform, Two Products”- Web — byvolare.com, Volāre’s online travel agency: the customer-facing storefront where travellers browse destinations and buy their trips. Lives in
frontend/(Frontend Overview). - Arkana — arkana.byvolare.com, the brain of Volāre: the FilamentPHP back office where the team configures everything — products, offers, pricing, suppliers, bookings, and CMS content — and where the REST API that feeds the Web lives. Lives in
backend/(Backend Overview).
Quick Navigation
Section titled “Quick Navigation”Arkana (Backend)Laravel 13 backend with the FilamentPHP v5 Arkana admin panel, REST APIs, and service integrations for flight booking and travel products.
Web (Frontend)byvolare.com — Astro 6 with React 19 islands and Tailwind CSS v4 for optimal performance and SEO-friendly travel product pages.
ServicesAerTicket integration, flight search, async booking system, queue infrastructure, and market-specific product management.
ArchitectureSystem design, data models, integration patterns, and monorepo structure documentation.
Key Features
Section titled “Key Features”- Multi-Market Support - Path-based market routing with localized content and translations
- Flight Booking - AerTicket integration for search, booking, and ticketing
- Queue System - Async job processing with database queues
- Full-Text Search - PostgreSQL FTS for intelligent airport lookup
- Arkana Admin Panel - FilamentPHP v5 back office with RBAC
- Payments - Stripe (via Laravel Cashier 16) and Redsys
- AI Tooling - Laravel AI SDK (
laravel/ai) integration - Observability - Nightwatch (production), Sentry error tracking, Telescope (development)
Technology Stack
Section titled “Technology Stack”| Component | Technology | Version |
|---|---|---|
| Backend (Arkana) | Laravel | 13.x |
| Admin Panel (Arkana) | FilamentPHP | 5.x |
| Frontend (Web) | Astro | 6.x |
| UI Islands | React | 19.x |
| Styling | Tailwind CSS | 4.x |
| Database | PostgreSQL | 18 |
| Cache | Redis | alpine (unpinned) |
| Queue | Database (dev; dedicated queue + queue-flights workers) |
- |
| Testing | Pest | 4.x |
Recent Updates
Section titled “Recent Updates”- Multi-Market API - Path-based market routing with automatic translation fallback
- Roles & Permissions - PHP enums for type-safe RBAC with spatie/laravel-permission
- Offer Management - ProductByMarket + FlightBooking combinations
- Async Booking - Queue-based booking architecture with real-time notifications