From 9028c79215f983e40dc61511bfa2122ef7525bdf Mon Sep 17 00:00:00 2001 From: Nils-Johan Gynther Date: Thu, 23 Apr 2026 21:48:56 +0200 Subject: [PATCH] feat: add initial microservice-todo plan with detailed steps for implementation and integration --- _archive/microservice-todo.md | 79 +++++++++++++++++++++++++++++++++++ 1 file changed, 79 insertions(+) create mode 100644 _archive/microservice-todo.md diff --git a/_archive/microservice-todo.md b/_archive/microservice-todo.md new file mode 100644 index 00000000..21a1573d --- /dev/null +++ b/_archive/microservice-todo.md @@ -0,0 +1,79 @@ +Read memory [](file:///c%3A/Users/Nils-JohanGynther/AppData/Roaming/Code/User/workspaceStorage/e6ea1b0bd55239bec87a0a6ab7819f74/GitHub.copilot-chat/memory-tool/memories/NTkxM2ZhMmYtYjViYi00YTE0LTg2NGEtNmYyYzZjMTcxNWEw/microservice-todo.md) + +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 +8. Skriv Dockerfile (multi-stage, production-ready, .dockerignore). +9. Lägg till service i compose.yml och ev. `compose.override.yml` för recipe-app. +10. Automatisera migreringar vid start (entrypoint-script eller Docker CMD). +11. Lägg till healthcheck i Docker och Compose. +12. Dokumentera miljövariabler och konfigurationsmöjligheter (MariaDB/SQLite, JWT-secret, etc). + +### FAS 3: Flutter Webbklient +13. Skapa nytt Flutter-projekt (t.ex. `todo-flutter`) enligt recipe-app-mönster. +14. Implementera login (JWT), lista/skapa/ta bort todo-listor och items, markera som klar, enkel UI. +15. Använd Riverpod, GoRouter, och ARB-lokalisering (svenska/engelska). +16. Lägg till Dockerfile och Compose-service för Flutter-klienten. +17. Testa integration mot backend (same-origin /api, JWT i header). + +### FAS 4: Integration och Extensibilitet +18. Definiera API-kontrakt för integration med recipe-app (t.ex. POST /api/todo/from-recipe, schema för item-data). +19. Lägg till möjlighet att skicka todo-poster från recipe-app (t.ex. via webhook eller direkt API-anrop). +20. Förbered för framtida AI-funktioner (t.ex. smarta förslag, auto-kategorisering) med extensibel tjänstestruktur. + +### FAS 5: Testning och Verifiering +21. Skriv integrationstester och E2E-tester för backend och frontend. +22. Säkerställ DTO-validering och roll/accesskontroller. +23. Testa fallback till SQLite (standalone-läge). +24. 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? \ No newline at end of file