PayrollSupportPlatform

📋 Vue d'ensemble

PayrollSupportPlatform est une application web complète de gestion de tickets et support client, spécifiquement conçue pour les cabinets comptables et services de paie.

Développée avec React 18 et Express.js, cette plateforme permet une gestion professionnelle des demandes clients avec un système de ticketing complet, des notifications automatiques par email, et un suivi détaillé des métriques.

🚀 Actuellement en production sur : helpdesk.excelae.fr

✨ Fonctionnalités principales

🎫 Système de tickets intelligent

Création, suivi et gestion complète des tickets avec numérotation automatique par entreprise

📊 Dashboard Analytics

Métriques en temps réel : tickets ouverts/résolus, temps de réponse moyen, satisfaction client

📧 Notifications automatiques

Emails transactionnels via Resend pour toutes les actions (création, assignation, résolution)

👥 Gestion multi-entreprises

Support de plusieurs entreprises avec isolation des données et numérotation personnalisée

🔒 Authentification sécurisée

Système d'auth bcrypt avec hashage sécurisé des mots de passe et sessions persistantes

📎 Pièces jointes

Upload et gestion de fichiers (JPG, PNG, PDF, DOC) avec limite de 10MB par fichier

🎨 Catégories et priorités

Classification des tickets par catégorie (Technique, Facturation, etc.) et niveau de priorité

✅ Tests complets

Suite de tests Jest avec couverture complète des fonctionnalités critiques

🏗️ Technologies utilisées

Interface utilisateur

React 18 pour une interface moderne et réactive
Navigation fluide entre les pages sans rechargement
Design responsive adapté à tous les écrans (PC, tablette, mobile)
Animations et transitions pour une expérience agréable

Serveur et base de données

Express.js pour gérer les requêtes et la logique métier
Supabase (PostgreSQL) pour stocker toutes les données de manière sécurisée
Sécurité renforcée avec cryptage des mots de passe
Resend pour l'envoi automatique d'emails de notification

Hébergement et déploiement

Docker pour empaqueter l'application dans un conteneur isolé
VPS Hostinger serveur dédié accessible 24/7
Déploiement automatisé avec scripts pour mettre à jour facilement
Tests automatiques avant chaque mise en production

Qualité et fiabilité

Tests automatiques pour garantir le bon fonctionnement
Vérification de la couverture pour s'assurer que tout est testé
Nettoyage automatique des données de test

React 18.2 Express 4.18 Node.js 18 Vite 5 Supabase PostgreSQL bcrypt Resend Jest Docker

🚀 Étapes de développement

Étape 1 : Version de base

Création de l'interface utilisateur avec React
Mise en place du serveur et de la base de données
Connexion entre le frontend et le backend
Premières fonctionnalités : créer et voir les tickets

Étape 2 : Sécurisation de l'application

Ajout du cryptage des mots de passe pour protéger les comptes
Système de connexion sécurisé avec vérification d'identité
Séparation des données entre chaque entreprise cliente
Protection des sessions pour éviter les accès non autorisés

Étape 3 : Notifications et expérience utilisateur

Mise en place de l'envoi automatique d'emails à chaque action
Création du tableau de bord avec statistiques en temps réel
Numérotation automatique des tickets par entreprise
Amélioration du design pour le rendre plus moderne et ergonomique

Étape 4 : Mise en production

Préparation de l'application pour le déploiement (Docker)
Installation sur le serveur VPS accessible en ligne
Ajout de tests automatiques pour garantir la qualité
Création de scripts pour faciliter les mises à jour futures

🎯 Problèmes résolus

1. Protection des comptes utilisateurs

Le défi : Au départ, les mots de passe étaient stockés sans protection, ce qui posait un gros risque de sécurité.

La solution : J'ai mis en place un système de cryptage (bcrypt) qui rend impossible la lecture des mots de passe, même en cas d'accès à la base de données. Tous les anciens mots de passe ont été migrés vers ce système sécurisé.

2. Numérotation automatique des tickets

Le défi : Chaque entreprise avait besoin de numéros de tickets uniques et personnalisés, suivant un format précis comme SHN-2025-001.

La solution : Création d'un système qui génère automatiquement les numéros avec le préfixe de l'entreprise, l'année en cours, et un compteur qui s'incrémente pour chaque nouveau ticket.

3. Envoi fiable des emails de notification

Le défi : Configurer un système d'envoi d'emails qui fonctionne de manière fiable et ne tombe pas dans les spams.

La solution : Utilisation du service Resend (spécialisé dans l'envoi d'emails professionnels) avec des templates personnalisés qui s'adaptent automatiquement à chaque action (nouveau ticket, assignation, résolution).

4. Compatibilité entre la base de données et l'interface

Le défi : La base de données PostgreSQL utilise une convention de nommage différente de celle utilisée en JavaScript, ce qui causait des problèmes de communication entre les deux.

La solution : Mise en place d'un système de conversion automatique qui traduit les données dans les deux sens, permettant une communication fluide sans erreur.

📈 Métriques du projet

🔢 Lignes de code

~5000 lignes (frontend + backend + tests)

📦 Version actuelle

v1.8.2 (Production stable)

⚡ Performance

Temps de réponse moyen < 200ms

🧪 Couverture tests

95%+ sur fonctionnalités critiques

🌐 Uptime

99.9% disponibilité sur VPS

📊 Base de données

5 tables relationnelles PostgreSQL

🎓 Apprentissages clés

Architecture full-stack moderne : Maîtrise de React + Express avec base PostgreSQL
Sécurité applicative : Implémentation bcrypt, hashage, sessions sécurisées
DevOps pratique : Dockerisation, déploiement VPS, CI/CD avec tests
Services externes : Intégration APIs tierces (Supabase, Resend)
Tests automatisés : Suite Jest complète avec mocking et fixtures
UX/UI professionnelle : Design moderne, responsive, interactions fluides
Gestion de projet : Documentation, versioning, migration de données

🌐 Découvrez l'application en ligne

Testez PayrollSupportPlatform en conditions réelles sur le VPS de production

Accéder à l'application → ← Retour au portfolio