Aller au contenu

Services et données

Services Compose

Service Responsabilité Exposition par défaut
database PostgreSQL 16, vérité métier interne
redis cache, sessions, verrous interne
api FastAPI et migrations 8000 interne
admin UI nginx et proxy API 8080
bot Discord, OAuth et mutations de rôles 8081 interne
fivem FXServer et txAdmin 30120 TCP/UDP, 40120
docs site MkDocs Material statique 8001
logs-init création des fichiers de logs ponctuel
log-maintenance rotation des logs interne

Persistance

Les volumes nommés conservent PostgreSQL, Redis, les artefacts FXServer, txAdmin et les ressources FiveM. Chaque application dispose d'un volume de logs. L'API monte ceux des autres services en lecture seule pour la consultation administrative.

Les comptes sont liés de manière unique à Discord. Les personnages référencent leur compte et conservent identité, argent en dollars RP entiers, apparence, vêtements, position et état de recustomisation. Les notes whitelist, rôles administrés, grants, contenu du loading screen, actions de modération et audit sont persistés dans PostgreSQL.

Redis utilise notamment les clés préfixées :

gta:player:{fivem_identifier}
gta:character:{character_id}
gta:session:{source_id}
gta:lock:{resource}:{identifier}

Le préfixe est configurable avec REDIS_KEY_PREFIX.