docs(release): update documentation for AI trace and flyer import improvements

- Update NEXT_STEPS.md with completed AI trace persistence and admin panel enhancements
- Add new section for executed steps (2026-05-21) documenting AI trace integration
- Update README.md with new AI trace features and improvements
- Enhance TEKNISK_BESKRIVNING.md with detailed technical description of AI trace implementation
- Document backend flow, persistence, masking, and UI improvements
- Add next steps including retention policy and API filtering for AiTrace

NEXT_STEPS.md

@@ -1,11 +1,20 @@
-## Utforda steg (2026-05-20)
+## Utforda steg (2026-05-20)
 
 - [x] **Deploy-script uppdaterat:** `deploy.sh` forenklat genom att ta bort `--migrate`; `--clean-database` kor nu migrering explicit innan rensning.
 - [x] **Prisma-integrering i deploy:** `--clean-database` kor `prisma migrate deploy` i `recipe-api` med explicit schema-parameter for att sakerstalla uppdaterat schema fore SQL-rensning.
 - [x] **Loggsynlighet for Prisma Client:** `deploy.sh` visar nu output fran `npx prisma generate` i terminalen vid migreringsrelaterade deployfloden.
 - [x] **Databasrensning standardiserad:** Ny underhallsfil `backend/prisma/maintenance/clean-database.sql` skapad for reset som bevarar kategorier.
 - [x] **Produktionsnara fel rattat:** `clean-database.sql` korrigerad efter serverfel (`Table 'ShoppingList' doesn't exist`).
-- [x] **Tabellista hardad:** SQL-filen anvander nu existerande tabeller i nuvarande Prisma-schema och tar bort beroenden i saker ordning med `FOREIGN_KEY_CHECKS`.
+- [x] **Tabellista hardad:** SQL-filen anvander nu existerande tabeller i nuvarande Prisma-schema och tar bort beroenden i saker ordning med `FOREIGN_KEY_CHECKS`.
+
+## Utförda steg (2026-05-21)
+
+- [x] **Flyer AI-trace persisteras:** `AiFlyerParserService` returnerar trace-data (prompt/rawOutput/chunkCount/retryCount) och `FlyerImportService` sparar detta i `AiTrace` med `source=flyer`.
+- [x] **Admin AI observability utökad:** `AiTraceService` hämtar kompletterande flyer-trace via `sessionId` och exponerar prompt/output/retry/chunk i detaljvyn.
+- [x] **Maskning i trace-detail:** känslig data maskas konsekvent i prompt/raw output/normaliserad output innan retur till admin-UI.
+- [x] **Flyer-kvalitet:** dedupe justerad för att minska dubletter utan att slå ihop olika kampanjer; hårdostnamn använder korrekt åäö.
+- [x] **Kontextstyrd OCR-korrigering:** kända fel (ex. `Pröd`) korrigeras endast i relevant textkontext för att minska falska rättningar.
+- [x] **Flutter Admin AI-panel UX:** selekterbar prompt/output, varningspanel med kopiering och output-trunkering med expandera/kollapsa.
 
 # Nasta steg
 
@@ -158,10 +167,12 @@ MVP ar uppnadd nar en vanlig anvandare kan importera, granska och spara kvitto/r
    - Deploy-script förbättrad med selektiv build och seed-kontroll
    - Se `SESSION_2026-05-09_RECEIPT_IMPORT.md` för detaljer
    - **Todo:** Deploy till prod, testa i live miljö, ev. add UI för user private rename/merge
-4. Verifiera flyerimportens sessionhydrering end-to-end i test/staging (tab-byte + app-omstart).
-5. Lokalisera kvarvarande stora Flutter-vyer i import/inventarie.
-6. Förbereda avancerad AI-integration med tydlig loggning/audit.
-7. Påbörja EAN-stöd via Open Food Facts.
+4. Verifiera flyerimportens sessionhydrering end-to-end i test/staging (tab-byte + app-omstart).
+5. Lägg till retention-policy och schemalagd rensning för `AiTrace` (receipt/flyer) för att styra datalivslängd i produktion.
+6. Lägg till API-stöd för filtrering av trace-lista på `status` och fri textsökning i varningskoder.
+7. Lokalisera kvarvarande stora Flutter-vyer i import/inventarie.
+8. Förbereda avancerad AI-integration med tydlig loggning/audit.
+9. Påbörja EAN-stöd via Open Food Facts.
 
 ## Beslut som styr arbetet