From 1ac644eb3e1871da87253497972fc09dc6e36a39 Mon Sep 17 00:00:00 2001 From: Nils-Johan Gynther Date: Thu, 30 Apr 2026 11:20:07 +0200 Subject: [PATCH] feat: expand next steps documentation with detailed plans for Flutter migration, including goals, priorities, and implementation strategies --- flutter/next_steps_flutter.md | 96 +++++++++++++++++++++++++++++++++++ 1 file changed, 96 insertions(+) diff --git a/flutter/next_steps_flutter.md b/flutter/next_steps_flutter.md index db0e101f..a57d587f 100644 --- a/flutter/next_steps_flutter.md +++ b/flutter/next_steps_flutter.md @@ -347,3 +347,99 @@ En feature ar klar nar allt nedan ar uppfyllt: - Finslipa UI och tillgänglighet i samband med de nya navigationsmöjligheterna. - Färdigställ kvittoimport och adminfunktioner enligt plan. - Lägg till snabbfilter i Produkt-admin: "Visa endast ändrade rader" för inline-kategoribyten (planerad förbättring till nästa pass). + +# Nästa steg: Flutter-migrering + +Relaterade dokument: +- [README.md](README.md) +- [teknisk_beskrivning_flutter.md](teknisk_beskrivning_flutter.md) + +## Mål och prioriteringar för produktion + +### Övergripande mål +- **Funktionell parity:** Säkerställa att alla kärnfunktioner är stabila och fungerar som förväntat. +- **Användarupplevelse:** Förenkla onboarding och säkerställa att användare snabbt förstår appens värde. +- **Produktionsklar:** Säkerställa att appen är redo för lansering genom att adressera kritiska buggar och förbättra prestanda. + +### Icke-förhandlingsbara ramar + +1. Inget ska tas bort eller ändras i `recipe-api` utom explicit beslutade backend-ändringar för användarscope i pantry och matplan. +2. Inget ska tas bort eller ändras i `recipe-frontend`. +3. Migreringen sker i Flutter-spåret som separat klient mot befintliga API-kontrakt. +4. Next-frontend körs parallellt tills Flutter har verifierad parity i kärnflöden. + +## Arbetsplan + +### Pågående arbete +- **Kvittoimport (Fas 6b):** Påbörjad men granskningssteg och bulk-spara återstår. +- **Bildimport:** Säkerställa att containrar är uppdaterade med senaste kod och att diagnostikloggar syns vid felsökning. +- **Adminfunktioner:** Avancerad AI-integration och ytterligare adminfunktioner planeras men är ej migrerade. + +### Prioriterade nästa steg +1. Slutför kvittoimport och bulk-spara. +2. Säkerställa robust bildimport och diagnostik. +3. Implementera avancerad AI-integration för produktkategorisering. +4. Utöka adminfunktioner för användarhantering och produktadministration. +5. Förbättra UI/UX för användarflöden, inklusive onboarding och profilhantering. + +## Plan för Implementering av Fas 6b + +### 1. Slutför Kvittoimport +- **Aktiviteter:** + - Implementera parsers för kvitton (PDF, bildbaserade kvitton). + - Utveckla gränssnitt för att granska importerade kvitton. + - Implementera bulk-spara-funktionalitet för kvitton. + +- **Tekniska Detaljer:** + - Använd `pdf-parse` och `tesseract.js` för att extrahera data från kvitton. + - Säkerställa att API-endpoints (`/receipt-import`) hanterar filuppladdning och returnerar strukturerad data. + +### 2. Förbättra Bildhantering +- **Aktiviteter:** + - Säkerställa att `downloadAndOptimizeImage` fungerar korrekt i Docker-miljön. + - Implementera robust felhantering och diagnostikloggning för bildimport. + +- **Tekniska Detaljer:** + - Använd miljövariabler för att definiera sökvägar för bildlagring. + - Säkerställa att bilder optimeras och lagras korrekt på servern. + +### 3. Säkerställa Kompatibilitet med Linux/Ubuntu +- **Aktiviteter:** + - Kontrollera att alla sökvägar är relativa eller konfigurerbara via miljövariabler. + - Säkerställa att Docker-miljön är korrekt konfigurerad för att köra på Ubuntu. + +- **Tekniska Detaljer:** + - Använd `path.join()` för att bygga sökvägar på ett plattformsoberoende sätt. + - Säkerställa att `IMAGE_DEST_DIR` är korrekt konfigurerad för Linux/Ubuntu. + +### 4. Förbättra API-Integration +- **Aktiviteter:** + - Säkerställa att API-endpoints har korrekt felhantering och tidsgränser. + - Implementera robusta tidsgränser och återförsöksmekanismer för API-anrop. + +- **Tekniska Detaljer:** + - Använd `http.Client` med korrekta tidsgränser för API-anrop. + - Implementera återförsöksmekanismer för tillfälliga fel. + +## Verifiering och Testning + +### 1. Enhets- och Integrationstester +- **Aktiviteter:** + - Skapa enhets- och integrationstester för nya parsers och API-endpoints. + - Säkerställa att alla tester körs i Docker-miljön. + +- **Tekniska Detaljer:** + - Använd `flutter test` för att köra enhetstester. + - Använd `jest` eller `supertest` för att testa API-endpoints. + +### 2. Manuell Testning +- **Aktiviteter:** + - Manuell testning av kvittoimport och bulk-spara-funktionalitet. + - Säkerställa att bildhantering fungerar korrekt i Docker-miljön. + +- **Tekniska Detaljer:** + - Använd Postman eller liknande verktyg för att testa API-endpoints. + - Säkerställa att gränssnittet för kvittoimport fungerar som förväntat. + +## Slutsats +För att slutföra Fas 6b krävs implementering av parsers för kvitton, förbättringar av bildhantering, och säkerställande av kompatibilitet med Linux/Ubuntu. En robust API-integration och omfattande testning är avgörande för att säkerställa att importfunktionen fungerar som förväntat i produktion. \ No newline at end of file