Об этом проекте

Mistorias Web — это репозиторий, содержащий исходный код сайта платформы Mistorias. Проект использует Astro в качестве основного фреймворка для создания интерфейса и генерации статических или динамических страниц. Цель Mistorias — трансформировать образование путем сочетания нарративов, данных и рефлексии, предлагая пользователям опыт значимого обучения. Ключевой особенностью архитектуры является четкое разделение между логикой представления и редакторским контентом. В то время как этот репозиторий управляет структурой сайта, компонентами и техническими настройками, фактический контент хранится в отдельном репозитории под названием `mistorias-contenido`. Этот контент-репозиторий интегрирован в основной проект как Git-подмодуль, что позволяет независимо и совместно управлять образовательными ресурсами, не мешая разработке базового кода. Для локальной разработки проект требует Node.js (с версиями, указанными в `.nvmrc`) и менеджера пакетов pnpm. Основные команды для запуска среды разработки включают установку зависимостей и запуск локального сервера на порту 4321. Кроме того, поддерживается использование Dev Containers (Docker) для создания согласованной среды разработки, что упрощает репликацию среды развертывания и снижает проблемы с конфигурацией на машинах разработчиков. Техническая документация обширна и хорошо структурирована. Разработчики могут ознакомиться с руководством по настройке и вкладу в `CONTRIBUTING.md`, а также с конкретными инструкциями по работе с контентом через подмодули. Для понимания архитектурных решений доступны записи о принятых решениях (ADR) в папке `docs/adr/`, а также стандарты кода и практики коммитов в `docs/STANDARDS.md`. Также имеется краткое руководство (`CLAUDE.md`), ориентированное на помощников по коду, таких как Claude Code.