Common
Wiederverwendbare Bausteine, die von allen drei Domains (Grenke, Weclapp, MFR) genutzt werden.
Inhalt
- HTTP-Clients —
GuzzleClient(HTTP Basic) &ODataClientfür MFR - Helpers —
ApiHelper,PdfHelper,BiMapHelper
Konventionen
- Routing: alle Routen unter
/api/v1/<domain>/, geschützt mitauth: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.