【授業レポート】システム開発（3年） 第53週目
〜最終調整＆発表準備：完成度を“伝わる形”へ〜
第53週目は、最終プロジェクトの仕上げフェーズとして、
バグ修正・UI改善・ドキュメント整備を行い、
発表に向けて“伝わる形”に整える授業となりました。
ここでのテーマは、
「動く」から「伝わる」へ。
■ 先生の導入：「完成度は“使う人の視点”で決まる」
田中先生：「開発者にとって分かるものではなく、
“初めて触る人でも使えるか”が完成度です。
今日はその視点で見直します。」
先生は、チェックの観点として以下を提示しました。
- 初見で操作できるか
- エラー時に困らないか
- 表示が分かりやすいか
- AIの挙動が適切か
■ 今日のゴール
- 主要ユースケースを安定動作させる
- UIを分かりやすく改善する
- README・説明資料を完成させる
- 発表デモの流れを作る
■ 実習①：バグ修正と安定化
まずは、結合テストで見つかった問題を修正。
よくあったバグ
- APIレスポンスのキー違い
- AI出力の文字数オーバー
- 入力エラーでクラッシュ
- フォールバックが動かない
対応
- バリデーション強化
- 例外処理追加
- ログで原因特定
生徒A：「ログを見ながら直せるようになってきた！」
■ 実習②：UI改善（ユーザー視点）
次に、UIを徹底的に見直しました。
改善ポイント
- 操作手順の明示
- ボタン・入力の分かりやすさ
- エラーメッセージの改善
- AI出力の説明追加
例：
※この文章はAIによって生成されています
生徒B：「“説明を足す”だけで使いやすさが変わる」
■ 実習③：ドキュメント最終整備
READMEと設計資料を完成させました。
含めた内容
- システム概要
- 機能説明
- 使い方（手順）
- エラー時の対応
- 使用API・AIの説明
- 安全設計のポイント
生徒C：「“他人が読む前提”で書くのが難しい」
■ 実習④：発表デモの構成作成
各班で発表の流れを設計。
発表構成（共通）
- システム概要
- ユースケース説明
- デモ（正常系）
- エラー・フォールバック
- 工夫点（AI・設計）
先生：「デモは“成功すること”より
“意図が伝わること”が重要です。」
■ 実習⑤：リハーサル（模擬発表）
班ごとに簡単な発表練習を実施。
フィードバック内容
- 説明が専門用語寄り
- デモの流れが分かりにくい
- AIの説明が不足
- エラー処理の説明が良かった
生徒D：「話してみると、自分の理解の甘さが分かる」
■ クラス全体の気づき
- 完成度は“伝え方”で変わる
- UIと説明はセット
- エラー処理は発表で評価される
- AI機能は説明しないと伝わらない
■ 先生のまとめのひとこと
「ここまでで、皆さんは
“システムを作る力”を身につけました。
最後に必要なのは、
それを人に伝える力です。
発表はゴールではなく、
“自分の設計を言語化する機会”です。」
■ 宿題（最終発表前）
- 発表スライド作成
- デモ手順の最終確認
- 想定質問を3つ考える
■ 来週の予告：最終発表会
次週はいよいよ
最終発表会です。
3年間の学びを一つのシステムとして発表し、
クラス全体で成果を共有します。
第53週目は、
システムを“完成させる”だけでなく、
“伝わる形に仕上げる”重要な授業でした。
生徒たちは、技術と表現の両方を磨き、
最後の発表へ向けて準備を整えています。