[REFACTOR] Simplification de l'arborescence

52 fichiers suivis hors skins -> 39, et deux dossiers en moins.

Doublons supprimes :
- requirements.txt : les dependances etaient listees deux fois, en plus de
  pyproject.toml. Elles n'ont plus qu'une source, et l'installation se fait
  par pip install -e . (install.bat, CI et release mis a jour)
- config/*.json n'est plus suivi : l'application recree ces fichiers au
  premier lancement, et les suivre faisait apparaitre les reglages
  personnels de chaque utilisateur comme des modifications a commiter

Redondances supprimees :
- packaging/ : la recette PyInstaller rejoint scripts/ et pointe
  directement sur launcher.pyw, son script d'entree intermediaire disparait
- run_server.pyw : redondant avec server.py et --console
- scripts/start_gui.bat : n'existait que parce qu'une erreur de demarrage
  etait invisible, ce que le journal et la boite d'erreur ont corrige
- application.py : ServerRuntime.create() et run_console() reprennent son
  contenu
- tests/__init__.py : remplace par une fixture

Regroupements :
- le paquet server/ devient un module unique music_overlay/server.py
- docs/ passe de 5 a 3 fichiers : DEMARRAGE, GUIDE et TROUBLESHOOTING

Verifie : 76 tests, ruff, GUI, diagnostic et compilation de l'executable.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

Author: mm-elmazani

.github/workflows/ci.yml

@@ -30,8 +30,7 @@ jobs:
       - name: Installer les dependances
         run: |
           python -m pip install --upgrade pip
-          pip install -r requirements.txt
-          pip install pytest ruff
+          pip install -e ".[dev]"
 
       - name: Ruff (lint)
         run: ruff check .

.github/workflows/release.yml

@@ -38,25 +38,24 @@ jobs:
       - name: Installer les dependances
         run: |
           python -m pip install --upgrade pip
-          pip install -r requirements.txt
-          pip install pytest ruff pyinstaller
+          pip install -e ".[dev,build]"
 
       - name: Tests avant publication
         run: |
           ruff check .
           pytest
 
       - name: Compiler l'executable
-        run: pyinstaller --noconfirm --clean packaging/MusicOverlayServer.spec
+        run: pyinstaller --noconfirm --clean scripts/MusicOverlayServer.spec
 
       - name: Archiver l'executable
         run: Compress-Archive -Path dist/MusicOverlayServer/* -DestinationPath MusicOverlayServer-${{ env.VERSION }}.zip
 
       - name: Archiver les sources utilisables
         run: |
-          $inclus = @('music_overlay', 'skins', 'docs', 'scripts', 'packaging',
-                      'launcher.pyw', 'run_server.pyw', 'server.py', 'DEMARRER.bat',
-                      'requirements.txt', 'pyproject.toml', 'README.md', 'CHANGELOG.md', 'LICENSE')
+          $inclus = @('music_overlay', 'skins', 'docs', 'scripts',
+                      'launcher.pyw', 'server.py', 'DEMARRER.bat',
+                      'pyproject.toml', 'README.md', 'CHANGELOG.md', 'LICENSE')
           Compress-Archive -Path $inclus -DestinationPath MusicOverlayServer-sources-${{ env.VERSION }}.zip
 
       - name: Publier la release

.gitignore

@@ -40,7 +40,7 @@ MANIFEST
 # PyInstaller (la recette de build du projet reste versionnee)
 *.manifest
 *.spec
-!packaging/*.spec
+!scripts/*.spec
 
 # Unit test / coverage
 htmlcov/
@@ -131,10 +131,8 @@ tmp/
 *.bak
 *.backup
 
-# Configuration locale (surcharges utilisateur)
-config/local_settings.json
-config/settings.local.json
-config/*.local.json
+# Configuration utilisateur : recreee automatiquement au premier lancement
+/config/
 
 # Artefact Windows : un « > nul » mal echappe cree un fichier nomme nul
 nul

CHANGELOG.md

@@ -4,6 +4,29 @@ Toutes les modifications notables du projet seront documentées dans ce fichier.
 
 ## [Non publié]
 
+### 🧹 Simplification de l'arborescence
+
+52 fichiers suivis (hors skins) → 39, et deux dossiers en moins.
+
+- ❌ **`requirements.txt`** : les dépendances étaient listées deux fois.
+  `pyproject.toml` est désormais l'unique source ; l'installation se fait par
+  `pip install -e .`
+- ❌ **`config/*.json` ne sont plus suivis** : l'application les recrée au
+  premier lancement. Vos réglages personnels n'apparaissent plus comme des
+  modifications à commiter
+- ❌ **`packaging/`** : la recette PyInstaller rejoint `scripts/` et son script
+  d'entrée intermédiaire disparaît (elle pointe directement sur `launcher.pyw`)
+- ❌ **`run_server.pyw`** : redondant avec `server.py` et
+  `python -m music_overlay --console`
+- ❌ **`scripts/start_gui.bat`** : n'existait que parce qu'une erreur de
+  démarrage était invisible — le journal et la boîte d'erreur le remplacent
+- ❌ **`application.py`** : `ServerRuntime.create()` et `run_console()` en
+  reprennent le contenu
+- 📦 **Paquet `server/` aplati** en un module unique `music_overlay/server.py`
+- 📚 **`docs/` passe de 5 à 3 fichiers** : `DEMARRAGE.md` (installation et
+  premier lancement), `GUIDE.md` (interface, filtres, configuration, API) et
+  `TROUBLESHOOTING.md`
+
 ### ✨ Nouveautés
 
 - 🖼️ **Aperçus complets** : `clipping_mask`, `kinetic_typography` et

CONTRIBUTING.md

@@ -22,8 +22,7 @@ en joignant :
 git clone https://github.com/dexteee-r/Windows-Music-overlay-server.git
 cd Windows-Music-overlay-server
 python -m venv .venv
-.venv\Scripts\python.exe -m pip install -r requirements.txt
-.venv\Scripts\python.exe -m pip install pytest ruff
+.venv\Scripts\python.exe -m pip install -e ".[dev]"
 ```
 
 | Commande | Rôle |
@@ -51,9 +50,7 @@ music_overlay/
 ├── media.py          Session média Windows (WinRT)
 ├── diagnostics.py    Auto-diagnostic
 ├── startup.py        Démarrage automatique Windows
-├── server/
-│   ├── app.py        Application Flask et routes
-│   └── runtime.py    Démarrage, arrêt, gestion du port
+├── server.py         Routes Flask, démarrage, arrêt et choix du port
 └── gui/
     ├── window.py     Fenêtre principale
     ├── dialogs.py    Fenêtres secondaires

README.md

@@ -22,8 +22,8 @@ avec 10 skins prêts à l'emploi et une interface de configuration.
 
 Dans OBS : *Sources* → **+** → **Navigateur** → collez l'URL → largeur **650**, hauteur **180**.
 
-> Besoin de détails ? [Installation pas à pas](docs/INSTALL.md) ·
-> [Guide d'utilisation](docs/USAGE.md) · [Dépannage](docs/TROUBLESHOOTING.md)
+> Besoin de détails ? [Installation pas à pas](docs/DEMARRAGE.md) ·
+> [Guide d'utilisation](docs/GUIDE.md) · [Dépannage](docs/TROUBLESHOOTING.md)
 
 ---
 
@@ -64,7 +64,7 @@ Pour créer le vôtre : [CONTRIBUTING.md](CONTRIBUTING.md).
 ## ⚙️ Configuration
 
 Tout se règle dans l'onglet **Paramètres** ; les fichiers JSON de `config/` restent
-modifiables à la main pour les habitués ([détail des options](docs/CONFIGURATION.md)).
+modifiables à la main pour les habitués ([détail des options](docs/GUIDE.md)).
 
 **Filtrer les applications** — trois modes :
 
@@ -79,7 +79,7 @@ cochez vos lecteurs, enregistrez. Le filtre s'applique immédiatement.
 
 Si un lecteur échappe à la détection, les listes restent modifiables à la main :
 le bouton **« Ouvrir la page source_app »** affiche l'identifiant exact à
-recopier ([procédure détaillée](docs/USAGE.md#choisir-ce-qui-saffiche)).
+recopier ([procédure détaillée](docs/GUIDE.md#choisir-ce-qui-saffiche)).
 
 ---
 
@@ -124,13 +124,12 @@ Windows-Music-overlay-server/
 │   ├── skins.py            #   découverte et sélection des skins
 │   ├── media.py            #   lecture de la session média Windows
 │   ├── diagnostics.py      #   auto-diagnostic
-│   ├── server/             #   application Flask et cycle de vie
+│   ├── server.py           #   routes Flask et cycle de vie
 │   └── gui/                #   interface tkinter
 ├── skins/                  # 10 skins (un dossier chacun)
 ├── config/                 # Configuration utilisateur (JSON)
 ├── tests/                  # Tests automatisés
-├── scripts/                # install.bat, start.bat, diagnostic.bat, build_exe.bat
-├── packaging/              # Recette PyInstaller
+├── scripts/                # install.bat, diagnostic.bat, build_exe.bat, recette PyInstaller
 └── docs/                   # Documentation détaillée
 ```
 
@@ -140,8 +139,7 @@ Windows-Music-overlay-server/
 
 ```bash
 python -m venv .venv
-.venv\Scripts\python.exe -m pip install -r requirements.txt
-.venv\Scripts\python.exe -m pip install pytest ruff
+.venv\Scripts\python.exe -m pip install -e ".[dev]"
 ```
 
 | Commande | Rôle |