commit 1c798efe15d12153d038ac94fe3d6e53b67e2dcd
Author: Jose Lago <jose@lago.dev>
Date:   Tue Jun 16 19:04:14 2026 +0200

    init: scaffold project structure

diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000..af9e8d7
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1,21 @@
+# Environment / secrets
+.env
+
+# Runtime data
+data/
+
+# Python
+worker/src/__pycache__/
+worker/src/*.pyc
+worker/src/.venv/
+
+# IDE
+.vscode/
+.idea/
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Docker
+*.log
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..ee5acf8
--- /dev/null
+++ b/README.md
@@ -0,0 +1,34 @@
+# willhaben-tracker
+
+Telegram bot + scraper for willhaben.at classified ads. Self-hosted on Unraid via Docker Compose.
+
+## Stack
+
+- **Postgres 15** with Supabase (PostgREST, Kong)
+- **Python worker** — Telegram long polling + scrape scheduler
+- **Docker Compose** deployed via Portainer at `/mnt/user/appdata/willhaben-tracker`
+
+## Quick Start
+
+```bash
+cp .env.example .env
+# Edit TELEGRAM_BOT_TOKEN and POSTGRES_PASSWORD in .env
+docker compose up -d
+```
+
+## Telegram Commands
+
+- `/start` — Welcome + usage instructions (whitelisted only)
+- `/add "keyword"` — Create new search query
+- `/list` — Show active queries
+- `/pause <id>` / `/resume <id>` — Toggle query
+- `/delete <id>` — Remove query
+- `/stats` — Tracking statistics
+
+## Ports
+
+| Service | Port |
+|---------|------|
+| Kong API | `55621` |
+| Studio | `55630` |
+| Postgres | `55632` |