BKBCK‑Inc • Docs

FR | EN

">LuckyScale

Bot Discord orienté gamification qui orchestre événements, drops rares et classements dynamiques pour les communautés BCK‑Inc.

Demander un accès  •  GitHub Blaackknight

Fonctionnalités clés

Modules centrés sur l’engagement communautaire et le suivi des compétitions.

Gamification

  • Points chance par mission, présence et participation vocale.
  • Classements hebdomadaires et saisonniers avec paliers.
  • Roues aléatoires et coffres mystères déclenchés par les modérateurs.
  • Quêtes dynamiques publiées dans des salons dédiés.

Automations

  • Gestion automatique des salons d’évènements.
  • Notifications ciblées pour drops, records et finales.
  • Exports CSV programmés pour intégration BI.
  • Webhooks entrants vers d’autres bots BCK‑Inc.

Architecture

Conçu pour tourner de manière fiable sur serveurs mutualisés ou déploiements Docker.

Stack technique

  • Node.js 20, discord.js 14, TypeScript strict.
  • PostgreSQL 14, Redis pour le cache.
  • BullMQ pour jobs différés (tirages, rappels).
  • Prometheus + Grafana (latence, taux d’erreur).

Déploiement

  • Docker Compose (bot, base, redis, grafana).
  • CI GitHub Actions pour lint, tests et build.
  • Rolling updates (Watchtower / ArgoCD).
  • Backups chiffrés quotidiens sur stockage S3.

Mise en route

Checklist pour préparer un serveur avant l’intégration du bot.

Pré‑requis

  1. Créer un rôle LuckyScale Admin avec permissions.
  2. Configurer #luckyscale-log et #luckyscale-events.
  3. Collecter les IDs : serveur, salons, rôles spéciaux.
  4. Partager les webhooks entrants des dashboards.

Invitation & configuration

  • Utiliser l’URL d’invitation fournie (scopes applications.commands, bot).
  • Lancer /luckyscale setup pour mapper salons et options.
  • Définir les récompenses via /luckyscale rewards.
  • Créer des évènements via /luckyscale event create.

Opérations & support

Bonnes pratiques pour garder LuckyScale performant.

Maintenance

  • Mettre à jour : docker compose pull puis up -d.
  • Surveiller les logs pour quotas et latence.
  • Journalisation JSON dans logs/luckyscale-YYYYMMDD.jsonl.
  • Alertes Grafana: latence > 2s, erreurs > 3%.

Escalade

  • Ticket Discord #luckyscale-support.
  • Transmettre logs et captures.
  • Issues privées: contact@bck-inc.fr.
  • Roadmap premium sur demande.

Ressources

Documentation

  • Guide d’administration (PDF) lors de l’onboarding.
  • Tableau Notion pour saisons et récompenses.
  • Playbooks incidents (connexion, quotas Discord).
  • Accès Git privé sur demande.

Contact & support

  • Email : contact@bck-inc.fr.
  • Discord : salon #luckyscale-support.
  • Mises à jour : canal #luckyscale-release.
  • Feedback : call mensuel pour admins.