first upload

README.md

@@ -0,0 +1,78 @@
+# comi-cleanmgr - sources de paquet WAPT
+
+Paquet de configuration de **N profils cleanmgr Windows**, destine a etre personnalise
+avec **Lancer update-package** depuis la console WAPT. Pas de suppression de fichiers lors
+de l'installation : seuls les parametres des profils sont deposes dans le registre.
+
+## Update-package : approche native WAPT
+
+Le code est adapte des conventions utilisees dans le paquet public officiel
+[`tis-waptagent-logo-template` 1.1-15](https://wapt.tranquil.it/store/en/details/tis-waptagent-logo-template_1.1-15_windows_5.1_PROD.wapt) :
+
+- `waptguihelper.message_dialog(...)` : introduction et validation.
+- `waptguihelper.input_dialog(...)` : nombre de profils, categories additionnelles.
+- `waptguihelper.grid_dialog(..., waptguihelper.GRT_ALL, MetaData)` : tableau editable des IDs/noms et grilles de categories (booleens).
+- `control.inc_build()` puis `control.save_control_to_wapt()` : incrementation native du build WAPT lors d'un changement.
+- Garde pour `params['install_with_luti']` ou `params['running_as_luti']` : pas d'interface sur les builds automatiques LUTI.
+
+Les helpers `ask_control_package` et `ask_control_version` de l'exemple de Tranquil IT
+sont **definis dans le fichier de l'exemple** ; ce ne sont pas des API standard.
+Ici, comme le nom du paquet ne change pas et que seule sa configuration change,
+`control.inc_build()` est suffisant.
+
+## Utilisation
+
+1. Extraire l'archive comme sources WAPT, puis ouvrir le paquet dans la **console WAPT sur Windows**.
+2. Depuis le depot prive, cliquer **Lancer update-package**.
+3. Saisir N (1 a 50), puis renseigner **dans une seule grille** les IDs `0..9999`
+   et les noms des N profils.
+4. Pour chacun, cocher les categories dans la grille interactive. Les `VolumeCaches`
+   personnalises sont disponibles dans un champ facultatif.
+5. Confirmer le recapitulatif : cela reecrit `profiles.json`, incremente le numero
+   de build de `WAPT/control` et enregistre le controle.
+6. Construire, **signer** et publier le paquet selon le flux de travail habituel,
+   puis l'installer sur les postes.
+7. Exemples d'execution (locale, admin ou action distante autorisee) :
+
+   ```cmd
+   cleanmgr.exe /sagerun:4101
+   cleanmgr.exe /sagerun:4102
+   ```
+
+`update_package()` s'execute **sur le poste de l'administrateur**, pas sur les endpoints.
+Les postes ne voient jamais de fenetres de configuration : `setup.py` lit seulement
+`profiles.json` a l'installation.
+
+## Fonctionnement agent
+
+- Configuration en `HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\Explorer\VolumeCaches`.
+- `StateFlagsNNNN` REG_DWORD a `2` (categorie activee) ou `0` (categorie desactivee).
+- Trace des IDs et de la configuration dans `HKLM\SOFTWARE\Comitari\CleanmgrProfiles`.
+- `audit()` verifie les flags : `OK`, `WARNING` si categorie selectionnee absente de ce Windows,
+  `ERROR` si registre non conforme.
+- `uninstall()` efface les valeurs de profil gerees sans toucher aux autres IDs.
+- Les profils supprimes lors d'une evolution du paquet voient leurs flags nettoyes.
+
+## Precautions
+
+- Ne **jamais** reutiliser un ID attribue a un autre administrateur : le paquet prend
+  le controle des `StateFlagsNNNN` de l'ID utilise.
+- Certaines categories n'existent pas sous toutes les versions de Windows.
+- `Previous Installations` et `Update Cleanup` peuvent limiter le retour en arriere ;
+  `Recycle Bin` supprime le contenu de la corbeille.
+- Le comportement sous SYSTEM peut differer de celui dans une session utilisateur.
+- L'action integree **Lancer CleanMgr** de WAPT Enterprise n'est pas prouvee comme
+  prenant en charge les profils `4101/4102` personnalises.
+- Aucune tache planifiee ou nettoyage n'est lance automatiquement par ce paquet.
+- L'interface graphique n'a pas ete testee sur une console WAPT Windows reelle.
+  La logique a ete testee via des doubles Python des helpers, de la console et du registre.
+
+## Contenu
+
+- `WAPT/control` : metadonnees WAPT (minimum WAPT 2.4).
+- `update_package.py` : assistant interactif de configuration, utilisant les helpers WAPT.
+- `profiles.json` : donnees des profils embarquees.
+- `setup.py` : application des profils sur les machines Windows, `audit`, `uninstall`.
+
+Sources uniquement ; archive non signee, non compilable directement en `.wapt`
+sans la console et la chaine de signature WAPT.