週案エディタ（School Plan Note）

週案エディタ（School Plan Note） は、小学校（および小中学校）の教員向けに開発された、週案（週間指導計画）および校務支援のWebアプリケーションです。

Google Apps Script (GAS) と Google スプレッドシートをバックエンドとして利用し、最新の生成AI（Gemini API）を組み込むことで、教員の日常的な事務作業の負担を大幅に軽減することを目的としています。

🖥 画面構成（8つのタブ）

アプリはシングルページ構成で、画面上部の8つのタブを切り替えて使います。以下の機能説明は、このタブ名で参照しています。

タブ	何をする画面か
週案	週単位のグリッドに授業予定を入力する。起動時に開く画面
行事予定	学校の年間行事予定PDFを登録・閲覧する
タスク	準備物・連絡事項などのタスクを管理する（未処理件数がタブにバッジ表示）
単元	「単元マスタ」シートを表形式で編集する（画面見出しは「単元マスタ編集」）
学級通信	学級通信をブロックエディタで作り、PDF出力・Classroom投稿する
時数	教科別の実施時数集計と、年度末の過不足シミュレーション
PDF読み込み	指導計画PDF・行事予定PDFをAIで解析して取り込む
設定	使用中のデータベース、システム設定、固定時間割、標準時数、データ保全・復元など

タブの右端には表示テーマの切替ボタンがあり、押すたびに「自動（OSの設定に追従）→ ライト → ダーク」を巡回します。

🚀 主な機能 (Features)

1. デジタル週案（週間指導計画）

• ブラウザ上の直感的なグリッドUIで、1週間分の予定を入力・管理できます。行は上から 行事／登校前／朝学習／1校時／2校時／中休み／3校時／4校時／昼休み／5校時／6校時／放課後／宿題／持ち物 の14行で、各校時は「教科」「単元」「学習活動」の3つに分かれています。土曜・日曜の列は表示/非表示を切り替えられます。

• セルはダブルクリック（ダブルタップ）で編集でき、**ドラッグ＆ドロップでのコマ移動・Undo（元に戻す）**にも対応しています。朝学習・中休み・昼休み・放課後の欄には、「タスク」タブに登録したタスクをボタンから転記できます。

• 閲覧モードは完全に読み取り専用、書き換えは編集モードだけ: 週案タブには「閲覧モード」と「編集モード」があり、内容を書き換える操作（入力、コマのコピー＆ペースト、クリア、ドラッグ＆ドロップでの入れ替え、元に戻す、タスクの書き込み）はすべて編集モードでのみ行えます。閲覧モードでは右クリックや長押しのセル操作メニューも出ません。閲覧中に書き換えようとしたときは、編集モードへの入り方を案内します。

  • この線引きは、保存されない編集を防ぐためです。以前は閲覧モードでもセル操作ができ、そのための自動保存が別に走っていました。モードの切り替えとグリッドの描き直しが食い違うと「閲覧モードの表示のままセルが編集できてしまい、打った内容が保存されない」という壊れ方をしたため、閲覧モードからは書き込みの経路そのものを無くしました。
  • 編集モードへの入り方: ツールバーの「編集」ボタン、E キー、セルのダブルクリック（ダブルタップ）、選択中セルで Enter。
  • Ctrl+C / Ctrl+V: 編集モードで、文字を選択していない時の Ctrl+C がコマ全体のコピーになり、コピーしたコマを Ctrl+V するとセルごと貼り付きます。文字を選択してのコピーや、他アプリからコピーした文字の貼り付けは今までどおり文字として扱われるため、入力の邪魔になりません。閲覧モードでは横取りしないので、選んだ文字がブラウザ標準の動きでそのままコピーできます。
  • 右クリック（コピー / ペースト / クリア / 元に戻す）は編集モードで開きます。文字を選択している時だけは、ブラウザ標準のメニューを優先します。閲覧モードではいつもブラウザ標準のメニューなので、セルの中のリンクを新しいタブで開いたり、文字を選んでコピーしたりできます。
  • タブレットなど右クリックできない端末では、編集モードで**選択中のセルの右上に出る「⋮」**から同じメニューを開けます（出るのは選択中の1セルだけなので画面は散らかりません）。長押しは、どちらのモードでも文字選択のまま残しています。
  • 編集中の入力内容は、これらの操作や再描画をはさんでも失われず、カーソル位置も保たれます。「キャンセル」を押した時は、入力もセル操作もまとめて編集開始前の状態に戻ります。

• 登校前タスク列: 「行事」列と「朝学習」列の間に、出勤後・児童登校前に済ませておくタスクを記入できる「登校前」列を用意しています。アプリが作成するデータベースには最初から含まれています（11_Tenant.gs の DB_CANONICAL_HEADERS）。この列が導入される前に作ったシートや、手作りのシートで欄が出ない場合は、スプレッドシートを直接開いて「行事」列の隣に列を挿入し、見出しに 登校前 と入力してください。列は見出し名で解決するため（00_config.gs の scanDbHeaderForSheet_()）、並び順は問いません。印刷時は印刷オプションのチェックボックスで表示するかどうかを選べます（初期状態は非表示）。

• 祝日の自動表示: 内閣府が公開する祝日データ（syukujitsu.csv）を自動取得し、週案グリッドの該当日を赤色で強調して祝日名（例：「海の日」）をバッジ表示します。印刷時も標準・コンパクト両レイアウトで祝日の列を赤系で色分けし、祝日名を表示するため、休みの日が一目で分かります。祝日データは未取得なら週案の生成時に自動取得されます。更新はアプリを開いたとき（doGet）に行われ、前回取得から25日以上経っていれば自動で取り直します（07_WebApp.gs の HOLIDAY_REFRESH_INTERVAL_DAYS）。手動更新の操作はありません。

• 入力支援メニュー: ツールバーの「入力支援」に、固定時間割反映／単元自動入力／以降を一括自動入力／単元をずらすをまとめています。グリッドの右側には開閉できるサイドパネルがあり、今週のタスクと行事予定PDFをタブで切り替えられます。タスクのカードは週案のセルへドラッグして、そのまま記入できます（ドラッグできない端末では、セルを選んでカードの書き込みボタンを押します）。ツールバーのキーボードアイコンからショートカット一覧を確認できます。

• AI自動入力: 「単元マスタ」の進捗と過去の履歴を照らし合わせ、次の時間の学習内容を自動で割り当てます。その週だけの自動入力と、その週以降をまとめて埋める一括自動入力を選べます。

• 進捗つき単元選択: 週案の単元選択モーダルに、単元ごとの指導状況（未指導／○時間目まで実施済み／指導済み）を表示します。指導が終わった単元は既定で折りたたまれて下に送られ、次に指導する単元が先頭に強調表示されるため、毎回一覧から目で探す必要がありません。単元名での検索もでき、単元を選んだあとの「何時間目」も自動で次の時間目が初期選択されます。この進捗には、まだ保存していないその週の入力も含まれます。月曜のコマに1時間目を入れたら、保存しなくても火曜のコマでは2時間目が初期選択になります（手入力・ドラッグ＆ドロップ・自動入力の結果も同じように反映されます）。この反映は画面内で完結するため、サーバーへの問い合わせは増えません。

  • 単元名の表記ゆれは自動で吸収します: 週案のセルに全角スペースが入っていたり、かぎ括弧をつけていたり、長音「ー」がハイフン「-」になっていたりしても、単元マスタの同じ単元として数えます。それでも別の名前で書いてしまった分は、モーダルの下に「週案にこの名前で書かれていますが、単元マスタにはありません」として、何時間目まで入っているかと一緒に出ます。
  • 「◯時間で終了」: 5時間で組んだ単元を3時間で切り上げたときは、その単元の行にある「◯時間で終了」を押すと、単元マスタの総時数を実際に指導した時数に合わせます。以後その単元は「指導済み」として扱われ、自動入力もそこへ戻らなくなります。余った時間の学習活動は消しません（行はそのまま残るので来年また使えます）。単元マスタは全学級で共通のため、この変更はすべての学級に反映されます。実行前の状態は復元ポイントとして保存されます。
  • 「指導しない」（未指導の単元を終了扱いにする）: 結局やらないまま学期が終わった単元は、未指導のままだと自動入力が何度もそこへ戻ってきます。そういう単元の行には「指導しない」が出ます。押すと総時数が全0時間になり、指導し終えた単元と同じように扱われます。ここでも行は消さないので、学習活動は来年また使えます。あとで指導することになったら、一覧のその行を押すと「指導を再開しますか？」と聞かれ、総時数が行数へ戻ります。
  • まとめて終了にする: 終了にできる単元が2つ以上あるときは、一覧の右上に「まとめて終了にする」が出ます。押すと行にチェックが並び、指導途中の単元も未指導の単元も混ぜて選べます。検索で絞ってから「表示中をすべて選ぶ」も使えます。学期末に何単元もまとめて閉じるための入口です。復元ポイント・書き込み・監査ログは何単元選んでも1回ずつなので、1件ずつ押したときのように復元ポイントが単元の数だけ増えることはありません。

• 週をまたいだ全文検索: 週ナビゲーションの「検索」ボタンから、すべての週の入力内容（行事・朝学習・各校時の教科/単元/学習内容・宿題・持ち物・振り返りなど）をキーワードで横断検索できます。「あの実験いつやったっけ」も一発で見つかり、検索結果をクリックするとその週の週案へジャンプします。

• 印刷: 「印刷」ボタンで印刷オプションが開きます。レイアウトは標準（A4・2ページ）／コンパクト（A4・1ページ）の2種類。行事・登校前・朝学習・中休み・昼休み・放課後・教科時数表・週のまとめ・Todoリストの9項目を個別にON/OFFでき、フォントサイズは既定で用紙に合わせて自動調整され、その週の分量に対してA4に収まる範囲でいちばん大きいサイズが選ばれます（自動調整をOFFにすると8〜14pxで手動指定できます）。選択内容はブラウザに記憶されます。Todoリストと教科時数表は標準レイアウトの2ページ目にのみ印刷されます。なお、アプリの「印刷」ボタンを使わずブラウザの印刷（Ctrl+P など）を直接呼んだ場合は、週案の紙面ではなくいま開いている画面が刷られます。この場合も画面の途中で切れないよう、紙では画面の高さの縛りと内側のスクロールを外して全体を流し込みます。

  • ⚠️ 印刷ダイアログの上端が画面から切れて見えるとき: これはブラウザ自身のダイアログで、Chrome のそれには最低限の高さがあります。端末の画面がそれより低いと上端がはみ出し、見出しやページ数が切れたまま出ます。アプリからはこのダイアログの大きさも位置も変えられません。 Chromebook では **Ctrl と Shift と −（ハイフン）**を同時に押して端末の表示を1段小さくすると収まります（戻すのは Ctrl と Shift と ＋）。画面の高さが足りない端末では、印刷オプションの中でこの手順を案内します。

• 固定時間割の反映: 「設定」タブの「固定時間割エディタ」で基本の時間割を登録しておくと、週案画面の「入力支援」からその週へ一括反映できます。「年間一括転記」を使えば、長期休業期間を除いた今後のすべての週へまとめて転記できます（既存の入力は上書きされます）。

  • 転記が書き込むのは、エディタに表示中の内容ではなく保存済みの固定時間割です。取り違えて「前の時間割が入った」とならないよう、転記の前に実際に書き込まれる時間割を表で確認できます。エディタに未保存の変更があるときは警告し、その場で保存してから転記できます。
  • 固定時間割が空のまま転記すると対象週の時程・朝学習・各校時が消えるため、実行前に警告します。

2. 生成AI (Gemini) による業務アシスト

• PDF自動読み取り: 学校配布のPDF（年間指導計画・行事予定）をAIが解析し、スプレッドシートに転記します。「PDF読み込み」タブにドラッグ＆ドロップするか、クリックしてファイルを選ぶ方式で（複数可・1ファイル15MBまで）、ファイルごとの処理状況が画面に表示されます。抽出結果は書き込み前にプレビュー（行事予定は月ごと、指導計画は教科ごと）で確認・修正・除外してから反映できます。指導計画の反映時は、同じ教科の既存データが置き換えられます。
  • 読み込むのは自校で作成・編集した指導計画を基本にしてください。教科書会社の指導書などをもとにした資料を取り込んだ場合、その文言を学級通信やClassroomの投稿へそのまま転載しないようご注意ください（著作権法35条の範囲を外れ得ます）。

This is the beginning of the README. Read the rest at the original. Read the full README ↗