mistorias-web

Mistorias Web est le dépôt contenant le code source du site web de la plateforme Mistorias. Cette initiative utilise Astro comme framework principal pour la construction de l’interface et la génération de pages statiques ou dynamiques. L’objectif central de Mistorias est de transformer l’éducation en combinant récits, données et réflexion, offrant une expérience utilisateur axée sur l’apprentissage significatif. Une caractéristique clé de l’architecture de ce projet est la séparation claire entre la logique de présentation et le contenu éditorial. Tandis que ce dépôt gère la structure du site, les composants et la configuration technique, le contenu réel est hébergé dans un dépôt dédié appelé `mistorias-contenido`. Ce dépôt de contenu est intégré au projet principal en tant que sous-module Git, permettant une gestion indépendante et collaborative des ressources éducatives sans interférer avec le développement du code de base. Pour le développement local, le projet nécessite Node.js (avec des versions spécifiées dans `.nvmrc`) et le gestionnaire de paquets pnpm. Les commandes de base pour démarrer l’environnement de développement incluent l’installation des dépendances et l’exécution du serveur local sur le port 4321. De plus, un support est offert pour un environnement de développement cohérent via Dev Containers (Docker), ce qui facilite la réplication de l’environnement de déploiement et réduit les problèmes de configuration sur les machines des collaborateurs. La documentation technique est étendue et bien structurée. Les développeurs peuvent consulter `CONTRIBUTING.md` pour des guides de configuration et de contribution, ainsi que des directives spécifiques pour la gestion du contenu via les sous-modules. Pour comprendre les décisions d’architecture, des enregistrements de décisions d’architecture (ADR) sont fournis dans le dossier `docs/adr/`, ainsi que des standards de code et des pratiques de commit dans `docs/STANDARDS.md`. Un guide rapide (`CLAUDE.md`) est également disponible, orienté vers les assistants de code comme Claude Code.