Files
pta/README.md
Loic Masi 5fbf76868f pour prod
2026-08-07 16:13:43 +02:00

2.6 KiB
Raw Permalink Blame History

PTA V6 — application PHP MVC multipage

PTA nest plus une SPA. Chaque fonction principale correspond à une page PHP distincte :

  • planning.php : saisie, brouillon, validation et semaines types ;
  • pending.php : plannings en attente de validation ;
  • coverage.php : contrôle des créneaux sans agent ;
  • structures.php : planning hebdomadaire par lieu ;
  • agents.php : planning mensuel et bilan par agent ;
  • vacations.php : aperçu et enregistrement des vacances scolaires ;
  • administration.php : lieux, agents et règles de couverture.

index.php redirige vers le choix de rôle lors de la première visite, puis vers la page daccueil autorisée pour le profil sélectionné.

Architecture

page PHP
  → PageController
    → Models / Services
      → View dédiée

View
  → API JSON uniquement pour les actions asynchrones utiles

Les contrôleurs métier, modèles, services PDF et endpoints API de la V5.20 sont conservés. La différence principale porte sur linterface : plus de routeur JavaScript, plus de vues cachées et plus de chargement de tous les modules sur une seule page.

JavaScript chargé par page

  • Saisie : planning-editor.js et week-templates.js ;
  • À valider : pending-validation.js ;
  • Couverture : coverage.js ;
  • Par lieu : structure-overview.js ;
  • Par agent : agent-overview.js ;
  • Vacances : vacation-calendar.js ;
  • Administration : administration.js et la partie configuration de coverage.js.

assets/js/page-bootstrap.js initialise uniquement les modules déclarés par la page et applique les filtres transmis dans lURL.

Liens directs

Une page de contrôle peut ouvrir directement le planning concerné :

planning.php?structure_id=2&agent_id=7&week=2026-W31&focus=validation

Installation

  1. Configurer config.php.
  2. Utiliser le schéma SQL correspondant à la V5.20.
  3. Placer le dossier sur le serveur PHP.
  4. Ouvrir index.php ou planning.php.

Aucune migration SQL supplémentaire nest nécessaire pour passer de la V5.20 à la V6.

Version 7

Voir README_V7.md pour le nouveau socle PTA annuel, les équipes des mercredis/vacances et les contrôles métier associés.

V7.2 — Vue annuelle

La page annual.php reproduit lesprit du tableau annuel historique : douze mois côte à côte, codes AP/PP/AE/PE, couleurs métier, vacances scolaires et accès direct à la semaine à corriger. Voir README_V7_2.md.

V7.4 — Rôles et droits daccès

La première arrivée ouvre role.php. Les droits Agent, Responsable de structure et Service Enfance sont vérifiés dans les pages et les contrôleurs API. Voir README_V7_4.md.