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`)

DOCS/DB_SCHEMA.md

@@ -1,6 +1,6 @@
 # Database Schema
 
-**Updated:** 2026-04-28 | **Total tables:** 55 | **Engine:** InnoDB | **Charset:** utf8mb4_unicode_ci
+**Updated:** 2026-05-12 | **Total tables:** 60 | **Engine:** InnoDB | **Charset:** utf8mb4_unicode_ci
 
 ---
 
@@ -574,6 +574,25 @@ UNIQUE: `(integration_id)` - one global HostedSMS settings row.
 
 ---
 
+**smsplanet_integration_settings** - SMSPLANET account credentials (Phase 117; fixed 1 row)
+| Column | Type | Nullable | Notes |
+|--------|------|----------|-------|
+| `id` | TINYINT UNSIGNED | NO | PK, always 1 |
+| `integration_id` | INT UNSIGNED | YES | UNIQUE, FK -> integrations(id) CASCADE |
+| `auth_method` | VARCHAR(32) | NO | `token` or `key_password`, DEFAULT `token` |
+| `api_token_encrypted` | TEXT | YES | AES-encrypted Bearer token via `IntegrationSecretCipher` |
+| `api_key_encrypted` | TEXT | YES | AES-encrypted API key via `IntegrationSecretCipher` |
+| `api_password_encrypted` | TEXT | YES | AES-encrypted API password via `IntegrationSecretCipher` |
+| `sender` | VARCHAR(32) | YES | SMSPLANET `from` sender |
+| `clear_polish` | TINYINT(1) | NO | DEFAULT 0 |
+| `transactional` | TINYINT(1) | NO | DEFAULT 0 |
+| `created_at` | DATETIME | NO | |
+| `updated_at` | DATETIME | NO | |
+
+UNIQUE: `(integration_id)` - one global SMSPLANET settings row.
+
+---
+
 ## Accounting / Receipts
 
 **receipt_configs** — Receipt generation configurations

DOCS/TECH_CHANGELOG.md

@@ -1,5 +1,21 @@
 # Technical Changelog
 
+## 2026-05-12 - Phase 117 Plan 01: SMSPLANET Integration Settings + Test SMS
+
+**Co zrobiono:**
+- Dodano migracje `20260512_000108_create_smsplanet_integration_settings.sql` z pojedyncza konfiguracja `smsplanet_integration_settings` i bazowym wpisem `integrations` typu `smsplanet`.
+- Dodano `SmsplanetIntegrationRepository` z obsluga metod autoryzacji `token` oraz `key_password` i szyfrowaniem sekretow przez `IntegrationSecretCipher`.
+- Dodano `SmsplanetApiClient` dla SMSPLANET (`POST https://api2.smsplanet.pl/sms`) z obsluga Bearer token oraz `key` + `password`.
+- Dodano `SmsplanetIntegrationController` i trasy `/settings/integrations/smsplanet`, `/save`, `/test`.
+- Dodano widok `resources/views/settings/smsplanet.php` z konfiguracja i realna wysylka testowego SMS z edytowalna trescia oraz panelem ostatniego testu (`OK`, HTTP, `messageId`).
+- Dodano SMSPLANET do hubu integracji `/settings/integrations`.
+- Poprawiono import `IntegrationSecretCipher`, aby rzucal istniejacy `App\Core\Exceptions\IntegrationConfigException`.
+
+**Dlaczego:**
+- Operator potrzebuje drugiej bramki SMS analogicznej do HostedSMS, ale bez uruchamiania jeszcze automatyzacji lub historii wysylek.
+- SMSPLANET wspiera dwa warianty autoryzacji, wiec konfiguracja przechowuje wszystkie sekrety w formie szyfrowanej i waliduje wymagania zalezne od wyboru operatora.
+- Test uzywa rzeczywistej wysylki, bo celem tej fazy jest potwierdzenie realnej sciezki API.
+
 ## 2026-05-12 - Phase 116 Plan 01: HostedSMS Integration Settings + Test SMS
 
 **Co zrobiono:**