feat(116): hostedsms integration settings

Phase 116 complete:
- add HostedSMS settings with encrypted password storage
- add SimpleAPI real test SMS flow and integrations hub row
- document schema, architecture, changelog, and PAUL state

Co-Authored-By: Codex <noreply@openai.com>

DOCS/ARCHITECTURE.md

@@ -149,6 +149,25 @@ tests/
   bootstrap.php    PSR-4 autoloader for tests
 ```
 
+## Phase 116 - HostedSMS Integration Settings
+
+### HostedSmsIntegrationRepository (`src/Modules/Settings/HostedSmsIntegrationRepository.php`)
+- Zarzadza pojedynczym rekordem `hostedsms_integration_settings` (`id=1`) i bazowym wpisem `integrations` typu `hostedsms`.
+- Szyfruje haslo przez `IntegrationSecretCipher`; formularz widzi tylko flage `has_password`.
+- Udostepnia `getCredentials()` dla kontrolera testowej wysylki SMS.
+
+### HostedSmsApiClient (`src/Modules/Settings/HostedSmsApiClient.php`)
+- Wykonuje `POST https://api.hostedsms.pl/SimpleApi` jako `application/x-www-form-urlencoded`.
+- Wysyla `UserEmail`, `Password`, `Sender`, `Phone`, `Message` oraz opcjonalnie `ConvertMessageToGSM7`.
+- Traktuje `MessageId` jako sukces, a `ErrorMessage` jako blad biznesowy nawet przy HTTP 200.
+
+### HostedSmsIntegrationController (`src/Modules/Settings/HostedSmsIntegrationController.php`)
+- Endpointy: `GET /settings/integrations/hostedsms`, `POST /settings/integrations/hostedsms/save`, `POST /settings/integrations/hostedsms/test`.
+- `test` realnie wysyla SMS z edytowalna trescia i zapisuje wynik w `integrations.last_test_*`.
+
+### IntegrationsHubController
+- Dodaje wiersz HostedSMS 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

@@ -558,6 +558,22 @@ UNIQUE: `(type, name)`
 
 ---
 
+**hostedsms_integration_settings** - HostedSMS account credentials (Phase 116; fixed 1 row)
+| Column | Type | Nullable | Notes |
+|--------|------|----------|-------|
+| `id` | TINYINT UNSIGNED | NO | PK, always 1 |
+| `integration_id` | INT UNSIGNED | YES | UNIQUE, FK -> integrations(id) CASCADE |
+| `user_email` | VARCHAR(190) | YES | HostedSMS login |
+| `password_encrypted` | TEXT | YES | AES-encrypted via `IntegrationSecretCipher` |
+| `sender` | VARCHAR(32) | YES | HostedSMS sender name / nadpis |
+| `convert_message_to_gsm7` | TINYINT(1) | NO | DEFAULT 0 |
+| `created_at` | DATETIME | NO | |
+| `updated_at` | DATETIME | NO | |
+
+UNIQUE: `(integration_id)` - one global HostedSMS settings row.
+
+---
+
 ## Accounting / Receipts
 
 **receipt_configs** — Receipt generation configurations

DOCS/TECH_CHANGELOG.md

@@ -1,5 +1,20 @@
 # Technical Changelog
 
+## 2026-05-12 - Phase 116 Plan 01: HostedSMS Integration Settings + Test SMS
+
+**Co zrobiono:**
+- Dodano migracje `20260512_000107_create_hostedsms_integration_settings.sql` z pojedyncza konfiguracja `hostedsms_integration_settings` i bazowym wpisem `integrations` typu `hostedsms`.
+- Dodano `HostedSmsIntegrationRepository` z szyfrowaniem hasla przez `IntegrationSecretCipher`.
+- Dodano `HostedSmsApiClient` dla HostedSMS SimpleAPI (`POST https://api.hostedsms.pl/SimpleApi`).
+- Dodano `HostedSmsIntegrationController` i trasy `/settings/integrations/hostedsms`, `/save`, `/test`.
+- Dodano widok `resources/views/settings/hostedsms.php` z konfiguracja i realna wysylka testowego SMS z edytowalna trescia oraz czytelnym panelem ostatniego testu (`OK`, HTTP, MessageId).
+- Dodano HostedSMS do hubu integracji `/settings/integrations`.
+
+**Dlaczego:**
+- Operator potrzebuje najpierw zapisac dane HostedSMS i sprawdzic realna wysylke SMS, zanim integracja zostanie wykorzystana w automatyzacjach lub komunikacji z klientami.
+- Test uzywa rzeczywistej wysylki, bo SimpleAPI nie udostepnia osobnego endpointu ping/test.
+- Haslo nie jest ujawniane po zapisie; UI pokazuje tylko status zapisanego sekretu.
+
 ## 2026-04-28 - Phase 110 Plan 01: Statistics Summary
 
 **Co zrobiono:**