feat: expand next steps documentation with detailed plans for Flutter migration, including goals, priorities, and implementation strategies

This commit is contained in:
Nils-Johan Gynther
2026-04-30 11:20:07 +02:00
parent b7f78fc3ff
commit 1ac644eb3e
+96
View File
@@ -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.