Heatmaps

​

Préalable

1. Une URL de site sur le projet (https://www.example.com). Lab et heatmaps partagent cette origine.
2. Le host visité doit correspondre (www et l’apex sont le même site).
3. La page doit être joignable publiquement (pas de login, pas de 401/403).
4. L’API doit avoir Chromium (playwright install chromium, déjà dans l’image Docker de l’API).

​

Déroulement

Ouverture /behavior/heatmaps?page=/pricing
        │
        ▼
GET /v1/analytics/heatmap/page-capture
  si pas de screenshot < 7 j → file Chromium
        │
        ▼
Le worker visite website_url + path, stocke un JPEG dans Minio
        │
        ▼
La densité de clics se superpose (mêmes % que les events click)

• Lazy : ouvrir un chemin le capture s’il manque ou a plus de 7 jours.
• Cron : POST /v1/internal/jobs/heatmap-captures (quotidien, X-Internal-Secret) recapture les chemins les plus cliqués.
• Recapturer cette page force un nouveau screenshot sans attendre le TTL.
• Les clics s’affichent même si le screenshot échoue. L’overlay n’est pas bloquant.

​

Config

cd apps/api
uv sync
uv run playwright install chromium

​

États