175 lines
7.3 KiB
Markdown
175 lines
7.3 KiB
Markdown
---
|
|
phase: 101-aged-orders-row-highlight
|
|
plan: 01
|
|
type: execute
|
|
wave: 1
|
|
depends_on: []
|
|
files_modified:
|
|
- src/Modules/Orders/OrdersController.php
|
|
- resources/views/components/table-list.php
|
|
- resources/scss/app.scss
|
|
- public/assets/css/app.css
|
|
autonomous: true
|
|
delegation: off
|
|
---
|
|
|
|
<objective>
|
|
## Goal
|
|
Na liscie zamowien (`/orders/list`) wiersze tabeli zamowien z wiekiem 4-7 dni maja widoczna czerwona ramke. Im starsze zamowienie, tym bardziej intensywna (ciemniejsza / grubsza) ramka.
|
|
|
|
## Purpose
|
|
Sprzedawca na pierwszy rzut oka widzi stare zamowienia, ktore wymagaja uwagi, bez potrzeby sortowania lub filtrowania po dacie. Skraca czas reakcji na zalegajace zamowienia.
|
|
|
|
## Output
|
|
- Row-level highlight w `table-list.php` oparty o `_row_class` z danych wiersza
|
|
- `OrdersController::prepareTableRows` (lub metoda buildujaca `$tableRows`) ustawia `_row_class` na podstawie wieku zamowienia w dniach
|
|
- Style SCSS dla 4 wariantow intensywnosci (4, 5, 6, 7 dni)
|
|
</objective>
|
|
|
|
<context>
|
|
## Project Context
|
|
@.paul/PROJECT.md
|
|
@.paul/ROADMAP.md
|
|
@.paul/STATE.md
|
|
|
|
## Source Files
|
|
@src/Modules/Orders/OrdersController.php
|
|
@resources/views/components/table-list.php
|
|
@resources/views/orders/list.php
|
|
@resources/scss/app.scss
|
|
</context>
|
|
|
|
<acceptance_criteria>
|
|
|
|
## AC-1: Zamowienie mlodsze niz 4 dni bez ramki
|
|
```gherkin
|
|
Given zamowienie zostalo zlozone dzisiaj, wczoraj, 2 lub 3 dni temu
|
|
When uzytkownik otwiera /orders/list
|
|
Then wiersz zamowienia nie ma czerwonej ramki (brak klasy aged-*)
|
|
```
|
|
|
|
## AC-2: Zamowienie 4-7 dni z rosnaca intensywnoscia
|
|
```gherkin
|
|
Given zamowienia o wieku 4, 5, 6 i 7 dni
|
|
When uzytkownik otwiera /orders/list
|
|
Then kazdy z tych wierszy ma czerwona ramke (border 2px solid), a intensywnosc koloru rosnie wraz z wiekiem (4d = najjasniejsza, 7d = najciemniejsza / najintensywniejsza)
|
|
```
|
|
|
|
## AC-3: Zamowienie starsze niz 7 dni
|
|
```gherkin
|
|
Given zamowienie zlozone 8+ dni temu
|
|
When uzytkownik otwiera /orders/list
|
|
Then wiersz ma maksymalna intensywnosc ramki (poziom aged-7) — nie wraca do stanu bez ramki
|
|
```
|
|
|
|
## AC-4: Wiek liczony od daty zamowienia
|
|
```gherkin
|
|
Given pole `order_date` (lub rownowazne) istnieje w danych zamowienia
|
|
When controller buduje wiersze tabeli
|
|
Then wiek dnia wyliczany jest jako floor((now - order_date) / 86400), z uwzglednieniem strefy czasowej aplikacji
|
|
```
|
|
|
|
</acceptance_criteria>
|
|
|
|
<tasks>
|
|
|
|
<task type="auto">
|
|
<name>Task 1: Rozszerz table-list.php o row-level class</name>
|
|
<files>resources/views/components/table-list.php</files>
|
|
<action>
|
|
W petli `foreach ($rows as $row)` (linia ~219) zamiast `<tr>` renderuj:
|
|
`<tr class="<?= $e((string) ($row['_row_class'] ?? '')) ?>">`.
|
|
Nie zmieniaj nic innego. Klucz `_row_class` traktuj jako opcjonalny — jesli brak, atrybut class ma byc pusty (nie renderowac pustego atrybutu jest OK, ale najprosciej zawsze go wypisac).
|
|
Avoid: zmiany w innych petlach, zmiany struktury columns/rows, zmiany JS.
|
|
</action>
|
|
<verify>Otworz /orders/list w przegladarce — DOM tabeli nadal renderuje sie, wiersze maja atrybut class (pusty lub z wartoscia).</verify>
|
|
<done>AC-1..AC-4 czesc wspolna: mechanizm row-class dostepny.</done>
|
|
</task>
|
|
|
|
<task type="auto">
|
|
<name>Task 2: OrdersController ustawia _row_class wg wieku zamowienia</name>
|
|
<files>src/Modules/Orders/OrdersController.php</files>
|
|
<action>
|
|
Zlokalizuj miejsce budowy `$tableRows` (przekazywane do `tableList.rows`, linia ~128).
|
|
Dla kazdego zamowienia:
|
|
- Pobierz date zamowienia (pole uzywane obecnie do wyswietlenia daty w kolumnie — zweryfikuj w kontrolerze / repozytorium, najczesciej `order_date`).
|
|
- Wylicz wiek w dniach: `$ageDays = (int) floor((time() - strtotime($orderDate)) / 86400);` (pomin jesli data pusta).
|
|
- Przypisz:
|
|
- ageDays < 4 → brak klasy
|
|
- ageDays == 4 → `order-row-aged order-row-aged-4`
|
|
- ageDays == 5 → `order-row-aged order-row-aged-5`
|
|
- ageDays == 6 → `order-row-aged order-row-aged-6`
|
|
- ageDays >= 7 → `order-row-aged order-row-aged-7`
|
|
- Zapisz w `$row['_row_class']`.
|
|
Avoid: modyfikacji zapytan DB, dodawania nowych kolumn, logiki w widoku, zmian w repozytorium.
|
|
</action>
|
|
<verify>Zrob testowe zamowienia (lub uzyj istniejacych) z roznym wiekiem; w HTML `/orders/list` wiersze maja odpowiednie klasy order-row-aged-N.</verify>
|
|
<done>AC-1, AC-2, AC-3, AC-4 satisfied: wiersze otrzymuja poprawne klasy wg wieku.</done>
|
|
</task>
|
|
|
|
<task type="auto">
|
|
<name>Task 3: Style SCSS dla intensywnosci ramki + build CSS</name>
|
|
<files>resources/scss/app.scss, public/assets/css/app.css</files>
|
|
<action>
|
|
Dodaj w `resources/scss/app.scss` (lub w dedykowanym partialu jesli projekt tak robi — sprawdz istniejace wzorce) reguly:
|
|
```
|
|
.table-list-table tbody tr.order-row-aged > td {
|
|
border-top-width: 2px;
|
|
border-bottom-width: 2px;
|
|
border-top-style: solid;
|
|
border-bottom-style: solid;
|
|
}
|
|
.table-list-table tbody tr.order-row-aged > td:first-child { border-left: 2px solid; }
|
|
.table-list-table tbody tr.order-row-aged > td:last-child { border-right: 2px solid; }
|
|
|
|
tr.order-row-aged-4 > td { border-color: #f8b4b4; }
|
|
tr.order-row-aged-5 > td { border-color: #f28282; }
|
|
tr.order-row-aged-6 > td { border-color: #e74c3c; }
|
|
tr.order-row-aged-7 > td { border-color: #b91c1c; }
|
|
```
|
|
Zbuduj SCSS → CSS tak jak dotychczas w projekcie (sprawdz czy jest npm skrypt, Gulp, czy recznie — jesli brak pipeline, rownolegle zaktualizuj `public/assets/css/app.css` dopisujac te same reguly).
|
|
CSS ma zadzialac razem z istniejacym kolorem tla statusu — ramka nie moze ukrywac tla komorek.
|
|
Avoid: dodawania styli inline w list.php, duplikowania selektorow w innych plikach SCSS, zmian w innych komponentach.
|
|
</action>
|
|
<verify>Wizualnie /orders/list: wiersze 4-dniowe najjasniejsza ramka, 7-dniowe najciemniejsza. Starsze niz 7 dni dalej na poziomie aged-7. Tla komorek / kolory statusow bez zmian.</verify>
|
|
<done>AC-2, AC-3 satisfied: ramka rosnaco intensywna, klamrowana przez table.</done>
|
|
</task>
|
|
|
|
</tasks>
|
|
|
|
<boundaries>
|
|
|
|
## DO NOT CHANGE
|
|
- src/Modules/Orders/OrdersRepository.php (brak nowych SQL/kolumn)
|
|
- database/migrations/** (brak migracji)
|
|
- Logika sortowania, filtrowania i paginacji w OrdersController
|
|
- Inne widoki / inne listy korzystajace z `components/table-list.php` — musza nadal dzialac (klasa `_row_class` jest opcjonalna)
|
|
- Kolumny / zawartosc komorek wiersza (tylko wrapper <tr> + CSS)
|
|
|
|
## SCOPE LIMITS
|
|
- Tylko strona /orders/list — nie dotyczy innych list (ksiegowosc, automatyzacja, print queue)
|
|
- Ramka oparta wylacznie o wiek w dniach; nie mieszaj tego z statusem zamowienia
|
|
- Brak konfigurowalnosci progow w ustawieniach — wartosci zakodowane (4..7)
|
|
|
|
</boundaries>
|
|
|
|
<verification>
|
|
Przed zamknieciem planu:
|
|
- [ ] /orders/list laduje sie bez bledow PHP i JS
|
|
- [ ] Wiersze z zamowieniami <4 dni nie maja ramki
|
|
- [ ] Wiersze z zamowieniami 4,5,6,7+ dni maja coraz ciemniejsza czerwona ramke
|
|
- [ ] Inne listy korzystajace z components/table-list.php nadal renderuja sie poprawnie
|
|
- [ ] Brak naruszenia zasad z CLAUDE.md (brak styli w widokach, medoo prepared, SCSS → CSS build)
|
|
- [ ] All acceptance criteria met
|
|
</verification>
|
|
|
|
<success_criteria>
|
|
- Wszystkie taski zakonczone
|
|
- Wizualna weryfikacja potwierdza rosnaca intensywnosc ramki
|
|
- Brak regresji na innych listach opartych o table-list.php
|
|
</success_criteria>
|
|
|
|
<output>
|
|
Po ukonczeniu utworz `.paul/phases/101-aged-orders-row-highlight/101-01-SUMMARY.md`
|
|
</output>
|