📖 Manuel d'Utilisation Complète

PointagePro est une application web avancée de gestion de pointage et de ressources humaines. Elle permet aux entreprises d'enregistrer les entrées et sorties des employés, de calculer automatiquement les heures travaillées et les salaires, de gérer les congés avec calcul automatique des soldes, et de suivre l'activité via des tableaux de bord détaillés et des rapports analytiques.

L'application est accessible depuis n'importe quel navigateur (ordinateur, tablette, smartphone) et peut être installée comme application mobile grâce à la technologie PWA (Progressive Web App).

Ce que vous pouvez faire avec PointagePro

L'application distingue deux rôles principaux, chacun ayant des droits spécifiques clairement définis :

3.1 Se connecter

Accessible à l'URL /connexion. Saisissez votre nom d'utilisateur et votre mot de passe, puis cliquez sur "Se connecter".

3.2 Première connexion

3.3 Se déconnecter

Cliquez sur l'icône de déconnexion dans le menu latéral (desktop) ou l'en-tête (mobile). La session est immédiatement détruite et la page de connexion s'affiche.

3.4 Changer son mot de passe

Accessible via /profil → "Changer le mot de passe".

Accessible à l'URL /profil. Tous les utilisateurs (administrateurs et pointeurs) peuvent consulter et modifier leur profil.

4.1 Fonctionnalités du profil

• Consultation de vos informations personnelles (nom, username, rôle, date de dernière connexion…)
• Changement de mot de passe : ancien mot de passe requis, nouveau mot de passe validé côté serveur
• Déconnexion sécurisée avec validation CSRF

Le module Pointage est le cœur de l'application. Il permet d'enregistrer les entrées et sorties des employés sur leur lieu de travail avec traçabilité complète et snapshot historique.

5.1 URL et accès

• /pointage/registre — Interface de pointage principale (recherche + formulaire)
• /pointage/historique — Historique complet des pointages
• /pointage/modifier/{id} — Modifier un pointage existant
• /api/pointage/verifier — API AJAX de vérification en temps réel

5.2 Enregistrer un pointage

1. Recherchez l'employé par nom, matricule ou numéro CIN (recherche AJAX dynamique avec résultats en temps réel)
2. Sélectionnez l'employé dans les résultats
3. Renseignez la date de travail (pré-remplie avec la date du jour pour les pointeurs), l'heure d'entrée, l'heure et date de sortie (optionnelles), le service, la ville et une observation éventuelle
4. Validez — une notification toast confirme le succès ou affiche l'erreur

5.3 Règles appliquées au Pointage

5.4 Consultation de l'historique

URL : /pointage/historique. L'historique des pointages liste tous les enregistrements. Filtres disponibles :

• Date — Période de début et de fin
• Service — Filtrer par service
• Ville — Filtrer par ville
• Pointeur — Filtrer par utilisateur ayant enregistré (admin uniquement)
• Recherche textuelle — Par nom d'employé

5.5 Modifier et supprimer un pointage

5.6 API de vérification

L'URL /api/pointage/verifier permet une vérification AJAX en temps réel de :

• Déjà pointé : vérifie si un pointage identique existe déjà
• Chevauchement : détecte les chevauchements horaires avec les pointages clos
• Pointage ouvert : indique si l'employé a déjà un pointage sans heure de sortie

Le tableau de bord est le point d'entrée principal de l'application. Il offre une synthèse en temps réel de l'activité de l'entreprise.

6.1 Vue Administrateur

URL : /tableau-de-bord

6.2 Vue Pointeur (mobile)

Sur mobile, le pointeur voit un résumé simplifié :

• Total des pointages effectués aujourd'hui
• Liste détaillée des pointages du jour (ouverts en premier, puis les plus récents)

6.3 Hub Mobile — Sections admin

Sur mobile, le tableau de bord est découpé en hubs spécialisés :

Le module Employés permet de gérer l'ensemble de la base de données des employés : création, modification, consultation, activation/désactivation, documents administratifs et génération de badges.

7.1 Liste des employés

URL : /employes

• Affichage paginé de tous les employés (100 par page)
• Recherche par nom, matricule, CIN, téléphone
• Filtrage par ville, service ou type de contrat
• Indicateurs : nombre de pointages et congés par employé

7.2 Créer un employé

URL : /employes/creer

7.3 Règles appliquées aux Employés

7.4 Fiche employé

URL : /employes/voir/{id}

La fiche employé regroupe toutes les informations :

• Photo et informations personnelles complètes
• Documents administratifs téléchargeables
• Soldes de congés par année
• Historique des pointages (paginé)
• Historique des congés

7.5 Modifier un employé

URL : /employes/modifier/{id}

Tous les champs sont modifiables. Règle clé : si le salaire ou le type de salaire est modifié, le changement prend effet au 1er du mois suivant — les pointages antérieurs conservent l'ancien taux grâce à l'historique salarial.

7.6 Badge et QR Code

• URL badge : /employes/carte/{id}
• URL QR Code : /employes/qr/{id}

Chaque employé dispose d'une carte d'identification imprimable avec photo et QR code. Utilisée pour : badge papier plastifié, scan rapide via l'application, identification visuelle.

7.7 Activer / Désactiver

Un employé peut être désactivé (il reste dans l'historique mais n'apparaît plus dans les listes actives). Cette action est réservée à l'administrateur. La suppression définitive n'est possible que si l'employé n'a aucun pointage ni congé enregistré.

Le module Congés gère l'intégralité du cycle de vie des congés : acquisition automatique des soldes, prises de congé avec calcul FIFO, suivi et historique complet.

URL : /conges

8.1 Types de congés

8.2 Règles appliquées aux Congés

8.3 Procédure de prise de congé

Le système vérifie automatiquement le chevauchement et le solde disponible avant d'enregistrer.

8.4 Modification et suppression

• La modification d'un congé recalcule automatiquement la consommation FIFO avec la nouvelle ventilation.
• La suppression d'un congé rétablit le solde automatiquement par recalcul complet.

Le bilan mensuel est un rapport détaillé qui synthétise, pour chaque employé, les heures travaillées et les salaires calculés sur une période donnée, en utilisant l'historique des taux et types de salaire.

URL : /bilan/mensuel

9.1 Filtres disponibles

• Période : date de début et date de fin
• Ville : filtrer par ville
• Service : filtrer par service
• Contrat : filtrer par type de contrat
• Recherche textuelle : nom, matricule, CIN

9.2 Colonnes du bilan

9.3 Calculs salariaux par type

9.4 Règles appliquées au Bilan

9.5 Estimation de la masse salariale (Vision RH)

Les formules de calcul appliquées :

La Vision RH est un tableau de bord stratégique offrant une vue d'ensemble des indicateurs RH pour la direction.

URL : /visionrh

10.1 Indicateurs disponibles

10.2 Filtres

Toutes les données de la Vision RH peuvent être filtrées par période (date début et date fin) pour analyser une semaine, un mois ou toute période personnalisée.

10.3 Calcul de la masse salariale

Le module Vision RH calcule une estimation du coût salarial sur la période en appliquant les taux journaliers, horaires ou mensuels selon le type de chaque employé, en distinguant le coût réel (basé sur les jours de présence) et le coût théorique (basé sur les minutes travaillées).

Les villes sont des référentiels utilisés pour catégoriser les lieux de travail des employés et affecter les pointages géographiques.

URL : /villes

11.1 Actions disponibles

• Consultation de la liste complète des villes
• Création d'une nouvelle ville
• Modification d'une ville existante
• Suppression d'une ville (si non référencée)
• Vérification AJAX de l'unicité du nom

11.2 Règles appliquées

11.3 Opérations AJAX

L'URL /villes/verifier permet de vérifier en temps réel si un nom de ville est déjà utilisé avant la soumission du formulaire.

11.4 Suppression

Les services représentent les départements ou unités organisationnelles de l'entreprise. Ils peuvent être liés à une ville et/ou un contrat.

URL : /services

12.1 Actions disponibles

• Consultation de la liste des services (avec recherche et pagination)
• Création d'un nouveau service
• Modification d'un service
• Suppression d'un service (si non référencé)
• Vérification AJAX de l'unicité du nom

12.2 Formulaire de création

Le formulaire comprend les champs suivants :

• Nom du service (obligatoire)
• Description (optionnelle)
• Ville associée (optionnel, liaison avec le référentiel villes)
• Contrat associé (optionnel, liaison avec le référentiel contrats)

12.3 Règles appliquées

12.4 Affichage

La liste des services affiche pour chaque entrée : le nom, la description, la ville associée, le contrat associé, ainsi que le nombre d'employés et de pointages associés. La pagination affiche jusqu'à 100 services par page.

Les contrats définissent les types de relation de travail (CDI, CDD, Freelance, Stage, etc.) et sont utilisés comme référentiel pour les employés.

URL : /contrats

13.1 Actions disponibles

• Consultation de la liste des contrats (triés par code)
• Création d'un nouveau type de contrat
• Modification d'un contrat existant
• Suppression d'un contrat (si non utilisé par un employé)

13.2 Champs du formulaire

• Code : identifiant unique court (ex : "CDI", "CDD6M", "FREELANCE") — obligatoire
• Description : texte libre décrivant le type de contrat

13.3 Règles appliquées

Le calendrier des jours fériés est utilisé pour le calcul des jours ouvrables dans les bilans et la gestion des congés. Un jour férié peut couvrir une période (date de début → date de fin) pour gérer les ponts et les vacances prolongées.

URL : /configuration/feries

14.1 Actions disponibles

• Liste des jours fériés (du plus récent au plus ancien)
• Création d'un jour férié ou d'une période
• Modification d'un jour férié existant
• Suppression d'une entrée
• Vérification AJAX de l'unicité du nom

14.2 Règles appliquées

Ce module permet de gérer les comptes utilisateurs de l'application (identifiants de connexion, rôles et sécurité). Il est séparé du module Employés qui gère les données RH.

URL : /utilisateurs

15.1 Actions disponibles

• Liste paginée des utilisateurs (avec recherche par nom, username, rôle)
• Création d'un nouveau compte utilisateur
• Consultation du profil d'un utilisateur
• Modification d'un utilisateur (nom, rôle, mot de passe)
• Basculement du statut (Actif/Inactif)
• Suppression d'un compte (si pas d'historique)

15.2 Règles appliquées

15.3 Formulaire de création

• Nom complet : affiché dans l'interface
• Nom d'utilisateur : identifiant de connexion (sans espaces)
• Mot de passe : au moins 8 caractères avec lettres et chiffres
• Rôle : Administrateur ou Pointeur

15.4 Basculement du statut

L'administrateur peut activer ou désactiver un utilisateur. La désactivation bloque la connexion sans supprimer l'historique. Un administrateur ne peut pas se désactiver lui-même.

Ce module permet d'assigner des services aux utilisateurs ayant le rôle "pointeur". Un pointeur ne verra et ne pourra pointer que les employés des services qui lui sont assignés.

URL : /pointeurs

16.1 Principe de fonctionnement

Un pointeur peut être assigné à zéro, un ou plusieurs services. Il ne pourra enregistrer des pointages que pour les employés appartenant aux services qui lui sont assignés. Les assignations sont stockées dans la table pointeurs_services.

16.2 Procédure d'assignation

16.3 Règles appliquées

16.4 Impact sur le pointage

Lorsqu'un pointeur enregistre un pointage pour un employé ne faisant pas partie de ses services assignés, la requête est rejetée. Cette restriction est appliquée au niveau du contrôleur et du modèle.

Le journal d'audit assure la traçabilité de toutes les actions critiques réalisées dans l'application. Il constitue un outil fondamental pour la conformité, la détection d'anomalies et les enquêtes internes.

URL : /logs

17.1 Actions tracées

17.2 Filtres disponibles

• Par utilisateur ayant effectué l'action
• Par table concernée (employés, pointages, conges, utilisateurs, etc.)
• Par période (date début / date fin)
• Recherche textuelle dans les métadonnées de l'action

17.3 Fonctionnalités avancées

PointagePro intègre de multiples couches de sécurité pour protéger les données et garantir l'intégrité du système à tous les niveaux.

18.1 Mesures de sécurité implémentées

18.2 Bonnes pratiques recommandées

Cette section regroupe l'ensemble des 47 règles appliquées dans l'application, classées par module et par référence unique.

PointagePro est une Progressive Web App (PWA) : elle peut être installée sur votre appareil comme une application native et fonctionne partiellement hors ligne grâce au service worker intégré.

20.1 Installation

20.2 Fonctionnalités hors ligne

Grâce au service worker (sw.js), les ressources statiques (CSS, images, code JavaScript) sont mises en cache. En cas de perte de connexion, l'application peut toujours afficher les pages déjà visitées. Les données nouvellement saisies sont mises en attente et synchronisées automatiquement lors du retour en ligne.