Jacek Pyziak
522c94a434
- Nowa tabela sms_templates (name + body + is_active) + minimalny CRUD.
- /settings/sms-templates: lista + formularz z paleta zmiennych (pill chips).
- Wydzielono Sms\SmsVariableResolver ze wspolna logika placeholderow;
Email\VariableResolver staje sie cienka fasada — EmailSendingService bez zmian.
- Dropdown "Wybierz szablon" w zakladce SMS na /orders/{id} z fetch
GET /orders/{id}/sms/template + OrderProAlerts.confirm przy nadpisaniu.
- Stopka SMSPLANET dalej doklejana wylacznie przez SmsConversationService
(Phase 122 contract preserved).
- Sidebar Ustawien: nowy link "Szablony SMS".
Migration: 20260512_000112_create_sms_templates.sql (CREATE TABLE).
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
303 lines
24 KiB
Markdown
303 lines
24 KiB
Markdown
---
|
|
phase: 124-sms-templates
|
|
plan: 01
|
|
type: execute
|
|
wave: 1
|
|
depends_on: []
|
|
files_modified:
|
|
- database/migrations/20260512_000112_create_sms_templates.sql
|
|
- src/Modules/Sms/SmsTemplateRepository.php
|
|
- src/Modules/Sms/SmsVariableResolver.php
|
|
- src/Modules/Settings/SmsTemplateController.php
|
|
- src/Modules/Email/VariableResolver.php
|
|
- src/Modules/Orders/OrdersController.php
|
|
- routes/web.php
|
|
- resources/views/settings/sms-templates.php
|
|
- resources/views/settings/sms-templates-form.php
|
|
- resources/views/orders/show.php
|
|
- resources/views/layouts/app.php
|
|
- resources/lang/pl/orders.php
|
|
- public/assets/js/modules/sms-template-picker.js
|
|
- .paul/codebase/db_schema.md
|
|
- .paul/codebase/architecture.md
|
|
- .paul/codebase/tech_changelog.md
|
|
autonomous: true
|
|
delegation: off
|
|
---
|
|
|
|
<objective>
|
|
## Goal
|
|
Dodać moduł szablonów wiadomości SMS (CRUD w Ustawieniach) oraz dropdown "Wybierz szablon" w zakładce SMS na `/orders/{id}`, który wstawia treść z rozwiniętymi zmiennymi (`{{zamowienie.numer}}`, `{{kupujacy.imie_nazwisko}}`, `{{przesylka.numer}}` itd.) do textarea formularza wysyłki SMS.
|
|
|
|
## Purpose
|
|
Operator zamawia SMS-y typu „przypomnienie o płatności", „numer śledzenia", „prośba o opinię" wielokrotnie. Dziś za każdym razem ręcznie wpisuje tekst i tracking number. Szablony skracają flow do jednego kliknięcia + ewentualnej edycji, analogicznie jak szablony e-mail (`/settings/email-templates`).
|
|
|
|
## Output
|
|
- Tabela `sms_templates` (name, body, is_active, timestamps).
|
|
- Sekcja `/settings/sms-templates` z listą + formularzem CRUD (parytetowo z email-templates).
|
|
- Współdzielony resolver zmiennych (wydzielony z `Email\VariableResolver`) używany przez wysyłkę e-mail i SMS.
|
|
- Dropdown w zakładce SMS na szczegółach zamówienia — wybór szablonu wstawia rozwiniętą treść do `<textarea>`.
|
|
- Auto-stopka SMSPLANET (`default_footer`) doklejana dalej tylko przez `SmsConversationService` — szablon body NIE zawiera stopki.
|
|
</objective>
|
|
|
|
<context>
|
|
<clarifications>
|
|
- **Pola szablonu** — Jakie pola powinien mieć szablon SMS?
|
|
→ Odpowiedź: Nazwa + treść + is_active (minimalnie). Bez subject/mailbox_id/attachment, bez duplikacji, bez sort_order.
|
|
- **Zmienne** — Czy szablony SMS mają używać tego samego systemu zmiennych co email?
|
|
→ Odpowiedź: Tak — reuse VariableResolver z Email (wydzielić warstwę wspólną; Email\VariableResolver pozostaje aliasem-fasadą dla wstecznej zgodności).
|
|
- **UX wstawiania** — Jak operator ma używać szablonu w zakładce SMS?
|
|
→ Odpowiedź: Dropdown 'Wybierz szablon' nad textarea — wstawia treść z rozwiniętymi zmiennymi dla danego zamówienia. Operator może dalej edytować przed wysyłką.
|
|
- **Stopka** — Czy w treści szablonu trzymać stopkę (default_footer SMSPLANET)?
|
|
→ Odpowiedź: Nie — szablon zawiera tylko body; stopka jest doklejana automatycznie przez `SmsConversationService::buildFinalOutboundBody()` (Phase 122). Walidacja 918 znaków obowiązuje na finalnej treści ze stopką.
|
|
</clarifications>
|
|
|
|
## Project Context
|
|
@.paul/PROJECT.md
|
|
@.paul/ROADMAP.md
|
|
@.paul/STATE.md
|
|
@.paul/codebase/architecture.md
|
|
@.paul/codebase/db_schema.md
|
|
|
|
## Prior Work
|
|
- Phase 14 (`email_templates` CRUD + Quill) — wzorzec UI i kontraktu repo.
|
|
- Phase 117 (`SMSPLANET integration`) — globalna konfiguracja, `SmsplanetApiClient`.
|
|
- Phase 121 (SMS conversation) — `SmsConversationService::sendFromOrder()`, `sms_messages`, zakładka SMS na `/orders/{id}`.
|
|
- Phase 122 (default footer) — `default_footer` doklejany w `buildFinalOutboundBody()`; walidacja 918 znaków na FINALNEJ treści.
|
|
|
|
## Source Files (do przejrzenia przed implementacją)
|
|
@src/Modules/Settings/EmailTemplateRepository.php
|
|
@src/Modules/Settings/EmailTemplateController.php
|
|
@src/Modules/Email/VariableResolver.php
|
|
@src/Modules/Sms/SmsConversationService.php
|
|
@src/Modules/Orders/OrdersController.php
|
|
@resources/views/settings/email-templates.php
|
|
@resources/views/settings/email-templates-form.php
|
|
@resources/views/orders/show.php
|
|
@routes/web.php
|
|
</context>
|
|
|
|
<acceptance_criteria>
|
|
|
|
## AC-1: CRUD szablonów SMS
|
|
```gherkin
|
|
Given operator jest zalogowany
|
|
When wchodzi na `/settings/sms-templates`
|
|
Then widzi listę szablonów (kolumny: Nazwa, Treść skrócona, Status, Akcje [Edytuj/Aktywuj-Dezaktywuj/Usuń])
|
|
And może utworzyć nowy szablon (`/settings/sms-templates/create`) podając: Nazwa, Treść (textarea), aktywny (checkbox)
|
|
And formularz pokazuje paletę zmiennych `{{zamowienie.numer}}`, `{{kupujacy.imie_nazwisko}}`, `{{przesylka.numer}}` itd. — kliknięcie wkleja placeholder w pozycji kursora
|
|
And zapis trafia do tabeli `sms_templates` z `body` (TEXT NOT NULL), `name` (VARCHAR(200)), `is_active` (TINYINT(1) DEFAULT 1)
|
|
```
|
|
|
|
## AC-2: Walidacja zapisu szablonu
|
|
```gherkin
|
|
Given operator tworzy szablon SMS
|
|
When `name` jest pusty albo `body` jest pusty
|
|
Then formularz zwraca błąd walidacji (Flash danger) i nie tworzy rekordu w DB
|
|
And po sukcesie zapisu Flash success "Szablon SMS zapisany" + redirect na listę
|
|
```
|
|
|
|
## AC-3: Wspólny VariableResolver (refaktor)
|
|
```gherkin
|
|
Given istnieje `App\Modules\Email\VariableResolver` używany przez `EmailSendingService`
|
|
When refaktoryzuję wspólną logikę zmiennych do `App\Modules\Sms\SmsVariableResolver` (lub nadrzędnego namespace)
|
|
Then `Email\VariableResolver` przekierowuje do nowej klasy (kompozycja albo extends jeśli klasa nie była `final`; obecna jest `final` → preferowana kompozycja z forwardingiem `buildVariableMap`/`resolve`)
|
|
And `SmsConversationService` otrzymuje konstruktorowo `SmsVariableResolver` i ma nową metodę `renderTemplate(int $orderId, string $body): string` która zwraca treść z rozwiniętymi zmiennymi
|
|
And żaden istniejący test/feature emaila się nie psuje (smoke: wysyłka e-mail z zamówienia dalej rozwiązuje zmienne)
|
|
```
|
|
|
|
## AC-4: Wstawianie szablonu w zakładce SMS
|
|
```gherkin
|
|
Given operator otwiera `/orders/{id}?tab=sms` z istniejącymi aktywnymi szablonami SMS
|
|
When widzi nad `<textarea name="message">` element `<select name="template_id">` z opcjami: "— Wybierz szablon —" + aktywne szablony (sort po nazwie)
|
|
And wybiera szablon "Numer śledzenia"
|
|
Then JS wykonuje `GET /orders/{id}/sms/template/{templateId}` (lub `?template_id=N`) i otrzymuje JSON `{body: "Twój numer śledzenia to ABC12345"}` z rozwiniętymi zmiennymi dla tego zamówienia
|
|
And treść trafia do `<textarea>` (overwrite jeśli pusta; przy niepustej → confirm przez `window.OrderProAlerts.confirm` z opcjami `{title, message, onConfirm, danger:false}`)
|
|
And operator może dalej edytować treść przed wysyłką
|
|
```
|
|
|
|
## AC-5: Brak duplikacji stopki + walidacja długości
|
|
```gherkin
|
|
Given szablon SMS w bazie zawiera tylko body bez stopki
|
|
When operator wybiera szablon i wysyła SMS przez `/orders/{id}/sms/send`
|
|
Then `SmsConversationService::sendFromOrder()` dokleja `default_footer` jeden raz (jak teraz, Phase 122)
|
|
And walidacja `MAX_SMS_LENGTH = 918` obowiązuje na finalnej treści (body + stopka)
|
|
And rekord w `sms_messages.body` zawiera końcową treść (body + "\n\n" + stopka)
|
|
```
|
|
|
|
## AC-6: Menu / nawigacja
|
|
```gherkin
|
|
Given operator jest w sekcji Ustawienia
|
|
When otwiera sidebar Ustawień
|
|
Then widzi link "Szablony SMS" obok "Szablony e-mail" (sublink, `currentSettings === 'sms-templates'` aktywny stan)
|
|
And klik prowadzi na `/settings/sms-templates`
|
|
```
|
|
|
|
</acceptance_criteria>
|
|
|
|
<tasks>
|
|
|
|
<task type="auto">
|
|
<name>Task 1: Migracja + repozytorium SMS templates</name>
|
|
<files>database/migrations/20260512_000112_create_sms_templates.sql, src/Modules/Sms/SmsTemplateRepository.php, .paul/codebase/db_schema.md</files>
|
|
<action>
|
|
1. Migracja DDL: `CREATE TABLE sms_templates (id INT UNSIGNED PK AUTO_INCREMENT, name VARCHAR(200) NOT NULL, body TEXT NOT NULL, is_active TINYINT(1) NOT NULL DEFAULT 1, created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP, updated_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;` + INDEX `idx_sms_templates_active_name (is_active, name)`.
|
|
2. `SmsTemplateRepository` mirroruje `EmailTemplateRepository` ale BEZ subject/mailbox_id/attachment_1/duplicate: `listAll(): list<array>`, `listActive(): list<array>`, `findById(int): ?array`, `save(array): int`, `delete(int): void`, `toggleStatus(int): void` (przez `ToggleableRepositoryTrait::toggleActive('sms_templates', $id)`).
|
|
3. Wszystkie zapytania prepared statements (Medoo nie jest tu wymagane — repo używa PDO bezpośrednio, jak EmailTemplateRepository).
|
|
4. Zaktualizuj `.paul/codebase/db_schema.md` — sekcja "SMS / Notifications", dodaj `sms_templates` z pełną specyfikacją kolumn.
|
|
Avoid: dodawania `mailbox_id`/`subject`/`attachment_1` (decyzja: pola minimalne); używania `SELECT 1;` jako no-op (rule: zawsze DDL).
|
|
</action>
|
|
<verify>`php bin/migrate.php` przechodzi bez błędów; `DESCRIBE sms_templates` pokazuje 6 kolumn + 2 indexy (PK + idx_sms_templates_active_name); manualny INSERT/SELECT przez Medoo działa.</verify>
|
|
<done>AC-1 (schemat) + AC-2 (repo wspiera walidację — pusty name/body rzuca `RuntimeException`).</done>
|
|
</task>
|
|
|
|
<task type="auto">
|
|
<name>Task 2: Wspólny VariableResolver dla SMS</name>
|
|
<files>src/Modules/Sms/SmsVariableResolver.php, src/Modules/Email/VariableResolver.php, src/Modules/Sms/SmsConversationService.php, routes/web.php</files>
|
|
<action>
|
|
1. Utwórz `App\Modules\Sms\SmsVariableResolver` (final class) — przenieś logikę `buildVariableMap()` i `resolve()` z `Email\VariableResolver`. Konstruktor: `ShipmentPackageRepository $shipmentPackageRepository`. Public API:
|
|
- `buildVariableMap(array $order, array $addresses, array $companySettings): array<string,string>`
|
|
- `resolve(string $template, array $variableMap): string`
|
|
- NOWA: `renderForOrder(int $orderId, string $template, OrdersRepository $orders, CompanySettingsRepository $company): string` — fetcher: order + addresses + company → buildVariableMap → resolve. (Albo prościej: helper zewnętrzny w `SmsConversationService::renderTemplate()`.)
|
|
2. `Email\VariableResolver` staje się cienką fasadą: konstruktor przyjmuje `SmsVariableResolver` (lub samodzielnie tworzy), `buildVariableMap`/`resolve` deleguje 1:1. Zachowaj kontrakt publiczny (`EmailSendingService` nie wymaga zmian).
|
|
3. `SmsConversationService` dostaje dodatkowy konstruktor param `SmsVariableResolver` + nową publiczną metodę `renderTemplate(array $order, array $addresses, array $companySettings, string $body): string`. NIE zmieniaj kontraktu `sendFromOrder()` — pozostaje przyjmować już-rozwinięty `$body` (operator może edytować po wstawieniu, więc resolwowanie zmiennych odbywa się w controllerze przy fetchu szablonu, nie podczas wysyłki).
|
|
4. Wiring w `routes/web.php`: `$smsVariableResolver = new SmsVariableResolver($shipmentPackageRepository);` → przekaż do `EmailSendingService` (poprzez `Email\VariableResolver` lub bezpośrednio jeśli refaktorujesz `EmailSendingService`) i do `SmsConversationService`.
|
|
Avoid: kopiowania logiki zmiennych (DRY); zmiany istniejących publicznych metod `Email\VariableResolver` (mogą być w użyciu w testach/automation).
|
|
</action>
|
|
<verify>Manualny smoke test: `php -r "require 'bootstrap/app.php'; $resolver = ...; var_dump($resolver->resolve('Zam {{zamowienie.numer}}', ['zamowienie.numer' => 'OP1']));"` → "Zam OP1". Smoke wysyłki e-maila z zamówienia (zakładka Wiadomości) dalej rozwiązuje `{{kupujacy.imie_nazwisko}}` poprawnie.</verify>
|
|
<done>AC-3 satisfied: wspólny resolver, Email niezmieniony funkcjonalnie, SmsConversationService ma `renderTemplate()`.</done>
|
|
</task>
|
|
|
|
<task type="auto">
|
|
<name>Task 3: Controller + widoki + routy CRUD `/settings/sms-templates`</name>
|
|
<files>src/Modules/Settings/SmsTemplateController.php, resources/views/settings/sms-templates.php, resources/views/settings/sms-templates-form.php, resources/views/layouts/app.php, routes/web.php</files>
|
|
<action>
|
|
1. `SmsTemplateController` mirror `EmailTemplateController` (uproszczony — bez Quill, bez mailbox select, bez attachment): metody `index`, `create`, `edit`, `save`, `delete`, `toggleStatus`, `preview` (POST z `order_id` opcjonalnie do podglądu z rozwiniętymi zmiennymi — dla podglądu na formularzu), `getVariables` (GET zwraca JSON dostępnych zmiennych dla palety).
|
|
2. `VARIABLE_GROUPS` jako stała klasy — kopia z `EmailTemplateController::VARIABLE_GROUPS` ale BEZ `firma` (SMS-y nie używają nazwy firmy domyślnie; opcjonalnie zostaw — patrz odpowiedź pytania 2: pełny zestaw zmiennych). KOPIA pełna (wszystkie 5 grup) — operator decyduje czego używa.
|
|
3. `sms-templates.php` — lista (analog `email-templates.php`): tabela z kolumnami Nazwa | Treść (skrócona substr(0,80) + ellipsis) | Status | Akcje. Bez kolumny Skrzynka/Załącznik. Bez "Duplikuj".
|
|
4. `sms-templates-form.php` — analog `email-templates-form.php`:
|
|
- Pola: `name` (text), `body` (textarea, rows=6, maxlength=918), `is_active` (checkbox).
|
|
- Paleta zmiennych po prawej stronie — kliknięcie wstawia `{{group.var}}` w pozycji kursora w textarea (vanilla JS).
|
|
- Licznik znaków pod textarea (live update); ostrzega gdy >800 (margines na stopkę).
|
|
- Bez wyboru skrzynki, bez Quill, bez sekcji "Załącznik".
|
|
- Kolumna lewa: formularz; kolumna prawa: panel pomocy "Dostępne zmienne" + przykład podglądu (opcjonalny GET na pierwsze zamówienie z bazy).
|
|
5. Routy w `routes/web.php` (po blocku email-templates, ~linia 647):
|
|
```
|
|
$router->get('/settings/sms-templates', [$smsTemplateController, 'index'], [$authMiddleware]);
|
|
$router->get('/settings/sms-templates/create', [$smsTemplateController, 'create'], [$authMiddleware]);
|
|
$router->get('/settings/sms-templates/edit', [$smsTemplateController, 'edit'], [$authMiddleware]);
|
|
$router->post('/settings/sms-templates/save', [$smsTemplateController, 'save'], [$authMiddleware]);
|
|
$router->post('/settings/sms-templates/delete', [$smsTemplateController, 'delete'], [$authMiddleware]);
|
|
$router->post('/settings/sms-templates/toggle', [$smsTemplateController, 'toggleStatus'], [$authMiddleware]);
|
|
$router->get('/settings/sms-templates/variables', [$smsTemplateController, 'getVariables'], [$authMiddleware]);
|
|
```
|
|
6. Wiring DI w `routes/web.php`: `$smsTemplateRepository = new SmsTemplateRepository($app->db()); $smsTemplateController = new SmsTemplateController($template, $translator, $auth, $smsTemplateRepository);`
|
|
7. Sidebar w `layouts/app.php` (~linia 121): dodaj `sublink` "Szablony SMS" → `/settings/sms-templates`, aktywny gdy `$currentSettings === 'sms-templates'`. Przekaż `$currentSettings` z `SmsTemplateController` jako lokal w renderze.
|
|
8. Confirm-delete: użyj globalnego `confirm-delete.js` (Phase 114) — markery `js-confirm-delete` na `<form>`.
|
|
Avoid: pisania własnego modal confirm (jest globalny z `data-confirm-bound='1'` guard); inline CSS w widokach (rule projektu — wszystko SCSS).
|
|
</action>
|
|
<verify>Manualny smoke: `/settings/sms-templates` zwraca 200, lista pusta z CTA "Dodaj szablon". Tworzysz "Test SMS" z body "Witaj {{kupujacy.imie_nazwisko}}, nr {{zamowienie.numer}}", is_active=1. Zapisuje się w `sms_templates`. Edycja działa. Toggle (AJAX) zmienia status bez reload. Usuń pokazuje confirm OrderProAlerts.</verify>
|
|
<done>AC-1, AC-2, AC-6 satisfied.</done>
|
|
</task>
|
|
|
|
<task type="auto">
|
|
<name>Task 4: Dropdown szablonów w zakładce SMS + endpoint fetch</name>
|
|
<files>src/Modules/Orders/OrdersController.php, resources/views/orders/show.php, public/assets/js/modules/sms-template-picker.js, resources/lang/pl/orders.php, routes/web.php</files>
|
|
<action>
|
|
1. `OrdersController::__construct` rozszerz o parametry: `SmsTemplateRepository $smsTemplateRepository`, `SmsVariableResolver $smsVariableResolver`, `CompanySettingsRepository $companySettingsRepository` (jeśli nie jest jeszcze wstrzyknięty — sprawdź; jeśli `EmailSendingService` go używa, controller już może go mieć przekazany pośrednio). Dodaj nowe metody:
|
|
- `smsTemplate(Request)`: handler dla `GET /orders/{id}/sms/template?template_id=N`. Sprawdź uprawnienia (authMiddleware już chroni). Fetch order + addresses + company → `SmsVariableResolver::buildVariableMap()` → `resolve()` na `body` szablonu → zwróć JSON `{ok:true, body: "..."}` lub `{ok:false, error: "..."}` (404 gdy template/order nie istnieje).
|
|
- Method action `index` (renderShowOrder) — przekaż do widoku `$smsTemplates = $smsTemplateRepository->listActive();`.
|
|
2. W `routes/web.php` (po `/orders/{id}/sms/send`, ~linia 556):
|
|
```
|
|
$router->get('/orders/{id}/sms/template', [$ordersController, 'smsTemplate'], [$authMiddleware]);
|
|
```
|
|
Zaktualizuj wiring `$ordersController = new OrdersController(...)` — dodaj 3 nowe trailing params (`$smsTemplateRepository`, `$smsVariableResolver`, ewentualnie `$companySettingsRepository` jeśli nie jest tam już).
|
|
3. `resources/views/orders/show.php` — sekcja SMS form (~linia 1017-1033):
|
|
- Nad `<label class="form-field">` z textarea wstaw `<label class="form-field">` z `<select data-sms-template-picker data-order-id="<?= $orderId ?>">` z opcją domyślną i pętlą po `$smsTemplates`:
|
|
```html
|
|
<option value="">— Wybierz szablon —</option>
|
|
<?php foreach ($smsTemplates as $tpl): ?>
|
|
<option value="<?= (int) $tpl['id'] ?>"><?= $e((string) $tpl['name']) ?></option>
|
|
<?php endforeach; ?>
|
|
```
|
|
- Dodaj atrybut `data-sms-message-target` na textarea aby JS go odnalazł.
|
|
4. `public/assets/js/modules/sms-template-picker.js` — vanilla JS, idempotent guard `window.__smsTemplatePickerBound`. Na `change` selecta:
|
|
- Pobierz `data-order-id` + wybrany `template_id`.
|
|
- Fetch `GET /orders/{orderId}/sms/template?template_id={id}`.
|
|
- Jeśli textarea pusta → wstaw body bezpośrednio.
|
|
- Jeśli textarea ma treść → `window.OrderProAlerts.confirm({title:'Zamiana treści', message:'Tekst w polu zostanie nadpisany. Kontynuować?', onConfirm: () => textarea.value = body, danger: false})`.
|
|
- Reset selecta do "" po wstawieniu/anulowaniu.
|
|
- Po wstawieniu fire `input` event aby ewentualny licznik znaków się zaktualizował.
|
|
5. Załaduj skrypt globalnie w `layouts/app.php` (po istniejących modułach).
|
|
6. `resources/lang/pl/orders.php` — dodaj klucz `details.sms.template_picker = 'Wybierz szablon'` i `details.sms.template_picker_placeholder = '— Wybierz szablon —'`.
|
|
Avoid: AJAX-em wysyłania zamiast wstawiania (decyzja UX: edytowalny preview); pomijania confirm gdy textarea ma treść (utrata pracy operatora); używania `alert()`/`confirm()` natywnych.
|
|
</action>
|
|
<verify>Manualny smoke na `/orders/{id}?tab=sms`: dropdown widoczny, opcje aktywnych szablonów. Wybierz "Test SMS" → textarea wypełnia się `"Witaj Jan Kowalski, nr OP000001234"`. Z niepustą textarea pojawia się OrderProAlerts confirm. Po wstawieniu wysyłka SMS (`/orders/{id}/sms/send`) działa jak wcześniej, stopka SMSPLANET doklejona raz (sprawdź `sms_messages.body` ostatniego rekordu).</verify>
|
|
<done>AC-4, AC-5 satisfied.</done>
|
|
</task>
|
|
|
|
<task type="auto">
|
|
<name>Task 5: Aktualizacja dokumentacji codebase</name>
|
|
<files>.paul/codebase/architecture.md, .paul/codebase/tech_changelog.md, .paul/codebase/db_schema.md</files>
|
|
<action>
|
|
1. `architecture.md` — nowa sekcja "## Phase 124 — SMS Templates" opisująca: `SmsTemplateRepository`, `SmsTemplateController` (mirror EmailTemplate bez subject/mailbox/attachment), `SmsVariableResolver` (wydzielony z Email\VariableResolver — wspólna logika zmiennych), endpoint `GET /orders/{id}/sms/template`, JS `sms-template-picker.js`. Zaktualizuj inwentaryzację modułów `Sms` (3 → 5 plików: dodaj `SmsTemplateRepository`, `SmsVariableResolver`).
|
|
2. `tech_changelog.md` — wpis chronologiczny: data 2026-05-12 (lub data wdrożenia), opis "Phase 124: szablony SMS — CRUD `/settings/sms-templates`, wspólny resolver zmiennych z e-mail, dropdown wstawiania szablonu w zakładce SMS na `/orders/{id}`".
|
|
3. `db_schema.md` — finalizuj sekcję `sms_templates` (jeśli niedodana w Task 1) oraz zwiększ Total tables o 1.
|
|
Avoid: duplikowania opisu modułu w `architecture.md` z PROJECT.md (PROJECT trzyma `Validated (Shipped)` listę — dodać tam jedną pozycję bullet).
|
|
</action>
|
|
<verify>`grep -i 'sms_templates' .paul/codebase/*.md` zwraca trafienia w db_schema.md i architecture.md. `git diff --stat .paul/codebase/` pokazuje 3 zmienione pliki.</verify>
|
|
<done>Dokumentacja zsynchronizowana — wymóg CLAUDE.md "Przy kazdej nowej funkcji ... zaktualizuj odpowiednie sekcje".</done>
|
|
</task>
|
|
|
|
</tasks>
|
|
|
|
<boundaries>
|
|
|
|
## DO NOT CHANGE
|
|
- `EmailSendingService` — kontrakt publiczny i konstruktor pozostają niezmienione (Email\VariableResolver delegate-only).
|
|
- `SmsConversationService::sendFromOrder()` — body otrzymywane od controllera już rozwinięte; nie dodawaj drugiego przejścia rozwijającego zmienne (uniknij podwójnego escape'u dla treści edytowanej przez operatora).
|
|
- `SmsConversationService::buildFinalOutboundBody()` — stopka SMSPLANET doklejana dokładnie raz (Phase 122).
|
|
- `automation_rules` / `automation_actions` — szablony SMS nie integrują się jeszcze z automatyzacją (deferred do osobnej fazy: `automation_action_type='send_sms'`).
|
|
- `sms_messages` schema — bez zmian; szablon nie wpływa na strukturę wiadomości po wysłaniu.
|
|
- Phase 121 webhook `/webhooks/smsplanet/inbound` — bez zmian.
|
|
|
|
## SCOPE LIMITS
|
|
- Brak akcji automatyzacji `send_sms` (osobna faza, kandydat z ROADMAP).
|
|
- Brak duplikacji szablonu (różnica vs email — UX prostsze, operator tworzy nowy ręcznie jeśli potrzebuje).
|
|
- Brak sort_order / kategorii / tagów (decyzja: minimalne pola).
|
|
- Brak HostedSMS — moduł szablonów jest provider-agnostyczny, ale wysyłka idzie przez SmsConversationService (SMSPLANET). HostedSMS w ogóle nie jest podpięty do `/orders/{id}/sms/send` na ten moment.
|
|
- Brak Quill/WYSIWYG — textarea (SMS to plain text).
|
|
- Brak walidacji długości w bazie ponad VARCHAR/TEXT — walidacja 918 obowiązuje na finalnej treści w `SmsConversationService` (Phase 122).
|
|
- Brak migracji do alembica / fixturek seedowych — operator tworzy swoje szablony ręcznie.
|
|
|
|
</boundaries>
|
|
|
|
<verification>
|
|
Before declaring plan complete:
|
|
- [ ] `php bin/migrate.php` przechodzi (migracja 20260512_000112).
|
|
- [ ] `php -l src/Modules/Sms/SmsTemplateRepository.php src/Modules/Sms/SmsVariableResolver.php src/Modules/Settings/SmsTemplateController.php src/Modules/Email/VariableResolver.php src/Modules/Sms/SmsConversationService.php src/Modules/Orders/OrdersController.php routes/web.php` — wszystkie No syntax errors.
|
|
- [ ] `/settings/sms-templates` lista + create + edit + toggle + delete działają (manualny smoke).
|
|
- [ ] `/settings/email-templates` flow wysyłki e-mail z zamówienia dalej działa (regression test).
|
|
- [ ] `/orders/{id}?tab=sms`: dropdown szablonów wstawia rozwinięte zmienne; confirm OrderProAlerts przy niepustej textarea; wysyłka SMS dokleja stopkę raz.
|
|
- [ ] Sidebar Ustawień ma podkreślenie aktywne na `/settings/sms-templates`.
|
|
- [ ] `.paul/codebase/db_schema.md`, `architecture.md`, `tech_changelog.md` zaktualizowane.
|
|
</verification>
|
|
|
|
<success_criteria>
|
|
- Wszystkie zadania (1-5) ukończone, AC-1..AC-6 zaspokojone.
|
|
- Brak regresji w wysyłce e-mail (VariableResolver refaktor zachowuje kontrakt).
|
|
- Brak duplikacji stopki w wysłanych SMS-ach (Phase 122 contract preserved).
|
|
- Zero `alert()` / `confirm()` natywnych — wyłącznie `window.OrderProAlerts.confirm({...})` options-object API.
|
|
- Zero inline CSS w widokach — style w SCSS jeśli wymagane (najpewniej reuse istniejących `.form-field`, `.form-control`, `.btn`).
|
|
- Brak zmian w `automation_*` (akcja `send_sms` poza zakresem).
|
|
</success_criteria>
|
|
|
|
<output>
|
|
After completion, create `.paul/phases/124-sms-templates/124-01-SUMMARY.md` opisujący:
|
|
- Zmienione pliki i krótki opis każdego.
|
|
- Nowe routy.
|
|
- Schema diff (`sms_templates`).
|
|
- Wszelkie odchylenia od planu i decyzje implementacyjne.
|
|
- Pending manual smoke tests (jeśli XAMPP niedostępny w trakcie APPLY).
|
|
</output>
|