update

2026-03-30 20:23:38 +02:00
parent 70662afd2c
commit 5435209b08
26 changed files with 1949 additions and 160 deletions
--- a/.paul/ROADMAP.md
+++ b/.paul/ROADMAP.md
@@ -16,6 +16,7 @@ Wersja mobilna aplikacji, modul po module. Cel: pelna uzywalnosc orderPRO na tel
 | 53 | Mobile Status Panel Toggle | 1/1 | Complete |
 | 54 | Order Detail Image Hover | 1/1 | Complete |
 | 55 | Desktop Collapsed Sidebar Fix | 1/1 | Complete |
+| 56 | Order Payments | 0/1 | Planning |
 | TBD | Mobile Orders List | - | Not started |
 | TBD | Mobile Order Details | - | Not started |
 | TBD | Mobile Settings | - | Not started |
--- a/.paul/STATE.md
+++ b/.paul/STATE.md
@@ -5,34 +5,34 @@
 See: .paul/PROJECT.md (updated 2026-03-28)

 **Core value:** Sprzedawca moze obslugiwac zamowienia ze wszystkich kanalow sprzedazy i nadawac przesylki bez przelaczania sie miedzy platformami.
-**Current focus:** Milestone v3.0 Mobile Responsive — Phase 52 (Mobile Main Menu) planning
+**Current focus:** Milestone v3.0 Mobile Responsive — Phase 56 (Order Payments) planning

 ## Current Position

 Milestone: v3.0 Mobile Responsive — In progress
-Phase: 4 of N (55 - Desktop Collapsed Sidebar Fix) — Complete
-Plan: 55-01 complete
-Status: Loop complete — phase 55 done, ready for next PLAN
-Last activity: 2026-03-29 — UNIFY closed for 55-01
+Phase: 5 of N (56 - Order Payments) — Planning
+Plan: 56-01 created, awaiting approval
+Status: PLAN created, ready for APPLY
+Last activity: 2026-03-30 — Created .paul/phases/56-order-payments/56-01-PLAN.md

 Progress:
 - Milestone: [####░░░░░░] ~40%
- Phase 55: [##########] 100%
+- Phase 56: [░░░░░░░░░░] 0%

 ## Loop Position

 Current loop state:
 ```
 PLAN ──▶ APPLY ──▶ UNIFY
-  ✓        ✓        ✓     [Loop complete - ready for next PLAN]
+  ✓        ○        ○     [Plan created, awaiting approval]
 ```

 ## Session Continuity

-Last session: 2026-03-29
-Stopped at: Phase 55 complete
-Next action: /paul:plan dla kolejnego modulu
-Resume file: .paul/phases/55-desktop-collapsed-sidebar-fix/55-01-SUMMARY.md
+Last session: 2026-03-30
+Stopped at: Plan 56-01 created
+Next action: Review and approve plan, then run /paul:apply .paul/phases/56-order-payments/56-01-PLAN.md
+Resume file: .paul/phases/56-order-payments/56-01-PLAN.md

 ## Accumulated Context

@@ -41,9 +41,10 @@ Resume file: .paul/phases/55-desktop-collapsed-sidebar-fix/55-01-SUMMARY.md
 |------|----------|--------|
 | 2026-03-29 | Mobile menu jako slide-in overlay (nie horizontal scroll) | Pelna nawigacja na mobile bez kompromisow |
 | 2026-03-29 | Hamburger w topbarze, sidebar fixed z transform slide | Plynna animacja CSS, zero zaleznosci JS |
+| 2026-03-30 | Push set_paid do shopPRO API po dodaniu platnosci w orderPRO | Synchronizacja statusu platnosci bez dodatkowego endpointu w shopPRO |

 ## Git State

-Last commit: cbc2058
+Last commit: 70662af
 Branch: main
 Feature branches merged: none
--- a/.paul/phases/56-order-payments/56-01-PLAN.md
+++ b/.paul/phases/56-order-payments/56-01-PLAN.md
@@ -0,0 +1,248 @@
+---
+phase: 56-order-payments
+plan: 01
+type: execute
+wave: 1
+depends_on: []
+files_modified:
+  - database/migrations/20260330_000073_create_order_payments_table.sql
+  - src/Modules/Orders/OrdersController.php
+  - src/Modules/Orders/OrdersRepository.php
+  - src/Modules/Settings/ShopproApiClient.php
+  - resources/views/orders/show.php
+  - resources/lang/pl.php
+  - resources/scss/modules/_order-details.scss
+  - public/assets/css/app.css
+  - routes/web.php
+  - DOCS/DB_SCHEMA.md
+  - DOCS/ARCHITECTURE.md
+  - DOCS/TECH_CHANGELOG.md
+autonomous: false
+---
+
+<objective>
+## Goal
+Uruchomienie funkcji dodawania platnosci do zamowienia z poziomu zakladki Platnosci w widoku zamowienia. Po dodaniu platnosci — automatyczny push statusu platnosci do shopPRO API (dla zamowien source=shoppro).
+
+## Purpose
+Sprzedawca moze oznaczyc zamowienie jako oplacone bezposrednio z orderPRO i ta informacja jest synchronizowana do sklepu shopPRO.
+
+## Output
+- Tabela `order_payments` w bazie (migracja)
+- Formularz dodawania platnosci w zakladce Platnosci
+- Endpoint POST `/orders/{id}/payment/add`
+- Push `set_paid` do shopPRO API po dodaniu platnosci (source=shoppro)
+</objective>
+
+<context>
+## Project Context
+@.paul/PROJECT.md
+@.paul/ROADMAP.md
+@.paul/STATE.md
+
+## Source Files
+@database/drafts/20260302_orders_schema_v1.sql (linie 102-121 — draft schemat order_payments)
+@src/Modules/Orders/OrdersController.php
+@src/Modules/Orders/OrdersRepository.php (loadOrderPayments, findDetails)
+@src/Modules/Orders/OrderImportRepository.php (replacePayments)
+@src/Modules/Settings/ShopproPaymentStatusSyncService.php (wzorzec update + push)
+@src/Modules/Settings/ShopproApiClient.php (requestJsonPut)
+@src/Modules/Settings/ShopproIntegrationsRepository.php
+@resources/views/orders/show.php (zakladka Platnosci linie 559-648)
+@routes/web.php (pattern: /orders/{id}/...)
+</context>
+
+<acceptance_criteria>
+
+## AC-1: Tabela order_payments istnieje w bazie
+```gherkin
+Given migracja 20260330_000073 zostala uruchomiona
+When wykonam SHOW CREATE TABLE order_payments
+Then tabela zawiera kolumny: id, order_id, source_payment_id, external_payment_id, payment_type_id, payment_date, amount, currency, comment, payload_json, created_at, updated_at
+And istnieje FK na orders(id) z ON DELETE CASCADE
+```
+
+## AC-2: Formularz dodawania platnosci w zakladce Platnosci
+```gherkin
+Given otwieram zamowienie /orders/130
+When klikam zakladke Platnosci
+Then widze przycisk "Dodaj platnosc" nad tabela platnosci
+And po kliknieciu pojawia sie formularz inline z polami: kwota, typ platnosci (select), data platnosci, komentarz
+And formularz zawiera przyciski Zapisz i Anuluj
+```
+
+## AC-3: Zapis platnosci przez AJAX
+```gherkin
+Given wypelniam formularz platnosci (kwota, typ, data)
+When klikam Zapisz
+Then platnosc jest zapisana w tabeli order_payments
+And kolumny orders.payment_status i orders.total_paid sa zaktualizowane
+And zakladka Platnosci odswieza sie z nowa platnoscia na liscie
+And pojawia sie komunikat sukcesu
+```
+
+## AC-4: Push set_paid do shopPRO po dodaniu platnosci
+```gherkin
+Given zamowienie ma source=shoppro i polaczona integracje
+When dodaje platnosc pokrywajaca pelna kwote zamowienia
+Then orderPRO wywoluje PUT shopPRO API /api.php?endpoint=orders&action=set_paid&id={source_order_id}
+And w activity_log zapisuje informacje o pushu
+```
+
+## AC-5: Walidacja formularza
+```gherkin
+Given otwieram formularz dodawania platnosci
+When probuje zapisac bez kwoty lub z kwota <= 0
+Then formularz nie jest wysylany i pojawia sie komunikat bledu walidacji
+```
+
+</acceptance_criteria>
+
+<tasks>
+
+<task type="auto">
+  <name>Task 1: Migracja order_payments + update orders columns</name>
+  <files>database/migrations/20260330_000073_create_order_payments_table.sql, DOCS/DB_SCHEMA.md</files>
+  <action>
+    Utworz migracje tworzaca tabele order_payments na podstawie draftu (database/drafts/20260302_orders_schema_v1.sql linie 102-121).
+    Uzyj CREATE TABLE IF NOT EXISTS — migracja idempotentna.
+    Schemat: id, order_id, source_payment_id, external_payment_id, payment_type_id, payment_date, amount, currency, comment, payload_json, created_at, updated_at.
+    Indexy: UNIQUE (order_id, source_payment_id), INDEX (order_id), INDEX (payment_date).
+    FK: order_payments_order_fk -> orders(id) ON DELETE CASCADE ON UPDATE CASCADE.
+
+    Sprawdz tez czy kolumny payment_status, total_paid, external_payment_type_id istnieja w tabeli orders. Jezeli nie — dodaj ALTER TABLE (idempotentnie przez IF NOT EXISTS pattern z prepared statements).
+
+    Zaktualizuj DOCS/DB_SCHEMA.md o nowa tabele.
+  </action>
+  <verify>Uruchom migracje na serwerze: sprawdz SHOW CREATE TABLE order_payments</verify>
+  <done>AC-1 satisfied: tabela order_payments istnieje z poprawnym schematem</done>
+</task>
+
+<task type="auto">
+  <name>Task 2: Backend — endpoint dodawania platnosci + push do shopPRO</name>
+  <files>src/Modules/Orders/OrdersController.php, src/Modules/Orders/OrdersRepository.php, src/Modules/Settings/ShopproApiClient.php, routes/web.php, resources/lang/pl.php, DOCS/ARCHITECTURE.md</files>
+  <action>
+    1. W routes/web.php dodaj route:
+       POST /orders/{id}/payment/add -> OrdersController->addPayment
+
+    2. W OrdersRepository dodaj metode addPayment(int $orderId, array $data): int
+       - INSERT INTO order_payments (order_id, payment_type_id, payment_date, amount, currency, comment)
+       - Przelicz total_paid: SELECT SUM(amount) FROM order_payments WHERE order_id
+       - UPDATE orders SET total_paid = sum, payment_status = (2 jesli sum >= total_with_tax, 1 jesli sum > 0, 0 jesli sum = 0)
+       - Zwroc nowy payment ID
+
+    3. W OrdersController dodaj metode addPayment(Request $request): Response
+       - Walidacja: orderId > 0, amount > 0, payment_type_id niepusty
+       - CSRF token
+       - Wywolaj OrdersRepository::addPayment()
+       - Jezeli zamowienie ma source=shoppro i payment_status stalo sie 2 (oplacone):
+         - Pobierz dane integracji (integration_id z zamowienia)
+         - Wywolaj ShopproApiClient::pushPaymentPaid() do set_paid
+         - Zaloguj w activity_log
+       - Return JSON response {ok, payment, payment_status, total_paid}
+
+    4. W ShopproApiClient dodaj metode pushPaymentPaid(string $baseUrl, string $apiKey, int $timeout, string $sourceOrderId): array
+       - PUT {baseUrl}/api.php?endpoint=orders&action=set_paid&id={sourceOrderId}
+       - Body: {"send_email": 0}
+       - Uzyj istniejacego requestJsonPut()
+
+    5. Zaktualizuj resources/lang/pl.php o klucze bledow/komunikatow platnosci.
+
+    6. Zaktualizuj DOCS/ARCHITECTURE.md.
+  </action>
+  <verify>
+    curl -X POST /orders/130/payment/add z danymi platnosci — odpowiedz 200 z JSON
+  </verify>
+  <done>AC-3, AC-4, AC-5 satisfied: platnosc zapisywana, push do shopPRO, walidacja</done>
+</task>
+
+<task type="auto">
+  <name>Task 3: Frontend — formularz platnosci w zakladce + AJAX</name>
+  <files>resources/views/orders/show.php, resources/scss/modules/_order-details.scss, public/assets/css/app.css</files>
+  <action>
+    1. W show.php, w sekcji data-order-tab-panel="payments" (linia ~606):
+       - Dodaj przycisk "Dodaj platnosc" (klasa btn btn--sm btn--primary) nad tabela/komunikatem "Brak platnosci"
+       - Po kliknieciu — pokaz formularz inline (ukryty domyslnie):
+         - Kwota (input number, step=0.01, required) — domyslna: total_with_tax - total_paid
+         - Typ platnosci (select: ONLINE, TRANSFER, CASH_ON_DELIVERY)
+         - Data platnosci (input date, domyslna: dzisiaj)
+         - Komentarz (input text, opcjonalny)
+         - Przyciski: Zapisz (submit AJAX), Anuluj (ukryj formularz)
+
+    2. JavaScript na dole widoku (pattern jak inne formularze AJAX w tym pliku):
+       - POST /orders/{orderId}/payment/add
+       - Wysylaj JSON: {amount, payment_type_id, payment_date, comment, _token}
+       - On success: window.location.reload() dla odswiezenia karty
+       - On error: pokaz blad przez OrderProAlerts.error()
+
+    3. Style w _order-details.scss:
+       - .payment-add-form — kompaktowy formularz inline
+       - .payment-add-form__row — flex row z gap
+       - Responsywnosc (na mobile kolumny zawijaja sie)
+
+    4. Zbuduj SCSS: npm run build (lub sass compile)
+  </action>
+  <verify>
+    Otworz /orders/130, kliknij Platnosci, kliknij "Dodaj platnosc", wypelnij formularz, zapisz — platnosc pojawia sie na liscie
+  </verify>
+  <done>AC-2, AC-3 satisfied: formularz widoczny, zapis dziala, lista odswieza sie</done>
+</task>
+
+<task type="checkpoint:human-verify" gate="blocking">
+  <what-built>Formularz dodawania platnosci + push do shopPRO</what-built>
+  <how-to-verify>
+    1. Otworz: https://orderpro.projectpro.pl/orders/130
+    2. Kliknij zakladke "Platnosci"
+    3. Kliknij "Dodaj platnosc"
+    4. Wypelnij kwote (np. 100.00), wybierz typ "Platnosc online", data dzisiejsza
+    5. Kliknij "Zapisz"
+    6. Sprawdz: platnosc pojawia sie w tabeli, status platnosci zaktualizowal sie
+    7. Sprawdz shopPRO: czy zamowienie zostalo oznaczone jako oplacone
+    8. Sprobuj dodac platnosc z kwota 0 — powinien byc blad walidacji
+  </how-to-verify>
+  <resume-signal>Type "approved" to continue, or describe issues to fix</resume-signal>
+</task>
+
+</tasks>
+
+<boundaries>
+
+## DO NOT CHANGE
+- src/Modules/Settings/ShopproPaymentStatusSyncService.php (istniejacy cron sync — nie modyfikowac)
+- src/Modules/Orders/OrderImportRepository.php (import platnosci z API — nie modyfikowac)
+- database/migrations/ istniejace migracje (nie modyfikowac)
+- src/Modules/Cron/* (nie modyfikowac handlerow crona)
+
+## SCOPE LIMITS
+- Tylko dodawanie platnosci — nie edycja ani usuwanie
+- Nie implementujemy zwrotow (refunds)
+- Push do shopPRO tylko przez istniejace API set_paid — nie dodajemy nowego endpointu w shopPRO
+- Nie modyfikujemy synchronizacji platnosci Allegro
+- Nie dodajemy nowych cron jobow
+
+</boundaries>
+
+<verification>
+Before declaring plan complete:
+- [ ] Migracja uruchomiona — tabela order_payments istnieje
+- [ ] POST /orders/{id}/payment/add zwraca 200 z poprawnymi danymi
+- [ ] Formularz w UI wyswietla sie poprawnie
+- [ ] Platnosc zapisana w order_payments
+- [ ] orders.payment_status i total_paid zaktualizowane
+- [ ] Push set_paid do shopPRO (source=shoppro) dziala
+- [ ] Walidacja formularza — kwota > 0, typ niepusty
+- [ ] DOCS zaktualizowane
+- [ ] SCSS zbudowany do CSS
+</verification>
+
+<success_criteria>
+- Wszystkie taski ukonczone
+- Wszystkie AC spelnione
+- Platnosc dodana z UI pojawia sie w zakladce Platnosci
+- shopPRO otrzymuje informacje o oplaceniu
+- Brak bledow PHP/JS w konsoli
+</success_criteria>
+
+<output>
+After completion, create `.paul/phases/56-order-payments/56-01-SUMMARY.md`
+</output>