Acerca de PublicSchema
Qué ofrece, dónde se sitúa y hacia dónde va.
Qué ofrece PublicSchema
PublicSchema es un modelo de referencia abierto para datos de servicios públicos. La página de inicio cubre los aspectos básicos; esta página profundiza más.
Ofrece:
- Conceptos: entidades semánticas (Persona, Inscripción, Pago y otras) con definiciones redactadas para profesionales de políticas públicas, no para desarrolladores.
- Propiedades: campos con nombre y tipo que se aplican a uno o más conceptos. Se definen una sola vez y se reutilizan, manteniendo las definiciones coherentes entre dominios.
- Vocabularios: conjuntos de valores controlados. Cuando existen estándares internacionales (ISO, FHIR, ONU), hacemos referencia a ellos. Cuando no existen, definimos un conjunto canónico con correspondencias a cómo los sistemas específicos codifican los mismos valores.
- Esquemas de credenciales: contextos JSON-LD y estructuras para emitir datos de conceptos como Credenciales Verificables, usando SD-JWT VC para la revelación selectiva de datos personales sensibles.
Cada elemento recibe un URI estable. Todo es opcional. Los países y los programas adoptan lo que necesitan y amplían lo que no cubre sus necesidades.
Principios de diseño
Las definiciones tienen peso semántico, no solo estructura. Las propiedades son reutilizables entre conceptos. La dimensión temporal es un aspecto central del modelo. Se hace referencia a los estándares internacionales, nunca se reinventan. Nada es obligatorio.
Consulte Principios de diseño para conocer la justificación completa de cada una de estas decisiones.
Dónde se ubica PublicSchema
PublicSchema complementa los esfuerzos existentes en lugar de competir con ellos. Se sitúa en la capa de datos para la prestación de servicios: entre los estándares de identidad, la interoperabilidad de APIs y la infraestructura de confianza.
| Capa | Qué existe | Qué agrega PublicSchema |
|---|---|---|
| Confianza y transporte | W3C VC, OpenID4VC, EBSI | Vocabulario de dominio dentro de las credenciales |
| Atributos de identidad | EU Core Person Vocabulary | Datos sobre el ciclo de vida de la prestación, más allá del nombre, la fecha de nacimiento y la ciudadanía |
| Catálogos de servicios | CPSV-AP, HSDS/Open Referral | Quién recibe qué, no qué servicios existen |
| Interoperabilidad de API | DCI, GovStack | Semántica compartida detrás de los contratos de API |
| Medición estadística | ILO/World Bank ASPIRE | Modelos de datos para el intercambio, no solo indicadores |
| Ciclo de vida de la prestación | Nada | Esta es la brecha |
DCI es la iniciativa más cercana: define cómo fluyen los datos entre sistemas de protección social; PublicSchema define qué significan esos datos. GovStack define bloques de construcción para el gobierno digital; PublicSchema es el modelo de datos compartido que esos bloques necesitan implícitamente. FHIR es el equivalente en el sector salud; nos inspiramos en su enfoque pero nuestro alcance abarca los servicios públicos en general.
Consulte Estándares relacionados para una comparación detallada.
Alcance
PublicSchema proporciona conceptos y vocabularios compartidos en la prestación de servicios públicos: identidad, estado civil, composición del hogar, ubicación, pago, eventos peligrosos, y otros. Actualmente hay dos capas sectoriales activas: protección social (inscripciones, prestaciones, reclamos, derivaciones) y registro civil (nacimientos, defunciones, matrimonios, adopciones). La evaluación humanitaria se extiende a través del esquema AidOps, que reutiliza las bases de PublicSchema. Los dominios de salud y educación están planificados.
Consulte la lista completa de conceptos para conocer la cobertura actual.
La estructura es la misma entre dominios; solo cambian los conceptos y los vocabularios.
Cómo lo adoptan los países y los programas
PublicSchema es un punto de partida, no un mandato. Los países y los programas adoptan las partes que se aplican a su contexto y extienden el resto en su propio espacio de nombres. El esquema compartido se mantiene estable; la especificidad local se preserva.
- Adopte los conceptos universales tal cual. Persona, Hogar, Ubicación y otros conceptos universales rara vez necesitan cambios locales. Usarlos directamente ofrece interoperabilidad sin costo adicional.
- Use los vocabularios cuando encajen. Los códigos ISO de países, monedas e idiomas se corresponden sin dificultad con la mayoría de los sistemas. Cuando un vocabulario de dominio (estado de inscripción, modalidad de beneficio) no cubra un código local, agréguelo en su espacio de nombres.
- Extienda lo que falta. Los conceptos específicos de un país (un identificador nacional, un registro específico de gestión de casos, una categoría local de beneficio) viven en su espacio de nombres junto a los términos de PublicSchema.
- Proponga su inclusión en el modelo compartido. Cuando una extensión resulte útil en varios países, proponga su inclusión. El vocabulario crece a través de la adopción real, no del diseño por comité.
Consulte Extender PublicSchema para patrones y ejemplos concretos.
Cómo se construye
PublicSchema sintetiza un amplio cuerpo de trabajo previo: literatura sobre la prestación de servicios públicos, sistemas de código abierto (openIMIS, OpenSPP, OpenCRVS, MOSIP, SEMIC, GovStack) y estándares internacionales (ISO, FHIR, UN M49, DCI). La IA acelera ese análisis a escala; los humanos revisan cada definición, correspondencia y decisión de diseño, y cada decisión arquitectónica no trivial queda registrada en un registro de decisiones público. Los conceptos llevan un indicador de madurez (borrador, uso experimental, normativo) para que los adoptantes vean dónde tenemos confianza y dónde los aportes de la comunidad siguen abiertos.
Consulte Metodología para conocer el proceso completo.
Gobernanza y hoja de ruta
PublicSchema es de código abierto y de uso libre. El proyecto es liderado por Jeremi Joslin, con decisiones tomadas en público para que los colaboradores y los adoptantes puedan ver cómo evoluciona el esquema.
Dónde estamos hoy
Los conceptos, propiedades y esquemas de credenciales se publican con URIs estables. Los vocabularios hacen referencia a estándares internacionales (ISO, ONU, FHIR) cuando existen. Las correspondencias entre sistemas cubren identidad (MOSIP), protección social (OpenSPP, openIMIS), registro civil (OpenCRVS) y salud (DHIS2), junto con estándares de interoperabilidad (DCI, FHIR, GovStack). El esquema aún no ha sido validado en condiciones reales en un despliegue nacional.
Cómo se toman las decisiones
- Cada concepto, propiedad y valor de vocabulario lleva un indicador de madurez (borrador, uso experimental, normativo), para que los adoptantes vean dónde tenemos confianza y dónde los aportes siguen abiertos.
- Las decisiones arquitectónicas no triviales se registran como Architecture Decision Records públicos en el repositorio del proyecto.
- Se agradecen las contribuciones de expertos en el dominio, implementadores de sistemas y organismos de normalización.
Cómo evolucionará la gobernanza
El dispositivo actual permite iterar con rapidez antes de la adopción. A medida que los países y los programas adopten el esquema, la gobernanza se ampliará: primero a un grupo asesor de colaboradores y expertos en el dominio, luego a una estructura formal de múltiples partes interesadas cuando los compromisos de adopción lo justifiquen.