# Intégration Serveur

# 🔧 Guide d'Intégration Serveur - Admin Menu v2.1

**Auteur**: ProtoMehka
**Version**: 2.1
**Date**: 10 Janvier 2025
**Framework**: Altis Life 5.0+

---

## 📖 Introduction

Ce guide détaille l'installation de la **partie serveur** du menu admin v2.1. Il couvre :
- Les fonctions serveur pour les requêtes SQL
- Le système de logging des actions admin
- La configuration du serveur
- Les permissions remoteExec

**Prérequis** :
- Serveur Altis Life fonctionnel avec extDB3
- Accès aux fichiers `life_server`
- Base de données MySQL/MariaDB configurée

---

## 📁 Structure des Fichiers Serveur

```
life_server/
└── Functions/
    └── Admin/
        ├── fn_getPlayerFinances.sqf    # Récupère cash/banque d'un joueur
        └── fn_logAdminAction.sqf        # Enregistre les actions admin en BDD
```

---

## 🚀 Installation

### 1️⃣ Créer le Dossier Admin

Si le dossier n'existe pas déjà :

```
life_server/Functions/Admin/
```

### 2️⃣ Copier les Fichiers

Copiez les 2 fichiers `.sqf` dans `life_server/Functions/Admin/` :

```
✅ fn_getPlayerFinances.sqf
✅ fn_logAdminAction.sqf
```

### 3️⃣ Modifier config.cpp

**Chemin** : `life_server/config.cpp`

**Localiser** la classe `TON_System` :

```cpp
class TON_System {
    tag = "TON";

    // ... autres classes existantes ...
};
```

**Ajouter** cette classe **DANS** `TON_System` :

```cpp
class Admin {
    file = "\life_server\Functions\Admin";
    class getPlayerFinances {};
    class logAdminAction {};
};
```

**Résultat final** :

```cpp
class TON_System {
    tag = "TON";

    // Autres classes...
    class MySQL_Database {
        // ...
    };

    class Admin {
        file = "\life_server\Functions\Admin";
        class getPlayerFinances {};
        class logAdminAction {};
    };
};
```

### 4️⃣ Modifier CfgRemoteExec.hpp (Client)

**Chemin** : `admin_menu.Altis/CfgRemoteExec.hpp`

**Ajouter** dans la section `/* Server only functions */` :

```cpp
F(TON_fnc_getPlayerFinances,SERVER)
F(TON_fnc_logAdminAction,SERVER)
```

**Exemple complet** :

```cpp
/* Server only functions */
F(DB_fnc_insertRequest,SERVER)
F(DB_fnc_queryRequest,SERVER)
F(DB_fnc_updatePartial,SERVER)
F(DB_fnc_updateRequest,SERVER)
F(TON_fnc_getPlayerFinances,SERVER)
F(TON_fnc_logAdminAction,SERVER)
F(life_fnc_jailSys,SERVER)
// ... autres fonctions serveur
```

---

## 📋 Détail des Fonctions

### fn_getPlayerFinances.sqf

**Description** : Récupère le cash et la banque d'un joueur depuis la base de données.

**Paramètres** :
- `0: STRING` - PID du joueur cible
- `1: OBJECT` - Admin qui demande les infos

**Fonctionnement** :
1. Reçoit une demande du client (admin)
2. Exécute : `SELECT cash, bankacc FROM players WHERE pid='...'`
3. Envoie les résultats au client via `remoteExecCall`

**Exemple de requête SQL** :
```sql
SELECT cash, bankacc FROM players WHERE pid='76561198012345678'
```

---

### fn_logAdminAction.sqf

**Description** : Enregistre une action admin dans la base de données.

**Paramètres** :
- `0: STRING` - PID de l'admin
- `1: STRING` - Nom de l'admin
- `2: STRING` - Commande exécutée
- `3: STRING` - Cible (optionnel, nom du joueur ciblé)
- `4: STRING` - Détails additionnels (optionnel)

**Fonctionnement** :
1. Reçoit les données d'une action admin
2. Échappe les guillemets pour la sécurité SQL
3. Insère dans la table `admin_logs`

**Exemple de requête SQL** :
```sql
INSERT INTO admin_logs (pid, player_name, command, target, details)
VALUES ('76561198012345678', 'Admin Name', 'TELEPORT', NULL, 'X:3612 Y:13138')
```

**Gestion des valeurs NULL** :
- Si `target` ou `details` sont vides, ils sont insérés comme `NULL` et non comme chaînes vides

---

## 🔐 Sécurité

### Protection SQL Injection

Les fonctions utilisent `regexReplace` pour échapper les guillemets :

```sqf
_adminName = _adminName regexReplace ["'", "''"];
_target = _target regexReplace ["'", "''"];
_details = _details regexReplace ["'", "''"];
_command = _command regexReplace ["'", "''"];
```

### Validation des Données

Vérifications avant exécution :
- PID et commande non vides
- Objet admin valide
- Limite de résultats respectée

---

## ✅ Checklist d'Installation

```
☐ Dossier life_server/Functions/Admin créé
☐ 2 fichiers .sqf copiés
☐ config.cpp modifié (classe Admin ajoutée avec 2 fonctions)
☐ CfgRemoteExec.hpp modifié (2 fonctions serveur ajoutées)
☐ Table admin_logs créée en BDD (voir INTEGRATION_DB.md)
☐ Serveur compilé sans erreur
☐ Tests effectués avec succès
```

---

## 🆕 Nouveautés v2.1

### Fonctionnalités Utilisant le Serveur

**Object Manager** :
- Logging des suppressions d'items : `DELETE_ITEM | Type: weapon | Class: hgun_Rook40_F`
- Utilise `TON_fnc_logAdminAction` pour tracer les suppressions

**Actions Admin avec Logging Renforcé** :
- Toutes les commandes admin sont loguées via `TON_fnc_logAdminAction`
- Logs stockés dans la table `admin_logs` avec timestamp automatique

**Spectate Mode** :
- Compatible TFAR (détection automatique)
- Logging de l'action spectate avec nom de la cible

### Pas de Modification Serveur Requise

Les fonctions serveur v2.0 sont **100% compatibles** avec v2.1 :
- ✅ `fn_getPlayerFinances.sqf` - Inchangé
- ✅ `fn_logAdminAction.sqf` - Inchangé

Aucune modification côté serveur n'est nécessaire pour migrer de v2.0 vers v2.1.

---

**Version 2.1** - 10 Janvier 2025