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.

Filosofía del sistema de diseño

El sistema de diseño de PointSav es un sustrato auto-alojado de propiedad del cliente para gestionar tokens de diseño, componentes e investigación de decisiones de diseño. Responde a cuatro brechas estructurales en el panorama del diseño de 2026 — la ausencia de justificación de diseño legible por máquinas, precios de nivel empresarial que excluyen a las pequeñas y medianas empresas (PyMES), la dependencia de editores específicos y la estructura insuficiente para el consumo por inteligencia artificial — mediante tres inversiones arquitectónicas del modelo de plataforma dominante. El vocabulario de tokens está documentado en el vocabulario primitivo del sistema de diseño; la superficie wiki construida sobre este sustrato es servida por Aplicación MediaKit Knowledge.

El sustrato de sistema de diseño de PointSav existe como respuesta directa a cuatro brechas estructurales en el panorama del diseño de 2026.

Los sistemas de diseño establecidos publican únicamente el QUÉ: valores de tokens y formas de componentes. Ninguno publica la investigación de decisiones de diseño — el POR QUÉ — en un formato que un agente de IA o un desarrollador en una nueva organización pueda leer en tiempo de generación de código. Las plataformas SaaS de gestión de sistemas de diseño cobran precios para empresas de más de 5.000 empleados, dejando a las pymes sin alternativas. Cada editor de diseño construye para retener al cliente dentro de su plataforma. Y el 77% de los sistemas de diseño no están estructurados para el consumo de IA en 2026.

Qué hace el sustrato

El sustrato lleva cinco elementos por inquilino, en una bóveda rastreada en Git que el cliente posee:

  • tokens/ — tokens de diseño en formato DTCG. Capa primitiva (familias de color originales de PointSav, escala tipográfica, espaciado, movimiento, anillo de foco — patrones estructurales alineados con el campo moderno de sistemas de diseño, valores hexadecimales y nombres de familia propios de PointSav), capa semántica (interactive-primary, surface-elevated, ...), capa de componentes.
  • components/ — archivos de receta HTML+CSS+ARIA. Agnósticos al framework; el framework elegido por el cliente consume la receta, no al revés.
  • themes/<marca>/ — capas de anulación por inquilino que redirigen las referencias semánticas hacia las primitivas.
  • research/ — justificación de decisiones de diseño legible por IA, justificaciones de accesibilidad, reglas de voz de marca, antipatrones.
  • exports/ — cachés derivados (JSON de Variables de Figma, configuración de Tailwind, variables CSS, builds de Style Dictionary). Recalculables a partir de los cuatro directorios canónicos anteriores.

El motor del sustrato (app-privategit-design) lee esta bóveda y la sirve como un showcase público, un paquete DTCG, una superficie de investigación legible por IA y un servidor de Model Context Protocol (MCP). Los agentes de IA consultan el endpoint MCP en tiempo de generación de código; las herramientas de diseño consultan el paquete de tokens exportado para la sincronización con el editor; las personas leen el showcase.

El sustrato responde con tres inversiones estructurales:

  1. Propiedad del cliente sobre alojamiento en plataforma. El sistema de diseño vive en el repositorio Git del cliente — la migración tiene un costo tendiente a cero.
  2. La investigación como canónica en lugar de como marketing. El POR QUÉ vive en la misma bóveda que el QUÉ, en el mismo nivel de legibilidad por máquinas, accesible a través del mismo endpoint MCP.
  3. Neutralidad de editor en lugar de dependencia de editor. El formato DTCG es el denominador común: cualquier editor compatible produce contenido que el sustrato acepta.

En la era de la IA 2026–2030, el sustrato de sistema de diseño de una pyme es un medio: su forma — legibilidad por máquinas, interoperabilidad sin dependencia de editor, auto-alojamiento, investigación consumible por IA — determina cómo la marca de la pyme llega a cada superficie orientada al cliente.

Diseño móvil primero y fundación Inter

Cada superficie de operador que renderiza el sistema de diseño está especificada con enfoque móvil primero. La maquetación, la navegación y los componentes interactivos se definen a 375 px antes de la mejora progresiva para ventanas más amplias. Los objetivos táctiles cumplen el SC 2.5.8 de las WCAG 2.2 — mínimo 44 px × 44 px — y las interacciones no dependen de estados hover. Se aplica relleno de zona segura (env(safe-area-inset-*)) al cromo de la interfaz para pantallas con muesca y dynamic island.

La fundación tipográfica de interfaz es Inter (SIL OFL 1.1) — una neo-grotesca mantenida por la comunidad, diseñada específicamente para legibilidad en pantalla, sin asociación de marca corporativa. Inter es el resultado práctico de elegir neutralidad de editor en tipografía: es la tipografía más interoperable, ampliamente disponible y optimizada para pantalla que ninguna plataforma posee. Véase Sistema tipográfico del wiki para la pila tipográfica completa de la superficie wiki (Inter + Source Serif 4 + mono del sistema).

Antipatrones que el sustrato rechaza

  • Integración con Storybook (renderizador paralelo; el sustrato es dueño del renderizado).
  • Dependencia de SaaS de sistemas de diseño de nivel empresarial.
  • Componentes atados a un framework JS (las recetas HTML+CSS+ARIA son la forma canónica).
  • Empaquetado en contenedores (según Tiempo de ejecución sin contenedores).
  • Dependencia de editor (se rechazan las funciones exclusivas de un solo editor).
  • Vocabulario de marketing en los archivos de investigación (los archivos de investigación describen justificación estructural, no posicionamiento de producto).

Véase también

Referencias

Cite this record: /wiki/design-philosophy — revision 76c90b70, last updated 31 July 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 →