orderPRO/.paul/phases/72-per-page-persistence/72-01-PLAN.md

phase, plan, type, wave, depends_on, files_modified, autonomous

phase	plan	type	wave	depends_on	files_modified	autonomous
72-per-page-persistence	01	execute	1		resources/views/components/table-list.php	true

## Goal Zapamiętywanie wybranej liczby wierszy na stronie (per_page) w localStorage przeglądarki na liście zamówień i innych listach korzystających z komponentu table-list.

Purpose

Użytkownik zmienia per_page na 50 lub 100, ale po powrocie na listę wartość resetuje się do domyślnej 20. Zmiana powinna być trwała w danej przeglądarce.

Output

Zmodyfikowany resources/views/components/table-list.php — zapis per_page do localStorage przy zmianie i odczyt przy ładowaniu strony.

## Source Files @resources/views/components/table-list.php (linie 311-325 per-page selector, 329-432 localStorage, 428-432 change handler)

<acceptance_criteria>

AC-1: Zapis per_page do localStorage

Given użytkownik jest na liście zamówień z per_page=20
When zmieni per_page na 50
Then wartość 50 zostaje zapisana w localStorage pod kluczem tableList_[basePath]_[listKey]_per_page

AC-2: Odczyt per_page z localStorage

Given użytkownik wcześniej wybrał per_page=50 (zapisane w localStorage)
When wchodzi na listę zamówień bez parametru per_page w URL
Then formularz per_page automatycznie ustawia 50 i strona przeładowuje się z per_page=50

AC-3: Parametr URL ma priorytet nad localStorage

Given użytkownik ma per_page=50 w localStorage
When wchodzi na listę z jawnym per_page=20 w URL
Then wyświetla 20 rekordów (URL ma priorytet) i localStorage zostaje zaktualizowane na 20

AC-4: Brak pętli przeładowań

Given użytkownik ma per_page=50 w localStorage i wchodzi na stronę
When strona przeładowuje się z per_page=50
Then nie następuje kolejne przeładowanie (brak nieskończonej pętli)

</acceptance_criteria>

Task 1: Dodanie persistence per_page w table-list.php resources/views/components/table-list.php 1. Dodać klucz localStorage: `var perPageKey = storagePrefix + '_per_page';` (obok istniejących filterKey, colsKey, queryKey ~linia 336)

2. W handlerze change selecta per_page (~linia 428-432): przed `form.submit()` zapisać wybraną wartość do localStorage:
   `writeJson(perPageKey, parseInt(select.value, 10));`

3. Na końcu sekcji DOMContentLoaded (po istniejących restore bloków), dodać logikę restore per_page:
   - Odczytać `readJson(perPageKey, null)`
   - Jeśli wartość istnieje i jest różna od aktualnie wybranej w selekcie per_page:
     - Sprawdzić czy per_page jest obecne w URL (URLSearchParams)
     - Jeśli per_page NIE jest w URL (użytkownik wszedł bez jawnego parametru):
       - Ustawić wartość w selekcie i submitować formularz (to spowoduje przeładowanie z prawidłowym per_page w URL)
     - Jeśli per_page JEST w URL: zaktualizować localStorage z wartości z URL (sync)
   - Jeśli wartość jest taka sama jak w selekcie: nic nie rób (brak pętli)

Wzorzec: użyć istniejących helperów readJson/writeJson.
Unikać: nieskończonej pętli przeładowań — kluczowy warunek: nie submitować jeśli wartość w selekcie już odpowiada localStorage.

1. Otworzyć /orders/list — domyślnie 20 2. Zmienić na 50 — strona przeładowuje z per_page=50 3. Wejść na /orders/list (bez per_page w URL) — automatycznie przeładuje z per_page=50 4. Wejść na /orders/list?per_page=20 — wyświetli 20 i zaktualizuje localStorage 5. Sprawdzić brak pętli przeładowań AC-1, AC-2, AC-3, AC-4 satisfied

DO NOT CHANGE

• Backend PHP (OrdersController, OrdersRepository)
• Struktura HTML per-page selectora
• Inne localStorage keys (filters_open, hidden_cols, query)

SCOPE LIMITS

• Tylko frontend JS w table-list.php
• Bez zmian backendu — per_page nadal przychodzi jako query param

Before declaring plan complete: - [ ] Brak błędów JS w konsoli przeglądarki - [ ] Per_page zapisuje się w localStorage po zmianie - [ ] Per_page odtwarza się po wejściu bez parametru w URL - [ ] Brak nieskończonej pętli przeładowań - [ ] Inne listy (np. paragony) też korzystają z persistence

<success_criteria>

• Wybrana liczba wierszy jest zapamiętywana w localStorage
• Wejście na listę bez per_page w URL automatycznie stosuje zapamiętaną wartość
• Brak regresji w istniejącej funkcjonalności table-list </success_criteria>

After completion, create `.paul/phases/72-per-page-persistence/72-01-SUMMARY.md`