Brekz CMS¶

Brekz CMS is an internal application built on Laravel with two core functionalities:

1. It serves as the content management system (CMS) for the brekz-prestashop storefront (also referred to as the Brekz website), combined with Laravel Nova as the admin panel.
2. It provides product data management for specific tools integrated into the website. For full PIM (Product Information Management) functionality, Brekz uses Ergonode as the dedicated PIM platform.

Purpose¶

The purpose of this application is to simplify and accelerate website content management for both customers and internal users. It supports automated content imports and editing flows, significantly reducing the time required for repetitive tasks that are otherwise time-consuming within PrestaShop.

Dependencies¶

Key dependencies of this application are defined in the composer.json. The main packages to be aware of are:

• Laravel Nova – Used for admin panel and CRUD management.
• Statamic CMS – Powers the content editing experience and serves content to the frontend in a headless configuration.

Functionalities¶

Brekz CMS provides the following key features:

• Homepage banner management – Add, remove, or edit promotional banners displayed on the homepage.
• Mega menu configuration – Control the structure and items of the mega menu on the brekz-prestashop storefront.

• CSV import tools – Import and manage bulk data for:

• MQC (Multi Quantity Configuration)

• Specific Prices / Discounts
• Product price updates
• Category information management – Edit and enrich product category data.

CSV Import Workflow¶

flowchart TD
    A[User uploads CSV] --> B[Click 'Validate']
    B --> C{Run SQL transaction}
    C -->|Validation success| D[Rollback transaction]
    C -->|Validation error| E[Show field-level validation errors]
    D --> F[User confirms import]
    F --> G[Commit to database]
    G --> H[Display import log + statistics]

Feature Dependencies¶

Upstream Dependencies¶

• brekz-prestashop Provides:

• Website content integration

• Product data synchronization
• Frontend rendering based on CMS inputs

Environments¶

The brekz-cms repository runs two parallel git tracks due to the ongoing Templating migration: the non-templating track (serving PrestaShop) and the templating track (serving Brekz Website). Each track has its own test, acceptance, and production environment.

Release branches¶

Staged branches pending merge to master (non-templating track):

Active feature branches¶

Hosting provisioning¶

Nginx vhost configurations are managed in the flooris-hosting-provisioning repository.

Path: webhosting/brekz-new/environments/{tier}/vhost_nginx_{tier}/

Lifecycle¶

Both production environments run concurrently during the Templating A/B test. Once 100% of traffic is routed to cms-templating.brekz.nl, the non-templating track (cms.brekz.nl and its acceptance environment) will be phased out (targeted: end of 2026).

Roadmap¶

The roadmap below outlines the four-step migration plan for Brekz CMS: the Supersale QoL release (step 1), three parallel tracks covering go-live usage, content clean-up, and the git major rebase (step 2), conversion of PrestaShop pages to the Templating structure (step 3), and the feature branch rebase (step 4).

Open roadmap in new tab

Architecture¶

For a full overview of how brekz-cms and brekz-website work together (Blade directives, page warmer, Statamic content repository), see the CMS & Website Rendering Architecture.