Nils-Johan Gynther
b31af6181c
- Updated next_steps_flutter.md to reflect completed tasks for user-scoped PantryItem and MealPlanEntry, including API contract publication and migration application. - Enhanced the prioritization plan with clear completion dates and added localization tasks. - Expanded teknisk_beskrivning_flutter.md with details on inventory filtering, sorting, and user-scoped backend changes, including migration notes and localization setup. - Improved error handling documentation and localization usage guidelines.
117 lines
5.0 KiB
Markdown
117 lines
5.0 KiB
Markdown
# Next Steps: Flutter-migrering
|
|
|
|
Relaterade dokument:
|
|
- [flutter/README.md](flutter/README.md)
|
|
- [teknisk_beskrivning_flutter.md](teknisk_beskrivning_flutter.md)
|
|
- [TEKNISK_BESKRIVNING.md](TEKNISK_BESKRIVNING.md)
|
|
|
|
## Icke-forhandlingsbara ramar
|
|
|
|
1. Inget ska tas bort eller andras i `recipe-api` utom explicit beslutade backend-andringar for anvandarscope i pantry och matplan.
|
|
2. Inget ska tas bort eller andras i `recipe-frontend`.
|
|
3. Migreringen sker i Flutter-sparet som separat klient mot befintliga API-kontrakt.
|
|
4. Next-frontend kor parallellt tills Flutter har verifierad parity i karnfloden.
|
|
|
|
## Beslut 2026-04-22 - User-scope for pantry och matplan
|
|
|
|
- Pantry och matplan ska vara per anvandare, inte globala.
|
|
- Detta kraver backend-andringar i `recipe-api` innan Flutter kan na full parity for dessa floden.
|
|
- Flutter ska folja de nya kontrakten nar de finns pa plats, utan klientspecifik speciallogik.
|
|
|
|
## Malbild for v1 (funktionell parity)
|
|
|
|
For v1 ska dessa floden vara stabila i Flutter:
|
|
- Auth: login, session, logout, auth-guard.
|
|
- Recept: lista, detalj, skapa, uppdatera, ta bort.
|
|
- Inventarie: lista, skapa, uppdatera, konsumera, historik.
|
|
- Matplan: veckovy, val av recept per dag, portionsjustering, inkopslista, inventariejamforelse.
|
|
- Import: quick-import + parse-markdown-flode.
|
|
- Profil: basfunktioner for anvandarprofil.
|
|
|
|
Adminfloden migreras efter att ovanstaende ar verifierat.
|
|
|
|
## Prioriterad plan (ordning)
|
|
|
|
## Fas 0 - Backend-forarbete for user-scope (KLAR 2026-04-22)
|
|
- [x] Gor `PantryItem` user-scopad (userId + productId unik per anvandare).
|
|
- [x] Gor matplan user-scopad och filtrera list/upsert/delete per inloggad anvandare.
|
|
- [x] Uppdatera matplanens inventory-jamforelse till anvandarspecifikt pantry.
|
|
- [x] Publicera uppdaterade API-kontrakt innan vidare Flutter-parity for matplan/baslager.
|
|
- [x] Migration 20260422130000_user_scope_pantry_meal_plan applicerad.
|
|
|
|
## Fas 1 - Stabil app-shell (KLAR 2026-04-22)
|
|
- [x] Bygg tydlig auth-gate i router.
|
|
- [x] Centralisera API-fel (401/403/500) i ett gemensamt lager (`mapErrorToUserMessage`).
|
|
- [x] Skapa gemensamma UI-komponenter for loading, empty, error.
|
|
- [x] Satt en enhetlig navigationsstruktur (web forst, mobil-redo).
|
|
- [x] Lokalisering: ARB-infrastruktur pa plats (`flutter_localizations`, `l10n.yaml`, `app_sv.arb`, `synthetic-package: false`, `flutter gen-l10n` i Dockerfile).
|
|
- [x] Regressionstest for svenska strangkvalitet tillagd.
|
|
|
|
## Fas 2 - Auth parity (KLAR 2026-04-22)
|
|
- [x] Hardna loginflodet (tydliga felmeddelanden, retries dar relevant).
|
|
- [x] Verifiera token-livscykel (reload/hard refresh/logout).
|
|
- [x] Implementera automatisk hantering av utgangen token (401 -> logout -> login).
|
|
|
|
## Fas 3 - Recept parity (KLAR 2026-04-22)
|
|
- [x] Lista -> detalj -> skapa -> redigera -> ta bort.
|
|
- [x] Knyt ihop med parse-markdown-proxy.
|
|
- [x] Behall backend som enda plats for matchning, validering och affarslogik.
|
|
|
|
## Fas 4 - Inventarie parity (KLAR 2026-04-22)
|
|
- [x] Lista med filter/sortering (plats + sort via Riverpod-querystate).
|
|
- [x] Skapa och uppdatera inventariepost.
|
|
- [x] Konsumtion och konsumtionshistorik.
|
|
|
|
## Fas 5 - Matplan parity (NASTA)
|
|
- Veckovy med receptval per dag mot nu user-scopat `GET /api/meal-plan?from=&to=`.
|
|
- Portionsjustering per dag.
|
|
- Inkoplista och inventariejamforelse mot anvandarens pantry.
|
|
|
|
## Fas 6 - Import parity
|
|
- URL/PDF/bild via befintliga endpoints.
|
|
- Tydlig hantering av langkorande anrop och fel.
|
|
|
|
## Fas 7 - Profil/admin parity
|
|
- Profil for alla anvandare.
|
|
- Role-aware navigation och skydd for adminytor.
|
|
- Adminfunktioner migreras sist for att minimera risk i karnfloden.
|
|
|
|
## Contract-first per feature
|
|
|
|
For varje feature:
|
|
1. Verifiera request/response mot befintligt backendkontrakt.
|
|
2. Mappa modeller robust (null-safe, fallback-falt, typskillnader).
|
|
3. Kontrollera felbanor innan UI-polish.
|
|
|
|
Ingen ad-hoc backendforandring goras for att "fa Flutter att funka".
|
|
Backend-andringar for user-scope i pantry/matplan ar explicit beslutade och ska goras kontrollerat forst.
|
|
|
|
## Kvalitetsgrind (Definition of Done)
|
|
|
|
En feature ar klar nar allt nedan ar uppfyllt:
|
|
1. API-floden fungerar for bade success och fel.
|
|
2. Auth/rollskydd fungerar (inklusive 401/403).
|
|
3. Loading/empty/error ar konsekvent hanterat.
|
|
4. Navigation in/ut ur feature fungerar utan specialfall.
|
|
5. Smoke-test i testmiljo ar godkant.
|
|
|
|
## Leveransmodell
|
|
|
|
- Leverera 1 feature i taget till testdoman.
|
|
- Demo och snabb feedback innan nasta feature.
|
|
- Hall dubbel drift (Next + Flutter) tills karnfloden ar stabila.
|
|
- Flytta trafik gradvis nar parity ar verifierad.
|
|
|
|
## Nasta konkreta sprint (rekommenderad)
|
|
|
|
1. Fas 5: Matplan parity mot user-scopat API (veckovy, inkoplista, inventariejamforelse).
|
|
2. Fa 6: Import parity.
|
|
3. Fas 7: Profil/admin parity.
|
|
4. Fortatt flytt av UI-strangar till ARB (inventarie, pantry, recept).
|
|
5. Smoke-test pa testdomanen och avstamning.
|
|
|
|
## Tumregel
|
|
|
|
- Sikta pa funktionell parity forst.
|
|
- Pixel-perfect parity tas efter stabil funktion.
|