# 🏫 通常学級・特別支援学級対応 所見作成支援システム AI Assistant (v9.0)

【開発者】清水　正典
【連絡先】masanori432@icloud.com
【ソフトの概要】全国の小・中学校の先生方の通知表・所見作成業務を大幅に効率化するために開発された、オフライン＆AIハイブリッド型の所見作成支援システムです。
【動作環境】
* **対応OS**: Windows 10 / 11 (64bit)
* **必要環境**: インターネット接続（※Gemini AI機能を利用する場合のみ）

---

## 🌟 主な特徴

1. **通常学級・特別支援学級に完全対応**
   * 小学校・中学校の全教科・総合所見・行動の記録・部活動など幅広い評価項目に対応しています。
2. **生成AI（Gemini AI）連携による文章自動生成・肯定変換**
   * 箇条書きの事実メモから、適切な文字数（120〜250文字等）で温かみのある所見文を瞬時に生成します。
3. **配慮表現（NGワード）のリアルタイム自動チェック**
   * 「〜ができない」「短気」などのネガティブな表現をリアルタイムで検知し、肯定的な言い換え案を提案します。
4. **Excel / CSV 名簿の一括インポート機能**
   * クラス名簿を手入力する必要はありません。既存のExcelやCSVファイルから一括で登録可能です。
5. **進捗状況の可視化 ＆ 全自動バックアップ**
   * クラス全体の入力完了率（％）をプログレスバーでリアルタイム表示。自動バックアップ機能で大切なデータ消失を防ぎます。
6. **安心のローカルデータ保護**
   * 生徒名や保存された所見データは、すべてお使いのPC内（SQLiteデータベース）にのみ保存されます。外部サーバーへ個人情報が蓄積されることはありません。

---

## 📖 詳しい使い方マニュアル

### 1. アプリの起動
* ダウンロードした `app.exe` をダブルクリックして起動します。
* *(※Windowsの「PCが保護されました」と警告が出た場合は、「詳細情報」をクリックし「実行」を選択してください)*

---

### 2. 初期設定 ＆ APIキーの設定手順（※AI機能を使用する場合）

AIによる自動生成機能を利用するには、Googleが提供する「Gemini APIキー（無料）」の設定が必要です。

1. **APIキーの取得（初回のみ・約1分）**
   * [Google AI Studio](https://aistudio.google.com/) にアクセスします。
   * Googleアカウントでログインし、**「Create API key」** ボタンを押してキーを生成・コピーします。
2. **アプリへの登録**
   * アプリ画面上部の **「⚙️ クラス・名簿のデータ管理・初期設定」** タブを開きます。
   * 一番下の **「APIキー」** 入力欄に、取得したキーを貼り付けます。
   * 右側の **「APIキーを保存」** ボタンをクリックします。（※一度保存すれば次回から入力不要です）

---

### 3. クラス登録 ＆ CSV/Excel 名簿インポート手順

#### ① 手動で登録する場合
1. 「⚙️ 初期設定」タブの **「クラスの追加と校種設定」** で、校種（小学校/中学校）・クラス名・担任名を入力し「クラスを登録」を押します。
2. その下の **「児童・生徒の追加」** で出席番号と氏名を入力し「手動で1人追加」を押します。

#### ② Excel / CSV から一括登録する場合（おすすめ）
1. 対象クラスを選択します。
2. **「📂 CSV / Excel から名簿を一括登録」** ボタンをクリックします。
3. 学校で既にお持ちの名簿ファイル（.xlsx または .csv）を選択します。
   * ※ファイル内に **「出席番号」「氏名」** という列ヘッダーが含まれていれば、自動で認識して全生徒を一瞬で読み込みます。

---

### 4. 所見の作成・編集手順

1. 画面上のドロップダウンから **「対象学期」「クラス」「児童・生徒名」「教科・領域」** を選択します。
2. **【AIで作る場合】**
   * 右側の「AIアシスタント」枠にある「事実・様子のメモ」欄に、児童の様子を箇条書きで入力します（例：「漢字テストで満点」「掃除を黙々と頑張る」）。
   * 文字数範囲と結び方を選択し、**「✨ AIで文章を作る」** を押します。
   * 提案された文章を確認し、**「👇 この文章を下の入力欄に挿入する」** を押します。
3. **【自分で調整・編集する場合】**
   * 下部の最終編集欄で文章を調整します。文字数が自動カウントされ、設定範囲内か色で識別できます。
   * ネガティブな表現が含まれる場合、上部の警告バーに肯定的な言い換え案が表示されます。
4. **「💾 保存する」** ボタンを押すと、自動的にデータベースへ保存され、次の児童へ切り替わります。

---

### 5. 成績一覧表の Excel 出力

1. 上部メニューの **「📊 Excel出力」** ボタンをクリックします。
2. 保存先を指定すると、選択中の学期の**クラス全員分・全教科の所見が綺麗にレイアウトされたExcelファイル**が自動生成されます。

---

## 📜 ライセンス ＆ 免責事項

### ライセンス：MIT License
本ソフトウェアは **MITライセンス** のもとで無料公開されています。商用利用・改変・再配布が自由に許可されています。

```text
Copyright (c) 2026 [開発者名 または 清水]

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.