Zoubeir23/Smart-HR

Système de Gestion des Ressources Humaines Intelligent
Anticiper les départs · Automatiser le recrutement · Piloter vos talents

Démarrage rapide · Aperçu · Fonctionnalités · Architecture · Commandes Make · IA Intégrée · Déploiement

Smart-HR est une plateforme SIRH nouvelle génération qui transforme la gestion RH d'une PME en outil proactif. Là où les SIRH classiques stockent passivement les données, Smart-HR les analyse en temps réel pour anticiper les démissions, automatiser le recrutement et assister les équipes RH avec un chatbot IA contextuel.

• Prédit le churn — Un modèle Random Forest entraîné sur 1 470 employés (dataset IBM) calcule un score de risque de départ 0–100 % avec explication de la cause principale
• Analyse les CVs automatiquement — Gemini 2.5 Flash extrait compétences, expériences et calcule un score de matching sémantique face à l'offre d'emploi
• Conduit des entretiens vocaux — Intégration Vapi (WebRTC) pour des sessions d'entretien IA avec feedback structuré en fin d'appel
• Assiste les RH via chatbot — Agent conversationnel multi-LLM (Gemini, OpenAI, Anthropic, Grok) avec actions directes sur la base de données
• Gère l'ensemble du cycle RH — Congés, présences, paie, documents, formations, tâches

Page d'accueil	Connexion
Inscription candidat	Dashboard Admin
Dashboard RH	Dashboard Employé
Dashboard Candidat	Gestion des employés

• JWT (access 30 min transmis dans l'en-tête Authorization, refresh 7 jours confiné à un cookie HttpOnly hors de portée du JavaScript)
• Argon2 (hachage des mots de passe)
• OTP email 6 chiffres (brute-force : verrouillage 15 min après 5 tentatives)
• RBAC : 4 rôles (Admin, RH, Employé, Candidat)
• Aucune inscription libre : les candidats passent par /api/v1/auth/register/candidate/ (vérification OTP obligatoire), les comptes internes sont créés par un administrateur
• Réponses neutres sur l'inscription, la vérification et le renvoi d'OTP (pas d'énumération de comptes)
• Quotas dédiés : connexion (5/min), inscription (5/h), OTP (10/h), renvoi d'OTP (3/h), réinitialisation de mot de passe (3/h)

• Content-Security-Policy sur l'API (Django) et sur le document HTML de la SPA (nginx)
• Fichiers sensibles (CV, contrats, bulletins de paie) servis via une vue protégée avec contrôle d'accès par propriétaire, URLs signées et expirantes en cas de stockage objet
• Logs d'audit (AuditLog) pour toutes les actions critiques
• Export RGPD des données personnelles (droit à la portabilité, endpoint dédié)
• Anonymisation RGPD des données d'un employé (droit à l'oubli, réservé Admin)
• Pages légales dédiées : Politique de confidentialité, CGU, RGPD, Mentions légales (/privacy, /terms, /gdpr, /legal-notice)

┌──────────────────────────────────────────────────────────┐
│              Frontend  React 18 + TypeScript + Vite       │
│  Pages · Composants · Services Axios · React Query        │
└────────────────────────┬─────────────────────────────────┘
                         │  REST API (JWT)
┌────────────────────────▼─────────────────────────────────┐
│              Backend  Django 6 + DRF                      │
│  users · personnel · recruitment · conge · ai · ai_engine │
│  Celery Workers  │  Celery Beat (cron hebdo)              │
└──────┬───────────┴──────────────────────┬────────────────┘
       │                                  │
┌──────▼───────┐              ┌───────────▼──────────────┐
│  PostgreSQL  │              │  Redis (cache + Celery)  │
└──────────────┘              └──────────────────────────┘
                                          │
              ┌───────────────────────────▼───────────────┐
              │  IA externe                                │
              │  Gemini 2.5 Flash · OpenAI · Anthropic     │
              │  Grok · Vapi (WebRTC voice)                │
              └───────────────────────────────────────────┘

Smart-HR/
├── Backend/
│   ├── config/                 # Settings Django (base / local / production)
│   │   ├── settings/
│   │   │   ├── base.py
│   │   │   ├── local.py
│   │   │   └── production.py
│   │   └── urls.py
│   ├── smart_hr/
│   │   ├── users/              # Auth JWT, OTP, RBAC
│   │   ├── personnel/          # Employés, départements, postes
│   │   ├── recruitment/        # Offres d'emploi, candidatures, analyse CV
│   │   ├── conge/               # Demandes et validation de congés
│   │   ├── presence/            # Pointage et présences
│   │   ├── paiement/            # Salaires, bulletins de paie (moteur multi-pays)
│   │   ├── document/            # Gestion documentaire (contrats, attestations)
│   │   ├── formation/           # Formations et réunions
│   │   ├── tache/               # Gestion des tâches (Kanban)
│   │   ├── performance/        # Évaluations, feedback 360, coaching
│   │   ├── discipline/         # Actions disciplinaires
│   │   ├── communication/      # Messages internes, alertes de détresse
│   │   ├── survey/              # Enquêtes internes
│   │   ├── ai/                  # Chatbot multi-LLM + actions RH (function-calling)
│   │   ├── ai_agents/           # Sessions d'assistant vocal RH (mêmes LLM que le chatbot)
│   │   ├── ai_engine/           # Prédiction churn (Random Forest)
│   │   └── core/                # Modèles partagés, sécurité média, AuditLog
│   ├── pyproject.toml           # Dépendances (gérées via `uv`)
│   └── Dockerfile
│
├── Frontend/
│   ├── src/
│   │   ├── pages/              # Toutes les pages (dashboard, recrutement, IA...)
│   │   ├── components/         # Composants réutilisables
│   │   ├── services/           # Couche Axios (authService, recruitmentService...)
│   │   ├── hooks/              # Custom React hooks
│   │   ├── lib/                # Utilitaires et helpers
│   │   └── types/              # Types TypeScript partagés
│   ├── public/
│   │   ├── logo.svg            # Logo icône seul
│   │   └── logo-lockup.svg     # Logo + texte
│   └── Dockerfile
│
├── nginx/                       # Configuration reverse proxy
├── docker-compose.yml
└── .github/workflows/           # CI/CD GitHub Actions

• Python 3.13
• Node.js 18+
• PostgreSQL 15+
• Redis 7+
• Docker (optionnel, recommandé)

Une fois les fichiers .env créés (voir Variables d'Environnement), tout se lance en une seule commande :

git clone https://github.com/Zoubeir23/Smart-HR.git
cd Smart-HR

mkdir -p Backend/.envs/.local
touch Backend/.envs/.local/.django Backend/.envs/.local/.postgres
cp Frontend/.env.example Frontend/.env
# Éditer les fichiers .env avec vos clés API

make init-all   # up + migrate + seed-demo, dans l'ordre, avec les temps d'attente nécessaires

La liste complète des commandes disponibles est dans la section Commandes Make ci-dessous, ou via make help.

git clone https://github.com/Zoubeir23/Smart-HR.git
cd Smart-HR

# Créer les fichiers de variables d'environnement (voir la section
# "Variables d'Environnement" pour la liste complète des clés à renseigner)
mkdir -p Backend/.envs/.local
touch Backend/.envs/.local/.django Backend/.envs/.local/.postgres
cp Frontend/.env.example Frontend/.env
# Éditer les fichiers .env avec vos clés API

# Lancer tous les services
docker compose up -d

# Initialiser la base de données
docker compose exec django python manage.py migrate
docker compose exec django python manage.py seed_demo_data

# L'application est disponible sur http://localhost:8080

cd Backend

# Installer uv (gestionnaire de dépendances, remplace pip/venv)
pip install uv

# Installer les dépendances et créer l'environnement virtuel automatiquement
uv sync
source .venv/bin/activate

# Variables d'environnement — créer .envs/.local/.django (voir la section
# "Variables d'Environnement" ci-dessous pour la liste complète des clés)
mkdir -p .envs/.local
touch .envs/.local/.django .envs/.local/.postgres

# Base de données
python manage.py migrate
python manage.py seed_demo_data

# Lancer le serveur
python manage.py runserver
# API disponible sur http://localhost:8000/api/v1/

cd Frontend

# Installer les dépendances
npm install

# Variables d'environnement
cp .env.example .env
# Éditer .env : VITE_API_URL=http://localhost:8000

# Lancer le serveur de développement
npm run dev
# Interface disponible sur http://localhost:5173

cd Backend
# Worker
celery -A config.celery_app worker --loglevel=info

# Scheduler (Celery Beat)
celery -A config.celery_app beat --loglevel=info

Toutes les commandes agissent sur la stack Docker locale (Backend/docker-compose.local.yml), sauf mention contraire. Liste complète et à jour : make help.

Le modèle Random Forest est entraîné sur le dataset IBM HR Analytics (1 470 employés, 35 features). Il prédit la probabilité de départ d'un employé avec un score 0–100 % et affiche la cause principale identifiée.

# Ré-entraîner manuellement le modèle
python manage.py train_churn_model

# Ou déclencher via l'API (RH/Admin uniquement)
POST /api/v1/ai-engine/retrain/

Le ré-entraînement automatique s'exécute chaque semaine via Celery Beat (configurable dans CELERY_BEAT_SCHEDULE).

Lors d'une candidature, Gemini analyse le CV en PDF et génère un score de matching sémantique (0–100) par rapport à la description du poste. Le score est stocké sur le modèle Application et filtrable depuis le dashboard RH.

La page /ai/recruteur intègre le SDK Vapi WebRTC pour conduire des entretiens vocaux IA en temps réel. Un feedback structuré (points forts, points faibles, recommandation) est généré automatiquement à la fin de chaque session.

Configuration requise :

VITE_VAPI_PUBLIC_KEY=votre_cle_publique_vapi

L'assistant conversationnel supporte 4 fournisseurs de LLM configurables :

Au-delà de la conversation, le chatbot exécute directement des actions métier via function-calling natif, filtrées par rôle :

Une fiche de poste ou un document peut être joint au message : son contenu (assaini contre l'injection de prompt) alimente à la fois la réponse conversationnelle et la détection d'action — « crée l'offre à partir de ce fichier » fonctionne directement.

Le chatbot détecte la confusion de l'utilisateur (2 réponses consécutives hors-contexte) et propose automatiquement une escalade vers un RH humain.

Le projet est déployé sur VPS avec Dokploy comme orchestrateur Docker. La configuration complète est disponible dans Docs/.

# Variables d'environnement de production critiques
DATABASE_URL=postgres://...
REDIS_URL=redis://...
DJANGO_SECRET_KEY=...
DJANGO_SETTINGS_MODULE=config.settings.production

# IA
GEMINI_API_KEY=...
VITE_VAPI_PUBLIC_KEY=...

# Email (SMTP Gmail)
EMAIL_HOST=smtp.gmail.com
EMAIL_PORT=587
EMAIL_HOST_USER=...
EMAIL_HOST_PASSWORD=...  # App password Gmail

Deux workflows (.github/workflows/ci.yml et cd.yml) :

CI — 4 jobs en parallèle sur chaque push/PR vers main :

1. Backend — Lint : hooks pre-commit (ruff, djLint, django-upgrade)
2. Backend — Tests : pytest dans un environnement Docker Compose complet (PostgreSQL inclus)
3. Frontend — Quality : tsc --noEmit, ESLint, Vitest, build de production
4. Security — Trivy Scan : scan de vulnérabilités (dépendances + filesystem)

CD — se déclenche uniquement si la CI complète réussit :

1. Build et push des images Docker (Backend + Frontend) vers GHCR
2. Scan Trivy des images construites
3. Déploiement automatique sur le VPS

Le frontend est servi par nginx avec deux configurations :

• Frontend/nginx.vps.conf — utilisée en production (Dockerfile) : proxy /api/ et /admin/ vers Django, Content-Security-Policy et headers de sécurité sur le document HTML de la SPA, blocage des scans de vulnérabilités courants, cache 1 an sur les assets statiques
• Frontend/nginx.conf — configuration de développement, plus minimale

# Général
USE_DOCKER=yes
DJANGO_SECRET_KEY=your-secret-key   # generer via: python -c "import secrets; print(secrets.token_urlsafe(50))"
IPYTHONDIR=/app/.ipython

# Cache & Celery
REDIS_URL=redis://redis:6379/0
CELERY_FLOWER_USER=your_flower_user
CELERY_FLOWER_PASSWORD=your_flower_password

# Email — Gmail SMTP (OTP, notifications recrutement)
EMAIL_HOST=smtp.gmail.com
EMAIL_PORT=587
EMAIL_USE_TLS=True
EMAIL_HOST_USER=[email protected]
EMAIL_HOST_PASSWORD=your_app_password

# Admin — notifications d'erreurs Django
DJANGO_ADMIN_NAME=Admin
DJANGO_ADMIN_EMAIL=[email protected]

# IA — Google Gemini par défaut ; les autres fournisseurs sont optionnels
GEMINI_API_KEY=...
OPENAI_API_KEY=...
ANTHROPIC_API_KEY=...
GROK_API_KEY=...

POSTGRES_HOST=postgres
POSTGRES_PORT=5432
POSTGRES_DB=smart_hr
POSTGRES_USER=smart_hr
POSTGRES_PASSWORD=your-password

VITE_API_URL=http://localhost:8000
VITE_VAPI_PUBLIC_KEY=your_vapi_public_key

765 tests backend (pytest) et 238 tests frontend (Vitest), exécutés à chaque push via la CI.

# Backend — tests unitaires et d'intégration
cd Backend
pytest

# Avec couverture
pytest --cov=smart_hr --cov-report=term-missing

# Frontend — type checking
cd Frontend
npx tsc --noEmit

# Linting
npm run lint

1. Forker le dépôt
2. Créer une branche : git checkout -b Feature/XXX-description
3. Commiter : git commit -m "feat: description"
4. Pousser : git push origin Feature/XXX-description
5. Ouvrir une Pull Request

Zoubeir IBRAHIMA AMED Projet de soutenance HESTAFRICA 2026

GitHub

MIT — voir LICENSE

Smart-HR · SIRH Intelligent · HESTAFRICA 2026