Architecture technique
Vue d'ensemble

Vue d'ensemble technique

ZelhayHost est une plateforme auto-hébergée, développée en interne, sans dépendance à un cloud provider tiers.

Briques principales

BriqueTech
FrontendsNext.js 16 (App Router) + React 19 + Tailwind
BackendNestJS 10 + Prisma
Hyperviseur VPSProxmox VE (KVM cluster, snapshots, VLAN vRack)
Panel GamePterodactyl (open-source)
Process managerpm2
Reverse proxynginx (un vhost par sous-domaine)
PaiementStripe (CB) + virement bancaire (validation manuelle)
Facturation élec.Factur-X (PDF/A-3 + XML CII) + UBL 2.1
Chiffrement secretsAES-256-GCM (CryptoService)

Sous-domaines exposés

  • zelhay-host.fr — vitrine publique
  • admin.zelhay-host.fr — espace client
  • game.zelhay-host.fr — panel Game
  • pro.zelhay-host.fr — vitrine Pro
  • console.zelhay-host.fr — console série web (xterm.js + WebSocket)
  • doc.zelhay-host.fr — cette doc

Tous les frontends parlent au même backend (/api/*, proxifié par nginx vers 127.0.0.1:3001).

Conventions

  • Routes API préfixées /api/<feature>/... côté NestJS.
  • Auth par cookie httpOnly zh_token (JWT HS256). Voir Authentification.
  • Format JSON partout (entrées/sorties).
  • Erreurs au format NestJS standard : { statusCode, message, error }.
  • Frontends et backend partagent la même origine en prod (pas de CORS à gérer).
Support & ticketsArchitecture