Aller au contenu
Tchomtchi Kamgang Daniel Merlys
EN
Retour aux projets
  • Automatisation
  • Data
  • Finance
Version 1.8.0

Gestion des salaires

Application de paie des enseignants pour des établissements scolaires au Cameroun : du classeur Excel mensuel aux bulletins et aux exports comptables.

Statut
Version 1.8.0
Rôle
Conception et développement
Période
2026

01Contexte

La paie des enseignants d'établissements scolaires au Cameroun, avec deux statuts aux règles différentes : vacataires, soumis à une taxe spécifique, et permanents, payés au mois.

Les éléments de paie arrivent chaque mois dans un classeur Excel (heures, informations, état comptable).

02Problème

Chaque mois, la paie part d'un classeur Excel : calculer les montants selon le statut de chaque enseignant, contrôler les écarts, produire les bulletins au format de l'établissement et préparer l'état comptable. À la main, ce travail est répétitif, difficile à contrôler et laisse peu de traces des corrections.

03Objectif

Couvrir tout le cycle de paie dans un seul outil : saisie, calcul, contrôle, validation, clôture, bulletins et exports comptables.

04Données

  • Classeur Excel mensuel : heures, informations des enseignants, état comptable.
  • Listes d'enseignants existantes (Excel, CSV, Word ou PDF), reprises avec détection des doublons probables.
  • Modèles de bulletin de l'établissement (Word ou PDF).

Les tests automatisés utilisent un classeur fictif construit sur le modèle de celui des établissements.

05Méthodologie

  • Architecture en couches stricte : page Streamlit → service → repository → SQLite. Aucune requête SQL depuis l'interface, aucune logique métier dans les pages.
  • Un seul module de calcul de paie, source unique de vérité.
  • Cycle de vie des périodes : brouillon → ouverte → validée → clôturée. Le taux de taxe est figé au moment de la validation.
  • Imports contrôlés : écarts détectés et tableau de correction avant validation ; imports massifs avec simulation préalable (dry-run) et transaction.
  • Tests automatisés (pytest) exécutés en intégration continue avec GitHub Actions.

06Solution

  • Authentification et rôles (administrateur, gestionnaire de paie, consultation), sans aucun mot de passe par défaut.
  • Calcul, contrôle, validation et clôture de la paie.
  • Bulletins identiques au bulletin officiel de l'établissement, en Word ou en PDF.
  • Exports comptables Excel, historique et reporting sur plusieurs périodes, statistiques.
  • Gestion documentaire et archivage ; sauvegarde et restauration par l'API native SQLite, avec retour arrière automatique en cas d'échec.
  • Licence d'utilisation par clé signée (Ed25519).
  • Code source consultable sur GitHub, sous licence propriétaire.

07Technologies

  • Python
  • Streamlit
  • SQLite
  • pandas
  • openpyxl
  • python-docx
  • PyMuPDF
  • cryptography
  • pytest
  • GitHub Actions

08Résultats

Version 1.8.0, couverte par plus de 1 600 tests automatisés exécutés en intégration continue (GitHub Actions).

La sécurité des données de paie est traitée dès la conception : aucun mot de passe par défaut, droits par rôle, journalisation des changements de statut et sauvegardes vérifiées avant toute restauration.

09Limites

L'exécutable Windows est spécifié (PyInstaller) mais n'a pas encore été construit ni testé sur Windows.

Base SQLite locale : l'application est pensée pour fonctionner sur un poste, pas comme un service en ligne.