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`) もあります。