API Mapping (Ist → Geplant v4)
Kurzüberblick: aktuelle Frontend-Calls, wofür sie genutzt werden, welche Header/Payload erwartet werden und welcher Ziel-Endpunkt in einer aufgeräumten /api/v4/... Welt vorgesehen ist. Keine Codeänderung, reine Orientierung.
| Bereich | Aktueller Endpunkt | Nutzung | Header/Payload | Geplanter v4-Endpunkt |
|---|---|---|---|---|
| Auth | auth/login (POST) | Login / Magic-Link | Email, ggf. device info | /api/v4/auth/login |
| Device Check | validate-device (POST) | Gerät validieren | x-user-email, x-device-id | /api/v4/auth/device/validate |
| Session Admin | auth/session/users, auth/session/check, auth/session/terminate, auth/user/unblock | Admin-Session-Übersicht/Beenden/Unblock | Auth-Header | /api/v4/admin/sessions/... |
| Force Reauth | force-neuanmeldung (POST, dryRun), force-neuanmeldung/eligible | Reauth erzwingen | Auth-Header, Body (email, flags) | /api/v4/admin/force-reauth |
| User Profil | muc4taxiActivateUser/:email (GET/POST/DELETE), muc4taxiActivateUser/me (GET) | User laden/ändern, Profil laden | Auth-Header, Body userPersData, settings | /api/v4/users/:id, /api/v4/users/me |
| User Settings | users/settings, users/theme, users/profile, users/profile/avatar | Settings/Theme/Profile/Avatar | Auth-Header, JSON/Multipart | `/api/v4/users/:id/settings |
| Menü | menu/items | Menüeinträge laden | Auth-Header | /api/v4/menu/items |
| Conditions | check-conditions (GET/POST), check-conditions/admin/current, check-conditions/tarife | Mitgliedschaft/Konditionen | ggf. Auth-Header | /api/v4/conditions, /api/v4/admin/conditions |
| Server-Status | health + `readAirports/{arrivals | departures}/muc` | Server-/Daten-Check | Auth-Header bei readAirports |
| Flugplan | readAirports/{direction}/{airport} | Flugdaten | Auth-Header | /api/v4/flights/{direction}/{airport} |
| Invoices | invoices/create, invoices/history, invoices/pending-users, invoices/unseen, invoices/mark-seen | Quittungen erstellen/listen/markieren | Auth-Header, JSON | /api/v4/invoices/... |
| Feature Feedback | feature-feedback/summary | Feedback-Übersicht (Admin) | Auth-Header | /api/v4/admin/feedback/summary |
| Admin User Mgmt | getUnrealUser (GET/POST) | Inaktive User | Auth-Header, JSON | /api/v4/admin/users/stale |
| Admin Rollen | muc4taxiUserRolle | Rollenverwaltung | Auth-Header | /api/v4/admin/roles |
| Admin Misc | muc4taxi/devices | Device/Session-Counts | Auth-Header | /api/v4/admin/devices |
| Sys Status | sysStatusUser | Systemstatus User | Auth-Header | /api/v4/admin/system/users |
| Magic | magicmail, magicauth | Magic-Link Versand/Auth | /api/v4/auth/magic/... | |
| Reset | reset (Server), resetApp (Client) | Client/Session Reset | n/a | /api/v4/auth/reset (falls nötig) |
Hinweise für die spätere Umstellung
- Auth/Headers konsistent halten: zentrale Stelle im neuen API-Client, alle Services greifen darauf zu.
- Alte „muc4taxi…“ Routen per Alias bereitstellen, bis Frontend umgestellt ist, dann abschalten.
- Eine detaillierte Mapping-Tabelle pro Komponente/Service (Datei → Endpunkt → Methode/Payload) kann hier ergänzt werden, sobald der automatisierte Scan vorliegt.