Consigne ce que le paquet YunoHost a appris de sa propre mesure

Trois items ouverts d'IDEES.md instruits sur pieces, et deux conclusions
renversees en chemin — c'est ce que ces notes servent a ne pas refaire.

Le paquet n'avait presque rien a simplifier : neuf fichiers, 209 lignes de
code, de 9 a 49 lignes chacun. Ce qui donnait l'impression de volume, ce sont
les 306 lignes de commentaires, qui documentent chacune une panne reellement
constatee. Tout le poids etait dans publier.sh, 1,4 fois le paquet reuni.

Le menu interactif de choix de version paraissait le meilleur candidat a la
coupe, jusqu'a ce que les neuf montees de version montrent six correctifs ET
trois sauts mineurs. Il sert une fois sur trois : mesurer avant de tailler vaut
aussi pour l'outillage.

L'icone du paquet : logo.png n'est lu par personne. Les logos du catalogue
vivent dans le depot YunoHost/apps, ou MaBibli n'est pas ; la tuile du portail
accepte un logo televerse depuis la 12.1, et le manifeste exige deja 12.1.38.
Il n'y a donc rien a corriger dans le depot.

La RAM est mesuree et ram.runtime porte a 256M. Le pic n'est pas le lookup
ISBN, contrairement a l'intuition, mais « Nouveautes » sur un auteur tres
reedite — cas qui n'a pas encore ete mesure et qui croit avec le fonds.

Le README cesse de decrire --archive-seule comme une brique de CI et retire le
« --version est obligatoire ici », piege qui n'existe plus.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
mathieu
2026-08-22 12:15:39 +02:00
co-authored by Claude Opus 5
parent 888f12596d
commit 7f72386547
3 changed files with 198 additions and 14 deletions
+45 -3
View File
@@ -736,6 +736,35 @@ en second rideau** et l'**EAN-2 à confirmer en kiosque** — la série du 2026-
## Simplifier `mabibli_ynh`
✅ **Traité le 2026-08-22** — voir `CLAUDE.md`, « `--archive-seule` n'est PAS une brique
de CI » et « Ce que la mesure a montré ». Le texte d'origine est conservé ci-dessous : il
dit le besoin, que la décision ne remplace pas.
**Le diagnostic n'était pas celui attendu.** Mesuré : le paquet fait **209 lignes de code**
pour **306 de commentaires**, ses neuf fichiers pesant de 9 à 49 lignes chacun. Il n'y
avait rien à y couper. Tout le poids est dans `publier.sh` (298 lignes de code, 1,4 fois
le paquet réuni). Ce qui a été fait :
- `--archive-seule` **rangé, pas retiré** : ses 8 ramifications tombent à 5, dont une
seule exprime la différence de mode. ⚠️ Il avait failli être supprimé sur la foi d'une
justification fausse (« brique de CI ») ; le `README` montrait qu'il est le chemin de
reprise après échec ;
- les **cinq variables d'environnement jumelles** supprimées ;
- deux défauts corrigés au passage : le dépôt sale n'était **pas signalé** en
`--archive-seule`, et la version y retombait sur celle **déjà publiée** ;
- `build/dist` ramené de **680 Mo à 205 Mo** (trois dernières versions), et les deux
`doc/*_fr.md`, identiques à leurs jumeaux, supprimés.
⚠️ **Le menu interactif de choix de version reste** : c'était le meilleur candidat à la
coupe sur le papier, jusqu'à ce que les neuf montées de version montrent six correctifs
**et trois sauts mineurs**. Mesurer avant de tailler vaut aussi pour l'outillage.
⚠️ **Écarté avec l'utilisateur le 2026-08-22** : automatiser le dépôt de la release dans
Gitea via son API. Cela aurait fait passer la publication de trois gestes à deux, au prix
d'un jeton d'accès à posséder et à renouveler. Le téléversement reste manuel.
---
Demande telle quelle : « retravailler la partie YunoHost pour la simplifier ». Rien n'est
diagnostiqué à ce stade — le paquet **fonctionne** (installé, mis à jour, sauvegardé et restauré
sur un vrai serveur, voir `CLAUDE.md`), il s'agit de le rendre plus simple à lire et à
@@ -759,13 +788,26 @@ lignes, ou moins de choses à savoir pour publier une version ? Ce ne sont pas l
## L'icône du paquet
`mabibli_ynh/logo.png` **existe** (824 o, 256×256, même dessin que l'application). Reste à
établir ce qui manque exactement — le catalogue YunoHost et la tuile du portail ne lisent pas
forcément le même fichier au même endroit. ⚠️ À ne pas confondre avec les icônes **de la PWA**
✅ **Tranché le 2026-08-22** — voir `CLAUDE.md`, « L'icône du paquet ». Réponse : **le
fichier n'est lu par personne**, et il n'y a **rien à corriger dans le dépôt**. Les logos
du catalogue vivent dans le dépôt `YunoHost/apps`, où MaBibli n'est pas ; la tuile du
portail accepte un logo téléversé **depuis la 12.1**, et le manifeste exige déjà
`>= 12.1.38`. C'est un geste sur le serveur, avec le fichier déjà présent — reste à le
faire, et à vérifier sur place l'écran exact de l'interface 12.1.
`mabibli_ynh/logo.png` **existe** (824 o, 256×256, même dessin que l'application). ⚠️ À ne pas confondre avec les icônes **de la PWA**
(`favicon.png`, `icon-192.png`, `icon-512.png`), qui sont dans le dépôt du code et déjà en place.
## Ajuster la RAM déclarée au plus près du réel
✅ **Mesuré et tranché le 2026-08-22** — voir `CLAUDE.md`, « `ram.runtime` mesuré et
porté à 256M ». Pic réel **199,1 Mio** contre 200M déclarés, soit **0,4 % de marge** :
`ram.runtime` passe à `256M`, `ram.build` reste à `50M`.
⚠️ **Reste ouvert, mais nommé** : le cas plafond (« Nouveautés » sur un auteur très
réédité) n'a pas été mesuré, et il croît avec la taille du fonds. À reprendre quand la
bibliothèque aura beaucoup grossi.
`manifest.toml` annonce `ram.build = "50M"` et `ram.runtime = "200M"` — des valeurs **posées à
l'estime**, jamais mesurées. YunoHost s'en sert pour refuser une installation sur une machine
trop petite : trop haut, on interdit une installation qui aurait marché ; trop bas, on la laisse