Métadonnées de l'application

Quatre propriétés racines scalaires façonnent l'identité de votre application : name, version, description et badge. Seule name est obligatoire. Les trois premières ancrent l'historique de migration en ajout seul de Sovrium ; badge contrôle la pastille d'attribution « Construit avec Sovrium ».

name: '@acme/crm'
version: 2.1.0
description: 'A CRM workspace for managing contacts, deals, and tasks.'
badge: false # optionnel — supprime le badge « Construit avec Sovrium »

name

Le nom de l'application suit les conventions de nommage des paquets npm. Il est en minuscules, compatible avec les URL et constitue la seule propriété obligatoire de tout le schéma.

# Valid names
name: my-app
name: task-tracker-v2
name: '@acme/dashboard'

version

Une chaîne Semantic Versioning 2.0.0 (semver.org). Optionnelle, mais recommandée — lorsqu'elle est présente, elle étiquette l'historique de migration décrit ci-dessous.

version: 1.0.0 # Stable release
version: 2.0.0-beta.1 # Pre-release
version: 1.0.0+build.42 # Build metadata

description

Une description sur une seule ligne affichée dans l'interface d'administration et les métadonnées.

description: 'Full-featured e-commerce platform with cart, checkout & payment processing'

badge

Un booléen contrôlant le badge « Construit avec Sovrium » — une petite pastille-lien affichée en bas à droite de chaque page de votre application. Optionnel ; affiché par défaut.

name: my-app
badge: false # supprime le badge — une ligne, gratuit, pour toujours

Le badge est un élément purement rendu côté serveur, avec zéro télémétrie : un unique <a> statique pointant vers sovrium.com — pas de balise de suivi, pas de pixel, pas de JavaScript côté client. Son libellé suit la locale active de la page (anglais « Built with Sovrium », français « Construit avec Sovrium », repli anglais pour les autres locales) ; le texte lui-même n'est pas personnalisable. Il apparaît sur les pages de l'application, la page d'accueil par défaut, les pages d'erreur et les pages de formulaire autonomes — et il est toujours absent de la console d'administration /_admin et des variantes de formulaire embarquées (?embed=true).

Historique des versions

Sovrium est un interpréteur de configuration-en-tant-que-code : la configuration d'une application vit dans son fichier app.ts / app.yaml (ou la variable d'environnement APP_SCHEMA) et ne change que lorsque cette source change et que l'application est redéployée. Il n'existe aucune surface d'édition de configuration à l'exécution — pas de brouillon, pas d'API de publication, pas d'éditeur de schéma dans le tableau de bord d'administration (le tableau de bord reflète les données d'exécution, jamais la configuration). Votre propre gestion de versions est l'historique de référence de ce qu'était la configuration et de quand.

À des fins d'observabilité, Sovrium conserve un historique de migration en ajout seul dans la base de données de l'application. Chaque fois qu'un changement de schéma est appliqué au démarrage, une ligne est enregistrée avec la version appliquée, une somme de contrôle du schéma et l'instantané du schéma — un journal d'audit du schéma exact sur lequel tourne l'application. Les changements additifs (nouvelles tables, nouveaux champs) s'appliquent en direct au démarrage ; les changements destructifs sont différés à un redémarrage par sécurité. Voir Migrations pour la façon dont l'évolution du schéma est appliquée.

Recharger un serveur en cours d'exécution

sovrium reload signale à un serveur en cours d'exécution de relire son fichier de configuration sans redémarrage complet, de sorte qu'une modification de app.ts / app.yaml prend effet sur place. Comme le fichier (ou APP_SCHEMA) est l'unique source de vérité, l'application active ne diverge jamais de celui-ci à l'exécution — il n'y a rien à réconcilier.

Étapes suivantes

• Vue d'ensemble du schéma — toutes les propriétés racines en un coup d'œil.
• Fichiers de configuration — comment les transports config-file et env chargent votre application.
• Référence CLI — sovrium reload pour recharger la configuration en place.