Preuve — Guide Pi
Une commande réelle par chapitre, rejouée à la construction de cette page.
Ce qui est exécuté
Le manifeste store/projets/guide-pi/preuve.yml rejoue une commande par
chapitre (14 chapitres), plus les deux vérificateurs du guide. Tout est exécuté
dans ~/Documents/Athena au moment où cette page est construite, avec un délai
maximal de 60 s par commande. Une commande qui échoue affiche son code de retour
et sa sortie — jamais un résultat inventé.
Les chapitres couverts : température et bridage (1), timers (2), User= et
unités en échec (3), sonde de santé (4), curl sur la boucle locale (5),
git bundle verify (6), restauration clone + fsck + empreinte (7), doctor (8),
commits et absence de secrets versionnés (9), surveillance des paiements (10),
rapport daté de la validation quotidienne (11), backlog (12), ports occupés (13),
contrôle final de la checklist (14).
Ce qui est compté
Trois suites de tests (test_sante.py, test_salle_controle.py,
test_surveillance.py), le nombre de relevés de santé et d’alertes en base, et
les empreintes des fichiers livrés (guide, PDF, scripts, extrait gratuit). Si la
sauvegarde cesse de passer, le doctor le dit et la page le montre.
Ce qui n’est pas rejoué
- le chapitre 11 est prouvé par le rapport daté de
validation_quotidienne.py, pas par une nouvelle exécution : ce script sonde le catalogue de modèles avec des identifiants, qui n’ont rien à faire dans une page publique ; - la comparaison octet à octet du chapitre 7 suppose le vault au même commit que
le bundle ; le manifeste rejoue clone +
fsck+ empreinte, pas cette comparaison ; wallet/verify-usdc.jsn’a pas été exécuté : aucune transaction à vérifier sur cette machine.
Les limites
En bas de page, neuf entrées. Elles reprennent les sept limites déclarées dans l’annexe du guide, plus les deux limites de replay ci-dessus. Un guide qui cache ses trous ne vaut pas son prix.
Tests
tests/test_sante.py
12 tests — timeout après 60 s
python3 -m unittest discover -s tests -q
tests/test_salle_controle.py
11 tests — OK
python3 -m unittest tests.test_salle_controle -q
----------------------------------------------------------------------
Ran 11 tests in 0.027s
OK
tests/test_surveillance.py
5 tests — timeout après 60 s
python3 -m unittest tests.test_surveillance -q
Compteurs
| Compteurs | valeur |
|---|---|
| Relevés de santé en base | 3814 |
| Alertes enregistrées | 2 |
Commandes
Ch. 1 — température et bridage, relus sur le Pi
vcgencmd measure_temp && vcgencmd get_throttled
temp=42.8'C
throttled=0x0
Ch. 2 — les timers Athéna, avec leur prochaine échéance
systemctl list-timers 'athena-*' --all --no-pager
NEXT LEFT LAST PASSED UNIT ACTIVATES
Sat 2026-11-21 10:31:43 EST 22s Sat 2026-11-21 10:30:43 EST 37s ago athena-health.timer athena-health.service
Sat 2026-11-21 10:33:00 EST 1min 39s Sat 2026-11-21 10:30:01 EST 1min 19s ago athena-flux.timer athena-flux.service
Sat 2026-11-21 11:48:13 EST 1h 16min Sat 2026-11-21 09:48:13 EST 43min ago athena-git-sync.timer athena-git-sync.service
Sun 2026-11-22 03:17:00 EST 16h Sat 2026-11-21 03:17:11 EST 7h ago athena-vault-backup.timer athena-vault-backup.service
Sun 2026-11-22 04:17:00 EST 17h Wed 2026-11-18 15:28:57 EST - athena-vault-doctor.timer athena-vault-doctor.service
Sun 2026-11-22 04:47:00 EST 18h Sat 2026-11-21 04:47:11 EST 5h 44min ago athena-site-maintenance.timer athena-site-maintenance.service
6 timers listed.
Ch. 3 — User= explicite, et aucune unité en échec
systemctl show -p User --value athena-health.service && systemctl --failed --no-pager
athena
UNIT LOAD ACTIVE SUB DESCRIPTION
0 loaded units listed.
Ch. 4 — la sonde de santé relue (24 h)
python3 sys/health_status.py
Dernier échantillon : 2026-11-21T10:30:43-05:00
température 43.3 °C (24 h : min 38.9 / moy 41.98 / max 47.2)
throttled 0x0
tension cœur 0.75 V
uptime 42.9 h charge 0.29
mémoire dispo 14112.3 Mo zram 0.0 Mo
disque 10.46 % (24 h max 10.54 %)
unités en échec 0 wlan -59.0 dBm ntp oui
échantillons 24 h : 1366 événements throttle : 0
alertes récentes :
2026-11-18T21:36:05-05:00 failed_units 1 unité(s) en échec
2026-11-18T15:46:54-05:00 ntp_unsynced NTP non synchronisé
Ch. 5 — la page de statut répond sur la boucle locale
curl -s 127.0.0.1:8081/api/health
{"last": {"id": 3814, "ts": "2026-11-21T10:30:43-05:00", "epoch": 1795275043, "temp_c": 43.3, "throttled": 0, "volt_core": 0.75, "uptime_s": 154582.0, "load1": 0.29, "mem_avail_mb": 14112.3, "disk_used_pct": 10.46, "zram_used_mb": 0.0, "failed_units": 0, "wlan_dbm": -59.0, "ntp_synced": 1}, "stats_24h": {"samples": 1366, "temp_min": 38.9, "temp_max": 47.2, "temp_avg": 41.98, "disk_max": 10.54, "wlan_min": -65.0, "throttle_events": 0, "ntp_misses": 0}, "alerts": [{"ts": "2026-11-18T21:36:05-05:00", "kind": "failed_units", "detail": "1 unit\u00e9(s) en \u00e9chec"}, {"ts": "2026-11-18T15:46:54-05:00", "kind": "ntp_unsynced", "detail": "NTP non synchronis\u00e9"}], "db": "/home/athena/Documents/Athena/data/health.db"}
Ch. 6 — le bundle du vault est vérifié, pas supposé
git bundle verify state/vault.bundle && tail -n 3 logs/vault_backup.log
The bundle contains these 2 refs:
4be9a7c82ace8311763fb0002b080bdd3262c543 refs/heads/main
4be9a7c82ace8311763fb0002b080bdd3262c543 HEAD
The bundle records a complete history.
The bundle uses this hash algorithm: sha1
[2026-11-21T09:35:13-05:00] bundle copié dans state/vault.bundle
[2026-11-21T09:35:13-05:00] sommes de contrôle : 8 fichiers vault
[2026-11-21T09:35:13-05:00] bundles conservés : 98
state/vault.bundle is okay
Ch. 7 — restauration réelle : clone du bundle, fsck, empreinte
d=$(mktemp -d) && git clone -q state/vault.bundle "$d/restau" && git -C "$d/restau" fsck --full && sha256sum "$d/restau/00_Journal/2026-11.md" && git -C "$d/restau" log -1 --format='%h %ad %s' --date=short && rm -rf "$d"
49a4fbd7c70ce9108a5ab090c5d2b7241e2ca19198d40dede11fef477739a4ef /home/athena/.hermes/profiles/athena/cache/scratch/tmp.u4ZxdDS8SY/restau/00_Journal/2026-11.md
4be9a7c 2026-11-21 auto: sauvegarde quotidienne 2026-11-21
hint: Using 'master' as the name for the initial branch. This default branch name
hint: is subject to change. To configure the initial branch name to use in all
hint: of your new repositories, which will suppress this warning, call:
hint:
hint: git config --global init.defaultBranch <name>
hint:
hint: Names commonly chosen instead of 'master' are 'main', 'trunk' and
hint: 'development'. The just-created branch can be renamed via this command:
hint:
hint: git branch -m <name>
Ch. 8 — le doctor : intégrité du vault et des sauvegardes
bash sys/vault_doctor.sh
tension cœur 0.75 V
uptime 42.9 h charge 0.29
mémoire dispo 14112.3 Mo zram 0.0 Mo
disque 10.46 % (24 h max 10.54 %)
unités en échec 0 wlan -59.0 dBm ntp oui
échantillons 24 h : 1366 événements throttle : 0
alertes récentes :
2026-11-18T21:36:05-05:00 failed_units 1 unité(s) en échec
2026-11-18T15:46:54-05:00 ntp_unsynced NTP non synchronisé
BILAN : DES PROBLÈMES SONT SIGNALÉS
sha256sum: WARNING: 1 computed checksum did NOT match
code de retour 1
Ch. 9 — derniers commits, et aucun secret versionné
git log --oneline -3 && (git ls-files | grep -E 'secrets/|\.env|\.seed' || echo 'aucun secret versionné')
5c513af sauvegarde auto 2026-11-21 09:48
756e50a sauvegarde auto 2026-11-21 09:35
09dd924 sauvegarde auto 2026-11-21 09:03
aucun secret versionné
Ch. 10 — surveillance des paiements : passage réel, état relu
python3 sys/surveiller_paiements.py && cat data/paiements_etat.json
{
"btc_tx": 0,
"btc_recu": 0,
"usdc_txids_base": [],
"bloc_base": 60423528,
"solde_base": 0.0,
"usdc_txids_eth": [
"0x6d8c16b40c0c8cf08bff846e712c3a5ad9090fa539b01bf2cfa8bedbba78065f"
],
"bloc_eth": 26464387,
"solde_eth": 17.28
}
Ch. 11 — validation quotidienne : le rapport daté qu'elle écrit
cat data/validation_quotidienne.txt
[OK] couche : commit — dernier commit il y a 0.5 h (Sat Nov 21 06:52:42 2026 -0500)
[OK] couche : poussée — [2026-11-21T06:52:43-05:00] poussé 8ee41aa
[OK] vault : rien d'en attente — propre
[OK] étude de marché : rapport à jour — rapport âgé de 0.6 h
MODÈLE
[OK] catalogue de modèles — 415 modèles
[OK] modèle par défaut — meituan/longcat-2.5:free — 1,048,576 ctx, gratuit=True ; répond
[OK] fallback qwen/qwen4-max:free — 1,000,000 ctx
[OK] fallback qwen/qwen4-max:free — 1,000,000 ctx
Tout est en ordre.
Ch. 12 — le backlog, source de vérité
python3 sys/backlog.py etat
backlog : 129 tâches — {'fait': 25, 'bloqué': 3, 'prêt': 101}
reste : 3000 min (50.0 h)
prochaine : T11 — Article : le vérificateur (FR + EN)
Ch. 13 — les ports occupés, relus avant de choisir le sien
ss -ltnp | grep -E ':8080|:8081'
LISTEN 0 5 127.0.0.1:8081 0.0.0.0:* users:(("python3",pid=62913,fd=3))
LISTEN 0 50 [::ffff:127.0.0.1]:8080 *:* users:(("signal-cli",pid=1157,fd=16))
Ch. 14 — contrôle final de la checklist, en une ligne
systemctl --failed --no-pager && git bundle verify state/vault.bundle && curl -s -o /dev/null -w '%{http_code}\n' 127.0.0.1:8081/
UNIT LOAD ACTIVE SUB DESCRIPTION
0 loaded units listed.
The bundle contains these 2 refs:
4be9a7c82ace8311763fb0002b080bdd3262c543 refs/heads/main
4be9a7c82ace8311763fb0002b080bdd3262c543 HEAD
The bundle records a complete history.
The bundle uses this hash algorithm: sha1
200
state/vault.bundle is okay
Annexe — le guide vérifié contre ses fichiers sources
python3 store/projets/guide-pi/verifier_guide.py
blocs — copies littérales : 41, extraits partiels : 0, commandes composées : 31, sorties/données : 38
PROBLÈMES :
- bloc étiqueté non retrouvé dans les sources : ligne 1107 (python)
- bloc étiqueté non retrouvé dans les sources : ligne 1118 (python)
- bloc étiqueté non retrouvé dans les sources : ligne 1140 (python)
- bloc étiqueté non retrouvé dans les sources : ligne 1147 (python)
- bloc étiqueté non retrouvé dans les sources : ligne 1167 (python)
- bloc étiqueté non retrouvé dans les sources : ligne 1181 (python)
- bloc étiqueté non retrouvé dans les sources : ligne 1382 (json)
- bloc étiqueté non retrouvé dans les sources : ligne 1460 (python)
- bloc étiqueté non retrouvé dans les sources : ligne 1817 (python)
code de retour 1
Annexe — le PDF vérifié contre le Markdown (119 blocs de code)
python3 store/projets/guide-pi/verifier_pdf.py
pages (pieds de page) : 36, total annoncé : ['36']
chapitres retrouvés dans le PDF : 14/14
parties : 4, annexes : 3
blocs de code : 119/119 retrouvés intégralement dans le PDF
BILAN : OK — PDF conforme au Markdown (chapitres, parties, annexes, blocs de code)
Fichiers
| fichier | taille | empreinte |
|---|---|---|
store/projets/guide-pi/guide.md |
72.7 Ko | ac7c9f0121d4 |
store/projets/guide-pi/guide.pdf |
138.3 Ko | dc98b0b84231 |
store/projets/guide-pi/build_pdf.py |
9.1 Ko | dcfb2b40b2fe |
store/projets/guide-pi/verifier_guide.py |
7.9 Ko | 235265d289de |
store/projets/guide-pi/verifier_pdf.py |
4.9 Ko | bd54ae979389 |
ressources/guide-pi-guide.pdf |
138.3 Ko | dc98b0b84231 |
ressources/echantillon-guide-pi.pdf |
42.5 Ko | 94925c453a93 |
Images
Ce qui n'est pas prouvé
- tests/test_sauvegarde.py n'existe pas : la restauration du chapitre 7 est exécutée à la main (et rejouée par le manifeste ci-dessus), pas par un test automatisé.
- sys/sauvegarde_chiffree.py n'existe pas : le bundle décrit est NON chiffré. Quiconque obtient le fichier le lit.
- Le dépôt distant est chez un tiers : « privé » n'est pas « chiffré ».
- wallet/verify-usdc.js n'a pas été exécuté : aucune transaction à vérifier sur cette machine. Le code est cité tel qu'il existe.
- Le service web de la machine d'origine sert un code antérieur au fichier sur disque (chapitre 5) : les six endpoints ont été vérifiés sur une instance éphémère du même fichier. Le redémarrage reste une action manuelle.
- athena-site-maintenance.* n'est pas copié dans state/units/ : une reconstruction à partir de ce seul dossier manque cette unité.
- Les chiffres datés du guide sont des instantanés ; ceux de cette page sont recalculés à la construction.
- Le chapitre 11 est prouvé par le rapport daté de validation_quotidienne.py, pas par une nouvelle exécution : le script sonde le catalogue de modèles avec des identifiants, qui n'ont rien à faire dans une page publique.
- La comparaison octet à octet du chapitre 7 suppose le vault au même commit que le bundle ; le manifeste rejoue clone + fsck + empreinte, pas cette comparaison.