Documentation /docu (aperçu) et bouton dans le pied de page

- docu/ : accueil et 5 sujets (architecture, rôles, réseau, sauvegardes en brouillon noindex, météo), feuille docu.css (Inter, thème clair).
- index.html : bloc « Vous êtes développeur… Lisez ma documentation » vers /docu/, juste au-dessus du bouton Statistiques.
- Non intégré à tools/build.js : docu/ est à copier à part lors du déploiement.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Cette révision appartient à :
Théo GastineletClaude Opus 5.5 a révisé 2026-11-06 01:57:53 +01:00
1 Parent 5779a8d882
révision bd6c291567
8 fichiers modifiés
+442

Aucun fichier ne correspond à votre recherche

+75
Voir le fichier
@@ -0,0 +1,75 @@
<!doctype html>
<html lang="fr">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<meta name="color-scheme" content="light">
<title>Les choix d'architecture du code · Documentation · Théo Gastinel</title>
<meta name="description" content="Comment mes projets sont découpés, quels langages j'utilise et pourquoi.">
<link rel="stylesheet" href="docu.css">
</head>
<body>
<header class="entete"><div class="barre">
<a class="marque" href="/">Théo Gastinel</a>
<nav><a href="./">Documentation</a><a href="architecture.html" aria-current="page">Architecture</a><a href="roles.html">Rôles</a><a href="reseau.html">Réseau</a><a href="meteo.html">Météo</a></nav>
</div></header>
<main>
<p class="surtitre">Documentation · Sujet 1</p>
<h1>Les choix d'architecture du code</h1>
<p class="chapeau">Je ne cherche pas la technologie à la mode. Pour chaque projet, je prends l'outil le plus simple qui fait le travail, que je peux relire et expliquer moi-même dans six mois.</p>
<h2>L'idée de départ : tout chez moi</h2>
<p>Mes services tournent sur mon propre matériel. Un serveur à la maison fait le gros du travail : les comptes, l'intelligence artificielle, le serveur Minecraft, la collecte météo, le stockage. Un petit VPS en Suisse sert de porte d'entrée publique : il reçoit les visiteurs en HTTPS et transmet les demandes à la maison par des tunnels chiffrés.</p>
<div class="schema">Internet
│
Petit VPS en Suisse HTTPS, site public, mises à jour des logiciels
│ tunnels chiffrés (WireGuard)
Serveur maison comptes, IA, Minecraft, météo, stockage
│
Deuxième machine copies de secours</div>
<p>Pourquoi ce découpage ? Le serveur maison n'est jamais exposé directement sur Internet, et le VPS ne garde presque rien d'important. Si le VPS tombe, je le remonte vite. Et je ne dépends pas d'un grand fournisseur de cloud pour garder les données des personnes qui utilisent mes services.</p>
<h2>Un service, une boîte</h2>
<p>Sur le serveur, chaque service vit dans sa propre pile Docker Compose, isolée des autres : les comptes et leur base, le panneau d'administration, la forge Git, le stockage, Minecraft… Toute cette configuration est rangée dans un seul dépôt d'infrastructure, versionné avec Git. Quand je change quelque chose, je sais où c'est écrit et je peux revenir en arrière.</p>
<p>Les services qui ont besoin du processeur graphique, comme l'IA, tournent directement sur la machine, sans conteneur, pour garder les meilleures performances.</p>
<h2>Le bon langage pour chaque projet</h2>
<table>
<thead><tr><th>Projet</th><th>Technologie</th><th>Pourquoi</th></tr></thead>
<tbody>
<tr><td>Hub des comptes</td><td>Go, PostgreSQL</td><td>Un seul programme compilé, rapide, typé. Pour les comptes et les droits, je veux que le compilateur m'arrête avant une erreur.</td></tr>
<tr><td>Panneau d'administration</td><td>Interface React, relais en Go</td><td>L'interface est riche (tableaux, rôles, sanctions) ; le relais en Go fait le lien avec le serveur et garde les contrôles côté serveur.</td></tr>
<tr><td>Gastinel Weather Studio</td><td>Rust, Tauri v2, SQLite</td><td>Une application de bureau légère pour Windows (et Android), qui lit directement le thermomètre enregistreur par USB et garde les données sur l'ordinateur de l'utilisateur.</td></tr>
<tr><td>Gastinel Write</td><td>C++20, Win32</td><td>Un moteur maison sans aucune dépendance externe. C'est aussi un projet pour apprendre comment fonctionne vraiment une application.</td></tr>
<tr><td>Petits services (collecte météo, forum, suivi des tâches)</td><td>Python, bibliothèque standard</td><td>Aucune dépendance à installer ni à mettre à jour. Le code reste court et facile à relire.</td></tr>
<tr><td>Gastinel Mind</td><td>Python, llama.cpp</td><td>Un modèle de langage ouvert qui tourne sur ma propre carte graphique, avec quelques outils : recherche web par un moteur auto-hébergé, calcul, documents locaux.</td></tr>
<tr><td>Mods Minecraft</td><td>Java, NeoForge</td><td>C'est l'environnement imposé par le jeu.</td></tr>
<tr><td>Ce site</td><td>Un fichier HTML, Node et esbuild pour la construction</td><td>Une seule page, le CSS et le JavaScript dedans. La construction minifie et prépare des versions compressées, pour que la page arrive vite même avec une petite connexion.</td></tr>
</tbody>
</table>
<h2>Un compte pour tout</h2>
<p>Le <a href="https://hub.gastinel.me/">Hub</a> est le point central : il gère les comptes, les offres et les rôles. Les autres services ne gardent pas de mot de passe. Ils utilisent « Se connecter avec Gastinel », un échange standard OAuth (code d'autorisation avec PKCE). Le forum de Météo Vercors est le premier service à l'utiliser.</p>
<h2>Les données restent au service</h2>
<p>Une règle que je ne négocie pas : les données des utilisateurs ne servent qu'au service lui-même. Pas de publicité, pas de revente, pas d'entraînement d'IA. Côté technique, ça se traduit par des choix concrets : pas de traceur tiers, des statistiques de visite comptées sur mon propre serveur, et Mind ne conserve pas le contenu des conversations.</p>
<h2>Ma façon de travailler</h2>
<ul>
<li><strong>Une branche par chantier.</strong> Rien ne part en production directement depuis la branche principale. Mon code est hébergé sur ma propre forge Git.</li>
<li><strong>Des tests sur des copies jetables.</strong> Une base de données de test qu'on peut casser, jamais la vraie.</li>
<li><strong>Une sauvegarde avant chaque modification</strong>, et toujours un moyen de revenir en arrière.</li>
<li><strong>Un déploiement avec garde-fou.</strong> Pour ce site, l'outil de déploiement compare les empreintes des fichiers en ligne avec la dernière version envoyée : si quelque chose a changé entre-temps, il s'arrête.</li>
<li><strong>Les nouvelles options sont désactivées par défaut.</strong> Rien ne change sans qu'on l'ait choisi.</li>
<li><strong>Des mises à jour signées.</strong> Les mises à jour de Weather Studio sont signées (Ed25519) et vérifiées avant d'être installées.</li>
</ul>
<p>Je travaille aussi avec des assistants d'IA pour écrire et relire du code. Je garde les décisions, la relecture et la mise en ligne.</p>
<div class="suite"><a href="./">← Sommaire</a><a href="roles.html">La hiérarchie des rôles →</a></div>
<p class="maj">Mise à jour : novembre 2026.</p>
</main>
<footer class="global-footer">
<div class="footer-content"><span>Théo Gastinel · Lans-en-Vercors</span><span><a href="/">Portfolio</a> · <a href="./">Documentation</a></span></div>
<div class="footer-bottom">© 2026 Théo Gastinel</div>
</footer>
</body>
</html>
+48
Voir le fichier
@@ -0,0 +1,48 @@
/* Documentation gastinel.me/docu : même charte que le portfolio (Inter, monochrome, thème clair). */
@font-face { font-family:'Inter'; font-style:normal; font-weight:400 700; font-display:swap; src:url('../assets/fonts/inter-latin.woff2') format('woff2'); unicode-range:U+0000-00FF,U+0131,U+0152-0153,U+02BB-02BC,U+02C6,U+02DA,U+02DC,U+2000-206F,U+2074,U+20AC,U+2122,U+2191,U+2193,U+2212,U+2215,U+FEFF,U+FFFD; }
@font-face { font-family:'Inter'; font-style:normal; font-weight:400 700; font-display:swap; src:url('../assets/fonts/inter-latin-ext.woff2') format('woff2'); unicode-range:U+0100-02AF,U+0304,U+0308,U+0329,U+1E00-1E9F,U+1EF2-1EFF,U+2020,U+20A0-20AB,U+20AD-20C0,U+2113,U+2C60-2C7F,U+A720-A7FF; }
:root { color-scheme:light; --font-sans:'Inter',system-ui,-apple-system,'Segoe UI',Roboto,Arial,sans-serif; --texte:#111; --gris:#555; --pale:#888; --trait:#e4e4e4; --fond2:#f7f7f7; }
* { box-sizing:border-box; }
html { background:#fff; }
body { margin:0; background:#fff; color:var(--texte); font-family:var(--font-sans); font-size:17px; line-height:1.7; -webkit-font-smoothing:antialiased; }
a { color:var(--texte); text-underline-offset:3px; }
a:hover { color:#000; }
.entete { border-bottom:1px solid var(--trait); }
.entete .barre { max-width:1000px; margin:0 auto; padding:18px 20px; display:flex; justify-content:space-between; align-items:center; gap:16px; flex-wrap:wrap; }
.entete .marque { font-weight:700; letter-spacing:.2px; text-decoration:none; }
.entete nav a { color:var(--gris); text-decoration:none; font-size:.9rem; margin-left:18px; font-weight:500; }
.entete nav a:hover, .entete nav a[aria-current="page"] { color:var(--texte); }
main { max-width:760px; margin:0 auto; padding:56px 20px 90px; }
.surtitre { text-transform:uppercase; letter-spacing:1.5px; font-size:.75rem; font-weight:600; color:var(--pale); margin:0 0 10px; }
h1 { font-size:2.3rem; line-height:1.2; letter-spacing:-.02em; margin:0 0 18px; }
h2 { font-size:1.35rem; letter-spacing:-.01em; margin:48px 0 12px; padding-top:8px; }
h3 { font-size:1.05rem; margin:28px 0 8px; }
p, li { color:#222; }
.chapeau { font-size:1.12rem; color:var(--gris); margin-bottom:36px; }
ul { padding-left:22px; }
li { margin-bottom:6px; }
code { font-family:ui-monospace,Consolas,monospace; font-size:.88em; background:var(--fond2); border:1px solid var(--trait); border-radius:4px; padding:1px 5px; }
table { width:100%; border-collapse:collapse; margin:16px 0 8px; font-size:.95rem; }
th, td { text-align:left; padding:10px 12px; border-bottom:1px solid var(--trait); vertical-align:top; }
th { font-weight:600; font-size:.8rem; text-transform:uppercase; letter-spacing:.8px; color:var(--gris); }
.encadre { border:1px solid var(--trait); border-left:4px solid #111; background:var(--fond2); padding:14px 18px; margin:24px 0; border-radius:4px; }
.encadre p { margin:0; }
.brouillon { border:2px dashed #111; padding:12px 18px; margin:0 0 32px; font-weight:600; border-radius:4px; }
.schema { font-family:ui-monospace,Consolas,monospace; font-size:.85rem; line-height:1.5; background:var(--fond2); border:1px solid var(--trait); border-radius:4px; padding:16px 18px; overflow-x:auto; white-space:pre; }
.sujets { list-style:none; padding:0; margin:28px 0 0; border-top:1px solid var(--trait); }
.sujets li { margin:0; border-bottom:1px solid var(--trait); }
.sujets a { display:block; padding:20px 4px; text-decoration:none; }
.sujets a:hover { background:#fafafa; }
.sujets strong { display:block; font-size:1.08rem; }
.sujets span { color:var(--gris); font-size:.95rem; }
.sujets .etiquette { display:inline-block; margin-left:8px; font-size:.7rem; text-transform:uppercase; letter-spacing:1px; font-weight:600; border:1px solid #111; border-radius:4px; padding:1px 7px; color:#111; vertical-align:middle; }
.suite { display:flex; justify-content:space-between; gap:16px; margin-top:64px; padding-top:24px; border-top:1px solid var(--trait); font-size:.95rem; }
.suite a { text-decoration:none; font-weight:600; }
.maj { color:var(--pale); font-size:.85rem; margin-top:40px; }
/* Pied de page : repris du portfolio */
.global-footer { background:#242424; color:#d1d1d1; padding:40px 20px 30px; border-top:4px solid #111; font-size:.9rem; line-height:1.8; }
.global-footer .footer-content { max-width:1000px; margin:0 auto; display:flex; justify-content:space-between; gap:24px; flex-wrap:wrap; }
.global-footer a { color:#a8b2bd; text-decoration:none; font-weight:600; }
.global-footer a:hover { color:#fff; text-decoration:underline; }
.global-footer .footer-bottom { text-align:center; border-top:1px solid #333; margin-top:28px; padding-top:20px; font-size:.8rem; color:#888; }
@media (max-width:640px){ h1{ font-size:1.8rem; } main{ padding-top:36px; } .entete nav a{ margin-left:0; margin-right:14px; } }
+38
Voir le fichier
@@ -0,0 +1,38 @@
<!doctype html>
<html lang="fr">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<meta name="color-scheme" content="light">
<title>Documentation · Théo Gastinel</title>
<meta name="description" content="Comment je construis mes projets : architecture du code, rôles et comptes, réseau, collecte météo.">
<link rel="stylesheet" href="docu.css">
</head>
<body>
<header class="entete"><div class="barre">
<a class="marque" href="/">Théo Gastinel</a>
<nav><a href="./" aria-current="page">Documentation</a><a href="architecture.html">Architecture</a><a href="roles.html">Rôles</a><a href="reseau.html">Réseau</a><a href="meteo.html">Météo</a></nav>
</div></header>
<main>
<p class="surtitre">Documentation</p>
<h1>Comment je construis mes projets</h1>
<p class="chapeau">Ces pages sont pour les développeurs, et pour toutes les personnes curieuses de savoir ce qu'il y a derrière mes sites et mes applications. J'y explique mes choix, ce qui marche, et ce qui est encore en chantier.</p>
<p>Presque tout ce que je fais tourne sur mon propre matériel : un serveur à la maison, et un petit VPS en Suisse qui sert de porte d'entrée sur Internet. J'ai fait ce choix pour garder la main sur les données des personnes qui utilisent mes services, et parce que c'est la meilleure façon d'apprendre.</p>
<ul class="sujets">
<li><a href="architecture.html"><strong>Les choix d'architecture du code</strong><span>Comment mes projets sont découpés, quels langages j'utilise et pourquoi.</span></a></li>
<li><a href="roles.html"><strong>La hiérarchie des rôles et les passages de grade</strong><span>Offres, niveau du compte, rôles généraux et rôles de projet. Ce qui change quand on monte en grade, qu'on est sanctionné ou banni.</span></a></li>
<li><a href="reseau.html"><strong>Les sites LAN et le réseau</strong><span>Ce qui est public, ce qui reste à la maison, et comment les deux se parlent.</span></a></li>
<li><a href="sauvegardes.html"><strong>Les sauvegardes et la sécurité</strong><span class="etiquette">Brouillon</span><span>Pas encore publié.</span></a></li>
<li><a href="meteo.html"><strong>La collecte météo</strong><span>Comment Météo Vercors récupère, range et publie les mesures des stations du massif.</span></a></li>
</ul>
<p class="maj">Mise à jour : novembre 2026.</p>
</main>
<footer class="global-footer">
<div class="footer-content"><span>Théo Gastinel · Lans-en-Vercors</span><span><a href="/">Portfolio</a> · <a href="./">Documentation</a></span></div>
<div class="footer-bottom">© 2026 Théo Gastinel</div>
</footer>
</body>
</html>
+64
Voir le fichier
@@ -0,0 +1,64 @@
<!doctype html>
<html lang="fr">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<meta name="color-scheme" content="light">
<title>La collecte météo · Documentation · Théo Gastinel</title>
<meta name="description" content="Comment Météo Vercors récupère, range et publie les mesures des stations du massif du Vercors.">
<link rel="stylesheet" href="docu.css">
</head>
<body>
<header class="entete"><div class="barre">
<a class="marque" href="/">Théo Gastinel</a>
<nav><a href="./">Documentation</a><a href="architecture.html">Architecture</a><a href="roles.html">Rôles</a><a href="reseau.html">Réseau</a><a href="meteo.html" aria-current="page">Météo</a></nav>
</div></header>
<main>
<p class="surtitre">Documentation · Sujet 5</p>
<h1>La collecte météo</h1>
<p class="chapeau">J'habite dans le Vercors, un massif connu pour ses « trous à froid » : des creux où l'air froid s'accumule la nuit. Météo Vercors rassemble les mesures des stations du massif sur une seule carte, en direct et en archives.</p>
<h2>D'où viennent les mesures</h2>
<table>
<thead><tr><th>Source</th><th>Ce que c'est</th></tr></thead>
<tbody>
<tr><td>Ma station</td><td>Une Davis Vantage Pro 2 installée chez moi, reliée au serveur de la maison.</td></tr>
<tr><td>Météo-France</td><td>Les postes officiels du massif, par l'API publique, et leur historique.</td></tr>
<tr><td>ROMMA</td><td>Le réseau associatif des stations de montagne, avec son accord.</td></tr>
<tr><td>Infoclimat</td><td>Des stations d'amateurs, en respectant les règles techniques d'Infoclimat.</td></tr>
<tr><td>WeatherLink</td><td>Des stations Davis du massif, partagées par leurs propriétaires.</td></tr>
</tbody>
</table>
<p>Une station n'apparaît que si j'ai l'autorisation de l'afficher. J'en ai retiré plusieurs pour cette raison.</p>
<h2>Le trajet d'une mesure</h2>
<div class="schema">station → collecteur (toutes les quelques minutes)
→ base locale (une ligne par source, station et instant)
→ archive (courbes sur plusieurs jours, historique)
→ fichiers JSON publics → carte de vercors.me</div>
<p>Les collecteurs sont de petits programmes Python, sans dépendance, lancés par des minuteurs. Ils écrivent dans une base SQLite, puis publient des fichiers JSON statiques. Le site public n'interroge jamais les sources lui-même : il lit seulement ces fichiers.</p>
<h2>Les règles de la collecte</h2>
<ul>
<li><strong>Les sources ne sont jamais mélangées.</strong> Chaque mesure garde son origine. Si une station a un enregistreur principal et un de secours, leurs données restent séparées.</li>
<li><strong>Respecter les fournisseurs.</strong> Chaque source a un plafond de requêtes par jour, les demandes sont groupées par lots avec une pause entre deux, et une alerte prévient avant d'atteindre la limite.</li>
<li><strong>Une panne ne bloque pas tout.</strong> Si une source répond mal, elle est mise en pause un moment ; les autres sources et la publication continuent.</li>
<li><strong>Écrire proprement.</strong> Les fichiers publics sont remplacés d'un coup, pour qu'un visiteur ne tombe jamais sur un fichier à moitié écrit. Un verrou empêche deux collectes de tourner en même temps.</li>
<li><strong>Ne publier que le nécessaire.</strong> Seuls les champs utiles sortent, filtrés par une liste blanche.</li>
</ul>
<h2>L'historique</h2>
<p>En plus du direct, j'ai importé l'historique des postes Météo-France du Parc du Vercors, depuis 1950 pour les plus anciens. Il sert à la page Climat : comparer aujourd'hui avec les normales, repérer les records.</p>
<h2>Le site</h2>
<p>La carte de <a href="https://vercors.me/">vercors.me</a> est faite d'images pré-calculées du relief, pour rester fluide sur un téléphone. Les polices sont servies par le site lui-même, sans service externe. Le forum utilise la connexion « Se connecter avec Gastinel » du Hub des comptes, et les statistiques de visite sont tenues sans adresse IP.</p>
<p>La même passion a donné Gastinel Weather Studio, une application pour analyser les relevés de mes thermomètres posés dans les trous à froid.</p>
<div class="suite"><a href="sauvegardes.html">← Les sauvegardes et la sécurité</a><a href="./">Sommaire →</a></div>
<p class="maj">Mise à jour : novembre 2026.</p>
</main>
<footer class="global-footer">
<div class="footer-content"><span>Théo Gastinel · Lans-en-Vercors</span><span><a href="/">Portfolio</a> · <a href="./">Documentation</a></span></div>
<div class="footer-bottom">© 2026 Théo Gastinel</div>
</footer>
</body>
</html>
+62
Voir le fichier
@@ -0,0 +1,62 @@
<!doctype html>
<html lang="fr">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<meta name="color-scheme" content="light">
<title>Les sites LAN et le réseau · Documentation · Théo Gastinel</title>
<meta name="description" content="Ce qui est public, ce qui reste sur le réseau de la maison, et comment les deux se parlent.">
<link rel="stylesheet" href="docu.css">
</head>
<body>
<header class="entete"><div class="barre">
<a class="marque" href="/">Théo Gastinel</a>
<nav><a href="./">Documentation</a><a href="architecture.html">Architecture</a><a href="roles.html">Rôles</a><a href="reseau.html" aria-current="page">Réseau</a><a href="meteo.html">Météo</a></nav>
</div></header>
<main>
<p class="surtitre">Documentation · Sujet 3</p>
<h1>Les sites LAN et le réseau</h1>
<p class="chapeau">Tout n'a pas besoin d'être sur Internet. Une bonne partie de mes outils ne sont visibles que depuis le réseau de la maison, et c'est voulu.</p>
<h2>Trois zones</h2>
<table>
<thead><tr><th>Zone</th><th>Ce qu'on y trouve</th></tr></thead>
<tbody>
<tr><td>Public</td><td>Ce site, Gastinel Mind, le Hub des comptes, Météo Vercors et son forum, les mises à jour de mes logiciels.</td></tr>
<tr><td>Réseau de la maison (LAN)</td><td>Mes outils de travail : suivi des tâches et notifications, annuaire des pages, météo en direct, imprimante et scanner, tri de photos, pages d'aperçu avant publication.</td></tr>
<tr><td>Réseau invité</td><td>Les visiteurs et les autres appareils. Il est séparé du reste et ne voit pas les outils de la maison.</td></tr>
</tbody>
</table>
<h2>Comment le public arrive jusqu'à la maison</h2>
<p>Le serveur de la maison n'est pas ouvert directement sur Internet. Les visiteurs arrivent sur un petit VPS en Suisse. Celui-ci s'occupe du HTTPS (certificats Let's Encrypt, renouvelés automatiquement) et transmet seulement les services prévus vers la maison, par des tunnels WireGuard. Chaque tunnel a un rôle précis, et ils ne sont jamais mélangés.</p>
<p>Côté maison, un pare-feu ferme tout par défaut et n'ouvre que ce qui est nécessaire, tunnel par tunnel. Mes outils de travail ne sont pas joignables depuis le VPS.</p>
<h2>Les sites LAN</h2>
<p>Sur le réseau de la maison, j'ai une petite collection de pages et d'outils. Pour s'y retrouver :</p>
<ul>
<li><strong>Un annuaire</strong> : une page d'accueil qui liste toutes les pages LAN sous forme de tuiles.</li>
<li><strong>Des adresses courtes</strong> : chaque page a un numéro court, facile à retenir. Un numéro qui ne correspond à rien renvoie une page d'erreur claire, au lieu de laisser deviner ce qui tourne derrière.</li>
<li><strong>Des noms en <code>.lan</code></strong> pour certains outils, avec un HTTPS interne.</li>
<li><strong>Une page d'aperçus</strong> : avant de publier un site ou une page, je la dépose là pour la regarder sur mon téléphone et la faire relire. Cette documentation y est passée aussi.</li>
</ul>
<p>Les pages LAN restent légères : souvent un petit serveur Python ou un serveur de fichiers en lecture seule, avec une mémoire limitée.</p>
<h2>Et depuis l'extérieur ?</h2>
<p>Quand je ne suis pas à la maison (la semaine, je suis à l'internat), j'accède au réseau de la maison par un VPN WireGuard qui passe par le VPS. Sans ce VPN, les outils LAN restent invisibles. Le suivi de mes tâches, par exemple, ne sera jamais ouvert sur Internet.</p>
<h2>Le matériel</h2>
<ul>
<li>Un serveur maison sous Debian, avec une carte graphique dédiée à l'IA et un onduleur pour tenir les coupures de courant.</li>
<li>Une deuxième machine plus ancienne, qui garde des copies de secours.</li>
<li>Un petit VPS en Suisse pour la partie publique.</li>
</ul>
<div class="suite"><a href="roles.html">← La hiérarchie des rôles</a><a href="sauvegardes.html">Les sauvegardes et la sécurité →</a></div>
<p class="maj">Mise à jour : novembre 2026.</p>
</main>
<footer class="global-footer">
<div class="footer-content"><span>Théo Gastinel · Lans-en-Vercors</span><span><a href="/">Portfolio</a> · <a href="./">Documentation</a></span></div>
<div class="footer-bottom">© 2026 Théo Gastinel</div>
</footer>
</body>
</html>
+90
Voir le fichier
@@ -0,0 +1,90 @@
<!doctype html>
<html lang="fr">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<meta name="color-scheme" content="light">
<title>La hiérarchie des rôles et les passages de grade · Documentation · Théo Gastinel</title>
<meta name="description" content="Offres, niveau du compte, rôles généraux et rôles de projet, sanctions et bannissement sur les comptes Gastinel.">
<link rel="stylesheet" href="docu.css">
</head>
<body>
<header class="entete"><div class="barre">
<a class="marque" href="/">Théo Gastinel</a>
<nav><a href="./">Documentation</a><a href="architecture.html">Architecture</a><a href="roles.html" aria-current="page">Rôles</a><a href="reseau.html">Réseau</a><a href="meteo.html">Météo</a></nav>
</div></header>
<main>
<p class="surtitre">Documentation · Sujet 2</p>
<h1>La hiérarchie des rôles et les passages de grade</h1>
<p class="chapeau">Un compte Gastinel n'a pas un seul « grade ». Il a plusieurs branches indépendantes, qui se cumulent. Cette page décrit l'organisation que je mets en place : elle est en cours de refonte dans le code.</p>
<div class="encadre"><p>Exemple réel de cumul, sur un même compte : une offre payante, admin général du projet Minecraft, modérateur de la météo, admin général, et en même temps « suspect ». Chaque branche se lit séparément.</p></div>
<h2>1. L'offre</h2>
<ul>
<li><strong>Gratuit</strong> : c'est une offre à part entière, pas un compte au rabais.</li>
<li><strong>Payant</strong>, par paliers (par exemple « Synapse »).</li>
<li><strong>Interne</strong> : réservé aux personnes très proches de moi. Il donne par exemple plus de stockage ou l'accès à certains sites de la maison. Ce n'est pas un rôle d'administration, et faire partie du staff ne le donne pas.</li>
</ul>
<h2>2. Le niveau du compte</h2>
<p>C'est l'état général du compte : normal, suspect, banni, et vers le haut aspirant puis modérateur. Un membre du staff garde sa place : être « suspect » ne lui retire pas son rôle, mais un admin ne peut pas descendre plus bas que suspect sans perdre ses rôles (voir plus bas).</p>
<h2>3. Les rôles généraux</h2>
<p>Ils gèrent l'ensemble : les comptes, le staff, les bannissements généraux. Ils <strong>n'agissent pas à l'intérieur des services</strong> (le serveur Minecraft, le forum…) : c'est le travail des rôles de projet.</p>
<table>
<thead><tr><th>Rôle général</th><th>En bref</th></tr></thead>
<tbody>
<tr><td>Admin vérificateur</td><td>Premier rôle d'administration, il vérifie et signale.</td></tr>
<tr><td>Admin confiance</td><td>Un admin qui a fait ses preuves.</td></tr>
<tr><td>Admin général</td><td>Gère l'ensemble et les bans généraux.</td></tr>
<tr><td>Super admin général conjoint</td><td>Direction, à côté du titulaire.</td></tr>
<tr><td>Super admin général</td><td>Le sommet de l'échelle.</td></tr>
</tbody>
</table>
<h2>4. Les rôles de projet</h2>
<p>Chaque projet a sa propre branche, avec la même échelle. Le nom du projet suit le rôle : « admin confiance projet Minecraft », par exemple.</p>
<div class="schema">aspirant
→ admin vérificateur projet X
→ admin confiance projet X
→ admin projet X
→ super admin projet conjoint X
→ super admin projet X</div>
<ul>
<li>Un rôle de projet n'agit que dans son projet.</li>
<li>Être admin général ne fait pas de quelqu'un un admin de chaque service.</li>
<li>Il n'y a pas d'administrateur général de Weather Studio : c'est un logiciel, pas une communauté.</li>
<li><strong>Jobrunner</strong> fait exception : ce projet appartient à Nils, qui en est le super admin ; j'en suis le conjoint.</li>
</ul>
<h3>Le cas de la météo</h3>
<p>Météo Vercors est un projet à part, avec les rôles de son forum : adhérent, propriétaire de station, propriétaire, modérateur. Le panneau de gestion du forum n'est accessible qu'à partir de modérateur.</p>
<h2>Monter en grade</h2>
<p>On monte une marche à la fois, en commençant comme aspirant. Une promotion est toujours une décision humaine, prise par quelqu'un qui a le droit de gérer le staff, et elle est notée dans le journal du staff. Monter dans un projet ne change rien dans les autres projets ni dans les rôles généraux.</p>
<h2>Les sanctions</h2>
<p>Les sanctions vont par paliers, et la plupart visent un seul service :</p>
<ul>
<li><strong>Suspect</strong> : d'abord une note interne, invisible pour la personne, puis des stades visibles si ça continue.</li>
<li><strong>Avertissement officiel</strong>, envoyé avec un motif.</li>
<li><strong>Ban</strong> : défini (avec une date de fin, puis levé automatiquement), indéfini, ou définitif.</li>
</ul>
<p>Un ban sur un service n'empêche pas d'ouvrir son compte, par exemple pour lire ses sanctions. Seul un ban général bloque la connexion. Les outils automatiques (détection de triche, par exemple) peuvent signaler, mais un ban définitif est toujours une décision humaine. Lever un ban définitif demande deux motifs écrits : un pour le dossier interne, un pour la personne.</p>
<h2>Et quand un membre du staff est sanctionné ?</h2>
<ul>
<li><strong>Ban général</strong> : il perd tous ses rôles, même modérateur.</li>
<li><strong>Premier stade de ban sur un seul service</strong>, pour une faute pas grave, regrettée ou excusable : il peut garder son rôle d'admin, avec mon accord. Ses pouvoirs de staff sont alors suspendus sur ce service pendant le ban, et mon accord est noté dans le journal du staff.</li>
<li><strong>Récidive</strong> : les rôles sont retirés.</li>
</ul>
<div class="suite"><a href="architecture.html">← Les choix d'architecture du code</a><a href="reseau.html">Les sites LAN et le réseau →</a></div>
<p class="maj">Mise à jour : novembre 2026.</p>
</main>
<footer class="global-footer">
<div class="footer-content"><span>Théo Gastinel · Lans-en-Vercors</span><span><a href="/">Portfolio</a> · <a href="./">Documentation</a></span></div>
<div class="footer-bottom">© 2026 Théo Gastinel</div>
</footer>
</body>
</html>
+57
Voir le fichier
@@ -0,0 +1,57 @@
<!doctype html>
<html lang="fr">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<meta name="color-scheme" content="light">
<meta name="robots" content="noindex, nofollow">
<title>Les sauvegardes et la sécurité · Documentation · Théo Gastinel</title>
<meta name="description" content="Brouillon non publié : comment je sauvegarde mes services et comment je les protège.">
<link rel="stylesheet" href="docu.css">
</head>
<body>
<header class="entete"><div class="barre">
<a class="marque" href="/">Théo Gastinel</a>
<nav><a href="./">Documentation</a><a href="architecture.html">Architecture</a><a href="roles.html">Rôles</a><a href="reseau.html">Réseau</a><a href="meteo.html">Météo</a></nav>
</div></header>
<main>
<p class="brouillon">Brouillon, non publié. Cette page n'est pas encore en ligne : elle reste en aperçu tant que je ne l'ai pas validée.</p>
<p class="surtitre">Documentation · Sujet 4</p>
<h1>Les sauvegardes et la sécurité</h1>
<p class="chapeau">Héberger soi-même, c'est aussi être seul responsable quand un disque lâche. Voici comment je m'y prends, sans entrer dans des détails qui aideraient quelqu'un de mal intentionné.</p>
<h2>Plusieurs copies, à plusieurs endroits</h2>
<ul>
<li><strong>Chaque nuit</strong>, une sauvegarde complète des bases de données, de la configuration et des services, sur un autre disque que celui du système.</li>
<li><strong>Une copie sur une deuxième machine</strong> à la maison, vérifiée par empreinte après l'envoi.</li>
<li><strong>Une copie hors de la maison</strong>, dans un stockage en ligne. Elle est chiffrée avant de partir : le contenu et même les noms des fichiers sont illisibles pour l'hébergeur.</li>
<li><strong>Une durée de conservation limitée</strong> (environ deux semaines pour les copies hors site), pour garder de quoi revenir en arrière sans tout accumuler.</li>
</ul>
<p>Et avant toute modification d'un fichier important, je garde une copie datée de l'ancienne version.</p>
<h2>Les règles de sécurité que je m'impose</h2>
<ul>
<li><strong>Tout est fermé par défaut.</strong> Un pare-feu sur chaque machine, qui n'ouvre que le nécessaire.</li>
<li><strong>Le serveur maison n'est pas exposé directement.</strong> Le public passe par le VPS et des tunnels chiffrés.</li>
<li><strong>Les outils de travail restent sur le réseau local</strong>, ou derrière le VPN.</li>
<li><strong>Les tentatives de connexion répétées sont bloquées automatiquement.</strong></li>
<li><strong>Les secrets ne sont jamais dans le code.</strong> Clés et mots de passe sont rangés à part, avec des droits restreints, et jamais versionnés.</li>
<li><strong>Les mises à jour de mes logiciels sont signées</strong> et vérifiées avant installation.</li>
<li><strong>Peu de journaux, et sans adresse IP</strong> quand c'est possible. Ce qu'on ne garde pas ne peut pas fuir.</li>
<li><strong>Des audits réguliers</strong> : je fais relire mes services point par point, puis je corrige par ordre de gravité.</li>
</ul>
<h2>Ce que je veux encore améliorer</h2>
<ul>
<li>Tester la restauration régulièrement, pas seulement la sauvegarde : une copie qu'on n'a jamais restaurée n'est qu'un espoir.</li>
<li>Garder une copie hors ligne des clés de chiffrement, à part des données.</li>
</ul>
<div class="suite"><a href="reseau.html">← Les sites LAN et le réseau</a><a href="meteo.html">La collecte météo →</a></div>
<p class="maj">Mise à jour : novembre 2026.</p>
</main>
<footer class="global-footer">
<div class="footer-content"><span>Théo Gastinel · Lans-en-Vercors</span><span><a href="/">Portfolio</a> · <a href="./">Documentation</a></span></div>
<div class="footer-bottom">© 2026 Théo Gastinel</div>
</footer>
</body>
</html>
+8
Voir le fichier
@@ -399,6 +399,13 @@ body.spa-nav-hidden .spa-nav { display:none; }
.stats-btn:hover,.stats-btn:focus-visible { background:#242424; color:#fff; transform:translate(-50%,-54%); }
.stats-btn:focus-visible { outline:3px solid #a8b2bd; outline-offset:3px; }
@media (prefers-reduced-motion:reduce){ .stats-btn{ transition:none; } .stats-btn:hover,.stats-btn:focus-visible{ transform:translate(-50%,-50%); } }
.docu-invite { background:#fff; text-align:center; padding:56px 20px 64px; border-top:1px solid #e4e4e4; font-family:var(--font-sans); }
.docu-invite p { margin:0 0 16px; color:#444; font-size:1rem; line-height:1.6; }
.docu-btn { display:inline-flex; align-items:center; gap:10px; padding:12px 32px; border-radius:999px; background:#fff; color:#242424; border:2px solid #242424; font-weight:700; font-size:.92rem; letter-spacing:.3px; text-decoration:none; transition:background .25s,color .25s; }
.docu-btn svg { width:18px; height:18px; fill:currentColor; flex:none; }
.docu-btn:hover,.docu-btn:focus-visible { background:#242424; color:#fff; }
.docu-btn:focus-visible { outline:3px solid #a8b2bd; outline-offset:3px; }
@media (prefers-reduced-motion:reduce){ .docu-btn{ transition:none; } }
.global-footer { background:#242424; color:#d1d1d1; padding:60px 20px 30px; border-top:4px solid #111; font-size:.9rem; line-height:1.8; font-family:var(--font-sans); }
.global-footer .footer-content { max-width:1000px; margin:0 auto; display:grid; grid-template-columns:1fr 1fr; gap:40px; }
@@ -2877,6 +2884,7 @@ body.spa-nav-hidden .spa-nav { display:none; }
</div>
</div>
</section>
<div class="docu-invite"><p>Vous êtes développeur ou mon infrastructure vous intéresse&nbsp;?</p><a class="docu-btn" href="/docu/"><svg viewBox="0 0 24 24" aria-hidden="true" focusable="false"><path d="M6 2h9l5 5v15H6V2zm8 1.5V8h4.5L14 3.5zM8.5 12v1.5h9V12h-9zm0 3.5V17h9v-1.5h-9zm0 3.5v1.5h6V19h-6z"/></svg><span>Lisez ma documentation</span></a></div>
<div class="stats-bridge"><a class="stats-btn" href="https://stats.gastinel.me/" rel="noopener"><svg viewBox="0 0 24 24" aria-hidden="true" focusable="false"><path d="M4 20V10h4v10H4zm6 0V4h4v16h-4zm6 0v-7h4v7h-4z"/></svg><span>Statistiques</span></a></div>
<footer class="global-footer">
<div class="footer-content">