Glossaire Technique Pédagogique
Ce glossaire explique simplement tous les termes utilisés dans ce projet. Il n'y a aucun prérequis technique pour comprendre ce qui suit.
- ADR
-
Architectural Decision Record
Document officiel qui explique : Pourquoi on a pris cette décision, quelles alternatives on a étudié, quel est le compromis accepté. Chaque choix important du projet est tracé et justifié. Il y en a plus de 75 aujourd'hui. - Local-First
- Philosophie d'architecture. Vos données restent toujours sur votre ordinateur. Il n'y a aucun serveur obligatoire, aucun compte à créer, aucune connexion internet requise. Vous êtes seul propriétaire de vos données.
- Rust
- Langage de programmation moderne. Connu pour être extrêmement sûr, rapide et stable. Élimine 90% des bugs classiques des autres langages. C'est la raison pour laquelle l'application ne pèse que 10 Mo.
- Tauri 2.0
- Outil qui permet de transformer une interface web en application desktop native. Remplace Electron. Consomme 10x moins de mémoire et est 2x plus rapide.
- Svelte 5
- Framework frontend. Celui qui fait que l'interface réagit instantanément lorsque vous cliquez. L'un des plus rapides et des plus simples qui existe aujourd'hui.
- SurrealDB
- Base de données embarquée. C'est la boite qui range toutes vos fiches. Elle fonctionne directement sur votre ordinateur, pas besoin de serveur.
- Sidecar
- Processus qui accompagne l'application principale. Comme un assistant privé. Dans notre cas c'est SurrealDB qui tourne en arrière plan.
- ProseMirror
- Éditeur de texte riche. Le meilleur outil existant pour construire des éditeurs personnalisés. C'est celui qui est derrière les éditeurs de Notion, Atlassian et Wordpress.
- CI/CD Pipeline
- Robot qui compile automatiquement l'application pour Windows, Linux et macOS à chaque modification. Garantit que la version que vous utilisez est exactement celle qui est dans le code source.
- Compilation
- L'opération qui transforme le code source écrit par les développeurs en un programme que vous pouvez lancer sur votre ordinateur.
- Workflow
- Cycle de vie. Par exemple pour une fiche : Brouillon → Révision → Publié. Ce sont les règles qui définissent comment les choses progressent.
- FileMaker
- Logiciel propriétaire dans lequel LiturgiCiel 2010 a été développé. Technologie aujourd'hui obsolète et fermée qui empêchait toute évolution.
- Tests
- Petits programmes qui vérifient automatiquement que tout fonctionne comme prévu. Il y en a 109 aujourd'hui qui s'exécutent à chaque modification.
- WCAG AAA
- Norme internationale d'accessibilité. Le plus haut niveau d'exigence. Garantit que le logiciel est utilisable par tout le monde, y compris les personnes en situation de handicap.
- Architecture
- La façon dont on a organisé le code. C'est le plan de construction du logiciel. Une bonne architecture garantit que le projet pourra évoluer pendant 20 ans sans devoir tout réécrire.
- Frontend
- La partie que vous voyez. Tout ce qui est affiché sur votre écran, les boutons, les textes, les couleurs.
- Backend
- La partie invisible qui travaille en arrière plan. Qui lit et écrit les données, qui fait les calculs, qui vérifie les permissions.
- AGPL v3
- Licence Open-Source. Garantit à jamais que ce logiciel restera gratuit, libre, modifiable et que personne ne pourra jamais l'enfermer dans un système propriétaire.
- Javascript
- Le seul langage que comprend nativement tous les navigateurs web. C'est celui qui est utilisé pour l'interface.
Big Picture
LiturgiCielauri est une application Offline-First construite sur Tauri 2.0. Elle suit une architecture SOLID où le frontend (Svelte 5) communique avec une couche de persistance SurrealDB locale. La synchronisation est asynchrone et privilégie l'intégrité des données liturgiques.
Index des ADR
Les Décisions Architecturales enregistrent tous les choix structurants du projet. Il y en a 75 à ce jour.
Ceci est une sélection des plus importantes. La totalité des ADR est disponible dans le dépôt de code source.
Fondations
- ADR 001 : Sélection de la Pile Technique
- ADR 013 : Architecture en Couches
- ADR 017 : Organisation du Code
- ADR 031 : Couche de Persistance
- ADR 066 : Gestion des États avec Svelte 5 Runes
- ADR 072 : Architecture SurrealDB Sidecar
Qualité
- ADR 003 : Standards de Développement
- ADR 005 : Protocole de Tests
- ADR 011 : Automatisation CI/CD
- ADR 040 : Stratégie de Tests SOLID
Interface
- ADR 014 : Accessibilité WCAG AAA
- ADR 041 : Principes de Design
- ADR 042 : Système de Couleurs OKLCH
- ADR 074 : Architecture ProseMirror
Fonctionnalités
- ADR 033 : Navigation Mode Livre
- ADR 032 : Workflow d'Édition
- ADR 054 : Déroulés de Culte
- ADR 061 : Gestion des Variantes