New import in version 0.1

2026-04-11 15:38:24 +02:00
parent 8552c6f757
commit 5448da1b98
12 changed files with 868 additions and 7 deletions
@@ -0,0 +1,86 @@
+# Recipe App
+
+En fullstack-applikation för hantering av hemmavaror och recept. Håll koll på vad du har hemma, spara recept och se direkt om du har allt du behöver för att laga en rätt.
+
+> För teknisk detaljinformation, se [TEKNISK_BESKRIVNING.md](TEKNISK_BESKRIVNING.md).
+
+---
+
+## Funktioner
+
+- **Hemmavaror** — lägg till, redigera och konsumera varor. Filtrera på plats och bäst före-datum.
+- **Recept** — skapa och redigera recept med ingredienser och tillagningsinstruktioner (Markdown-stöd).
+- **Receptjämförelse** — se direkt vilka ingredienser du har hemma och vad som saknas.
+- **Importera recept från Markdown** — klistra in ett recept i ett enkelt textformat, granska matchade produkter och spara med ett klick.
+- **Admin: Produkter** — hantera produktnamn och slå ihop dubbletter.
+
+---
+
+## Kom igång
+
+### Förutsättningar
+
+- Docker och Docker Compose
+- En `proxy`-nätverk i Docker (extern, hanteras av Caddy eller liknande)
+
+### Starta applikationen
+
+```bash
+# Bygg och starta alla tjänster
+docker compose build
+docker compose up -d
+```
+
+### Bygg om enbart backend (t.ex. efter kodändringar)
+
+```bash
+docker compose build recipe-api
+docker compose up -d recipe-api
+```
+
+---
+
+## Importera recept från Markdown
+
+Gå till **Recept → Lägg till nytt recept → Importera från Markdown** och klistra in ett recept i följande format:
+
+```markdown
+# Köttfärssås
+
+En klassisk köttfärssås med massa smak.
+
+## Ingredienser
+- 500 g köttfärs
+- 1 st lök
+- 2 msk tomatpuré
+- 1 dl grädde (vispgrädde)
+
+## Tillvägagångssätt
+Hacka löken och stek den mjuk i lite olja. Tillsätt köttfärsen...
+```
+
+Systemet tolkar texten, föreslår matchande produkter från databasen och låter dig granska och justera innan receptet sparas.
+
+---
+
+## Projektstruktur
+
+```
+recipe-app/
+├── frontend/                  # Next.js (App Router)
+├── backend/                   # NestJS REST API
+├── recipe-document-converter/ # Markdown-parserbibliotek
+├── db/init/                   # SQL-initialiseringsskript
+├── compose.yml                # Docker Compose
+└── backup_recipe_app.sh       # Backupskript
+```
+
+---
+
+## Backup
+
+```bash
+bash backup_recipe_app.sh
+```
+
+Säkerhetskopierar källkod och Docker-images till konfigurerad backupmapp.