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.

Autoalojar un sistema de diseño, y por qué es distinto de usar los tokens

El Sistema de Diseño PointSav hace dos ofertas, dirigidas a lectores distintos. La primera — la principal — son los propios datos de tokens: decisiones de color, tipografía, espaciado, movimiento, voz de contenido y formato documental publicadas como JSON en formato DTCG del W3C bajo Apache-2.0. Cualquiera puede usarlos como los equipos usan Carbon de IBM o Material de Google: incorporar el grafo de tokens a su propio proceso de construcción y seguir adelante. No se requiere nada más: ni cuenta, ni servidor, ni bifurcación, ni relación alguna con PointSav.

La segunda oferta es autoalojar el motor que sirve este sitio. Esa oferta no es una versión ampliada de la primera, y no es una manera de replicar los tokens de PointSav en hardware propio. Está pensada para una organización distinta que quiere construir y operar su propio sistema de diseño — sus propios tokens, su propia marca, su propio dominio — sobre la misma maquinaria de publicación que opera PointSav, abordando la misma brecha de mercado de precios de nivel empresarial que describe la filosofía del sistema de diseño para el propio sustrato de PointSav. Las dos ofertas son separables por diseño, y confundirlas tergiversa ambas. Este artículo explica cada una en sus propios términos, y dónde pasa exactamente la línea entre ellas.

Usar los tokens no requiere nada

El problema del formato de los tokens de diseño está resuelto. El Design Tokens Community Group del W3C publicó la primera versión estable de su Format Module en octubre de 2025, y el formato está implementado en las principales herramientas de autoría y construcción. El grafo de tokens de PointSav — más de 200 tokens hoja resueltos entre los niveles primitivo, semántico y de tema oscuro, en crecimiento junto con el sistema — se publica en ese formato, bajo Apache-2.0, en un repositorio git público.

Esa es toda la transacción. Un equipo que quiere los tokens clona o descarga los datos, los resuelve con las herramientas que ya usa, y publica. Los tokens no llaman a casa, no requieren que el servidor de PointSav exista, y no imponen ninguna obligación más allá de los términos de atribución de Apache-2.0. Si design.pointsav.com desapareciera mañana, cada copia de los datos de tokens seguiría funcionando, porque los datos nunca estuvieron acoplados al servicio que los publica.

Si eso es lo que vino a buscar, puede dejar de leer aquí.

Qué es realmente el autoalojamiento

El autoalojamiento atiende un problema distinto: no "cómo consumo un grafo de tokens", sino "cómo gobierna, versiona, documenta y publica mi organización su propio grafo de tokens a lo largo del tiempo". El software que hace esto — la capa que ocupan comercialmente zeroheight, Supernova, Knapsack y plataformas similares — se entrega casi exclusivamente como software como servicio alojado por el proveedor, lo que exige que los datos de tokens del cliente residan en la infraestructura del proveedor. El zeroheight Design Systems Report 2026 encuentra que solo el 40% de los equipos encuestados tiene siquiera una cadena automatizada de tokens; el resto sincroniza a mano. Y para una clase específica de comprador — servicios financieros, jurídicos, gobierno — el alojamiento por terceros no es solo incómodo sino con frecuencia descalificante, porque la postura de cumplimiento que gobierna dónde pueden residir los artefactos de una organización rara vez contempla una excepción para los activos de diseño. La investigación sobre dependencia de proveedor en la nube documenta la asimetría de fondo: Opara-Martins, Sahandi y Tian, encuestando a 114 profesionales empresariales en 2016, identificaron la portabilidad de datos y la incompatibilidad de integración como los riesgos dominantes de dependencia una vez que los activos pasan a infraestructura controlada por el proveedor.

La oferta de autoalojamiento es el motor detrás de este sitio, operado por otra organización para el sistema propio de esa organización. La empresa que bifurca no hereda las decisiones de marca de PointSav — las reemplaza. Lo que hereda es la maquinaria: la estructura del vault, el renderizado de la galería de tokens, la cadena de exportación resuelta, los puntos de acceso legibles por máquina y el modelo de gobernanza. Los tokens propios de PointSav son, para un cliente que se autoaloja, contenido de ejemplo.

El mecanismo: bifurcar y ejecutar

El procedimiento documentado tiene cinco pasos: hacer una bifurcación (fork) del repositorio público; clonar el fork en su propio servidor; editar el directorio de temas del vault para declarar las anulaciones primitivas de su marca; ejecutar el binario de servicio apuntado a su directorio de vault; y poner delante su propio proxy inverso y certificado TLS, bajo su propio dominio.

Toda la superficie de configuración de arrendamiento son tres variables de entorno. DESIGN_VAULT_DIR nombra la ruta del sistema de archivos a su vault. DESIGN_TENANT nombra su marca, coincidiendo con un nombre de archivo de tema dentro de ese vault. DESIGN_BIND nombra la dirección en la que escucha el proceso. Un binario sirve el vault de un arrendatario por proceso — no hay base de datos multiarrendatario ni infraestructura compartida entre el despliegue de una organización y el de otra. Nada en el procedimiento transmite sus datos de tokens o temas a PointSav, y la instancia en ejecución no hace ninguna llamada a la infraestructura de PointSav en tiempo de solicitud. Cambiar de proveedor, o dejar el despliegue completamente fuera de línea para una auditoría, significa mover un directorio y reiniciar un proceso, porque no hay paso de exportación de datos: los datos nunca vivieron en otro lugar que su propio repositorio.

La gobernanza sale del mismo lugar. Las plataformas alojadas ofrecen permisos de edición, historial de versiones y revisión de cambios mediante controles de capa de aplicación sobre una base de datos operada por el proveedor; el modelo de bifurcar-y-ejecutar ofrece el equivalente mediante el control de versiones del propio cliente. Los cambios de tokens son commits, los derechos de edición son protección de ramas, el historial es el registro de git, la revisión es un pull request — infraestructura que un comprador regulado ya opera y ya ha auditado.

Qué licencia aplica a qué

Las dos ofertas también se separan con nitidez en la frontera de licencias, y aquí la precisión importa:

  • Datos de tokens y componentes — Apache-2.0. El JSON DTCG, las recetas de componentes y los archivos de investigación del repositorio del sistema de diseño. Es la capa que se consume directamente, y la capa que un fork reemplaza con su propio contenido.
  • Código del servidor — AGPL-3.0-or-later. El motor de servicio (app-privategit-design en el monorepo de PointSav). Ejecutarlo sin modificaciones para la propia organización no conlleva ninguna carga inusual; una organización que modifica el servidor y lo ofrece a usuarios a través de una red asume la obligación de la Sección 13 de la AGPL de ofrecer a esos usuarios el código fuente modificado. Para las organizaciones que no pueden aceptar esa obligación, la matriz de licencias del proyecto ratifica un nivel comercial alternativo compatible con Apache; su presentación exacta a los clientes que se autoalojan aún está por definirse.
  • Este artículo — CC BY 4.0, la licencia del wiki de documentación en el que se publica. El texto del artículo no es ni datos de tokens ni código del servidor, y ninguna de las tres licencias sustituye a las otras.

Alcance y límites

Dicho con claridad: el procedimiento de bifurcación está documentado, y cada uno de sus pasos usa herramientas ordinarias y verificables de forma independiente — git, variables de entorno, una unidad de systemd, un proxy inverso. Pero al momento de escribir, ninguna organización fuera de PointSav ha ejecutado el procedimiento de principio a fin en producción; la propia instancia de PointSav es el único despliegue. Toda afirmación de este artículo sobre autoalojamiento externo es, por lo tanto, arquitectónica y procedimental — un patrón que el sistema está construido para soportar y que se prevé que soporte — no un informe de adopción observada por terceros. El manuscrito de investigación que acompaña este artículo enuncia la misma limitación, junto con un programa de falsación para las afirmaciones implicadas, y este artículo prefiere publicar con ese estatus a la vista antes que sugerir una base de clientes que no puede demostrar.


Este artículo es material de contexto para los lectores de la documentación del Sistema de Diseño PointSav que deciden cuál de las dos ofertas necesitan. El manual operativo del procedimiento de bifurcación se mantiene por separado como guía; el tratamiento con grado de investigación de la arquitectura, incluidas sus hipótesis formales y limitaciones, es el manuscrito acompañante sobre infraestructura de sistemas de diseño controlada por el cliente.

Cite this record: /wiki/self-hosting-customer-controlled-design-systems — revision 38c462f9, last updated 1 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 →