Supply Chain Map
AlpenFX Supply Chain Map
Interaktive Visualisierung globaler Lieferketten – für Magento 2
Magento2.4 AlpenFXModul
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.
References to legal requirements describe what the extension does. Whether a shop meets a requirement depends on its configuration and use and is down to its operator. This is not legal advice.