Seite 4 - Monthly Archives: August 2025

REST API Design: Ressourcen, Verben, Idempotenz und Statuscodes sauber trennen

August 16, 2025

{ }

GET

REST API Design · HTTP · Idempotenz · Statuscodes · Ressourcen

REST API Design: Ressourcen, Verben, Idempotenz
und Statuscodes sauber trennen

Viele REST-APIs nutzen HTTP als Transportprotokoll, ohne seine Semantik auszuschöpfen. Ressourcen falsch modelliert, Verben falsch eingesetzt, Idempotenz nicht garantiert und Statuscodes willkürlich gewählt – das sind keine Stilfragen, sondern Designfehler mit direkten Auswirkungen auf Caching, Retry-Logik und Client-Implementierung.

17 Min. Lesezeit GET · POST · PUT · PATCH · DELETE · Idempotenz · 2xx · 4xx · 5xx RFC 7231 · RFC 7807 · Symfony 7 · REST-Constraints

Inhaltsverzeichnis

1. Ressourcenmodellierung: Nomen statt Verben in URLs
2. HTTP-Verben: Semantik statt Konvention
3. Idempotenz: GET, PUT, DELETE vs. POST und PATCH
4. Statuscodes: präzise statt approximiert
5. Sub-Ressourcen und Beziehungen modellieren
6. Aktionen auf Ressourcen: wenn Verben Sinn ergeben
7. Content Negotiation und Accept-Header
8. Vergleich: Anti-Patterns vs. REST-konformes

Magento GraphQL für eigene Module vorbereiten: Struktur und Dateiaufteilung

August 15, 2025

{ }

type

GraphQL · Magento · Modul-Struktur · Schema · Resolver

Magento GraphQL für eigene Module vorbereiten
sinnvolle Struktur und Dateiaufteilung

Ein eigenes Magento-Modul GraphQL-fähig zu machen klingt einfach, scheitert aber häufig an fehlender Struktur: falsch platzierte Schema-Dateien, Resolver ohne klare Delegation, di.xml-Einträge, die nie greifen. Dieser Artikel zeigt, wie die Dateiaufteilung aussehen sollte und warum Konvention hier wichtiger ist als Kreativität.

15 Min. Lesezeit etc/schema.graphqls · di.xml · ResolverInterface · Model-Delegation Magento 2.4 · PHP 8.x

Inhaltsverzeichnis

1. Warum Struktur bei GraphQL-Modulen so wichtig ist
2. Welche Dateien ein GraphQL-fähiges Modul braucht
3. Das Schema: etc/schema.graphqls richtig aufbauen
4. Resolver: Klassen, Interfaces und Delegation
5. di.xml: Resolver registrieren und Typen verbinden
6. Modelle und ViewModels nicht im Resolver vermischen
7. Dateistruktur im Vergleich: falsch gegen richtig
8. Typische Fehler beim ersten

API-First: Workflow zwischen Backend, Frontend und QA

August 15, 2025

{ }

GET

API-First · OpenAPI · Team-Workflow · Contract-Testing

API-First: Workflow zwischen Backend, Frontend und QA
OpenAPI als Single Source of Truth im Team

Wer APIs implementiert, bevor das Design steht, blockiert Frontend-Teams und zwingt QA-Ingenieure zu manuellem Nachfassen. API-First kehrt die Reihenfolge um: Die OpenAPI-Spezifikation entsteht zuerst, ermöglicht Mocking für Frontend und Contract-Tests für QA – alle Teams entwickeln parallel, ohne aufeinander zu warten.

18 Min. Lesezeit OpenAPI · Mocking · Contract-Testing · Review-Prozess Teams · Parallelarbeit · Schnittstellendesign

Inhaltsverzeichnis

1. Das Problem ohne API-First: Blockaden im Teamworkflow
2. Was API-First konkret bedeutet – und was nicht
3. Die OpenAPI-Spezifikation gemeinsam erarbeiten
4. Backend: Code gegen Spezifikation entwickeln
5. Frontend: Mit Mocks parallel entwickeln
6. QA: Contract-Tests automatisch aus der Spec ableiten
7. API-Design-Review: Wie strukturierte Governance funktioniert
8. API-First vs.

Webhooks in OpenAPI 3.1 dokumentieren

August 15, 2025

{ }

GET

OpenAPI 3.1 · Webhooks · API Dokumentation · HMAC

Webhooks in OpenAPI 3.1 dokumentieren
Payload-Schemas, Signaturen und Retry-Verhalten

Webhooks wurden jahrelang außerhalb der API-Dokumentation beschrieben – in separaten Markdown-Dateien, die niemand aktuell hält. OpenAPI 3.1 bringt das neue webhooks-Objekt, das Webhook-Payload-Schemas, Sicherheitsanforderungen und Retry-Verhalten direkt in der Spezifikation verankert.

11 Min. Lesezeit OpenAPI 3.1 · webhooks-Objekt · HMAC-SHA256 · Redoc · Swagger UI OpenAPI Specification 3.1.0

Inhaltsverzeichnis

1. Das Problem: Webhooks außerhalb der API-Dokumentation
2. OpenAPI 3.1: Was sich geändert hat
3. Das webhooks-Objekt: Aufbau und Syntax
4. Payload-Schemas mit Discriminator
5. HMAC-Signatur und Sicherheit dokumentieren
6. Retry-Verhalten und Idempotenz
7. Tool-Unterstützung: Redoc, Swagger UI, Stoplight
8. OpenAPI 3.0 vs. 3.1 für Webhooks im Vergleich
9. Zusammenfassung
10. FAQ

1. Das Problem: Webhooks außerhalb der API-Dokumentation

Vor

Vue Composable Stores vs. Pinia Stores: Wann welches Muster?

August 15, 2025

<v/>

{ }

Vue 3 · Pinia · State Management · Composables

Composable Stores vs. Pinia Stores
Wann welches Muster in Vue 3?

„Brauchen wir hier Pinia oder reicht ein Composable?" ist eine der häufigsten Architekturfragen in Vue-3-Projekten. Die Antwort entscheidet darüber, ob globaler State zentralisiert oder verteilt, sichtbar oder verborgen, DevTools-trackbar oder unsichtbar ist. Der falsche Ansatz kostet Monate Debugging-Aufwand, wenn die Anwendung wächst.

14 Min. Lesezeit Pinia · defineStore · useStore · reactive · provide/inject Vue 3.x · Pinia 2.x · TypeScript

Inhaltsverzeichnis

1. Das Kernproblem: Wann ist State „global"?
2. Der Composable Store: reaktiver State außerhalb von Komponenten
3. Pinia: defineStore, State, Getters und Actions
4. Pinia Setup Stores: Composables als Store-Definition
5. DevTools-Integration: Warum Pinia sichtbarer State ist
6. SSR und Hydration: Pinia vs. Composable Store im Server-Rendering
7. Die Entscheidungsmatrix: Composable oder Pinia?
8. Store-Komposition:

Interaktive Bash-Tools mit select, read, Menüs und Bestätigungen

August 14, 2025

Bash · select · read · Terminal · DevOps

Interaktive Bash-Tools mit
select, read, Menüs und Bestätigungen

Gute interaktive Bash-Tools haben eine klare Bedienoberfläche: nummerierte Menüs mit select, Eingaben mit read -r und Timeout, farbige Statusmeldungen und Bestätigungsdialoge, die gefährliche Aktionen absichern – all das ist mit reinen Bash-Builtins umsetzbar.

15 Min. Lesezeit select · read -r · Timeout · ANSI-Farben · Bestätigungen Bash 4.x+ · Linux · macOS · tput · dialog

Inhaltsverzeichnis

1. Warum interaktive Bash-Tools Usability brauchen
2. select: nummerierte Auswahlmenüs
3. read: Eingaben sicher einlesen
4. Timeouts und Default-Werte
5. Eingabevalidierung und Wiederholung
6. Bestätigungsdialoge für gefährliche Aktionen
7. Farben und Formatierung im Terminal
8. Fortschrittsanzeigen und Spinner
9. Interaktive Bash-Techniken im Vergleich
10. Zusammenfassung
11. FAQ

1. Warum interaktive Bash-Tools Usability brauchen

Ein interaktives Bash-Tool, das täglich von mehreren Personen genutzt

Dateibasierte Architektur für größere Vue-Projekte

August 13, 2025

<v/>

{ }

Vue 3 · Architektur · Feature-Slicing · Composables

Dateibasierte Architektur für größere Vue-Projekte
von Feature-Slices bis zu sauberen Modul-Grenzen

Wer Vue-Projekte ohne durchdachte Dateistruktur aufbaut, kämpft spätestens beim zweiten Entwickler mit unklaren Verantwortlichkeiten und zirkulären Abhängigkeiten. Feature-basierte Vue-Architektur mit klar definierten Schichten und Composables als Herzstück löst dieses Problem strukturell, bevor es den Alltag verlangsamt.

15 Min. Lesezeit Feature-Slices · Composables · Pinia · Vue Router · Modul-Grenzen Vue 3 · Vite · TypeScript

Inhaltsverzeichnis

1. Warum klassische Ordnerstruktur in Vue scheitert
2. Feature-Slicing: der Kern dateibasierter Vue-Architektur
3. Schichten innerhalb eines Feature-Slice
4. Composables als Herzstück der Geschäftslogik
5. Shared-Layer: was wirklich geteilt werden darf
6. Routing und Lazy-Loading pro Feature
7. Pinia-Stores sauber organisieren
8. Modul-Grenzen durchsetzen und Abhängigkeiten prüfen
9. Architektur-Ansätze

CSS Critical Path und PageSpeed optimieren

August 13, 2025

CSS · PageSpeed · Core Web Vitals · Performance

CSS Critical Path und PageSpeed
render-blocking CSS dauerhaft eliminieren

Jedes CSS-Stylesheet, das im <head> ohne Optimierung eingebunden ist, blockiert den Browser bis zum vollständigen Download und Parsen. Critical CSS inline zu setzen und den Rest asynchron zu laden ist die wirkungsvollste Einzelmaßnahme für bessere Core Web Vitals — und eine, die rein auf CSS-Ebene umgesetzt werden kann.

12 Min. Lesezeit Critical CSS · preload · font-display · render-blocking · FCP · LCP CSS3 · HTTP/2 · Lighthouse · PageSpeed Insights

Inhaltsverzeichnis

1. Warum CSS der häufigste render-blocking Engpass ist
2. Was ist Critical CSS und wie wird es definiert?
3. Critical CSS extrahieren: Tools und Methoden
4. Critical CSS inline setzen: Patterns und Fallstricke
5. Nicht-kritisches CSS asynchron laden
6. preload und prefetch für CSS-Ressourcen
7. font-display: render-blocking durch Web Fonts vermeiden
8. FCP, LCP und CLS: CSS-Einfluss auf Core Web Vitals

Pagination in SQL: OFFSET vs. Keyset Pagination

August 12, 2025

PAGE

CURSOR

SQL · Keyset Pagination · MySQL · Performance · Magento

Pagination in SQL: OFFSET vs. Keyset Pagination

Warum OFFSET bei Seite 1000 zur Performance-Falle wird, wie Keyset Pagination mit Cursor-Werten das Problem löst — und warum Magento tiefe Seiten drosseln muss.

OFFSET-Degradierung erklärt Keyset mit Composite Cursor SQL_CALC_FOUND_ROWS Covering Index

Inhaltsverzeichnis

1. Das OFFSET-Problem: Warum Seite 1000 langsam ist
2. EXPLAIN zeigt das Problem deutlich
3. Keyset Pagination: Das Grundprinzip
4. Composite Cursor für Sort-Ties
5. Konsistenz bei gleichzeitigen Inserts und Deletes
6. Trade-offs: Was Keyset Pagination nicht kann
7. Magento Produktgrid und Deep Pagination
8. SELECT SQL_CALC_FOUND_ROWS vs. separates COUNT
9. Covering Index für Keyset-Queries
10. Unterstützung
11. Zusammenfassung
12. FAQ

1. Das OFFSET-Problem: Warum Seite 1000 langsam ist

OFFSET/LIMIT ist die intuitive SQL-Pagination: Man überspringt die ersten N Zeilen und gibt die nächsten M zurück. Das funktioniert

Docker Secrets: Was nie ins Image gehört

August 12, 2025

Docker · Security · Secrets Management · DevOps

Docker Secrets: Was nie ins Image gehört
BuildKit, Swarm Secrets und sichere Credential-Flows

Passwörter in Dockerfiles, API-Keys als ENV-Variablen, Zertifikate in Image-Layern – das sind reale Sicherheitslücken in Tausenden von Container-Setups. Docker Secrets, BuildKit Mount-Secrets und ein durchdachtes Credentials-Management eliminieren diese Risiken, ohne den Entwicklungsworkflow zu belasten.

12 Min. Lesezeit BuildKit · Swarm Secrets · Vault · ENV-Sicherheit Docker 24+ · BuildKit 0.11+

Inhaltsverzeichnis

1. Das Problem: Secrets in Images sind ein Dauerbrenner
2. Wie Secrets in Image-Layer gelangen – und warum das gefährlich ist
3. BuildKit Mount-Secrets: Secrets im Build ohne Layer-Spur
4. ENV-Variablen: Grenzen und sicherer Einsatz
5. Docker Swarm Secrets: Secrets für Produktions-Services
6. Docker Compose Secrets für lokale Entwicklung
7. HashiCorp Vault und externe Secret-Stores
8. Secret-Scanning: Lecks erkennen bevor sie passieren