Documentation & Aide

Guide d'utilisation du système de gestion des pointages

Navigation Rapide

Import Excel

Quarts de Travail

Corrections

Utilisateurs

Import de Fichier Excel

1. Préparation du fichier

Le système accepte les fichiers Excel au format matriciel :

  • Format : .xlsx
  • Structure : 1 ligne = 1 employé, 1 colonne = 1 jour
  • Colonnes requises : ID, Nom, Département, Dates (jours)

2. Upload du fichier

  1. Cliquez sur "Import Excel" dans le menu
  2. Glissez-déposez votre fichier ou cliquez pour sélectionner
  3. Cliquez sur "Analyser le fichier"
  4. Attendez le traitement (30-60 secondes pour ~400 employés)

3. Résultat

Après l'import :

  • ✅ Conversion automatique : chaque cellule → 1 ligne en base
  • 🤖 Correction automatique des pointages incomplets
  • 📊 Génération des statistiques et analyses
  • ⚠️ Affichage des pointages à vérifier en orange

Quarts de Travail

Types de quarts disponibles

🌙 Quart 1 (Nuit)

22h00 → 06h00 (8h)

Date = jour du départ

🌅 Quart 2 (Matin)

06h00 → 14h00 (8h)

🌆 Quart 3 (Après-midi)

14h00 → 22h00 (8h)

☀️ Quart Normal (Bureau)

07h00 → 17h30 (8h30)

Pause 12h-14h déduite (2h)

Attribution des quarts

Le système utilise 3 niveaux de priorité :

  1. Configuration par employé (priorité maximale)
  2. Configuration par département (si pas de config employé)
  3. Détection automatique basée sur les heures (fallback)

Système de Corrections Automatiques

Comment ça marche ?

Lors de l'import, si un employé a une seule heure (arrivée OU départ) :

  1. 🔍 Détection du quart basée sur l'heure unique
  2. 🎯 Analyse de proximité : heure proche du début = arrivée, proche de la fin = départ
  3. 🤖 Déduction automatique de l'heure manquante selon le quart
  4. ⚠️ Marquage visuel en orange avec icône robot

Modification manuelle

Pour corriger un pointage :

  1. Aller dans "Pointages à Vérifier" ou sur la page d'analyse
  2. Cliquer sur le bouton "Modifier" orange
  3. Ajuster les heures et le quart si nécessaire
  4. Valider : le pointage ne sera plus marqué comme incomplet

Astuce : Les pointages corrigés automatiquement sont toujours recalculés selon le quart assigné, incluant les pauses éventuelles.

Utilisateurs et Permissions

Rôles disponibles

👑 Administrateur

Accès complet : gestion des quarts, utilisateurs, modifications de tous les pointages

👔 RH / Manager

Modification des pointages de son périmètre (département), consultation des rapports

👤 Employé

Consultation des rapports et statistiques uniquement

Compte par défaut

Username : admin

Mot de passe : admin123

⚠️ Changez ce mot de passe après la première connexion !

Questions Fréquentes (FAQ)

Comment fonctionne la pause du Quart Normal ?

La pause de 12h à 14h (2 heures) est toujours soustraite du temps de travail pour le Quart Normal, peu importe l'heure de départ.

Que faire si un quart n'est pas détecté correctement ?

Créez une configuration spécifique pour l'employé ou le département dans "Gestion > Configuration Employés".

Les corrections automatiques sont-elles définitives ?

Non, elles peuvent être modifiées manuellement à tout moment par un Admin ou RH/Manager.

Puis-je importer plusieurs fois le même fichier ?

Oui, chaque import créé un nouveau batch. Les anciens imports restent accessibles dans l'historique.