Skip to main content

Common

Wiederverwendbare Bausteine, die von allen drei Domains (Grenke, Weclapp, MFR) genutzt werden.

Inhalt

  • HTTP-ClientsGuzzleClient (HTTP Basic) & ODataClient für MFR
  • HelpersApiHelper, PdfHelper, BiMapHelper

Konventionen

  • Routing: alle Routen unter /api/v1/<domain>/, geschützt mit auth:sanctum
  • Response-Format:
    {
    "success": true,
    "data": { ... },
    "meta": { ... } // optional, z.B. State-Metadaten
    }
  • Error-Format:
    {
    "success": false,
    "message": "<menschenlesbare Fehlermeldung>"
    }
  • PascalCase ↔ camelCase: externe APIs (Grenke, MFR) liefern PascalCase. Interner Code spricht camelCase. Übersetzung läuft IMMER über DTOs (siehe Architektur).
  • Logging: jeder fehlgeschlagene External-Call landet im Laravel-Log mit method, uri, status, body, message. Nichts wird stillschweigend geschluckt.