# PosterBell

> The doorbell for your conference poster. Visitors scan a QR code and ring the author
> (Telegram or e-mail notification with one-tap replies), download the poster PDF,
> or leave a message — while the author is at another session.

## What it is
PosterBell is a small self-hosted web service for scientific conferences:
- Authors create posters (title, optional PDF) and get a unique QR code.
- Visitors use a lightweight public page: ring / download / contact. No account or app needed.
- Authors are notified via the Telegram bot and e-mail, with reply actions
  ("On my way", "5 min", "15 min", "Leave contact").
- No trackers, no analytics; GDPR-aware with 30-day retention of rings/messages.

## Key pages
- / — landing page (what it is, how it works, FAQ)
- /auth — author signup (magic-link e-mail, no passwords)
- /privacy — privacy policy
- /p/{slug} — visitor page for one poster (indexable)

## How it works (HTTP)
- POST /p/{slug}/ring — visitor rings (rate-limited); returns { ref, afterMs, timeoutMs }
- GET /p/{slug}/ring/{ref} — visitor polls the ring status
- POST /p/{slug}/message — visitor contact form (name, optional e-mail, body, consent)
- GET /p/{slug}/poster — poster PDF download

## For LLM agents
This service is a simple REST + HTML app. No API key is required for the public
visitor endpoints above. There is no public JSON API beyond the ring/message
endpoints; the dashboard (/me) is session-protected.