EZ-Flightlog ユーザーマニュアル

対象バージョン: v1.3.2（常に稼働中の最新版を表示します）

目次

• 1. はじめに
• 2. クイックスタート
• 3. 画面共通の操作
  • 3.1 ヘッダーナビゲーション
  • 3.2 バージョン表示
  • 3.3 操作の記録について（プライバシー）
• 4. アカウント
  • 4.1 新規登録
  • 4.2 ログイン
  • 4.3 ログアウト
  • 4.4 アカウント設定
  • 4.5 パスワード再設定（お忘れの場合）
  • 4.6 2段階認証（2FA）
  • 4.7 パスキー（パスワードレス）
• 5. 機体マスタ
• 6. 飛行記録の登録・編集
  • 6.1 入力項目
  • 6.2 ボタン
• 7. 飛行記録一覧
  • 7.1 検索フィルタ
  • 7.2 テーブルの見出し
  • 7.3 ページ移動ボタン
  • 7.4 累計フッター
  • 7.5 エクスポート／取込ボタン
• 8. 初期値（持込み値）
• 9. 画像取込
• 10. データ取込・エクスポート
  • 10.1 データ取込
  • 10.2 エクスポート
• 11. 飛行サマリー
• 12. 管理機能（管理者アカウントのみ）
  • 12.1 管理画面
  • 12.2 アクセスログ
  • 12.3 セッション再生
• 13. 付録: 数字だけで入力するヘルパー
  • 13.1 時刻の入力
  • 13.2 累計時間の入力
  • 13.3 整数の入力
• 14. 用語
• 15. バージョン情報

1. はじめに

EZ-Flightlogは滑空機の飛行ログを管理するWebアプリケーションです。 まず、EZ-Flightlogで新規アカウントを作成し、ログの記録を開始してください。 過去のログはまとめて初期値として登録することもできますし、ログブックを撮影した画像からまとめて登録することも可能です。

本マニュアルは、EZ-Flightlogの全機能と、画面上に表示されるすべてのボタン・操作要素の役割を説明します。困ったときは目的の画面の章を参照してください。

このアプリでできること

• 飛行記録の登録・閲覧・編集・削除（滑空機／動力滑空機）
• 過去の累計実績を「初期値（持込み値）」としてまとめて登録
• 紙のログブックを撮影した画像からAIで飛行記録を自動抽出して登録
• 他システムのJSON／CSVファイルからの取込、およびエクスポート
• 型式・登録記号・区間・期間での絞り込みと、飛行時間・発数の時系列サマリー
• 機体マスタの管理

2. クイックスタート

1. アカウントを作成する … ログイン画面の「新規登録」から、メールアドレスとパスワード（8文字以上）で登録します。→ 4.1 新規登録
2. 機体を登録する（任意） … 「機体マスタ」で普段乗る機体を登録しておくと、記録がスムーズです。飛行記録の登録時にその場で追加することもできます。→ 5. 機体マスタ
3. 飛行を記録する … ナビの「新規登録」から1件ずつ記録します。→ 6. 飛行記録の登録・編集
4. 過去の実績を取り込む（任意）
   • アプリ導入前の累計だけをまとめて入れる → 8. 初期値（持込み値）
   • 紙のログブックの写真からまとめて取り込む → 9. 画像取込
   • 他システムのCSV／JSONから取り込む → 10. データ取込・エクスポート
5. 実績を振り返る … 「飛行サマリー」で飛行時間・発数の推移を確認します。→ 11. 飛行サマリー

3. 画面共通の操作

3.1 ヘッダーナビゲーション

ログインすると、画面上部に共通ナビゲーションが表示されます。よく使う項目は直接リンクで、副次的な項目は ☰ メニュー（ハンバーガーメニュー）にまとめられています。

常時表示（直接リンク）

☰ メニュー（新規登録の右のボタン。クリックで開き、外側クリックまたは Esc キーで閉じます）

その他

右端にはログイン中のユーザー名（未設定ならメールアドレス）が表示されます。未ログイン時は右端に ログイン リンクのみが表示されます。

マニュアルの開き方: 本マニュアルはログインしていなくても閲覧できます。ログイン画面の「ユーザーマニュアル」リンク、またはログイン後の**☰ メニューの右にある「マニュアル」**から、いつでも /manual を開けます。

3.2 バージョン表示

画面下部のフッターに EZ-Flightlog v1.3.2 の形式で現在のバージョンが表示されます。

3.3 操作の記録について（プライバシー）

利用体験の改善（GUIの改善）を目的として、ログイン中のマウス移動・クリック・スクロール・画面遷移などの操作が自動的に記録されます。入力欄に打ち込んだ値（パスワードを含む）はマスクされ、平文では保存されません。 記録は管理者のみが閲覧できます（→ 12.3 セッション再生）。

4. アカウント

4.1 新規登録（/signup）

メールアドレスとパスワードでアカウントを作成します。

入力項目

ボタン・リンク

• アカウント作成（緑ボタン） … 入力内容を検証してアカウントを作成します。成功するとログイン画面へ移動し、「アカウントを作成しました。続けてログインしてください。」と表示されます。
• ログイン（リンク） … すでにアカウントがある場合、ログイン画面へ移動します。

エラー表示

• 「このメールアドレスは既に登録されています。」… 別のメールで登録してください。
• 「入力内容を確認してください (パスワードは8文字以上、有効なメール形式)。」

4.2 ログイン（/login）

入力項目: メール（必須）／パスワード（必須）

ボタン・リンク

• ログイン（青ボタン） … 認証してホーム（飛行記録一覧）へ移動します。
• 🔑 パスキーでログイン（枠線ボタン） … 登録済みのパスキーで、パスワードなしでログインします（→ 4.7 パスキー）。対応ブラウザでのみ表示されます。
• パスワードをお忘れですか？（リンク） … パスワード再設定画面へ移動します（→ 4.5 パスワード再設定）。
• 新規登録（リンク） … アカウントをお持ちでない場合、新規登録画面へ移動します。

認証に失敗すると「メールまたはパスワードが正しくありません。」と表示されます。

2段階認証を有効にしている場合は、メール・パスワードが正しいと 認証コード 欄が表示されます。認証アプリの6桁コード（またはバックアップコード）を入力して 「認証してログイン」 を押してください（→ 4.6 2段階認証）。

4.3 ログアウト

ヘッダー右端の ログアウト ボタンでサインアウトし、ログイン画面へ戻ります。

4.4 アカウント設定（/account）

プロフィール（表示のみ）: 名前、メール

• 操縦士技能証明書番号 … ライセンス番号を入力できます（例: KK-1234567、任意）。
• 保存（青ボタン） … 証明書番号を保存します。

パスワード変更

• パスワード変更（青ボタン） … 現在のパスワードを確認したうえで新しいパスワードに更新します。
  • 成功: 「パスワードを変更しました。」
  • 現在のパスワードが違う: 「現在のパスワードが正しくありません。」
  • 新パスワードが短い: 「新しいパスワードは8文字以上にしてください。」

4.5 パスワード再設定（お忘れの場合）

パスワードを忘れてログインできない場合は、メールで届くリンクから安全に再設定できます。

手順

1. ログイン画面の 「パスワードをお忘れですか？」 をクリック（/forgot-password）。
2. 登録済みのメールアドレスを入力し、「再設定リンクを送信」 を押します。
   • セキュリティのため、入力アドレスが登録済みかどうかに関わらず同じ案内（「登録されている場合は送信しました」）が表示されます。
3. 届いたメールの 「パスワードを再設定する」 ボタン（またはリンク）を開きます。
   • リンクの有効期限は 30分・1回のみ有効です。迷惑メールフォルダもご確認ください。
4. 新しいパスワード（8文字以上）を2回入力し、「パスワードを設定する」 を押します。
5. 完了するとログイン画面に「パスワードを再設定しました」と表示され、新しいパスワードでログインできます。

ボタン・リンク

• 再設定リンクを送信（青ボタン、/forgot-password） … 再設定メールを送信します（列挙防止のため常に同じ応答）。
• ログインへ戻る（リンク） … ログイン画面へ戻ります。
• パスワードを設定する（青ボタン、/reset-password） … 新しいパスワードを保存します。
• リンクが無効・期限切れの場合は「リンクが無効です」と表示され、「パスワード再設定をやり直す」 から再度お試しいただけます。

セキュリティ: 再設定リンクのトークンは暗号学的な乱数で、サーバーにはハッシュ化して保存され、1回使うと無効になります。パスワードを再設定すると、既存のログインセッションはすべて無効化されます（他人にログインされていた場合の対策）。

4.6 2段階認証（2FA）

パスワードに加えて、認証アプリが生成する**6桁のワンタイムコード（TOTP）**を要求することで、アカウントの安全性を高められます。任意の機能で、いつでも有効／無効を切り替えられます。設定は アカウント → 「2段階認証・セキュリティ設定」（/account/security）から行います。

有効にする手順

1. /account/security を開き、「2段階認証を有効にする」 を押します。
2. 表示された QRコード を認証アプリ（Google Authenticator / Microsoft Authenticator / 1Password など）で読み取ります（QRが使えない場合は「手動キー」を入力）。
3. 認証アプリに表示された 6桁コード を入力し、「確認して有効化」 を押します。
4. バックアップコード（10個） が表示されます。認証アプリが使えないときの予備なので、この画面でしか表示されません。「コピー」して安全な場所に保管し、「保管しました・飛行記録へ」 を押します。→ 設定が完了し、設定パネルが閉じて飛行記録画面へ自動的に移動します。

ログイン時

2段階認証が有効な状態でログインすると、メール・パスワードの後に 認証コード 欄が出ます。認証アプリの6桁コード、またはバックアップコード（1回のみ有効）を入力してください。

ボタン・コントロール（/account/security）

セキュリティ: 認証アプリのシークレットは暗号化して保存され、バックアップコードはハッシュ化して保存されます（いずれも平文では保存しません）。バックアップコードは1回使うと無効になります。認証アプリとバックアップコードの両方を失うとログインできなくなるため、バックアップコードは必ず保管してください（最終手段として管理者によるリセットがあります）。

4.7 パスキー（パスワードレス）

パスキー（WebAuthn） を登録すると、パスワードを入力せずに、端末の指紋・顔認証・PINやセキュリティキー（USB/NFC）でログインできます。フィッシングに強く、パスワードより安全です。任意の機能で、複数の端末のパスキーを登録できます。設定は アカウント → 「2段階認証・セキュリティ設定」（/account/security）の「パスキー」欄で行います。

登録する手順

1. /account/security を開き、「パスキー」欄で名前（任意・例: iPhone, YubiKey）を入力します。
2. 「パスキーを追加」 を押すと、端末の認証（指紋・顔・PIN 等）が求められます。
3. 認証に成功すると、パスキーが一覧に追加されます。

ログインする手順

1. ログイン画面で 「🔑 パスキーでログイン」 を押します。
2. 端末の認証（指紋・顔・PIN 等）を行うと、パスワードなしでログインできます（メールアドレスの入力も不要）。

ボタン・コントロール

一覧には各パスキーの名前・登録日時・最終使用日時が表示されます。

セキュリティ: サーバーには公開鍵のみが保存され、指紋・顔などの生体情報や秘密鍵は端末から外に出ません。パスキーは登録した端末（または同期先）でのみ使用できます。パスワードや2段階認証と併用でき、いつでも削除できます。

5. 機体マスタ（/aircraft）

普段使う機体（型式・登録記号）を管理します。飛行記録は機体マスタの機体に紐づきます。

新規追加フォーム

• 追加（青ボタン） … 入力した機体を新規登録します。

一覧テーブル

列: 型式 / 登録記号 / 飛行記録（その機体の記録件数） / 操作

各行の操作:

• 編集（リンク） … その機体の編集画面（/aircraft/{id}/edit）へ移動します。
• 削除（赤） … 確認ダイアログ「〇〇 を削除しますか?」の後、機体を削除します。
• 削除不可（グレー表示） … その機体に飛行記録が1件以上ある場合は削除できません（先に飛行記録を削除・付け替えてください）。

機体が未登録のときは「機体がまだ登録されていません」と表示されます。

機体の編集（/aircraft/[id]/edit）

• 型式 / 登録記号（いずれも必須）を編集できます。
• 更新（青ボタン） … 変更を保存します。
• キャンセル（リンク） … 保存せずに機体マスタへ戻ります。

6. 飛行記録の登録・編集

「新規登録」（/flights/new）と、一覧の各行の「編集」（/flights/[id]/edit）は同じ入力フォームを使います。新規なら 登録、既存を開いた場合は 更新 ボタンになります。

6.1 入力項目

基本情報

飛行区分

高度（いずれも任意、単位ft）: 離脱高度／動力停止高度、最高高度

補足事項: 自由記述のメモ（気象条件、機体特性、訓練内容など）

6.2 ボタン

• 登録 / 更新（青ボタン） … 入力内容を保存し、飛行記録一覧へ戻ります。
• 削除（赤ボタン、編集時のみ） … 確認ダイアログ「この飛行記録を削除しますか?」の後、記録を削除します。

積算（累計）はアプリが自動計算します。過去の記録を修正・削除すると、それ以降の累計もリアルタイムに再計算されます。手書きログの記入ミス防止のための仕組みです。

7. 飛行記録一覧（ホーム /）

登録済みの飛行記録を、1行＝1フライトの表で表示します。上部に検索フィルタ、下部に累計フッターがあります。初期表示は10件です。

7.1 検索フィルタ

フィルタ条件はブラウザに保存され、次回アクセス時に復元されます。

7.2 テーブルの見出し

日付・型式・登録記号・区間・飛行時刻（離陸／着陸）・着陸回数に続き、滑空機／動力滑空機それぞれの「飛行時間・機長・同乗教育・野外飛行（時間・距離）」、高度(ft)（離脱／最高）、教員時間、備考の列が並びます。時系列（古い順）で固定表示され、列のクリックによる並べ替えはありません。

各行右側:

• 編集（リンク） … その記録の編集画面へ移動します。
• 削除（赤リンク） … 確認ダイアログ「この飛行記録を削除しますか?」（日付・区間つき）の後、その記録を削除します。削除すると、それ以降の積算（累計）が自動的に再計算されます。

7.3 ページ移動ボタン（右側の縦並び）

飛行記録は時系列で、この7つのコントロールで表示位置を移動します。各ボタンはマウスを乗せると説明が表示されます。

最古／最新を表示中の方向のボタンは押せなくなります。表示位置と件数はブラウザに保存され、記録の編集後に戻っても維持されます。

7.4 累計フッター

• 頁小計 … 現在表示中ページの合計
• 前頁までの合計 … 表示先頭の1つ前までの累計
• 総合計 … 表示末尾までの累計

7.5 エクスポート／取込ボタン（テーブル右上）

記録がないときは「飛行記録がまだありません」と表示されます。

8. 初期値（持込み値）（/initial-values）

アプリ導入前に紙で飛んできたベテランパイロット向けに、過去の累計実績をまとめて登録する画面です。ここで登録した値に、アプリで記録した飛行が加算されて集計されます。

使い方

1. 基準日（必須） … 過去累計の締め日を入力します。基準日当日を含む過去の累計を入力します。
2. 各セルに 累計時間（数字1〜4桁を hh:mm に自動変換）と、その下に 累計飛行回数（単位「回」）を入力します。野外飛行の距離セルは距離（単位「km」）のみです。
   • 列構成: 滑空機（飛行時間／機長: ウィンチ・飛行機曳航／同乗教育: ウィンチ・飛行機曳航／野外飛行: 時間・距離）、動力滑空機（飛行時間／機長: 動力・滑空／同乗教育: 動力・滑空／野外飛行: 時間・距離）、操縦教員 時間。
3. 保存（青ボタン） … 初期値を保存します。

ボタン

• 保存 … 入力した初期値を保存します。
• 初期値を削除 … 確認ダイアログ「初期値 (持込み値) を削除しますか? 基準日と各カラムの累計初期値がすべてリセットされます。基準日より前のフライトもすべて表示・集計対象になります。」の後、初期値をリセットします。初期値が未登録のときは 初期値未登録 と表示され押せません。

9. 画像取込（/flights/import）

紙のログブックのページを撮影した画像をアップロードすると、Claude AI が飛行記録を1行ずつ自動抽出します。内容を確認・編集してから保存します。

手順

1. ファイル選択で画像を1枚以上選びます（複数可）。JPEG／PNG／GIF／WebP／HEIC／HEIF に対応（1ファイル最大20MB）。HEICはプレビューできませんが、サーバー側でJPEGに変換して抽出します。
2. 画像から抽出（ボタン、処理中は「抽出中… (N枚)」）を押すと、各画像を解析します。撮影の向きは自動補正されます（必要に応じて自動回転）。
3. 「抽出結果 (画像ごと)」に各画像の抽出件数・自動回転・エラーが表示されます。
4. 「抽出候補」に抽出された各行が編集可能なカードで並びます（初期状態で全行選択済み）。飛行日・型式・登録記号・区間・離着陸時刻・着陸回数・航空機タイプ・離陸方式・PIC区分・飛行範囲・（条件により）動力時間／距離・高度・備考をその場で修正できます。機体マスタに未登録の登録記号は黄色でハイライトされます。
5. 選択した行を保存 を押して保存します。

ボタン

保存時、未登録の登録記号があると「以下の機体は機体マスタに未登録です。機体マスタへ自動追加してから飛行記録を保存します。続行しますか?」と確認され、承認すると機体を自動追加してから保存します。保存後は「N 件保存しました。」と、自動追加された機体があればその一覧が表示されます。

10. データ取込・エクスポート

10.1 データ取込（/flights/data-import）

自システムのエクスポートJSON、または他システムのJSON／CSVから飛行記録を取り込む4ステップのウィザードです（1. ファイル選択 → 2. 項目の対応付け → 3. 確認 → 4. 完了）。1ファイルずつ取り込みます。

• ステップ1 ファイル選択 … .json / .csv を選択します。列名が標準形式と一致すれば対応付けを飛ばして確認へ進みます。
• ステップ2 項目の対応付け … 列名が標準と異なる場合、標準の16項目にファイルの列を割り当てます。取り込みたくない項目は先頭の (取り込まない) を選びます。
  • 対応付けを確定して次へ … 割り当てを確定し、既存記録と照合して確認へ進みます。
  • やり直す … 最初からやり直します。
• ステップ3 確認 … 読み込んだ行数・正常に読めた行・新規／既存重複の件数を表示します。未登録機体は取込時に自動追加されます。重複がある場合は「重複した記録の扱い」を選びます。
  • スキップ（既存はそのまま、新規のみ取込） … 既定
  • 上書き（既存記録を取込内容で更新）
  • 追加（重複を承知で新しい記録として追加）
  • N 件を取り込む … 取込を実行します。
  • 取り込めない行の詳細 … エラー行の内容を開いて確認できます。
• ステップ4 完了 … 新規追加／上書き／スキップの件数、自動追加された機体を表示します。
  • 飛行記録を見る … 一覧へ移動
  • 続けて別のファイルを取込 … 最初からやり直します

画面上部の ← 飛行記録へ戻る で一覧に戻れます。

10.2 エクスポート

エクスポートには2通りの方法があります。どちらで書き出したファイルも、そのまま「インポート（データ取込）」で読み戻せます（往復可能）。

(A) 一覧からワンクリック … 飛行記録一覧の CSV出力 / JSON出力（→ 7.5）で、そのとき表示している検索条件のデータをすぐに書き出します。

(B) エクスポート専用画面（/flights/export） … ナビの ☰ メニュー →「エキスポート」で開きます。形式と期間を選んで書き出せます。

画面上部の ← 飛行記録へ戻る で一覧に戻れます。

11. 飛行サマリー（/summary）

飛行記録を期間・型式・登録記号・区間で絞り込み、指定した粒度で時系列に集計してグラフ表示します。

集計粒度セレクタ

選択中のボタンは青く表示されます。セレクタ横に「対象 〇発 / 合計 〇〇（/ 期間数）」が表示されます。

グラフ

• 飛行時間（粒度別／累計） … 棒＝各期間の飛行時間、折れ線＝累計飛行時間
• 飛行発数（粒度別／累計） … 棒＝各期間の発数、折れ線＝累計発数

対象データがないときは「対象期間に飛行記録がありません。」と表示されます。フィルタの使い方は飛行記録一覧と同じです（→ 7.1）。

12. 管理機能（管理者アカウントのみ）

管理機能は特定の管理者アカウントでログインしたときだけ、ナビに 管理 リンクが表示され利用できます。一般ユーザーがURLで直接アクセスしてもホームへ戻されます。

12.1 管理画面（/admin）

登録ユーザーの一覧（氏名／メール／免許番号／フライト件数／機体件数／登録日）を表示します。各ユーザーカードで（管理者自身を除く）:

• 新パスワード (8文字以上) 入力 ＋ パスワード再発行 … 管理者が対象ユーザーのパスワードを強制リセットします。
• ユーザ削除 … 確認ダイアログの後、そのユーザーと関連データ（フライト・機体・初期値）をすべて削除します。

ロールの付与・変更やユーザーの新規作成機能はありません。管理者自身のパスワード変更・削除はアカウント設定から行います。

• アクセスログ … /admin/access-log へ
• セッション再生 … /admin/recordings へ

12.2 アクセスログ（/admin/access-log）

ログイン成功／失敗、アカウント登録、ログアウトの記録を表示します。直近30日の概況カード、ユーザー別ログイン集計、直近300件の明細（日時・種別・メール・IP・UA）を確認できます。

• 絞り込みタブ: すべて / ログイン成功 / ログイン失敗 / アカウント登録 / ログアウト
• ← 管理画面 … 管理画面へ戻る

12.3 セッション再生（/admin/recordings）

ユーザーのGUI操作（マウス移動・クリック・スクロール・画面遷移）を記録したセッションの一覧です。入力欄の値はマスクされています。

• 各行の 再生 … 個別の再生画面（/admin/recordings/[id]）へ
• ← 管理画面 … 管理画面へ戻る

個別再生画面では、rrweb プレーヤー（再生／一時停止・シークバー・再生速度などの標準コントロール付き）でセッションを再生できます。

• この記録を削除 … 確認ダイアログの後、その記録を削除します。
• ← 一覧 … 一覧へ戻る

13. 付録: 数字だけで入力するヘルパー

離着陸時刻や累計時間、各種の数値は、テンキーで数字を打つだけで正しい形式に自動整形されます。全角数字は自動的に半角へ変換されます。

13.1 時刻の入力（離陸／着陸時刻）

数字1〜4桁を打って入力欄を離れると hh:mm に整形されます。例: 830 → 08:30、1345 → 13:45。

13.2 累計時間の入力（動力稼働時間・初期値）

数字を打って入力欄を離れると「下2桁＝分、残り＝時間」として解釈されます。例: 130 → 1時間30分、1015 → 10時間15分。

13.3 整数の入力（着陸回数・距離・高度）

数字以外は取り除かれ、上限・下限を超える値は自動的に補正されます。単位（km・ft・回）は入力欄の横に表示されます。

14. 用語

15. バージョン情報

• 現在のバージョン: v1.3.2（このマニュアルは常に稼働中の最新版に追随します）
• バージョンは画面下部のフッターにも表示されます。
• 本マニュアルは固定 URL /manual で公開されており、バージョンが上がっても URL は変わりません。

本マニュアルは EZ-Flightlog の画面・機能に基づいて記載しています。画面の文言はアプリ内の実際の表示に合わせています。