# 🤖 Guide Agent IA – Web Sentinel (MAJ 2025‑10)

## 1. Vue d’ensemble

- **Produit** : scanner de sécurité web on-premise avec licence embarquée RSA‑4096.
- **Plateformes** : GUI Tkinter + CLI, localisation FR/EN complète.
- **Admin Panel** : utilitaire `docs/legacy/sysop_panel_prototype/admin_panel.py` pour générer/importer des licences signées et orchestrer les comptes de test.
- **État global** : fonctionnalités cœur en production, tests unitaires 100% verts (`python3 run_tests.py`).

## 2. Structure du dépôt

```
web-sentinel/
├── web_sentinel/                # Code applicatif
│   ├── auth/                    # Authentification locale/cloud (SQLite)
│   ├── license/                 # Loader licence, crypto, backends
│   ├── gui/                     # Interface Tkinter, modal licence
│   ├── cli.py                   # Interface CLI bilingue
│   ├── checks/                  # Diagnostics TLS, headers, injection, etc.
│   ├── subscription/            # Feature flags & managers
│   └── reporting.py             # Export JSON/HTML localisé
├── docs/legacy/sysop_panel_prototype/   # Panel admin & scripts de test (legacy)
├── tests/                       # Tests unitaires & scénarios licence
├── docs/                        # Documentation (architecture, technique, business, projet)
└── docs/project/STATUS.md       # Synthèse état actuel
```

## 3. Règles critiques (ne pas refaire)

| Domaine | Statut | Notes |
|---------|--------|-------|
| Licence embarquée | ✅ Terminé | RSA-4096 + AES-GCM, validation externe via backend SQLite pour FREE/PRO/ENTERPRISE. |
| Authentification | ✅ Terminé | Mode hybride, stockage `~/.web-sentinel/auth.db`. |
| Localisation | ✅ Terminé | GUI + CLI + rapports HTML bilingues. |
| Tests | ✅ Terminé | 57+ tests – ne pas casser la suite `python3 run_tests.py`. |

## 4. Extensions autorisées / priorités

1. **Optimisations performance** : caching localisation, lazy-load translations, threading multi-domaine.
2. **Phase commerciale** : contenus marketing FR/EN, tarification multi-tiers, préparation API licence distante.
3. **Monitoring** : instrumentation usage/licence pour tiers premium (backlog).

Consulter `docs/project/PLAN_ACTION.md` pour la feuille de route détaillée.

## 5. Utilisation rapide

```bash
# GUI
python -m web_sentinel.gui

# CLI (scan + rapport HTML)
python -m web_sentinel.cli example.com --html-report rapport.html

# Panel admin (génération/import licence, stats, DB)
python docs/legacy/sysop_panel_prototype/admin_panel.py
```

## 6. Localisation & licence

- Toutes les chaînes utilisateur passent par `web_sentinel/gui/localization.py`.
- Modal licence + bouton « Gérer licence » dans la GUI (alertes 30/14/7/3/1 jours).
- CLI refuse `--allow-invasive` / `--html-report` si la licence l’interdit (messages FR/EN).
- Offline tiers (GOVERNMENT/FINANCE/MEDICAL ou flag `air_gap`) fonctionnent 100% localement.

## 7. Documentation utile

- `docs/project/STATUS.md` — résumé de l’état du projet.
- `docs/project/PLAN_ACTION.md` — jalons en cours / backlog.
- `docs/architecture/ARCHITECTURE_LICENCE_EMBARQUEE.md` — détails cryptographie & anti-contournement.
- `docs/project/reports/*.md` — audits & rapports historiques.
- `docs/project/prompts/*.md` — prompts de reprise.

## 8. Bonnes pratiques

- Régénérer les licences via le panel ou `docs/legacy/sysop_panel_prototype/create_test_license.py` pour conserver la signature RSA.
- Après modification licence/DB, relancer la GUI/CLI pour recharger l’état.
- Ne jamais supprimer `license.lic` en production ; préférer l’import d’une licence valide.
- Maintenir la localisation FR/EN pour toute nouvelle fonctionnalité utilisateur.

Bon travail ! Les prochaines missions se concentrent principalement sur la performance, l’industrialisation et la mise sur le marché. Consultez régulièrement `STATUS.md` pour suivre l’avancement.
