Architecture¶

This page documents the Zwerfkei system architecture in two stages: the current (legacy) situation and the target architecture. A full integration overview is included at the bottom.

Current Architecture¶

The current platform is built around Zwerfkei Backoffice (legacy), a legacy monolithic application. It connects to Microsoft Dynamics Navision as the ERP and uses True Object Storage for file storage.

C4Container
    title Current Architecture - Zwerfkei

    Person(employee, "Employee", "Internal user of Zwerfkei")
    Person(customer, "Customer", "External customer")

    System_Boundary(zwerfkei, "Zwerfkei Systems") {
        Container(old, "Zwerfkei Backoffice (legacy)", "Legacy application", "Central application for all business processes")
        Container(customerportal, "Zwerfkei Klant", "Customer portal", "Portal for customers")
        ContainerDb(olddb, "Zwerfkei Backoffice (legacy) Database", "MySQL", "Central database")
    }

    System_Ext(navision, "Microsoft Navision 2018", "ERP system (end-of-support 2026)")
    System_Ext(storage, "True Object Storage", "S3-compatible storage")

    Rel(employee, old, "Uses")
    Rel(customer, customerportal, "Uses")
    Rel(customer, old, "Uses (webshop)")

    Rel(old, olddb, "Reads/writes")
    Rel(old, navision, "Synchronises")
    Rel(old, storage, "File storage")

    Rel(customerportal, old, "API calls")
    Rel(customerportal, olddb, "Reads")

Target Architecture¶

The target architecture introduces a new Zwerfkei API, Zwerfkei Website and Zwerfkei CMS alongside the existing legacy systems. The legacy environment remains operational during the transition.

High-level flowchart of all systems, services and data flows in the target 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 --> S3["New S3 Bucket\nObject Storage"]
    Backend -- "Legacy API" --> ZwerfkeiOld

    %% CMS
    CMS --> S3

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

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