Guide d'utilisation
← Retour

Principe

L'application reprend la logique de vos feuilles Excel « Semaine – Heures travaillées » :

  • Heures travaillées = (départ midi − arrivée) + (départ − retour) − absence décomptée éventuelle.
  • Différentiel du jour = heures travaillées − objectif du jour (« Nbre heures par jour ») ± correction.
  • Total différentiel / semaine = somme des différentiels de la semaine.
  • Heures à récupérer = solde de la semaine précédente + total différentiel de la semaine.

Horaires de référence : comme dans le modèle Excel, quand une journée de travail est commencée, chaque pointage pas encore saisi prend l'heure de référence (8:30, 12:00, 13:45, 17:15 par défaut). Les heures à récupérer sont donc recalculées à chaque pointage : à l'arrivée, au départ midi, au retour et au départ. Ces heures prévues apparaissent en italique avec la mention « prévu ». Une journée dont l'objectif est personnalisé (demi-journée par exemple) n'est pas complétée.

Un jour non saisi ne compte pas. Les journées futures ne sont jamais prises en compte dans le solde.

Accueil et pointage

Le grand cadre bleu affiche votre solde d'heures à récupérer au jour même (en vert s'il est positif, en rouge s'il est négatif).

Le bloc Aujourd'hui montre les quatre pointages. Le prochain pointage attendu est entouré en pointillés doré.

  • Pointer maintenant : enregistre l'heure actuelle dans le prochain pointage vide (arrivée, départ midi, retour, départ).
  • Déclarer une absence : choisissez le motif, puis « Je pars maintenant » ; au retour, touchez Retour d'absence. Vous pouvez aussi « Saisir les horaires » d'une absence passée.
  • Départ conseillé : après le retour de pause, l'application calcule l'heure de départ pour atteindre l'objectif du jour, et, si votre solde est négatif, l'heure pour revenir à zéro. Le matin, l'estimation utilise votre pause déjeuner moyenne des 60 derniers jours.
  • Modifier la journée ouvre la fenêtre de saisie complète.

Semaine

Comme un onglet Sxx de votre classeur : les 7 jours avec leurs horaires, la durée travaillée et le différentiel de chaque jour. Les jours fériés français sont signalés automatiquement.

En bas : heures travaillées, objectif, total différentiel / semaine, solde semaine précédente et heures à récupérer. Les flèches ‹ › changent de semaine ; touchez un jour pour le saisir ou le modifier.

Saisir une journée

  • Type de journée : voir le tableau ci-dessous ; il fixe l'objectif automatique.
  • Matin, après-midi : heures de début et de fin. Le bouton ⏱ à côté de chaque champ met l'heure actuelle.
  • Absence dans la journée : voir la section ci-dessous.
  • Objectif du jour : laissez vide pour l'objectif automatique (réglages et type de journée), ou saisissez une durée (ex. 3:30 pour une demi-journée).
  • Correction : retire (−) ou ajoute (+) une durée, par exemple après un oubli de pointage.
  • Note : texte libre (projet, client, motif…).

Le cadre du bas montre en direct le travaillé, l'objectif et le différentiel. Les fenêtres se ferment uniquement par Annuler, Fermer ou Enregistrer (option modifiable dans les Réglages). Toute suppression demande une confirmation qui détaille ses conséquences.

Absences dans la journée

Pour une sortie pendant vos heures de travail, sans repointer : médecin, médecine du travail, rendez-vous, banque, enfant malade…

  • Motif : Médecin, Médecine du travail, Rendez-vous personnel, Banque / administratif, Enfant malade, Autre. Précisez si besoin dans la note.
  • Départ en absence et retour, ou seulement une durée si vous n'avez pas les horaires.
  • Décompter du temps travaillé : coché par défaut, la durée est retirée des heures travaillées. Pour la médecine du travail, la case est décochée par défaut, car ce temps compte comme du travail.

Si vous avez repointé votre départ et votre retour (par exemple départ midi puis retour), inutile de déclarer une absence : le temps est déjà exclu. Une seule absence peut être saisie par journée.

Le Bilan récapitule les absences de l'année par motif.

Types de journée

TypeObjectif automatique
Travail, Télétravail, FormationObjectif du jour de la semaine
RécupérationObjectif du jour (sans heures saisies, il est déduit du solde)
½ CP matin, ½ CP après-midiMoitié de l'objectif du jour
Congé payé, RTT, Jour férié, Maladie, Déplacement, Séminaire, Autre absenceAucun (0:00)

Un déplacement avec des horaires réels peut recevoir un objectif personnalisé.

Congés payés

Comptes de congés

Comme sur votre portail RH, les congés sont répartis en comptes, un par période d'acquisition : « Congés payés 2025/2026 » a été acquis de juin 2025 à mai 2026, « Congés payés 2026/2027 » s'acquiert de juin 2026 à mai 2027. Chaque compte a une date limite (« à poser avant »).

  • Solde actuel : jours acquis moins les jours déjà pris.
  • Jours posés : congés prévus d'ici la date de projection.
  • À acquérir : jours qui seront acquis d'ici la date de projection (droits / 12 par mois complet : 2,08 j pour 25 j par an).
  • Solde estimé = solde actuel − jours posés + à acquérir.
  • Disponible à ce jour : solde actuel moins tous les jours posés ; un compte en cours d'acquisition compte par demi-journée.

Les congés sont décomptés sur le compte le plus ancien d'abord. Le Bilan indique pour chaque congé le compte utilisé.

Renseigner ses soldes

Réglages → Congés payés : indiquez la date du relevé et, pour chaque compte, le solde actuel affiché par votre portail RH ou votre bulletin à cette date, ainsi que la date limite. L'application part de ces valeurs : elle ajoute l'acquisition des mois suivants et retire les congés pris ou posés après cette date. Mettez ces soldes à jour de temps en temps (par exemple à chaque bulletin) pour rester aligné sur la paie.

Poser des congés

  1. Accueil → carte Congés payés → Poser des congés (ou depuis la Semaine ou le Bilan).
  2. Choisissez le type (congé payé, RTT, récupération, maladie, autre absence), les dates du et au, et si besoin « À partir de l'après-midi » pour le premier jour ou « Jusqu'à midi » pour le dernier.
  3. L'aperçu indique le nombre de jours décomptés et les jours fériés exclus. Si des journées sont déjà saisies, elles sont laissées telles quelles, sauf si vous cochez « Remplacer ».

Pour annuler des congés prévus, touchez chaque jour dans la Semaine puis Supprimer.

Bilan

Le Bilan présente les comptes avec la date de projection de votre choix, puis l'historique des congés par période de prise (1er juin – 31 mai), regroupés par séjour.

Bilan

Pour l'année choisie : heures à récupérer (et solde de début d'année), différentiel de l'année, heures travaillées et moyenne par jour, congés payés pris (½ journée = 0,5), horaires moyens d'arrivée et de départ, pause déjeuner moyenne, déplacements et formations.

La courbe montre l'évolution du solde jour après jour ; le tableau détaille chaque mois avec le solde de fin de mois.

Historique

La liste des semaines de l'année, de la plus récente à la plus ancienne, avec le total différentiel et les heures à récupérer en fin de semaine. Touchez une semaine pour l'ouvrir.

Réglages

Bouton ⚙ en haut à droite.

  • Mon compte : nom affiché, changement de mot de passe (l'œil affiche le mot de passe pendant la saisie).
  • Horaires de référence : arrivée, départ midi, retour et départ utilisés pour les pointages pas encore saisis ; décochez « Compléter les pointages manquants » pour ne compter que les heures réellement pointées.
  • Objectif journalier : durée attendue pour chaque jour de la semaine (7:00 du lundi au vendredi par défaut). Les journées dont l'objectif a été personnalisé ne changent pas.
  • Solde de départ : date de début du suivi et solde à cette date. Utile pour démarrer avec un report d'heures.
  • Déconnexion automatique après un nombre de minutes d'inactivité (15 par défaut).
  • Fermer les fenêtres en touchant à côté : désactivé par défaut, réglé pour chaque appareil.

Données et sauvegardes

  • Exporter en CSV : fichier lisible dans Excel (séparateur point-virgule), une ligne par journée avec le solde cumulé.
  • Sauvegarde complète (JSON) : toutes vos journées, votre solde de départ et vos objectifs.
  • Restaurer une sauvegarde : ajoute les journées du fichier (ou remplace tout si vous cochez « Remplacer »).
  • Réimporter l'historique Excel : réécrit les 492 journées issues de vos fichiers 2025 et 2026.

Utilisateurs

Chaque utilisateur a ses propres temps, son solde et ses réglages. Le premier compte créé est administrateur : il peut ajouter, modifier ou supprimer des comptes (bloc « Utilisateurs » des Réglages) et donner le rôle d'administrateur à d'autres.

Envoyer un retour

En bas de l'accueil, Envoyer un retour permet de signaler un problème, proposer une idée ou poser une question.

  • Choisissez le type, écrivez votre message (20 000 caractères au maximum) et ajoutez si besoin jusqu'à 3 pièces jointes : capture d'écran, photo ou document (8 Mo chacune, 15 Mo au total).
  • La version de l'application, la page, l'appareil et le navigateur sont ajoutés automatiquement au message.
  • « Merci ! Votre retour a été envoyé » s'affiche seulement si le serveur de messagerie a accepté l'e-mail. Sinon, le retour est conservé et le motif est indiqué.

Réglages de l'envoi (administrateur)

Réglages → Retours par e-mail :

  1. Destinataire : adresse qui reçoit les retours (webapp@ifrikya.eu par défaut).
  2. Serveur SMTP : ssl0.ovh.net, port 465 SSL (ou 587 STARTTLS).
  3. Identifiant et mot de passe de la boîte OVH qui envoie (webapp@ifrikya.eu par défaut). Le mot de passe est chiffré sur le serveur ; laissez le champ vide pour garder celui enregistré.
  4. Envoyer un e-mail de test pour vérifier.

La liste des derniers retours indique s'ils sont partis ; Renvoyer relance un envoi échoué (le texte est renvoyé, les pièces jointes ne sont pas conservées sur le serveur).

Empreinte digitale

Sur votre téléphone, l'application peut s'ouvrir avec votre empreinte (ou le déverrouillage de l'écran) au lieu du mot de passe.

Activer

  1. Connectez-vous avec votre mot de passe sur le téléphone, dans Chrome ou depuis l'icône de l'application.
  2. Réglages → Empreinte digitale → Activer sur cet appareil.
  3. Vérifiez le nom proposé (votre nom, la marque et le modèle du téléphone), puis Activer et posez votre doigt.

Utiliser

À chaque ouverture, la demande d'empreinte s'affiche d'elle-même. Si vous l'annulez, touchez Déverrouiller avec l'empreinte ou utilisez le mot de passe.

Gérer les appareils

La liste des Réglages indique pour chaque appareil la date d'ajout et la dernière utilisation. Renommer change son nom ; Retirer désactive l'empreinte sur cet appareil (le mot de passe sera demandé). Chaque utilisateur gère ses propres appareils.

Noms des téléphones : l'application traduit le code du modèle (ex. 2311DRK48G) en nom commercial (POCO X6 Pro 5G) grâce à la liste des appareils de Google Play. Elle est téléchargée automatiquement par le serveur quand un administrateur se connecte, puis tous les 30 jours ; le bouton Mettre à jour maintenant la force.

L'empreinte ne quitte jamais le téléphone : le serveur conserve seulement une clé publique. L'empreinte fonctionne uniquement en HTTPS (https://timesheets.ifrikya.eu).

Sécurité

  • Mots de passe chiffrés (hachage password_hash), jamais stockés en clair.
  • Blocage pendant 15 minutes après 8 tentatives de connexion échouées.
  • Après avoir quitté l'application ou fermé l'onglet, la connexion est toujours redemandée (par empreinte si elle est activée).
  • Déconnexion automatique après inactivité.
  • La base de données (data/.ht_heures.sqlite) est inaccessible depuis le web.

Installer sur Android

Ouvrez l'adresse de l'application dans Chrome, puis menu ⋮ → Ajouter à l'écran d'accueil (ou « Installer l'application »). L'icône HT apparaît comme une application, en plein écran.

Installation sur OVH (offre Perso)

  1. Décompressez l'archive et envoyez le dossier timesheets par FTP dans /www de votre hébergement (soit /www/timesheets).
  2. Vérifiez que le dossier data est accessible en écriture (droits 755 ou 705 suffisent chez OVH).
  3. Ouvrez https://timesheets.ifrikya.eu : la page « Bienvenue » propose de créer le compte administrateur et d'importer l'historique Excel.
  4. Sous-domaine timesheets.ifrikya.eu : dans l'espace client OVH, Multisite → ajouter le sous-domaine avec le dossier racine www/timesheets, cocher SSL, puis régénérer le certificat SSL. Le fichier .htaccess force le HTTPS et redirige ifrikya.eu/timesheets vers le sous-domaine.

Prérequis : PHP 8.0 ou plus avec PDO SQLite (inclus chez OVH). Aucune base MySQL n'est nécessaire.

Mise à jour : remplacez tous les fichiers sauf le dossier data (qui contient vos données).

Historique Excel importé

Les classeurs « 2025 – Semaine – Heures travaillées » et « 2026 – Semaine – Heures travaillées » ont été convertis : 492 journées du 1er janvier 2025 au 19 novembre 2026, avec les congés, jours fériés, déplacements, formations, demi-journées, notes et absences (la ligne « Soir » du classeur, convertie en absence ; motif « Médecin » ou « Banque / administratif » quand la note l'indiquait, sinon « Autre »).

Les semaines sont datées d'après leur numéro (Sxx), car certains onglets avaient des dates d'en-tête erronées (ex. S10 2026). Les semaines de fin 2026 préremplies à l'avance n'ont pas été importées.

Report du classeur conservé : dans le classeur 2025, l'onglet S19 reprend le solde de S17 au lieu de S18. Pour garder exactement les heures à récupérer du classeur, une correction de +2:02 est inscrite le lundi 5 mai 2025 (semaine 19), avec une note. Chaque semaine affiche ainsi le même solde que l'Excel : 36:23 à fin 2025 et 10:50 au 19/11/2026.