update

DOCS/ARCHITECTURE.md

@@ -82,6 +82,7 @@
 - `POST /settings/integrations/shoppro/save`
 - `POST /settings/integrations/shoppro/test`
 - `POST /settings/integrations/shoppro/statuses/save`
+- `POST /settings/integrations/shoppro/statuses/save-pull`
 - `POST /settings/integrations/shoppro/statuses/sync`
 - `POST /settings/integrations/shoppro/delivery/save`
 - `GET /settings/accounting`
@@ -337,6 +338,7 @@
   - `ShipmentController::prepare(Request): Response`,
   - laduje uslugi dostawy providerow z `ShipmentProviderRegistry` (aktualnie: `allegro_wza`, `apaczka`),
   - pobiera automatyczne mapowanie formy dostawy przez `CarrierDeliveryMethodMappingRepository` (`source_system` + `source_integration_id` + `order_delivery_method`),
+  - `buildReceiverAddress` laczy delivery + customer z fallbackami: jezeli delivery nie ma ulicy (`street_name`), wszystkie brakujace pola adresowe (name, street, city, zip, country, phone, email) sa uzupelniane z customer,
   - dla dostaw punktowych (`parcel_external_id`/`parcel_name`) prefillem `receiver_name` sa dane klienta (a nie nazwa punktu/metody dostawy),
   - gdy mapowanie nie zostanie znalezione, buduje komunikat diagnostyczny (brak mapowan dla instancji lub brak mapowania konkretnej metody) i przekazuje go do widoku.
 - `POST /orders/{id}/shipment/create`:
@@ -562,6 +564,11 @@
   - zapisuje mapowania per instancja shopPRO przez `ShopproStatusMappingRepository::replaceForIntegration(...)` do `order_status_mappings` (klucz: `orderpro_status_code`).
   - `ShopproStatusMappingRepository::listExternalStatuses(int)` — zwraca liste zewnetrznych statusow shopPRO dla danej integracji.
   - `ShopproIntegrationsController` uzywa `buildMappingIndex()` + `buildExternalStatusOptions()` zamiast poprzedniego `buildStatusRows()`.
+- `POST /settings/integrations/shoppro/statuses/save-pull`:
+  - `ShopproIntegrationsController::savePullStatusMappings(Request): Response`
+  - waliduje CSRF, `integration_id` i kody statusow,
+  - zapisuje mapowania pull (shopPRO → orderPRO) przez `ShopproPullStatusMappingRepository::replaceForIntegration(...)` do `order_status_pull_mappings` (klucz: `shoppro_status_code`).
+  - `ShopproIntegrationsController` uzywa `buildPullMappingIndex()` do zaladowania pull mappings do widoku.
 - `POST /settings/integrations/shoppro/delivery/save`:
   - `ShopproIntegrationsController::saveDeliveryMappings(Request): Response`
   - waliduje CSRF i `integration_id`,
@@ -575,6 +582,7 @@
   - mapuje adres faktury do `order_addresses.address_type=invoice` (firma/NIP/adres) na podstawie pol `invoice`/`billing*`/`firm_*`,
   - mapuje punkty odbioru (`inpost_paczkomat` / `orlen_point`) do adresu `delivery` (`parcel_external_id`, `parcel_name`, ulica/kod/miasto),
   - uzupelnia `delivery` o telefon/e-mail klienta i etykiete metody dostawy z kosztem (`transport_cost`).
+  - `ShopproOrderMapper::extractPersonalization()` buduje personalizacje z pol: `attributes`, `custom_fields` i `message` (wiadomosc klienta z prefiksem "Wiadomosc:").
 - `ShopproStatusSyncService`:
   - uruchamiany z crona (`shoppro_order_status_sync`),
   - obsluguje oba kierunki synchronizacji statusow: