Pièces et éléments

Un logement se compose de pièces, et une pièce contient des éléments : les équipements (chaudière, détecteur de fumée, four) et les surfaces (le mur nord, le sol) qu’il faudra un jour entretenir, réparer ou remplacer. Ce guide montre comment les décrire. Tous les champs sont facultatifs sauf le nom : on peut commencer par un nom et compléter le reste quand on a le document sous la main.

Ajouter les pièces

Ouvrez Pièces dans la navigation, puis Ajouter une pièce. Donnez-lui un nom et, si vous le souhaitez, un type. Changer l’ordre sur la liste place les pièces dans l’ordre voulu, par exemple celui du parcours dans la maison. Un espace comme le jardin ou la cave est une pièce comme une autre.

Noter la mémoire de la pièce

Sur la page d’une pièce, Modifier la mémoire garde ce qu’il faudrait sinon chercher plus tard : la peinture (couleur, marque, référence, lot, ce qu’il en reste et où), les revêtements de sol et de mur, et des notes libres. Prenez des photos avant de fermer un mur ou une gaine et ajoutez-les sous Murs ouverts : dans dix ans, elles disent où passent les câbles.

Ajouter les éléments

Ajouter un élément sur la page d’une pièce. Notez la marque, le modèle, le numéro de série, la date de pose et la fin de la garantie, le contrat d’entretien et un lien vers celui-ci, et tout lien qui mérite d’être gardé, comme la notice en ligne. La page de l’élément affiche une étiquette qui indique si la garantie court encore.

Si un élément est dans la mauvaise pièce, modifiez-le et choisissez une autre pièce : l’élément se déplace avec ses photos.

Ajouter des photos

On peut ajouter des photos à une pièce ou à un élément, depuis un téléphone ou un ordinateur. HouseCairn garde l’image et rien d’autre : la position, la date et toute autre information cachée dans le fichier sont supprimées, et une grande image est réduite à 2 560 pixels sur son plus grand côté. Seuls JPEG, PNG et WebP sont acceptés. Les images HEIC, que certains téléphones enregistrent par défaut, ne le sont pas : réglez l’appareil photo sur son format le plus compatible (JPEG) ou convertissez-les d’abord.

La limite par défaut est de 10 Mo par photo. L’administrateur la modifie avec la variable d’environnement HOUSECAIRN_PHOTO_MAX_BYTES, en octets, entre 10 240 (10 Ko) et 104 857 600 (100 Mo). Un reverse proxy placé devant HouseCairn peut avoir sa propre limite, plus basse, sur la taille d’une requête : relevez-la aussi. Les photos sont stockées dans le volume de données, dans media/photos/, et sont comprises dans la sauvegarde de ce volume (voir Données et sauvegardes).

Rechercher et partager

Le champ de recherche de la liste des pièces trouve une pièce ou un élément par son nom. Tout le monde dans le logement voit les mêmes pièces ; les membres en lecture seule voient tout et ne modifient rien. L’adresse d’une pièce ou d’un élément ne change jamais, quoi qu’on renomme ou déplace, et ne s’ouvre que pour les membres connectés du logement.

Les mêmes données sont accessibles aux scripts et aux intégrations par l”API : pièces, éléments et photos, avec les portées read et write d’un jeton d’API.