# Documentation PMOptimizer Pro

Index de la documentation utilisateur et technique (v1.5.x). Les fichiers sources sont en **Markdown** (`docs/*.md`) pour l’édition ; dans l’application, ils s’ouvrent en **HTML** (`reports/guides_html/*.html`) avec **liens cliquables** entre guides.

> **Pourquoi du HTML dans l’app ?** Le navigateur ne suit pas correctement les liens `fichier.md` depuis une page HTML. À l’ouverture d’un guide (menu **Système → Aide**, bouton **Aide**), tous les `.md` sont convertis en `.html` dans le même dossier pour que les liens fonctionnent.

## Informations légales et support

| Document | Sujet |
|----------|--------|
| [RESPONSABILITE_ET_SUPPORT.md](RESPONSABILITE_ET_SUPPORT.md) | Logiciel **gratuit**, responsabilité, **plantage** → logs à l’auteur ; rappel aussi au **premier lancement** (boîte de dialogue) |

---

## Démarrage

| Document | Public |
|----------|--------|
| [UI_TROIS_FENETRES.md](UI_TROIS_FENETRES.md) | Architecture : écran de choix, mode Débutant, mode Expert |
| [AIDE_DEBUTANT.md](AIDE_DEBUTANT.md) | Aide complète mode Débutant (menu **Système → Aide**, bouton bleu en-tête) |
| [AIDE_EXPERT.md](AIDE_EXPERT.md) | Aide complète mode Expert |
| [AIDE_EXPERT_TECHNIQUE.md](AIDE_EXPERT_TECHNIQUE.md) | Guide technique (CLI, baselines, modules) |

## Nettoyage et maintenance

| Document | Sujet |
|----------|--------|
| [GLARY_ONE_CLICK.md](GLARY_ONE_CLICK.md) | Mode 1 clic — séquence guidée (débutant) |
| [NETTOYAGE_TEMP_SECURISE.md](NETTOYAGE_TEMP_SECURISE.md) | Fichiers temporaires Windows et logiciels (sans risque Installer) |
| [NETTOYAGE_NAVIGATEURS.md](NETTOYAGE_NAVIGATEURS.md) | Caches navigateurs — **mots de passe conservés** |
| [DOUBLONS_FICHIERS.md](DOUBLONS_FICHIERS.md) | Recherche légère de fichiers en double |

## Qualité, anti-bug et concurrence

| Document | Sujet |
|----------|--------|
| [ANALYSE_CONCURRENTIELLE.md](ANALYSE_CONCURRENTIELLE.md) | **Analyse complète** : anti-bug (91 tests, grille robustesse, risques P1–P3), **concurrence** (18 rubriques ★, note **4,4/5**), méthodologie Glary/CCleaner (estimation marché 2026, pas labo) |

Points techniques récents (v1.5) : sauvegarde auto **`uwopt_state.json.bak`**, plus de **`rglob`** actif dans le code applicatif.

---

## Expert / technicien

| Document | Sujet |
|----------|--------|
| [PLANIFICATEUR_WINDOWS.md](PLANIFICATEUR_WINDOWS.md) | Tâche planifiée, CLI, rapports, e-mail SMTP |
| [PACK_SESSION_GAMING.md](PACK_SESSION_GAMING.md) | Profils gaming et pack session |
| [SIGNATURE_CODE.md](SIGNATURE_CODE.md) | Build Nuitka et signature Authenticode |

## Accès dans l’application

| Action | Où |
|--------|-----|
| Aide mode actuel | Bouton bleu **Aide — Débutant** / **Aide — Expert** (en-tête à droite) |
| Aide + guide technique | Menu **Système → Aide** — ouverture en **document HTML** (style Word) |
| Ouvrir le guide | **Aide → Ouvrir le guide (document HTML)** ou **Consulter le guide (HTML)** |
| Analyse diagnostic | **Score & historique** → bouton **Rapport HTML** |
| Analyse système | **Analyser le système** → **Rapport HTML** après l’analyse |
| Mode 1 clic | Onglet **Outils Glary** ou **Système → Outils Glary** |

## Fichiers générés par l’app

| Chemin | Rôle |
|--------|------|
| `uwopt_state.json` | État, baselines, planificateur, thème, dernier mode |
| `uwopt_state.json.bak` | Copie automatique avant chaque enregistrement (repli si fichier principal corrompu) |
| `uwopt_log.txt` | Journal des opérations |
| `crash_diagnostics/crash_diag_LAST.txt` | Rapport du dernier plantage — à envoyer à l’auteur en cas de crash (voir [RESPONSABILITE_ET_SUPPORT.md](RESPONSABILITE_ET_SUPPORT.md)) |
| `reports/` | Rapports de lot **HTML** (mise en page document), TXT, PDF optionnel |
| `reports/guides_html/` | **Guides HTML** générés depuis `docs/*.md` — à ouvrir via l’app (liens `.html` entre pages) |

## Prérequis

- Windows 10 ou 11
- Lancement **en administrateur**
- PowerShell disponible

---

*Entrée application : `PMOptimizerProV1a.py` → `pmoptimizer.app.bootstrap.main()`*
