Nils-Johan Gynther
49 lines
2.1 KiB
Markdown
49 lines
2.1 KiB
Markdown
# Microservice Importer
|
|
|
|
Intern import-tjänst (`importer-api`) för [recipe-app](../recipe-app). Den hanterar URL-skrapning, OCR, PDF-parsning och AI-kvittoparsning utan databas. Tjänsten körs som Docker-tjänst på det interna `recipe-internal`-nätverket och exponeras inte externt.
|
|
|
|
## Dokumentstatus (2026-05-12)
|
|
|
|
Det här dokumentet är skrivet för systemadministratörer och utvecklare som driftar eller vidareutvecklar importtjänsten. För arkitektur, drift och tekniska detaljer, se [TEKNISK_BESKRIVNING.md](TEKNISK_BESKRIVNING.md). För roadmap och prioriteringar, se [next_steps_MSImporter.md](next_steps_MSImporter.md).
|
|
|
|
## Vad tjänsten gör
|
|
|
|
- Tar emot URL:er, filer och markdown för importflöden
|
|
- Skrapar receptsidor och extraherar `imageUrl` när det finns
|
|
- Kör OCR för bilder och skannade dokument
|
|
- Tolkar kvitton via Mistral AI
|
|
- Returnerar strukturerad data till recipe-app utan att lagra någon session eller databaspost
|
|
|
|
## Flöden
|
|
|
|
- `POST /api/quick-import` för URL-skrapning, bild-OCR och PDF-import
|
|
- `POST /api/recipes/parse-markdown` för markdown till strukturerat recept
|
|
- `POST /api/receipt-import/parse` för kvittobild eller PDF till `ParsedReceiptItem[]`
|
|
- `GET /api/health` för Docker healthcheck
|
|
|
|
## Viktigt
|
|
|
|
- Inga absoluta Windows-sökvägar ska användas i kod eller scripts
|
|
- Tjänsten är stateless
|
|
- Ingen databas är konfigurerad i tjänsten
|
|
- Host-port 3001 används av `wetty` på servern och får därför inte exponeras av importtjänsten
|
|
|
|
## Kort faktadel
|
|
|
|
- Runtime: Node.js 22-alpine
|
|
- Ramverk: NestJS 11 + TypeScript 5
|
|
- OCR: `tesseract.js`
|
|
- PDF: `pdf-parse` med `pdfjs-dist/legacy` fallback
|
|
- AI: `@mistralai/mistralai`
|
|
- Upload: `multer` 2.1.1
|
|
- Alpine-paket: `tesseract-ocr`, `tesseract-ocr-data-swe`, `tesseract-ocr-data-eng`
|
|
|
|
### Saker att veta efter uppgradering
|
|
|
|
- Backendberoenden är uppgraderade till NestJS 11-serien och `multer` 2.1.1 för att adressera kända audit-varningar.
|
|
- CI/node-miljö bör vara Node.js 22 (eller minst Node.js 20.11 för Nest CLI 11).
|
|
|
|
## Support
|
|
|
|
- Git repo: Gitea på `192.168.50.2:2222/nilsjohan/microservice-importer`
|