diff --git a/.claude/settings.local.json b/.claude/settings.local.json new file mode 100644 index 0000000..502e17c --- /dev/null +++ b/.claude/settings.local.json @@ -0,0 +1,12 @@ +{ + "permissions": { + "allow": [ + "Bash(npx vue-tsc:*)", + "Bash(npx nuxi:*)", + "Bash(php:*)", + "Bash(docker compose:*)", + "Bash(make test:*)", + "Bash(grep:*)" + ] + } +} diff --git a/.idea/SIRH.iml b/.idea/SIRH.iml index c7476c0..47ac152 100644 --- a/.idea/SIRH.iml +++ b/.idea/SIRH.iml @@ -152,6 +152,8 @@ + + diff --git a/.idea/db-forest-config.xml b/.idea/db-forest-config.xml index 651867c..c621ddf 100644 --- a/.idea/db-forest-config.xml +++ b/.idea/db-forest-config.xml @@ -1,6 +1,6 @@ - \ No newline at end of file diff --git a/.idea/php.xml b/.idea/php.xml index 6df8250..c4734e1 100644 --- a/.idea/php.xml +++ b/.idea/php.xml @@ -153,6 +153,8 @@ + + diff --git a/AGENTS.md b/AGENTS.md index 02f1a16..b91a212 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -13,6 +13,13 @@ Arborescence clé: - `tests/`: TU backend (PHPUnit) - `frontend/`: app Nuxt (pages, composants, composables, services) - `migrations/`: migrations Doctrine +- `doc/`: documentation fonctionnelle et règles métier de référence + +## 1.1) Référentiel Fonctionnel (obligatoire) + +- Référence principale des règles métier: `doc/functional-rules.md` +- Toute intervention doit commencer par une vérification de cohérence avec cette documentation. +- Règle permanente: à chaque développement qui modifie le fonctionnel, la documentation dans `doc/` doit être mise à jour automatiquement dans la même intervention (pas de report). ## 2) Commandes utiles diff --git a/composer.json b/composer.json index bf8f442..c7ed2ef 100644 --- a/composer.json +++ b/composer.json @@ -87,6 +87,7 @@ } }, "require-dev": { + "doctrine/doctrine-fixtures-bundle": "^4.3", "friendsofphp/php-cs-fixer": "^3.93", "phpunit/phpunit": "^12.5" } diff --git a/composer.lock b/composer.lock index 58cd62f..cb7c9e7 100644 --- a/composer.lock +++ b/composer.lock @@ -4,7 +4,7 @@ "Read more about it at https://getcomposer.org/doc/01-basic-usage.md#installing-dependencies", "This file is @generated automatically" ], - "content-hash": "71d28cc0a29fa3f385b067186aa43678", + "content-hash": "b540b6cb25ef55c5eebccb57c76da584", "packages": [ { "name": "api-platform/doctrine-common", @@ -8504,6 +8504,175 @@ ], "time": "2024-05-06T16:37:16+00:00" }, + { + "name": "doctrine/data-fixtures", + "version": "2.2.0", + "source": { + "type": "git", + "url": "https://github.com/doctrine/data-fixtures.git", + "reference": "7a615ba135e45d67674bb623d90f34f6c7b6bd97" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/doctrine/data-fixtures/zipball/7a615ba135e45d67674bb623d90f34f6c7b6bd97", + "reference": "7a615ba135e45d67674bb623d90f34f6c7b6bd97", + "shasum": "" + }, + "require": { + "doctrine/persistence": "^3.1 || ^4.0", + "php": "^8.1", + "psr/log": "^1.1 || ^2 || ^3" + }, + "conflict": { + "doctrine/dbal": "<3.5 || >=5", + "doctrine/orm": "<2.14 || >=4", + "doctrine/phpcr-odm": "<1.3.0" + }, + "require-dev": { + "doctrine/coding-standard": "^14", + "doctrine/dbal": "^3.5 || ^4", + "doctrine/mongodb-odm": "^1.3.0 || ^2.0.0", + "doctrine/orm": "^2.14 || ^3", + "ext-sqlite3": "*", + "fig/log-test": "^1", + "phpstan/phpstan": "2.1.31", + "phpunit/phpunit": "10.5.45 || 12.4.0", + "symfony/cache": "^6.4 || ^7", + "symfony/var-exporter": "^6.4 || ^7" + }, + "suggest": { + "alcaeus/mongo-php-adapter": "For using MongoDB ODM 1.3 with PHP 7 (deprecated)", + "doctrine/mongodb-odm": "For loading MongoDB ODM fixtures", + "doctrine/orm": "For loading ORM fixtures", + "doctrine/phpcr-odm": "For loading PHPCR ODM fixtures" + }, + "type": "library", + "autoload": { + "psr-4": { + "Doctrine\\Common\\DataFixtures\\": "src" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Jonathan Wage", + "email": "jonwage@gmail.com" + } + ], + "description": "Data Fixtures for all Doctrine Object Managers", + "homepage": "https://www.doctrine-project.org", + "keywords": [ + "database" + ], + "support": { + "issues": "https://github.com/doctrine/data-fixtures/issues", + "source": "https://github.com/doctrine/data-fixtures/tree/2.2.0" + }, + "funding": [ + { + "url": "https://www.doctrine-project.org/sponsorship.html", + "type": "custom" + }, + { + "url": "https://www.patreon.com/phpdoctrine", + "type": "patreon" + }, + { + "url": "https://tidelift.com/funding/github/packagist/doctrine%2Fdata-fixtures", + "type": "tidelift" + } + ], + "time": "2025-10-17T20:06:20+00:00" + }, + { + "name": "doctrine/doctrine-fixtures-bundle", + "version": "4.3.1", + "source": { + "type": "git", + "url": "https://github.com/doctrine/DoctrineFixturesBundle.git", + "reference": "9e013ed10d49bf7746b07204d336384a7d9b5a4d" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/doctrine/DoctrineFixturesBundle/zipball/9e013ed10d49bf7746b07204d336384a7d9b5a4d", + "reference": "9e013ed10d49bf7746b07204d336384a7d9b5a4d", + "shasum": "" + }, + "require": { + "doctrine/data-fixtures": "^2.2", + "doctrine/doctrine-bundle": "^2.2 || ^3.0", + "doctrine/orm": "^2.14.0 || ^3.0", + "doctrine/persistence": "^2.4 || ^3.0 || ^4.0", + "php": "^8.1", + "psr/log": "^2 || ^3", + "symfony/config": "^6.4 || ^7.0 || ^8.0", + "symfony/console": "^6.4 || ^7.0 || ^8.0", + "symfony/dependency-injection": "^6.4 || ^7.0 || ^8.0", + "symfony/deprecation-contracts": "^2.1 || ^3", + "symfony/doctrine-bridge": "^6.4.16 || ^7.1.9 || ^8.0", + "symfony/http-kernel": "^6.4 || ^7.0 || ^8.0" + }, + "conflict": { + "doctrine/dbal": "< 3" + }, + "require-dev": { + "doctrine/coding-standard": "14.0.0", + "phpstan/phpstan": "2.1.11", + "phpunit/phpunit": "^10.5.38 || 11.4.14" + }, + "type": "symfony-bundle", + "autoload": { + "psr-4": { + "Doctrine\\Bundle\\FixturesBundle\\": "src" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Fabien Potencier", + "email": "fabien@symfony.com" + }, + { + "name": "Doctrine Project", + "homepage": "https://www.doctrine-project.org" + }, + { + "name": "Symfony Community", + "homepage": "https://symfony.com/contributors" + } + ], + "description": "Symfony DoctrineFixturesBundle", + "homepage": "https://www.doctrine-project.org", + "keywords": [ + "Fixture", + "persistence" + ], + "support": { + "issues": "https://github.com/doctrine/DoctrineFixturesBundle/issues", + "source": "https://github.com/doctrine/DoctrineFixturesBundle/tree/4.3.1" + }, + "funding": [ + { + "url": "https://www.doctrine-project.org/sponsorship.html", + "type": "custom" + }, + { + "url": "https://www.patreon.com/phpdoctrine", + "type": "patreon" + }, + { + "url": "https://tidelift.com/funding/github/packagist/doctrine%2Fdoctrine-fixtures-bundle", + "type": "tidelift" + } + ], + "time": "2025-12-03T16:05:42+00:00" + }, { "name": "evenement/evenement", "version": "v3.0.2", diff --git a/config/bundles.php b/config/bundles.php index 746539c..1c5d047 100644 --- a/config/bundles.php +++ b/config/bundles.php @@ -4,6 +4,7 @@ declare(strict_types=1); use ApiPlatform\Symfony\Bundle\ApiPlatformBundle; use Doctrine\Bundle\DoctrineBundle\DoctrineBundle; +use Doctrine\Bundle\FixturesBundle\DoctrineFixturesBundle; use Doctrine\Bundle\MigrationsBundle\DoctrineMigrationsBundle; use Lexik\Bundle\JWTAuthenticationBundle\LexikJWTAuthenticationBundle; use Nelmio\CorsBundle\NelmioCorsBundle; @@ -22,4 +23,5 @@ return [ ApiPlatformBundle::class => ['all' => true], LexikJWTAuthenticationBundle::class => ['all' => true], MonologBundle::class => ['all' => true], + DoctrineFixturesBundle::class => ['dev' => true, 'test' => true], ]; diff --git a/config/packages/monolog.yaml b/config/packages/monolog.yaml index 06b67a2..cf2b085 100644 --- a/config/packages/monolog.yaml +++ b/config/packages/monolog.yaml @@ -1,14 +1,19 @@ monolog: - channels: [deprecation] + channels: [deprecation, cron] when@dev: monolog: handlers: + cron: + type: stream + path: "%kernel.logs_dir%/cron.log" + level: info + channels: [cron] main: type: stream path: "%kernel.logs_dir%/%kernel.environment%.log" level: debug - channels: ["!event"] + channels: ["!event", "!cron"] console: type: console process_psr_3_messages: false @@ -17,11 +22,16 @@ when@dev: when@prod: monolog: handlers: + cron: + type: stream + path: "%kernel.logs_dir%/cron.log" + level: info + channels: [cron] main: type: stream path: "%kernel.logs_dir%/%kernel.environment%.log" level: debug - channels: ["!deprecation"] + channels: ["!deprecation", "!cron"] deprecation: type: stream channels: [deprecation] diff --git a/config/services.yaml b/config/services.yaml index 9a7408a..f1d8a11 100644 --- a/config/services.yaml +++ b/config/services.yaml @@ -23,8 +23,10 @@ services: resource: '../src/' App\Repository\Contract\AbsenceReadRepositoryInterface: '@App\Repository\AbsenceRepository' + App\Repository\Contract\EmployeeContractPeriodReadRepositoryInterface: '@App\Repository\EmployeeContractPeriodRepository' App\Repository\Contract\EmployeeScopedRepositoryInterface: '@App\Repository\EmployeeRepository' App\Repository\Contract\WorkHourReadRepositoryInterface: '@App\Repository\WorkHourRepository' + App\Service\Contracts\EmployeeContractPeriodManagerInterface: '@App\Service\Contracts\EmployeeContractPeriodManager' # add more service definitions when explicit configuration is needed # please note that last definitions always *replace* previous ones diff --git a/doc/functional-rules.md b/doc/functional-rules.md new file mode 100644 index 0000000..ce18874 --- /dev/null +++ b/doc/functional-rules.md @@ -0,0 +1,255 @@ +# Règles Fonctionnelles SIRH + +Ce document centralise les règles métier actuellement implémentées dans l'application. + +Documents complementaires: +- `doc/leave-rollover.md` (rollover conges et checklist de lancement) +- `doc/rtt-rollover.md` (rollover RTT et checklist de lancement) + +## 1) Utilisateurs et accès + +- `ROLE_ADMIN` + - accès complet aux écrans d'administration + - vue semaine des heures + - validation RH des lignes d'heures +- `ROLE_SELF` + - accès limité à son périmètre personnel +- Accès "Sites" (via `user_site_roles` avec rôle `SITE_ACCESS`) + - accès au périmètre des sites autorisés + - validation site des lignes d'heures + +## 2) Contrats + +- Le profil de temps de travail est porté par `Contract`: + - `trackingMode`: `TIME` ou `PRESENCE` + - `weeklyHours` (ex: 35, 39, 4, etc.) +- La nature RH est portée par période employé: + - `CDI`, `CDD`, `INTERIM` +- Historique des contrats employé: + - table `employee_contract_periods` + - un employé peut avoir plusieurs périodes + +### Règles de période + +- `CDI`: + - à la création d'une période: `endDate` doit être vide + - en clôture d'un contrat en cours: `endDate` peut être renseignée +- `CDD` / `INTERIM`: + - `endDate` obligatoire +- `endDate` ne peut pas être antérieure à `startDate` + +## 3) Heures (vue jour) + +- Saisie par salarié et par date: + - matin / après-midi / soir + - pour `PRESENCE`: demi-journées matin/après-midi +- Sélecteur de temps: + - créneaux de 15 minutes uniquement (00:00, 00:15, ..., 23:45) + - saisie libre possible mais valeur vidée au blur si hors options +- Calculs affichés: + - `Jour`, `Nuit`, `Total` +- Heures de nuit: + - fenêtres `00:00-06:00` et `21:00-24:00` +- Date de modification (`updatedAt`): + - mise à jour uniquement quand un employé (`ROLE_SELF`) modifie ses propres heures + - non mise à jour lors de modifications admin ou chef de site + - affichée sous le nom de l'employé (visible admin uniquement) + +## 4) Absences + +- Les absences sont stockées par jour (découpage lors de l'écriture) +- Une absence peut être: + - journée complète + - demi-journée `AM` ou `PM` +- Colonne absence (vue jour): + - affiche le libellé + - fond coloré selon le type d'absence +- Calendrier congés: fond coloré selon la couleur du type d'absence (`AbsenceType.color`) + - demi-journée: dégradé diagonal + - journée complète: fond plein + +### Effet absence sur les heures + +- Absence `AM`: + - efface les heures du matin +- Absence `PM`: + - efface les heures d'après-midi et du soir +- Absence journée: + - efface toutes les plages horaires + +### Absences "comptées comme travaillées" + +- Si `countAsWorkedHours = true`: + - `TIME`: crédit de minutes selon contrat actif du jour + - `PRESENCE` (forfait): aucun crédit de présence (seules les checkboxes cochées comptent) + +## 5) Validations des lignes d'heures + +- Validation RH (`isValid`) + - action admin +- Validation site (`isSiteValid`) + - action chef de site + +### Verrouillage + +- Ligne validée RH: + - verrouillée pour modifications heures/absences +- Ligne validée site: + - verrouillée pour non-admin + - admin peut corriger +- Toute vraie modification d'une ligne: + - remet `isSiteValid = false` + - remet `isValid = false` +- Si aucun changement réel à l'enregistrement: + - les validations existantes ne sont pas altérées + +## 6) Heures supplémentaires (vue semaine) + +- Base de calcul: + - dépend du contrat actif par jour +- Tranche 25%: + - contrats <= 35h: de 35h à 43h + - contrats >= 39h: de 39h à 43h +- Tranche 50%: + - au-delà de 43h +- Nature `INTERIM`: + - pas de bonus 25% + - pas de bonus 50% + - pas de total récup + +## 7) Fériés + +- Les jours fériés sont identifiés et affichés +- Onglet congés: jours fériés affichés sur le calendrier avec fond `rgb(179, 229, 252)` et nom au survol +- Règle courante: + - absences bloquées sur jour férié + - saisie d'heures autorisée + +## 8) Impression absences (PDF) + +Filtres disponibles: +- période `from` / `to` +- sites +- nature de contrat (`CDI`, `CDD`, `INTERIM`) +- temps de travail (contrats de type Forfait, 35h, 39h, etc.) + +Tous les filtres checkbox sont cochés par défaut à l'ouverture du drawer. + +## 9) Employés + +- Création employé: + - prénom, nom, site + - type de contrat (nature RH) + - temps de travail + - dates début/fin (selon règles nature) +- Modification employé: + - uniquement prénom, nom, site + - pas de modification de contrat depuis ce drawer +- Détail employé: + - onglet `Suivi contrat` avec affichage de l'historique des périodes de contrat + - chaque ligne expose: nature (`CDI`/`CDD`/`INTERIM`), contrat/temps de travail, date de début, date de fin (ou "En cours") + - action `Clôturer`: + - bouton actif uniquement s'il existe un contrat en cours non déjà clôturé à la date du jour + - ouvre un drawer en lecture seule (type/temps de travail/date de début) + - champs saisissables: + - `contractEndDate` (prérempli à aujourd'hui) + - `contractPaidLeaveSettled` (checkbox "Soldé dans le solde de tout compte") + - backend: en mode clôture, le flag `contractPaidLeaveSettled` est persisté sur la période clôturée + - action `Ajouter`: + - conserve le flux d'ajout d'un nouveau contrat via drawer dédié + - disponible uniquement s'il n'y a pas de contrat en cours, ou si le contrat en cours a déjà une date de fin + - onglet `Congé`: + - endpoint de synthèse: `GET /api/employees/{id}/leave-summary?year=YYYY` + - phase 1 métier (`CDI`/`CDD` non forfait + `FORFAIT`): + - exercice CP: + - `CDI`/`CDD` non forfait: du `1er juin (YYYY-1)` au `31 mai (YYYY)` (paramètre `year` = année de fin d'exercice) + - `FORFAIT`: du `1er janvier (YYYY)` au `31 décembre (YYYY)` (paramètre `year` = année civile) + - contrats `39h` / `35h` / `25h` (et plus largement CDI/CDD non forfait hors `4h`): + - acquis annuel CP: `25` + - acquis annuel samedi: `5` + - en cours d'acquisition jours: `25/12 = 2,08` jours/mois + - en cours d'acquisition samedis: `5/12 = 0,42` samedi/mois (non detaille en UI) + - samedis acquis affiches: uniquement `opening_saturdays` (report N-1) + - contrat `4h`: + - acquis annuel CP: `10` + - acquis annuel samedi: `0` + - en cours d'acquisition: `0.83` jour/mois + - contrat `FORFAIT`: + - base annuelle: `jours ouvrés de l'exercice (lundi-vendredi, hors jours fériés métropole) - 218` + - prorata: en cas de démarrage/fin de contrat en cours d'année civile, le calcul ne couvre que l'intervalle actif du contrat dans l'année + - reste à prendre: `acquis - absences` (toutes absences, demi-journées incluses) + - pas de samedi (`0`) + - pas de jours en cours d'acquisition (`0`) + - fractionné: saisie manuelle par la RH via `PATCH /employees/{id}/fractioned-days`, stocké dans `employee_leave_balances.fractioned_days`. Les jours fractionnés sont ajoutés aux acquis et au reste à prendre. + - pour `CDI`/`CDD` non forfait: + - pris CP: basé sur absences de type code `C` (CONGÉ), en tenant compte des demi-journées + - samedi pris: absences `C` posées le samedi (demi-journée incluse) + - restants = acquis - pris (borné à 0) + - pour `FORFAIT`: + - pris: basé sur toutes les absences (demi-journées incluses) + - restants = acquis - pris (borné à 0) + - report annuel: + - le reliquat (`restants`) de l'exercice précédent est reporté dans les acquis de l'exercice courant + - pour `CDI`/`CDD` non forfait: report séparé jours + samedis + - pour `FORFAIT`: report uniquement sur les jours + - si un solde d'ouverture existe en base (`employee_leave_balances`) pour l'exercice courant, ce solde devient la source prioritaire du report + - si une clôture de contrat est marquée `contractPaidLeaveSettled=true` sur l'exercice précédent, le report vers l'exercice suivant est remis à `0` + - si une clôture `contractPaidLeaveSettled=true` existe dans l'exercice courant, le calcul est réinitialisé à partir du lendemain de cette clôture (pas de continuité intra-exercice) + - lecture des compteurs: + - `acquis` = droits reportés de l'exercice N-1 (après application des règles de soldé) + - `en cours d'acquisition` = total droits générés sur l'exercice N (jours + samedis en cours), sans detail séparé en UI + - règle de consommation: + - les absences s'imputent d'abord sur `acquis`, puis sur `en cours d'acquisition` + - la prise sur `en cours d'acquisition` est autorisée (usage anticipé) + - `en cours d'acquisition` peut devenir négatif si la prise dépasse le généré (ex: `2.08 - 3 = -0.92`), puis se reconstitue avec les acquisitions suivantes + - date d'arret de calcul: + - les compteurs sont calculés jusqu'au dernier jour du mois précédent (le mois en cours est exclu) + - exemple: au `04/03/2026`, l'arret de calcul est le `28/02/2026` (ou `29/02` en année bissextile) + - hors périmètre phase 1: `INTERIM` (retour non supporté) + - onglet `RTT`: + - endpoint de synthèse: `GET /api/employees/{id}/rtt-summary?year=YYYY` + - exercice RTT: du `1er juin (YYYY-1)` au `31 mai (YYYY)` (paramètre `year` = année de fin d'exercice) + - affichage: + - détail hebdomadaire (semaine ISO) regroupé par mois + - total mensuel des minutes de récupération + - compteur global exercice = `report N-1 + acquis N` + - attribution mensuelle des semaines: + - une semaine ISO est affichée une seule fois, dans le mois qui contient le **samedi** de cette semaine + - si le weekend tombe en début de mois suivant, c'est le mois suivant qui porte la semaine + - logique de calcul: + - base identique aux calculs d'heures supplémentaires de la vue semaine Heures + - minutes de récupération hebdomadaires = `HS totales + bonus 25% + bonus 50%` + - contrats `INTERIM` et suivi `PRESENCE`: récupération à `0` + - compteur global: + - affiché en **jours** (1 jour = 7h = 420 minutes) + - report: + - le report N-1 correspond à la somme des minutes de récupération calculées sur l'exercice précédent + - si une ligne existe dans `employee_rtt_balances` pour `(employee, year)`, le champ `opening_minutes` est utilisé en priorité + - sinon, le calcul dynamique sur l'exercice N-1 est effectué + - rollover automatique: + - commande: `php bin/console app:rtt:rollover` + - s'exécute le `1er juin` (même cron que le rollover congés) + - calcule le total récup N-1 et le persiste en `opening_minutes` du nouvel exercice + - idempotent (ne recrée pas si la ligne existe) + - paiement RTT: + - saisie RH via `PATCH /employees/{id}/rtt-payments` (body: `month`, `minutes`, `rate`) + - stocké dans `employee_rtt_payments` (employee, year, month, minutes, rate) + - `rate`: taux de majoration, valeurs `25` ou `50` + - les heures payées sont soustraites du disponible RTT (`availableMinutes -= totalPaidMinutes`) + - affichage: 2 lignes par mois dans le tableau (25% et 50%) + - affichage: + - le compteur global RTT est affiché en **heures** (format `Xh00`) + +## 10) Notifications + +- Icône cloche en topbar: + - badge = nombre de notifications non lues + - ouverture panneau = liste des non lues + - fermeture panneau = marquage "lu" en masse + +### Règle métier de déclenchement + +- Les notifications de validation site ne sont pas envoyées ligne par ligne. +- Une notification est créée uniquement quand un chef de site termine la validation complète: + - condition: plus aucune ligne `work_hours` du site à la date concernée avec `isSiteValid = false` + - destinataires: utilisateurs `ROLE_ADMIN` diff --git a/doc/leave-rollover.md b/doc/leave-rollover.md new file mode 100644 index 0000000..3b26087 --- /dev/null +++ b/doc/leave-rollover.md @@ -0,0 +1,226 @@ +# Rollover Conges - Regles et Mise en Production + +Document de reference pour expliquer le fonctionnement metier du report N-1 et preparer le lancement en production. + +## 1) Objectif + +Eviter les recalculs "depuis le debut du contrat" et fiabiliser les soldes. + +Principe: +- le solde est stocké par exercice +- au changement d'exercice, on ouvre la nouvelle période avec un "solde d'ouverture" (report N-1) +- un indicateur de cloture (`contractPaidLeaveSettled`) permet de couper la continuité entre 2 contrats + +## 2) Exercices metier + +- `CDI` / `CDD` non forfait: + - exercice: `1er juin` au `31 mai` + - `year` = annee de fin d'exercice (ex: `2026` = 01/06/2025 -> 31/05/2026) +- `FORFAIT`: + - exercice: `1er janvier` au `31 decembre` + - `year` = annee civile +- `INTERIM`: + - hors perimetre conges + +## 3) Logique de compteurs + +- `acquis`: + - correspond au report N-1 (solde d'ouverture) +- `en cours d'acquisition`: + - correspond aux droits generes sur l'exercice en cours +- `pris`: + - non forfait: absences type `C` (conge) + - forfait: toutes absences +- `restant`: + - `acquis + en_cours - pris` (borne a 0 dans l'affichage) + +## 4) Effet du "solde de tout compte" + +Le champ de cloture `contractPaidLeaveSettled` est saisi lors de la fermeture d'une periode contrat. + +- `false`: + - continuite des droits entre contrats +- `true`: + - pas de reprise des droits precedents + - reset de continuite au lendemain de la date de cloture + +## 5) Table cible + +Table `employee_leave_balances` (une ligne par employe et exercice): +- `employee_id` +- `rule_code` (`CDI_CDD_NON_FORFAIT` ou `FORFAIT_218`) +- `year` +- `opening_days` +- `opening_saturdays` +- `accrued_days` +- `accrued_saturdays` (optionnel selon implementation) +- `taken_days` +- `taken_saturdays` +- `closing_days` +- `closing_saturdays` +- `is_locked` +- `created_at`, `updated_at` + +Contrainte unique recommandee: +- `(employee_id, rule_code, year)` + +Etat implementation: +- la table est creee +- le calcul de synthese conges lit en priorite `opening_days/opening_saturdays` de cette table quand une ligne existe pour `(employee, rule_code, year)` +- si aucune ligne n'existe, le calcul reste base sur le report dynamique N-1 +- la commande `app:leave:rollover` calcule aussi le report dynamique N-1 si la ligne N-1 n'est pas encore persistée (pas de reset a 0 par defaut) + +### Definition des colonnes + +- `employee_id`: + - identifiant employe (FK vers `employees`) + - une ligne de solde par employe / regle / exercice +- `rule_code`: + - code de regle appliquee (`CDI_CDD_NON_FORFAIT`, `FORFAIT_218`) + - permet de savoir quelles regles de calcul sont utilisees +- `year`: + - annee d'exercice + - non forfait: annee de fin d'exercice (`2026` = 01/06/2025 -> 31/05/2026) + - forfait: annee civile (`2026` = 01/01/2026 -> 31/12/2026) +- `opening_days`: + - report N-1 en jours (solde d'ouverture) +- `opening_saturdays`: + - report N-1 "samedis" (0 pour forfait) +- `accrued_days`: + - droits generes sur l'exercice courant (N) +- `accrued_saturdays`: + - droits samedis generes sur N (0 pour forfait) +- `taken_days`: + - jours poses sur l'exercice +- `taken_saturdays`: + - samedis poses sur l'exercice (0 pour forfait) +- `closing_days`: + - solde de cloture jours (`opening_days + accrued_days - taken_days`) +- `closing_saturdays`: + - solde de cloture samedis (`opening_saturdays + accrued_saturdays - taken_saturdays`) +- `is_locked`: + - `false` sur exercice ouvert (recalcul possible) + - `true` apres validation RH (exercice fige) +- `created_at`, `updated_at`: + - trace technique creation / mise a jour + +## 6) Rollover automatique + +Commande quotidienne (cron) idempotente. + +- commande Symfony: `php bin/console app:leave:rollover` +- comportement date metier: + - le `01/01`: traite uniquement `FORFAIT_218` + - le `01/06`: traite uniquement `CDI_CDD_NON_FORFAIT` + - les autres jours: sortie sans action +- option manuelle: `--force` pour executer hors date metier (reprise/correction) + +Date d'effet: +- forfait: au `1er janvier` +- non forfait: au `1er juin` + +Traitement par employe: +1. lire l'exercice precedent +2. determiner le report: + - si cloture `paidLeaveSettled=true` sur la periode precedente => report `0` + - sinon report = `closing` exercice precedent +3. creer la ligne du nouvel exercice avec ce report en `opening_*` +4. initialiser `accrued/taken/closing` pour le nouvel exercice + +## 7) Donnees a fournir au go-live + +La RH doit fournir un import d'ouverture: + +Colonnes minimales: +- `employee_identifier` (id interne ou matricule) +- `rule_code` +- `year` +- `opening_days` +- `opening_saturdays` (0 pour forfait) +- `source_date` (date de reference du relevé RH) +- `comment` (optionnel) + +Format recommande: +- CSV UTF-8 +- separateur `;` +- decimales en point (`7.5`) + +Exemple: +```csv +employee_id;rule_code;year;opening_days;opening_saturdays;source_date;comment +42;CDI_CDD_NON_FORFAIT;2026;12.5;2;2026-05-31;Reprise fichier RH +17;FORFAIT_218;2026;8;0;2025-12-31;Reprise fichier RH +``` + +## 8) Checklist mise en prod + +1. Valider le mapping employe RH -> employe applicatif +2. Importer les soldes d'ouverture N-1 +3. Verifier 5 cas metier: + - CDI simple sans changement de contrat + - CDD -> CDI avec `paidLeaveSettled=false` + - CDD -> CDI avec `paidLeaveSettled=true` + - Forfait sur annee complete + - Forfait avec debut en cours d'annee +4. Activer le cron de rollover +5. Geler (`is_locked`) les exercices historicises valides + +Exemple cron (tous les jours a 02:10): +Dev +```cron +10 2 * * * cd /var/www/html && php bin/console app:leave:rollover --no-interaction 2>&1 +``` +Prod +```cron +10 2 * * * cd /var/www/sirh && php bin/console app:leave:rollover --no-interaction 2>&1 +``` +Explication de la ligne cron: +- `10 2 * * *`: planification + - `10` = minute + - `2` = heure + - `*` = tous les jours du mois + - `*` = tous les mois + - `*` = tous les jours de la semaine +- `cd /var/www/html`: se place dans le dossier de l application Symfony +- `php bin/console app:leave:rollover --no-interaction`: execute le rollover sans demander de confirmation + - hors `01/01` et `01/06`, la commande sort en no-op (normal) +- `>> var/log/leave-rollover.log`: ajoute la sortie standard dans le fichier de log (sans ecraser l historique) +- `2>&1`: redirige aussi les erreurs dans le meme fichier de log + +Execution manuelle forcee: +```bash +php bin/console app:leave:rollover --force --no-interaction +``` + +Exemple de verification rapide: +```bash +tail -n 50 /var/www/html/var/log/leave-rollover.log +``` + +## 9) Points de vigilance + +- Ne jamais recalculer les soldes historiques apres validation RH sans procedure explicite +- Garder une trace de toute correction manuelle (auteur, date, motif) +- Aligner strictement les regles UI et API sur les memes compteurs (pas de formule differente front/back) + +## 10) Regle de consommation des droits + +Regle metier: +- un employe peut poser des conges en cours d'acquisition +- la consommation se fait par ordre: + 1. `acquis` (report N-1) + 2. `en cours d'acquisition` (droits N) + +Effet attendu: +- si `acquis = 0` et `en cours = 7.5`, puis prise de `7`, alors: + - `acquis` reste `0` + - `en cours` devient `0.5` +- si `acquis = 0` et `en cours = 2.5`, puis prise de `3`, alors: + - `acquis` reste `0` + - `en cours` devient `-0.5` (dette) + - le mois suivant, une acquisition de `2.5` ramené `en cours` a `2.0` + +Formule de lecture recommandée: +- `restant_acquis = max(0, acquis - pris)` +- `reste_a_imputer_sur_en_cours = max(0, pris - acquis)` +- `restant_en_cours = en_cours - reste_a_imputer_sur_en_cours` (valeur negative autorisee) diff --git a/doc/rtt-rollover.md b/doc/rtt-rollover.md new file mode 100644 index 0000000..3c3792f --- /dev/null +++ b/doc/rtt-rollover.md @@ -0,0 +1,163 @@ +# Rollover RTT - Regles et Mise en Production + +Document de reference pour expliquer le fonctionnement metier du report RTT N-1 et preparer le lancement en production. + +## 1) Objectif + +Permettre le report des heures supplementaires (RTT) d'un exercice a l'autre et fiabiliser les soldes. + +Principe: +- le solde d'ouverture est stocke par exercice +- au changement d'exercice, on ouvre la nouvelle periode avec un "solde d'ouverture" (report N-1) +- au go-live, les soldes d'ouverture sont importes manuellement (CSV ou insertion SQL) + +## 2) Exercice metier + +- exercice RTT: du `1er juin` au `31 mai` +- `year` = annee de fin d'exercice (ex: `2026` = 01/06/2025 -> 31/05/2026) +- employes eligibles: tous sauf `INTERIM` et suivi `PRESENCE` + +## 3) Logique de compteurs + +- `report N-1`: + - correspond au solde d'ouverture (`opening_minutes`) + - source prioritaire: table `employee_rtt_balances` + - fallback: calcul dynamique de la somme des minutes de recuperation de l'exercice precedent +- `acquis N`: + - somme des minutes de recuperation hebdomadaires de l'exercice en cours + - calcul: `HS totales + bonus 25% + bonus 50%` par semaine +- `disponible`: + - `report N-1 + acquis N` +- affichage du compteur global: en **jours** (1 jour = 7h = 420 minutes) + +## 4) Attribution mensuelle des semaines + +- une semaine ISO est affichee une seule fois, dans le mois qui contient le **samedi** de cette semaine +- si le weekend tombe en debut du mois suivant, c'est ce mois qui porte la semaine +- pas de prorata: la totalite des minutes de recuperation de la semaine est comptee dans un seul mois + +## 5) Table cible + +Table `employee_rtt_balances` (une ligne par employe et exercice): +- `employee_id` +- `year` +- `opening_minutes` +- `is_locked` +- `created_at`, `updated_at` + +Contrainte unique: +- `(employee_id, year)` + +Etat implementation: +- la table est creee +- le calcul de synthese RTT lit en priorite `opening_minutes` de cette table quand une ligne existe pour `(employee, year)` +- si aucune ligne n'existe, le calcul dynamique sur l'exercice N-1 est effectue + +### Definition des colonnes + +- `employee_id`: + - identifiant employe (FK vers `employees`) + - une ligne de solde par employe / exercice +- `year`: + - annee d'exercice (annee de fin) + - `2026` = 01/06/2025 -> 31/05/2026 +- `opening_minutes`: + - report N-1 en minutes (solde d'ouverture) + - correspond a la somme des minutes de recuperation de l'exercice precedent +- `is_locked`: + - `false` sur exercice ouvert (recalcul possible) + - `true` apres validation RH (exercice fige) +- `created_at`, `updated_at`: + - trace technique creation / mise a jour + +## 6) Rollover automatique + +Commande quotidienne (cron) idempotente. + +- commande Symfony: `php bin/console app:rtt:rollover` +- comportement date metier: + - le `01/06`: calcule et persiste le report pour chaque employe eligible + - les autres jours: sortie sans action +- option manuelle: `--force` pour executer hors date metier (reprise/correction) + +Date d'effet: +- au `1er juin` (meme date que le rollover conges non forfait) + +Traitement par employe: +1. verifier l'eligibilite (ni INTERIM, ni suivi PRESENCE) +2. verifier qu'aucune ligne n'existe deja pour `(employee, targetYear)` (idempotence) +3. calculer la somme des minutes de recuperation de l'exercice N-1 +4. creer la ligne du nouvel exercice avec ce total en `opening_minutes` + +## 7) Donnees a fournir au go-live + +La RH doit fournir les soldes RTT a reporter. + +Colonnes minimales: +- `employee_id` (id interne) +- `year` +- `opening_minutes` (total en minutes) + +Format recommande: +- CSV UTF-8 +- separateur `;` + +Exemple: +```csv +employee_id;year;opening_minutes +42;2026;1260 +17;2026;840 +``` + +Equivalent en insertion SQL directe: +```sql +INSERT INTO employee_rtt_balances (employee_id, year, opening_minutes, is_locked, created_at, updated_at) +VALUES + (42, 2026, 1260, false, NOW(), NOW()), + (17, 2026, 840, false, NOW(), NOW()); +``` + +Conversion rapide: `1260 minutes = 21h00 = 3.00 jours` (1 jour = 420 min = 7h) + +## 8) Checklist mise en prod + +1. Executer la migration (`employee_rtt_balances`) +2. Importer les soldes d'ouverture N-1 (CSV ou SQL) +3. Verifier 3 cas metier: + - CDI 39h avec heures supp sur l'exercice precedent + - CDI 35h sans heures supp (report = 0) + - INTERIM (doit etre ignore, pas de ligne creee) +4. Activer le cron de rollover +5. Geler (`is_locked`) les exercices historicises valides + +Exemple cron (tous les jours a 02:15, juste apres le rollover conges): +Dev +```cron +15 2 * * * cd /var/www/html && php bin/console app:rtt:rollover --no-interaction 2>&1 +``` +Prod +```cron +10 2 * * * cd /var/www/sirh && php bin/console app:rtt:rollover --no-interaction 2>&1 +``` +Explication de la ligne cron: +- `15 2 * * *`: tous les jours a 02:15 +- `php bin/console app:rtt:rollover --no-interaction`: execute le rollover sans confirmation + - hors `01/06`, la commande sort en no-op (normal) +- `>> var/log/rtt-rollover.log 2>&1`: log sortie standard et erreurs + +Execution manuelle forcee: +```bash +php bin/console app:rtt:rollover --force --no-interaction +``` + +Exemple de verification rapide: +```bash +tail -n 50 /var/www/html/var/log/rtt-rollover.log +``` + +## 9) Points de vigilance + +- Ne jamais modifier `opening_minutes` apres validation RH sans procedure explicite +- Garder une trace de toute correction manuelle (auteur, date, motif) +- Le calcul dynamique N-1 (fallback) parcourt toutes les heures de l'exercice precedent: preferer l'import explicite pour les exercices historiques +- La commande de rollover est idempotente: si une ligne existe deja, l'employe est ignore (pas d'ecrasement) diff --git a/frontend/components/AppTopNav.vue b/frontend/components/AppTopNav.vue new file mode 100644 index 0000000..115d5f3 --- /dev/null +++ b/frontend/components/AppTopNav.vue @@ -0,0 +1,233 @@ + + + diff --git a/frontend/components/CalendarGrid.vue b/frontend/components/CalendarGrid.vue index cef459e..fbd734f 100644 --- a/frontend/components/CalendarGrid.vue +++ b/frontend/components/CalendarGrid.vue @@ -11,12 +11,12 @@ v-for="day in daysInMonth" :key="day.date" class="sticky top-0 z-20 border-b border-neutral-200 px-2 py-3 text-center text-xs font-semibold transition-colors" - :class="isHoveredColumn(day.date) ? 'bg-primary-500 text-white' : 'bg-tertiary-500 text-neutral-700'" + :class="isHoveredColumn(day.date) || day.date === today ? 'bg-primary-500 text-white' : 'bg-tertiary-500 text-neutral-700'" >
{{ day.label }}
{{ day.weekday }}
@@ -91,6 +91,10 @@ diff --git a/frontend/components/SiteFilterSelector.vue b/frontend/components/SiteFilterSelector.vue index 405e40b..4f5922a 100644 --- a/frontend/components/SiteFilterSelector.vue +++ b/frontend/components/SiteFilterSelector.vue @@ -1,25 +1,69 @@ diff --git a/frontend/components/employees/ContractTab.vue b/frontend/components/employees/ContractTab.vue new file mode 100644 index 0000000..041c021 --- /dev/null +++ b/frontend/components/employees/ContractTab.vue @@ -0,0 +1,248 @@ +