mistorias-web

Mistorias Web은 Mistorias 플랫폼의 웹사이트 소스 코드를 포함하는 저장소입니다. 이 프로젝트는 인터페이스 구축 및 정적/동적 페이지 생성을 위해 Astro를 주요 프레임워크로 사용합니다. Mistorias의 핵심 목표는 내러티브, 데이터, 그리고 반성을 결합하여 교육을 혁신하고, 의미 있는 학습에 초점을 맞춘 사용자 경험을 제공하는 것입니다. 이 프로젝트의 아키텍처에서 중요한 특징은 프레젠테이션 로직과 편집 콘텐츠의 명확한 분리입니다. 이 저장소는 사이트 구조, 컴포넌트, 그리고 기술적 설정을 관리하는 반면, 실제 콘텐츠는 `mistorias-contenido`라는 전용 저장소에 호스팅됩니다. 이 콘텐츠 저장소는 Git 서브모듈로 메인 프로젝트에 통합되어, 기본 코드 개발에 영향을 주지 않고 교육 자원을 독립적이고 협업적으로 관리할 수 있습니다. 로컬 개발을 위해, 이 프로젝트는 Node.js(버전은 `.nvmrc`에 명시됨)와 pnpm 패키지 관리자를 필요로 합니다. 개발 환경을 시작하기 위한 기본 명령어에는 의존성 설치와 포트 4321에서 로컬 서버 실행이 포함됩니다. 또한, Dev Containers(Docker)를 통해 일관된 개발 환경을 지원하여, 배포 환경을 쉽게 복제하고 협업자의 머신에서 발생하는 설정 문제를 줄입니다. 기술 문서화는 포괄적이고 잘 구조화되어 있습니다. 개발자들은 `CONTRIBUTING.md`에서 설정 및 기여 가이드를 확인할 수 있으며, 서브모듈을 통한 콘텐츠 관리에 대한 특정 지침도 포함되어 있습니다. 아키텍처 결정 사항을 이해하기 위해, `docs/adr/` 폴더에 아키텍처 결정 기록(ADR)이 제공되며, `docs/STANDARDS.md`에는 코드 표준과 커밋 관행이 설명되어 있습니다. 또한, Claude Code와 같은 코드 어시스턴트를 위한 빠른 가이드(`CLAUDE.md`)도 제공됩니다.