159 lines
6.5 KiB
Markdown
159 lines
6.5 KiB
Markdown
---
|
|
phase: 91-print-client-timeout-resilience
|
|
plan: 01
|
|
type: execute
|
|
wave: 1
|
|
depends_on: []
|
|
files_modified:
|
|
- clients/windows/OrderPROPrint/Services/PollingService.cs
|
|
- clients/windows/OrderPROPrint/Services/PrintApiClient.cs
|
|
autonomous: true
|
|
delegation: off
|
|
---
|
|
|
|
<objective>
|
|
## Goal
|
|
Wyeliminować zawieszanie się OrderPROPrint przy timeout'ach HTTP — aplikacja ma kontynuować polling w nieskończoność niezależnie od błędów sieciowych.
|
|
|
|
## Purpose
|
|
Użytkownik zgłasza, że po timeout'cie etykiety przestają się drukować i trzeba ręcznie otworzyć ustawienia i kliknąć Zapisz żeby "odwiesić" program. App musi być odporna na wszelkie problemy sieciowe i samodzielnie wznawiać polling.
|
|
|
|
## Output
|
|
Zmodyfikowane pliki `PollingService.cs` i `PrintApiClient.cs` z resilient polling.
|
|
</objective>
|
|
|
|
<context>
|
|
## Project Context
|
|
@.paul/PROJECT.md
|
|
@.paul/ROADMAP.md
|
|
@.paul/STATE.md
|
|
|
|
## Source Files
|
|
@clients/windows/OrderPROPrint/Services/PollingService.cs
|
|
@clients/windows/OrderPROPrint/Services/PrintApiClient.cs
|
|
@clients/windows/OrderPROPrint/TrayApplicationContext.cs
|
|
</context>
|
|
|
|
<acceptance_criteria>
|
|
|
|
## AC-1: Polling kontynuuje po timeout HTTP
|
|
```gherkin
|
|
Given aplikacja odpytuje API i serwer nie odpowiada
|
|
When HttpClient.Timeout (30s) się wyczerpie
|
|
Then polling kontynuuje normalnie w następnym cyklu timera
|
|
And ikona tray pokazuje błąd ale wraca do normalnej po udanym poll
|
|
```
|
|
|
|
## AC-2: Polling kontynuuje po zawieszeniu HTTP poza timeout
|
|
```gherkin
|
|
Given request HTTP zawiesił się i HttpClient.Timeout nie zadziałał (edge case Windows)
|
|
When minęło 45 sekund od rozpoczęcia poll
|
|
Then CancellationToken wymusza anulowanie requestu
|
|
And _isProcessing jest resetowane
|
|
And następny cykl timera wykonuje normalny poll
|
|
```
|
|
|
|
## AC-3: Ikona wraca do normalnego stanu po odzyskaniu połączenia
|
|
```gherkin
|
|
Given polling był w stanie błędu (ikona Error)
|
|
When kolejny poll zakończy się sukcesem
|
|
Then ikona tray wraca do normalnej (Application)
|
|
And tooltip pokazuje aktualny status
|
|
```
|
|
|
|
</acceptance_criteria>
|
|
|
|
<tasks>
|
|
|
|
<task type="auto">
|
|
<name>Task 1: Dodać CancellationToken per-poll i watchdog w PollingService</name>
|
|
<files>clients/windows/OrderPROPrint/Services/PollingService.cs</files>
|
|
<action>
|
|
1. Dodać pole `private DateTime _pollStartedAt` do klasy.
|
|
|
|
2. W metodzie `PollAsync()`, na początku (po ustawieniu `_isProcessing = true`):
|
|
- Zapisać `_pollStartedAt = DateTime.UtcNow`
|
|
- Utworzyć `using var cts = new CancellationTokenSource(TimeSpan.FromSeconds(45))`
|
|
- Przekazać `cts.Token` do wszystkich wywołań `_apiClient.*Async()`
|
|
|
|
3. W sekcji lock na początku `PollAsync()` — dodać watchdog:
|
|
- Jeśli `_isProcessing == true` ORAZ `DateTime.UtcNow - _pollStartedAt > TimeSpan.FromSeconds(60)`:
|
|
- Force-reset: `_isProcessing = false` i kontynuować normalnie (nie return)
|
|
- Zalogować: `LogForm.Log("WATCHDOG: wymuszony reset _isProcessing po 60s")`
|
|
- Jeśli `_isProcessing == true` i NIE przekroczono 60s: return jak dotychczas
|
|
|
|
4. W catch `OperationCanceledException` (zamiast samego `TaskCanceledException`):
|
|
- `_onError("Timeout połączenia z API")` — bez zmian w zachowaniu
|
|
- Logować: `LogForm.Log("Timeout: poll anulowany przez CancellationToken")`
|
|
|
|
5. Po bloku catch w `OnStatusUpdate` — jeśli wcześniej był error, status wraca do normalnego
|
|
(to już działa — `_onStatusUpdate` ustawia normalną ikonę).
|
|
|
|
6. Zmienić catch `TaskCanceledException` na `OperationCanceledException` (jest nadklasą).
|
|
</action>
|
|
<verify>Kompilacja projektu: `dotnet build` w katalogu clients/windows/OrderPROPrint/</verify>
|
|
<done>AC-1 i AC-2 satisfied: timeout i zawieszony request nie blokują kolejnych poll'i</done>
|
|
</task>
|
|
|
|
<task type="auto">
|
|
<name>Task 2: Dodać CancellationToken do metod PrintApiClient</name>
|
|
<files>clients/windows/OrderPROPrint/Services/PrintApiClient.cs</files>
|
|
<action>
|
|
1. Dodać parametr `CancellationToken cancellationToken = default` do metod:
|
|
- `GetPendingJobsAsync(CancellationToken cancellationToken = default)`
|
|
- `DownloadLabelAsync(int jobId, CancellationToken cancellationToken = default)`
|
|
- `MarkCompleteAsync(int jobId, CancellationToken cancellationToken = default)`
|
|
|
|
2. Przekazać `cancellationToken` do każdego wywołania `_httpClient.GetAsync()` / `PostAsync()`:
|
|
- `await _httpClient.GetAsync("api/print/jobs/pending", cancellationToken)`
|
|
- `await _httpClient.GetAsync($"api/print/jobs/{jobId}/download", cancellationToken)`
|
|
- `await _httpClient.PostAsync($"api/print/jobs/{jobId}/complete", null, cancellationToken)`
|
|
|
|
3. Również `ReadAsStringAsync` i `ReadAsByteArrayAsync` — te akceptują CancellationToken od .NET 5+:
|
|
- `await response.Content.ReadAsStringAsync(cancellationToken)`
|
|
- `await response.Content.ReadAsByteArrayAsync(cancellationToken)`
|
|
|
|
4. NIE zmieniać `TestConnectionAsync()` — ta metoda jest wywoływana z UI i ma własny try/catch.
|
|
</action>
|
|
<verify>Kompilacja projektu: `dotnet build` w katalogu clients/windows/OrderPROPrint/</verify>
|
|
<done>AC-1 i AC-2 satisfied: CancellationToken propagowany do HTTP calls</done>
|
|
</task>
|
|
|
|
</tasks>
|
|
|
|
<boundaries>
|
|
|
|
## DO NOT CHANGE
|
|
- clients/windows/OrderPROPrint/TrayApplicationContext.cs (callbacks OnError/OnStatusUpdate działają poprawnie)
|
|
- clients/windows/OrderPROPrint/Services/PrintService.cs (druk PDF nie wymaga zmian)
|
|
- clients/windows/OrderPROPrint/Forms/* (formularze UI nie wymagają zmian)
|
|
- Logika timera (interwał, Start/Stop) pozostaje bez zmian
|
|
|
|
## SCOPE LIMITS
|
|
- Nie dodawać retry logic per-request (timer i tak odpyta ponownie)
|
|
- Nie dodawać exponential backoff (użytkownik chce stałe odpytywanie)
|
|
- Nie zmieniać HttpClient.Timeout (30s jest OK jako pierwszy poziom obrony)
|
|
- Nie zmieniać interfejsu publicznego PollingService (Start/Stop/IsRunning)
|
|
|
|
</boundaries>
|
|
|
|
<verification>
|
|
Before declaring plan complete:
|
|
- [ ] `dotnet build` kompiluje bez błędów
|
|
- [ ] CancellationToken przekazywany z PollingService do PrintApiClient do HttpClient
|
|
- [ ] Watchdog resetuje _isProcessing po 60s
|
|
- [ ] OperationCanceledException łapany (nie tylko TaskCanceledException)
|
|
- [ ] Brak regresji: normalne działanie polling → print → mark complete
|
|
</verification>
|
|
|
|
<success_criteria>
|
|
- Wszystkie taski ukończone
|
|
- Kompilacja bez błędów
|
|
- Watchdog chroni przed zawieszeniem _isProcessing
|
|
- CancellationToken wymusza timeout niezależnie od HttpClient.Timeout
|
|
</success_criteria>
|
|
|
|
<output>
|
|
After completion, create `.paul/phases/91-print-client-timeout-resilience/91-01-SUMMARY.md`
|
|
</output>
|