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.

Muestrario de familias de marcas

El muestrario de familias de marca es un componente de clasificación visual agnóstico respecto a la taxonomía: un punto codificado por color combinado con una etiqueta semántica, de modo que la membresía de categoría sea legible de un vistazo sin depender únicamente del color. Los identificadores de familia se resuelven a través de una configuración en tiempo de ejecución en lugar de un cambio de código, por lo que cada implementación define su propia lista de familias y colores — las tres familias mostradas a lo largo de este artículo (Departamental, Ferretería, Club de Compras) son los valores predeterminados de referencia del componente, no una taxonomía fija. La superficie GIS de la plataforma, parte de la plataforma de inteligencia de ubicación, es una implementación de referencia: define su propia taxonomía real de familias de anclas a través de este mismo mecanismo en tiempo de ejecución para impulsar la visualización de niveles de la metodología de niveles de co-ubicación minorista, en lugar de usar los valores predeterminados mostrados aquí.

Representación visual

El muestrario de familias de marca estandariza la apariencia de las categorías de anclas en marcadores de mapa, filtros tabulares y paneles de detalle. Un identificador codificado por color combinado con una etiqueta semántica garantiza una densidad de datos accesible. El componente desacopla la presentación de la taxonomía subyacente, resolviendo los identificadores de familia a través de una configuración JSON en tiempo de ejecución — la superficie GIS, como implementación de referencia, define su propia taxonomía de esta misma manera, en lugar de que el componente venga con una única taxonomía fija para todas las implementaciones.

Directrices de uso

Escenarios de implementación

  • Marcadores de Mapa: Funciona como la base visual para los marcadores de anclas, utilizando puntos codificados por colores para señalar la afiliación familiar.
  • Filtrado de Datos: Sirve como la primitiva interactiva dentro de las filas de filtro (normalmente emparejada con una casilla de verificación).
  • Superposiciones de Detalles: Proporciona categorización de alto nivel dentro de los paneles laterales y distintivos de encabezado.
  • Análisis de Conglomerados: Emplea una variante de anillo concéntrico para representar la distribución familiar dentro de los conglomerados (clusters) agregados del mapa.

Restricciones

El componente está reservado para la clasificación taxonómica. No debe utilizarse para indicadores de estado binarios, mensajes transitorios del sistema o etiquetas no taxonómicas, que son atendidos por los componentes Tag (Etiqueta) y Status Indicator (Indicador de Estado).

Especificaciones técnicas

Anatomía y composición

  • Indicador: Un punto circular de 10px (predeterminado) o 24px (marcador) que utiliza tokens de color específicos de la familia.
  • Etiqueta: Un nombre de visualización resuelto por la taxonomía (por ejemplo, "Warehouse Club").
  • Capa de Accesibilidad: Un aria-label que combina la semántica del punto y la etiqueta, garantizando que el indicador visual esté oculto para los lectores de pantalla para evitar anuncios redundantes.

Modelo de interacción

El muestrario es nativamente estático. La interactividad se hereda de su contenedor principal (por ejemplo, un botón de filtro o una función de mapa). En las superficies de mapas, el componente admite un comportamiento de revelación por zoom: se prevé que los anillos de centroide de conglomerado se representen en niveles de zoom bajos, transicionando a muestrarios individuales en aumentos mayores.

Accesibilidad y cumplimiento

El componente está diseñado para cumplir con los estándares WCAG 2.2 AA:

  • Señalización Redundante: El color nunca es el único canal de información; las etiquetas proporcionan el significado semántico principal.
  • Soporte de Alto Contraste: En entornos de modo de alto contraste de Windows o forced-colors, el punto vuelve a los colores del sistema para enlaces mientras la etiqueta mantiene la integridad del texto.
  • Contraste de Luminancia: Los tokens de color de la familia están validados para una relación de contraste mínima de 3:1 frente a mapas base tanto claros como oscuros.

Tokens de diseño (DTCG)

El punto es CSS en línea, no un token dimensionado — .ps-swatch__dot está fijado en 10px por defecto y 24px en la variante de marcador de mapa. El componente referencia cuatro tokens compartidos ({semantic.ink-primary}, {semantic.ink-secondary}, {primitive.space.05}, {primitive.radius.sm}) más colores de familia de marca, específicos de cada implementación y definidos en tiempo de ejecución en lugar de venir incluidos en el paquete de tokens primitivos. Los tres valores predeterminados de referencia se incluyen como respaldo CSS para una implementación que aún no ha definido su propia taxonomía:

Valor Descripción
#0B5FFF Department — azul azur (valor predeterminado de referencia)
#FF6B00 Hardware — naranja construcción (valor predeterminado de referencia)
#00875A Warehouse Club — verde almacén (valor predeterminado de referencia)

Estos son valores predeterminados, no un conjunto cerrado — una implementación amplía o reemplaza la lista de familias mediante su propio archivo de taxonomía en tiempo de ejecución, no editando el componente.

Extensiones previstas

Se prevé que las futuras iteraciones incluyan:

  • Rellenos con Patrones: Soporte planificado para patrones geométricos dentro del punto para mejorar la distinción para usuarios con deficiencias avanzadas de visión cromática.
  • Gráficos de Tarta Dinámicos: Se está investigando la transición del anillo de centroide de conglomerado a un gráfico de dona dinámico una vez que la densidad del conglomerado supere un umbral configurado.

Véase también

Cite this record: /wiki/brand-family-swatch — revision 7c7bfeb4, last updated 25 May 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 →