Export et suppression

Les données d’un logement appartiennent à ses propriétaires, qui peuvent les récupérer et les supprimer ; les données d’une personne sont effacées avec son compte (ADR 0023). L’administrateur de l’instance ne fait ni l’un ni l’autre pour un logement dont il n’est pas propriétaire.

Export d’un logement

Un propriétaire télécharge l’archive depuis la page du logement (Exporter toutes les données) ou depuis l’API (POST /api/v1/homes/<id>/export/, connecté ; un jeton d’API ne peut pas). L’export est inscrit au journal d’audit du logement.

L’archive est un fichier zip :

Élément	Contenu
export.json	Les données, au format JSON (ci-dessous).
files/	Les fichiers du logement, aux chemins que liste export.json : les photos, sous files/photos/.
README.txt	Un rappel du format.

export.json est versionné. La version 1 comporte ces clés :

Clé	Contenu
format, version	"housecairn-export" et 1. Un changement qui supprime ou renomme une clé augmente la version.
exported_at, application_version	Quand, et par quelle version.
home	id, name, currency, required_provider, created_at.
members	id, email, name, role, joined_at de chaque membre.
pending_invitations	id, email, role, sent_at, expires_at ; jamais de lien.
events	id, kind, payload, received_at des événements reçus.
rooms	id, name, kind, position, notes, created_at de chaque pièce, et sa mémoire memory (couleur, marque, référence, lot et reste de peinture, revêtements de sol et de mur, notes de mémoire).
items	id, room, name, kind, brand, model, serial_number, installed_on, warranty_ends_on, contract, contract_url, links, notes, created_at de chaque élément.
photos	id, room ou item, category, caption, content_type, size_bytes, width, height, created_at, et file, le chemin de la photo dans l’archive (files/photos/<id>.<extension>, ou null si le fichier manque).
files	path et size de chaque fichier de files/.

Les photos sont exportées telles qu’elles sont stockées, déjà dépouillées de leurs métadonnées au dépôt. Les miniatures ne sont pas exportées, ni rien de ce qui a été supprimé. L’archive n’a pas de plafond de taille propre : elle est aussi grosse que les photos du logement (chacune est limitée par HOUSECAIRN_PHOTO_MAX_BYTES).

Chaque lot qui ajoute des données ajoute sa section ici et dans l’archive. L’archive contient le logement pour lequel elle a été faite, et rien d’un autre.

Suppression d’un logement

Un propriétaire supprime le logement depuis sa page (Supprimer ce logement) : saisissez son nom exact. Le logement et tout ce qu’il contient disparaissent définitivement, pour tous ses membres : membres, invitations, événements, son journal d’audit et ses fichiers ; un jeton d’API resté sans logement est révoqué. Il n’y a ni délai de grâce ni retour en arrière : exportez d’abord. Le journal d’audit de l’instance enregistre qu’un logement a été supprimé, sans son nom.

Les photos sont effacées du disque avec le logement, celles déjà supprimées comprises. Si le disque refuse (droits, volume plein ou en lecture seule), le logement est quand même supprimé et l’erreur est journalisée par housecairn.files avec le chemin du répertoire (photos/<id du logement>) : supprimez ce répertoire à la main.

Effacement d’un compte

Supprimer mon compte (voir Pages du compte) efface le compte, ses méthodes de connexion, ses appareils et ses jetons d’API, les logements dont il est le seul membre, et les invitations envoyées à son adresse. L’effacement est refusé pour l’unique administrateur et pour l’unique propriétaire d’un logement qui a d’autres membres : transmettez d’abord la propriété, ou supprimez le logement. Le journal d’audit garde la trace de l’opération, sans plus dire qui.

Sauvegardes

Les données supprimées restent dans les sauvegardes jusqu’à leur expiration : indiquez aux gens combien de temps vous les conservez (voir Sauvegarde).

Modifier cette page sur GitHub Signaler un problème sur cette page