feat(117): smsplanet integration settings

DOCS/ARCHITECTURE.md

@@ -168,6 +168,27 @@ tests/
 ### IntegrationsHubController
 - Dodaje wiersz HostedSMS do `/settings/integrations` ze statusem konfiguracji, sekretu, aktywnosci i ostatniego testu.
 
+## Phase 117 - SMSPLANET Integration Settings
+
+### SmsplanetIntegrationRepository (`src/Modules/Settings/SmsplanetIntegrationRepository.php`)
+- Zarzadza pojedynczym rekordem `smsplanet_integration_settings` (`id=1`) i bazowym wpisem `integrations` typu `smsplanet`.
+- Obsluguje dwie metody autoryzacji: Bearer token oraz `key` + `password`.
+- Szyfruje token, klucz API i haslo przez `IntegrationSecretCipher`; formularz widzi tylko flagi `has_api_token`, `has_api_key` i `has_api_password`.
+- Udostepnia `getCredentials()` tylko dla kompletnej i aktywnej konfiguracji testowej wysylki SMS.
+
+### SmsplanetApiClient (`src/Modules/Settings/SmsplanetApiClient.php`)
+- Wykonuje `POST https://api2.smsplanet.pl/sms` jako `application/x-www-form-urlencoded`.
+- Dla Bearer token wysyla naglowek `Authorization: Bearer ...`; dla `key_password` wysyla parametry `key` i `password`.
+- Wysyla `from`, `to`, `msg` oraz opcjonalnie `clear_polish` i `transactional`; test nie ustawia `test=1`, wiec wysyla realny SMS.
+- Traktuje `messageId` jako sukces, a `errorMsg`/`errorCode` jako blad biznesowy.
+
+### SmsplanetIntegrationController (`src/Modules/Settings/SmsplanetIntegrationController.php`)
+- Endpointy: `GET /settings/integrations/smsplanet`, `POST /settings/integrations/smsplanet/save`, `POST /settings/integrations/smsplanet/test`.
+- `test` realnie wysyla SMS z edytowalna trescia i zapisuje wynik w `integrations.last_test_*`.
+
+### IntegrationsHubController
+- Dodaje wiersz SMSPLANET do `/settings/integrations` ze statusem konfiguracji, sekretu, aktywnosci i ostatniego testu.
+
 ## Phase 108 — Delivery Status Management
 
 ### DeliveryStatusRepository (`src/Modules/Shipments/DeliveryStatusRepository.php`)