feat: update README and technical documentation with user guidance, architectural details, and ongoing work plans

flutter/README.md

@@ -1,6 +1,6 @@
-# Flutter Frontend - User Guide
+# Flutter Frontend - Användarguide
 
-This README describes how to use the Flutter frontend for Recipe App from a user and operator perspective.
+Detta dokument beskriver hur du använder Flutter-frontenden för Recipe App ur ett användar- och operatörsperspektiv.
 
 ## Senaste ändringar (2026-04-25)
 
@@ -18,6 +18,33 @@ This README describes how to use the Flutter frontend for Recipe App from a user
 - **User-scope för pantry och matplan** — Alla baslager- och matplansdata är nu per användare (inte globala).
 - **UI/UX-förbättringar** — Produktval med bottenark (ProductPickerField), swipe-för-±1 på inventarielistan (SwipeableInventoryTile), och förbättrad felhantering.
 
+## Vad appen är
+
+Flutter-webben för Recipe App är en webbklient byggd med Flutter och körs i Docker med Caddy som proxy. Den är avsedd att ersätta den befintliga Next.js-frontenden och stödja framtida mobilklienter.
+
+## Aktuella användarflöden
+- Inloggning med användarnamn och lösenord.
+- Receptlista efter inloggning.
+- Profil-sida (grundversion).
+- Utloggning från recept- och profil-sidor.
+
+## Var man kommer åt appen
+- Testmiljö: `https://test.gynther.se`
+
+## Inloggningsdetaljer
+- Inloggning förväntar sig användarnamn, inte e-post.
+- Exempel på seedad admin-användare i backend: `Nadmin`.
+- Lösenordet kontrolleras av servermiljövariabeln (`ADMIN_NADMIN_PASSWORD`).
+
+## Kända begränsningar
+- Kvittoimport (Fas 6b) är påbörjad men granskningssteg och bulk-spara återstår.
+- Bildimport kräver att containrar är uppdaterade med senaste kod — kontrollera att diagnostikloggar syns vid felsökning.
+- Vissa adminfunktioner och avancerad AI-integration är planerade men ej migrerade.
+
+## Felsökning (användarnivå)
+1. Om sidan visar gammalt beteende efter deployment: hård uppdatering eller öppna i inkognitoläge.
+2. Om inloggning misslyckas: verifiera användarnamn/lösenord (inte e-post).
+
 ## Relaterade dokument
 - [next_steps_flutter.md](next_steps_flutter.md)
 - [teknisk_beskrivning_flutter.md](teknisk_beskrivning_flutter.md)