Dis à l'application quelle version elle est, et sous quelle licence

Page « À propos » (/a-propos) : manuel annoncé à venir, contact, site de
l'auteur, version publiée avec sa date de build, et licence AGPL v3 avec le
lien vers le dépôt — l'AGPL attend que les utilisateurs d'un service en réseau
puissent en obtenir la source, ce lien n'est donc pas un ornement.

L'application ne connaissait pas sa version : elle vivait dans le manifeste du
paquet et dans les tags git, jamais dans le binaire. `build/publier-release.sh`
pose désormais `-p:Version` et `-p:MaBibliDateBuild` ; l'API rend les deux par
`GET /api/version`.

⚠️ L'horodatage est le TÉMOIN de l'injection, et rien ne le calcule côté
MSBuild. Sans lui, la version lue serait le « 1.0.0 » que le SDK pose par
défaut : il se lirait comme une vraie version alors qu'il ne désigne rien, et
c'est exactement la valeur qu'on ira chercher pour diagnostiquer un appareil au
cache dépareillé. Mieux vaut ne rien annoncer — un binaire compilé à la main se
déclare « version de développement », ce qui est vrai.

Autres décisions :

- l'entrée du menu est DÉTACHÉE des six destinations, par un filet au-dessus
  sur téléphone et à gauche en rangée sur PC : « À propos » est une annexe, pas
  une septième destination. Ses règles vivent en feuille GLOBALE, comme tout le
  menu — une règle scopée n'atteint pas ce que rend un NavLink ;
- le « mailto: » reste un lien même hors-ligne : il ne charge aucune page et
  passe la main au client de messagerie, qui sait mettre un message en attente.
  Le site et le dépôt, eux, basculent en boutons désactivés portant leur motif,
  comme les liens d'export des envies ;
- la version est un sixième instantané hors-ligne : on la lit justement quand
  quelque chose ne va pas, et un appareil qu'on soupçonne est souvent celui qui
  n'a plus de réseau. L'écran dit alors que c'est la dernière version vue du
  serveur.

Le point de rupture de 40 rem reste identique dans les deux feuilles, et
/a-propos est inscrite dans la table de remontée des routes.

Vérifié en exécution, l'API lancée : sans injection
`{"numero":null,"publiee":false}`, avec `-p:Version=0.4.1
-p:MaBibliDateBuild=…` `{"numero":"0.4.1","publiee":true}`. Le rendu des écrans
n'a PAS été vérifié en navigateur. 618 tests au vert (605 avant).

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
mathieu
2026-08-21 14:50:34 +02:00
co-authored by Claude Opus 5
parent 0976da90be
commit 498579f27b
13 changed files with 449 additions and 0 deletions
+11
View File
@@ -19,6 +19,17 @@ public static class ClesCache
public const string Utilisateur = "utilisateur";
/// <summary>
/// La version publiée et sa date de build, telles que le serveur les a annoncées.
/// </summary>
/// <remarks>
/// ⚠️ Elle vaut la peine d'être rangée précisément parce qu'on la lit quand quelque chose ne
/// va pas — et un appareil dont on soupçonne le cache est aussi bien celui qui n'a plus de
/// réseau. Ce qui est affiché hors-ligne est la <b>dernière version vue du serveur</b>, et
/// l'écran le dit : c'est un fait daté, pas une supposition.
/// </remarks>
public const string Version = "version";
/// <summary>
/// La liste d'envies de l'utilisateur courant.
/// </summary>
@@ -76,6 +76,10 @@ public static class RemonteeRoutes
("/auteurs", Racine),
("/prets", Racine),
// « À propos » est une annexe du menu : elle remonte au catalogue, comme toute racine de
// branche. Elle n'a pas d'enfants, et n'en aura pas.
("/a-propos", Racine),
("/not-found", Racine),
];
@@ -53,6 +53,7 @@ public sealed class ServiceLivresApi(HttpClient http, CacheHorsLigne cache, Etat
await ListerSeriesAsync(ct);
await ListerRevuesAsync(ct);
await ObtenirUtilisateurAsync(ct);
await ObtenirVersionAsync(ct);
return reseau.EnLigne;
}
catch (OperationCanceledException)
@@ -459,6 +460,30 @@ public sealed class ServiceLivresApi(HttpClient http, CacheHorsLigne cache, Etat
return instantane?.Donnees ?? UtilisateurCourant.Anonyme;
}
/// <summary>
/// Version publiée du serveur, avec repli sur la dernière connue de cet appareil.
/// </summary>
/// <remarks>
/// Même forme que <see cref="ObtenirUtilisateurAsync"/>. Hors-ligne on rend l'instantané
/// plutôt que rien : c'est un fait daté (« voilà ce que le serveur annonçait »), et c'est
/// justement quand l'application se comporte mal qu'on veut ce numéro. L'écran distingue les
/// deux cas ; ici on ne fabrique aucune valeur.
/// </remarks>
public async Task<VersionApplication> ObtenirVersionAsync(CancellationToken ct = default)
{
var (ok, version) = await EssayerAsync(
() => http.GetFromJsonAsync<VersionApplication>("api/version", Json, ct));
if (ok && version is not null)
{
await MemoriserAsync(ClesCache.Version, version);
return version;
}
var instantane = await LireCacheAsync<VersionApplication>(ClesCache.Version);
return instantane?.Donnees ?? VersionApplication.Developpement;
}
/// <summary>
/// Exécute un appel de lecture. Renvoie <c>false</c> — sans exception — quand le réseau
/// manque, ce qui est la bascule vers le cache. Une annulation demandée par l'appelant,