# AerariumChain Hub - Comment le Hub AerariumChain sert la collection : numérisation, étude et préservation à long terme, expliqués aux conservateurs, restaurateurs et historiens de l'art. Un seul fichier markdown avec tout le guide - donnez-le à ChatGPT, Claude ou à tout assistant et demandez comment utiliser le Hub AerariumChain. Source: https://docs.aerariumchain.com/fr/ (generated from the official AerariumChain documentation). --- # Ce qu'est l'AerariumChain Hub Chaque œuvre d'une collection possède une vie numérique : sa notice d'inventaire, sa forme en trois dimensions, sa surface photographiée jusqu'à la touche, ce que l'infrarouge et l'ultraviolet révèlent sous le vernis, et les copies de conservation qui devront nous survivre à tous. L'**AerariumChain Hub** (hub.aerariumchain.com) est le lieu où cette vie numérique est tenue ensemble, en ordre et à portée de main. Le Hub est conçu pour celles et ceux qui ont la charge des collections : conservateurs, restaurateurs, régisseurs, responsables de collections et historiens de l'art. Les campagnes de numérisation l'alimentent depuis les salles et les réserves ; le Hub transforme ce qui a été capté en un matériau que vous pouvez étudier, partager et préserver. ## Ce que le Hub fait pour la collection - **Il tient le registre.** Le [Catalogue](/fr/catalog/) garde la notice de chaque œuvre : numéros d'inventaire et de catalogue, matériaux et techniques, dimensions, garde et droits. Des listes de campagne entières arrivent par import Excel, avec des modèles que vous pouvez façonner au format propre à votre institution. - **Il reçoit la numérisation.** Tout ce que le [kit AerariumChain Scan](/fr/scan-kit/) capte sur place (numérisations 3D, photographie gigapixel, imagerie multispectrale) afflue dans le Hub, déjà rattaché à la bonne œuvre. - **Il prépare de lui-même le matériau pour l'étude.** Chaque téléversement 3D est [traité automatiquement](/fr/upload-and-processing/) : converti, texturé et optimisé, sans qu'aucun personnel technique ne soit requis de votre côté. - **Il ouvre l'œuvre à l'examen.** La [visionneuse 3D](/fr/3d-viewer/) et la [visionneuse Gigapixel](/fr/gigapixel/) fonctionnent dans un simple navigateur, sur n'importe quel appareil : le poste du cabinet d'étude, une tablette en réserve, un téléphone dans les salles. - **Il préserve.** Avec **DPAC** d'Ecomic, depuis le [Store](/fr/store/), les œuvres numérisées sont conditionnées, déposées et notarisées pour la MiC Digital Library. - **Il grandit avec vous.** Le [Store](/fr/store/) ajoute des applications au Hub à mesure que vos projets l'exigent. ## Comment l'accès s'organise Vous entrez dans le Hub avec votre compte AerariumChain, au sein de l'espace propre à votre institution (un espace personnel existe également). L'accès est gouverné par des **rôles** : un administrateur invite ses collègues depuis la page Team et décide des sections que chaque rôle peut voir, de sorte qu'un restaurateur, un régisseur et un chercheur extérieur travaillent chacun avec exactement ce qui les concerne. ## S'orienter : la barre latérale gauche | Section | Ce que vous y trouvez | |---------|-----------------------| | **Artwork Catalog** | Le registre des œuvres (Artwork Library) et l'import Excel (Import Data) | | **Site Manager** | Les données venues des chantiers de numérisation, les configurations d'acquisition et le téléchargement de l'application Site Manager | | **Acquisitions** | Les tableaux de bord des campagnes, les numérisations 3D, Gigapixel Studio et le téléchargement de l'application Scan | | **Gigapixel Gallery** | Les planches gigapixel publiées | | **3D Assets** | Chaque modèle 3D traité, avec ses versions et son historique | | **DPAC** | Le Package Manager de l'application de conservation DPAC | | **Store** | Les applications qui étendent votre Hub | Les administrateurs disposent en outre d'un **Worker Monitor**, la salle des machines du Hub, qui montre le [réseau de calcul](/fr/node-workers/) à l'œuvre. --- # Démarrage rapide Six étapes vous mènent d'une liste de campagne sur papier à une œuvre que vous pouvez tourner, agrandir et annoter à l'écran. ## 1. Connectez-vous Rendez-vous sur **hub.aerariumchain.com** et connectez-vous avec votre compte AerariumChain. Si votre institution vous a invité, acceptez d'abord l'invitation : votre rôle détermine les sections du Hub que vous verrez. ## 2. Choisissez votre institution Le sélecteur de l'en-tête liste les institutions auxquelles vous appartenez. Choisissez celle pour laquelle vous travaillez, ou restez dans votre espace personnel. ## 3. Faites entrer la liste de campagne Ouvrez **Artwork Catalog > Import Data** et téléversez le tableur de la campagne. Le Hub reconnaît de lui-même les colonnes du modèle DPAC ; ajustez tel ou tel appariement si votre liste diffère, enregistrez cet appariement comme modèle pour la prochaine campagne, puis confirmez. Les œuvres figurent désormais dans l'**Artwork Library**. La page [Catalogue](/fr/catalog/) explique chaque colonne. ## 4. Numérisez La capture a lieu dans les salles et les réserves avec le [kit AerariumChain Scan](/fr/scan-kit/) : - L'**application Scan** (téléchargée depuis **Acquisitions > Download App**) pilote le scanner 3D, l'appareil photographique gigapixel et la séquence multispectrale. - Une campagne structurée se conduit avec [Site Manager](/fr/site-manager/), qui tient la liste de ce qui manque encore à chaque œuvre. ## 5. Laissez le Hub faire le travail technique Les numérisations sont téléversées depuis l'application Scan ; un modèle isolé peut aussi être téléversé depuis **3D Assets**. De là, le Hub [traite tout automatiquement](/fr/upload-and-processing/) : conversion, textures, niveaux de détail. Vous pouvez suivre l'avancement depuis la vue de détail de l'œuvre, mais rien ne requiert votre intervention. ## 6. Étudiez et partagez Le traitement achevé, ouvrez le modèle dans la [visionneuse 3D](/fr/3d-viewer/) depuis n'importe quel appareil, ou la planche photographique dans la [visionneuse Gigapixel](/fr/gigapixel/). Tout demeure lié à la notice de l'œuvre dans le Catalogue. ## Pour aller plus loin - Déposez et notarisez les œuvres numérisées avec **DPAC** d'Ecomic, depuis le [Store](/fr/store/). - Lisez comment le [réseau de calcul](/fr/node-workers/) accomplit les gros calculs, et comment votre institution peut y prendre part. --- # Le kit AerariumChain Scan Le kit Scan est ce qu'AerariumChain apporte dans vos salles et vos réserves pour numériser une collection. Chaque technique du kit est **sans contact et en lumière froide** : l'œuvre n'est jamais touchée, ni exposée à un rayonnement plus nocif que celui des lampes d'examen ordinaires d'un restaurateur. Trois captures complémentaires construisent le dossier numérique de chaque pièce, toutes conduites avec l'application **AerariumChain Scan**, que vous téléchargez depuis le Hub. ## Trois manières de voir l'œuvre ### La forme : la numérisation 3D Des scanners professionnels à lumière structurée (Artec Eva pour les grands volumes, Artec Spider pour la ciselure fine et l'ornement, ou les deux ensemble) relèvent la forme tridimensionnelle exacte de la sculpture, des arts décoratifs et des objets, avec la couleur de leur surface. Le résultat est un corps numérique fidèle de l'œuvre, prêt pour le traitement automatique du Hub et pour l'étude dans la [visionneuse 3D](/fr/3d-viewer/). ### La surface : la photographie gigapixel Un appareil moyen format (le boîtier de référence est un **Fujifilm GFX100S II**, 102 mégapixels, avec un objectif macro de 120 mm ; les boîtiers Sony et Canon sont également pris en charge) photographie la surface en cellules qui se recouvrent, fusionnées ensuite en une planche unique de plusieurs milliards de pixels. L'opérateur indique la résolution voulue sur l'œuvre, en pixels par pouce, et l'application planifie et guide toute la séquence. La capture multi-prises **Pixel Shift** est disponible là où la fidélité la plus haute s'impose. Sur la planche achevée, vous lisez les craquelures, la trame de la toile, la touche même du pinceau. ### Sous la surface : l'imagerie multispectrale Avec un appareil moyen format converti à l'infrarouge et une séquence guidée de filtres, le kit enregistre l'œuvre bande par bande : visible, réflectographie infrarouge à 720 et 850 nm, et ultraviolet. Dessins sous-jacents, repentirs, repeints anciens et interventions postérieures, invisibles en lumière ordinaire, apparaissent dans les couches spectrales, qui demeurent attachées à l'œuvre dans le Hub. ## Une lumière et une couleur dignes de confiance - **Éclairage étalonné.** Des sources LED de studio JINBEI, commandées depuis l'application, dans la disposition classique à deux sources à 45 degrés : une lumière égale, répétable et douce. - **La couleur sous l'autorité du ColorChecker.** Chaque session comprend une charte ColorChecker Classic. L'application mesure la justesse des couleurs plage par plage en **Delta E 2000**, vérifie la balance des blancs et l'exposition, et archive le rapport colorimétrique avec la capture. Ce que vous voyez dans la visionneuse est ce qui se tenait sur le chevalet. - **Couverture vérifiée.** Visée en direct, analyse de la mise au point et du cadrage, et contrôle automatique du recouvrement réel des cellules gigapixel voisines. ## Du chevalet au Hub 1. Les sessions 3D sont conditionnées et téléversées de manière sécurisée ; le [traitement automatique](/fr/upload-and-processing/) du Hub en fait des modèles prêts pour l'étude. 2. Les captures gigapixel sont assemblées et publiées dans la [visionneuse Gigapixel](/fr/gigapixel/). 3. Chaque capture est rattachée à la notice de l'œuvre dans le [Catalogue](/fr/catalog/), afin que forme, surface et couches spectrales ne se dispersent jamais. Le kit s'utilise avec l'[application AerariumChain Scan](/fr/scan-app/) ; les campagnes se tiennent en ordre avec [Site Manager](/fr/site-manager/). --- # L'application AerariumChain Scan AerariumChain Scan est l'application de bureau qui conduit le travail du [kit Scan](/fr/scan-kit/) : elle pilote le scanner, les appareils photographiques et l'éclairage, tient chaque session en ordre et remet le tout au Hub. Elle fonctionne sous Windows et macOS et se télécharge directement depuis le Hub, de sorte que la version en usage sur le chantier est toujours la version courante. ## Télécharger et installer 1. Dans le Hub, ouvrez **Acquisitions > Download App**. 2. Choisissez votre plateforme : Windows, macOS Apple Silicon ou macOS Intel. 3. Installez, lancez, et connectez-vous avec le compte que vous utilisez dans le Hub. ## Les écrans de travail - **Dashboard** (tableau de bord) : ce qui est en cours de conditionnement et de téléversement à l'instant même, et ce qui est achevé. - **3D Scan** : ouvre une session pour une œuvre donnée, lance le logiciel de numérisation Artec et surveille le dossier de session ; dès que les fichiers de numérisation apparaissent, la session est marquée et ses métadonnées techniques recueillies automatiquement. - **Gigapixel** : planifie la séquence photographique. L'opérateur choisit le mode (rapide, guidé, rotation guidée, manuel ou libre) ; l'application calcule la grille de prises de vue d'après l'appareil, l'objectif et la résolution voulue sur l'œuvre, puis suit la progression cellule par cellule. - **Capture Studio** : la salle de prise de vue connectée. Visée en direct et commande à distance des boîtiers Fujifilm, Sony et Canon, multi-prises Pixel Shift, séquence guidée des filtres multispectraux, commande sans fil de l'éclairage de studio, et rapport colorimétrique ColorChecker. - **Upload** (téléversement) : conditionne les sessions 3D achevées en archives protégées et les remet ; le Hub enregistre chaque remise et lance le [traitement automatique](/fr/upload-and-processing/). - **Gigapixel Upload / Drive Upload** : remet les captures gigapixel, avec un flux prévu pour les grands chantiers où plusieurs stations de capture confient leurs sessions à un même disque externe ; seul ce que le Hub ne détient pas encore est téléversé. - **History** (historique) : chaque session et chaque remise, avec son état. - **Setup** (réglages) : préférences et chemins locaux (emplacement du logiciel de numérisation, dossiers de session). ## Comment elle se connecte L'application se connecte avec votre compte AerariumChain et dialogue avec le Hub. Les collections auxquelles vous pouvez remettre des captures sont celles auxquelles votre compte a accès. Les remises sont vérifiées (par somme de contrôle), protégées et envoyées directement vers un stockage cloud sécurisé ; le Hub rattache ensuite chacune d'elles à la bonne œuvre du [Catalogue](/fr/catalog/). ## Plusieurs stations, une seule campagne Sur les grands chantiers de numérisation, plusieurs stations captent en même temps. La remise par disque rassemble les sessions de chaque machine, les compare avec ce que le Hub détient déjà et n'envoie que ce qui manque : rien n'est remis deux fois, rien n'est laissé en arrière. --- # Site Manager Une campagne de numérisation est, avant toute chose, une liste d'œuvres et une discipline : quelles pièces demandent la 3D, lesquelles demandent le gigapixel, ce qui est déjà fait, ce que dit la fiche de relevé de chaque objet. **AerariumChain Site Manager** est l'application de bureau qui tient cette discipline sur le chantier. Elle fonctionne sous Windows et macOS, se télécharge depuis le Hub et travaille **entièrement hors ligne** dans les salles et les réserves, avec des copies de sauvegarde locales automatiques ; seules l'ouverture de session et la remise finale au Hub requièrent une connexion. ## Télécharger et installer 1. Dans le Hub, ouvrez **Site Manager > Download App**. 2. Choisissez Windows, macOS Apple Silicon ou macOS Intel. 3. Installez, lancez, et connectez-vous avec votre compte AerariumChain. ## Ce qu'il tient en ordre ### La liste des œuvres La liste de campagne arrive d'Excel par une étape guidée d'appariement des colonnes. Chaque œuvre porte sa liste de contrôle de numérisation : 3D requise, gigapixel requis, et ce qui est déjà accompli (3D, gigapixel, photographie, fiche de relevé). Filtres, recherche, vues par emplacement et chiffres d'avancement en direct gardent lisible même une campagne de plusieurs milliers de pièces. ### La fiche de relevé (scheda di rilievo) Une fiche de relevé complète pour chaque œuvre, avec des valeurs par défaut configurables et la composition automatique de l'identifiant d'objet, exportée fidèlement vers le modèle Excel officiel en usage dans les institutions de conservation. ### Les configurations d'acquisition Des descriptions nommées de la manière dont les œuvres sont captées (quel scanner, quelle disposition). Des préréglages pour les scanners Artec remplissent correctement, à chaque fois, les champs d'équipement de la fiche de relevé. ### Les paquets Pour chaque œuvre, Site Manager exporte un paquet comprenant le fichier de métadonnées, le tableur de la fiche de relevé et les photographies, accompagnés d'un classeur maître d'état pour l'ensemble du chantier et d'un rapport des modifications. Les paquets suivent le format de données DPAC : ils sont donc déjà conformés pour la conservation. ### Les communications Des lettres d'avancement, générées : tout ce qui a changé depuis la dernière communication, prêt à relire et à envoyer. ## La remise au Hub Quand le chantier (ou une portion du chantier) est prêt, Site Manager le remet au Hub : le classeur maître, toutes les fiches de relevé, les configurations, les photographies et l'historique complet des commentaires. Avant l'envoi, il montre précisément en quoi la remise diffère de ce que le Hub détient déjà, et signale tout conflit de nom de configuration, si bien que vous savez toujours si vous créez ou si vous mettez à jour. Dans le Hub, le chantier apparaît sous **Site Manager**, et ses œuvres prennent leur place dans le [Catalogue](/fr/catalog/). --- # Catalogue L'**Artwork Catalog** est le registre de la collection au sein du Hub : une notice par œuvre, et autour de chaque notice tout ce que les campagnes ont produit. Il compte deux pages dans la barre latérale : **Artwork Library**, où vous consultez et gérez les notices, et **Import Data**, où des listes de campagne entières arrivent d'Excel. Chaque modèle 3D, chaque planche gigapixel et chaque remise de chantier peut être rattaché à une notice, afin que le catalogue demeure ce qu'il doit être : le fil qui tient ensemble l'œuvre et sa documentation. ## Artwork Library Un tableau clair de toutes les œuvres de l'institution sélectionnée, avec pagination, tri, recherche, et un filtre pour les notices auxquelles un matériau numérisé est déjà rattaché. Les colonnes peuvent être affichées, masquées et redimensionnées ; la disposition que vous choisissez est mémorisée, si bien que régisseurs et conservateurs peuvent garder chacun leur propre vue. ### Les colonnes, avec le modèle DPAC pour exemple Les colonnes suivent le modèle choisi pour la collection. Un bon exemple de ce que le Catalogue peut contenir est le modèle utilisé par **DPAC**, l'application de conservation d'Ecomic pour la MiC Digital Library (disponible dans le [Store](/fr/store/)) : avec lui, le tableau se lit comme la feuille Excel DPAC officielle, de l'identification aux données de capture. Toutes les colonnes gérables, groupées comme dans ce modèle : | Groupe | Colonnes | |--------|----------| | Identification | ODA_Id, Inventario (catalog id), Numero di Catalogo, ESC, TSK, Fondo/Collezione, Descrizione, Nome Opera | | Chantier et lot | Codice Cantiere, Codice Lotto, PK, Label | | Propriétés physiques | Material, Techniques, Width, Height, Length, Depth, Diameter, Weight | | Conservation et localisation | Conservation, Location / Luogo | | Garde et droits | Custodian, Creating Organization, IP Owner, OBJID / DocumentID, logicalId, conservativeId, conservativeIdAuthority, recordContentSource, RightsHolderName, RightsHolderContactEmail, FolderLabel | | Équipement d'acquisition | Acquisition Method, Acquisition Manufacturer, Equipment model, Processing software, Processing software version | | Données de capture | scanCount, frameCount, resolution, resolution unit, lighting, imageCount | | Optique et exposition | focalLength, focalLength unit, aperture, exposureTime, exposureTime unit, iso | | Livrables du chantier | Photos S3 Paths, Scanner, 3D Done, Gigapixel Done, Scheda Done | | Champs génériques | Author, Art ID, Date, Purpose, Medium, Frame, Sign, Sign date, Note, Complexity index, Lot name | ## Import Data La page d'import fait entrer dans le registre le tableur d'une campagne entière : 1. **Téléversez** le fichier Excel (.xls / .xlsx). 2. **Appariez les colonnes.** Chaque colonne du tableur est associée à un champ du catalogue. Le Hub reconnaît de lui-même les intitulés du modèle DPAC, en italien comme en anglais ; toute association peut être corrigée à partir de la liste de tous les champs du catalogue. 3. **Relisez avant de valider.** Les lignes extraites sont d'abord présentées. En mode ajout, les nouvelles notices viennent s'ajouter ; en mode remplacement, le Hub énonce clairement quelles notices seraient créées, lesquelles mises à jour, lesquelles supprimées. Les lignes peuvent être corrigées, ajoutées ou rayées sur-le-champ. 4. **Enregistrez**, et les notices prennent leur place dans le registre. La page conserve aussi le dernier fichier importé et les tableurs remis par [Site Manager](/fr/site-manager/), tous deux téléchargeables : la trace écrite de la campagne. ## Des modèles façonnés à votre institution Les appariements de colonnes peuvent être enregistrés comme **modèles**, de sorte qu'un format récurrent s'importe d'un seul geste : - **Créez** l'appariement une fois, puis enregistrez-le avec un nom et une description. Un modèle retient les associations de colonnes, la ligne d'en-têtes et le nom de la feuille, et peut être défini comme modèle par défaut. - **Appliquez-le** à l'import suivant : l'appariement tout entier se remplit de lui-même. - **Gérez** les modèles librement ; ils peuvent être relus et supprimés à tout moment. Le modèle DPAC est reconnu d'emblée. Les modèles personnalisés étendent la même courtoisie à la tradition de tableur de votre institution, quelle qu'elle soit : le Hub s'adapte à votre registre, et non l'inverse. --- # Téléversement 3D et traitement automatique Entre le scanner et un modèle que vous pouvez étudier s'étend une chaîne de travail technique : conversions de format, gestion des textures, optimisation pour l'écran. Dans le Hub, cette chaîne se déroule d'elle-même. Votre part s'achève à la remise de la capture. ## Comment un modèle parvient au Hub - **Depuis l'application Scan.** Les sessions de numérisation achevées sont remises directement par l'[application AerariumChain Scan](/fr/scan-app/) ; le Hub enregistre chaque remise et se met au travail. - **Depuis le navigateur.** Dans **3D Assets**, la fenêtre de téléversement accepte les fichiers par glisser-déposer : utile pour les modèles produits ailleurs ou reçus en prêt de données. Formats de modèle acceptés : **OBJ, PLY, STL, GLB, OFF**, avec matériaux **MTL** et textures **JPG, PNG, BMP**. Les transferts vont vers un stockage cloud protégé ; les grands modèles voyagent en parties parallèles, si bien que même les numérisations lourdes arrivent promptement. ## Ce que le Hub fait de lui-même Dès qu'une remise est enregistrée, le [réseau de calcul](/fr/node-workers/) prend le relais : - **Conversion** de tout format accepté vers la forme que la visionneuse diffuse le mieux, et retour vers les formats de travail quand il le faut. - **Textures** préservées, compressées et repréparées lorsque c'est nécessaire, afin que la couleur captée sur le chevalet survive intacte. - **Niveaux de détail.** Plusieurs versions graduées de chaque modèle sont préparées, avec des textures mises à l'échelle en proportion, pour que la [visionneuse](/fr/3d-viewer/) serve avec une égale aisance un téléphone dans les salles et une station de travail dans le cabinet d'étude. - **Planches et aperçus.** Des vues tournantes, en pleine couleur et en relief neutre, illustrent chaque modèle dans la liste. - **Traitement des numérisations.** Les sessions brutes du scanner sont résolues en maillages achevés sur des nœuds équipés du logiciel Artec. ## Suivre le travail Chaque élément de **3D Assets** montre ses versions et les étapes qui les ont produites, chacune marquée achevée, échouée ou annulée. Quand la dernière étape se clôt, **View 3D** ouvre la [visionneuse](/fr/3d-viewer/). Les dérivés de conservation produits par **DPAC** (Ecomic) apparaissent ici également. Tant qu'un paquet DPAC citant un dérivé est en cours de dépôt, ou une fois qu'il a été notarisé, ce dérivé est verrouillé contre la suppression : le dossier de conservation reste entier. ## Lié au Catalogue Chaque remise est rattachée à la notice de l'œuvre qu'elle numérise. Depuis le [Catalogue](/fr/catalog/), vous atteignez les modèles d'une œuvre ; depuis un modèle, vous savez toujours à quelle œuvre il appartient, et sous la garde de qui il se trouve. --- # La visionneuse 3D La visionneuse est le lieu où l'œuvre numérisée se soumet à l'examen. Elle s'ouvre dans un simple navigateur et, parce que le rendu s'accomplit dans le cloud et que seule l'image est diffusée vers votre écran, **même le modèle le plus lourd, en pleine résolution, s'ouvre à l'instant sur n'importe quel appareil** : la station du cabinet d'étude, un iPad en réserve, un téléphone devant l'original. Rien n'est téléchargé sur l'appareil, ce qui signifie aussi que le modèle lui-même ne quitte jamais la garde du Hub : un point qui compte lorsque droits et reproduction sont en jeu. Ouvrez-la avec **View 3D** depuis n'importe quel modèle de **3D Assets**, ou depuis la notice de l'œuvre dans le [Catalogue](/fr/catalog/). ## Tourner l'œuvre entre vos mains - **Faites pivoter** et **déplacez**, au toucher et au pincement sur tablettes et téléphones. - **Zoomez** jusqu'aux traces d'outil, reculez jusqu'à la figure entière ; la **réinitialisation** ramène à la vue canonique. - **Choisissez le centre** de rotation et enregistrez-le comme présentation par défaut de l'œuvre. - **Outils de pivot** pour un placement précis, avec la possibilité d'enregistrer une nouvelle version du modèle à partir de l'état ajusté. ## Annoter constats d'état et observations - **Des commentaires ancrés à la surface** : un point unique, ou une zone dessinée (à plat, ou épousant le relief), chacun dans sa propre couleur. Un constat d'état, une question d'attribution, une consigne au restaurateur : chacun demeure exactement là où il doit être, et la discussion reste avec lui. - **Révision** : les collections qui soumettent les numérisations entrantes à un examen formel peuvent approuver ou rejeter chacune d'elles depuis la visionneuse. ## Coupes et détails En mode éditeur, la visionneuse sert les questions les plus exigeantes du restaurateur : - Sélection au **lasso**, au **rectangle**, par **plan de base** ou de l'**objet entier**. - Coupes à travers la seule face avant, ou à travers tout le corps de l'objet ; les sélections peuvent être inversées. - **Annulation et rétablissement** complets, avec récupération des sessions non enregistrées. - **Export** de la coupe en fichier de travail (OBJ avec matériaux et texture), ou adoption de la coupe comme état par défaut du modèle. ## Couches et vues spectrales - **Superposition de plusieurs modèles** dans une même scène : états avant et après traitement, fragments recomposés, moulages confrontés aux originaux. - **Vue multispectrale** : lorsque des captures spectrales existent, la même œuvre peut basculer vers ses couches infrarouges et ultraviolettes, et le dessin sous-jacent se lire en place. ## La notice à portée de main Un panneau latéral garde en vue les détails du modèle et son historique de traitement, et la notice complète de l'œuvre (inventaire, matériaux, dimensions, droits) est à un pas dans le [Catalogue](/fr/catalog/). La visionneuse montre l'objet ; le registre en répond. --- # Impression 3D **3D Print** transforme les modèles 3D de votre collection en objets physiques : répliques muséales pour les expositions et les prêts, reproductions tactiles avec étiquette en braille pour les visiteurs aveugles et malvoyants, séries pour la boutique. Vous décrivez votre besoin ; les ateliers certifiés du réseau AerariumChain envoient des devis concurrents ; vous choisissez, payez et suivez la production et l'expédition depuis le Hub. Vos fichiers 3D ne quittent jamais AerariumChain. Les ateliers établissent leur devis à partir d'une image et des mesures calculées par le Hub ; seul l'atelier choisi reçoit un fichier prêt à imprimer, préparé par AerariumChain, unique pour votre commande et traçable. L'interface de l'application est en anglais pour cette langue : les libellés ci-dessous sont indiqués tels qu'ils apparaissent. ## Installer depuis le Store 1. Ouvrez **Store** dans la barre latérale du Hub et sélectionnez la carte **3D Print**. 2. Lisez la fiche et choisissez **Install** (installer). 3. **3D Print** prend place dans la barre latérale. Ouvrez-la quand vous en avez besoin : elle fonctionne dans le Hub, sur l'institution sélectionnée en haut. ![La carte 3D Print dans le Store du Hub](/downloads/3d-print-en-01-store.png) ![La fiche 3D Print avec l'action Install](/downloads/3d-print-en-02-installa.png) Pour commander, il faut une institution (pas le compte personnel) et le droit d'agir pour elle : les administrateurs de l'institution l'ont, et peuvent l'accorder à d'autres membres avec la permission **3D Print** dans les rôles de l'équipe. ## Données de facturation Avant d'accepter un devis, complétez une fois pour l'institution les **Billing details** (données de facturation) : raison sociale, pays, numéro de TVA ou code fiscal, siège et adresse de livraison par défaut. Les organismes publics italiens cochent **Public body** et indiquent le code de l'office. Le pays détermine le vendeur : les institutions situées aux États-Unis achètent auprès d'**AerariumChain Corp.** en dollars ; toutes les autres auprès de **WEREA S.r.l.** en euros. ![Les données de facturation de l'institution](/downloads/3d-print-en-04-fatturazione.png) ## Une nouvelle demande Choisissez **New request** (nouvelle demande). Quatre étapes : 1. **Model** : choisissez un modèle 3D de la collection de l'institution. 2. **Type** : **Museum replica** (réplique muséale), **Tactile reproduction** (reproduction tactile) ou **Gadget & shop** (boutique). 3. **Configure** : quantité, échelle, matériau, finition (brute ou poncée), protection transparente facultative, étiquette en braille et socle pour les pièces tactiles, notes pour l'atelier. Confirmez les dimensions de l'original : le Hub les mesure à partir du modèle et de la fiche de catalogue. 4. **Review** : vérifiez et envoyez. ![Le choix du modèle](/downloads/3d-print-en-05-modello.png) ![Le choix du type d'impression](/downloads/3d-print-en-06-tipologia.png) ![La configuration, avec l'aperçu 3D et les dimensions de l'original](/downloads/3d-print-en-07-configurazione.png) ### Pourquoi la mise en couleur n'est pas incluse Les prix excluent la mise en couleur et la patine. La mise en couleur se fait à la main, et le passage du modèle numérique au travail manuel peut introduire des écarts de ton et de couleur : elle revient à un restaurateur expérimenté, en coordination avec votre conservateur. Les impressions arrivent brutes ou poncées, prêtes pour ce travail. Si vous avez aussi besoin de la mise en couleur, indiquez-le dans les notes : nous vous mettrons en relation avec l'atelier de restauration le plus proche. ## Comparer les devis La demande parvient aux ateliers certifiés dont les machines et les matériaux conviennent. Chaque devis indique le prix hors TVA, le délai et la validité ; les ateliers apparaissent comme **Offer A**, **Offer B** et ainsi de suite, car le vendeur responsable de la commande est WEREA S.r.l. (ou AerariumChain Corp.). Vous recevez un e-mail à chaque nouveau devis. ![Les devis reçus pour une demande](/downloads/3d-print-en-09-preventivi.png) ## Accepter et payer Choisissez **Accept** sur l'offre retenue. Sélectionnez le mode de paiement, vérifiez l'adresse de livraison, lisez les conditions de vente et acceptez-les avec le nom et la fonction du signataire. - **Credit card** : vous payez immédiatement et la production démarre au paiement. - **Bank transfer** : vous recevez un bon de commande avec les coordonnées bancaires et le code de commande à indiquer. - **Acquisti in Rete PA (MePA)** : pour les organismes publics italiens. ![L'acceptation d'un devis : paiement, livraison et conditions de vente](/downloads/3d-print-en-10-accetta.png) ## Suivre la commande **Orders** liste chaque commande avec son état de paiement et de production. Dans la commande, vous trouvez l'avancement, l'historique, les montants avec le régime fiscal appliqué et l'**Order document**. Au départ du colis apparaissent le transporteur et le numéro de suivi : choisissez **Confirm receipt** à l'arrivée. ![Une commande en production](/downloads/3d-print-en-11-ordine.png) ## La protection de vos modèles - Les ateliers ne téléchargent jamais vos modèles : pas même un aperçu pendant l'établissement du devis. - Le fichier remis à l'atelier choisi est préparé par AerariumChain pour cette seule commande : à l'échelle, positionné pour l'impression et marqué de sorte que le fichier, et même une copie imprimée, puissent être rattachés à la commande. - Les ateliers sont liés par un accord-cadre avec WEREA S.r.l. : confidentialité, interdiction de réutilisation, suppression du fichier après la livraison et pénalités pour toute copie au-delà de la commande. --- # Gigapixel Studio et la visionneuse La photographie gigapixel enregistre la surface d'une œuvre en cellules haute résolution qui se recouvrent, puis les fusionne en une planche unique de plusieurs milliards de pixels : le tableau entier en une seule image, et dans la même image les craquelures, la trame, le poil même du pinceau. Dans le Hub, **Gigapixel Studio** gouverne le passage des cellules captées à la planche achevée, et la **visionneuse Gigapixel** ouvre cette planche à qui vous voulez, sur n'importe quel appareil. ## Gigapixel Studio **Acquisitions > Gigapixel Studio** liste chaque capture gigapixel de l'institution, de la fraîchement remise (cellules brutes) à la finalisée (planche prête). Chaque capture est rattachée à son œuvre dans le [Catalogue](/fr/catalog/). Ouvrir une capture fait entrer dans l'atelier, qui procède comme un restaurateur le voudrait : posément, et la couleur d'abord. 1. **Rassembler.** Relisez les cellules remises, la vue d'ensemble et la référence ColorChecker de la session. 2. **Étalonner.** Le profil colorimétrique se construit à partir de la capture du ColorChecker, si bien que la planche entière répond à un étalon mesuré, non au goût. 3. **Aligner.** Les cellules voisines s'alignent automatiquement ; un éditeur de points de contrôle permet la correction fine là où la surface l'exige, avec un aperçu de l'ajustement. 4. **Affiner.** L'accentuation de la capture est pesée cellule par cellule ; les candidates sont comparées et la meilleure retenue. 5. **Prévisualiser.** La planche assemblée s'inspecte avant tout engagement définitif. 6. **Assembler.** La fusion finale s'exécute sur le [réseau de calcul](/fr/node-workers/) et produit un **TIFF maître 16 bits**, la planche d'archive, ainsi que la version tuilée que la visionneuse diffuse. La publication est automatique. Lorsqu'une planche achevée a été produite ailleurs, elle peut être déposée directement au format TIFF. ## La visionneuse Gigapixel La visionneuse ne diffuse que les tuiles de la région et du grossissement que vous regardez ; c'est pourquoi une planche de cent gigapixels se meut avec fluidité **sur n'importe quel appareil**, téléphones compris. Vous voyagez continûment de la composition entière aux craquelures, comme si vous marchiez vers le tableau sans que l'on vous demande jamais de vous arrêter. Les planches fraîchement assemblées s'ouvrent en mode diffusé avant même que leurs tuiles ne soient entièrement préparées. La **Gigapixel Gallery** de la barre latérale rassemble les planches publiées de l'institution, chacune ramenant à son œuvre dans le [Catalogue](/fr/catalog/), auprès de la forme 3D et des couches spectrales de la même pièce. --- # Le réseau de calcul Derrière chaque modèle qui s'ouvre à l'instant et chaque planche assemblée pendant la nuit se tient le **réseau de calcul AerariumChain** : un corps distribué de nœuds de calcul (les workers), coordonné par le Hub, qui porte tout le lourd travail technique afin qu'aucun musée n'ait à l'entretenir seul. ## Ce qu'il porte - La conversion de format, les textures et les niveaux de détail de chaque remise 3D. - La résolution des sessions brutes du scanner en maillages achevés. - Le profilage colorimétrique, l'alignement et l'assemblage final des planches gigapixel. - Les dérivés de conservation conditionnés par **DPAC** (Ecomic). - Le rendu cloud derrière la [visionneuse 3D](/fr/3d-viewer/) : chaque session de consultation est servie en direct par un nœud du réseau. Chaque remise ou requête devient une tâche ; les nœuds déclarent ce dont ils sont équipés (processeurs graphiques, logiciels installés), reçoivent les tâches qui leur correspondent, et le Hub équilibre la file, reprend ce qui échoue et tient le registre. Le matériau sensible ne quitte jamais la chaîne AerariumChain. Les administrateurs observent tout cela dans le **Worker Monitor** : les nœuds en ligne, leur charge et leur température, la file d'attente, l'historique des tâches. Chaque nœud peut être réglé, admis à certaines familles de travaux et exclu d'autres. ## Une infrastructure partagée pour le patrimoine Le réseau est conçu pour croître comme une **infrastructure commune**, à la manière dont les grands chantiers de conservation ont toujours été partagés. Musées, institutions publiques, organismes de recherche et entreprises partenaires peuvent le rejoindre en opérant un nœud : - **Qui peut rejoindre le réseau** : institutions, organismes de recherche, musées et entreprises partenaires d'AerariumChain. - **Ce qu'un nœud apporte** : du temps de calcul pour le traitement et le rendu, coordonné automatiquement par le Hub. - **Ce qu'un membre reçoit** : de la capacité de traitement pour ses propres collections, et une place dans un réseau dont la raison d'être est la sauvegarde du patrimoine. Une institution désireuse d'opérer un nœud peut s'adresser à AerariumChain via [aerariumchain.com](https://aerariumchain.com). --- # Store Le **Store** est le lieu où le Hub acquiert de nouvelles capacités. Ouvrez-le depuis la barre latérale gauche : chaque application se présente comme une carte ; en sélectionner une ouvre sa fiche, avec une description, ce qu'elle offre et l'action **Install** (installer). ## Installer une application 1. Ouvrez **Store** dans la barre latérale gauche. 2. Sélectionnez la carte de l'application pour lire sa fiche. 3. Choisissez **Install**. Les applications installées prennent leur place dans la barre latérale, prêtes à l'usage. Les applications marquées **Coming soon** (prochainement) annoncent ce qui arrive et ne peuvent pas encore être installées. Que le Store vous apparaisse ou non dépend de votre rôle : les administrateurs décident quels rôles de l'institution y ont accès. ## DPAC, d'Ecomic **DPAC (Digital Preservation and Access Console)**, d'**Ecomic**, est la première application installable du Store, construite pour la **MiC Digital Library** du ministère italien de la Culture. Elle est le pont entre la collection numérisée et sa conservation à long terme : - Elle définit le **modèle de catalogue DPAC**, le format de tableur que le [Catalogue](/fr/catalog/) du Hub et Import Data reconnaissent nativement, si bien que le registre se lit comme la feuille officielle. - Son **Package Manager** assemble des paquets de conservation à partir des œuvres numérisées, les dépose dans la Digital Library et les **notarise** : une attestation certifiée et infalsifiable que le dépôt a bien eu lieu. - Le Hub suit chaque paquet (en dépôt, déposé, notarisé) et protège les dérivés conditionnés contre la suppression aussi longtemps qu'un paquet les cite : le dossier de conservation ne peut être défait en silence. - Le lourd travail de conditionnement est accompli par le [réseau de calcul](/fr/node-workers/) du Hub lui-même ; rien n'est demandé à vos machines. Une fois installée, DPAC se tient dans la barre latérale avec son Package Manager. ## Impression 3D, par AerariumChain **3D Print** commande des impressions physiques de vos œuvres aux ateliers certifiés AerariumChain, directement à partir de leurs modèles 3D : répliques muséales, reproductions tactiles en braille, séries pour la boutique. Les ateliers sont mis en concurrence ; vous payez par carte ou par virement, et vos fichiers 3D ne quittent jamais AerariumChain. Une fois installée, elle prend place dans la barre latérale. Voir le [guide Impression 3D](/fr/3d-print/). ## Coming soon Le rayon s'agrandit. Applications déjà annoncées : | Application | Ce qu'elle offrira | |-------------|--------------------| | **museAR** | La réalité augmentée construite à partir de vos œuvres numérisées : modèles, annotations et récits déployés sur la collection physique. Par AerariumChain. | | **MyTotem Manager** | Des totems tactiles interactifs pour les salles, composés depuis votre Catalogue et déployés sur site à distance. | | **VideoRender Maker** | Des films de présentation des modèles 3D : vues tournantes, trajectoires de caméra et éclairages, rendus dans le cloud. | | **Image Render Maker** | Des planches de qualité publication des œuvres numérisées, pour les catalogues, l'imprimé et le service de presse. | | **SweetReach** | De courts films tirés de la collection, publiés sur vos canaux, avec leurs campagnes planifiées et suivies. | D'autres applications rejoignent le Store à mesure que de nouveaux partenaires montent à bord. --- # DPAC T2 Generator Le **AerariumChain DPAC T2 Generator** est une application de bureau (macOS et Windows, sous licence) qu'AerariumChain met à la disposition des prestataires de numérisation et de la Digital Library. Elle construit les **paquets de mise à jour T2** des objets 3D et des gigapixels, les vérifie avant la compression, les écrit sur un disque externe et délivre un **certificat de vérification** avec le journal de tous les contrôles et les documents de paradonnées en annexe. Un paquet T2 est un *delta* sur le paquet T1 déjà ingéré par DPAC : il contient le METS mis à jour (`RECORDSTATUS="UPDATE_3D"`, ID d'en-tête égal à l'UUID de la ressource attribué par DPAC), le dossier des **paradonnées** (le rapport de configuration de l'acquisition et le rapport de traitement) et le dossier **RAW_3D** avec les données brutes d'acquisition. Les images déjà présentes dans le T1 (la vignette et les vues de rendu) sont remises aussi dans le T2, copiées octet par octet depuis le paquet T1 et vérifiées avec les sommes de contrôle du METS ; master et dérivé restent des références (option : images seulement, tous les fichiers du T1, aucun). L'outil a deux parties : un **constructeur** (une procédure guidée) et un **vérificateur** (l'interface de contrôle avec les panneaux des paquets générés et échoués). Tout ce que fait la fenêtre peut aussi être piloté par une **API HTTP locale**, afin qu'un prestataire puisse intégrer le packager à son propre système et garder l'interface pour le travail manuel sur le PC. ## Installation, connexion et licence L'application ne fonctionne qu'avec un **compte du Hub AerariumChain** et une **licence active**. Le titulaire de la licence (pour la Digital Library, AerariumChain) décide quels comptes peuvent l'utiliser et sur combien d'ordinateurs. **Télécharger l'installateur.** Sur le Hub, menu **DPAC → DPAC T2 Generator**, la page affiche la licence du compte et les boutons pour macOS (Apple Silicon ou Intel) et Windows. Le téléchargement est enregistré au nom du compte. Sans licence active, les boutons sont désactivés. **macOS.** Ouvrir le fichier `.dmg` et faire glisser l'application dans Applications. L'application est signée et notarisée par Apple : elle s'ouvre sans avertissement. Si macOS affiche quand même un message d'application non vérifiée (par exemple pour un fichier copié depuis une clé USB), ouvrir **Réglages Système → Confidentialité et sécurité** et choisir **Ouvrir quand même**, ou faire un clic droit sur l'application → **Ouvrir**. **Windows.** Lancer `AerariumChain DPAC T2 Generator Setup .exe` et suivre l'installation (le dossier peut être choisi). Tant que l'installateur n'est pas signé avec le certificat de signature de code Windows, l'un de ces messages peut apparaître : | Message | Que faire | |---|---| | **« Windows a protégé votre ordinateur »** (Microsoft Defender SmartScreen) | cliquer sur **Informations complémentaires**, vérifier que l'application est « AerariumChain DPAC T2 Generator », puis **Exécuter quand même** | | Le navigateur signale le fichier comme **« rarement téléchargé »** | dans la liste des téléchargements choisir **Conserver** (Edge : … → Conserver → Afficher plus → Conserver quand même) | | **« Contrôle intelligent des applications a bloqué une application »** | avec le Contrôle intelligent des applications actif, Windows n'ouvre pas les applications non signées : [contactez-nous](https://aerariumchain.com/fr/contact/) pour la version signée. L'état se trouve dans **Sécurité Windows → Contrôle des applications et du navigateur → Contrôle intelligent des applications** | | L'antivirus de l'entreprise met le fichier en quarantaine | demander à l'administrateur informatique d'autoriser l'installateur et le dossier de l'application | **Premier lancement.** L'application affiche le **contrat de licence** (EULA) à accepter, puis demande la connexion avec le compte du Hub : la même session lit les données du Hub, sans seconde connexion. Le code de licence, le titulaire et l'échéance apparaissent en haut ; le même code figure sur le certificat et dans le paquet de vérification de chaque paquet construit. **Licence.** Chaque ordinateur sur lequel on se connecte occupe une installation de la licence (rouvrir l'application sur le même ordinateur n'en consomme pas d'autre). La licence est renouvelée en ligne toutes les 30 minutes ; sans réseau, l'application fonctionne jusqu'à 72 heures. À l'échéance, ou si elle est suspendue, l'application se bloque et indique qui contacter. **Mises à jour.** Les nouvelles versions se téléchargent seules et s'installent au redémarrage (voir plus bas). ## Ce que l'outil produit Pour chaque paquet, le disque de destination reçoit un dossier portant le nom de la livraison, de sorte que la liste se lit une ligne par œuvre : ``` /CANTIERE_LOTTO_PK_T2/ CANTIERE_LOTTO_PK_T2.zip la livraison pour la Digital Library CANTIERE_LOTTO_PK_T2_CERTIFICATO.pdf certificat de vérification CANTIERE_LOTTO_PK_T2_VERIFICA.zip le lot de vérification pour le contrôle qualité (voir ci-dessous) CANTIERE_LOTTO_PK_T2/ la livraison non compressée, du même nom que le ZIP (sur laquelle tournent les contrôles) .xml METS T2 (UPDATE_3D, UUID DPAC, SIZE et MD5 réels) _PARADATA_3D/ configuration d'acquisition / fiche de relevé et rapport de traitement (PDF) _RAW_3D/ données brutes : export Artec (PLY + photos), fichiers, conteneur .acraw ou projet original _Thumbnail_3D/ vignette déjà dans le T1, remise dans le T2 _6ViewImages_3D/ vues de rendu déjà dans le T1, remises dans le T2 CANTIERE_LOTTO_PK_T2_VERIFICA/ le lot de vérification non compressé, du même nom que son ZIP ``` Le ZIP de livraison ne contient que le contenu du dossier `CANTIERE_LOTTO_PK_T2/`. Tout le reste reste hors de la livraison. Pour un **gigapixel** (matériel HQ de D.PaC), le T2 a la même forme : le METS du T1 gigapixel avec le statut de mise à jour (`UPDATE_HQ`, ou `UPDATE_2D` si la Digital Library le demande : à choisir dans les Paramètres), les dossiers `_PARADATA_HQ` et `_RAW_HQ`, et comme données brutes les **images d'entrée du photomosaïque en RAW DNG** avec au moins une prise de vue avec le **ColorChecker**, comme le demande le Ministère. Le rapport de traitement décrit l'assemblage, l'alignement, la calibration des couleurs et l'image maître. La structure du paquet, la transformation du METS et les règles de somme de contrôle sont celles du pipeline du Hub AerariumChain : un paquet construit avec l'outil est identique à un paquet produit par le Hub. ![La vue de vérification : le paquet examiné, les paquets générés et ceux qui ont échoué avec leurs problèmes](/downloads/dpac-t2-verifica.png) ## Construire un paquet à la main La section **Créer un paquet T2** est une procédure en cinq étapes. 1. **METS T1** : le METS exact ingéré avec le T1, depuis un fichier local, une URL, ou lu directement sur le **Hub AerariumChain** (connexion avec les identifiants du Hub, choix de la hive et de l'œuvre : l'outil télécharge le METS T1, l'UUID DPAC, la fiche de relevé du Site Manager et l'état du dérivé). Avec le T1 arrive aussi son paquet (depuis le hub seules les entrées nécessaires sont lues), d'où la vignette et les vues de rendu sont remises dans le T2. 2. **Identification** : code de chantier, code de lot et PK (ils nomment le ZIP), le préfixe du paquet (il nomme le METS et les dossiers), l'**UUID de la ressource attribué par DPAC** après l'ingestion du T1, titre et numéro d'inventaire. 3. **Paradonnées** : les deux rapports peuvent être générés à partir des formulaires (l'outil reproduit les modèles MiC) ou joints comme PDF prêts ; d'autres documents peuvent être ajoutés. 4. **RAW 3D** : les données brutes d'acquisition sous l'une de quatre formes : - l'**export depuis le projet Artec Studio** avec la CLI `aec_artecViewer`, le même outil que le nœud GPU AerariumChain exécute : un PLY brut par scan (chaque frame tel qu'enregistré) plus les **photos des scans** (les images de la caméra de texture, PNG sans perte, `_RAW_NN_INP_NNNN.png`) listées dans le METS comme images d'entrée. Les filtres sont ceux de la CLI (`kind`, `scan-geometry`, `target-total`, `max-size`, `on-oversize`) : un scan exclu ou refusé pour sa taille ne laisse ni PLY ni photos, un fichier fusionné ou incomplet fait échouer l'export (garde de provenance du serveur DPAC). Le projet peut être un dossier ou un ZIP local, ou celui enregistré sur le hub, téléchargé avant l'export ; - des **fichiers bruts** (un PLY par scan, images, E57 ...), copiés et hachés ; - le **format ouvert `.acraw`** (AerariumChain Raw) : au lieu de fichiers épars, un seul conteneur avec manifeste, SHA-256 de chaque fichier et root hash, vérifiable par quiconque sans logiciel propriétaire ; il s'applique aux fichiers bruts sélectionnés comme à l'export Artec (PLY par scan + photos) ; spécification sur [github.com/aerariumchain/acraw-spec](https://github.com/aerariumchain/acraw-spec) ; - le **format original** du logiciel d'acquisition : le dossier du projet zippé sans recompression, ou une archive copiée octet par octet. 5. **Destination** : le disque externe (les volumes montés et l'espace libre sont listés), vérification automatique, ZIP (ZIP64 si nécessaire) et certificat. ![L'étape RAW 3D : export depuis le projet Artec avec la CLI intégrée (PLY par scan + photos), filtres de la CLI](/downloads/dpac-t2-raw.png) Depuis le Hub, l'outil peut aussi demander au **Hub lui-même** de construire le T2 : les PLY bruts sont exportés du projet du scanner sur un nœud GPU et le paquet y est assemblé. ![La procédure guidée : METS T1 depuis le Hub, identification, paradonnées, RAW 3D, destination](/downloads/dpac-t2-crea.png) ## Vérifier un paquet La section **Vérifier les paquets** accepte le dossier du paquet (avant la compression) ou un ZIP déjà créé. Les contrôles portent sur : - le METS : XML bien formé, `PROFILE`, `OBJID`, en-tête (`RECORDSTATUS`, UUID, `CREATEDATE`, agents), sections descriptive et administrative, les champs obligatoires des métadonnées techniques 3D, les identifiants en double ; - la section des fichiers : vocabulaire `USE`, le groupe `FG_3D` du T1, les groupes `STORAGE` et `RAW_3D`, les noms des documents de paradonnées ; - chaque fichier déclaré dans les groupes du T2 : présence, `SIZE`, `MD5`, `MIMETYPE`, `CREATED`, `ADMID` ; la signature des PDF ; l'en-tête des PLY ; les conteneurs `.acraw` (règles du conteneur, manifest, hachages, root hash, structure) ; - la sémantique du delta : aucun fichier du T1 dans le paquet, aucun fichier non déclaré ; - la comparaison avec le METS T1, lorsqu'il est fourni ; - au choix, le validateur public METS ECO-MiC de l'ICDP. Deux panneaux gardent l'historique : **paquets générés** (vérification réussie) et **paquets échoués**, chacun avec les problèmes relevés. Chaque règle a un identifiant stable (`HDR-ID`, `FSEC-STORAGE`, `FILE-MD5` ...) qui figure aussi dans le certificat et dans les réponses de l'API. ## Le lot de vérification pour le contrôle qualité À côté de chaque livraison, l'outil écrit un **lot de vérification** : le dossier `CANTIERE_LOTTO_PK_T2_VERIFICA/` et sa copie `CANTIERE_LOTTO_PK_T2_VERIFICA.zip` (les dossiers non compressés peuvent être désactivés dans les paramètres). Il est destiné au contrôle qualité de la Digital Library : qui reçoit le ZIP de livraison peut vérifier qu'il est arrivé intact, lire le journal des contrôles et retracer comment il a été construit, sans ouvrir le paquet. Pour le paquet `3D03CE01_LDIG013_PK0000002_T2` il contient : | Fichier | Ce que c'est et à quoi ça sert | |---|---| | `3D03CE01_LDIG013_PK0000002_T2_CERTIFICATO.pdf` | le certificat de vérification (voir ci-dessous), copie de celui à côté du ZIP | | `3D03CE01_LDIG013_PK0000002_T2.zip.md5` | l'empreinte MD5 du ZIP de livraison au format `md5sum` : le hachage, deux espaces, le nom du fichier. Depuis le dossier contenant le ZIP : `md5sum -c 3D03CE01_LDIG013_PK0000002_T2.zip.md5` (Linux), `md5 -r 3D03CE01_LDIG013_PK0000002_T2.zip` (macOS), `certutil -hashfile 3D03CE01_LDIG013_PK0000002_T2.zip MD5` (Windows). Si le hachage correspond, le ZIP reçu est octet par octet celui produit | | `3D03CE01_LDIG013_PK0000002_T2.zip.sha256` | la même empreinte en SHA-256 (`sha256sum -c …` sous Linux, `shasum -a 256 -c …` sous macOS) : plus robuste que MD5, c'est aussi celle imprimée dans le certificat | | `rapporto.json` | le journal complet des contrôles, lisible par machine : `ok`, `errors`, `warnings`, la liste `items[]` (chaque contrôle a un `id` stable comme `HDR-ID`, `FSEC-STORAGE`, `FILE-MD5`, `T1-FILES`, un `level` `error|warn|info|ok`, le message et le fichier concerné) et `summary` (type, OBJID, UUID DPAC, RECORDSTATUS, décomptes, inventaire avec MD5) | | `build.json` | comment le paquet a été construit : la spécification de build (identifiants, source du T1, paradonnées, mode RAW, options), d'où vient le T1, les fichiers produits avec taille et MD5, l'outil d'export et sa version | | `t1.xml` | le METS T1 ingéré par DPAC dont dérive le T2 : nécessaire pour refaire la comparaison delta (chaque fichier du T1 cité dans le T2 doit garder les mêmes SIZE et CHECKSUM) ; l'application le réutilise d'elle-même quand quelqu'un vérifie le ZIP | | `METS_.xml` | copie du METS T2 livré | | `METS__RELAZIONE_SETUP-ACQUISIZIONE.pdf`, `METS__RELAZIONE_ELABORAZIONE.pdf` | copies des documents de paradonnées, pour les lire sans ouvrir le paquet | | `artec-manifest.json` | (mode Artec) le manifeste de la CLI : pour chaque PLY brut le scan d'origine, frames totaux et utilisés, HD/SD, MD5, et la liste des photos | | `inventario.txt` | une ligne par fichier du paquet : MD5, taille, groupe METS (STORAGE, RAW_3D, LOW, PREVIEW…), chemin | | `LEGGIMI.txt` | ce qu'est le dossier, verdict et identifiants du paquet, les problèmes relevés et la liste ci-dessus | Une erreur bloque le ZIP ; un avertissement non. Le lot de vérification est aussi produit lorsqu'un paquet est seulement vérifié (un dossier ou un ZIP reçu d'un prestataire), à côté du fichier contrôlé. ## Le certificat de vérification Lorsqu'un paquet réussit la vérification, l'outil écrit un PDF **hors du paquet** : l'identité du paquet, SHA-256 et MD5 du METS et du ZIP, le journal complet des contrôles avec leur résultat, l'inventaire des fichiers avec leurs hachages. Les PDF de paradonnées ne sont pas joints : ils sont dans le paquet livré et dans le lot de vérification. C'est le document à conserver avec la livraison. ## L'API locale La fenêtre et l'API partagent le même code. L'API n'écoute que sur le PC (`http://127.0.0.1:47821/api/v1`, port et jeton facultatif dans les réglages) et est décrite par un document **OpenAPI 3.0** servi par l'application sur `/api/v1/openapi.json` et téléchargeable ici : [dpac-t2-openapi.json](/downloads/dpac-t2-openapi.json). ![Réglages : accès au Hub, API locale avec le contrat OpenAPI, validateur public, valeurs par défaut](/downloads/dpac-t2-impostazioni.png) ![Paramètres : suivi et assistance, valeurs par défaut et dossiers non compressés nommés comme les ZIP](/downloads/dpac-t2-artec.png) | Méthode | Route | Rôle | |---|---|---| | GET | `/health` | état de l'application | | GET | `/openapi.json` | le contrat de l'API | | GET | `/disks` | volumes montés et espace libre | | GET | `/artec/status` | la CLI `aec_artecViewer` est-elle utilisable ? (chemin, Node, version) | | POST | `/artec/list` | liste les scans, frames et photos d'un projet Artec | | POST | `/build` | construit un paquet T2 (job) à partir d'une `BuildSpec` | | POST | `/check` | vérifie un dossier ou un ZIP (job, ou synchrone avec `wait: true`) | | POST | `/zip` | vérifie et compresse le dossier d'un paquet (job) | | POST | `/acraw` | enveloppe des fichiers bruts dans un conteneur `.acraw` (job) | | POST | `/pdf/setup`, `/pdf/elaborazione` | génère les deux rapports de paradonnées | | GET | `/jobs`, `/jobs/{id}` | état, résultat et événements d'un job | | GET | `/jobs/{id}/events` | les mêmes événements en Server-Sent Events | | GET, DELETE | `/packages`, `/packages/{id}` | le registre des paquets générés et échoués | Authentification : aucune par défaut ; lorsqu'un jeton est défini dans les réglages, il doit être envoyé en `X-Api-Token` ou comme bearer token. Chaque chemin dans les requêtes est un chemin sur le PC où tourne l'application. ### La requête de construction ```json { "identity": { "codiceCantiere": "3D03CE05", "codiceLotto": "LDIG003", "pk": "PK0000002", "objid": "M489_XXXX", "dpacUuid": "6f1c2a3e-4b5d-4e6f-8a9b-0c1d2e3f4a5b", "title": "Titre de l'œuvre", "inventory": "INV-1", "catalogId": "XXXX" }, "t1": { "source": "file", "path": "/donnees/t1/M489_XXXX.xml" }, "paradata": { "setup": { "mode": "generate", "data": { "id_oggetto": "...", "setup_acquisizione": "SETUP_#1" } }, "elaborazione": { "mode": "generate", "data": { "operator": "...", "derivFile": "M489_XXXX_DRV.glb", "derivSoftware": "Blender" } } }, "raw": { "mode": "folder", "folder": "/donnees/raw/M489_XXXX", "extensions": ["ply"], "acraw": { "enabled": false } }, "options": { "overwrite": true }, "output": { "dir": "/Volumes/DISQUE/T2", "zip": true, "keepStaging": true } } ``` - `t1.source` vaut `file` ou `url` (avec `headers`). - `paradata.*.mode` vaut `generate` (à partir des données), `file` (un PDF existant, `path`) ou `none`. - `raw.mode` vaut `artec` (avec `raw.artec` : `projectPath` ou `projectS3Key`, `kind`, `scanGeometry`, `targetTotal`, `maxSize`, `onOversize`, `maxTotalSize`, `photos`), `files`, `folder`, `original` (avec `originalPath` et `originalVendor`) ou `none` ; `raw.acraw.enabled` active le conteneur ouvert. Le manifeste de la CLI Artec est conservé dans `verifica/artec-manifest.json`. ### Le déroulement d'un job ``` POST /build -> 202 { "jobId": "..." } GET /jobs/{jobId} -> { "job": { "status": "running|done|failed", "result": ... }, "events": [...] } GET /jobs/{jobId}/events -> text/event-stream: progress, done, error ``` Les événements de progression portent `step`, `percent` et `message` ; le résultat d'une construction porte les chemins du dossier, du ZIP (avec taille et MD5), du rapport de vérification et du certificat. Une vérification synchrone : ``` POST /check { "target": "/Volumes/DISQUE/T2/3D03CE05_LDIG003_PK0000002_T2.zip", "wait": true } -> 200 { "report": { "ok": true, "errors": 0, "warnings": 0, "items": [...], "certificatePath": "..." } } ``` Les mêmes opérations sont disponibles en ligne de commande (`dpac-t2 build`, `check`, `zip`, `acraw`, `pdf-setup`, `pdf-elab`), avec le même code. ## Guide et support IA Cette page est le guide de l'application : le menu **Guide** l'ouvre dans le navigateur. Le même guide en Markdown, conçu comme contexte pour un assistant IA, se télécharge ici : [dpac-t2-guida.md](/downloads/dpac-t2-guida.md) (en italien). Le menu **Connecter à l'IA** rassemble tout ce qui permet à un assistant (Claude Code, Claude Desktop, ChatGPT) ou à l'équipe AerariumChain d'aider quand quelque chose ne va pas : - **Exporter le diagnostic pour l'IA** : un fichier Markdown (ou une copie dans le presse-papiers) avec l'environnement, les paramètres sans secrets, les paquets échoués et leurs problèmes, le rapport de vérification du paquet choisi, une note de l'opérateur, les dernières lignes du journal et le guide. Jamais les fichiers des paquets. Le même bouton se trouve sur chaque paquet échoué. - **Connecteur MCP** : l'application est un serveur MCP (Model Context Protocol) local. En un clic elle se connecte à Claude Code ou Claude Desktop, qui peuvent lire l'état, les paquets, les rapports et le journal, lancer une vérification ou une construction et résoudre le problème en direct avec l'opérateur. ChatGPT exige un serveur public : on utilise l'export de diagnostic. - **Guide** (lien et téléchargement) et **Demander de l'aide** (requête à l'équipe avec le contexte de l'application). ![Connecter à l'IA : diagnostic, guide, connecteur MCP, assistance](/downloads/dpac-t2-ai.png) ## Mises à jour, suivi et assistance L'application dialogue avec le manager AerariumChain (manager.aerariumchain.com) via le Hub, avec un identifiant d'installation et, si l'opérateur est connecté, avec sa session : - **Mises à jour** : au démarrage et toutes les six heures, elle vérifie si une version plus récente a été publiée ; si oui, elle la télécharge en arrière-plan et la barre latérale affiche « Mise à jour X » avec la progression et le bouton Redémarrer et mettre à jour (l'installation se fait aussi à la fermeture). AerariumChain peut marquer une version comme obligatoire ou forcer la mise à jour d'une installation depuis le manager : l'application l'installe d'elle-même dès qu'aucun travail n'est en cours. - **Suivi** : pour chaque paquet construit, elle envoie un rapport avec les identifiants (paquet, préfixe, UUID DPAC, œuvre, hive), le résultat de la vérification avec les problèmes relevés, hachage et taille du ZIP, décomptes (paradonnées, PLY, photos, images du T1), outil d'export et durées. Jamais les fichiers du paquet. Les événements sont mis en file hors ligne et partent à la première connexion ; désactivable dans Paramètres → Suivi. - **Assistance** : « Demander de l'aide » dans la barre latérale ouvre une demande à l'équipe AerariumChain avec la version de l'application, le système, l'état de la CLI et les dernières lignes du journal ; la réponse arrive à l'email indiqué. ## Prérequis et distribution - macOS 11 ou ultérieur (Apple Silicon ou Intel) ou Windows 10/11 64 bits ; aucun autre logiciel n'est nécessaire (les PDF de paradonnées sont générés par l'outil). - De l'espace sur le disque de destination pour les données brutes et pour le ZIP. - Un compte du Hub AerariumChain avec une licence active, et une connexion internet au moins une fois toutes les 72 heures. - La CLI `aec_artecViewer` pour l'export depuis les projets Artec est intégrée à l'application (prise dans son propre dépôt à la compilation) et s'exécute sur le runtime de l'application : rien à installer. L'installateur se télécharge depuis le Hub avec un compte qui dispose de la licence. Pour une licence ou de l'assistance [contactez-nous](https://aerariumchain.com/fr/contact/).