Application du poste (Linux)
Le paquet .deb et l'AppImage de Bosco, leurs mises à jour, la barre système, les notifications natives, et leur construction depuis le dépôt.
L'application du poste est une fenêtre Electron autour de l'interface de Bosco, avec une icône dans la barre système et des notifications natives. Elle est facultative : Bosco marche aussi dans le navigateur. Elle n'existe que pour Linux, en paquet .deb ou en AppImage, à télécharger depuis la dernière release.
Les deux embarquent tout ce qu'il faut pour tourner sans le dépôt :
- le service de Bosco et son interface déjà construite, avec leurs seules dépendances de production ;
- Node 26, pour ne dépendre ni du Node du poste ni de nvm ;
- l'application Electron.
Elles gardent les données de ~/.local/share/bosco, les mêmes que le service lancé depuis le dépôt : passer de l'un à l'autre ne perd rien.
Le paquet .deb
sudo apt install ./bosco-desktop_0.1.0-beta.1_amd64.debIl s'installe dans /opt/Bosco, ajoute Bosco au menu des applications et configure à l'installation le bac à sable de Chromium (chrome-sandbox) et le profil AppArmor qu'Ubuntu exige depuis la 23.10. C'est le choix conseillé. Si apt signale que _apt ne peut pas lire le fichier, copie-le d'abord dans /tmp.
L'AppImage
chmod +x bosco-desktop_0.1.0-beta.1_x86_64.AppImage
./bosco-desktop_0.1.0-beta.1_x86_64.AppImageUn seul fichier, sans installation, pour toute distribution Linux. Elle se met à jour seule depuis les releases : garde-la à un endroit fixe (par exemple ~/Applications), la mise à jour la remplace sur place.
Sans le bac à sable de Chromium
Une AppImage ne peut pas installer le chrome-sandbox privilégié ni le profil AppArmor : son lanceur ajoute
--no-sandbox. Préfère le paquet .deb si tu veux ce bac à sable. Le bac à sable de Bosco,
où tournent les sessions, n'en dépend pas.
Les mises à jour
Réglages › À propos dit la version qui tourne et comment Bosco est installé : paquet .deb, AppImage (mise à jour automatique) ou depuis le dépôt. Une bêta se lit « 0.3.0-beta.1 · bêta ». Bosco cherche une version plus récente une fois par jour au plus, sur le canal « Stable » ou « Bêta » (voir Réglages).
- AppImage : la nouvelle version se télécharge en arrière-plan, puis le menu de la barre système commence par « Relancer pour mettre à jour · version 0.2.0 ».
- Paquet .deb : un bandeau « Version 0.2.0 disponible » propose le nouveau paquet. Installé pendant que Bosco tourne, il se signale : une notification « Bosco a été mis à jour » s'affiche, et le menu de la barre système commence par « Relancer Bosco · version 0.2.0 installée ».
Bosco ne se relance jamais seul : c'est toi qui choisis le moment, entre deux tours. Après une mise à jour, un bandeau « Bosco 0.2.0 installé » mène une fois aux nouveautés.
Une version plus ancienne refuse de démarrer sur des données qu'une plus récente a mises à jour. Elle affiche « Tes données viennent d'un Bosco plus récent ».
Construire depuis le dépôt
make desktop-package # construit apps/desktop/out/bosco-desktop_<version>_amd64.deb
make desktop-package-install # l'installe avec apt (sudo)
make desktop-update # git pull, pnpm install, puis construit et installe le paquet (sudo)
make desktop-release # .deb, AppImage et fichiers de mise à jour, à la version exacte du dépôtmake desktop-package construit d'abord tout le dépôt (make build), puis prépare le paquet. Un seul .deb reste dans apps/desktop/out : les anciens sont supprimés. Un paquet construit hors d'une release porte la version suivie de la date et du commit, par exemple 0.1.0+git20261109073400.3118cb5 : chaque construction est plus récente pour apt. Une copie de travail modifiée prend en plus un suffixe .dev….
make desktop-package-install copie le paquet dans un dossier temporaire lisible par l'utilisateur _apt, puis lance sudo apt install --reinstall. Sans ce détour, apt se plaint de ne pas pouvoir lire un fichier du dossier personnel.
Les releases elles-mêmes sont construites par le workflow « Release » de GitHub Actions : voir Développement.
Essayer une branche : make beta
Pour essayer une branche avant sa fusion, sur tes vraies données :
make beta BRANCH=feat/usage-page # construit la branche d'origin et installe son paquet (sudo)
make beta # sans BRANCH : la copie de travail courante
make beta BRANCH=main # revenir à mainLa branche se construit dans un worktree à part, ~/.cache/bosco/beta, gardé d'un essai à l'autre : le dépôt courant n'est pas touché. Le paquet remplace ensuite l'application installée.
make beta BRANCH=main ne revient en arrière que si la branche essayée n'a pas migré la base. Sinon, la version de
main refuse de démarrer sur ces données.
Au lancement
L'application cherche un service Bosco sur http://127.0.0.1:4870 :
- aucun service ne répond : elle démarre le sien, celui du paquet ;
- un service répond déjà, par exemple le service systemd de l'installation : la fenêtre « Bosco tourne déjà sur ce poste » propose « Se relier au service », « Remplacer le service par l'application » (qui désactive le service systemd) ou « Quitter ». Le choix est gardé.
Si le service ne démarre pas, la fenêtre « Le service Bosco n'a pas démarré » montre ses dernières lignes d'erreur.
La fenêtre
La fenêtre affiche l'interface de Bosco, comme le navigateur. Les liens vers l'extérieur s'ouvrent dans le navigateur. Fermer la fenêtre la masque : Bosco reste dans la barre système et continue de notifier. Relancer l'application ramène la fenêtre existante, sans seconde instance.
La barre système
L'icône change dès qu'une session t'attend, et son infobulle dit combien : « Bosco · 2 sessions t'attendent ». Un clic sur l'icône ouvre la fenêtre. Le menu se lit de haut en bas :
- « Relancer pour mettre à jour · version … » (AppImage) ou « Relancer Bosco · version … installée » (paquet
.deb), seulement quand une nouvelle version est prête. - L'état : « Bosco · rien ne t'attend », « Bosco · 1 session t'attend » ou « Bosco · N sessions t'attendent ».
- Une ligne par session qui t'attend, la plus ancienne d'abord, qui ouvre la session :
- une autorisation : « Ajouter les catégories au budget du foyer · Bash npm run db:migrate » ;
- une question : « Récapitulatif quotidien des réservations · question de l'agent » ;
- un tour terminé : « Migrer le logger vers OpenTelemetry · tour terminé ».
- « Ouvrir Bosco », « Nouvelle session » et la case « Suspendre les notifications 1 h ».
- La case « Lancer au démarrage » et « Quitter Bosco ».
« Lancer au démarrage » écrit ~/.config/autostart/bosco.desktop : Bosco démarre avec ta session, fenêtre fermée, dans la barre système.
Les notifications
Quand l'application tourne, c'est elle qui affiche les notifications, avec celles du système : le service ne les envoie pas en double. Le titre dit le type et le projet, « Autorisation · maison », le texte donne le titre de la session et un extrait. Un clic ouvre la session dans la fenêtre.
Une autorisation ou une question part en priorité critique : elle reste affichée jusqu'à ce que tu la fermes. Rien ne s'affiche quand la fenêtre est au premier plan (l'interface montre un message bref) ni pendant une suspension d'une heure. Ce qui notifie se règle dans Réglages › Notifications.
Lancer l'application depuis le dépôt
Pour développer l'application elle-même, sans paquet :
make desktop # construit, puis ouvre l'application du dépôt avec le Node du poste
make desktop-install # ajoute au menu des applications une entrée qui lance l'application du dépôtDepuis le dépôt, le bac à sable de Chromium demande un chrome-sandbox qui appartient à root. Sans lui, l'application se lance sans bac à sable et affiche la commande sudo chown … && sudo chmod 4755 … qui le configure. Le paquet .deb le configure à l'installation ; l'AppImage s'en passe.