Ce que j'ai, dans quel sac, et pour quel projet.
Un inventaire du matériel pensé pour le téléphone, avec des étiquettes QR imprimées en Bluetooth.
Voir la démo · Installer · Imprimantes · App iOS
In English. Barda is a self-hosted inventory for tools and gear: items, the bags or boxes they live in (lots), and the projects they serve. Each item and lot gets a 12 mm QR label printed over Bluetooth (Fichero D11s today, more printers can be added). Scan a label to open the item, or scan a series to put things away. Next.js + SQLite, one Docker container, an MCP server so an AI assistant can read and update the inventory. The UI is in French.
Trois objets, et c'est tout :
| Code | À quoi ça sert | |
|---|---|---|
| Objet | I… |
Une chose. Un fer à souder, un disque dur, un rouleau de gaine, une trousse de secours. Nom, description libre, quantité et unité, catégorie, état, photo, notices. |
| Lot | L… |
Où c'est rangé : un sac, une caisse, un tiroir. Nommé « Lot 1 », « Lot 2 »… par défaut. Un objet est dans zéro ou un lot. |
| Projet | P… |
À quoi ça sert : « Voiture enfant », « Support CAN ». Un objet peut servir à plusieurs projets. |
La fiche d'un projet répond à la seule question qui compte au moment de charger la voiture : quels lots embarquer.
Chaque objet et chaque lot porte un code court à 6 caractères (IR7MCX, LGJWAQ). L'alphabet
exclut I, L, O et U, illisibles sur une étiquette de 12 mm.
Deux choses différentes, volontairement séparées :
- l'état décrit la chose :
ok,usé,à réparer,à remplacer,prêté,manquant; - « à racheter » est une intention, pas un état. Un tournevis neuf peut être sur la liste de courses parce qu'on en veut un deuxième ; un foret usé peut ne pas y être parce qu'on s'en contente.
La page /courses rassemble tout ce qui est à reprendre. Un objet y arrive de cinq façons :
coché à la main, quantité tombée à zéro, passé sous son seuil, porté manquant, ou
date de renouvellement passée (une trousse de secours, un extincteur). Chaque ligne dit
pourquoi, et « Racheté » remet le stock et sort l'objet de la liste.
Le seuil (min_qty) évite d'avoir à y penser : trois rouleaux d'étain avec un seuil à 1, et
l'étain remonte tout seul le jour où il n'en reste qu'un. À 0, pas de seuil : c'est le défaut,
pour ne pas imposer de compter ce qu'on ne veut pas compter.
Sans photo, l'objet affiche l'icône de sa catégorie : il n'y a jamais de vignette vide. Quatre façons d'en mettre une, dans cet ordre d'utilité :
| Photo | l'appareil du téléphone, réduite à 1024 px dans le navigateur avant l'envoi. |
| Coller | le vrai chemin pour un produit précis : copier l'image sur la page du vendeur, coller ici. |
| Adresse | une URL d'image, récupérée côté serveur (le navigateur ne peut pas, à cause de CORS). |
| Suggérer | Unsplash et Wikipédia, proposés puis validés à l'œil, jamais appliqués tout seuls. |
Pourquoi pas de récupération automatique : mesuré avant d'écrire la moindre ligne, Wikipédia répond juste sur le générique (perceuse, multimètre) mais « tresse à dessouder » renvoie le dieu égyptien Seth, et scraper une boutique casse en silence. Une photo fausse est pire qu'une icône.
Photo ou illustration. Chaque image dit d'où elle vient. Ce qui sort de l'appareil photo est une photo : l'objet réel. Ce qui est collé, récupéré par une adresse, suggéré ou posé par le MCP est une illustration : au plus près de l'objet, mais pas lui. Les illustrations portent un petit badge, et la fiche garde le site d'où elles viennent. Une image récupérée par son adresse est téléchargée, vérifiée (jpeg, png ou webp, 12 Mo au plus), réduite à 1024 px et réencodée côté serveur, ce qui en retire aussi les métadonnées. Le serveur refuse les adresses du réseau privé.
Chaque objet porte aussi des documents : un PDF déposé ou un lien. Les deux existent, mais un lien ne s'ouvre pas sans réseau ; pour du matériel qui part loin, c'est le fichier qui compte.
Le QR encode le code nu (IR7MCX), pas une adresse. Mesuré sur les 90 px de haut disponibles :
| Contenu | Modules | Taille de module | Correction d'erreur |
|---|---|---|---|
adresse https://…/s/… |
25×25 | 0,38 mm | L : 7 % |
code nu IR7MCX |
21×21 | 0,50 mm | Q : 25 % |
+32 % de module et 3,5× plus de correction, pour le même encombrement. Sur une étiquette pliée, sale ou vue de loin, c'est la différence entre lire et ne pas lire. Le bouton QR lien rétablit l'adresse (seule l'adresse permet à l'appareil photo d'iOS d'ouvrir la fiche directement) ; le scanner de l'app lit les deux.
Le scanner intégré (/scan) sert à deux choses : consulter (scan, la fiche s'ouvre) et
ranger (on choisit un lot, puis on scanne les objets à la chaîne). Un code-barres de
fabricant inconnu propose de créer l'objet avec ce code.
Calage. Si l'imprimante coupe un bord de l'étiquette, les flèches sous l'aperçu décalent tout le contenu par pas de 0,5 mm, et l'aperçu montre exactement ce qui sortira. Le réglage est gardé dans le navigateur et vaut pour les deux sens ; la D11s part avec +2,5 mm, mesuré sur des étiquettes de 12 × 30 mm.
Un bouton qui imprime au premier appui coûte cher : un double appui, une étiquette de trop. Le
chemin normal est donc le panier : on ajoute à la file depuis les fiches, la page
/impression montre une carte par étiquette avec son aperçu réel, et rien ne sort tant qu'on
ne l'a pas demandé. Au-delà de dix étiquettes, l'impression demande une confirmation ; une
coupure en cours de série n'acquitte que ce qui est sorti ; chaque fiche dit « imprimée le … ».
| Imprimante | Étiquettes | Navigateur (Web Bluetooth) | App iOS | Relais Mac |
|---|---|---|---|---|
| Fichero D11s | 12 × 30 mm, 203 dpi | Chrome, Edge | oui | oui |
Safari n'expose pas le Bluetooth aux pages web, ni sur iPhone ni sur Mac. D'où trois chemins, que la page choisit toute seule :
| Contexte | Chemin | Ce qu'il faut |
|---|---|---|
App iOS barda-ios |
pont natif vers CoreBluetooth | l'app installée |
| Chrome / Edge, sur ordinateur ou Android | Web Bluetooth | rien |
| Safari, ou n'importe quoi d'autre | « Confier au Mac », puis le relais | npm run spool qui tourne sur un Mac |
Le relais imprime via la CLI de fichero-printer, et
doit être lancé depuis Terminal.app : macOS n'accorde le Bluetooth qu'aux processus dont le
parent y a droit.
BARDA_URL=https://barda.example.com BARDA_PRINT_TOKEN=… npm run spool-
Décrire le modèle dans
src/lib/printers/models.ts, en ajoutant une entrée àPRINTERS:- un
idstable (marque-modele), qui ne changera plus ; - le
nameaffiché, ledpi, la largeur de têteheadDotsetbytesPerRow; - les formats d'étiquette dans
labels(largeur dans le sens de la tête, longueur dans le sens du papier) ; - la plage de
densityet lestransportsréellement pris en charge. - au besoin
feedOffsetMm, le calage par défaut si la machine démarre à côté du bord.
Le rendu s'adapte seul : la hauteur de l'étiquette suit le modèle, le gabarit garde ses proportions.
- un
-
Navigateur : écrire un pilote
src/lib/printers/<id>.tsqui renvoie unPrinterDriver. Il reçoit une trame 1 bit déjà encodée et la transmet. L'inscrire dans la tableWEB_BLUETOOTHdesrc/lib/printers/index.ts. -
iPhone : dans
barda-ios, écrireBarda/<Modele>.swift, une classe conforme àLabelPrinter, avec le mêmeidet le mêmebytesPerRowque côté web, puis l'ajouter àPrinters.catalogdansBarda/Printers.swift. -
Relais : ajouter une entrée à
RELAYdansscripts/spool.mjs, avec la commande qui imprime un PNG, choisie parBARDA_PRINTER=<id>. -
Tant qu'il n'y a qu'une imprimante,
activePrinter()la renvoie directement : c'est le seul endroit à transformer en réglage pour en gérer plusieurs.
Un transport non implémenté pour un modèle ne casse rien : la page propose les chemins restants. Les contributions pour d'autres étiqueteuses Bluetooth (Niimbot, Phomemo…) sont bienvenues.
Un seul conteneur, une base SQLite, un volume. Avec Docker Compose :
git clone https://github.com/Lyniiiix/barda.git && cd barda
cp .env.example .env # puis BARDA_PASSWORD et BARDA_SECRET au minimum
docker compose up -d # écoute sur 127.0.0.1:3000Mets-le derrière ton reverse proxy HTTPS habituel : la caméra du téléphone n'est accessible
qu'en HTTPS. Pour ma part, Barda tourne sous Coolify, derrière son Traefik : un projet
avec ce dépôt comme source, le Dockerfile comme méthode de build, un volume persistant sur
/data, et les variables d'environnement ci-dessous. Caddy, Nginx Proxy Manager ou un tunnel
font aussi bien l'affaire.
Dockerfile, pas une détection automatique : node:sqlite exige Node ≥ 24, et
nixpacks choisit Node 22 (ERR_UNKNOWN_BUILTIN_MODULE).
| Variable | Rôle |
|---|---|
BARDA_PASSWORD |
mot de passe unique d'accès (obligatoire en production) |
BARDA_SECRET |
clé HMAC du cookie de session, openssl rand -hex 32 (obligatoire en production) |
BARDA_DB |
chemin du fichier SQLite (/data/barda.db dans le conteneur) |
BARDA_PRINT_TOKEN |
jeton du relais d'impression (en-tête x-barda-token) |
BARDA_MCP_TOKEN |
jeton du serveur MCP ; sans lui, /api/mcp refuse tout |
UNSPLASH_ACCESS_KEY |
optionnel : suggestions de photos Unsplash |
BARDA_DEMO |
1 pour le mode démo (voir plus bas) |
BARDA_SIGNATURE |
pied de page : vide pour « Conçu par can.sys », off pour le retirer |
BARDA_CF_ACCESS_TEAM · BARDA_CF_ACCESS_AUD |
derrière Cloudflare Access : nom de l'équipe et aud de l'application ; Barda refuse alors toute requête sans jeton Access valide |
Sécurité. L'accès tient en un mot de passe et un cookie signé d'un an, et le site est en
noindex. Sur un domaine public, mets une porte devant : un réseau privé (Tailscale) ou
Cloudflare Access. Avec Access, pose BARDA_CF_ACCESS_TEAM et BARDA_CF_ACCESS_AUD : Barda
vérifie alors lui-même la signature du jeton que Cloudflare ajoute à chaque requête, ce qui
ferme le contournement par l'IP de l'origine. Laisse hors d'Access /api/mcp et
/api/print-queue, appelés par des machines qui ont chacune leur jeton. La sonde de santé du
conteneur est /api/sante.
Sauvegarde. Réglages ▸ Exporter en JSON sort tout (objets, lots, projets, liens). Les photos
et les PDF sont dans le volume, à côté de la base : sauvegarde le volume entier.
BARDA_DEMO=1 ouvre l'app sans mot de passe, sur un inventaire fictif créé au premier démarrage,
en lecture seule : le middleware refuse toute requête qui écrit (formulaire, action serveur,
envoi de fichier), ainsi que le MCP, le relais et les suggestions de photos. C'est ce qui tourne
sur showcase-barda.can-ali.fr.
POST /api/mcp : un serveur MCP (JSON-RPC, transport HTTP, sans état) servi par l'app elle-même,
pour qu'un assistant puisse consulter et tenir l'inventaire.
claude mcp add --transport http barda https://barda.example.com/api/mcp \
--header "Authorization: Bearer $BARDA_MCP_TOKEN"| Outil | |
|---|---|
inventaire_apercu |
vue d'ensemble : totaux, lots, projets, ce qui cloche. Le point d'entrée. |
objets_chercher · objet_lire |
recherche et détail |
lots_lister · projets_lister |
les contenants et les usages |
projet_besoins |
ce qu'il faut pour un projet, groupé par lot, donc quoi embarquer |
objet_ajouter · objet_modifier |
création et modification partielle |
objet_ranger · stock_ajuster · stock_reappro |
changer de lot, décompter, racheter |
objet_photo_definir |
donner une image à un objet par son adresse : téléchargée et gardée, marquée illustration par défaut ; une vraie photo ne se remplace qu'avec forcer |
objet_document_lier · a_racheter_lister |
notices et liste de courses |
lot_creer · lot_modifier |
nouveau contenant, ou changer le nom, le type, l'emplacement ou la description d'un lot |
projet_creer |
nouveaux projets |
Aucun outil ne supprime. Un modèle peut se tromper de code, et un objet effacé ne se retrouve
pas. Les écritures passent par src/lib/mutations.ts, exactement le même code que les formulaires.
npm install
npm run dev # http://localhost:3210, mot de passe « barda » hors productionNode ≥ 24 obligatoire. Base SQLite par node:sqlite : aucun ORM, le schéma est en haut de
src/lib/db.ts et se crée tout seul au démarrage. Seule dépendance native : sharp, déjà
embarqué par Next.js, pour réduire les images récupérées par leur adresse ; ses binaires sont
précompilés, rien à installer. Pour travailler sur
des données d'exemple : BARDA_DEMO=1 BARDA_DB=/tmp/demo.db npm run dev.
Barda fait partie de la « Suite » de can.sys : une tuile nuit, une initiale en serif (Source Serif 4), un point de couleur propre à chaque app (ambre pour Barda), Inter pour le texte et JetBrains Mono pour les codes. Les icônes viennent de Lucide.
- Protocole BLE de la D11s : 0xmh/fichero-printer (MIT),
dont la partie web dérive de NiimBlue (MIT). Voir
src/lib/fichero/NOTICE.md. - Lecture des codes : ZXing (Apache 2.0).
- Icônes : Lucide (ISC). Polices : Inter, Source Serif 4, JetBrains Mono (OFL).


