PublicSchema
Cuando los programas atienden a las mismas personas, sus sistemas necesitan un lenguaje común. PublicSchema lo proporciona: definiciones consensuadas para conceptos, campos y códigos de valores. Empiece aquí; adáptelo y amplíelo según el contexto de su país.
Qué contiene el esquema
PublicSchema no es un estándar de API, un producto de software ni un marco de cumplimiento. Proporciona definiciones consensuadas en las que cada concepto tiene peso semántico, no solo estructura. Una Persona no es un conjunto de campos. Cada definición obtiene un URI estable, apto para su uso en Credenciales Verificables. Todo es opcional. Adopte lo que se aplica al contexto de su país; amplíe el resto en su propio espacio de nombres.
Conceptos y propiedades
Entidades como Persona, Inscripción y Pago reciben definiciones claras
redactadas para responsables de programas. Cada concepto tiene propiedades
con nombre y tipo (given_name, date_of_birth,
enrollment_status) definidas una sola vez y reutilizadas
entre conceptos.
Vocabularios
Conjuntos de valores controlados para campos como género, país, modalidad de beneficio y estado de inscripción. Cuando existen estándares internacionales (ISO, FHIR), hacemos referencia a ellos. Cuando no existen, definimos un conjunto común basado en la convergencia observada entre sistemas.
Por qué importa un vocabulario compartido
Una madre inscrita en un programa de transferencias monetarias debería tener acceso automático a un beneficio de salud materna. Pero los dos sistemas definen "género" de manera diferente, "hogar" de manera diferente y "estado de inscripción" de manera diferente. La remisión requiere un ejercicio manual de mapeo que puede llevar semanas e introduce errores.
| Sistema | Nombre del campo | Valores |
|---|---|---|
| Sistema A | gender | 1, 2, 3 |
| Sistema B | sex | M, F, O |
| Sistema C | gender_identity | male, female, non-binary, prefer_not_to_say |
El mismo concepto. Tres sistemas. Tres representaciones incompatibles.
Este es el peaje de la coordinación: cada vez que dos programas necesitan compartir datos, alguien dedica semanas a mapear campos y traducir códigos. Es costoso, frágil y el proceso se reinicia cada vez que un sistema se actualiza.
Peor aún, algunos mapeos no son solo lentos sino que conllevan pérdida de información.
El Sistema C distingue non-binary y prefer_not_to_say; el Sistema A tiene
tres códigos numéricos. Ningún mapeo puede preservar esa distinción. Se pierde información
y las decisiones posteriores se toman sobre datos distorsionados. Las definiciones compartidas no
solo ahorran tiempo; hacen posible el intercambio preciso desde el principio.
Su lugar en el panorama de estándares
Estándares como DCI y GovStack definen cómo se mueven los datos entre sistemas: contratos de API, protocolos de transporte, bloques funcionales. Incluyen modelos de datos, pero esos modelos sirven a la capa de transporte. PublicSchema parte desde la otra dirección: ¿qué significa "inscripción"? ¿Qué propiedades describen un pago? ¿Qué valores son válidos para la modalidad de beneficio? El modelo semántico es el artefacto principal.
Los dos enfoques son complementarios. DCI especifica cómo mover registros de inscripción entre sistemas; PublicSchema especifica qué significan "inscripción", "activo" y "benefit_modality" en esos registros. EU Core Person Vocabulary gestiona los atributos de identidad; PublicSchema se extiende al ciclo de vida de la provisión de servicios, más allá del nombre y la fecha de nacimiento.
Basado en evidencia
PublicSchema se basa en un análisis comparativo de seis sistemas de protección social. Cuando existen estándares internacionales (ISO para género, países y monedas; FHIR para salud), hacemos referencia a ellos. Cuando no existen, definimos un conjunto común basado en cómo estos sistemas funcionan en la práctica.
Elija su camino
Por dónde empezar
“Coordino programas que atienden a poblaciones superpuestas”
Necesita cifras consolidadas, listas de beneficiarios deduplicadas o rutas de referencia entre servicios. PublicSchema le ofrece definiciones compartidas para que los datos de diferentes programas puedan compararse y vincularse.
“Construyo o mantengo integraciones entre sistemas”
Necesita nombres de campos y códigos de valores compartidos para que los sistemas puedan intercambiar datos sin capas de traducción personalizadas. Mapee su sistema una vez; todos los demás sistemas mapeados se vuelven interoperables.
“Estoy redactando requisitos para un nuevo sistema”
Necesita especificaciones concretas de interoperabilidad para su convocatoria, no “el sistema debe ser interoperable.” Referencie las propiedades y los códigos de vocabulario de PublicSchema para que los proveedores tengan un objetivo verificable.
“Analizo programas entre países o sectores”
Necesita un marco estructurado de comparación para que las divergencias sean visibles e identificables. El inventario de conceptos y propiedades de PublicSchema le ofrece un marco de referencia común sobre el cual realizar el mapeo.
“Estoy adaptando un estándar al contexto de mi país”
Los conceptos universales como Persona y Hogar se aplican tal cual. Donde los programas de su país necesiten más (categorías específicas de prestaciones, códigos de focalización mediante indicadores indirectos, identificadores heredados), amplíe PublicSchema en su propio espacio de nombres. La interoperabilidad se preserva; la especificidad local no se pierde.
Explorar el esquema
Conceptos fundamentales
19Protección social
9Vocabularios
51PublicSchema se mantiene como un proyecto abierto. Repositorio en GitHub Acerca del proyecto