Un moteur de référence haute performance pour le calcul et la consultation du calendrier liturgique catholique (Novus Ordo).
Ce projet repose sur un changement de paradigme radical : la donnée liturgique n'est pas traitée comme un algorithme perpétuel, mais comme une vue matérialisée d'un état du droit à un instant T.
Vouloir calculer dynamiquement le calendrier (dates de Pâques, préséances complexes, transferts de fêtes) à l'exécution entraîne une complexité technique inutile et des risques d'incohérence entre les plateformes.
Pour résoudre cela, l'intelligence métier a été entièrement déportée en amont. Le système se divise en deux composants asymétriques :
- La Forge (Le Compilateur) : Elle ingère les règles liturgiques lisibles par l'homme (fichiers YAML), calcule les dates mobiles sur plusieurs siècles, résout les conflits calendaires, et génère un dataset binaire statique et cryptographiquement vérifié (
.kald). - L'Engine (Le Projecteur) : C'est le runtime ultra-léger intégré dans vos applications. Il est réduit à sa plus simple expression technique : il ne contient aucune règle de liturgie, il se contente de lire le résultat binaire pré-calculé.
Cette séparation stricte offre des garanties de performance et de stabilité exceptionnelles :
- Zéro calcul à l'exécution : L'accès à n'importe quel jour de l'année se fait en un temps constant ultra-rapide (O(1)). L'Engine lit simplement une table continue, éliminant les branchements conditionnels (
if/else) liés aux années bissextiles ou aux dates flottantes. - Le Binaire comme Table Maître : Le fichier
.kaldagit comme l'unique source de vérité. Une mise à jour des règles liturgiques (comme la canonisation d'un saint) nécessite simplement de fournir un nouveau fichier, sans jamais toucher ni recompiler le code de l'Engine. - Empreinte mémoire minimale : L'Engine fonctionne sans allocation mémoire dynamique (
no_alloc) et sans recourir à la bibliothèque standard du système (no_std). - Portabilité universelle : Conçu avec une interface C native (FFI), le moteur peut être embarqué partout : serveurs, applications mobiles iOS/Android, systèmes embarqués ou directement dans le navigateur via WebAssembly.
Le pipeline repose sur une architecture Data-Driven stricte : la source de vérité du domaine n'est pas codée en dur, mais modélisée sous forme de données. Le droit liturgique (calendriers universel, nationaux et diocésains) est intégralement défini dans des fichiers YAML.
- Source de Vérité Indépendante : Les entités liturgiques (saints, préséances, règles de transfert) sont déclarées via un schéma YAML qui agit comme un contrat de données amont.
- Validation AOT (Ahead-Of-Time) : L'intégralité du corpus YAML est validée formellement lors de la compilation par la Forge. Les cycles de dépendance, les collisions de préséance ou les erreurs de dates provoquent un échec immédiat du build, garantissant mathématiquement qu'aucune erreur de configuration ne peut atteindre le runtime.
- Évolutivité Zéro-Code : Le domaine liturgique est vivant. Lorsqu'une nouvelle règle est édictée ou qu'un saint est canonisé, il suffit de mettre à jour le fichier YAML correspondant. La Forge ingère le YAML mis à jour et génère un nouveau dataset binaire
.kald. L'Engine consomme ce nouveau fichier et reflète la mise à jour instantanément, sans nécessiter la moindre modification ou recompilation du code de l'application hôte.
Le calendrier pré-compilé couvre de manière exhaustive et déterministe la période allant de 1969 (réforme du calendrier romain) à 2399.
[à venir...]