ADR-006: Address & Geocoding Provider

Status: Accepted

Kontext

ByteBite benötigt qualitativ gute deutsche Adresssuche und strukturierte Komponenten für hierarchische Lieferregeln. Ergebnisse müssen für Bestellungen dauerhaft gespeichert werden können.

Entscheidung

Mapbox Search + Permanent Geocoding wird als erster Provider verwendet. Die Integration liegt hinter einem eigenen AddressProvider-Interface.

ByteBite normalisiert Provider-Daten in ein eigenes Modell, z. B.:

interface NormalizedAddress {
  countryCode: string;
  postalCode: string;
  city: string;
  district: string | null;
  street: string;
  houseNumber: string;
  latitude: number;
  longitude: number;
  provider: "mapbox";
  providerId: string;
}

Konsequenzen

• Delivery Matching arbeitet ausschließlich auf normalisierten Adresskomponenten.
• Keine Lieferregel matcht auf frei eingegebenen Rohstrings.
• Mapbox bleibt austauschbar.
• Vor Go-live wird ein realer Adress-Testdatensatz aus dem Zielgebiet geprüft.