Documentation — PPE Checklist

1) À quoi sert l’application ?

L’application PPE Checklist sert à suivre des tâches d’entretien (périodes, groupes, items), cocher ce qui est fait, ajouter un montant en CHF, et conserver des informations (responsable, statut, date, etc.).

Plusieurs PPE possibles (ex: “principal”, “villa-a”, “entretien-2026”).
Sauvegarde automatique : sur le serveur + une copie dans le navigateur (utile si offline).
Titre par PPE : un champ “Titre” enregistré pour chaque PPE.

2) Ouvrir une PPE (choisir un dossier)

En haut, tu as un menu déroulant “PPE” (par ex. principal, villa-a, etc.).

✅ Changer de PPE

Clique sur la liste PPE et choisis une autre PPE. La page se recharge automatiquement sur la PPE sélectionnée.

⚠️ Conseil

Attends une seconde après une grosse modification (édition / montants) pour laisser le temps à la sauvegarde automatique.

Exemples d’URL

index.php?objet=villa&ppe=principal
index.php?objet=villa&ppe=villa-a
index.php?objet=immeuble&ppe=entretien-2026

objet = catégorie (villa, immeuble…) • ppe = nom court (sans espaces).

3) Créer / supprimer une PPE

Créer une PPE

Cliquer sur “Nouvelle PPE”.
Entrer un nom simple, ex: villa-b ou immeuble-2026.
Valider : la PPE est créée et ouverte automatiquement.

Important : utilise uniquement des lettres/chiffres et des tirets (ex: ppe-2026). Évite accents et espaces.

Supprimer une PPE

Ouvre la PPE à supprimer.
Cliquer sur “Suppr. PPE”.
Confirmer.

Attention : la PPE principal ne peut pas être supprimée.

4) Mettre un titre à une PPE (Option A)

En haut, tu as un champ “Titre de la PPE” (ex: “Villa A – PPE 2026”).

Clique dans le champ Titre de la PPE.
Écris ton titre.
Le titre est sauvegardé automatiquement (serveur + navigateur).

Le titre est spécifique à la PPE courante : chaque PPE peut avoir son propre titre.

5) Cocher des items (tâches)

Chaque période (ex: “Annuel”, “Trimestriel”) s’ouvre/ferme en cliquant dessus.
Pour marquer une tâche faite : coche la case.
Pour remettre “à faire” : décoche.

Le bouton “Tout décocher” enlève toutes les coches.

6) Ajouter un montant (CHF) et voir les totaux

À droite de chaque item, tu peux saisir un montant (CHF).

Le total d’un groupe s’affiche dans l’en-tête du groupe.
Le total d’une période s’affiche dans l’en-tête de la période.
Le Total général s’affiche dans la pastille en haut.

7) Détails d’un item (standard, facturation, statut)

Sous chaque item, ouvre “Détails / Standard / Facturation” pour renseigner :

Détail / Standard (comment faire)
Responsable (Interne / Entreprise / Régie)
Durée estimée
Type de montant (Intervention, Produits…)
Facturable (Oui/Non) + Réf. facture
Statut (À faire / Fait / Reporté) + Date d’exécution
Commentaire + Photo/Doc (lien)

Clique sur Enregistrer pour sauvegarder.

8) Recherche rapide

La barre de recherche filtre par période, groupe ou item.
Raccourci clavier : Ctrl + K (Windows) / Cmd + K (Mac) pour focus sur la recherche.

9) L’éditeur (ajouter/supprimer rubriques, groupes, items)

Clique sur “Éditeur” pour afficher/masquer le panneau de droite.

Ajouter une rubrique (période)

Écrire un nom (ex: “Trimestriel”).
Cliquer Ajouter.

Ajouter un groupe

Choisir la rubrique (période).
Donner le titre du groupe.
Cliquer Ajouter.

Ajouter des items

Choisir la rubrique + groupe.
Écrire un item par ligne.
Cliquer Ajouter les items.

Supprimer (rubrique/groupe/item) efface aussi les données associées (coches, montants, détails).

10) Import / Export JSON

L’export/import sert à sauvegarder la structure de la checklist (périodes / groupes / items).

Exporter

Cliquer Exporter JSON.
Un fichier .json est téléchargé.

Importer

Choisir le mode :
- Fusion : ajoute ce qui manque (recommandé).
- Remplacer : écrase tout (attention).
Cliquer Importer JSON et choisir le fichier.

Remplacer remet aussi à zéro les coches, montants et détails (selon configuration).

11) Sauvegarde : comment savoir si c’est sauvegardé ?

Dans la pastille en haut (à côté de “PPE Checklist”), tu vois :

Indication	Signification
⏳ sauvegarde…	Le système est en train d’enregistrer.
✅ serveur	Dernière sauvegarde sur le serveur OK.
⚠️ serveur (échec)	La sauvegarde serveur a échoué (réessaie ou vérifie la connexion).

Même si le serveur est indisponible, une copie reste dans le navigateur (cache local).

12) Problèmes fréquents

“Je ne retrouve plus mes données”

Vérifie que tu es sur la bonne PPE (menu déroulant).
Vérifie l’URL (paramètre ppe=...).
Si tu as changé de navigateur/appareil : les données viennent du serveur, donc elles doivent réapparaître.

“Ça ne sauvegarde pas (⚠️ serveur)”

Vérifie la connexion Internet.
Réessaye après quelques secondes.
Contacte l’administrateur si le problème persiste (permissions dossier /data).

“Je veux repartir propre”

Utilise Réinitialiser dans l’éditeur (remet la checklist par défaut).