4201894e28
Reprise dans le répertoire de production du travail mené dans le worktree ux-service-enfance : - tableau de bord Service Enfance (dashboard.php) et navigation regroupée ; - guide d'utilisation (faq.php) accessible depuis toute la navigation ; - éditeur de semaine type mis en avant sur l'écran de saisie ; - droit à l'enveloppe de formation par agent, en remplacement de la case « formation déjà prévue dans la répartition annuelle » ; - correctif de « [object Object] » sur les cartes de quota du PTA ; - motif de travail par défaut à la saisie, heures travaillées complètes dans les PDF. Le docker-compose.yml de production est conservé : celui du worktree décrit une pile de test (conteneurs et volume suffixés « test », ports 9080/9081), qui aurait fait redémarrer l'application sur un volume MariaDB vide. Les migrations database/migration_v7_9*.sql sont obligatoires ; le service db-migrate les applique au déploiement. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
77 lines
3.0 KiB
Markdown
77 lines
3.0 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.8 — Sécurité et droits en base
|
||
|
||
Les correctifs de sécurité et le déplacement de la matrice des droits dans des
|
||
vues SQL sont décrits dans `README_V7_8.md`. La migration
|
||
`database/migration_v7_8_securite_acces.sql` est obligatoire ; elle est appliquée
|
||
automatiquement au déploiement par le service `db-migrate` du docker-compose.
|
||
|
||
## 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`.
|