Supply Chain Map

AlpenFX Supply Chain Map

Interaktive Visualisierung globaler Lieferketten – für Magento 2

Magento-2-Portierung des gleichnamigen Shopware-Plugins – mit denselben Kernfunktionen: Standortverwaltung, Lieferketten-Schritte (Timeline), Geocoding (OpenStreetMap/Google), Kartendaten-Aggregation und Storefront- Visualisierung auf der Produktseite (SSR + interaktive Leaflet-Karte).

Was macht dieses Modul?

Das AlpenFX Supply Chain Map Modul bildet komplette Lieferketten vom Rohstoff bis zum Endprodukt ab und visualisiert sie transparent auf der Produktseite – als Leaflet/OpenStreetMap-Karte mit einem Marker pro Station plus einem stufenweisen Lieferketten-Graphen (Timeline). Standorte werden im Backend gepflegt, per Geocoding mit Koordinaten versehen und Produkten zugeordnet.

Hauptfunktionen

• Standortverwaltung: Lieferanten, Hersteller, Lager, Häfen, Distribution – mit Kontakt, Branche, Zertifizierungen und Risiko-Feldern
• Lieferketten-Schritte (Timeline): pro Produkt geordnete Stufen (Quelle → Verarbeitung → Fertigung → Versand → Distribution) mit Status, Transportart und CO₂-Feldern
• Geocoding: Adresse → Koordinaten über OpenStreetMap (Nominatim) oder Google Maps, mit Ergebnis-Cache (alpenfx_location_geocoding)
• Kartendaten-Service: Marker, Bounds und Map-Konfiguration aus der Store-Config
• Storefront: Produktseiten-Abschnitt mit interaktiver Karte (Leaflet) + Lieferketten-Graph – reines SSR + Vanilla-JS (Luma & Hyvä kompatibel)
• APIs: GraphQL-Query + REST-Endpoints für headless/PWA und ERP-Sync
• CLI: bin/magento alpenfx:supply-chain:geocode-all | import | test-map
• Admin-Grid + Formular für Standorte (UI Components) mit ACL

Architektur

| Komponente | Detail | |------------|--------| | Entitäten | alpenfx_supply_chain_location, alpenfx_supply_chain_step, alpenfx_location_geocoding, alpenfx_supply_chain_product_location (Mapping) | | Services | LocationService, GeocodingService (+ OSM/Google Provider), MapService, TimelineService, WidgetService | | Storefront | ViewModel + SSR-Template auf catalog_product_view, Leaflet via CDN (Vanilla-JS, kein jQuery/RequireJS) | | API | GraphQL (productSupplyChain) + REST (/V1/alpenfx/supply-chain/*) | | CLI | Console/Command/* (geocode-all, import, test-map) |

Installation

Als Composer-Paket

composer require alpenfx/module-supply-chain-map
bin/magento module:enable AlpenFX_SupplyChainMap
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento cache:flush

Als Submodule im Hauptprojekt

bin/magento module:enable AlpenFX_SupplyChainMap

Konfiguration

Stores → Configuration → AlpenFX → Supply Chain Map: Widget anzeigen, Standard-Zoom, Geocoding-Provider (OSM/Google), Google-API-Key (nur fürs Geocoding), Timeline anzeigen, Zertifikate/Risiko anzeigen.

Kartendarstellung: Die Karte wird – im Storefront wie im Backend – immer mit Leaflet + OpenStreetMap-Tiles gerendert. Google wird ausschließlich als Geocoding-Provider (Adresse → Koordinaten) unterstützt, nicht als Karten-Renderer.

Geocoding & Nominatim-Usage-Policy

Beim Bulk-/Batch-Geocoding über OpenStreetMap (Nominatim) hält das Modul die Nominatim Usage Policy ein: Es sendet einen identifizierenden User-Agent und drosselt auf ≤ 1 Anfrage/Sekunde (automatisches Throttling im Provider). Für hochvolumiges Geocoding empfiehlt sich ein eigener Nominatim-Server oder Google als Provider.

Lizenz

Proprietär – © Felix Astner Software.