Nils-Johan Gynther
87 lines
2.3 KiB
Markdown
87 lines
2.3 KiB
Markdown
# 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.
|