Architecture

This section documents the architectural decisions, system design, and external integrations that define the Feyenoord digital platform.

What's Here

Platform Overview

High-level overview of the Feyenoord platform: the three layers, system diagram, and external integrations.

Data Flow

How data moves through the platform: request paths, API gateway, GraphQL router, client SDKs, and async events.

Observability

How traces, logs, and exceptions flow through the platform — from the native app and web browser, through Traefik and the Apollo Router, into the subgraphs and the legacy API, and finally into the Aspire dashboard locally or Application Insights in Azure.

Feature Flags

How feature flags work: overview, client-side, and server-side connections to Flagsmith.

Decision Records

Architecture Decision Records (ADRs) documenting technical choices.

Cross-cutting concerns

Development

How the architecture is reproduced on a developer machine via Docker Compose profiles, the shared base image, and the Aspire telemetry sink.