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.
---