# AerariumChain Hub - Cómo el Hub de AerariumChain sirve a la colección: digitalización, estudio y preservación a largo plazo, explicado para conservadores, restauradores e historiadores del arte. Un único archivo markdown con toda la guía - dáselo a ChatGPT, Claude o a cualquier asistente y pregunta cómo usar el Hub de AerariumChain. Source: https://docs.aerariumchain.com/es/ (generated from the official AerariumChain documentation). --- # Qué es el AerariumChain Hub Toda obra de una colección tiene una vida digital: su ficha de inventario, su forma en tres dimensiones, su superficie fotografiada hasta la pincelada, lo que el infrarrojo y el ultravioleta revelan bajo el barniz, y las copias de preservación que habrán de sobrevivirnos a todos. El **AerariumChain Hub** (hub.aerariumchain.com) es el lugar donde esa vida digital se conserva reunida, en orden y al alcance de la mano. El Hub está pensado para quienes cuidan de las colecciones: conservadores, restauradores, registradores, gestores de colecciones e historiadores del arte. Las campañas de digitalización lo alimentan desde las salas y los almacenes; el Hub convierte lo capturado en material que se puede estudiar, compartir y preservar. ## Qué hace el Hub por la colección - **Lleva el registro.** El [Catálogo](/es/catalog/) guarda la ficha de cada obra: números de inventario y de catálogo, materiales y técnicas, dimensiones, custodia y derechos. Las listas completas de campaña llegan mediante importación desde Excel, con plantillas que puede adaptar al formato propio de su institución. - **Recibe la digitalización.** Todo lo que el [kit AerariumChain Scan](/es/scan-kit/) captura in situ (escaneos 3D, fotografía gigapíxel, imagen multiespectral) fluye hacia el Hub, ya vinculado a la obra correspondiente. - **Prepara el material para el estudio por sí solo.** Cada subida 3D se [procesa automáticamente](/es/upload-and-processing/): se convierte, se texturiza y se optimiza sin que su institución necesite personal técnico. - **Abre la obra al examen.** El [visor 3D](/es/3d-viewer/) y el [visor Gigapixel](/es/gigapixel/) funcionan en un navegador corriente, en cualquier dispositivo: el ordenador del gabinete de estudio, una tableta en el almacén, un teléfono en la sala. - **Preserva.** Con **DPAC**, de Ecomic, disponible en el [Store](/es/store/), las obras digitalizadas se empaquetan, se depositan y se notarizan para la MiC Digital Library. - **Crece con usted.** El [Store](/es/store/) añade aplicaciones al Hub a medida que sus proyectos las requieren. ## Cómo se organiza el acceso Se entra en el Hub con la cuenta AerariumChain, dentro del espacio propio de su institución (existe también un espacio personal). El acceso se rige por **roles**: un administrador invita a sus colegas desde la página de equipo y decide qué secciones ve cada rol, de modo que un conservador, un registrador y un investigador externo trabajen cada uno exactamente con lo que les concierne. ## Orientarse: la barra lateral izquierda | Sección | Qué encontrará en ella | |---------|------------------------| | **Artwork Catalog** | El registro de obras (Artwork Library) y la importación desde Excel (Import Data) | | **Site Manager** | Los datos que llegan de los emplazamientos de digitalización, las configuraciones de adquisición y la descarga de la aplicación Site Manager | | **Acquisitions** | Los paneles de campaña, los escaneos 3D, Gigapixel Studio y la descarga de la aplicación Scan | | **Gigapixel Gallery** | Las láminas gigapíxel publicadas | | **3D Assets** | Todos los modelos 3D procesados, con sus versiones y su historial | | **DPAC** | El Package Manager de la aplicación de preservación DPAC | | **Store** | Las aplicaciones que amplían su Hub | Los administradores disponen además de un **Worker Monitor**, la sala de máquinas del Hub, que muestra la [red de procesamiento](/es/node-workers/) en pleno trabajo. --- # Inicio rápido Seis pasos llevan de una lista de campaña en papel a una obra que se puede girar, ampliar y anotar en pantalla. ## 1. Inicie sesión Vaya a **hub.aerariumchain.com** e inicie sesión con su cuenta AerariumChain. Si su institución le ha invitado, acepte primero la invitación: su rol determina qué secciones del Hub verá. ## 2. Elija su institución El selector de la cabecera muestra las instituciones a las que pertenece. Elija aquella para la que trabaja, o permanezca en su espacio personal. ## 3. Incorpore la lista de campaña Abra **Artwork Catalog > Import Data** y suba la hoja de cálculo de la campaña. El Hub reconoce por sí solo las columnas de la plantilla DPAC; ajuste la correspondencia si su lista difiere, guárdela como plantilla para la próxima campaña y confirme. Las obras figuran ya en la **Artwork Library**. La página del [Catálogo](/es/catalog/) explica cada columna. ## 4. Digitalice La captura se realiza en las salas y los almacenes con el [kit AerariumChain Scan](/es/scan-kit/): - La **aplicación Scan** (que se descarga desde **Acquisitions > Download App**) gobierna el escáner 3D, la cámara gigapíxel y la secuencia multiespectral. - Una campaña estructurada se conduce con [Site Manager](/es/site-manager/), que lleva la lista de comprobación de lo que aún le falta a cada obra. ## 5. Deje que el Hub haga el trabajo técnico Los escaneos se suben desde la aplicación Scan; un modelo suelto puede subirse también desde **3D Assets**. A partir de ahí el Hub lo [procesa todo automáticamente](/es/upload-and-processing/): conversión, texturas, niveles de detalle. Puede seguir el progreso desde la vista de detalle de la obra, pero nada requiere su intervención. ## 6. Estudie y comparta Cuando el procesamiento termina, abra el modelo en el [visor 3D](/es/3d-viewer/) desde cualquier dispositivo, o la lámina fotográfica en el [visor Gigapixel](/es/gigapixel/). Todo permanece vinculado a la ficha de la obra en el Catálogo. ## Adónde ir después - Deposite y notarice las obras digitalizadas con **DPAC**, de Ecomic, desde el [Store](/es/store/). - Lea cómo la [red de workers](/es/node-workers/) realiza el cálculo pesado, y cómo su institución puede formar parte de ella. --- # El kit AerariumChain Scan El kit Scan es lo que AerariumChain lleva a sus salas y almacenes para digitalizar una colección. Todas las técnicas del kit son **sin contacto y de luz fría**: la obra no se toca jamás ni se expone a radiación nociva más allá de las lámparas de examen habituales de un restaurador. Tres capturas complementarias construyen el registro digital de cada pieza, todas conducidas con la aplicación **AerariumChain Scan**, que se descarga desde el Hub. ## Tres maneras de mirar la obra ### La forma: el escaneo 3D Escáneres profesionales de luz estructurada (Artec Eva para los volúmenes mayores, Artec Spider para la talla fina y el ornamento, o ambos a la vez) registran la forma tridimensional exacta de la escultura, las artes decorativas y los objetos, con el color de su superficie. El resultado es un cuerpo digital fiel de la obra, listo para el procesamiento automático del Hub y para su estudio en el [visor 3D](/es/3d-viewer/). ### La superficie: la fotografía gigapíxel Una cámara de formato medio (el cuerpo de referencia es una **Fujifilm GFX100S II**, de 102 megapíxeles, con un objetivo macro de 120 mm; también se admiten cuerpos Sony y Canon) fotografía la superficie en celdas superpuestas, fusionadas después en una única lámina de miles de millones de píxeles. El operador indica la resolución deseada sobre la obra, en píxeles por pulgada, y la aplicación planifica y guía toda la secuencia. La captura multidisparo **Pixel Shift** está disponible allí donde se exige la máxima fidelidad. En la lámina terminada se leen el craquelado, la trama del lienzo, el toque individual del pincel. ### Bajo la superficie: la imagen multiespectral Con una cámara de formato medio convertida al infrarrojo y una secuencia guiada de filtros, el kit registra la obra banda a banda: visible, reflectografía infrarroja a 720 y 850 nm, y ultravioleta. Los dibujos subyacentes, los arrepentimientos (pentimenti), los retoques antiguos y las intervenciones posteriores, invisibles a la luz ordinaria, afloran en las capas espectrales, que quedan unidas a la obra en el Hub. ## Luz y color dignos de confianza - **Iluminación calibrada.** Luces LED de estudio JINBEI, controladas desde la aplicación, en la disposición canónica de dos luces a 45 grados: una iluminación uniforme, repetible y suave. - **El color, gobernado por ColorChecker.** Cada sesión incluye una carta ColorChecker Classic. La aplicación mide la exactitud del color parche a parche como **Delta E 2000**, verifica el balance de blancos y la exposición, y archiva el informe de color junto con la captura. Lo que se ve en el visor es lo que estaba sobre el caballete. - **Cobertura verificada.** Vista en directo, análisis de enfoque y encuadre, y comprobación automática de que las celdas gigapíxel vecinas se solapan de verdad. ## Del caballete al Hub 1. Las sesiones 3D se empaquetan y se suben de forma segura; el [procesamiento automático](/es/upload-and-processing/) del Hub las convierte en modelos listos para el estudio. 2. Las capturas gigapíxel se ensamblan y se publican en el [visor Gigapixel](/es/gigapixel/). 3. Cada captura queda vinculada a la ficha de la obra en el [Catálogo](/es/catalog/), de modo que forma, superficie y capas espectrales no se separen jamás. El kit se maneja con la [aplicación AerariumChain Scan](/es/scan-app/); las campañas se mantienen en orden con [Site Manager](/es/site-manager/). --- # La aplicación AerariumChain Scan AerariumChain Scan es la aplicación de escritorio que conduce el trabajo del [kit Scan](/es/scan-kit/): gobierna el escáner, las cámaras y las luces, mantiene cada sesión en orden y lo entrega todo al Hub. Funciona en Windows y macOS y se descarga directamente desde el Hub, de modo que la versión en uso sobre el terreno es siempre la vigente. ## Descarga e instalación 1. En el Hub, abra **Acquisitions > Download App** (descarga de la aplicación). 2. Elija su plataforma: Windows, macOS Apple Silicon o macOS Intel. 3. Instale, inicie la aplicación e inicie sesión con la misma cuenta que utiliza en el Hub. ## Las pantallas de trabajo - **Dashboard**: qué se está empaquetando y subiendo en este momento, y qué ha terminado. - **3D Scan**: abre una sesión para una obra dada, lanza el software de escaneo de Artec y vigila la carpeta de la sesión; cuando aparecen los archivos de escaneo, la sesión queda marcada y sus metadatos técnicos se recogen automáticamente. - **Gigapixel**: planifica la secuencia fotográfica. El operador elige el modo (rápido, guiado, rotación guiada, manual o libre); la aplicación calcula la retícula de tomas a partir de la cámara, el objetivo y la resolución deseada sobre la obra, y sigue después el progreso celda a celda. - **Capture Studio**: la sala de cámara conectada. Vista en directo y control remoto para cuerpos Fujifilm, Sony y Canon, multidisparo Pixel Shift, la secuencia guiada de filtros multiespectrales, el control inalámbrico de las luces de estudio y el informe de color ColorChecker. - **Upload**: empaqueta las sesiones 3D terminadas en archivos protegidos y las entrega; el Hub registra cada entrega e inicia el [procesamiento automático](/es/upload-and-processing/). - **Gigapixel Upload / Drive Upload**: entrega las capturas gigapíxel, incluido un flujo de trabajo para los grandes emplazamientos en los que varias estaciones de captura confían sus sesiones a un único disco externo, y solo se sube lo que el Hub aún no posee. - **History**: cada sesión y cada entrega, con su estado. - **Setup**: preferencias y rutas locales (ubicación del software de escaneo, carpetas de sesión). ## Cómo se conecta La aplicación inicia sesión con su cuenta AerariumChain y dialoga con el Hub. Las colecciones a las que puede entregar son aquellas a las que su cuenta tiene acceso. Las entregas se verifican (mediante sumas de comprobación), se protegen y se envían directamente a un almacenamiento seguro en la nube; el Hub vincula después cada una a la obra correspondiente del [Catálogo](/es/catalog/). ## Varias estaciones, una sola campaña En los grandes emplazamientos de digitalización captura más de una estación a la vez. La entrega mediante disco reúne las sesiones de todas las máquinas, las compara con lo que el Hub ya posee y envía solo lo que falta: nada se entrega dos veces, nada se queda atrás. --- # Site Manager Una campaña de digitalización es, antes que nada, una lista de obras y una disciplina: qué piezas requieren 3D, cuáles requieren gigapíxel, qué se ha hecho ya, qué dice la scheda di rilievo (la ficha de levantamiento) de cada objeto. **AerariumChain Site Manager** es la aplicación de escritorio que mantiene esa disciplina sobre el terreno. Funciona en Windows y macOS, se descarga desde el Hub y trabaja **completamente sin conexión** en las salas y los almacenes, con copias locales de salvaguarda automáticas; solo el inicio de sesión y la entrega final al Hub requieren conexión. ## Descarga e instalación 1. En el Hub, abra **Site Manager > Download App**. 2. Elija Windows, macOS Apple Silicon o macOS Intel. 3. Instale, inicie la aplicación e inicie sesión con su cuenta AerariumChain. ## Qué mantiene en orden ### La lista de obras La lista de la campaña llega desde Excel mediante un paso guiado de correspondencia de columnas. Cada obra lleva su lista de comprobación de digitalización: si requiere 3D, si requiere gigapíxel y qué está ya hecho (3D, gigapíxel, fotografía, scheda di rilievo). Filtros, búsqueda, vistas por ubicación y cifras de progreso en tiempo real mantienen legible incluso una campaña de miles de piezas. ### La scheda di rilievo Una scheda di rilievo completa para cada obra, con valores predeterminados configurables y composición automática del identificador del objeto, exportada fielmente a la plantilla oficial de Excel utilizada por las instituciones de conservación. ### Configuraciones de adquisición Descripciones con nombre propio de cómo se capturan las obras (qué escáner, qué disposición). Los ajustes predefinidos para los escáneres Artec rellenan correctamente, todas las veces, los campos de equipamiento de la scheda. ### Paquetes Para cada obra, Site Manager exporta un paquete con el archivo de metadatos, la hoja de cálculo de la scheda y las fotografías, junto con un libro maestro de estado para todo el emplazamiento y un informe de cambios. Los paquetes siguen el formato de datos DPAC, de modo que llegan ya conformados para la preservación. ### Comunicaciones Cartas de progreso, generadas automáticamente: todo lo que ha cambiado desde la última comunicación, listo para revisar y enviar. ## La entrega al Hub Cuando el emplazamiento (o una parte de él) está listo, Site Manager lo entrega al Hub: el libro maestro, todas las schede di rilievo, las configuraciones, las fotografías y el historial completo de comentarios. Antes de enviar, muestra con exactitud en qué difiere la entrega de lo que el Hub ya posee, y advierte de cualquier conflicto en los nombres de configuración, de modo que siempre se sabe si se está creando o actualizando. En el Hub, el emplazamiento aparece bajo **Site Manager**, y sus obras ocupan su lugar en el [Catálogo](/es/catalog/). --- # Catálogo El **Artwork Catalog** es el registro de la colección dentro del Hub: una ficha por obra, y en torno a cada ficha todo lo que las campañas han producido. Tiene dos páginas en la barra lateral: **Artwork Library**, donde se consultan y gestionan las fichas, e **Import Data**, por donde llegan desde Excel las listas completas de campaña. Cada modelo 3D, cada lámina gigapíxel y cada entrega de emplazamiento puede vincularse a una ficha, de modo que el catálogo siga siendo lo que debe ser: el hilo que mantiene unidas la obra y su documentación. ## Artwork Library Una tabla clara con todas las obras de la institución seleccionada, con paginación, ordenación, búsqueda y un filtro para las fichas que ya tienen material digitalizado adjunto. Las columnas pueden mostrarse, ocultarse y redimensionarse; la disposición elegida se recuerda, de modo que registradores y conservadores puedan mantener cada uno su propia vista. ### Las columnas, con la plantilla DPAC como ejemplo Las columnas siguen la plantilla elegida para la colección. Un buen ejemplo de lo que el Catálogo puede albergar es la plantilla que utiliza **DPAC**, la aplicación de preservación de Ecomic para la MiC Digital Library (disponible en el [Store](/es/store/)): con ella, la tabla se lee como la hoja oficial de Excel de DPAC, de la identificación a los datos de captura. Todas las columnas gestionables, agrupadas como en esa plantilla: | Grupo | Columnas | |-------|----------| | Identificación | ODA_Id, Inventario (catalog id), Numero di Catalogo, ESC, TSK, Fondo/Collezione, Descrizione, Nome Opera | | Emplazamiento y lote | Codice Cantiere, Codice Lotto, PK, Label | | Propiedades físicas | Material, Techniques, Width, Height, Length, Depth, Diameter, Weight | | Conservación y ubicación | Conservation, Location / Luogo | | Custodia y derechos | Custodian, Creating Organization, IP Owner, OBJID / DocumentID, logicalId, conservativeId, conservativeIdAuthority, recordContentSource, RightsHolderName, RightsHolderContactEmail, FolderLabel | | Equipamiento de adquisición | Acquisition Method, Acquisition Manufacturer, Equipment model, Processing software, Processing software version | | Datos de captura | scanCount, frameCount, resolution, resolution unit, lighting, imageCount | | Óptica y exposición | focalLength, focalLength unit, aperture, exposureTime, exposureTime unit, iso | | Resultados del emplazamiento | Photos S3 Paths, Scanner, 3D Done, Gigapixel Done, Scheda Done | | Campos genéricos | Author, Art ID, Date, Purpose, Medium, Frame, Sign, Sign date, Note, Complexity index, Lot name | ## Import Data La página de importación incorpora al registro una hoja de cálculo completa de campaña: 1. **Suba** el archivo de Excel (.xls / .xlsx). 2. **Empareje las columnas.** Cada columna de la hoja de cálculo se empareja con un campo del catálogo. El Hub reconoce por sí solo los encabezados de la plantilla DPAC, en italiano y en inglés; cualquier emparejamiento puede corregirse a partir de una lista con todos los campos del catálogo. 3. **Revise antes de confirmar.** Las filas extraídas se muestran primero. En modo de adición, las fichas nuevas se añaden; en modo de sustitución, el Hub indica con claridad qué fichas serían nuevas, cuáles se actualizarían y cuáles se eliminarían. Las filas pueden corregirse, añadirse o tacharse en el momento. 4. **Guarde**, y las fichas ocupan su lugar en el registro. La página conserva además el último archivo importado y las hojas de cálculo entregadas por [Site Manager](/es/site-manager/), ambos disponibles para su descarga: el rastro documental de la campaña. ## Plantillas adaptadas a su institución Las correspondencias de columnas pueden guardarse como **plantillas**, de modo que un formato recurrente se importe en un solo gesto: - **Cree** la correspondencia una vez y guárdela con un nombre y una descripción. Una plantilla registra los emparejamientos de columnas, la fila de encabezados y el nombre de la hoja, y puede establecerse como predeterminada. - **Aplíquela** en la siguiente importación: toda la correspondencia se rellena por sí sola. - **Gestione** las plantillas con libertad; pueden revisarse y eliminarse en cualquier momento. La plantilla DPAC se reconoce de serie. Las plantillas personalizadas extienden la misma cortesía a cualquier tradición de hoja de cálculo que tenga su institución: el Hub se adapta a su registro, y no al revés. --- # Subida 3D y procesamiento automático Entre el escáner y un modelo que se pueda estudiar media una cadena de trabajo técnico: conversiones de formato, tratamiento de texturas, optimización para la pantalla. En el Hub esa cadena funciona por sí sola. Su parte termina cuando la captura queda entregada. ## Cómo llega un modelo al Hub - **Desde la aplicación Scan.** Las sesiones de escaneo terminadas las entrega directamente la [aplicación AerariumChain Scan](/es/scan-app/); el Hub registra cada entrega y comienza a trabajar. - **Desde el navegador.** En **3D Assets**, el diálogo de subida acepta archivos arrastrándolos y soltándolos: útil para los modelos producidos en otro lugar o recibidos en préstamo de datos. Formatos de modelo aceptados: **OBJ, PLY, STL, GLB, OFF**, con materiales **MTL** y texturas **JPG, PNG, BMP**. Las transferencias van a un almacenamiento protegido en la nube; los modelos grandes viajan en partes paralelas, de modo que incluso los escaneos pesados llegan con presteza. ## Lo que el Hub hace por sí solo En cuanto se registra una entrega, la [red de workers](/es/node-workers/) toma el relevo: - **Conversión** de cualquier formato aceptado a la forma que el visor transmite mejor, y de vuelta a formatos de trabajo cuando hace falta. - **Texturas** preservadas, comprimidas y preparadas de nuevo donde es necesario, para que el color capturado sobre el caballete sobreviva intacto. - **Niveles de detalle.** Se preparan varias versiones graduadas de cada modelo, con texturas escaladas en consonancia, de modo que el [visor](/es/3d-viewer/) atienda con la misma soltura a un teléfono en la sala y a una estación de trabajo en el gabinete de estudio. - **Láminas y previsualizaciones.** Vistas giratorias, en color pleno y en relieve neutro, ilustran cada modelo en el listado. - **Procesamiento de escaneos.** Las sesiones en bruto del escáner se resuelven en mallas terminadas en workers equipados con el software de Artec. ## Seguir el trabajo Cada elemento de **3D Assets** muestra sus versiones y los pasos que hay detrás de ellas, cada uno marcado como completado, fallido o cancelado. Cuando el último paso se cierra, **View 3D** (ver en 3D) abre el [visor](/es/3d-viewer/). Los derivados de preservación producidos por **DPAC** (Ecomic) aparecen aquí también. Mientras un paquete DPAC que cita un derivado está siendo depositado, o una vez notarizado, ese derivado queda protegido contra el borrado: el registro de preservación permanece íntegro. ## Ligado al Catálogo Cada entrega queda vinculada a la ficha de la obra que digitaliza. Desde el [Catálogo](/es/catalog/) se llega a los modelos de una obra; desde un modelo se sabe siempre a qué obra pertenece y bajo qué custodia se encuentra. --- # El visor 3D El visor es donde la obra digitalizada se somete a examen. Se abre en un navegador corriente y, como el renderizado sucede en la nube y a su pantalla solo llega la imagen, **hasta el modelo más pesado a resolución completa se abre al instante en cualquier dispositivo**: la estación de trabajo del gabinete de estudio, un iPad en el almacén, un teléfono frente al original. Nada se descarga al dispositivo, lo que significa además que el modelo nunca abandona la custodia del Hub: un punto que importa cuando están en juego los derechos y la reproducción. Ábralo con **View 3D** (ver en 3D) desde cualquier modelo de **3D Assets**, o desde la ficha de la obra en el [Catálogo](/es/catalog/). ## Girar la obra entre las manos - **Rote** y **desplace**, con gestos táctiles y de pellizco en tabletas y teléfonos. - **Acérquese** hasta las huellas de la herramienta, aléjese hasta la figura completa; **restablecer** devuelve a la vista canónica. - **Elija el centro** de rotación y guárdelo como presentación predeterminada de la obra. - **Herramientas de pivote** para una colocación precisa, con la posibilidad de guardar una nueva versión del modelo a partir del estado ajustado. ## Anotar el estado de conservación y las observaciones - **Comentarios anclados a la superficie**: un punto único, o un área dibujada (plana, o siguiendo el relieve), cada uno con su propio color. Una nota sobre el estado de conservación, una duda de atribución, una indicación para el restaurador: cada una permanece exactamente donde le corresponde, y la discusión se queda con ella. - **Revisión**: las colecciones que examinan formalmente los escaneos entrantes pueden aprobar o rechazar cada uno desde el propio visor. ## Secciones y detalles En modo editor, el visor atiende las preguntas más exigentes del restaurador: - Selección por **lazo**, **rectángulo**, **plano de base** u **objeto completo**. - Cortes solo por la cara frontal, o a través del cuerpo entero del objeto; las selecciones pueden invertirse. - **Deshacer y rehacer** completos, con recuperación de las sesiones no guardadas. - **Exportación** del corte como archivo de trabajo (OBJ con materiales y textura), o adopción del corte como estado predeterminado del modelo. ## Capas y vistas espectrales - **Superposición de varios modelos** en una misma escena: estados anteriores y posteriores al tratamiento, fragmentos recompuestos, vaciados frente a originales. - **Vista multiespectral**: donde existen capturas espectrales, la misma obra puede pasarse a sus capas de infrarrojo y ultravioleta, y el dibujo subyacente leerse en su sitio. ## La ficha a mano Un panel lateral mantiene a la vista los detalles del modelo y su historial de procesamiento, y la ficha completa de la obra (inventario, materiales, dimensiones, derechos) está a un paso, en el [Catálogo](/es/catalog/). El visor muestra el objeto; el registro responde por él. --- # Impresión 3D **3D Print** convierte los modelos 3D de su colección en objetos físicos: réplicas museísticas para exposiciones y préstamos, reproducciones táctiles con placa en braille para visitantes ciegos y con baja visión, y series para la tienda. Usted describe lo que necesita; los talleres certificados de la red AerariumChain envían presupuestos en competencia; usted elige, paga y sigue la producción y el envío desde el Hub. Sus archivos 3D nunca salen de AerariumChain. Los talleres presupuestan sobre una imagen y sobre las medidas que calcula el Hub; solo el taller elegido recibe un archivo listo para imprimir, preparado por AerariumChain, único para su pedido y trazable. La interfaz de la app está en inglés para este idioma: las etiquetas se indican tal como aparecen. ## Instalar la app desde el Store 1. Abra **Store** en la barra lateral del Hub y seleccione la tarjeta **3D Print**. 2. Lea la ficha y elija **Install** (instalar). 3. **3D Print** ocupa su lugar en la barra lateral. Ábrala cuando la necesite: funciona dentro del Hub, para la institución seleccionada arriba. ![La tarjeta 3D Print en el Store del Hub](/downloads/3d-print-en-01-store.png) ![La ficha de 3D Print con la acción Install](/downloads/3d-print-en-02-installa.png) Para hacer pedidos se necesita una institución (no la cuenta personal) y el derecho a actuar en su nombre: lo tienen los administradores de la institución, que pueden concederlo a otros miembros con el permiso **3D Print** en los roles del equipo. ## Datos de facturación Antes de aceptar un presupuesto, complete una vez para la institución los **Billing details** (datos de facturación): razón social, país, NIF-IVA o código fiscal, domicilio y dirección de envío predeterminada. Los organismos públicos italianos marcan **Public body** e indican el código de la oficina. El país determina el vendedor: las instituciones de Estados Unidos compran a **AerariumChain Corp.** en dólares; todas las demás a **WEREA S.r.l.** en euros. ![Los datos de facturación de la institución](/downloads/3d-print-en-04-fatturazione.png) ## Una nueva solicitud Elija **New request** (nueva solicitud). Cuatro pasos: 1. **Model**: elija un modelo 3D de la colección de la institución. 2. **Type**: **Museum replica** (réplica museística), **Tactile reproduction** (reproducción táctil) o **Gadget & shop** (tienda). 3. **Configure**: cantidad, escala, material, acabado (en bruto o lijado), protección transparente opcional, placa en braille y base para las piezas táctiles, notas para el taller. Confirme las dimensiones del original: el Hub las mide a partir del modelo y de la ficha de catálogo. 4. **Review**: revise y envíe. ![La elección del modelo](/downloads/3d-print-en-05-modello.png) ![La elección del tipo de impresión](/downloads/3d-print-en-06-tipologia.png) ![La configuración, con la vista previa 3D y las dimensiones del original](/downloads/3d-print-en-07-configurazione.png) ### Por qué no se incluye el coloreado Los precios excluyen el coloreado y la pátina. El coloreado se hace a mano, y el paso del modelo digital al trabajo manual puede introducir diferencias de tono y color: corresponde a un restaurador experto, en coordinación con su conservador. Las impresiones llegan en bruto o lijadas, listas para ese trabajo. Si también necesita el coloreado, indíquelo en las notas: le pondremos en contacto con el estudio de restauración más cercano. ## Comparar presupuestos La solicitud llega a los talleres certificados cuyas máquinas y materiales son adecuados. Cada presupuesto muestra el precio sin IVA, el plazo de entrega y la validez; los talleres aparecen como **Offer A**, **Offer B** y así sucesivamente, porque el vendedor responsable del pedido es WEREA S.r.l. (o AerariumChain Corp.). Recibe un correo con cada nuevo presupuesto. ![Los presupuestos recibidos para una solicitud](/downloads/3d-print-en-09-preventivi.png) ## Aceptar y pagar Elija **Accept** en la oferta preferida. Seleccione la forma de pago, compruebe la dirección de envío, lea las condiciones de venta y acéptelas con el nombre y el cargo del firmante. - **Credit card**: paga en el momento y la producción comienza con el pago. - **Bank transfer**: recibe un documento de pedido con los datos bancarios y el código de pedido que debe indicar. - **Acquisti in Rete PA (MePA)**: para organismos públicos italianos. ![La aceptación de un presupuesto: pago, envío y condiciones de venta](/downloads/3d-print-en-10-accetta.png) ## Seguir el pedido **Orders** muestra cada pedido con su estado de pago y de producción. En el pedido encontrará el avance, el historial, los importes con el régimen fiscal aplicado y el **Order document**. Cuando sale el paquete aparecen el transportista y el código de seguimiento: elija **Confirm receipt** cuando llegue. ![Un pedido en producción](/downloads/3d-print-en-11-ordine.png) ## La protección de sus modelos - Los talleres nunca descargan sus modelos: ni siquiera una vista previa mientras presupuestan. - El archivo que recibe el taller elegido lo prepara AerariumChain solo para ese pedido: a escala, posicionado para imprimir y marcado de modo que el archivo, e incluso una copia impresa, puedan vincularse al pedido. - Los talleres están obligados por un acuerdo marco con WEREA S.r.l.: confidencialidad, prohibición de reutilización, eliminación del archivo tras la entrega y penalizaciones por cualquier copia más allá del pedido. --- # Gigapixel Studio y el visor La fotografía gigapíxel registra la superficie de una obra en celdas de alta resolución superpuestas y las fusiona en una única lámina de miles de millones de píxeles: el cuadro entero en una imagen, y en la misma imagen el craquelado, la trama, el pelo suelto del pincel. En el Hub, **Gigapixel Studio** gobierna el paso de las celdas capturadas a la lámina terminada, y el **visor Gigapixel** abre esa lámina a quien usted decida, en cualquier dispositivo. ## Gigapixel Studio **Acquisitions > Gigapixel Studio** enumera todas las capturas gigapíxel de la institución, desde las recién entregadas (celdas en bruto) hasta las finalizadas (lámina lista). Cada captura está vinculada a su obra en el [Catálogo](/es/catalog/). Al abrir una captura se entra en la mesa de trabajo, que procede como querría un restaurador: con deliberación, y con el color por delante. 1. **Reunir.** Se revisan las celdas entregadas, la toma de conjunto y la referencia ColorChecker de la sesión. 2. **Calibrar.** El perfil de color se construye a partir de la captura del ColorChecker, de modo que la lámina entera responda a un patrón medido, no al gusto. 3. **Alinear.** Las celdas vecinas se alinean automáticamente; un editor de puntos de control permite la corrección fina donde la superficie lo exige, con previsualización del ajuste. 4. **Refinar.** La nitidez de captura se pondera celda a celda; las candidatas se comparan y se conserva la mejor. 5. **Previsualizar.** La lámina ensamblada se inspecciona antes de dar nada por definitivo. 6. **Fusionar.** La fusión final se ejecuta en la [red de workers](/es/node-workers/) y produce un **TIFF maestro de 16 bits**, la lámina de archivo, junto con la versión en teselas que el visor transmite. La publicación es automática. Cuando una lámina terminada se ha producido en otro lugar, puede depositarse directamente como TIFF. ## El visor Gigapixel El visor transmite solo las teselas de la región y el aumento que se están mirando, y por eso una lámina de cien gigapíxeles se mueve con fluidez **en cualquier dispositivo**, teléfonos incluidos. Se viaja sin interrupción de la composición completa al craquelado, como quien camina hacia el cuadro sin que nadie le pida detenerse. Las láminas recién fusionadas se abren en un modo de transmisión incluso antes de que sus teselas estén del todo preparadas. La **Gigapixel Gallery** de la barra lateral reúne las láminas publicadas de la institución, cada una con el camino de vuelta a su obra en el [Catálogo](/es/catalog/), junto a la forma 3D y las capas espectrales de la misma pieza. --- # La red de workers Detrás de cada modelo que se abre al instante y de cada lámina fusionada durante la noche está la **red de workers de AerariumChain**: un cuerpo distribuido de nodos de cálculo, coordinado por el Hub, que carga con todo el trabajo técnico pesado para que ningún museo tenga que sostenerlo en solitario. ## El trabajo que asume - La conversión de formatos, las texturas y los niveles de detalle de cada entrega 3D. - La resolución de las sesiones en bruto del escáner en mallas terminadas. - El perfilado de color, la alineación y la fusión final de las láminas gigapíxel. - Los derivados de preservación que empaqueta **DPAC** (Ecomic). - El renderizado en la nube que sostiene el [visor 3D](/es/3d-viewer/): cada sesión de visualización se sirve en directo desde un nodo de la red. Cada entrega o solicitud se convierte en un trabajo; los nodos declaran para qué están equipados (procesadores gráficos, software instalado), reciben los trabajos que les corresponden, y el Hub equilibra la cola, reintenta lo que falla y lleva el libro de cuentas. El material sensible no abandona nunca el circuito de AerariumChain. Los administradores lo observan todo en el **Worker Monitor**: los nodos en línea, su carga y su temperatura, la cola, el historial de trabajos. Cada nodo puede ajustarse, admitirse en ciertas familias de trabajo y excluirse de otras. ## Una infraestructura compartida para el patrimonio cultural La red está concebida para crecer como una **infraestructura común**, al modo en que siempre se han compartido las grandes empresas de la conservación. Museos, instituciones públicas, organismos de investigación y empresas asociadas pueden sumarse a ella operando un nodo: - **Quién puede sumarse**: instituciones, organismos de investigación, museos y empresas asociadas a AerariumChain. - **Qué aporta un nodo**: tiempo de cálculo para el procesamiento y el renderizado, coordinado automáticamente por el Hub. - **Qué recibe un miembro**: capacidad de procesamiento para sus propias colecciones, y un lugar en una red cuyo propósito es la preservación del patrimonio. Una institución interesada en operar un nodo puede dirigirse a AerariumChain a través de [aerariumchain.com](https://aerariumchain.com). --- # Store El **Store** es donde el Hub adquiere nuevas capacidades. Ábralo desde la barra lateral izquierda: cada aplicación se presenta como una tarjeta; al seleccionarla se abre su ficha de presentación, con una descripción, lo que ofrece y la acción **Install** (instalar). ## Instalar una aplicación 1. Abra **Store** en la barra lateral izquierda. 2. Seleccione la tarjeta de la aplicación para leer su ficha. 3. Elija **Install**. Las aplicaciones instaladas ocupan su lugar en la barra lateral, listas para el uso. Las aplicaciones marcadas **Coming soon** (próximamente) anuncian lo que está en camino y todavía no pueden instalarse. Que el Store le aparezca o no depende de su rol: los administradores deciden qué roles de la institución tienen acceso a él. ## DPAC, de Ecomic **DPAC (Digital Preservation and Access Console)**, de **Ecomic**, es la primera aplicación instalable del Store, construida para la **MiC Digital Library** del Ministerio de Cultura italiano. Es el puente entre la colección digitalizada y su preservación a largo plazo: - Define la **plantilla de catálogo DPAC**, el formato de hoja de cálculo que el [Catálogo](/es/catalog/) del Hub e Import Data reconocen de forma nativa, de modo que el registro se lee como la hoja oficial. - Su **Package Manager** compone paquetes de preservación a partir de las obras digitalizadas, los deposita en la Digital Library y los **notariza**: un registro certificado y a prueba de manipulaciones de que el depósito tuvo lugar. - El Hub sigue cada paquete (en depósito, depositado, notarizado) y protege contra el borrado los derivados empaquetados mientras un paquete los cite: el registro de preservación no puede deshacerse calladamente. - El trabajo pesado del empaquetado lo realiza la propia [red de workers](/es/node-workers/) del Hub; a sus máquinas no se les pide nada. Una vez instalado, DPAC figura en la barra lateral con su Package Manager. ## Impresión 3D, de AerariumChain **3D Print** encarga impresiones físicas de sus obras a los talleres certificados de AerariumChain, directamente desde sus modelos 3D: réplicas museísticas, reproducciones táctiles en braille, series para la tienda. Los talleres compiten con sus presupuestos; usted paga con tarjeta o transferencia, y sus archivos 3D nunca salen de AerariumChain. Una vez instalada, ocupa su lugar en la barra lateral. Consulte la [guía de Impresión 3D](/es/3d-print/). ## Coming soon El estante crece. Aplicaciones ya anunciadas: | Aplicación | Lo que ofrecerá | |------------|-----------------| | **museAR** | Realidad aumentada construida a partir de sus obras digitalizadas: modelos, anotaciones y narraciones desplegados sobre la colección física. De AerariumChain. | | **MyTotem Manager** | Tótems táctiles interactivos para las salas, compuestos a partir de su Catálogo y desplegados en la sede a distancia. | | **VideoRender Maker** | Películas de presentación de los modelos 3D: giros de plataforma, trayectorias de cámara e iluminación, renderizados en la nube. | | **Image Render Maker** | Láminas con calidad de publicación de las obras escaneadas, para catálogos, impresiones y el gabinete de prensa. | | **SweetReach** | Piezas breves de vídeo a partir de la colección, publicadas en sus canales, con sus campañas planificadas y seguidas. | Nuevas aplicaciones se incorporan al Store a medida que se suman nuevos socios. --- # DPAC T2 Generator El **AerariumChain DPAC T2 Generator** es una aplicación de escritorio (macOS y Windows, con licencia) que AerariumChain pone a disposición de los proveedores de digitalización y de la Digital Library. Construye los **paquetes de actualización T2** de los objetos 3D y de los gigapíxeles, los verifica antes de comprimirlos, los escribe en un disco externo y emite un **certificado de verificación** con el registro de todos los controles y los documentos de paradatos adjuntos. Un paquete T2 es un *delta* sobre el paquete T1 ya ingerido por DPAC: contiene el METS actualizado (`RECORDSTATUS="UPDATE_3D"`, ID de cabecera igual al UUID del recurso asignado por DPAC), la carpeta de **paradatos** (el informe de configuración de la adquisición y el informe de procesamiento) y la carpeta **RAW_3D** con los datos brutos de adquisición. Las imágenes ya presentes en el T1 (la miniatura y las vistas de renderizado) se vuelven a poner también en el T2, copiadas byte a byte desde el paquete T1 y verificadas con los checksums del METS; máster y derivado siguen siendo referencias (opción: solo imágenes, todos los archivos del T1, ninguno). La herramienta tiene dos partes: un **constructor** (un procedimiento guiado) y un **verificador** (la interfaz de control con los paneles de paquetes generados y fallidos). Todo lo que hace la ventana puede dirigirse también desde una **API HTTP local**, de modo que un proveedor pueda integrar el packager en su propio sistema y conservar la interfaz para el trabajo manual en el PC. ## Instalación, acceso y licencia La app solo funciona con una **cuenta del Hub AerariumChain** y una **licencia activa**. El titular de la licencia (para la Digital Library, AerariumChain) decide qué cuentas pueden usarla y en cuántos ordenadores. **Descargar el instalador.** En el Hub, menú **DPAC → DPAC T2 Generator**, la página muestra la licencia de la cuenta y los botones para macOS (Apple Silicon o Intel) y Windows. La descarga queda registrada a nombre de la cuenta. Sin licencia activa los botones están desactivados. **macOS.** Abrir el archivo `.dmg` y arrastrar la app a Aplicaciones. La app está firmada y notarizada por Apple: se abre sin avisos. Si macOS mostrara igualmente un mensaje de app no verificada (por ejemplo con un archivo copiado desde una memoria USB), abrir **Ajustes del Sistema → Privacidad y seguridad** y elegir **Abrir igualmente**, o hacer clic derecho en la app → **Abrir**. **Windows.** Ejecutar `AerariumChain DPAC T2 Generator Setup .exe` y seguir la instalación (se puede elegir la carpeta). Mientras el instalador no esté firmado con el certificado de firma de código de Windows, puede aparecer uno de estos mensajes: | Mensaje | Qué hacer | |---|---| | **«Windows protegió su PC»** (Microsoft Defender SmartScreen) | hacer clic en **Más información**, comprobar que la app es «AerariumChain DPAC T2 Generator» y luego **Ejecutar de todas formas** | | El navegador marca el archivo como **«no se descarga habitualmente»** | en la lista de descargas elegir **Conservar** (Edge: … → Conservar → Mostrar más → Conservar de todos modos) | | **«Control inteligente de aplicaciones bloqueó una aplicación»** | con el Control inteligente de aplicaciones activo, Windows no abre apps sin firmar: [contáctenos](https://aerariumchain.com/es/contact/) para la versión firmada. El estado está en **Seguridad de Windows → Control de aplicaciones y navegador → Control inteligente de aplicaciones** | | El antivirus de la empresa pone el archivo en cuarentena | pedir al administrador de TI que permita el instalador y la carpeta de la app | **Primer inicio.** La app muestra el **contrato de licencia** (EULA) para aceptar y luego pide el acceso con la cuenta del Hub: la misma sesión lee los datos del Hub, sin un segundo inicio de sesión. Arriba aparecen el código de la licencia, el titular y la fecha de vencimiento; el mismo código figura en el certificado y en el paquete de verificación de cada paquete creado. **Licencia.** Cada ordenador en el que se inicia sesión ocupa una instalación de la licencia (volver a abrir la app en el mismo ordenador no consume otra). La licencia se renueva en línea cada 30 minutos; sin red la app funciona hasta 72 horas. Al vencer, o si se suspende, la app se bloquea e indica a quién dirigirse. **Actualizaciones.** Las versiones nuevas se descargan solas y se instalan al reiniciar (ver más abajo). ## Qué produce Por cada paquete el disco de destino recibe una carpeta con el nombre de la entrega, de modo que el listado se lee una línea por obra: ``` /CANTIERE_LOTTO_PK_T2/ CANTIERE_LOTTO_PK_T2.zip la entrega para la Digital Library CANTIERE_LOTTO_PK_T2_CERTIFICATO.pdf certificado de verificación CANTIERE_LOTTO_PK_T2_VERIFICA.zip el paquete de verificación para el control de calidad (ver abajo) CANTIERE_LOTTO_PK_T2/ la entrega sin comprimir, con el mismo nombre del ZIP (sobre la que corren los controles) .xml METS T2 (UPDATE_3D, UUID DPAC, SIZE y MD5 reales) _PARADATA_3D/ configuración de adquisición / ficha de levantamiento e informe de procesamiento (PDF) _RAW_3D/ datos brutos: export Artec (PLY + fotos), archivos, contenedor .acraw o proyecto original _Thumbnail_3D/ miniatura ya presente en el T1, repuesta en el T2 _6ViewImages_3D/ vistas de renderizado ya presentes en el T1, repuestas en el T2 CANTIERE_LOTTO_PK_T2_VERIFICA/ el paquete de verificación sin comprimir, con el mismo nombre de su ZIP ``` El ZIP de entrega contiene solo el contenido de la carpeta `CANTIERE_LOTTO_PK_T2/`. Todo lo demás queda fuera de la entrega. Para un **gigapíxel** (material HQ de D.PaC) el T2 tiene la misma forma: el METS del T1 gigapíxel con el estado de actualización (`UPDATE_HQ`, o `UPDATE_2D` si la Digital Library lo pide: se elige en Ajustes), las carpetas `_PARADATA_HQ` y `_RAW_HQ`, y como datos brutos las **imágenes de entrada del fotomosaico en RAW DNG** con al menos una toma con el **ColorChecker**, como pide el Ministerio. El informe de procesamiento describe el ensamblaje, la alineación, la calibración del color y la imagen máster. La estructura del paquete, la transformación del METS y las reglas de checksum son las mismas de la canalización del Hub AerariumChain: un paquete construido con la herramienta es idéntico a uno producido por el Hub. ![La vista de verificación: el paquete en examen, los paquetes generados y los fallidos con sus problemas](/downloads/dpac-t2-verifica.png) ## Crear un paquete a mano La sección **Crear paquete T2** es un procedimiento en cinco pasos. 1. **METS T1**: el METS exacto ingerido con el T1, desde un archivo local, desde una URL, o leído directamente del **Hub AerariumChain** (acceso con las credenciales del Hub, elección del hive y de la obra: la herramienta descarga el METS T1, el UUID DPAC, la ficha de levantamiento del Site Manager y el estado del derivado). Con el T1 llega también su paquete (del hub se leen solo las entradas necesarias), del que la miniatura y las vistas de renderizado se reponen en el T2. 2. **Identificación**: código de obra, código de lote y PK (dan nombre al ZIP), el prefijo del paquete (da nombre al METS y a las carpetas), el **UUID del recurso asignado por DPAC** tras la ingesta del T1, título y número de inventario. 3. **Paradatos**: los dos informes pueden generarse desde los formularios (la herramienta reproduce los modelos MiC) o adjuntarse como PDF ya listos; se pueden añadir otros documentos. 4. **RAW 3D**: los datos brutos de adquisición en una de cuatro formas: - la **exportación desde el proyecto Artec Studio** con la CLI `aec_artecViewer`, la misma herramienta que ejecuta el nodo GPU de AerariumChain: un PLY bruto por escaneo (cada frame tal como se registró) más las **fotos de los escaneos** (las imágenes de la cámara de textura, PNG sin pérdida, `_RAW_NN_INP_NNNN.png`) listadas en el METS como imágenes de entrada. Los filtros son los de la CLI (`kind`, `scan-geometry`, `target-total`, `max-size`, `on-oversize`): un escaneo excluido o rechazado por tamaño no deja ni PLY ni fotos, un archivo fusionado o incompleto hace fallar la exportación (puerta de procedencia del servidor DPAC). El proyecto puede ser una carpeta o un ZIP local, o el registrado en el hub, descargado antes de la exportación; - **archivos brutos** (un PLY por escaneo, imágenes, E57 ...), copiados y con hash; - el **formato abierto `.acraw`** (AerariumChain Raw): en lugar de archivos sueltos, un único contenedor con manifiesto, SHA-256 de cada archivo y root hash, verificable por cualquiera sin software propietario; se aplica tanto a los archivos brutos seleccionados como a la exportación Artec (PLY por escaneo + fotos); especificación en [github.com/aerariumchain/acraw-spec](https://github.com/aerariumchain/acraw-spec); - el **formato original** del software de adquisición: la carpeta del proyecto comprimida sin recompresión, o un archivo copiado byte a byte. 5. **Destino**: el disco externo (se listan los volúmenes montados y el espacio libre), verificación automática, ZIP (ZIP64 cuando hace falta) y certificado. ![El paso RAW 3D: exportación desde el proyecto Artec con la CLI integrada (PLY por escaneo + fotos), filtros de la CLI](/downloads/dpac-t2-raw.png) Desde el Hub, la herramienta también puede pedir al **propio Hub** que construya el T2: los PLY brutos se exportan del proyecto del escáner en un nodo GPU y el paquete se ensambla allí. ![El procedimiento guiado: METS T1 desde el Hub, identificación, paradatos, RAW 3D, destino](/downloads/dpac-t2-crea.png) ## Verificar un paquete La sección **Verificar paquetes** acepta la carpeta del paquete (antes del ZIP) o un ZIP ya creado. Los controles cubren: - el METS: XML bien formado, `PROFILE`, `OBJID`, cabecera (`RECORDSTATUS`, UUID, `CREATEDATE`, agentes), secciones descriptiva y administrativa, los campos obligatorios de los metadatos técnicos 3D, los identificadores duplicados; - la sección de archivos: vocabulario `USE`, el grupo `FG_3D` del T1, los grupos `STORAGE` y `RAW_3D`, los nombres de los documentos de paradatos; - cada archivo declarado en los grupos del T2: presencia, `SIZE`, `MD5`, `MIMETYPE`, `CREATED`, `ADMID`; la firma de los PDF; la cabecera de los PLY; los contenedores `.acraw` (reglas del contenedor, manifest, hashes, root hash, estructura); - la semántica del delta: ningún archivo del T1 dentro del paquete, ningún archivo sin declarar; - la comparación con el METS T1, cuando se proporciona; - opcionalmente, el validador público METS ECO-MiC de ICDP. Dos paneles guardan la historia: **paquetes generados** (verificación superada) y **paquetes fallidos**, cada uno con los problemas encontrados. Cada regla tiene un identificador estable (`HDR-ID`, `FSEC-STORAGE`, `FILE-MD5` ...) que aparece también en el certificado y en las respuestas de la API. ## El paquete de verificación para el control de calidad Junto a cada entrega la herramienta escribe un **paquete de verificación**: la carpeta `CANTIERE_LOTTO_PK_T2_VERIFICA/` y su copia `CANTIERE_LOTTO_PK_T2_VERIFICA.zip` (las carpetas sin comprimir pueden desactivarse en los ajustes). Está pensado para el control de calidad de la Digital Library: quien recibe el ZIP de entrega puede comprobar que llegó intacto, leer el registro de los controles y saber cómo se construyó, sin abrir el paquete. Para el paquete `3D03CE01_LDIG013_PK0000002_T2` contiene: | Archivo | Qué es y para qué sirve | |---|---| | `3D03CE01_LDIG013_PK0000002_T2_CERTIFICATO.pdf` | el certificado de verificación (ver abajo), copia del que está junto al ZIP | | `3D03CE01_LDIG013_PK0000002_T2.zip.md5` | la huella MD5 del ZIP de entrega en formato `md5sum`: el hash, dos espacios, el nombre del archivo. Desde la carpeta donde está el 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 el hash coincide, el ZIP recibido es byte a byte el producido | | `3D03CE01_LDIG013_PK0000002_T2.zip.sha256` | la misma huella con SHA-256 (`sha256sum -c …` en Linux, `shasum -a 256 -c …` en macOS): más robusta que MD5, es la que figura también en el certificado | | `rapporto.json` | el registro completo de los controles, legible por máquina: `ok`, `errors`, `warnings`, la lista `items[]` (cada control tiene un `id` estable como `HDR-ID`, `FSEC-STORAGE`, `FILE-MD5`, `T1-FILES`, un `level` `error|warn|info|ok`, el mensaje y el archivo afectado) y `summary` (tipo, OBJID, UUID DPAC, RECORDSTATUS, recuentos, inventario con MD5) | | `build.json` | cómo se construyó el paquete: la especificación de build (identificadores, origen del T1, paradatos, modo RAW, opciones), de dónde viene el T1, los archivos producidos con tamaño y MD5, la herramienta de exportación y su versión | | `t1.xml` | el METS T1 ingerido por DPAC del que deriva el T2: sirve para rehacer la comparación delta (cada archivo del T1 citado en el T2 debe conservar los mismos SIZE y CHECKSUM); la app lo reutiliza sola cuando alguien verifica el ZIP | | `METS_.xml` | copia del METS T2 entregado | | `METS__RELAZIONE_SETUP-ACQUISIZIONE.pdf`, `METS__RELAZIONE_ELABORAZIONE.pdf` | copias de los documentos de paradatos, para leerlos sin abrir el paquete | | `artec-manifest.json` | (modo Artec) el manifiesto de la CLI: por cada PLY bruto el escaneo de origen, frames totales y usados, HD/SD, MD5, y la lista de fotos | | `inventario.txt` | una línea por archivo del paquete: MD5, tamaño, grupo METS (STORAGE, RAW_3D, LOW, PREVIEW…), ruta | | `LEGGIMI.txt` | qué es la carpeta, resultado e identificadores del paquete, los problemas detectados y la lista de arriba | Un error bloquea el ZIP; un aviso no. El paquete de verificación se produce también cuando un paquete solo se verifica (una carpeta o un ZIP recibido de un proveedor), junto al archivo controlado. ## El certificado de verificación Cuando un paquete supera la verificación, la herramienta escribe un PDF **fuera del paquete**: la identidad del paquete, SHA-256 y MD5 del METS y del ZIP, el registro completo de los controles con su resultado, el inventario de los archivos con sus hashes. Los PDF de paradatos no se adjuntan: están en el paquete entregado y en el paquete de verificación. Es el documento que debe conservarse con la entrega. ## La API local La ventana y la API comparten el mismo código. La API escucha solo en el PC (`http://127.0.0.1:47821/api/v1`, puerto y token opcional en la configuración) y está descrita por un documento **OpenAPI 3.0** servido por la app en `/api/v1/openapi.json` y descargable aquí: [dpac-t2-openapi.json](/downloads/dpac-t2-openapi.json). ![Configuración: acceso al Hub, API local con el contrato OpenAPI, validador público, valores predeterminados](/downloads/dpac-t2-impostazioni.png) ![Ajustes: monitorización y asistencia, valores predeterminados y carpetas sin comprimir con el nombre de los ZIP](/downloads/dpac-t2-artec.png) | Método | Ruta | Finalidad | |---|---|---| | GET | `/health` | estado de la app | | GET | `/openapi.json` | el contrato de la API | | GET | `/disks` | volúmenes montados y espacio libre | | GET | `/artec/status` | ¿se puede usar la CLI `aec_artecViewer`? (ruta, Node, versión) | | POST | `/artec/list` | lista escaneos, frames y fotos de un proyecto Artec | | POST | `/build` | crea un paquete T2 (job) a partir de una `BuildSpec` | | POST | `/check` | verifica una carpeta o un ZIP (job, o síncrona con `wait: true`) | | POST | `/zip` | verifica y comprime la carpeta de un paquete (job) | | POST | `/acraw` | envuelve archivos brutos en un contenedor `.acraw` (job) | | POST | `/pdf/setup`, `/pdf/elaborazione` | genera los dos informes de paradatos | | GET | `/jobs`, `/jobs/{id}` | estado, resultado y eventos de un job | | GET | `/jobs/{id}/events` | los mismos eventos como Server-Sent Events | | GET, DELETE | `/packages`, `/packages/{id}` | el registro de paquetes generados y fallidos | Autenticación: ninguna por defecto; cuando en la configuración se define un token, debe enviarse como `X-Api-Token` o como bearer token. Cada ruta en las peticiones es una ruta en el PC donde se ejecuta la app. ### La petición de construcción ```json { "identity": { "codiceCantiere": "3D03CE05", "codiceLotto": "LDIG003", "pk": "PK0000002", "objid": "M489_XXXX", "dpacUuid": "6f1c2a3e-4b5d-4e6f-8a9b-0c1d2e3f4a5b", "title": "Título de la obra", "inventory": "INV-1", "catalogId": "XXXX" }, "t1": { "source": "file", "path": "/datos/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": "/datos/raw/M489_XXXX", "extensions": ["ply"], "acraw": { "enabled": false } }, "options": { "overwrite": true }, "output": { "dir": "/Volumes/DISCO/T2", "zip": true, "keepStaging": true } } ``` - `t1.source` es `file` o `url` (con `headers`). - `paradata.*.mode` es `generate` (desde los datos), `file` (un PDF existente, `path`) o `none`. - `raw.mode` es `artec` (con `raw.artec`: `projectPath` o `projectS3Key`, `kind`, `scanGeometry`, `targetTotal`, `maxSize`, `onOversize`, `maxTotalSize`, `photos`), `files`, `folder`, `original` (con `originalPath` y `originalVendor`) o `none`; `raw.acraw.enabled` activa el contenedor abierto. El manifiesto de la CLI Artec se conserva en `verifica/artec-manifest.json`. ### El flujo de 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 ``` Los eventos de progreso llevan `step`, `percent` y `message`; el resultado de una construcción lleva las rutas de la carpeta, del ZIP (con tamaño y MD5), del informe de verificación y del certificado. Una verificación síncrona: ``` POST /check { "target": "/Volumes/DISCO/T2/3D03CE05_LDIG003_PK0000002_T2.zip", "wait": true } -> 200 { "report": { "ok": true, "errors": 0, "warnings": 0, "items": [...], "certificatePath": "..." } } ``` Las mismas operaciones están disponibles desde la línea de comandos (`dpac-t2 build`, `check`, `zip`, `acraw`, `pdf-setup`, `pdf-elab`), con el mismo código. ## Guía y soporte AI Esta página es la guía de la app: el menú **Guía** la abre en el navegador. La misma guía en Markdown, pensada como contexto para un asistente AI, se descarga aquí: [dpac-t2-guida.md](/downloads/dpac-t2-guida.md) (en italiano). El menú **Conectar a AI** reúne todo lo que permite a un asistente (Claude Code, Claude Desktop, ChatGPT) o al equipo AerariumChain ayudar cuando algo falla: - **Exportar diagnóstico para la AI**: un archivo Markdown (o una copia al portapapeles) con entorno, ajustes sin secretos, paquetes fallidos con sus problemas, el informe de verificación del paquete elegido, una nota del operador, las últimas líneas del log y la guía. Nunca los archivos de los paquetes. El mismo botón está en cada paquete fallido. - **Conector MCP**: la app es un servidor MCP (Model Context Protocol) local. Con un clic se conecta a Claude Code o Claude Desktop, que pueden leer estado, paquetes, informes y log, lanzar una verificación o una construcción y resolver el problema en directo con el operador. ChatGPT requiere un servidor público: se usa la exportación de diagnóstico. - **Guía** (enlace y descarga) y **Pedir asistencia** (solicitud al equipo con el contexto de la app). ![Conectar a AI: diagnóstico, guía, conector MCP, asistencia](/downloads/dpac-t2-ai.png) ## Actualizaciones, monitorización y asistencia La app dialoga con el manager AerariumChain (manager.aerariumchain.com) a través del Hub, con un identificador de instalación y, si el operador está conectado, con su sesión: - **Actualizaciones**: al arrancar y cada seis horas comprueba si se ha publicado una versión más reciente; si la hay, la descarga en segundo plano y la barra lateral muestra "Actualización X" con el progreso y el botón Reiniciar y actualizar (también se instala al cerrar). AerariumChain puede marcar una versión como obligatoria o forzar la actualización de una instalación desde el manager: la app la instala sola en cuanto no tiene trabajos en curso. - **Monitorización**: por cada paquete creado envía un informe con identificadores (paquete, prefijo, UUID DPAC, obra, hive), resultado de la verificación con los problemas detectados, hash y tamaño del ZIP, recuentos (paradatos, PLY, fotos, imágenes del T1), herramienta de exportación y duraciones. Nunca los archivos del paquete. Los eventos se encolan sin conexión y salen en la primera conexión; se desactiva en Ajustes → Monitorización. - **Asistencia**: "Pedir asistencia" en la barra lateral abre una solicitud al equipo AerariumChain con la versión de la app, el sistema, el estado de la CLI y las últimas líneas del log; la respuesta llega al email indicado. ## Requisitos y distribución - macOS 11 o posterior (Apple Silicon o Intel) o Windows 10/11 de 64 bits; no hace falta otro software (los PDF de paradatos los genera la herramienta). - Espacio en el disco de destino para los datos brutos y para el ZIP. - Una cuenta del Hub AerariumChain con una licencia activa, y conexión a internet al menos una vez cada 72 horas. - La CLI `aec_artecViewer` para la exportación desde proyectos Artec está integrada en la app (tomada de su propio repositorio al compilar) y se ejecuta con el runtime de la app: no hay nada que instalar. El instalador se descarga del Hub con una cuenta que tiene la licencia. Para una licencia o asistencia [contáctenos](https://aerariumchain.com/es/contact/).