nilsjohan/recipe-app
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
7f7e4c24a8d581e2fdb3a00d211f816a711ea8ee
recipe-app/_archive/microservice-todo/microservice-todo.md
T
Nils-Johan Gynther 1320f936ec Refactor technical documentation for clarity and updates 
- Updated "teknisk_beskrivning_flutter.md" to streamline content and remove outdated sections, focusing on architecture, environment, and recent technical additions.
- Enhanced "migrering-MSI.md" with post-migration updates and clarifications for target audience.
- Revised "produktlansering.md" to serve as a release checklist, ensuring it complements existing documentation without duplication.

Co-authored-by: Copilot <copilot@github.com>
2026-05-03 17:03:20 +02:00

5.0 KiB
Raw Blame History

Read memory

Dokumentstatus (2026-05-03)

Målgrupp

Detta arkivdokument är en historisk plan för framtida todo-microservice och riktar sig till utvecklare/arkitekter.

Kommentar utifrån senaste sessionerna

  • Fokus i senaste sessionerna har legat på kvittoimport, kategoriregler och klientpersistens i befintliga system.
  • Ingen aktiv implementation av todo-microservice har påbörjats i denna period.

Jag kan inte direkt flytta filer mellan minnesområdet och projektmappen, men här är hela planen. Kopiera och spara innehållet nedan som recipe-app/microservice-todo.md i din projektmapp:

Plan: Microservice-Todo (Shopping/Todo-list)

En skalbar, Dockeriserad microservice för shopping/todo-listor, med tight integration mot recipe-app men även möjlighet att köras fristående (SQLite fallback). Backend i NestJS/Prisma, REST API med JWT och användarscope, enkel Flutter-webbklient, och DevOps/CI/CD enligt befintliga mönster.

Steg

FAS 1: Backend och Databas

  1. Skapa nytt NestJS-projekt (t.ex. todo-api) med Prisma ORM.
  2. Definiera Prisma-schema för TodoList, TodoItem, och användarrelation (userId, foreign key mot User i recipe-db om integrerat, annars lokal User-tabell för standalone/SQLite).
  3. Implementera MariaDB som primär databas, med fallback till SQLite (env-styrd konfiguration).
  4. Skapa migreringar och seed-data för test/demo.
  5. Implementera JWT-baserad autentisering och användarscope på alla endpoints.
  6. Bygg REST API:
    • CRUD för listor och items (alla operationer användarspecifika)
    • Endpoint för att ta emot poster från recipe-app (t.ex. POST /api/todo/from-recipe)
    • Health endpoint (GET /health)
  7. Lägg till admin-endpoints (valfritt): lista alla användares listor/items, ta bort, återställ.

FAS 2: Dockerisering och DevOps

  1. Skriv Dockerfile (multi-stage, production-ready, .dockerignore).
  2. Lägg till service i compose.yml och ev. compose.override.yml för recipe-app.
  3. Automatisera migreringar vid start (entrypoint-script eller Docker CMD).
  4. Lägg till healthcheck i Docker och Compose.
  5. Dokumentera miljövariabler och konfigurationsmöjligheter (MariaDB/SQLite, JWT-secret, etc).

FAS 3: Flutter Webbklient

  1. Skapa nytt Flutter-projekt (t.ex. todo-flutter) enligt recipe-app-mönster.
  2. Implementera login (JWT), lista/skapa/ta bort todo-listor och items, markera som klar, enkel UI.
  3. Använd Riverpod, GoRouter, och ARB-lokalisering (svenska/engelska).
  4. Lägg till Dockerfile och Compose-service för Flutter-klienten.
  5. Testa integration mot backend (same-origin /api, JWT i header).

FAS 4: Integration och Extensibilitet

  1. Definiera API-kontrakt för integration med recipe-app (t.ex. POST /api/todo/from-recipe, schema för item-data).
  2. Lägg till möjlighet att skicka todo-poster från recipe-app (t.ex. via webhook eller direkt API-anrop).
  3. Förbered för framtida AI-funktioner (t.ex. smarta förslag, auto-kategorisering) med extensibel tjänstestruktur.

FAS 5: Testning och Verifiering

  1. Skriv integrationstester och E2E-tester för backend och frontend.
  2. Säkerställ DTO-validering och roll/accesskontroller.
  3. Testa fallback till SQLite (standalone-läge).
  4. Dokumentera testflöden och verifieringssteg.

Relevanta filer

  • todo-api/prisma/schema.prisma — datamodell och migreringar
  • todo-api/src/main.ts, app.module.ts — bootstrap och modulstruktur
  • todo-api/src/todo/todo.controller.ts — REST endpoints
  • todo-api/src/todo/todo.service.ts — affärslogik
  • todo-api/Dockerfile, .dockerignore — Dockerisering
  • todo-flutter/lib/ — Flutter-klientens kod
  • compose.yml, compose.override.yml — Compose-integration

Verifiering

  1. Alla endpoints kräver JWT och filtrerar på userId.
  2. CRUD på listor/items fungerar i både MariaDB och SQLite-läge.
  3. Flutter-klienten kan logga in, visa, skapa och markera todo-poster.
  4. Integration med recipe-app: poster kan skickas och dyker upp i todo-listan.
  5. Health endpoints och Docker healthchecks fungerar.
  6. Alla tester (integration/E2E) passerar.

Beslut och avgränsningar

  • Scope: Enkel todo/shopping-lista, användarscope, tight integration, men ingen avancerad AI/UX i v1.
  • Exkluderar: Mobilappar, avancerad AI, komplexa adminflöden, realtidsuppdateringar.
  • Följer recipe-apps patterns för auth, API, Docker, Compose, testning och lokalisering.

Vidare överväganden

  1. Hur ska användar-identity hanteras i standalone-läge? Rekommendation: lokal User-tabell med enkel auth.
  2. Hur ska recipe-app skicka poster? Rekommendation: direkt API-anrop med JWT, schema-dokumentation.
  3. Hur mycket adminfunktionalitet behövs? Rekommendation: börja enkelt, utöka vid behov.

Vill du ha planen i ett annat format eller med ytterligare detaljer?

Reference in New Issue View Git Blame Copy Permalink