Sobre el proyecto

Mistorias Web es el repositorio que contiene el código fuente del sitio web de la plataforma Mistorias. Esta iniciativa utiliza Astro como framework principal para la construcción de la interfaz y la generación de páginas estáticas o dinámicas. El objetivo central de Mistorias es transformar la educación a través de la combinación de narrativas, datos y reflexión, ofreciendo una experiencia de usuario enfocada en el aprendizaje significativo. Una característica clave de la arquitectura de este proyecto es la separación clara entre la lógica de presentación y el contenido editorial. Mientras que este repositorio gestiona la estructura del sitio, los componentes y la configuración técnica, el contenido real se aloja en un repositorio dedicado llamado `mistorias-contenido`. Este repositorio de contenido se integra en el proyecto principal como un submódulo de Git, permitiendo una gestión independiente y colaborativa de los recursos educativos sin interferir con el desarrollo del código base. Para el desarrollo local, el proyecto requiere Node.js (con versiones especificadas en `.nvmrc`) y el gestor de paquetes pnpm. Los comandos básicos para iniciar el entorno de desarrollo incluyen la instalación de dependencias y la ejecución del servidor local en el puerto 4321. Además, se ofrece soporte para un entorno de desarrollo consistente mediante Dev Containers (Docker), lo que facilita la replicación del entorno de despliegue y reduce problemas de configuración en las máquinas de los colaboradores. La documentación técnica es extensa y bien estructurada. Los desarrolladores pueden consultar `CONTRIBUTING.md` para guías de configuración y contribución, así como directrices específicas para el manejo del contenido vía submódulos. Para entender las decisiones arquitectónicas, se proporcionan registros de decisiones de arquitectura (ADR) en la carpeta `docs/adr/`, junto con estándares de código y prácticas de commits en `docs/STANDARDS.md`. También existe una guía rápida (`CLAUDE.md`) orientada a asistentes de código como Claude Code.