登下校打刻 Kiosk 端末 (app/Kiosk) 手動操作テストケース定義書 [オフライン/デモ版]

最終更新: 2026-08-14 対象: Kiosk (玄関等に設置する WinUI 3 または Avalonia 打刻専用アプリ - デモモード / オフライン環境)

ローカルで動作するデモ環境（オフライン版）におけるスタンドアロン打刻動作、初回の管理者PIN登録、およびAndroid端末での見切れ・配置のUI検証に関するテスト手順です。打刻データは暗号化されたローカルファイル（offline_data.dat）と送信待ちキューに保存されます。デモ版は通常版と異なる Kiosk-Demo 保存領域を使用するため、検証打刻が実運用データを変更しないことも確認します。

---

1. 管理者設定機能と暗証番号認証

KIO-OFL-SET-01: 管理者設定画面の起動と認証

• 操作手順:
  1. フッター左側にある「設定」ボタンをタップする。
  2. 初回起動（管理者PIN未登録）の場合は、認証画面ではなく設定画面が直接表示されることを確認する。
  3. 「管理者PIN」に4〜8桁の数字を入力し、「保存」をタップする。
  4. 2回目以降は管理者認証画面が表示され、登録したPINで設定画面を開けることを確認する。
• 期待される結果:
  • 固定の初期PINや共通マスターPINを要求せず、端末ごとに登録したPINで設定画面を保護できること。
  • 接続環境プリセット、APIベースURL、施設ID、動作モード、お迎えQR有効化、Kiosk APIキー、管理者PINの設定項目が表示されること。

KIO-OFL-SET-02: 接続環境の切り替えと保存

• 操作手順:
  1. 管理者設定画面で「接続環境プリセット」から別の環境（例：「ローカル (デモデータ)」）を選択する。
  2. APIベースURLが自動的に更新されることを確認する。
  3. 「保存」ボタンをタップする。
• 期待される結果:
  • 設定画面が閉じ、画面上部に「INITIALIZING...」と表示された後、通信できる場合は「ONLINE」、通信できない場合は「OFFLINE（ローカル保存）」になること。
  • 新しい設定に基づいて、一覧表示される児童・職員のテストデータが読み込み直されること。

KIO-OFL-SET-03: Windows版設定と終了制御

• 操作手順:
  1. Windows版を起動し、フッターの「設定」をタップする。
  2. 初回は管理者PINを登録し、2回目以降はPIN認証を行う。
  3. API URL、施設ID、お迎えQR設定を変更して保存する。
  4. 設定を再度開き、「アプリ終了」を選択する。
• 期待される結果:
  • Windows版がフルスクリーンで表示され、管理者認証なしの終了操作は受け付けないこと。
  • 保存後にAPI URL、施設ID、お迎えQR設定が再読み込みされること。
  • 「アプリ終了」は管理者認証後だけ実行されること。

---

2. Android 端末向け UI レイアウト検証

KIO-OFL-UI-01: 画面アスペクト比と上下見切れの検証

• 操作手順:
  1. Kiosk Android アプリを起動する。
  2. 画面の上部（ヘッダー）および下部（フッターの「設定」ボタンなど）を観察する。
  3. 各開始エリア（「ICカードをタッチ」「QRリーダーでスキャン」）をスクロールして表示する。デモビルドでは追加で「顔認証（デモ）で打刻」が表示されることを確認する。
• 期待される結果:
  • 各種Android端末の画面アスペクト比に関わらず、上部ヘッダーや下部設定ボタンが見切れることなく、きれいに画面内に収まっていること。
  • コンテンツ領域が極端に引き伸ばされたり、ボタンが重なったりしていないこと。
  • 通常ビルドではデモ用QR入力とデモ顔認証が表示されず、実機入力の案内だけが表示されること。

KIO-OFL-UI-03: 職員PIN有効時の打刻ダイアログ

• 操作手順:
  1. 施設設定でKiosk職員PINを有効にしたデータを読み込み、職員用モードへ切り替える。
  2. 職員カードを画面で選択し、表示されたPINキーパッドを確認する。
• 期待される結果:
  • 設定された桁数のPINを入力して確認するまで、職員の出勤・退勤が記録されないこと。
  • キャンセル、C（消去）、誤入力時の再入力が機能し、NFCカード打刻は別フローとして利用できること。

KIO-OFL-UI-02: 管理者認証キーパッドの配置とサイズ

• 操作手順:
  1. 設定ボタンをタップして管理者認証画面を開く。
  2. 表示された10キー（1〜0、C、閉）の並びとボタンの形状を観察する。
• 期待される結果:
  • テンキーボタンが左寄りに潰れておらず、ダイアログ内の中央（Center）にバランスよく整列していること。
  • 各ボタンが丸型で十分な大きさ（直径 72px）を持ち、指でタップしやすいサイズ感であること。
  • 数字入力時、および「C」での消去、「閉」でのキャンセルが問題なく動作すること。