Products Admin Panel
Products are managed through Filament resources. The primary workflow starts from Tours (under “Suppliers”), which creates both the tour and its underlying ProductTemplate in a single wizard. Publishing to markets is done from the Tour edit page.
Tour-Centric Workflow
Section titled “Tour-Centric Workflow”The simplified workflow is:
- Create a Tour (Suppliers > Tours) — defines itinerary, content, hotels, activities, transfers, and travel windows in one wizard
- Publish to Market — from the Tour edit page, creates a ProductByMarket with AI translation
- Review Market Product — fine-tune flight configs, translations, and SEO in Products by Market
ProductTemplate is created and managed automatically through the Tour form. The standalone Product Templates resource is hidden from navigation but remains accessible via direct URL for debugging.
Source: backend/app/Filament/Resources/ProductTemplates/ProductTemplateResource.php (shouldRegisterNavigation() returns false)
Tour View Page
Section titled “Tour View Page”Path: Admin > Suppliers > Tours > View
The Tour view page provides a comprehensive overview of the tour state.
TourCompletionWidget
Section titled “TourCompletionWidget”A header widget showing 6-step completion progress with auto-derived TourStatus (Draft/Complete):
| Step | Checks |
|---|---|
| Tour Details | Supplier, source locale, and title filled |
| Itinerary | At least arrival + one stop with locations, nights, and per-day content (title, details) |
| Visual & Media | Hero image + at least 3 gallery images |
| Travel Windows | At least one rate period with start/end dates |
| Services Assignments | All itinerary stops have a Selection-tier hotel assigned |
| Supplier Details | Meals and transport descriptions filled; guide languages if guide enabled |
Status is Complete when all 6 steps pass; Draft otherwise. Status is derived automatically on every save — there is no manual status toggle.
Source: backend/app/Filament/Resources/Suppliers/SupplierTours/Widgets/TourCompletionWidget.php, backend/app/Services/SupplierTourService.php
Published Markets Section
Section titled “Published Markets Section”Below the form, a “Published Markets” section lists all ProductByMarket records linked to this tour’s template. Each entry shows market name, locale, SKU, and status as a clickable badge linking to the market product view page.
Source: backend/app/Filament/Resources/Suppliers/SupplierTours/Pages/ViewSupplierTour.php
Service Assignment Tables
Section titled “Service Assignment Tables”Three footer widgets display the current hotel, activity, and transfer assignments from the tour itinerary in read-only tables:
- Hotels — grouped by stop, showing Selection/Luxury/Grand Luxury hotels per period
- Activities — per-day assignments across Included/Extra/Substitution tiers
- Transfers — per-day assignments across Selection/Luxury/Grand Luxury tiers
Source: backend/app/Filament/Resources/ProductTemplates/Widgets/SupplierTourHotelsWidget.php, SupplierTourActivitiesWidget.php, SupplierTourTransfersWidget.php
Publish to Market Action
Section titled “Publish to Market Action”Available on the Tour Edit page header. Creates a ProductByMarket from the tour’s template.
Modal form:
- Select a market (active markets only)
- Select a language from the market’s supported locales
On submit:
- Creates ProductByMarket record (status: draft) with auto-generated SKU
- Generates flight configs from the market’s default airports using
FlightRouteConfigGenerator - AI-translates content if target locale differs from source locale (falls back to empty translation on failure)
- Redirects to the new ProductByMarket edit page
Duplicate check: if a ProductByMarket already exists for the same template + market + locale, a warning is shown and no record is created.
Source: backend/app/Filament/Resources/Suppliers/SupplierTours/Actions/PublishToMarketAction.php
Products by Market Resource
Section titled “Products by Market Resource”Path: Admin > Products > Products by Market
Source: backend/app/Filament/Resources/ProductsByMarket/ProductByMarketResource.php
Create Workflow (Wizard)
Section titled “Create Workflow (Wizard)”The creation form uses a 4-step wizard for guided data entry:
- Product & Market — Select product template, market, language, status, sort order
- Flight Configuration — Departure airports, route type, search period, excluded dates
- Description and Itinerary — AI translation button, core content, per-stop itinerary with nested per-day translations (day_label, title, details)
- Details & SEO — Logistics, accommodation, meal plans, SEO metadata
Each step validates before allowing progression.
Source: backend/app/Filament/Resources/ProductsByMarket/Pages/CreateProductByMarket.php
View Page Actions
Section titled “View Page Actions”| Button | Visibility | Behavior |
|---|---|---|
| Preview on Frontend | Active products | Direct link to frontend product page |
| Preview Draft | Draft/Inactive products | Signed URL with 60-minute expiration |
| Prepare Flight Searches | Always | Creates routes and cache entries for flight configs |
| View Cached Flights | When matching routes exist | Links to DynamicFlightCaches filtered by product routes |
Source: backend/app/Filament/Resources/ProductsByMarket/Pages/ViewProductByMarket.php
Navigation
Section titled “Navigation”| Resource | Group | Icon | Notes |
|---|---|---|---|
| Tours | Suppliers | map-pin | Primary entry point for product creation |
| Products by Market | Products | globe-alt | Market-specific configuration |
| Product Templates | Products | rectangle-stack | Hidden from navigation (accessible via direct URL) |
Permissions
Section titled “Permissions”Resources use HasResourcePermissions trait for RBAC integration.
Source: backend/app/Filament/Traits/HasResourcePermissions.php
Related
Section titled “Related”- Product Templates - Data model
- Products by Market - Configuration details
- Suppliers Service - Tour creation wizard and service assignments
- Dynamic Flight Cache - Flight pricing cache system
- POI System - Points of Interest management