À propos du projet

Mistorias Web est le référentiel qui contient 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 à travers la combinaison de récits, de données et de réflexion, en 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. Alors que ce référentiel gère la structure du site, les composants et la configuration technique, le contenu réel est hébergé dans un référentiel dédié appelé `mistorias-contenido`. Ce référentiel de contenu est intégré au projet principal comme un sous-module Git, permettant une gestion indépendante et collaborative des ressources éducatives sans interférer avec le développement de la base de code. 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 lancer l'environnement de développement comprennent l'installation des dépendances et l'exécution du serveur local sur le port 4321. En outre, 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 extensive 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 des sous-modules. Pour comprendre les décisions architecturales, des enregistrements de décisions d'architecture (ADR) sont fournis dans le dossier `docs/adr/`, ainsi que des normes de code et des pratiques de commits dans `docs/STANDARDS.md`. Il existe également un guide rapide (`CLAUDE.md`) orienté vers les assistants de code comme Claude Code.