Schéma JSON

Le schéma d'application Sovrium décrit la structure complète d'une configuration d'application. Il est publié sous forme de schéma JSON standard (Draft 2020-12), dérivé directement du schéma Effect canonique (AppSchema) — il ne peut donc jamais dériver de ce que le serveur décode réellement.

Trois artefacts sortent de cette source unique de vérité :

Générer le schéma

# Afficher le schéma JSON sur la sortie standard
sovrium schema

# Écrire le schéma JSON dans un fichier
sovrium schema --output app.schema.json

Le document est autonome, avec une déclaration $schema de premier niveau : tout outil compatible JSON Schema le consomme sans configuration supplémentaire. Il ne prend aucune entrée hormis la version de Sovrium — régénérez-le en CI et comparez le résultat : toute différence est un vrai changement de schéma.

Propriétés racine en un coup d'œil

Chaque propriété sauf name est optionnelle et vient se superposer.

La référence complète se trouve dans Vue d'ensemble du schéma.

URLs du schéma

Référencez le schéma hébergé par son URL depuis un éditeur, un pipeline CI ou un script de validation.

Versionné (recommandé)

Épinglez à une version précise pour la stabilité en production. Remplacez <version> par la version de Sovrium que vous ciblez — celle qu'affiche sovrium --version :

https://sovrium.com/schema/app-<version>.json

Une URL épinglée est celle qui garde la CI honnête : la configuration est vérifiée face au schéma de la version que vous déployez réellement, si bien que monter Sovrium de version et adopter son nouveau schéma restent deux décisions distinctes.

Dernière version

Pointe toujours vers la version la plus récente. Pratique en développement ; elle peut introduire des changements incompatibles sans prévenir.

https://sovrium.com/schema/app.json

Intégration à l'éditeur

Déplacé vers Configuration de l'éditeur.

Autocomplétion TypeScript avec @sovrium/types

Déplacé vers Configurations TypeScript.

Valider un fichier de configuration

Déplacé vers Valider une configuration.

Validation programmatique

Déplacé vers Valider une configuration.

Pages associées

• Configuration de l'éditeur — brancher le schéma dans VS Code ou JetBrains.
• Valider une configuration — sovrium validate et le contrôle en CI.
• Configurations TypeScript — les mêmes garanties dans app.ts.
• Vue d'ensemble du schéma — la référence complète des propriétés racine.