Un Totebox Archive es una bóveda soberana de datos asignada a una única entidad — un edificio, una empresa, una persona, o cualquier otra unidad que el operador defina. Es la unidad fundamental de almacenamiento e identidad de la pila PointSav. El archivo se empaqueta como una imagen de disco de arranque y se ejecuta como una máquina virtual en la capa de hipervisor PPN. Se publica bajo Apache 2.0 y está disponible de forma gratuita: un operador, un archivo, es un despliegue gratuito.

La imagen de disco es el archivo

La propiedad más importante de un Totebox Archive es que la imagen de disco de arranque y el archivo son la misma cosa. No existe una base de datos externa, ni un bucket de almacenamiento en la nube, ni un registro central que contenga los datos del archivo. La imagen de disco contiene todo: los datos, el par de claves de identidad y el sistema operativo que sirve las consultas.

Esto significa que un archivo puede ser:

• Detenido — la VM se apaga; no se pierden datos; nada caduca
• Copiado — la imagen de disco es un archivo que puede duplicarse como cualquier otro archivo
• Reubicado — la copia se inicia en un nodo PPN diferente; el hipervisor del nodo de destino asigna recursos de su propio pool para la nueva VM
• Reanudado — el archivo continúa exactamente desde el estado en que se encontraba cuando fue detenido

El hipervisor del nodo receptor no sabe nada sobre los datos dentro de la VM. Asigna CPU y RAM de su pool por nodo para alojar la VM. La identidad, las claves y los datos del archivo viajan con la imagen de disco sin cambios. Esta es la propiedad de transferencia libre.

Modelo de almacenamiento: archivos planos WORM

Un Totebox Archive almacena datos como archivos planos inmutables:

Formato	Contenido
JSONL	Registros estructurados (entradas de libro mayor, registros de eventos, metadatos de entidades)
GeoParquet	Datos geoespaciales (límites de sitios, registros de ubicación)
Markdown	Documentos legibles por humanos (memorandos, notas, informes)

Cada escritura añade datos; ningún registro se modifica ni elimina jamás. Este es un libro mayor de Escritura Única, Lectura Múltiple (WORM). El archivo acumula un historial completo e inalterable de cada entrada registrada. No existe operación DELETE ni operación UPDATE — solo anexado. Una entrada que debe ser reemplazada es seguida por una entrada de corrección; la entrada original permanece permanentemente visible en el registro.

Este diseño es intencional: el archivo es un registro de calidad legal de lo que una entidad sabía y cuándo lo sabía. La garantía de inmutabilidad es estructural, no una opción de configuración.

Modelo de acceso: solo Diodo + PSP

Un Totebox Archive no expone una API de propósito general. Responde solo a consultas entregadas a través del Diode Standard — el flujo de comandos unidireccional que gobierna la pila PointSav:

os-console  ──┐
               ├──▶  os-orchestration  ──▶  os-totebox (dentro de la VM del archivo)
               │         (PSP)
               └──▶  os-totebox (directo, archivo único)

Las consultas llegan como objetos de capacidad firmados entregados a través del PointSav Protocol (PSP), un protocolo binario basado en capacidades que tuneliza sobre TLS. Un objeto de capacidad otorga permiso para leer una fila específica o un conjunto de filas — nada más. El archivo verifica la firma del objeto contra su par de claves MBA, ejecuta la consulta y devuelve solo las filas de resultados coincidentes. Nunca devuelve registros sin procesar en bloque. Nunca acepta comandos desde una dirección fuera del flujo del Diodo.

Ninguna VM puede emitir comandos de regreso al plano de control. Ningún archivo puede instruir a la malla PPN para añadir o eliminar un nodo. El flujo es estructuralmente unidireccional.

Par de claves de autorización basada en máquina

Cada Totebox Archive contiene un par de claves Ed25519. Este par de claves es la identidad del archivo en la malla PointSav. Está registrado en pairings.yaml, el archivo que gobierna qué operadores y orquestadores están autorizados para consultar el archivo.

Los tipos de emparejamiento son:

Tipo	Nivel de acceso
ADMIN	Autoridad administrativa total sobre este archivo
INPUT	Lectura-escritura; emparejamiento predeterminado para entrada de datos activa
USER	Solo lectura
INTERFACE	Solo metadatos; sin contenido de registros

Un operador sin entrada en pairings.yaml no puede consultar el archivo, independientemente de si está en la misma malla PPN. La accesibilidad de red y el acceso a datos son planos separados sin autoridad compartida.

Convención de nomenclatura del clúster

Los archivos se nombran con el prefijo cluster-totebox- seguido del dominio de datos y un número de instancia:

Nombre de instancia	Dominio
cluster-totebox-corporate-1	Registros de entidades corporativas
cluster-totebox-personnel-1	Registros de personal
cluster-totebox-property-1	Registros de bienes inmuebles

El prefijo cluster- indica una instancia de VM gestionada por la capa de hipervisor PPN. El sufijo numérico permite que múltiples archivos del mismo dominio coexistan en la misma flota.

Relación con la familia de SO

Componente	Rol
os-totebox	El sistema operativo que se ejecuta dentro de la VM del archivo; gestiona el libro mayor WORM y la superficie de consulta PSP
os-console	Un terminal nativo de teclado que se conecta a un archivo a la vez; nivel gratuito
os-orchestration	Un agregador sin estado de múltiples archivos que distribuye consultas a través de muchos archivos mediante PSP; nivel de pago
os-infrastructure	El hipervisor Tipo I que aloja VMs de archivo y gestiona el pool de recursos por nodo

os-totebox y os-console son Apache 2.0 — gratuitos. os-orchestration introduce el límite comercial: consultar un único archivo directamente a través de os-console es gratuito; enrutar consultas a través de múltiples archivos mediante os-orchestration es el nivel de pago.

Lo que un Totebox Archive no es

• No es una base de datos. No existe planificador de consultas, índice ni registro de transacciones en el sentido de bases de datos relacionales. El archivo es un libro mayor de solo anexado que devuelve filas que coinciden con un objeto de capacidad firmado.
• No es almacenamiento en la nube. No hay bucket S3, API de almacenamiento de objetos ni URL prefirmada. Los datos salen del archivo solo a través de la ruta Diodo + PSP.
• No es un recurso compartido de archivos. No hay recurso compartido SMB, montaje NFS ni punto final SFTP. Los operadores acceden a los datos a través de os-console o os-orchestration, no a través de protocolos de sistema de archivos.
• No es una VM en el sentido general. La VM es el medio de empaquetado. El archivo son los datos, la identidad y la historia que contiene. Cuando alguien se refiere al "Totebox Archive", se refiere a la imagen de disco y su contenido — no a la instancia del hipervisor que en este momento la ejecuta.

Temas relacionados

• infrastructure-os — el hipervisor Tipo I que aloja VMs de archivo y gestiona el pool de recursos
• ppn-hypervisor-resource-pool — cómo el hipervisor otorga y recupera CPU/RAM de cada VM
• machine-based-auth — el modelo de par de claves Ed25519 que gobierna el acceso al archivo
• diode-standard — el flujo de comandos unidireccional que atraviesa cada consulta al archivo