# 🛠️ Scripts Utilitaires - Web Sentinel

Ce dossier contient les scripts de maintenance et d'administration du projet.

## Scripts Disponibles

### 🧹 `clean_project.py` / `clean_project.ps1`
**Nettoyage automatique du projet**

Supprime :
- Caches Python (`__pycache__/`, `.pytest_cache/`, `.ruff_cache/`)
- Fichiers compilés (`.pyc`, `.pyo`, `.pyd`)
- Builds temporaires (`build/`, `dist/`, `*.egg-info/`)
- Bases de données de test (`*.db`)
- Fichiers de test obsolètes (`test_*.py` hors `tests/`)
- Résultats de scan (`*-results.json/html`, `*-raport.*`)

**Usage Windows :**
```powershell
# Mode simulation
.\scripts\clean_project.ps1 -DryRun

# Nettoyage réel
.\scripts\clean_project.ps1

# Mode verbose
.\scripts\clean_project.ps1 -Verbose
```

**Usage Linux/Mac :**
```bash
python scripts/clean_project.py
```

## Ajouter un Nouveau Script

1. Créer le fichier dans `scripts/`
2. Ajouter un shebang approprié :
   - Python : `#!/usr/bin/env python3`
   - Bash : `#!/bin/bash`
   - PowerShell : `#Requires -Version 5.1`

3. Documenter le script :
```python
"""
Nom du script
Description courte

Usage:
    python script.py [options]

Options:
    --help      Afficher l'aide
    --dry-run   Mode simulation
"""
```

4. Ajouter une section dans ce README

## Structure

```
scripts/
├── README.md               ← Ce fichier
├── build/                  ← Scripts de build & maintenance avancés
├── check_stripe_prices.py  ← Vérification des prix Stripe
├── clean_project.py        ← Nettoyage (Python)
├── clean_project.ps1       ← Nettoyage (PowerShell)
├── deployment/             ← Scripts migration (archives)
├── requirements_new.txt    ← Dépendances générées
├── start_payment_server.py ← Serveur de test Stripe
└── test_stripe_integration.py ← Tests Stripe
```

## Bonnes Pratiques

### ✅ À Faire
- Utiliser des chemins absolus ou relatifs au projet
- Ajouter des messages de progression clairs
- Gérer les erreurs avec try/catch
- Tester en mode dry-run d'abord
- Documenter les paramètres

### ❌ À Éviter
- Supprimer des fichiers sans confirmation
- Modifier des fichiers en production
- Ignorer les dossiers protégés (`.git/`, `.venv/`)
- Hardcoder des chemins spécifiques
- Oublier les logs d'erreur

## Scripts Planifiés (À Venir)

- [ ] `backup_database.py` - Sauvegarde automatique de la BDD
- [ ] `update_dependencies.py` - Mise à jour des dépendances
- [ ] `check_security.py` - Audit de sécurité
- [ ] `generate_docs.py` - Génération de documentation
- [ ] `deploy_production.sh` - Script de déploiement complet

## Support

Pour toute question ou suggestion de nouveau script :
- Ouvrir une issue sur GitHub
- Contact : contact@taaazzz-prog.fr

---
📅 Dernière mise à jour : 24 octobre 2025