# 📁 Structure du Projet Web Sentinel

> Organisation claire et maintenable du projet

## 🎯 Racine du projet

```
web-sentinel/
├── 📄 Fichiers de configuration
│   ├── .env, .env.example, .env.local, .env.production
│   ├── .gitignore
│   ├── pytest.ini
│   ├── setup.py
│   ├── requirements.txt, requirements-api.txt, requirements-dev.txt
│   ├── web-sentinel.spec, web-sentinel-gui.spec
│   └── LICENSE
│
├── 📝 Documentation
│   ├── README.md                    # Documentation principale
│   └── STRUCTURE.md                 # Ce fichier
│
├── 🐍 Code principal
│   └── web_sentinel_api_honest.py   # API Flask principale
│
├── 📦 Modules Python
│   └── web_sentinel/                # Package principal
│       ├── __main__.py              # Point d'entrée
│       ├── logging_config.py        # Configuration logs
│       ├── auth/                    # Authentification
│       ├── checks/                  # Modules de scan
│       ├── gui/                     # Interface graphique
│       └── ...
│
├── 🌐 Frontend Web
│   └── web/                         # Application web
│       ├── index.html
│       ├── account.html
│       ├── css/
│       ├── js/
│       └── assets/
│
├── 🔧 Scripts utilitaires
│   └── scripts/
│       ├── deployment/              # Scripts de déploiement
│       ├── database/                # Scripts de gestion DB
│       └── maintenance/             # Scripts de maintenance
│
├── 📚 Documentation complète
│   └── docs/
│       ├── architecture/            # Documents d'architecture
│       ├── guides/                  # Guides techniques
│       ├── reports/                 # Rapports de corrections
│       ├── business/                # Business & stratégie
│       ├── maintenance/             # Maintenance & structure
│       └── stripe/                  # Documentation Stripe
│
├── 🐳 Déploiement
│   ├── deployment/                  # Configurations déploiement
│   │   ├── docker/
│   │   ├── nginx/
│   │   └── traefik/
│   └── docker/                      # Fichiers Docker
│
├── 🧪 Tests
│   └── tests/                       # Suite de tests
│
├── 🔌 Intégrations
│   └── integrations/                # Intégrations externes
│
├── 🛠️ Outils
│   ├── tools/                       # Outils développement
│   ├── examples/                    # Exemples d'utilisation
│   └── install/                     # Scripts d'installation
│
├── 👑 Administration
│   └── admin/                       # Panel d'administration
│       ├── backend/
│       └── frontend/
│
└── 📦 Build & Distribution
    ├── build/                       # Fichiers de build
    ├── dist/                        # Distributions
    └── archives/                    # Archives anciennes versions
```

## 🚀 Accès rapide

| Besoin | Chemin |
|--------|--------|
| **Déployer l'API** | `scripts/deployment/deploy_api_only.ps1` |
| **Documentation complète** | `docs/README.md` |
| **Architecture système** | `docs/architecture/ARCHITECTURE_FINALE.md` |
| **Guide déploiement** | `docs/guides/DEPLOIEMENT_OVH.md` |
| **Créer comptes test** | `scripts/database/create_test_accounts.py` |
| **Code principal API** | `web_sentinel_api_honest.py` |
| **Frontend web** | `web/` |
| **Modules de scan** | `web_sentinel/checks/` |
| **Interface graphique** | `web_sentinel/gui/` |
| **Tests** | `tests/` |

## 📝 Conventions

### Fichiers à la racine
- **Configuration uniquement** : `.env`, `setup.py`, `requirements.txt`, etc.
- **Documentation principale** : `README.md`, `LICENSE`
- **Point d'entrée API** : `web_sentinel_api_honest.py`

### Scripts
- Tous dans `scripts/` organisés par fonction
- Chaque dossier a son propre `README.md`

### Documentation
- Toute la doc dans `docs/`
- Organisée par catégorie (architecture, guides, reports)
- Index principal : `docs/README.md`

### Code source
- Package principal : `web_sentinel/`
- API Flask : `web_sentinel_api_honest.py` (racine pour compatibilité Docker)
- Frontend : `web/`

## 🔄 Historique

- **06/11/2025** : Restructuration complète
  - 30+ fichiers MD déplacés de racine → `docs/`
  - Scripts organisés dans `scripts/`
  - Racine nettoyée : 15 fichiers essentiels uniquement
  - README créés dans chaque dossier important

## 📖 En savoir plus

Consultez `docs/README.md` pour l'index complet de la documentation.