pour prod
This commit is contained in:
69
README.md
Normal file
69
README.md
Normal file
@@ -0,0 +1,69 @@
|
||||
# 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`.
|
||||
Reference in New Issue
Block a user