70 lines
2.6 KiB
Markdown
70 lines
2.6 KiB
Markdown
# PTA V6 — application PHP MVC multipage
|
||
|
||
PTA n’est 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 d’accueil autorisée pour le profil sélectionné.
|
||
|
||
## Architecture
|
||
|
||
```text
|
||
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 l’interface : 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 l’URL.
|
||
|
||
## Liens directs
|
||
|
||
Une page de contrôle peut ouvrir directement le planning concerné :
|
||
|
||
```text
|
||
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 n’est 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 l’esprit 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 d’accè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`.
|