docs: mise a jour de la documentation technique et du plan de deploiement en production

Cette révision appartient à :
Théo Gastinel a révisé 2026-10-29 12:47:58 +01:00
1 Parent d4a2b7fa15
révision 57fb12c8f7
3 fichiers modifiés
+259 -60

Aucun fichier ne correspond à votre recherche

+30 -15
Voir le fichier
@@ -37,23 +37,32 @@ jobrunner web/
├── .gitignore # Protection des clés privées, logs et dépendances
├── README.md # Présentation du dépôt
├── DOCUMENTATION.md # Présente documentation technique complète
├── index.html # Espace projet : tableau de bord (point d'entrée ; accès protégé par Caddy basic_auth)
├── index.html # Espace projet : tableau de bord & générateur de codes bêta (admin.jobrunner.fr)
├── app.html # Application Web frontend complète (HTML, CSS inline, JS vanilla)
├── charte.html # Charte graphique v1.1 (couleurs, typo, logo, icônes, animations)
├── legal.html # Documents légaux (CGU, CGV, confidentialité, cookies, mentions) — brouillon, voir docs/conformite-legale.md
├── legal.html # Documents légaux (CGU, CGV, confidentialité, cookies, mentions) — brouillon
├── package.json # Outil de build CSS (devDependency : Tailwind 3.4.19)
├── tailwind.config.js # Palette et ombres du site (source du CSS généré, lit app.html)
├── beta/ # Couche autonome de la bêta testeurs (Python 3 standard)
│ ├── server.py # Serveur HTTP (porte d'entrée, sessions, API admin, injection CSS/JS)
│ ├── codes.py # CLI d'administration des codes d'accès (génération, révocation, liste)
│ ├── db.py # Couche SQLite (codes, sessions, tentatives, audit, démo)
│ ├── bots.py # Simulation d'activité lente et profils fictifs
│ ├── static/ # Pages HTML autonomes (formulaire.html, gate.html)
│ ├── pdf/ # Générateur du formulaire d'engagement testeur PDF (AcroForm)
│ ├── deploiement/ # Architecture et plan de déploiement en production (PLAN.md)
│ └── tests/ # Suite de 25 tests unitaires automatisés
└── assets/
├── css/
│ ├── app.css # CSS Tailwind compilé (généré, à versionner)
│ ├── espace.css # Styles de l'espace projet (index.html)
│ ├── espace.css # Styles de l'espace projet (index.html) dont zone gestion bêta
│ ├── legal.css # Styles de legal.html
│ ├── tailwind.src.css # Entrée du build Tailwind + règle reduced-motion
│ └── fonts.css # @font-face Plus Jakarta Sans et Outfit (auto-hébergées)
├── js/
│ └── legal.js # Navigation de legal.html
├── icones-jobrunner/ # 15 icônes de la charte (SVG, currentColor, sans cadre)
├── img/logo-j.svg # Logo J de la charte v1.1 (l'ancien logo-light.svg reste utilisé par app.html)
├── img/logo-j.svg # Logo J de la charte v1.1
├── fonts/ # Fichiers .woff2 Plus Jakarta Sans et Outfit (latin + latin-ext)
└── icons/
├── phosphor.css # Icônes Phosphor (sous-ensemble utilisé)
@@ -116,6 +125,8 @@ Le fichier `index.html` intègre déjà les modules complets suivants :
| **Processus de Séquestre Mock** | Modale de paiement avec explication des fonds protégés et validation de fin de mission. |
| **Espace Profil & Annonces** | Gestion des annonces personnelles, favoris, historique et statut de certification. |
| **Footer & Mentions Légales** | Modales légales (Mentions légales, CGU, Politique de confidentialité RGPD, Cookies). |
| **Porte d'entrée & Bêta (`jobrunner.fr`)** | Porte d'accès par code unique, formulaire d'inscription autonome (`/__beta/formulaire`), bandeau d'information bêta et bouton de retour d'expérience. |
| **Gestionnaire Bêta (`admin.jobrunner.fr`)** | Générateur instantané de codes testeurs `JRB-...`, validité paramétrable, message d'invitation pré-rempli pour WhatsApp/SMS, historique et statut des codes en temps réel. |
---
@@ -144,19 +155,23 @@ Le fichier `index.html` intègre déjà les modules complets suivants :
---
## 6. Mise en Ligne & Configuration du Domaine `Jobrunner.fr`
## 6. Mise en Ligne & Architecture de Production (Déployé le 29/10/2026)
### Pointage DNS du domaine :
Dans l'interface de gestion de votre nom de domaine `Jobrunner.fr` (chez votre registrar) :
L'infrastructure sépare le site public de test et l'espace projet / administration :
* **Enregistrement `A` :**
* Hôte : `@`
* Valeur : `IP_DE_VOTRE_SERVEUR`
* **Enregistrement `CNAME` :**
* Hôte : `www`
* Valeur : `jobrunner.fr.`
* **Certificat SSL / HTTPS :**
* Activation du certificat HTTPS Let's Encrypt (gratuit) sur votre serveur pour un affichage sécurisé avec le cadenas vert.
### 6.1 Domaines & DNS (Infomaniak)
* `jobrunner.fr`, `www.jobrunner.fr`, `beta.jobrunner.fr` : Enregistrements `A` vers `179.237.102.233` (VPS Suisse).
* `admin.jobrunner.fr` : Enregistrement `A` vers `179.237.102.233` (Espace projet sous authentification HTTP Basic Auth).
### 6.2 Architecture Caddy (VPS `cornafsuisse`)
* **`admin.jobrunner.fr`** : Protégé par HTTP Basic Auth (`/etc/caddy/jobrunner-auth.caddy`). Sert les fichiers statiques de `/srv/jobrunner.fr`. La route `/_admin/api/*` est proxifiée vers `10.88.88.2:8830` via WireGuard (`wg2`) avec l'en-tête interne `X-Admin: 1`.
* **`jobrunner.fr` (et alias `www`, `beta`)** : Proxifié vers `10.88.88.2:8830` via WireGuard (`wg2`).
### 6.3 Serveur Backend (`cornafserver`)
* **Service** : `jobrunner-beta.service` (systemd utilisateur).
* **Port** : `8830`, sécurisé par `nftables` (accessible uniquement depuis le VPS via WireGuard `wg2`).
* **Données** : `/home/cornaf2049/jobrunner-beta-data/beta.sqlite` avec permissions restreintes (`0600`).
* **Sécurité applicative** : HMAC-SHA256 pour les codes d'accès, anti-bruteforce (6 essais / 15 min), plafonds de requêtes concurrentes, timeouts stricts de 20 s.
---
+38 -15
Voir le fichier
@@ -1,19 +1,42 @@
# Bêta testeurs JobRunner
Couche locale, sans dépendance (Python 3 standard), qui sert le site derrière un code d'accès.
Le site d'origine n'est pas modifié : le serveur injecte `beta.js` et `beta.css` dans les pages.
Couche autonome, sans dépendance externe (Python 3 standard), qui sert le site JobRunner derrière un code d'accès sécurisé et offre une interface d'inscription pour les testeurs.
Le site d'origine n'est pas altéré : le serveur injecte `beta.js` et `beta.css` dans les pages servies aux testeurs.
set BETA_DATA=...\data # optionnel (défaut : beta/data, ignoré par git)
python beta/codes.py generer --label "Prénom N." --jours 30
python beta/server.py # http://127.0.0.1:8830/
python beta/bots.py # bots lents (autre terminal)
python -m unittest discover -s beta/tests -p "test_*.py"
python beta/pdf/generer_formulaire.py # régénère le PDF (reportlab, fonttools, brotli)
## Architecture & Déploiement en production (depuis le 29/10/2026)
Sécurité : codes hachés (HMAC + sel local), comparés en temps constant à tous les codes, limite de
tentatives par IP (6 par 15 min), journal, révocation immédiate, CSP `connect-src 'self'` (aucun appel
vers un prestataire de paiement), données de démo dans des tables `demo_*` séparées.
Droits POSIX (dossier 0700, fichiers 0600) vérifiés par `test_droits.py` sous Linux uniquement ;
sous Windows ils n'ont pas d'effet : s'appuyer sur le profil utilisateur.
Ne jamais exposer ce serveur directement : écoute 127.0.0.1, derrière Caddy seulement.
Déploiement : `beta/deploiement/PLAN.md` (non appliqué).
- **Domaine public bêta** : `https://jobrunner.fr` (et `www.jobrunner.fr`, `beta.jobrunner.fr`)
- Redirige automatiquement vers la porte d'entrée `/__beta/gate`.
- Formulaire interactif autonome d'inscription : `https://jobrunner.fr/__beta/formulaire`.
- Proxifié par le Caddy du VPS (`cornafsuisse`) vers le port 8830 de `cornafserver` via WireGuard (`wg2`).
- **Espace projet & Administration** : `https://admin.jobrunner.fr`
- Protégé par HTTP Basic Auth au niveau de Caddy (`/etc/caddy/jobrunner-auth.caddy`).
- Sert les maquettes et l'espace projet (`/srv/jobrunner.fr`).
- Intègre la **Gestion de la Bêta** pour générer en un clic des codes d'accès uniques (`JRB-XXXX-XXXX-XXXX`), copier le message d'invitation pré-rédigé pour WhatsApp/SMS, et suivre l'historique des codes.
- Route API : `/_admin/api/*` proxifiée vers `cornafserver:8830` avec l'en-tête interne `X-Admin: 1`.
## Commandes locales & Développement
```bash
set BETA_DATA=...\data # optionnel (défaut : beta/data, ignoré par git)
python beta/codes.py generer --label "Prénom N." --jours 30
python beta/server.py # http://127.0.0.1:8830/
python beta/bots.py # bots lents (autre terminal)
python -m unittest discover -s beta/tests -p "test_*.py"
python beta/pdf/generer_formulaire.py # régénère le PDF d'engagement (reportlab, fonttools, brotli)
```
## Sécurité & Robustesse
- **Codes d'accès** : Hachage HMAC-SHA256 avec sel local (`salt` de 32 octets sous `0600`), comparaison en temps constant `hmac.compare_digest`.
- **Anti-bruteforce** : Limite stricte de 6 tentatives par IP par tranche de 15 minutes, temporisation adaptative.
- **Déni de service & DoS** :
- Plafond de 64 connexions simultanées, max 2 requêtes `/enter` concurrentes par IP.
- Timeout total de 20 s (ligne de requête + en-têtes + corps).
- Taille de corps bornée par route (ex. 2 ko pour `/enter`, 4 ko pour `/admin/api/codes/creer`).
- Aucun keep-alive (`Connection: close` systématique).
- **Protection des données** :
- Base SQLite dédiée (`beta.sqlite`) avec permissions `0600` (dossier parent en `0700`).
- Tables de démo isolées (`demo_*`) réinitialisables via `bots.py --reset`.
- CSP stricte : `connect-src 'self'`, `frame-ancestors 'none'`, pas d'accès sortant vers des prestataires tiers de paiement.
- Respect RGPD : données testeurs conservées uniquement pour la durée du test, purgeable après clôture.
+191 -30
Voir le fichier
@@ -1,36 +1,197 @@
# Plan de déploiement de la bêta sur jobrunner.fr (préparé, NON appliqué)
# Déploiement de la Bêta JobRunner (Appliqué en production le 29/10/2026)
Rien de ce dossier n'a été exécuté sur un serveur. Tout est à valider avec Nils, puis à appliquer par Théo.
Ce document décrit l'architecture déployée et les procédures d'exploitation pour la bêta testeurs de JobRunner.
## Choix recommandé : sous-domaine `beta.jobrunner.fr`
| | Sous-domaine `beta.` (recommandé) | Chemin `jobrunner.fr/beta` |
|---|---|---|
| Cookies / CSP | isolés du site principal | partagés avec `jobrunner.fr` (basic_auth) |
| Retour arrière | supprimer 1 bloc Caddy + 1 DNS | éditer le bloc principal |
| Risque pour l'existant | nul (bloc séparé) | touche le bloc protégé |
| Coût | 1 enregistrement DNS + certificat auto | aucun |
---
## Étapes (dans l'ordre)
1. DNS : enregistrement `beta` (A, et AAAA si le VPS en a un) vers l'IP du VPS. Où est géré le DNS de jobrunner.fr : à vérifier (non trouvé dans mes notes).
2. cornafserver : copier le dépôt (branche `feat/beta-testeurs-1029`) dans `~/jobrunner-beta`, installer les unités `*.service.exemple` (utilisateur, sans sudo), `loginctl enable-linger` si besoin, démarrer le serveur puis les bots.
3. Générer les codes en local sur le serveur : `python3 beta/codes.py generer --label "Prénom N." --jours 30 --csv`, envoyer chaque code par un canal privé, puis supprimer `codes-emis.csv`.
4. VPS : ajouter le bloc `Caddyfile.beta.exemple` (sudo Théo), `caddy validate`, `systemctl reload caddy`. Sauvegarder d'abord le Caddyfile.
5. Vérifications : `/` redirige vers `/__beta/gate`, un mauvais code est refusé puis limité, un bon code entre, `/beta/db.py` et `/.git/config` donnent 404, aucun appel sortant (CSP `connect-src 'self'`).
6. Pré-requis : page 404 commune (note du 27/10) non appliquée sur jobrunner.fr : à voir avec Nils.
## 1. Architecture en Production
## Exposition : UNIQUEMENT derrière Caddy (obligatoire)
Le serveur Python (`http.server`) n'est pas fait pour Internet. Règles :
- il écoute sur `127.0.0.1` uniquement (`BETA_HOST=127.0.0.1`), jamais sur 0.0.0.0 ni sur une IP publique ;
- seul un Caddy le joint. Le VPS et cornafserver étant deux machines : VPS Caddy (public, TLS) -> WireGuard -> **second Caddy sur cornafserver** (écoute sur l'IP wg1) -> `127.0.0.1:8830`. Les limites ci-dessous se posent dans le Caddy qui est le plus proche du client (VPS) ET dans celui de cornafserver ;
- `BETA_TRUST_PROXY=1` seulement dans cette chaîne (le serveur lit le DERNIER `X-Forwarded-For`, ajouté par Caddy) ;
- limites Caddy explicites (voir `Caddyfile.beta.exemple`) : `timeouts { read_header 10s, read_body 15s, write 20s, idle 15s }`, `request_body max_size 3MB` (le serveur borne en plus : 2 ko /enter, 8 ko /tester, 2,6 Mo /feedback après session), `max_header_size`. Limite de connexions par IP : pas dans Caddy de base ; soit plugin `caddy-ratelimit`, soit règle `nftables ct count` (sudo Théo) : à choisir, non faite ;
- défenses déjà dans le serveur : délai total 20 s (ligne + en-têtes + corps, socket fermée), pas de keep-alive, 64 connexions max, 2 requêtes /enter simultanées par IP, délais d'échec hors de tout verrou.
```
INTERNET
│
▼
┌────────────────────────┐
│ VPS cornafsuisse │
│ IP : 179.237.102.233 │
│ Caddy (TLS Let's Enc) │
└───────────┬────────────┘
│
┌────────────────────────────┴────────────────────────────┐
│ │
admin.jobrunner.fr jobrunner.fr
(HTTP Basic Auth) www. / beta.jobrunner.fr
│ │
┌───────┴───────────────┐ │
│ Fichiers statiques │ │
│ /srv/jobrunner.fr │ │
│ (Espace projet) │ │
└───────┬───────────────┘ │
│ │
│ Route /_admin/api/* │
│ (en-tête X-Admin: 1) │
▼ ▼
Tunnel WireGuard wg2 (chiffré) Tunnel WireGuard wg2 (chiffré)
│ │
└────────────────────────────┬────────────────────────────┘
│
▼
┌────────────────────────┐
│ cornafserver (maison) │
│ IP wg2 : 10.88.88.2 │
│ nftables : port 8830 │
│ Service systemd user │
│ jobrunner-beta │
│ SQLite beta.sqlite │
└────────────────────────┘
```
## Retour arrière
Retirer le bloc Caddy, `systemctl --user stop jobrunner-beta jobrunner-beta-bots`, supprimer l'enregistrement DNS, supprimer `~/jobrunner-beta-data` (retours, testeurs : données personnelles).
---
## Exploitation
- Révoquer : `codes.py revoquer <id>` (coupe les sessions tout de suite). Prolonger : `codes.py prolonger <id> --jours N`.
- Journal : `codes.py journal`. Retours : `codes.py retours`. Testeurs : `codes.py testeurs`.
- Remise à zéro de la démo : `bots.py --reset` (n'efface que les tables `demo_*`).
- Suppression des données personnelles 6 mois après la fin de la bêta (engagement du formulaire).
## 2. Configuration DNS (Infomaniak)
| Enregistrement | Type | Cible | Rôle |
|---|---|---|---|
| `jobrunner.fr` | `A` | `179.237.102.233` | Bêta publique (redirigée vers `/__beta/gate`) |
| `www.jobrunner.fr` | `A` | `179.237.102.233` | Alias web |
| `beta.jobrunner.fr` | `A` | `179.237.102.233` | Sous-domaine dédié bêta |
| `admin.jobrunner.fr`| `A` | `179.237.102.233` | Espace projet & générateur de codes (accès restreint) |
---
## 3. Configuration Caddy (`cornafsuisse`)
Fichier : `/etc/caddy/Caddyfile`
### Espace projet & API Admin :
```caddy
admin.jobrunner.fr {
import /etc/caddy/jobrunner-auth.caddy
import /etc/caddy/securite.caddy
log {
format filter {
wrap json
fields {
request>remote_ip delete
request>client_ip delete
request>headers>X-Forwarded-For delete
request>headers>X-Real-Ip delete
}
}
}
encode zstd gzip
handle /_admin/api/* {
reverse_proxy 10.88.88.2:8830 {
header_up Host admin.jobrunner.fr
header_up X-Admin 1
header_up X-Forwarded-For {remote_host}
header_up X-Forwarded-Proto https
}
}
handle {
root * /srv/jobrunner.fr
file_server
}
}
```
### Bêta publique :
```caddy
jobrunner.fr, www.jobrunner.fr, beta.jobrunner.fr {
import /etc/caddy/securite.caddy
header {
X-Robots-Tag "noindex, nofollow, noarchive"
-Server
}
encode zstd gzip
reverse_proxy 10.88.88.2:8830 {
header_up Host {host}
header_up X-Forwarded-For {remote_host}
header_up X-Forwarded-Proto https
}
}
```
---
## 4. Configuration Serveur (`cornafserver`)
### Pare-feu nftables :
Fichier : `/etc/nftables.d/filtre_hote.nft`
Le port `8830` est autorisé uniquement depuis l'interface WireGuard `wg2` :
```nftables
table inet filtre_hote {
set tcp_wg2 {
type inet_service
flags interval
elements = { 22, 8000, 8095, 8830 }
}
}
```
### Service systemd utilisateur :
Fichier : `~/.config/systemd/user/jobrunner-beta.service`
- Écoute : `0.0.0.0:8830` (joignable par wg2 uniquement)
- Répertoire de travail : `/home/cornaf2049/jobrunner-beta`
- Variables d'environnement : `BETA_DATA=/home/cornaf2049/jobrunner-beta-data`
- Droits SQLite : `0600` sur `beta.sqlite`, `0700` sur `~/jobrunner-beta-data`
---
## 5. Exploitation & Gestion des Codes
### Depuis l'interface web (recommandé) :
Rendez-vous sur `https://admin.jobrunner.fr` :
1. Connectez-vous avec vos identifiants d'administration.
2. Dans la section **Gestion de la Bêta**, saisissez le nom ou la référence du testeur (ex. *Thomas D. (WhatsApp)*).
3. Choisissez la durée de validité (30 jours, 60 jours, 90 jours ou illimitée).
4. Cliquez sur **Créer le code**.
5. Le code `JRB-XXXX-XXXX-XXXX` s'affiche immédiatement avec :
- Un bouton pour copier le code seul.
- Un bouton pour copier le message d'invitation pré-rempli pour WhatsApp ou SMS.
### En ligne de commande sur `cornafserver` :
```bash
# Lister les codes actifs
python3 ~/jobrunner-beta/beta/codes.py liste
# Créer un code en CLI
python3 ~/jobrunner-beta/beta/codes.py generer --label "Testeur X" --jours 30
# Révoquer un code immédiatement
python3 ~/jobrunner-beta/beta/codes.py revoquer <ID>
# Consulter le journal d'activité
python3 ~/jobrunner-beta/beta/codes.py journal
# Consulter les retours testeurs reçus
python3 ~/jobrunner-beta/beta/codes.py retours
```
### Maintenance du service :
```bash
# Vérifier l'état du service
systemctl --user status jobrunner-beta
# Redémarrer après mise à jour
systemctl --user restart jobrunner-beta
# Consulter les logs en direct
journalctl --user -u jobrunner-beta -f -n 50
```
---
## 6. Procédure de Retour Arrière (Rollback)
En cas de besoin de suspension temporaire ou définitive :
1. **Couper le reverse proxy sur `cornafsuisse`** :
Restaurer la sauvegarde Caddy `/root/sauvegardes/caddy/Caddyfile.avant-admin-jobrunner-20261029-105849` et recharger Caddy (`caddy reload`).
2. **Stopper le service sur `cornafserver`** :
```bash
systemctl --user stop jobrunner-beta
```
3. **Fermer le port au pare-feu** :
Retirer le port 8830 de `/etc/nftables.d/filtre_hote.nft` et recharger nftables.