Skip to content

PointSav Documentation

The engineering library for the PointSav platform — operating systems and services for regulated businesses that own their data, their AI, and their record-keeping outright. Where the monorepo holds the code, this wiki holds the reasoning: architecture, services, security, and the governance commitments that bind future development.

Máquina de entrada

La Máquina de Entrada es la puerta obligatoria de incorporación a través de la cual todos los documentos y textos ingresan a los flujos de trabajo de os-console. Ocupa permanentemente la tecla F12 en todas las configuraciones de teclado. Cada cartucho en os-console depende de la Máquina de Entrada para su material de origen. Ningún flujo de trabajo la evita.

Por qué la posición es permanente

La tecla F12 ocupa la posición límite en la fila de teclas de función, separada físicamente de F1–F11 por un espacio más amplio en la mayoría de los teclados. Esta posición es deliberada. La Máquina de Entrada no es una función de flujo de trabajo; es un control de frontera. Debe ser localizable inmediata e inequívocamente sin importar qué cartucho esté activo.

La decisión de arquitectura de sistema SYS-ADR-10 establece F12 como el punto de control humano obligatorio para todas las operaciones de ingesta. La asignación no puede ser evitada por otro panel ni reasignada. Estas restricciones se aplican en el despachador de eventos de app-console-keys, no por convención.

Qué ocurre al presionar F12

Al presionar F12 en cualquier punto de os-console se suspende el cartucho activo y se abre el modal de la Máquina de Entrada. El operador completa el flujo de ingesta. Luego el cartucho se reanuda.

El flujo de ingesta opera así. Un modal presenta el campo de ruta del archivo; el operador ingresa y confirma la ruta (no se acepta envío pasivo). app-console-input envía la ruta, el nombre de usuario y el arrendatario al endpoint /v1/append de service-input en el Archivo Totebox. service-input lee el archivo, lo verifica por hash y lo omite si ya fue procesado; a los archivos nuevos les asigna una marca de destino aproximada — service-research o service-minutebook si la ruta contiene esa cadena, service-content en cualquier otro caso — y los reenvía a service-fs. service-input escribe su propia entrada de ledger (ID de carga, ruta, hash, marca de tiempo, marca de destino) y app-console-input escribe un registro local (marca de tiempo, operador, arrendatario, ruta, estado). Por último, el cartucho activo se reanuda con el documento incorporado disponible en su contexto.

service-input: el servicio frontera de ingesta

service-input es la contraparte del lado servidor del cartucho de la Máquina de Entrada, ejecutándose en el Archivo Totebox. Lee un documento una vez, lo deduplica por hash de contenido y lo reenvía a service-fs bajo una etiqueta aproximada. No clasifica el tipo de documento ni lo enruta a distintos servicios según su contenido — todo archivo no duplicado termina en service-fs, distinguido solo por su etiqueta, sin una ruta separada hacia service-proofreader, un manejador específico para BIM, ni ningún otro destino sensible al contenido.

service-input no realiza inferencia de inteligencia artificial — la asignación de etiqueta es una simple comprobación de subcadena sobre la ruta del archivo, no un clasificador por tipo MIME o firma estructural. Esto mantiene el paso de ingesta reproducible e independiente de la disponibilidad del modelo, conforme a SYS-ADR-07.

La pista de auditoría

Cada documento que pasa por la Máquina de Entrada genera dos registros.

Un registro local en SQLite en la máquina de os-console guarda la marca de tiempo, el operador, el arrendatario, la ruta del archivo y un campo de estado. Este registro local persiste incluso si el Archivo Totebox no está disponible.

Una entrada de ledger independiente en el propio service-input registra el ID de carga, la ruta del archivo, el hash de contenido, la marca de tiempo y la etiqueta de destino asignada. Juntos, estos dos registros establecen cuándo llegó un documento, quién lo envió y adónde se reenvió — pero ninguno registra una clasificación de contenido, porque no se realiza ninguna.

El cartucho app-console-input

app-console-input es el crate del cartucho F12 en pointsav-monorepo. Implementa el flujo de trabajo de la Máquina de Entrada en el lado cliente de os-console: renderiza el modal de entrada de ruta de archivo, envía la solicitud POST a service-input con un tiempo de espera de 30 segundos, y escribe la entrada de auditoría local en SQLite. Cuando termina la ingesta, devuelve el control al cartucho previamente activo.

app-console-input siempre está instalado y el modal siempre es accesible mediante F12. Esto no es configurable.

Cumplimiento de ADR-07

SYS-ADR-07 establece que ningún dato estructurado pasa por inferencia de IA. La Máquina de Entrada aplica esta regla en la frontera de ingesta — la asignación de etiqueta de service-input es una comprobación de subcadena determinista sobre la ruta del archivo, no una llamada a un modelo. Dado el mismo archivo, service-input siempre produce la misma etiqueta, y el registro de auditoría nunca depende de versiones del modelo ni de la disponibilidad de la inferencia.

La arquitectura sin formularios

La Máquina de Entrada es el fundamento de lo que la documentación operativa describe como la arquitectura sin formularios. Los flujos de trabajo tradicionales requieren que el operador rellene campos para contextualizar un documento antes de que ingrese al sistema. La Máquina de Entrada invierte esto: el operador proporciona un documento y confirma la intención, y el sistema lo registra, etiqueta y reenvía sin más captura de datos. La única entrada requerida es el documento en sí y una confirmación explícita de la intención de enviarlo.

Reanudación tras la ingesta

Cada cartucho utiliza la misma Máquina de Entrada para su material de origen, y F12 siempre devuelve el control al cartucho que estaba activo cuando se presionó. Es el cartucho activo, no la etiqueta de destino asignada, lo que determina qué ocurre con el documento dentro del flujo propio de ese cartucho. La etiqueta que asigna service-input es independiente de qué tecla de función abrió el modal — refleja solo dónde coincidió el texto de la ruta, no qué cartucho envió el archivo.

Véase también

Cite this record: /wiki/input-machine — revision 056ab965, last updated 24 August 2026.

Important Information

Estructura corporativa. PointSav Digital Systems ("PointSav") es actualmente un nombre comercial de Woodfine Capital Projects Inc. ("Woodfine"), con previsión de convertirse en una subsidiaria de propiedad absoluta de Woodfine tras su incorporación. PointSav no ofrece, vende ni solicita por sí mismo valor alguno. Toda oferta de valores asociada a las soluciones inmobiliarias de tenencia directa de Woodfine se realiza exclusivamente por parte de Woodfine, y únicamente por medio del Memorando de Colocación Privada aplicable.

Sin asesoramiento de inversión. El contenido de este wiki se ofrece con fines de ingeniería, operativos, de investigación y de desarrollo. Nada de lo que figura en este wiki constituye asesoramiento de inversión ni una solicitud para invertir en ninguna sociedad o solución de tenencia directa de Woodfine.

Propiedad intelectual. El nombre, el nombre comercial, el logotipo y las marcas de PointSav, junto con todos los productos, servicios y ofertas actuales y futuros de las marcas PointSav y Totebox — así como el software, el código fuente, la documentación, el sistema de diseño y todos los materiales relacionados — son propiedad de Woodfine y sus filiales, salvo los componentes identificados como de código abierto. No se otorga ningún derecho salvo el expresamente establecido en una licencia o acuerdo por escrito. El aviso de marcas completo aparece en el pie de página de cada página de este sitio.

Componentes de código abierto. Algunas partes de la plataforma se ofrecen bajo licencias de código abierto permisivas identificadas en el repositorio correspondiente. El uso de esos componentes se rige por los términos de sus respectivas licencias.

Sin garantía; uso informativo. El contenido de este wiki se ofrece únicamente con fines informativos generales y no constituye una declaración, garantía ni compromiso respecto de la funcionalidad, disponibilidad, precio o hoja de ruta de ningún producto. Algunos artículos describen características, capacidades e hitos planificados o previstos — el lenguaje como "planificado", "previsto", "objetivo", "puede" y "esperado" marca este contenido prospectivo, que está sujeto a cambios y no constituye un compromiso respecto del rendimiento futuro.

Confidencialidad. Cuando un artículo describiría un detalle operativo o de implementación no destinado a divulgación pública, ese artículo no se publica en este wiki. El contenido aquí es documentación de ingeniería de uso general, no configuración específica de clientes.

Jurisdicción. Woodfine Capital Projects Inc. está constituida en Columbia Británica, Canadá. Las referencias a la Sovereign Data Foundation en este wiki describen una iniciativa planificada o prevista únicamente, no una titular de capital actual ni un órgano de gobierno activo.

Cambios a este aviso. PointSav podrá actualizar este aviso periódicamente; rige la versión publicada en esta página.

No es un sistema de presentación de documentos. Este wiki no es un sistema de presentación de valores, un repositorio de divulgación electrónica ni un sustituto de SEDAR+ ni de ningún otro sistema de presentación regulatorio. Las presentaciones formales de valores se realizan a través del sistema de presentación regulatorio correspondiente, no a través de este wiki.

Descargo completo. Este aviso complementa, y no sustituye, el artículo completo de Avisos Legales. En caso de cualquier conflicto, prevalece el artículo de Avisos Legales.

Read the full disclaimer →