Zwerfkei Platform Overview¶

Welcome to the Zwerfkei System Overview. This document provides a high-level description of the Zwerfkei ecosystem, including all major services, applications, and their interactions.

Platform Purpose¶

Zwerfkei is a Dutch specialist outdoor retailer based in Woerden. The platform serves customers both through its physical store and its e-commerce website, offering a wide assortment of camping, hiking, climbing, cycling and travel equipment.

The Zwerfkei platform is a modular, service-oriented ecosystem designed to manage e-commerce operations, customer interactions, inventory, and marketing automation. The architecture promotes scalability, flexibility, and maintainability by decoupling responsibilities across independent services.

Current Platform¶

Assortment & Scale¶

Product Categories¶

Product Filtering (current)¶

The current platform features extensive per-category filtering — a capability the new platform must match or exceed:

Special Collections¶

Ultralight · Survival & Prepping · Family Holidays · Bikepacking · Trail Running · Commuter Cycling · Sustainable Products · Emergency Preparedness

Physical Store¶

Zwerfkei operates a physical store in Woerden that is tightly integrated with the online platform:

• 700 m² permanent tent display for in-store comparison
• 25-metre test trail for footwear fitting
• Treadmill for walking shoe evaluation
• Snowshoe rental service
• Real-time store status and opening hours displayed on the website

Current Technology Stack¶

Payment Methods (current)¶

iDEAL · Bancontact · Mastercard · Visa · PIN · Billink (buy now, pay later)

Core Components¶

System Architecture¶

graph TD
    subgraph Actors["Users & Actors"]
        Visitor["Website Visitor"]
        Employee["Employee"]
        ContentMgr["Content Manager"]
    end

    subgraph ZwerfkeiPlatform["Zwerfkei Platform"]
        Cloudflare["Cloudflare\nCDN & Security"]
        Website["Zwerfkei Website\nLaravel · Vue.js · TypeScript"]
        CMS["Zwerfkei CMS\nLaravel · Statamic"]
        Backend["Zwerfkei API\nLaravel"]
        BackendDB[("API Database\nMySQL")]
    end

    subgraph LegacySystems["Legacy Systems"]
        ZwerfkeiOld["Zwerfkei Backoffice (legacy)"]
        OldDB[("Zwerfkei Backoffice (legacy) Database\nMySQL")]
    end

    subgraph ExternalServices["External Services"]
        Navision["Microsoft Dynamics\nNavision ERP"]
        Ergonode["Ergonode PIM"]
        PostNL["PostNL\nShipment"]
        PayNL["PayNL\nPayments"]
        Kiyoh["Kiyoh\nReviews"]
        Copernica["Copernica\nEmail Marketing"]
        Storage["True Object Storage\nS3"]
    end

    subgraph AnalyticsTracking["Analytics & Tracking"]
        GTM["Google Tag Manager"]
        GA4["Google Analytics 4"]
    end

    Suppliers(["~17 Brand &\nSupplier Sources"])

    %% Actor flows
    Visitor --> Cloudflare
    Employee --> ZwerfkeiOld
    ContentMgr --> CMS

    %% Frontend flows
    Cloudflare --> Website
    Website -- "File Storage" --> CMS
    Website -- "HTTP / API" --> Backend
    Website --> GTM
    GTM --> GA4

    %% Backend flows
    Backend --> BackendDB
    Backend -- "Pricing & Availability" --> Navision
    Backend -- "Product Data API" --> Ergonode
    Backend --> PostNL
    Backend --> PayNL
    Backend --> Kiyoh
    Backend -- "Newsletter opt-in/out" --> Copernica
    Backend --> Storage
    Backend -- "Legacy API" --> ZwerfkeiOld

    %% CMS
    CMS --> Storage

    %% Legacy flows
    ZwerfkeiOld --> OldDB
    ZwerfkeiOld --> Navision

    %% Product data sources
    Suppliers -- "Product info &\nAvailability" --> Ergonode

Monitoring & Logging¶

All services follow the centralized logging and monitoring standards described in shared/logging.md.