Note : Tout ce qui touche à FFmpeg et S3 sera optionnel dans un premier temps. Si une solution pour trouver les fichiers .rofl est trouvée, alors nous l'implémenterons, sinon c'est chaud dehors.

Un monolithe 100% TypeScript pour une app de scouting communautaire League of Legends : profils joueurs, double notation (experts vs public), tags, clips, suivi mercato, comparaison, et ingestion multi-sources (Riot, Leaguepedia, GRID…).

Construire une app de scouting (communautaire) — pas une énième app de data :

• Profil joueur : identité, ranks (rank/top rank), ligue, pays, langues, équipe & fin de contrat, liens (OPGG, DPM, Liquipedia…), tags ("OTP", "Utilitaire", "Aggressif", "Drama", "Sioniste", ...).
• Notation à la RottenTomatoes :
  • Experts (validés) : note + justification (texte, PDF/diapo).
  • Public (bronzes) : note séparée + commentaire.
  • Réputation → promotion auto en “expert” si contributions concordantes.
• Votes & mise en avant : like/“validé”, tendances (semaine, nouveaux profils), filtres par tags.
• Clips & gameplay : extraits ajoutés par les scouts (upload direct S3 → transcodage FFmpeg → lecture HLS).
• Historique type Transfermarkt : équipes/rosters/coach, titres, rumeurs & suivi de dossier.
• Notifications : suivi joueurs (rumeur, fin de contærat, live).
• Ingestion : Riot Dev API, Leaguepedia/Liquipedia, LoL Esports, Twitch/YouTube, GRID (si on arrive à gratter un compte).

Processus simple pour contribuer avec des branches propres, commits normalisés et githooks activés.

• Point de départ : créez toujours votre branche depuis main.
• Nommages des branches: utilisez l'un des préfixes suivants :
  • feat/ pour une nouvelle fonctionnalité
  • fix/ pour une correction de bug
  • docs/ pour des modifications de documentation
  • style/ pour des changements de style (formatage, espaces, etc.)
  • refactor/ pour des refactorisations de code
  • test/ pour des ajouts ou modifications de tests
  • chore/ pour des tâches diverses (mise à jour de dépendances, scripts, etc.)
  • ci/ pour des modifications liées à l'intégration continue
  • perf/ pour des améliorations de performance
  • integration/ pour des branches liées à l'intégration avant une fusion

** Créer une branche **

# Depuis main
git checkout main
git pull origin main

# Créez une nouvelle branche avec le préfixe approprié
git checkout -b feat/ma-nouvelle-fonctionnalite

** Commits - Conventional Commits **

Respectez le format: <type>(<scope>): <message> Types usuels: feat, fix, docs, style, refactor, test, chore, ci, perf, integration Référez-vous à https://www.conventionalcommits.org/fr/v1.0.0/

Exemples:

• feat(auth): ajouter la connexion OAuth
• fix(api): corriger le bug de pagination
• docs(readme): mettre à jour les instructions d'installation
• test(api): couvrir GET /api/players

** Installer les githooks **

Exécuter le script d’installation des hooks pour valider automatiquement le format des commits et lancer les checks locaux.

# Rendre exécutable et lancer le script d'installation
chmod +x scripts/setup-githooks.sh
./scripts/setup-githooks.sh

Après installation:

• Le hook commit-msg valide le format Conventional Commits.
• Le hook pre-commit peut lancer lint/typecheck/test selon la configuration.

** Vérifications locales **

bun run lint
bun run typecheck
bun run test

** Ouvrir une PR **

git push -u origin feature/ajout_page_profil
# Ouvrir une Pull Request vers la branche souhaiter sur GitHub

Front (SPA)

• React + Vite (dev & build avec Bun)
• React Router, TanStack Query
• Tailwind + shadcn/ui
• Recharts (Graphique)
• Service Worker (Web Push)

Back (Monolithe TS)

• Hono (HTTP basé Fetch) sur Bun
• Prisma ≥ 5.12 ↔ PostgreSQL
• Redis (sessions, rate-limit, compteurs)
• BullMQ (jobs) + bull-board (dashboard) — via ioredis
• BetterAuth (OAuth Discord/Google) — cookies signés
• S3-compatible (Scaleway/OVH/Wasabi) pour médias
• FFmpeg (transcodage HLS + thumbnails), spawn via Bun

Ops

• Docker + Nginx (reverse proxy + statiques)
• CI GitHub Actions (lint/test/build/migrate/quality)

frontend/              # React + Vite (SPA)
    src/
    public/
    index.html
    vite.config.ts

backend/               # Hono (API) + workers BullMQ sur Bun
    src/
        api/               # Routes et contrôleurs Hono
        workers/           # BullMQ workers (ingestion, transcode, notifs)
        lib/               # Utilitaires (db, auth, storage, rbac)
        clients/           # SDK Riot, Leaguepedia, Twitch, GRID, LoL Esports
    prisma/              # Schema Prisma + migrations

infra/
    docker-compose.yml
    nginx.conf
    
scripts/             # Scripts divers (seed, migrate, etc.)

Créez un .env à la racine :

# Base
NODE_ENV=development
APP_ORIGIN=http://localhost

# API
PORT=8080

# DB
DATABASE_URL=postgresql://app:app@postgres:5432/app
æ
# Redis
REDIS_URL=redis://redis:6379

# Auth
AUTH_SECRET=change-me
OAUTH_DISCORD_CLIENT_ID=xxx
OAUTH_DISCORD_CLIENT_SECRET=xxx
OAUTH_GOOGLE_CLIENT_ID=xxx
OAUTH_GOOGLE_CLIENT_SECRET=xxx

# S3
S3_ENDPOINT=https://s3.fr-par.scw.cloud
S3_REGION=fr-par
S3_BUCKET=bsc-clips
S3_ACCESS_KEY_ID=xxx
S3_SECRET_ACCESS_KEY=xxx

# FFmpeg
FFMPEG_PATH=/usr/bin/ffmpeg

Accès

• Front SPA : http://localhost/
• API health : http://localhost/api/healthz
• Bull Board : http://localhost/admin/queues

# Installer Bun https://bun.sh
bun --version

# Installer les dependances
bun install

# Prisma
bunx prisma generate
bunx prisma migrate dev
bunx prisma db seed

# API (Hono + Bun)
bun --filter @apps/api dev     # http://localhost:8080

# Worker (BullMQ)
bun --filter @apps/worker dev

# Front (Vite)
bun --filter @apps/web dev     # http://localhost:5173

• GET /api/players?query=&role=&region=&tag=&sort=
• GET /api/players/:id (profil + stats + liens + clips)
• POST /api/players/:id/votes (rate-limit + idempotence via Redis)
• POST /api/players/:id/reviews (expert/public, pièces jointes S3)
• POST /api/players/:id/tags / DELETE /api/players/:id/tags/:tagId
• GET /api/compare?A=id&B=id&metrics=kda,dpm,csPerMin
• POST /api/players/:id/clips:signed-url → PUT direct S3 depuis le navigateur
• POST /api/webhooks/storage → enqueue media.transcode(clipId)

Convention : toutes les mutations exigent session OAuth (Discord/Google) et passent par RBAC + rate-limit Redis + idempotency key.

Queues : grid, riot, leaguepedia, media, notifs
Repeatable jobs :

• ingest.riot.* (delta) — 15 min
• ingest.leaguepedia.rosters — 6 h
• ingest.esports.schedule — 1 h
• twitch.status — 5 min
• reputation.evaluate — 1 h
• leaderboards.recompute — 15 min

• OAuth (Discord/Google) via BetterAuth → cookies HTTP-only.
• RBAC + réputation (promotion auto “expert”).
• Rate-limit IP+user (Redis), idempotency keys (votes, webhooks).
• Audit log des modérations.
• Sanitisation des liens externes (opgg/liquipedia/twitter).

• Prisma : utilisez Prisma ≥ 5.12 (ou version actuelle compatible Bun). bunx prisma generate & migrate OK.
• BullMQ / ioredis : compatibles sous Bun (Node-API support). Prenez des versions récentes.
• Vite : lancé via Bun (bun --filter @apps/web dev).
• Modules natifs : vérifiez la compatibilité Bun si vous en ajoutez.

{
  "scripts": {
    "build": "bun run -b apps/web && bun run -b apps/api && bun run -b apps/worker",
    "dev": "bun run -b apps/api & bun run -b apps/worker & bun run -b apps/web",
    "lint": "biome check .",
    "typecheck": "tsc -b",
    "migrate": "bunx prisma migrate deploy",
    "seed": "bunx prisma db seed",
    "prisma:gen": "bunx prisma generate",
    "test": "vitest run"
  }
}

1. Ingestion Riot + Leaguepedia (snapshots, rosters)
2. Liste & fiche joueur (liens rapides, tags, votes)
3. Reviews public/expert + réputation
4. Comparateur 2 joueurs (normalisation rôle & patch)
5. Upload clips S3 → transcodage HLS → lecture
6. Suivi de dossier (rumeurs/officiel) + notifications

Apache License 2.0