# Mettre le back-office EN LIGNE (o2switch) — comme un WordPress

Objectif : le client (ou vous) gère son site depuis **https://admin.son-domaine.fr** dans un simple
navigateur — connexion e-mail + mot de passe, « mot de passe oublié » par e-mail, publication en un
clic. Le site public reste 100 % statique (rapide, sans base de données) ; seul le back-office est
une application, isolée sur son sous-domaine.

## Ce qu'il faut sur l'hébergement
Un compte o2switch (offre unique) : l'icône **« Setup Python App »** est dans cPanel, section
Logiciels. Doc o2switch : https://faq.o2switch.fr/hebergement-mutualise/tutoriels-cpanel/app-python

## Installation (une fois par site, ~15 minutes)

1. **Sous-domaine** — cPanel › Domaines › Créer : `admin.son-domaine.fr`, avec sa propre racine
   (ex. `/home/COMPTE/admin.son-domaine.fr`). SSL : Run AutoSSL.

2. **Dossier de l'application** — via le Gestionnaire de fichiers ou FTP, créer un dossier HORS
   des racines web, ex. `/home/COMPTE/bo-son-domaine/`, et y déposer tout le dossier du site
   (celui du back-office : `pages/`, `assets/`, `blocks/`, `layout/` s'il existe, `build.py`,
   `admin.py`, `blocks_tools.py`, `translate.py`, `passenger_wsgi.py`, `config.json`,
   `users.json`, `redirects.json`, `translations/`…).

3. **Setup Python App** — cPanel › Setup Python App › Create application :
   - Python version : la plus récente proposée (3.9+)
   - Application root : `bo-son-domaine`
   - Application URL : `admin.son-domaine.fr`
   - Application startup file : `passenger_wsgi.py` (proposé par défaut)
   - Créer, puis dans la fiche de l'application : **Environment variables → ajouter `VFG_ONLINE` = `1`**
   - (Optionnel mais recommandé pour l'optimisation d'images) : champ « pip install » → `pillow` → Run.
   - Restart.

4. **Réglages dans le back-office** — ouvrir https://admin.son-domaine.fr (si `users.json` était
   absent, un compte admin temporaire est créé : identifiants dans le journal du tableau de bord).
   Aller dans Réglages › Publication :
   - Mode de publication : **Copie directe**
   - Dossier public de la production : la « Racine du document » du domaine (cPanel › Domaines),
     ex. `/home/COMPTE/son-domaine.fr`
   - Dossier public de la préprod : idem pour `preprod.son-domaine.fr` si vous en créez une.
   Enregistrer → Régénérer → **Publier en prod** : les fichiers sont copiés directement dans le
   dossier public, sans FTP.

## Ce qui change par rapport au back-office local
- L'aperçu est servi par l'application sur `/apercu/` (bouton « Voir le site (aperçu) »), réservé
  aux utilisateurs connectés.
- « Mot de passe oublié » sur l'écran de connexion : lien envoyé par e-mail (expéditeur = adresse
  d'expédition des formulaires ; créez-la dans cPanel › Comptes de messagerie).
- Publication = copie directe (plus de FTP à configurer).
- Sécurité renforcée : verrouillage 15 min après 5 échecs de connexion, sessions signées avec
  expiration (7 jours), cookies Secure, contrôle d'origine des envois de formulaires.

## Bonnes pratiques
- Le dossier de l'application est la **source du site** : le sauvegarder (cPanel › Sauvegardes,
  ou JetBackup inclus chez o2switch).
- Ne jamais mettre le dossier de l'application dans une racine web.
- Le back-office local (lanceurs .command/.bat) reste utilisable sur le même dossier en le
  téléchargeant — utile en secours ; ne pas éditer en local et en ligne en même temps.
- Un back-office par site : chaque site a son sous-domaine admin.*, son dossier, ses comptes.
