Transaction

Transactions

Description

Cette page permet de transférer des crédits à d’autres joueurs et de suivre vos transactions.

Elle permet :

• d’envoyer des crédits
• de consulter les transactions envoyées et reçues
• de filtrer et rechercher dans l’historique

👉 Une transaction peut ne pas être immédiate selon l’état du serveur ou des joueurs.

Accès

Depuis le menu principal :

• Joueur → Transactions

Accès

Vue de l’écran

Écran principal

Écran des transactions

L’écran est divisé en deux zones :

• en haut : Envoi de crédits
• en bas : Historique des transactions

Envoyer des crédits

Zone d’envoi

Zone d’envoi de crédits

Champs

• Univers

 → serveur sur lequel effectuer la transaction  
 (ex : Univ2 - Sans CPU)

• Destinataire

 → joueur sélectionné dans la liste

• SteamID

 → permet de saisir un joueur manuellement  
 (utile s’il n’apparaît pas dans la liste)

• Montant

 → crédits à envoyer

• Message

 → texte libre associé à la transaction

Envoi

Cliquez sur Envoyer.

✔️ Si tout est valide :

• un message s’affiche :

 → OK (ID xxx - Frais xxx - Total débité xxx)

• la transaction apparaît dans l’historique
• le statut passe à Créée

Exemple réel :

• Montant : 100
• Frais : 1000
• Total débité : 1100

Contraintes

• impossible de s’envoyer des crédits à soi-même
• le montant doit être > 0
• un seul transfert en cours à la fois (côté serveur)

Historique des transactions

Zone historique

Fichier:Ecran transactions joueur historique.png

Historique des transactions

Colonnes

• ID → identifiant interne
• Univers → serveur concerné
• Sens

 * Envoyé
 * Reçu

• Autre joueur → joueur concerné
• Montant → montant principal
• Frais → frais appliqués
• Statut → état actuel
• Créée le → date de création
• Terminée le → date de fin (si applicable)
• Description → message

Exemple réel

Transaction affichée :

• ID : 138
• Univers : Univ2 - Sans CPU
• Sens : Envoyé
• Joueur : babyloune
• Montant : 100
• Frais : 1000
• Statut : Créée

👉 Cela signifie que la transaction est enregistrée mais pas encore exécutée.

Filtres

Situés au-dessus de l’historique :

• Statut (par défaut : En cours)
• Type
• Sens
• Recherche

Recherche possible sur :

• pseudo
• GUID
• description
• ID

👉 Les filtres s’appliquent instantanément.

Actions

Actualiser

Recharge les transactions depuis le serveur.

Détails

Affiche les informations complètes d’une transaction.

Copier GUID

Copie l’identifiant unique.

Statuts des transactions

Cycle normal

• 1. Créée
• 2. Débit en attente
• 3. Débitée
• 4. Crédit en attente
• 5. Terminée

Important

👉 Une transaction peut rester bloquée en :

• Créée
• Débit en attente
• Crédit en attente

si :

• le joueur source est hors ligne
• le joueur cible est hors ligne
• le serveur est indisponible

Cas d’erreur

• Échec → erreur technique
• Annulée → arrêt manuel
• Rollback → remboursement automatique après problème

Fonctionnement réel

• la transaction est créée dans la BAO
• elle est traitée en arrière-plan côté serveur
• le système attend que les joueurs soient connectés
• le débit et le crédit se font séparément

👉 Le transfert n’est donc pas instantané.

Architecture technique

Le système de transactions repose sur 3 composants principaux :

• Client (Boîte à Outils)

 → envoie les demandes de transfert et affiche l’historique

• API BAO

 → enregistre les transactions et pilote leur exécution

• Serveur Empyrion (mod Credits)

 → applique réellement les crédits en jeu

👉 Les crédits ne sont jamais modifiés directement par le client. Tout passe par l’API serveur.

Traitement en arrière-plan

Les transactions sont traitées automatiquement par un service serveur.

Ce service :

• vérifie les transactions toutes les 30 secondes
• traite les transactions par lot
• priorise les joueurs qui viennent de se connecter

👉 Une transaction n’est donc jamais exécutée immédiatement. Elle est prise en charge par un worker.

Priorités de traitement

• 1. Joueurs qui viennent de se connecter
• 2. Transactions en attente
• 3. Transactions expirées

👉 Cela permet d’accélérer les transferts dès qu’un joueur revient en ligne.

Gestion des joueurs hors ligne

Le système gère automatiquement les joueurs hors ligne.

Cas 1 : joueur source hors ligne

• la transaction reste en attente
• elle sera exécutée à sa prochaine connexion

Cas 2 : joueur cible hors ligne

• le débit est effectué
• le crédit est mis en attente
• il sera appliqué à la prochaine connexion

Retry automatique

• le système réessaie régulièrement
• les compteurs sont réinitialisés à chaque reconnexion

👉 Aucune action manuelle n’est nécessaire.

Notifications

Le système envoie automatiquement des notifications Discord :

• création de transaction
• débit effectué
• crédit effectué
• transaction terminée
• erreurs ou rollback

👉 Les joueurs peuvent suivre l’évolution en temps réel.

Exemple

• Étape 1/2 : débit effectué
• Étape 2/2 : crédit effectué

Notes

• une connexion online est obligatoire
• les statuts évoluent automatiquement
• les frais sont calculés côté serveur
• les transactions sont sécurisées (pas de double envoi possible)