Manuel

Un guide pratique pour adopter PublicSchema : alignement des vocabulaires, correspondance des systèmes, conception de nouveaux systèmes, échanges de données, attestations, validation et gouvernance.

Cette page n'est pas encore disponible en français. Le contenu ci-dessous est en anglais.
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.

Documentation technique

Migration de domaine

Domaines canoniques, termes déplacés et migration des références existantes.

Intégration du registre avec FHIR

Relier les établissements de santé et les entrées de registre aux ressources FHIR.

Rôles des installations

Distinguer les installations, leurs exploitants et leurs rôles de prestation de services.

Conversion des dates de relation

Convertir les dates de validité inclusives des sources pour les relations et les périodes de responsabilité.

Services publics

Services publics, demandes, décisions, recours et succession organisationnelle.

Propriété et prestation d'éducation

Participations, montages juridiques, programmes d'enseignement, offres de formation et qualifications obtenues.