Initial vault setup

2026-06-09 18:40:21 +02:00
commit bda02d587f
3692 changed files with 402457 additions and 0 deletions
@@ -0,0 +1,136 @@
+---
+title: Telebugs
+created: 2026-06-07
+updated: 2026-06-07
+type: app
+tags: [catalogue, development, error-reporting, telegram, bot, observability]
+confidence: medium
+contested: false
+sources: [https://selfh.st/apps/?tag=Development, https://github.com/treezio/telebugs]
+---
+
+# 💻 Telebugs
+
+> Bot **Telegram** minimaliste pour **centraliser les rapports de bugs et d'erreurs** applicatives — un endpoint HTTP simple reçoit les exceptions, le bot les transmet dans un chat ou canal Telegram pour un triage rapide par l'équipe.
+
+## 📋 Informations Générales
+
+| Attribut | Valeur |
+|----------|--------|
+| **Nom** | Telebugs |
+| **Slug** | telebugs |
+| **Description** | Bot Telegram de bug reports / error reporting |
+| **Site officiel** | https://telebugs.app (à vérifier) |
+| **Repository** | https://github.com/treezio/telebugs (à vérifier) |
+| **Stars** | 0 ⭐ sur selfh.st |
+| **Licence** | MIT (à vérifier) |
+| **Langage** | Go / Python (à vérifier) |
+| **Catégorie** | Development |
+| **Note** | ⚠️ **Projet de niche (~0 ⭐)** — utile pour les **petites équipes** qui veulent centraliser leurs alertes dans Telegram sans déployer une stack Sentry/GlitchTip complète. |
+
+## 📝 Description
+
+**Telebugs** est un **bot Telegram open source** dont le rôle est de **collecter et dispatcher les rapports d'erreurs** applicatives vers un chat ou canal Telegram. Le concept est radicalement simple : une application cliente envoie une requête HTTP `POST` à Telebugs quand elle rencontre une exception, et Telebugs formate le payload en un message Telegram lisible dans un salon dédié.
+
+**Cas d'usage typiques** : remplacer ou compléter un **Sentry** / **GlitchTip** trop lourd pour un side-project, recevoir les erreurs d'un **cron** ou d'un **script de production** directement sur le téléphone du développeur, ou faire du **bug-bounty privé** où des testers externes soumettent des bugs via un canal Telegram public.
+
+**Fonctionnalités attendues** (à confirmer dans la doc) : endpoint HTTP simple avec token d'authentification, formatage automatique des stack traces, threading/grouping d'erreurs identiques, support de pièces jointes (screenshots, logs), filtrage par sévérité.
+
+**Positionnement vs Sentry** : Sentry / GlitchTip / Bugsnag sont des plateformes d'error tracking **complètes** (grouping, alerting, releases, source maps, performance). Telebugs joue le rôle inverse : **très léger**, **sans UI web dédiée** (tout se passe dans Telegram), **sans base complexe**. Adapté aux petites structures qui n'ont pas la volumétrie pour Sentry.
+
+**⚠️ Confiance faible** : 0 étoile sur selfh.st, projet récent et de niche. **Politique de sécurité à vérifier** (transmission en clair ? chiffrement ? stockage persistant ?). **Adapter la politique PII** : par défaut, les stack traces peuvent contenir emails, IPs, tokens — à **sanitizer côté application cliente** avant envoi.
+
+## 🚀 Installation
+
+### Via Docker (recommandé)
+
+```yaml
+# docker-compose.yml
+version: "3.8"
+services:
+  telebugs:
+    image: telebugs/telebugs:latest
+    container_name: telebugs
+    restart: unless-stopped
+    environment:
+      - TELEGRAM_BOT_TOKEN=123456:ABC-DEF...YZ
+      - TELEGRAM_CHAT_ID=-100123456789
+      - API_TOKEN=secret...ts
+      - LOG_LEVEL=info
+    ports:
+      - "8080:8080"
+    labels:
+      - "traefik.enable=true"
+      - "traefik.http.routers.telebugs.rule=Host(`telebugs.example.com`)"
+      - "traefik.http.routers.telebugs.entrypoints=websecure"
+      - "traefik.http.routers.telebugs.tls.certresolver=letsencrypt"
+    networks:
+      - proxy
+
+networks:
+  proxy:
+    external: true
+```
+
+### Création du bot Telegram
+
+```bash
+# 1. Parler à @BotFather sur Telegram, créer un bot, récupérer le token
+# 2. Ajouter le bot au canal/groupe cible, le promouvoir admin
+# 3. Récupérer le chat_id (via @userinfobot ou l'API getUpdates)
+# 4. Lancer le container avec les variables ci-dessus
+```
+
+### Envoi d'un rapport depuis une application
+
+```bash
+curl -X POST https://telebugs.example.com/report \
+  -H "Authorization: Bearer secret...ts" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "title": "NullPointerException in /api/users",
+    "severity": "high",
+    "stack": "...",
+    "context": {"user_id": 42, "endpoint": "/api/users"}
+  }'
+```
+
+## ⚙️ Configuration
+
+- **`TELEGRAM_BOT_TOKEN`** : fourni par @BotFather — **à garder secret**, permet le contrôle total du bot.
+- **`TELEGRAM_CHAT_ID`** : ID numérique du canal/groupe cible (négatif pour groupes, `-100…` pour supergroupes/canaux).
+- **`API_TOKEN`** : token d'authentification côté serveur HTTP — **distinct** du token Telegram, sert à authentifier les apps clientes.
+- **Sévérité** : à standardiser côté émetteur (`info`, `warning`, `error`, `critical`) pour permettre le filtrage Telegram.
+- **Sanitization PII** : Telebugs étant un **pass-through** (pas de PII store persistant par défaut), c'est côté **application cliente** qu'il faut **filtrer emails, IPs, tokens** avant envoi.
+
+## 🔗 Alternatives
+
+- **Sentry** — La référence de l'error tracking, **très complet** mais lourd (Docker Compose ou SaaS).
+- **GlitchTip** — Clone open source de Sentry, **plus léger**, auto-hébergeable, compatible SDK Sentry.
+- **[[app-bugsink]]** — Fork minimaliste de GlitchTip, focalisé sur la simplicité pour homelab.
+- **[[app-gotify]]** — Serveur de notifications auto-hébergé (push web + mobile), canal d'alertes générique.
+- **ntfy.sh** — Pub/sub HTTP simple, consommé par n'importe quel client.
+
+## 🔒 Sécurité
+
+- **Tokens en variables d'environnement** : `TELEGRAM_BOT_TOKEN` et `API_TOKEN` **ne doivent jamais** être commit dans le repo — `.env` gitignored ou secret manager.
+- **HTTPS obligatoire** : Telebugs reçoit potentiellement des données sensibles (stack traces, contexte applicatif) — **forcer HTTPS** via Traefik/Caddy.
+- **Rate limiting** : activer un rate limit sur l'endpoint `/report` (Traefik `crowdsec-bouncer` ou reverse-proxy dédié) pour éviter qu'un bug en boucle sature le canal Telegram.
+- **PII / RGPD** : les stack traces contiennent souvent des **données personnelles** (emails, IPs, chemins utilisateur) — **sanitizer côté émetteur** et **définir une politique de rétention** sur le canal Telegram (auto-suppression après N jours).
+
+## 📚 Ressources
+
+- [Site officiel Telebugs](https://telebugs.app) (à vérifier)
+- [Repository GitHub](https://github.com/treezio/telebugs) (à vérifier)
+- [Telegram Bot API — Documentation](https://core.telegram.org/bots/api)
+- [Selfh.st — Development](https://selfh.st/apps/?tag=Development)
+- [GlitchTip — Alternative plus complète](https://glitchtip.com)
+
+## 🔗 Pages Liées
+
+- [[cat-development]] — Catégorie Development
+- [[app-bugsink]] — Alternative error-tracking plus complète
+- [[app-gotify]] — Serveur de notifications push
+- [[app-traefik]] — Reverse-proxy HTTPS recommandé
+- [[securisation-home-lab]] — Bonnes pratiques de sécurité
+- [[recettes-docker-compose]] — Templates Docker