docs: add README
This commit is contained in:
@@ -0,0 +1,37 @@
|
|||||||
|
# Korting — prijstracker
|
||||||
|
|
||||||
|
Houdt een lijst productpagina's dagelijks in de gaten en mailt wanneer
|
||||||
|
de prijs verandert.
|
||||||
|
|
||||||
|
## Lokaal draaien
|
||||||
|
|
||||||
|
```bash
|
||||||
|
npm install
|
||||||
|
cp .env.example .env # env vars invullen
|
||||||
|
npm test
|
||||||
|
npm start
|
||||||
|
```
|
||||||
|
|
||||||
|
De UI staat achter basic auth (`BASIC_AUTH_USER` / `BASIC_AUTH_PASS`) op
|
||||||
|
`http://localhost:3000`.
|
||||||
|
|
||||||
|
## Environment variables
|
||||||
|
|
||||||
|
| Variabele | Omschrijving |
|
||||||
|
|---|---|
|
||||||
|
| `PORT` | HTTP-poort (default `3000`) |
|
||||||
|
| `DB_PATH` | Pad naar het SQLite-bestand (default `./data/korting.db`) |
|
||||||
|
| `BASIC_AUTH_USER` / `BASIC_AUTH_PASS` | Login voor de web-UI |
|
||||||
|
| `SMTP_HOST` / `SMTP_PORT` / `SMTP_USER` / `SMTP_PASS` | SMTP-server (Postal op `mail.sjoerd.app`) |
|
||||||
|
| `SMTP_FROM` | Afzenderadres van de notificatiemails |
|
||||||
|
| `NOTIFY_EMAIL` | Ontvangeradres van de notificatiemails |
|
||||||
|
|
||||||
|
## Hoe het werkt
|
||||||
|
|
||||||
|
Elke dag om 08:00 (Europe/Amsterdam) doorloopt de app alle producten,
|
||||||
|
haalt de huidige prijs op (JSON-LD → meta tags → regex-fallback), en
|
||||||
|
stuurt een email als de prijs is veranderd sinds de vorige geslaagde
|
||||||
|
check. Een mislukte poging (pagina onbereikbaar, geen prijs gevonden,
|
||||||
|
of de mail kon niet verstuurd worden) verandert de opgeslagen prijs
|
||||||
|
niet, zodat de volgende dag opnieuw wordt geprobeerd. Via de "Nu
|
||||||
|
controleren"-knop in de UI kan dit ook handmatig getriggerd worden.
|
||||||
Reference in New Issue
Block a user