Skip to content

Brekz CMS

Brekz CMS is an internal application 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).
  2. It functions as a product information manager (PIM) for specific tools integrated into the website.

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

Step-by-step process The CSV import system is designed to make bulk content and product data changes efficient and safe. The process involves the following steps: 1. **CSV Upload** The user uploads a CSV file based on a provided example/template to ensure correct structure and formatting. 2. **Validation Step** Upon clicking the **Validate** button: * A dry-run SQL transaction is initiated. * The system checks for field-level errors using a built-in validation mechanism. * The transaction is rolled back regardless of outcome, ensuring no data is committed during validation. 3. **Import Execution** Once validated, the user can execute the actual import: * The validated data is committed to the database. * A visual log is shown to the user. * Statistics are displayed including: * Total rows processed * Number of successful imports * Number of rows with errors
MermaidJS Flowchart 
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