Documentation TechSuivi

Guide complet d'installation, configuration et utilisation de la plateforme TechSuivi

Version 4.0 Mise à jour : 02 Septembre 2025

Introduction

TechSuivi est une plateforme complète de gestion technique développée pour répondre aux besoins des techniciens informatiques. Elle offre une suite d'outils intégrés pour la gestion d'interventions, le support client, et l'automatisation des tâches.

Objectif du Projet

TechSuivi a été créé par un technicien informatique pour optimiser le workflow quotidien et améliorer l'efficacité des interventions techniques.

Fonctionnalités Principales

  • Gestion d'Interventions - Planification, suivi et historique complet
  • Helpdesk Intégré - Système de tickets et support client
  • Base Clients - Gestion complète des clients et contrats
  • Automatisation AutoIt - Scripts de maintenance et installation
  • Sécurité Avancée - Protection et audit de sécurité
  • Interface Mobile - PWA pour utilisation nomade

Installation

Prérequis

Avant d'installer TechSuivi, assurez-vous que votre système dispose des éléments suivants :

Serveur Web

  • Apache 2.4+ ou Nginx 1.18+
  • PHP 8.0 ou supérieur
  • Extensions PHP : mysqli, json, curl, gd

Base de Données

  • MySQL 8.0+ ou MariaDB 10.5+
  • Minimum 100MB d'espace disque
  • Utilisateur avec privilèges CREATE/DROP

Système

  • Linux, Windows ou macOS
  • 2GB RAM minimum
  • 1GB d'espace disque libre

Installation avec Docker (Recommandée)

L'installation Docker est la méthode la plus simple et la plus rapide :

docker-compose.yml 
# Cloner le repository
git clone https://github.com/TechSuivi/TechSuivi.git
cd TechSuivi

# Lancer avec Docker Compose
docker-compose up -d

# Vérifier le statut
docker-compose ps

Première Installation

Lors du premier démarrage, la base de données sera automatiquement initialisée. Cela peut prendre quelques minutes.

Installation Manuelle

Pour une installation manuelle sur un serveur existant :

1

Télécharger les fichiers

wget https://github.com/TechSuivi/releases/latest/download/techsuivi.zip
unzip techsuivi.zip -d /var/www/html/techsuivi
2

Configurer les permissions

chown -R www-data:www-data /var/www/html/techsuivi
chmod -R 755 /var/www/html/techsuivi
chmod -R 777 /var/www/html/techsuivi/uploads
3

Créer la base de données

CREATE DATABASE techsuivi CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'techsuivi'@'localhost' IDENTIFIED BY 'mot_de_passe_securise';
GRANT ALL PRIVILEGES ON techsuivi.* TO 'techsuivi'@'localhost';
FLUSH PRIVILEGES;

Configuration

Configuration de la Base de Données

Configurez la connexion à la base de données dans le fichier config/database.php :

config/database.php 
<?php
$config = [
    'host' => 'localhost',
    'database' => 'techsuivi',
    'username' => 'techsuivi',
    'password' => 'votre_mot_de_passe',
    'charset' => 'utf8mb4',
    'port' => 3306
];
?>

Variables d'Environnement

Créez un fichier .env à la racine du projet :

.env 
# Configuration de base
APP_NAME=TechSuivi
APP_ENV=production
APP_DEBUG=false

# Base de données
DB_HOST=localhost
DB_PORT=3306
DB_DATABASE=techsuivi
DB_USERNAME=techsuivi
DB_PASSWORD=votre_mot_de_passe

# Sécurité
APP_KEY=votre_cle_secrete_32_caracteres
SESSION_LIFETIME=120

# Upload
MAX_UPLOAD_SIZE=10M
ALLOWED_EXTENSIONS=jpg,jpeg,png,pdf,doc,docx

Guide d'Utilisation

Gestion d'Interventions

Le module d'interventions est le cœur de TechSuivi. Il permet de :

Créer une Intervention

Formulaire complet avec client, description, priorité et planification

Suivi des Statuts

Workflow personnalisable : En attente → En cours → Terminé

Photos et Documents

Upload de photos avant/après et documents techniques

Historique Complet

Traçabilité de toutes les actions et modifications

Conseil de Technicien

Utilisez les photos avant/après pour documenter vos interventions. C'est un gain de temps énorme pour les rapports clients !

Centre de Messages

Le système de messagerie intégré permet une communication simple et efficace :

Messages Clients

Réception et gestion des messages clients avec historique complet

Catégories

Organisation des messages par catégories pour un tri efficace

Réponses Rapides

Interface simple pour répondre rapidement aux demandes

Archivage

Archivage automatique des conversations terminées

Gestion des Clients

Module complet de gestion de la relation client :

  • Fiche client détaillée avec historique
  • Gestion des contrats et abonnements
  • Suivi des équipements par client
  • Facturation et devis intégrés
  • Rapports d'activité personnalisés

Scripts AutoIt

TechSuivi intègre une collection de scripts AutoIt pour l'automatisation :

Nettoyage Système

  • Nettoyage des fichiers temporaires
  • Vidage des caches navigateurs
  • Défragmentation automatique

Installation Logiciels

  • Installation silencieuse d'applications
  • Mise à jour automatique
  • Configuration par défaut

Maintenance

  • Vérification de l'intégrité système
  • Sauvegarde automatique
  • Rapports de santé système

API REST

TechSuivi expose une API REST pour l'intégration avec d'autres systèmes :

GET
/api/interventions
Liste toutes les interventions
POST
/api/interventions
Crée une nouvelle intervention
PUT
/api/interventions/{id}
Met à jour une intervention

Authentification

L'API utilise l'authentification par token Bearer :

curl -H "Authorization: Bearer YOUR_TOKEN" \
     -H "Content-Type: application/json" \
     https://votre-domaine.com/api/interventions

Dépannage

Erreur 500 - Internal Server Error

Cause : Problème de configuration Apache ou permissions fichiers

Solution :

# Vérifier les permissions
chmod -R 755 /var/www/html/techsuivi
chown -R www-data:www-data /var/www/html/techsuivi

# Vérifier les logs Apache
tail -f /var/log/apache2/error.log

Erreur de Connexion Base de Données

Cause : Configuration incorrecte ou service MySQL arrêté

Solution :

# Vérifier le service MySQL
systemctl status mysql

# Tester la connexion
mysql -u techsuivi -p -h localhost techsuivi

Problème d'Upload de Fichiers

Cause : Limites PHP ou permissions dossier uploads

Solution :

# Vérifier les permissions uploads
chmod -R 777 /var/www/html/techsuivi/uploads

# Vérifier la configuration PHP
php -i | grep upload_max_filesize

Questions Fréquentes (FAQ)

Puis-je utiliser TechSuivi sur mobile ?

Oui ! TechSuivi est une PWA (Progressive Web App) qui fonctionne parfaitement sur mobile. Vous pouvez même l'installer sur votre écran d'accueil comme une application native.

Comment sauvegarder mes données ?

TechSuivi inclut un système de sauvegarde automatique. Vous pouvez également faire des sauvegardes manuelles via l'interface d'administration ou en exportant directement la base de données MySQL.

Puis-je personnaliser les statuts d'intervention ?

Absolument ! Les statuts sont entièrement configurables dans l'interface d'administration. Vous pouvez créer vos propres workflows selon vos besoins métier.

TechSuivi est-il sécurisé ?

Oui, TechSuivi intègre de nombreuses mesures de sécurité : protection contre les injections SQL, XSS, CSRF, chiffrement des sessions, audit de sécurité, et bien plus. Un rapport de sécurité complet est disponible.

Besoin d'Aide ?

Si vous ne trouvez pas la réponse à votre question dans cette documentation :

Signaler un Bug Forum Communauté Formulaire de Contact