Webエンジニア向けプログラミング解説動画をYouTubeで配信中!
▶ チャンネル登録はこちら

【ITニュース解説】Let Course Progress Follow Evidence, Not Session Endings

2026年11月02日に「Dev.to」が公開したITニュース「Let Course Progress Follow Evidence, Not Session Endings」について初心者にもわかりやすく解説しています。

作成日: 更新日:

ITニュース概要

ピアノ練習アプリPianoryでは、コース進捗はセッション終了ではなく、各ステップで求められる「エビデンス(証拠)」で判断される。自己申告、クイズ、演奏測定など、エビデンスの種類に応じた完了条件を設け、その達成度で進捗を管理し、データは永続化する。

ITニュース解説

Pianoryというピアノ練習アプリでは、学習者のコース進捗管理において、単に練習セッションが終了したという事実だけで進捗を判断しない。大切なのは、各学習ステップで求められる「証拠」が提出され、それが設定された完了ルールを満たしているかどうかである。これは、学習内容の確実な定着を促し、意味のある学習体験を提供するための、Pianoryアプリの中心となる考え方だ。

コースの各ステップには固有の完了ルールが設定されており、このルールに合致する証拠が提出された場合にのみ、そのステップが完了したと見なされる。この判断を行う主要な仕組みが、courseAttemptMeetsPolicyという関数である。この関数は、学習者が行った「試行」(練習や課題への取り組み)が完了しており、かつその試行によって得られた「証拠」がそろっていることを前提として、設定されたステップのルールを適用する。たとえば、学習者が特定の課題を「自己報告」する形式のステップでは、単に「終わった」と申告するだけでは不十分だ。システムに設定された評価基準、合格と見なされる回数、その他の具体的な基準を満たす必要がある。さらに、設定によっては、学習後に一定期間が経過してから再度確認する「遅延レビュー」の要件が求められる場合もある。また、クイズ形式のステップであれば、単に回答するだけでなく、設定された合計回答数のうち、どれだけの正解数が必要かという基準を満たす必要がある。これは、単に正解数を稼ぐだけでなく、全体の学習目標に沿った理解度を測るための仕組みだ。さらに、実際に演奏内容をシステムが分析して評価するようなステップでは、「計測された証拠」として扱われる。この場合、合格と判断できる観察結果が得られているか、入力が適切にサポートされているか、評価の「信頼度」が十分に高いか、そしてその評価が特定の「能力」や「ベンチマークバージョン」と一致しているかといった、複数の複雑な条件が同時に満たされる必要がある。これらの条件をクリアすることで、システムは学習者の演奏がそのステップの目標を達成したと客観的に判断するわけだ。

学習者のコース進捗を実際に進める処理は、advanceCourseEnrollmentという関数が担当する。この関数は、単に証拠が提出されたからといってすぐに進捗を進めるわけではない。まず、学習者が行っている「試行」が、現在アクティブになっているコースの「登録情報」、アプリに固定されている「コースバージョン」、そして現在の「ステップ」や学習の「フェーズ」と正確に一致しているかを厳密に確認する。これにより、誤った操作や古い情報に基づいて進捗が更新されることを防ぐ。もし学習者の試行が、ステップの完了ルールを部分的にしか満たさなかった場合、これは「部分的な結果」として扱われる。この場合、システムの内部的な「リビジョン」(改訂番号のようなもの)は更新されるが、学習者のカーソル、つまり現在取り組んでいるステップはそのまま変わらない。これは、学習者が納得いくまで同じステップを繰り返して練習できるようにするための配慮である。もし学習者が自己報告形式のステップで、うまく進められずに「行き詰まった」と判断された場合、そのステップに「リカバリーブランチ」という特別な回復経路が設定されていれば、「説明フェーズ」に進むことができる。これは、学習者がなぜ行き詰まっているのかをシステムに伝え、追加のヒントや異なる練習方法が提示されるような場面を想定している。また、特定のステップを学習者が意図的に「スキップ」することも可能だ。スキップされた場合、学習中のステップを示すカーソルは次のステップに進むことができる。しかし、このスキップという行為自体も「不変な試行」(一度記録されたら内容が変わらない試行の記録)としてシステムに記録され、「スキップ済み」というラベルが付与される。これは、学習履歴を正確に保ち、後から振り返ったときに、どのステップがどのように処理されたかを明確にするための重要な設計である。

学習者の進捗状況や試行結果は、アプリを閉じても情報が失われないように永続的に保存する必要がある。この保存処理はcommitCourseEnrollmentという関数によって行われる。この関数は、学習進捗の「スナップショット」(その時点での状態全体)と、先に述べた「不変な試行」を、一連の処理としてまとめてローカルストレージに書き込む。ここでは「IndexedDB」という、Webブラウザ内で動作するデータベースが利用される。この書き込みは「トランザクション」と呼ばれる形式で行われる。トランザクションとは、複数のデータベース操作をひとまとまりとして扱い、そのまとまりの中のすべての操作が成功するか、あるいはすべて失敗して元の状態に戻るかのどちらかであると保証する仕組みだ。これにより、データが途中で壊れたり、不整合な状態になったりするのを防ぐことができる。さらに、サインインしている学習者のアカウントの場合、このトランザクションの中で、サーバーへの「同期操作」もキューに追加される。これにより、ローカルで進んだ進捗が、インターネットを通じてサーバー側にも確実に記録されるように設計されている。もし、全く同じ「試行ID」と「証拠」で再度コミット処理が実行された場合、それはすでに保存されている内容と同一であるため、何も変更は行われない。しかし、同じ「試行ID」にもかかわらず、「異なる証拠」でコミットしようとした場合は、「競合」が発生したと見なされ、システムが適切にその状況を処理することになる。これは、データの整合性を維持するための重要な安全策である。

このシステムは、クイズの証拠、部分的な試行、そして学習者が明示的に行うスキップといった様々なケースを想定して設計されている。今回説明した内容は、Pianoryアプリの核となるソースコードと、その動作を定めた仕様書に基づいている。これらのルールは、学習者の最終的な成果を保証するものではなく、また、すべてのリモート同期シナリオが完全にテストされているわけではないが、学習進捗の信頼性と正確性を高めるための堅牢な基盤を提供している。このような複雑な進捗管理の仕組みを構築することで、学習者は自分の努力が正しく評価され、より効果的な学習体験を得ることができるようになっている。

関連コンテンツ

関連IT用語