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.

Arquitectura de resolución de nombres regionales

Cada agrupación de coubicación se etiqueta con un nombre regional legible: un área metropolitana norteamericana, una región NUTS-3 europea, un municipio mexicano, una subdivisión censal canadiense. Ese nombre no es un campo de los datos de origen: es la salida de un motor de geocodificación inversa por capas que funciona sin conexión.

Por qué importa: toda la resolución se ejecuta desde archivos de límites locales, sin ninguna API de geocodificación externa en el circuito, de modo que el sustrato conserva su capacidad de funcionar sin red y sin coste por solicitud incluso en el paso que más obviamente invitaría a contratar un servicio alojado.

Las capas de límites

Las coordenadas del ancla de cada agrupación se comprueban contra un conjunto de capas de límites en un orden específico por país. Capas principales de enrutamiento:

Capa Fuente Cobertura Granularidad
us_cbsa.geojson US Census Bureau TIGER GENZ2023 Estados Unidos Áreas estadísticas basadas en núcleo (metro y micropolitanas)
ca_cma.geojson Statistics Canada, Censo 2021 Canadá Áreas metropolitanas censales
ca_csd.geojson GADM 4.1 admin-3 Canadá Aproximaciones a subdivisiones censales (municipios)
mx_municipio.geojson GADM 4.1 admin-2 México Municipios
mx_metro.geojson INEGI 2018, Zonas Metropolitanas México Zonas metropolitanas (reserva intermedia)
eu_nuts3.geojson Eurostat GISCO 2021 UE, Reino Unido, AELC y Balcanes occidentales Regiones NUTS-3
fallback_ne_admin1.geojson Natural Earth 10m Global Admin-1 (estados y provincias)

Además de este conjunto principal, el motor carga una capa de archivos de límites a escala de asentamiento — límites más finos de ciudad, población y municipio para Estados Unidos, la Unión Europea y Canadá — que resuelven un nombre más específico allí donde esos datos existen. Todos los archivos se cargan una sola vez al inicializar el motor, y los índices espaciales reducen las búsquedas de punto en polígono a coste logarítmico por consulta.

Por qué importa: cargarlo todo una vez al arranque es lo que abarata lo suficiente la resolución por agrupación como para ejecutarla sobre el manifiesto completo en cada reconstrucción.

Enrutamiento por país

  • Estados Unidos — búsqueda en CBSA. Al encontrar coincidencia, se formatea el nombre: se elimina el sufijo estatal y se añade «Metro Area» si falta.
  • Canadá — primero la subdivisión censal (admin-3). Cuando coinciden y difieren tanto la subdivisión como el área metropolitana circundante, el resultado se compone: «Strathcona County, Edmonton». Cuando solo coincide una, se devuelve ese nombre solo.
  • México — búsqueda de municipio (admin-2), con posprocesado del texto en español al coincidir. Si falla, el motor recurre a la capa de zonas metropolitanas y, si esta también falla, a la reserva estatal de Natural Earth.
  • Unión Europea, Reino Unido, AELC y Balcanes occidentales — búsqueda NUTS-3.
  • Reserva — admin-1 de Natural Earth para cualquier país no cubierto por las capas, devolviendo nombres de estado o provincia.

Cada capa incorpora una tolerancia en su consulta espacial: cuando un punto cae justo fuera de todos los polígonos — una tienda costera al borde de un fiordo, por ejemplo — el motor acepta el polígono más cercano dentro de unos 15 km.

Por qué importa: sin esa tolerancia, tiendas costeras e insulares legítimas atraviesan todas las capas específicas hasta la reserva estatal, y el mapa etiqueta una localidad noruega con el nombre de su condado.

Posprocesado de los nombres brutos

Los archivos de límites traen nombres en lengua de origen con afijos concatenados que no son legibles. Tres transformaciones los limpian.

Separador de CamelCase. Los nombres GADM admin-2 y admin-3 se almacenan sin separadores de palabra: «StrathconaCounty» pasa a «Strathcona County».

Separador de preposiciones en español. Los nombres de municipios mexicanos arrastran a veces preposiciones concatenadas — «Bocadel Río», «Apetatitlánde Antonio Carvajal». Una expresión regular detecta de, del, la, las, el y los pegadas a un carácter minúsculo precedente e inserta un espacio antes.

Normalizador de puntos. «Gustavo A.Madero» se normaliza a «Gustavo A. Madero».

Un diccionario aparte de anulaciones explícitas resuelve los casos fuera del alcance de las expresiones regulares: nombres griegos transliterados al inglés, simplificaciones de sufijos finlandeses, eliminación de prefijos polacos, normalización de nombres bilingües belgas. Ese diccionario contenía unas 200 entradas a mediados de 2026.

Por qué importa: el nombre es la única parte de esta tubería que una persona lee directamente, así que un artefacto mecánico en él socava la confianza en cada cifra que aparece a su lado.

Anulaciones de presentación

Algunos nombres de municipio son técnicamente correctos pero no la forma que un lector hispanohablante espera ver en un mapa. Un pequeño diccionario de anulaciones asigna los nombres de zona metropolitana del INEGI a sus formas breves habituales: «Zona Metropolitana del Valle de México» pasa a «Ciudad de México» y «Zona Metropolitana de Guadalajara» a «Guadalajara».

Escala

Tras el enrutamiento por capas y el posprocesado, el motor produce unos 1.200 nombres de región únicos en el ámbito operativo a mayo de 2026: 671 áreas metropolitanas estadounidenses distintas, 245 regiones canadienses (subdivisiones censales y áreas metropolitanas combinadas), 104 municipios mexicanos y varios cientos de regiones NUTS-3 europeas. Cada uno aparece en las ventanas emergentes de agrupación y en el panel del inspector.

Véase también

Cite this record: /wiki/regional-name-resolution-architecture — revision a2fa91b3, last updated 26 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 →