![[PukiWiki]](image/pukiwiki.png "[PukiWiki]")
プログラムは iie.lab.tpu.2526のドライブより 学生/25_o4山本/プログラム/main.zip にて保存(2025/06/24更新)
| 扱うデータ | 用途 | ファイル名 | ファイルの場所 |
| アプリケーション全体 | |||
| アプリケーションの起動 | Flaskサーバーを起動する | run.py | main/ |
| アプリケーション本体 | 全てのWebページ（ルート）の処理、主要ロジック | app.py | main/app/ |
| 設定ファイル | 秘密鍵(SECRET_KEY)やソルト(SALT)の保存 | key.py | main/app/ |
| 計算モジュール | 科目推薦やレビュー信頼度の計算関数群 | Recommend.py | main/ |
| データベース | |||
| ユーザー認証情報 | 学籍番号、ハッシュ化パスワード | StudentKey.db | main/ |
| 成績・メタデータ | 学生の成績、古い科目メタデータ | StudentData.db | main/ |
| 年度別マスターデータ | |||
| 年度ごとの科目情報 | 科目名、フォルダ名、区分、単位数、必選、配当など | course_catalog_YYYY.csv | main/catalogs/ |
| 教材データ | |||
| 各回の教材リスト | 特定の講義回で表示する教材のリスト（Webサイト、動画） | kyouzai_X.csv video_kyouzai_X.csv | main/app/Kamoku/{科目名}/Kyouzai/ |
| 各回のレビューデータ | ユーザーが投稿したレビューの保存先（自動生成） | Kyouzai_X_Review.csv | main/app/Kamoku/{科目名}/Kyouzai/ |
| シラバス作成データ | |||
| 教員と担当科目 | 教員名と担当科目の対応リスト | main/teacher.csv | main/ |
| 授業計画データ | 作成されたシラバスの授業計画（自動生成） | {科目名}_Custom.csv | main/app/templates/{科目名}/ |
| ページの見た目 (HTML) | |||
| ログイン・新規登録 | ログインページ、新規登録ページ | top.html, newcomer.html | main/app/templates/ |
| メインページ | ログイン後の履修状況・推薦科目表示ページ | index.html | main/app/templates/ |
| 科目トップ（一覧） | 各科目の講義回一覧を表示するページ | {科目名}.html | main/app/templates/{科目名}/ |
| 講義詳細（汎用） | 各講義の教材やレビュー機能を表示する共通ページ | lecture_page.html | main/app/templates/{科目名}/ |
| シラバス（教員用） | シラバス作成・確認用の一連のページ | teacher.html, subject.html, syllabus.html, true_syllabus.html | main/app/templates/ |
| カスタムシラバス | 保存されたシラバスのHTML（自動生成） | {科目名}_Custom.html | main/app/templates/{科目名}/ |
Python3.11にて動作確認済み
| ライブラリ名 | インストールコマンド | 主な用途 |
| Flask | pip install Flask | Webアプリケーションのフレームワーク本体 |
| pandas, numpy | pip install pandas numpy | データ分析や行列計算（data_all_npなど）で中心的に使われている |
| SQLAlchemy | pip install SQLAlchemy Flask-SQLAlchemy | データベースを操作するために使われている |
| MeCab | 別で記載 | レビュー信頼度計算で、日本語の文章を単語に分解するために必要 |
| matplotlib | pip install matplotlib | グラフ描画のためにインポート |
| requests, bs4 | pip install requests beautifulsoup4 | Webページの情報取得などに使われている |
| pykakasi | pip install pykakasi | 科目名をURL用のローマ字フォルダ名に変換するスクリプトで提案したライブラリ |
https://github.com/ikegami-yukino/mecab/releases/tag/v0.996
C:\Program Files\MeCab\bin\
実験１：協調フィルタリングによる科目推薦
この実験は滝沢先輩までで実装されている機能の検証である。
この実験の目的は、「推薦システムの精度が、データの量（学生数）によってどう変化するか」を定量的に検証する。
プログラムは iie.lab.tpu.2526のドライブより 学生/25_o4山本/プログラム/test1.zip にて保存(2025/07/01更新)
| 扱うデータ | 用途 | ファイル名 | ファイルの場所 |
| 実験用ファイル | |||
| 計算モジュール | 科目推薦の計算関数群 | Recommend.py | test1/ |
| 実験用データ | 学生の成績データ | grades.csv | test1/ |
| 実験実行ファイル | 実験の実行と結果のグラフ化 | experiment1_kamoku_suisen.py | test1/ |
| 実験実行ファイル | データ生成 | generate_dataset.py | test1/ |
| 実験結果 | データ数と精度の関係を示すグラフ | accuracy_comparison_graph.png | test1/ |
1. generate_dataset.pyを実行する。
これによって同ディレクトリ内に grades.csv が生成される。
2. experiment1_kamoku_suisen.py を実行する。
これによってCMD上に実行結果の数値と、同ディレクトリ内に accuracy_comparison_graph.png が生成される。
実験２：レビュー信頼度に基づく教材推薦
この実験は滝沢先輩までで実装されている機能の検証である。
この実験の目的は、「レビュー評価の各指標（S, I, Cスコア）が設計通りに機能するか、また、それらを統合した最終的な教材ランキングは妥当か」を検証する。
プログラムは iie.lab.tpu.2526のドライブより 学生/25_o4山本/プログラム/test2.zip にて保存(2025/07/01更新)
| 扱うデータ | 用途 | ファイル名 | ファイルの場所 |
| 実験用ファイル | |||
| 計算モジュール | レビュー信頼度の計算関数群 | Recommend.py | test2/ |
| 実験用データ | 教材のマスターデータ | materials.csv | test2/ |
| 実験用データ | 教材へのレビューデータ | reviews.csv | test2/ |
| 実験実行ファイル | 実験の実行と結果の要約・グラフ化 | experiment2_kyouzai_shinraido.py | test2/ |
| 実験結果 | 「平均評価」と「最終信頼度スコア」の比較グラフ | report_graph.png | test2/ |
1. experiment2_kyouzai_shinraido.py を実行する。 これによってCMD上に実行結果の数値と、同ディレクトリ内に report_graph.png が生成される。
MeCab_test.ipynb