不等式マスター(改訂版)

Web

概要

このリポジトリは「Inequality-Master-Revisited」として、不等式(中学レベル)の学習を助けるウェブアプリケーションの改訂版です。オリジナルの設計を見直し、説明を明確化、インタラクティブな演習、デザイン改善、追加機能を組み込むことで教育効果の向上を図っています。TypeScriptで書かれたフロントエンド構成を持ち、コンポーネント分割された設計により機能追加やカスタマイズが容易です。READMEにはローカル実行とAI Studioでの展開手順、環境変数(GEMINI_API_KEY)設定に関する説明が含まれ、AI連携による説明生成や応答の拡張も想定されています。

GitHub

リポジトリの統計情報

  • スター数: 3
  • フォーク数: 0
  • ウォッチャー数: 3
  • コミット数: 2
  • ファイル数: 12
  • メインの言語: TypeScript

主な特徴

  • 中学生向け不等式を学べるインタラクティブ教材(説明+練習問題)
  • TypeScriptベースのコンポーネント構成で拡張・保守が容易
  • AI Studio連携のための設定(GEMINI_API_KEY)を用意し、説明生成などの拡張が可能
  • ローカル実行手順がREADMEに記載され、手軽に試せる

技術的なポイント

このプロジェクトはフロントエンド中心の実装で、App.tsx と components ディレクトリがあることから React 系(TSX)での構築が想定されます。TypeScript を採用しているため型安全性が確保され、コンポーネント分割によりUIとロジックが明確に分離されています。index.html を持つ構成は静的ホスティングやシングルページアプリとしての配備に適しており、ビルド後は任意のウェブサーバへデプロイできます。

README にある「AI Studioでの表示」「GEMINI_API_KEY を .env.local に設定」といった記述から、外部の大規模言語モデルやAIサービス(Gemini相当)と連携して、解説文や出題の自動生成、解答フィードバックを行う設計が推定されます。これにより、教師用の解説テンプレートに加えて動的な説明やヒント提示が可能になります。実行手順は npm install から始まり、環境変数を設定して起動する典型的なNode.jsベースの開発フローです。

拡張性の観点では components ディレクトリにUI部品(問題表示、入力フォーム、採点ロジックなど)を集約することが想定され、将来的には問題種類の追加、難易度調整、学習履歴の保存(ローカルストレージやバックエンド連携)などが容易に行えます。小規模リポジトリであるため、まずはフロントエンドの完成度を高め、必要に応じてAPI連携や認証、分析機能を段階的に追加するアプローチが現実的です。デプロイ面ではAI Studioのリンクがあるため、同プラットフォーム上でのホスティングや共有を活用することも可能です。

プロジェクトの構成

主要なファイルとディレクトリ:

  • .gitignore: file
  • App.tsx: file
  • README.md: file
  • components: dir
  • index.html: file

…他 7 ファイル

(上記はリポジトリのトップレベルを抜粋したものです。components 以下にUIパーツや画面ごとのコンポーネントが置かれている想定です。)

まとめ

中学生向けの不等式学習をTypeScriptで丁寧に再設計した、拡張性の高い教育用Webアプリです。

リポジトリ情報:

READMEの抜粋:

GHBanner

Run and deploy your AI Studio app

This contains everything you need to run your app locally.

View your app in AI Studio: https://ai.studio/apps/drive/1fqtykU2cswANyjLgBFzU2s7cPCqiPHuo

Run Locally

Prerequisites: Node.js

  1. Install dependencies: npm install
  2. Set the GEMINI_API_KEY in .env.local to …