Manual

Una guía práctica para adoptar PublicSchema mediante la alineación de vocabularios, la correspondencia entre sistemas, el diseño de nuevos sistemas, los intercambios de datos, las credenciales, la validación y la gobernanza.

Esta página aún no está disponible en español. El contenido a continuación está en inglés.
End-to-end Worked example See one package from scope to release. Lightest path Adopt vocabularies Align local codes first. Most common path Map existing systems Connect platforms without redesigning them. Greenfield path Design a new system Build compatibility from the start. Buying path Procurement acceptance Turn interoperability into evidence. Toolkit Templates Copy practical tables and checklists.

Start here

Introduction

What PublicSchema is, who it is for, and how the handbook is organized around practical adoption work.

Choose Your Path

A decision guide for teams adopting vocabularies, mapping existing systems, designing new systems, issuing credentials, or governing extensions.

Use Cases

Common public service delivery scenarios and the PublicSchema artifacts each one needs.

Worked Example: Mapping a Program Export

A small end-to-end example that follows cash transfer reporting from source systems to mappings, validation, publication, and governance.

Adoption paths

Adopt Vocabularies

The lightest adoption path: align local codes to canonical PublicSchema vocabularies without changing the internal data model.

Map Existing Systems

A complete mapping lifecycle for aligning existing platforms, schemas, APIs, and exports to PublicSchema.

Design a New System

How to use PublicSchema when designing a new registry, MIS, case management system, API, or procurement specification.

Procurement and Vendor Acceptance

Tender language, vendor evidence, acceptance levels, and validation checks for buying PublicSchema-compatible systems.

Implementation

Publish Exchanges and APIs

How to expose PublicSchema-compatible data through APIs, events, files, analytics pipelines, and canonical exports.

Issue Credentials

How to use PublicSchema with JSON-LD contexts, JSON Schemas, SD-JWT Verifiable Credentials, and selective disclosure.

Package and Validate Your Work

What a complete adoption package should contain, how to validate it, and how to make it maintainable.

Templates and Checklists

Copyable tables and review checklists for mappings, crosswalks, packages, validation reports, privacy notes, and releases.

Privacy and Data Protection

Practical data minimization, identifier, sample data, credential, and package review guidance for sensitive service delivery data.

Governance and reference

Extend PublicSchema

When to add local concepts, properties, or vocabulary values, and how to keep extensions interoperable.

Governance, Versioning, and Methodology

How PublicSchema evolves, how maturity and evidence work, and how implementation teams should govern local adoption.

Glossary

Shared terms used throughout the handbook, from concepts and properties to mappings, profiles, shapes, and credentials.

Documentación técnica

Migración de dominio

Dominios canónicos, términos trasladados y migración de las referencias existentes.

Integración del registro con FHIR

Conectar los establecimientos de salud y las entradas de registro con los recursos FHIR.

Funciones de las instalaciones

Distinguir las instalaciones, sus operadores y sus funciones de prestación de servicios.

Conversión de fechas de relación

Convertir las fechas de validez inclusivas de origen en relaciones y períodos de responsabilidad.

Servicios públicos

Servicios públicos, solicitudes, decisiones, recursos y sucesión organizacional.

Propiedad y prestación educativa

Participaciones de propiedad, acuerdos jurídicos, programas educativos, ofertas educativas y cualificaciones obtenidas.