9.2 KiB
Nasta steg
Detta ar huvudroadmap for Recipe App. All detaljhistorik och djup teknisk bakgrund finns i respektive tekniska dokument.
Dokumentstatus (2026-05-03)
- Fokus: en gemensam prioriteringslista for produkt, utveckling och drift.
- Delplaner for underomraden ska referera hit, inte duplicera hela roadmapen.
Nyligen klart
-
2026-05-10: Admin-inventarie (CRUD, merge, filter, sortering, preview, säkerhet), user-scope, IDOR-skydd, säkerhetshärdning, optimeringar och utökad testtäckning är nu genomförda och dokumenterade i README, TEKNISK_BESKRIVNING, SÄKERHETSHÄRDNINGSPLAN och SESSIONLOGGAR.
-
Kvittoimport: förbättrad antal/förpackningsinferens och robustare regelmotor.
-
Kategorisering: utökade brödregler + contradiction guards och nya regler för pasta, grädde, ägg, juice, godis, och potatis.
-
Kategoriträd: nya noder
KorvbrödunderFastfoodbrödochGräddeunderMatlagningi seed-data. -
Flutter: klientpersistens för pågående kvittoimport.
-
Produktmodell: user-scoped produkter och seed renodlad till kategorier.
-
Testinfrastruktur: parametriserade enhetstester för kvittoimport (18 testfall).
-
CI/CD: GitHub Actions-pipeline för automatiserad testkörning vid push och pull request.
-
Node.js versionsparitet:
package-lock.jsonspåras nu i git för båda repos; Dockerfiles körnpm ci— reproducerbara byggen i alla miljöer. -
PDF-kvittoimport stabiliserad:
pdf-parseCJS-fix +pdfjs-dist/legacyfallback löserDOMMatrix-fel i Node.js. -
Felkods-forwarding fixad:
receipt-import.service.tsi recipe-api vidarebefordrar nu 503 från importer-api somServiceUnavailableExceptionistället för att alltid returnera 400. -
AI-optimering (PDF):
looksLikeReceiptProductLine()i importer-api filtrerar bort header/footer-rader — Mistral anropas enbart för rader som faktiskt kan vara produkter. -
Receptparser hardening: gemensam parserutility, intervall/parantes/brak-forbattringar samt testtackning for parsern.
-
Receptsakerhet och dataintegritet: aktiv-produktvalidering, transaktion vid update, orphan-fil-cleanup och striktare owner-hantering av legacy-recept.
-
Alternativa ingredienser (Option A): lagring i
alternativeProductIds(JSON), matchning mot flera alternativ och lagerkoll som inkluderar alternativ. -
Flutter felhantering: kopierbara felmeddelanden i snackbar + global textselektion for enklare support/felsokning.
-
Kvittoimport — Simplified Matching Logic (2026-05-09): Unified matcher som konsoliderar product matching + categorization i en explicit flödestre. Eliminar split mellan
matchProducts()ochenrichWithAiCategories(). Ger tydligare trace-logging och bättre debuggability för varför ett item matchades på ett visst sätt. Systemet är nu mer underhållsbart och framtida förbättringar på matching/kategorisering går snabbare.
Huvudprioriteringar
- 🟡 Aliasstrategi i kvittoimport: DELVIS GENOMFÖRD (2026-05-09)
- Målbild:
- Vanliga användare skapar och använder privata alias som bara gäller deras egna importer.
- Admin kan dessutom skapa globala alias som fungerar som fallback för alla användare.
- Matchningsordning ska alltid vara: user alias -> global alias -> vanlig produktmatchning.
- Genomfört nu:
- Gemensam aliasnormalisering införd för lookup, upsert och alias-inlärning.
- Guardrails införda för tomma alias och brusalias som
rabatt,summa,pant. - Receipt import lär inte längre in alias automatiskt; användaren måste välja det explicit i edit-dialogen.
- Aliasöversikter i Flutter visar nu scope tydligare (
privatvsglobal fallback). - Tester tillagda för normalisering, prioritet och behörighet.
- Kvar:
- Manuell verifiering i produktionslik miljö av aliasflödet under riktig receipt import.
- Eventuell vidareutveckling av separat aliasöversikt om behov uppstår.
- Backend:
- Centralisera normalisering av
receiptNameså samma regler används i lookup, upsert och alias-inlärning. - Härda guardrails för alias: blockera tomma alias, uppenbart brus (
rabatt,summa,pant) och andra olämpliga kvittonamn. - Säkerställ deterministisk prioritet mellan privata och globala alias i receipt-import.
- Behåll nuvarande schema i första fasen; ingen ny migration behövs så länge nuvarande
ReceiptAlias-modell räcker.
- Centralisera normalisering av
- Flutter:
- Lägg alias-lärande nära manuell korrigering i receipt-import så användaren explicit kan välja att spara matchningen för framtida importer.
- Lägg en enkel aliasöversikt där användaren kan se och ta bort sina privata alias.
- Admin-UI ska kunna skapa globala alias utan att blanda ihop dem med vanliga användares privata alias.
- Tester:
- Verifiera att user alias alltid prioriteras före global alias för samma
receiptName. - Verifiera att global alias används när user alias saknas.
- Verifiera att vanlig användare inte kan skapa globala alias eller ta bort andras alias.
- Verifiera att manuell korrigering +
learnAliasger direkt träff vid nästa import. - Verifiera att normalisering gör alias robust mot versaler, whitespace och enklare stavningsvariationer.
- Verifiera att user alias alltid prioriteras före global alias för samma
- Leveransordning:
- ✅ Fas 1: backend-hardening + tester.
- ✅ Fas 2: UI-stöd i receipt import för alias-inlärning.
- 🟡 Fas 3: separat aliasöversikt för användare och admin (grund finns, kan vidareutvecklas vid behov).
- Målbild:
- ✅ [CLEANUP] Receipt import legacy code (2026-05-09): KLART
- Borttaget:
matchProducts(),enrichWithAiCategories(),findWordMatch()(gammal), m.fl. - Tester uppdaterade och gröna (66/66)
- Se
SESSION_2026-05-09_RECEIPT_IMPORT.mdför detaljer
- Borttaget:
- ✅ [FEATURE] Product Management & Scroll Fix (2026-05-09): KLART
- Scroll-issue i kvittoimport fixat (7 rader nu synliga)
- Admin rename/merge endpoints implementerade
- Private rename/merge endpoints för users implementerade
- Kodduplicering i products.service.ts eliminerad (~80 rader)
- admin_products_panel optimerad (cache, parallell restore, expression switches)
- Deploy-script förbättrad med selektiv build och seed-kontroll
- Se
SESSION_2026-05-09_RECEIPT_IMPORT.mdför detaljer - Todo: Deploy till prod, testa i live miljö, ev. add UI för user private rename/merge
- Stabilisera bildimport och diagnostik i alla miljöer.
- Lokalisera kvarvarande stora Flutter-vyer i import/inventarie.
- Förbereda avancerad AI-integration med tydlig loggning/audit.
- Påbörja EAN-stöd via Open Food Facts.
Beslut som styr arbetet
- User-scope for data som ar personligt agd.
- Backend-kontrakt ar sanningskalla; klienter foljer kontrakten.
- Importfunktionalitet ar delegerad till microservice-importer dar det ar beslutat.
Framtida förbättringsområden
Säkerhet: httpOnly cookies för Flutter Web
Idag lagras JWT-token i localStorage via SharedPreferences i Flutter Web. För att minska XSS-risk bör backend och Flutter Web stödja httpOnly-cookies för tokens. Detta kräver:
- Backend: endpoint för att sätta och läsa httpOnly-cookie vid login.
- Flutter Web: anpassning så att token inte läses från localStorage utan session hanteras via cookie. Detta är en större arkitekturändring och endast relevant för webben.
Säkerhet: Gitea webhook-signaturvalidering
Om Gitea-webhooks används, implementera endpoint i backend som validerar X-Gitea-Signature med timing-safe jämförelse. Lägg till GITEA_WEBHOOK_SECRET i .env.example. Se säkerhetshärdningsplanen för kodexempel.
Alternativa ingredienser — migrering till relationsmodell (Option B)
Nuläge: RecipeIngredient.alternativeProductIds lagras som JSON-kolumn (Option A).
Detta fungerar men saknar referensintegritet — om en alternativ produkt tas bort uppdateras inte kolumnen automatiskt.
Framtida lösning: Ersätt JSON-kolumnen med en separat tabell:
model RecipeIngredientAlternative {
id Int @id @default(autoincrement())
recipeIngredientId Int
recipeIngredient RecipeIngredient @relation(fields: [recipeIngredientId], references: [id], onDelete: Cascade)
productId Int
product Product @relation(fields: [productId], references: [id], onDelete: Cascade)
}
Fördelar: FK-integritet, möjlig sortering/prioritering av alternativ, lättare att querrya. Förutsättning: migration som konverterar befintlig JSON-data till rader i tabellen.
Relaterade dokument
README.md- anvandarperspektiv.TEKNISK_BESKRIVNING.md- teknisk huvudreferens.produktlansering.md- releasechecklista.migrering-MSI.md- migreringshistorik for importer.flutter/next_steps_flutter.md- Flutter-specifik plan._archive/microservice-ai/AI-FUNKTIONER.md- AI-strategi och historik.