ActCheckTracker ユーザーマニュアル

7. 集中セッション機能

7.1 集中セッションとは

集中セッション機能は、メインの常時記録とは別に、ユーザーが意図した区間だけを切り取って記録・分析するストップウォッチ機能です。
特定の作業やプロジェクトに集中している時間を計測し、その期間の活動データを詳細に分析できます。

集中セッションは、メインのモニタリングが有効な場合のみ開始できます。メインのモニタリングが停止すると、集中セッションも自動的に停止されます。

7.2 セッションの開始と停止

サイドバーの「⏱️ 集中セッション」ボタンをクリックして、集中セッション画面を開きます。

1. タイトルを入力：セッションのタイトルを入力します（例：「プロジェクトAの作業」「午前中の集中時間」など）。
2. 開始ボタンをクリック：セッションが開始され、ストップウォッチが動き始めます。
3. 作業を行う：通常通りPC作業を行います。セッション中の活動データが記録されます。
4. 停止ボタンをクリック：セッションを終了します。確認ダイアログが表示されるので、確認して停止します。

セッション実行中は、リアルタイムで経過時間や統計情報（キーストローク数、クリック数、アプリ使用状況など）が表示されます。

7.3 セッション履歴の閲覧

サイドバーの「📋 セッション履歴」ボタンをクリックして、過去の集中セッションの履歴を閲覧できます。

• 期間の指定：開始日と終了日を指定して、特定期間のセッションを表示できます。
• セッション一覧：各セッションのタイトル、開始時刻、終了時刻、経過時間、統計情報が一覧表示されます。
• セッション詳細：セッションを選択すると、詳細な統計情報を確認できます。
• PDF出力：セッション履歴画面の「PDF出力」ボタンをクリックすると、選択したセッションの詳細な統計レポートをPDF形式で出力できます。レポートには、セッションの基本情報、キーストローク数、クリック数、マウス移動距離、アプリ使用状況などの詳細な統計が含まれます。

7.4 セッションの削除

セッション履歴画面で、不要になったセッションを削除できます。

1. 削除したいセッションを選択します。
2. 「削除」ボタンをクリックします。
3. 確認ダイアログで確認して削除を実行します。

8. 設定画面

サイドメニューの「設定」ボタンをクリックすると、アプリケーションの詳細な設定を行えます。設定画面は以下のカテゴリーに分かれています。

8.1 プライバシー設定

• データ収集の状態： 現在の監視状態（監視中/停止中）を表示します。これは実監視状態（`MonitoringService.IsMonitoring`）の表示専用で、ON/OFF切替機能ではありません。監視の開始/停止は左側のモニタリングパネルで操作してください。監視状態が変更されると、この表示も自動的に更新されます。
• 記録しないデータ： プライバシー保護のため、キー入力内容や画面キャプチャ等は一切記録しないことを明記しています。

8.2 データのエクスポート・インポート

データのバックアップと移行を行います。2種類のエクスポート/インポート方法があります。

8.2.1 セッションデータのエクスポート・インポート

期間を指定してセッションデータのみをエクスポート/インポートします。

• エクスポート期間： 「全期間」または「日付指定」でデータを出力できます。
• データをエクスポート (📤)： 指定した期間のセッションデータをJSON形式またはCSV形式で保存します。
• データをインポート (📥)： 過去に保存したJSONファイルからセッションデータを復元（マージ・統合）します。

8.2.2 フォルダ全体のエクスポート・インポート

【v1.0.3〜追加】 Dataフォルダ全体をZIP形式でエクスポート/インポートします。セッションデータ、集中セッション、通知設定、通知履歴など、すべてのデータを含みます。

• 使い分け： 「PC移行/完全バックアップ（設定や通知履歴も含めたい）」ならこちら。特定期間の活動データだけ欲しい場合は 8.2.1 セッションデータのエクスポート を使ってください。
• 注意（個人情報）： ZIP内の export-info.json には、復元・調査のために UserName/MachineName が含まれる場合があります。第三者へ渡す際は十分注意してください。

• 📦 フォルダ全体をエクスポート： Dataフォルダ全体をZIP形式でエクスポートします。エクスポート日時、アプリバージョン、ライセンス状態などのメタデータも含まれます。
• 📥 フォルダ全体をインポート： ZIPファイルからDataフォルダ全体をインポートします。インポート前にプレビューが表示され、インポートモードを選択できます。

8.3 データ管理

不要なデータの削除を行います。

• データ保持期間（日）： 指定した日数より古いデータを自動的に削除します。0 以下で無効（デフォルトは 0）なので、初期状態では自動削除されません。必要に応じて日数を設定してください。
  削除判定は基本的にセッションの開始日時を基準に行います（データが破損して読み込めない場合は、ファイル日時でベストエフォート判定します）。
• 期間を指定して削除 (🗑️)： 「今日」「昨日」などのクイック選択や日付指定で、特定期間のデータを消去します。
• すべてのデータを削除 (🗑️)： 全ての履歴データを完全に消去・リセットします。

8.4 起動設定

• Windows起動時に自動起動： PC自体の起動時に、アプリを自動的にバックグラウンドで立ち上げる設定です（推奨）。
  この設定をONにすると、Windowsレジストリ（`HKEY_CURRENT_USER\SOFTWARE\Microsoft\Windows\CurrentVersion\Run`）にアプリの実行ファイルパスが登録されます。MSIXパッケージ版でも動作します（`runFullTrust` capabilityが必要）。
• 登録確認ボタン： 「登録確認」ボタンをクリックすると、以下の情報が表示されます：
  • 登録状態（有効/無効）
  • レジストリに登録されているパス
  • 現在の実行ファイルパス
  • パスの一致/不一致
  • 登録パスのファイル存在確認結果
  この情報により、スタートアップ登録が正しく設定されているかを確認できます。
• 単一起動仕様： アプリは同時に1つのインスタンスのみ起動可能です。既存インスタンスが起動中の場合、新しいインスタンスを起動しようとすると、既存インスタンスのウィンドウが前面に表示され、新しいインスタンスは終了します（Mutexを使用）。
• アプリを常駐させる（システムトレイ）： 有効にすると、ウィンドウを閉じる（×ボタン）操作でもアプリは終了しません。代わりに、システムトレイに格納され、バックグラウンドで監視を継続します。
  トレイアイコンのコンテキストメニューまたはダブルクリックで、アプリを表示/終了できます。
  • トレイアイコンのコンテキストメニュー： トレイアイコンを右クリックすると、「開く」「終了」のメニューが表示されます。
  • ダブルクリックで開く： トレイアイコンをダブルクリックすると、ウィンドウが復帰します。
  • バルーンチップ通知： 初めてトレイに格納した際、アプリがバックグラウンドで実行中であることを示す通知が表示されます。

8.5 表示設定

• テーマ選択： アプリ全体のデザイン（配色）を変更できます。
• 更新間隔（秒）： ダッシュボードの更新頻度を1～60秒の間で調整できます。
• リアルタイムダッシュボード設定： 集計期間モードを選択し、ダッシュボードに表示される数値の基準を変更できます。
  • アプリ起動時 (PerLaunchMode)： アプリを起動してから現在までのデータのみを集計します。再起動すると数値はリセットされます。
    （例：「今からの作業でどれくらいキーを打つか」など、作業セッションごとの計測に適しています）
  • 今日0時から (DailyMode)： 今日の午前0時から現在までのデータを合算して表示します。アプリを再起動しても数値は維持されます。
    （例：「今日1日でトータルどれくらいPCを使ったか」など、日次の活動量把握に適しています）
• ダッシュボードコンポーネント表示設定： ホーム画面（リアルタイムダッシュボード）に表示される各情報パネルのオン/オフを切り替えられます。
  💡 ヒント： 設定画面だけでなく、ダッシュボード画面上で右クリックすることでも、表示項目の設定メニューを素早く呼び出すことができます。

8.6 統計ページ設定

• チャートレイアウトのリセット： 統計画面の各チャートの表示・非表示や並び順を、デフォルト（アプリインストール時）の状態に戻すことができます。「今日」「今週」などの期間ごとにリセットボタンが用意されています。

8.7 アプリケーション情報

現在のバージョンや、実際にデータが保存されているフォルダのパス（場所）を確認できます。

8.8 ライセンス情報（試用版）

試用版のActCheckTrackerを使用している場合、設定画面の「ライセンス情報」セクションからライセンス状態を確認し、ライセンスを購入することができます。

「ライセンス情報」セクションでは、以下を確認できます：

• ライセンス状態：試用期間中は「試用版」と表示されます
• 試用期間の情報：残り日数が表示されます（例：「試用期間中 (残り6日)」）
• 購入ボタン：試用期間中（有効または終了）は「購入する」ボタンが表示されます。このボタンをクリックすると、Microsoft Storeの購入ページが開きます。

ライセンス状態の確認方法

ライセンス状態を確認するには、以下の手順を実行してください：

1. サイドバーメニューから「設定（⚙️ Settings）」を開きます。
2. 「ライセンス情報」セクションまでスクロールします。
3. このセクションに表示されている「ライセンス状態」と「ライセンス詳細」を確認します。

ライセンス情報は、設定画面を開くたびに自動的に更新されます。以下の情報が表示されます：

• ライセンス状態： 現在のライセンス状態を表示します：
  • 試用版：現在、試用期間中です。
  • 購入済み：ライセンスを購入済みです。
  • 試用期間終了：試用期間が終了しました。
• ライセンス詳細： ライセンスの詳細情報を表示します：
  • 試用期間中の場合：「試用期間中（残り X 日）」と表示されます。
  • 購入済みの場合：「すべての機能が利用可能です。」と表示されます。
  • 試用期間終了の場合：「試用期間が終了しました。引き続きご利用いただく場合は、ライセンスのご購入をお願いいたします。」と表示されます。

試用期間中のライセンス購入方法

試用期間中に、アプリ内からライセンスを購入できます：

1. サイドバーメニューから「設定（⚙️ Settings）」を開きます。
2. 「ライセンス情報」セクションまでスクロールします。
3. 試用期間中（有効または終了）の場合、このセクションに「購入する」ボタンが表示されます。
4. 「購入する」ボタンをクリックします。
5. 確認ダイアログが表示されます。メッセージを確認し、「はい、購入を続行する」をクリックして進みます。
6. Microsoft Storeの購入ページが開きます。Storeページの指示に従って購入を完了してください。
7. 購入が完了したら、アプリに戻ります。ライセンス状態が自動的に更新され、アプリを再起動する必要なく、すべての機能が利用可能になります。

試用期間中のネットワーク接続について

• 試用期間中：
  • アプリは起動のたびにMicrosoft Storeとライセンス認証を実施し、試用期間の終了日時と残り日数を確認します。
  • インターネット接続がある場合、Store APIによる認証結果に基づいて正確な残り日数が表示されます。
  • インターネット接続がない場合、最後に取得したライセンス状態とローカルに保存された試用期間開始日時を使用して、残り日数を推定表示します。
• 購入後：
  • アプリ内からライセンスを購入した場合、購入状態がすぐにローカルに保存され、アプリを再起動しなくてもすぐにすべての機能が利用可能になります。
  • Microsoft Storeから直接ライセンスを購入した場合（アプリ外から購入）、次回起動時にMicrosoft Storeと認証を行い、購入状態を確認します。
  • 重要：Microsoft Storeから購入後、初回起動時にインターネット接続がない場合、アプリは一時的に試用版として動作します。インターネットに接続してMicrosoft Storeと認証が完了すると、購入が検知され、正規版機能に切り替わります。
  • 購入状態が確認され、ローカルに保存されると、アプリはインターネット接続を一切必要とせず、完全にオフラインで動作します。

試用期間終了時の動作

試用期間が終了した後にアプリを起動した場合（まだライセンスを購入していない場合）、ライセンスの購入を促すダイアログボックスが表示されます：

ダイアログには以下の内容が表示されます：

• 試用期間中のご利用への感謝のメッセージ
• 試用期間が終了したことの通知
• 引き続きアプリをご利用いただく場合はライセンスのご購入をお願いする旨
• 2つのボタン：「購入する」（購入を進める）または「終了」（アプリを閉じる）

「購入する」をクリックすると、確認ダイアログが表示され、その後Microsoft Storeの購入ページが開きます。「終了」をクリックすると、アプリが閉じます。

試用期間中のオフライン時の動作

試用期間中にオフラインの場合、アプリは以下のように動作します：

• 初回起動時（オフライン）：
  • インターネット接続がない状態で初めてアプリを起動した場合、暫定的に7日間の試用期間があるものとして動作します。
  • 実際の試用期間は、次回インターネット接続がある状態でアプリを起動した際に確認されます。
• 試用期間中（オフライン）：
  • 以前にインターネット接続がある状態でアプリを起動し、試用期間が確認されている場合、アプリはローカルに保存された試用期間開始日時から残り日数を計算します。
  • この計算に基づいて、オフラインでもアプリを継続して使用できます。
• 試用期間終了後（オフライン）：
  • 試用期間が終了している場合（以前のオンラインセッションで確認済み）、オフラインでもアプリは使用できません。

試用版の機能制限

試用版では、正式版と比較して以下の機能が制限されています：

• 統計画面：「今日」の期間のみ利用可能。その他の期間（昨日、今週など）は選択できません。
• テーマ選択：デフォルトテーマのみ利用可能です。
• データエクスポート：データエクスポート機能は利用できません。
• データ削除：データ削除機能（全削除、期間指定削除）は利用できません。
• 集中セッション：集中セッション機能は利用できません。
• 集中セッション履歴：集中セッション履歴の表示は利用できません。
• 通知設定：カスタム通知条件の追加はできません。標準の通知プリセットのみ利用可能です。

8.9 通知設定

「状況通知（スマート通知）」の動作を詳細に設定できます。
自分の作業スタイルに合わせて、どのようなタイミングで通知を受け取るかをカスタマイズしましょう。

全般設定

• 通知の有効化： 機能全体のON/OFFを切り替えます。一時的に集中したい場合はオフにしてください。
• 1時間あたりの最大通知数： 通知が頻繁すぎて作業の妨げにならないよう、1時間あたりに表示される通知の上限回数を設定できます（デフォルトは100回）。上限を超えた通知はスキップされます。

通知条件の詳細設定（条件の追加・編集）

「ルールの追加」または既存ルールの「編集」ボタンをクリックすると、条件設定ダイアログが開きます。
ここで「どのようなときに通知するか」を細かく定義できます。

① 条件タイプ（メトリック）の種類

通知の基準となる測定値には、大きく分けて「累積型」と「時間型」の2種類があります。

タイプ	説明	具体例
累積型 （数・距離）	キー入力数、クリック数、マウス移動距離など、「回数や量」が一定値を超えたときに通知します。	「今日のキー入力が10,000回を超えたら通知」 「マウス移動距離が1kmを超えたら通知」
時間型 （時間・期間）	連続作業時間やアクティブ時間など、「時間の長さ」が条件を満たしたときに通知します。休憩の目安に最適です。	「2時間連続で作業したら通知」 （15分以上の操作なしでリセットされます）

② 時間範囲（スコープ）の設定

その条件を「どの期間」で集計するかを指定します。

• 今日 (Today)：今日の0時からの合計値で判定します（日次の目標管理などに）。
• 現在のセッション (Session)：アプリを起動してからの（または集中セッション中の）合計値で判定します（作業区切りの管理に）。

③ しきい値（目標値）

通知を行う具体的な数値を入力します。
・数・スコア：そのままの数値（例：10000）
・時間：秒単位（例：1時間なら 3600）
・距離：ピクセル単位（例：1kmなら 約1,000,000）

8.10 通知プリセット（おすすめセット）

「一つずつ設定するのが面倒」という場合は、プリセット機能を使用してください。
「健康管理」「生産性アップ」など、目的に合わせた推奨設定を一括で適用できます。

• プリセットの選択： リストから好みのセットを選択すると、右側に含まれる条件の内容が表示されます。
• 適用方法： 「現在の設定に追加（マージ）」するか、「現在の設定をすべて消去して置き換え」するかを選べます。

9. データ管理

9.1 データのエクスポート（バックアップ）

活動データを手動でバックアップしたり、別のPCへ移行するためにデータをJSON形式で書き出すことができます。

1. メイン画面右上の「設定（歯車アイコン）」をクリックして設定画面を開きます。
2. 左側のメニューから「データ管理」を選択します。
3. 「データのエクスポート」セクションにある「期間を選択」ドロップダウンから、書き出したい期間（全期間、今年、今月など）を選びます。
4. 「エクスポート」ボタンをクリックし、保存先とファイル名を指定して保存します。

エクスポートされるファイルの内容

出力されるJSONファイルには、以下の詳細情報が含まれます。

• メタデータ (Metadata)：
  • ExportDate：エクスポート実行日時（UTC）
  • StartDate / EndDate：対象期間
  • SessionCount：含まれるセッション数
• ソース情報 (ExportSource)：データの出所を特定するための情報
  • UserName：Windowsユーザー名（トラブルシューティング用）
  • MachineName：PCのマシン名
  • DeviceId：匿名化されたデバイスID
  • Timezone：タイムゾーン情報（例：Tokyo Standard Time）
  • AppVersion：アプリのバージョン
• セッションデータ (Sessions)：
  • 指定期間内の全ての活動記録（1分単位の詳細データ）

9.1.2 フォルダ全体のエクスポート（バックアップ）

【v1.0.3〜】 Dataフォルダ全体をZIP形式でエクスポートします。セッションデータ、集中セッション、通知設定、通知履歴など、すべてのデータを含みます。

1. 設定画面の「データのエクスポート・インポート」セクションを開きます。
2. 「📦 フォルダ全体をエクスポート」ボタンをクリックします。
3. 保存先とファイル名を指定して保存します（デフォルト: ActCheckTracker_Data_Backup_YYYYMMDD_HHMMSS.zip）。

エクスポートされるZIPファイルの内容

ZIPファイルには、以下の内容が含まれます：

• export-info.json：エクスポート情報のメタデータ
  • exportDate：エクスポート実行日時（UTC）
  • appVersion：アプリのバージョン（例：1.0.3.0）
  • baseDirectory：エクスポート元のベースディレクトリパス
  • isTrialBuild：試用版ビルドかどうか
  • isTrialMode：試用版モードかどうか
  • isLicenseValid：ライセンスが有効かどうか
  • deviceId：匿名化されたデバイスID
  • userName：Windowsユーザー名
  • machineName：PCのマシン名
  • timezone：タイムゾーン情報
  • dataStructure：データ構造情報（セッション数、年フォルダなど）
• Dataフォルダの全内容：
  • sessions/：セッションファイル（*.json）
  • FocusSessions/：集中セッションファイル（*.json）
  • Settings/：通知設定ファイル（notification-settings.json、notification-set-selection.json、NotificationSets/*.json）
  • Notifications/：通知履歴ファイル（notification-records.json）
  • .device-id：デバイスIDファイル
  • {年}/：年フォルダ（例：2025/）
  • {年}/{月}/：月フォルダ（例：2025/12/）
  • {年}/{月}/{yyyy-MM-dd}.json：日次データファイル

9.2 データのインポート（復元）

手動でバックアップしたJSONファイルを読み込み、活動データを復元します。
インポート機能は単なるコピーではありません。データの重複を賢く処理し、壊れたデータを修復する高度なロジックが組み込まれています。

1. 設定画面の「データ管理」を開き、「ファイルを選択してインポート」ボタンをクリックします。
2. 対象のJSONファイルを選択すると、まず「インポートプレビュー」が表示されます。
   • ここで、ファイル内のセッション数、期間、既存データとの重複状況などを事前に確認できます。
3. インポートモードを選択して実行します。

   セッションデータのインポートでは、以下の5つのモードから選択できます：

   マージ (Merge) （推奨）	既存データを保持し、新規データのみ追加します。 同じセッションIDが既に存在する場合、既存データを優先してインポートデータをスキップします。 重複するTimeSlotは自動的に統合され、データの整合性が保たれます。
   上書き (Overwrite)	インポートするデータを優先します。 同じセッションIDが既に存在する場合、既存データをインポートデータで強制的に書き換えます。 バックアップからの完全復旧時などに使用します。
   スキップ (Skip)	既存データがある場合はスキップします。 同じセッションIDが既に存在する場合、そのセッションはインポートされません。 新規データのみを追加したい場合に使用します。
   新しいデータのみマージ (MergeIfNewer)	インポートするセッションの方が新しい場合のみ上書きします。 セッションの開始日時を比較し、インポートデータの方が新しい場合のみ既存データを上書きします。 古いデータで上書きされることを防ぎたい場合に使用します。
   データが異なる場合のみマージ (MergeIfDifferent)	既存データと異なる場合のみ上書きします。 セッションの内容（TimeSlot、統計情報など）を比較し、異なる場合のみ既存データを上書きします。 データの差分のみを反映したい場合に使用します。

9.2.2 フォルダ全体のインポート（復元）

【v1.0.3〜】 ZIPファイルからDataフォルダ全体をインポートします。インポート前にプレビューが表示され、インポートモードを選択できます。

1. 設定画面の「データのエクスポート・インポート」セクションを開きます。
2. 「📥 フォルダ全体をインポート」ボタンをクリックします。
3. ZIPファイルを選択すると、まず「インポートプレビュー」が表示されます。
   • エクスポート日時、アプリバージョン、セッション数などの情報が表示されます。
   • エクスポート時と現在でライセンス状態が異なる場合、警告が表示されます（データは正常にインポートできます）。
   • 集中セッションデータが含まれているが、現在が試用版の場合、警告が表示されます。
4. インポートモードを選択して実行します。

   フォルダ全体のインポートでは、以下の3つのモードから選択できます：

   

   図 9.1 フォルダ全体のインポート：インポートモード選択

   マージ (Merge) （推奨）	既存データを保持し、新規データのみ追加します。 セッションデータ：同じセッションIDが既に存在する場合、既存データを優先してインポートデータをスキップします。新規セッションのみ追加されます。 集中セッション：既存の集中セッションIDがある場合、スキップします。 設定ファイル：既存の設定ファイルがある場合、スキップします。 年フォルダ：既存の年フォルダがある場合、その中身をマージします。
   上書き (Overwrite)	インポートするデータを優先します。 セッションデータ：同じセッションIDが既に存在する場合、既存データをインポートデータで強制的に書き換えます。 集中セッション：既存の集中セッションIDがある場合、上書きします。 設定ファイル：既存の設定ファイルがある場合、上書きします。 年フォルダ：既存の年フォルダがある場合、その中身を上書きします。 注意：既存データが失われる可能性があるため、使用前にバックアップを推奨します。
   スキップ (Skip)	既存データがある場合はスキップします。 セッションデータ：同じセッションIDが既に存在する場合、そのセッションはインポートされません。 集中セッション：既存の集中セッションIDがある場合、スキップします。 設定ファイル：既存の設定ファイルがある場合、スキップします。 年フォルダ：既存の年フォルダがある場合、その年フォルダ全体をスキップします。 新規データのみを追加したい場合に使用します。

5. インポートが完了すると、結果が表示されます。
   • インポートされたセッション数、集中セッション数、年フォルダ数が表示されます。
   • エラーが発生した場合、エラー内容と件数が表示されます。

9.3 データの削除

不要になったデータを手動で削除できます。特定の期間だけを消すことも、全てリセットすることも可能です。

• 期間指定削除：
  1. 「データの削除」セクションで、削除したい期間の開始日と終了日を選択します。
  2. 「指定期間のデータを削除」ボタンをクリックします。
• 全データ削除：
  1. 「全データを削除」ボタンをクリックします。
  2. 確認ダイアログが表示されるので、十分に注意して実行してください。この操作は取り消せません。

9.4 データ保持期間の設定

古いデータを自動的に削除して、ディスク容量を節約することができます。0 以下を指定すると自動削除は無効になり、デフォルト値も 0 です（安全運用のための初期設定）。

1. 「データ保持期間」セクションのドロップダウンリストから、希望する期間を選択します（例：3ヶ月、6ヶ月、1年、無期限）。
2. 設定を変更すると、次回起動時または日が変わるタイミングで、期限切れの古いデータがバックグラウンドで自動的に削除されます。

9.5 データ自動修復システム

ActCheckTrackerは、大切な活動データを予期せぬトラブルから守るため、バックグラウンドで常にデータの健康状態を監視・維持しています。
ここでは、このシステムが「いつ」「何を」しているのかを少し詳しく解説します。

実行タイミング

以下の3つのタイミングで自動的にチェックと修復が行われます。

• アプリ起動時：
  • まず直近1ヶ月分のデータを高速チェックします。
  • もし異常（終了処理が正しく行われなかった形跡など）が見つかれば、過去の全データに対して詳細なスキャンを実行します。
• データインポート時：
  • 外部から取り込んだデータが正しい形式か、既存データと矛盾しないかをチェックし、必要に応じて整合性を取ります。
• アプリ終了時：
  • メモリ上の最新データを書き込む際、万が一書き込みエラーが発生してもデータが破損しないよう、安全な保存プロセスを経て終了します。

具体的な修復プロセス

システムは「セッションファイル（詳細）」と「日次ファイル（集計）」の2つを常に比較し、矛盾があれば正しい方へ合わせます。

1. 欠損ファイルの復元
   「日次ファイルはあるが、元となるセッションファイルが消えている」場合、日次ファイルからセッション情報を逆算して復元します。
   逆に「セッションファイルはあるが、日次ファイルがない」場合、セッションファイルを再集計して日次ファイルを作り直します。
2. 破損データへの対応
   破損して読み込めないファイル（例：JSONの読み取りエラー）が検出された場合、エラーとして記録し、可能な範囲で他の正常データ（日次データ）から復元を試みます。復元に成功した場合は、セッションファイルを再保存（上書き）します。
   ※現行実装では、破損ファイルを別フォルダへ「隔離（退避）」する処理は行っていません。

9.6 データの仕組み（ファイル構造）

「自分のデータがどこに、どのように保存されているか」を知ることは、安心感につながります。
ActCheckTrackerは、ユーザーのローカルフォルダ内に、以下の構造でデータを保存しています。

• Microsoft Store版（MSIX）の場合: C:\Users\[ユーザー名]\AppData\Local\Packages\[パッケージ名]_[ランダム文字列]\LocalState\ActCheckTracker\Data
• 通常のデスクトップアプリ版の場合: C:\Users\[ユーザー名]\AppData\Local\ActCheckTracker\Data

フォルダ構造の概要

3種類のファイルの役割

セッションファイル (session-*.json)	アプリを「起動してから終了するまで」の1回の作業単位の記録です。 1分ごとの詳細なデータ（キー入力数、マウス移動など）がそのまま記録されています。 役割：詳細な分析や、データのバックアップ元としての役割を果たします。
日次データファイル (yyyy-MM-dd.json)	その日の全てのセッションをまとめた「1日分のアルバム」です。 セッションファイルから自動的に生成・更新されます。 役割：統計画面で「今週」や「今月」のグラフを高速に表示するために使用されます。
集中セッションファイル (focus-session-*.json)	ユーザーが意図した区間（集中セッション）の記録です。 メインの常時記録とは独立して保存され、セッションごとに個別のJSONファイルとして保存されます。 役割：特定の作業やプロジェクトに集中していた時間を詳細に分析するために使用されます。

JSONファイルの構造（詳しい方向け）

データファイル（JSON）は、主に以下の3つのパートで構成されています。

• メタデータ (Metadata)
  データのバージョンや作成日時、デバイスID（匿名化済み）などの管理情報です。
• セッション情報 (Session / Sessions)
  いつからいつまで起動していたかという時間情報と、その間の活動データの本体です。
• 統計データ (Statistics)
  
  • Keyboard: 総打鍵数、キーの種類別回数（文字キー、エンターキー等）
  • Mouse: クリック数、移動距離、スクロール量
  • Activity: アプリが独自に算出した「活動スコア」や集中度の推移

10. プライバシーとセキュリティ

10.1 記録される情報

ActCheckTrackerが記録する情報は、アクティビティの「量」と「傾向」に厳密に限定されます。

• 統計データ：
  • キーボード：総打鍵数、キーカテゴリ別割合（文字キー、エンターキー等）、入力速度
  • マウス：クリック数、移動距離、スクロール量
  • 時間：アクティブ時間、アイドル時間、活動スコア
  • アプリケーション名（プロセス名）：操作を行ったアプリケーションのプロセス名（例：chrome、notepad、visualstudioなど）
• システム情報（通常時）：
  • デバイスID：PC固有情報をハッシュ化（不可逆変換）した匿名ID
  • アプリバージョン、タイムゾーン

【重要】バックアップ（エクスポート）データに含まれる情報

機能「データのエクスポート」で生成されるJSONファイルには、データの復元やトラブルシューティングを目的として、例外的に以下の情報が含まれます。

項目	内容	目的
UserName	Windowsのログインユーザー名	所有者の特定、権限エラー時の調査
MachineName	PCのコンピューター名	複数PC利用時のデータの区別

10.2 記録されない情報

ユーザーのプライバシーを侵害する可能性のある情報は、技術的に一切取得・記録していません。

• ❌ キー入力の内容：どの文字を打ったか（パスワード、メッセージ本文など）は記録されません。記録されるのは「文字キーを1回押した」という事実のみです。
• ❌ 画面の内容：スクリーンショット、ウィンドウタイトル、閲覧中のファイル名、ブラウザのURLなどは一切取得していません。
• ❌ クリップボード：コピー＆ペーストした内容は記録されません。
• ❌ カメラ・マイク：一切アクセスしません。

10.3 データの保存場所

全てのデータは、あなたのPC内の以下のローカルフォルダにのみ保存されます。

• Microsoft Store版（MSIX）の場合:
  C:\Users\[ユーザー名]\AppData\Local\Packages\[パッケージ名]_[ランダム文字列]\LocalState\ActCheckTracker\Data
• 通常のデスクトップアプリ版の場合:
  C:\Users\[ユーザー名]\AppData\Local\ActCheckTracker\Data

どちらの環境でも、ベースディレクトリ直下にActCheckTrackerフォルダを作成し、その中にData、Settings、Logsサブディレクトリを配置します。

ActCheckTrackerには、データを外部サーバーやクラウドに送信する機能は一切ありません。あなたのデータは、あなたのPCの中にだけ存在します。

10.4 データの保護

ActCheckTrackerは「オフライン・ファースト」の設計思想で作られています。
インターネット接続を必要とせず（ストアの更新確認を除く）、外部からのアクセスを受け付けるポートも開放しません。 これにより、ネットワーク経由での情報漏洩リスクを最小限に抑えています。

10.5 セキュリティソフトとの競合について

本アプリは、キーボードとマウスの操作を監視するために低レベルフック（Windows API）を使用しているため、一部のセキュリティソフト（アンチウイルス、Windows Defenderなど）が警告を表示する場合があります。

セキュリティソフトが警告を表示した場合、以下の対処方法をご確認ください：

• Windows Defenderの場合：
  • 「Windows セキュリティ」を開き、「ウイルスと脅威の防止」を選択します。
  • 「ウイルスと脅威の防止の設定」の「設定の管理」をクリックします。
  • 「除外」セクションで「除外の追加または削除」を選択し、ActCheckTrackerのインストールフォルダまたは実行ファイルを除外リストに追加します。
• その他のセキュリティソフトの場合：
  • 各セキュリティソフトの設定画面で、ActCheckTrackerを「信頼できるアプリケーション」または「除外リスト」に追加してください。
  • 具体的な手順は、各セキュリティソフトのマニュアルまたはサポートページをご確認ください。

10.6 システム要件と注意事項

• 管理者権限：本アプリは、通常のユーザー権限で動作します。管理者権限は必要ありません（ただし、一部の環境では初回起動時にUAC（ユーザーアカウント制御）の確認が表示される場合があります）。
• システムへの影響：本アプリは、低レベルフックを使用するため、システムのパフォーマンスにわずかな影響を与える可能性があります。通常の使用環境では、影響はほとんど感じられません。
• 他のアプリケーションとの競合：他のキーボード・マウス監視アプリケーションや、同様の機能を持つアプリケーションと同時に使用すると、競合が発生する可能性があります。
• ゲームやフルスクリーンアプリケーション：一部のゲームやフルスクリーンアプリケーションでは、低レベルフックが正常に動作しない場合があります。
• 会社・組織のPC：企業向けセキュリティ（EDR）や管理ポリシーにより、入力監視（低レベルフック）やWebView2が制限され、警告・起動失敗・記録不可になる場合があります。その場合はPC管理者へ許可を依頼してください。
• 仮想マシン環境：仮想マシン（VMware、VirtualBoxなど）内での動作は、ホストOSの設定によっては制限される場合があります。

11. トラブルシューティング

11.1 データが記録されない・表示されない

• アプリが起動しているか確認する：タスクバーにアプリが表示されているか確認してください。誤って閉じてしまった場合は、スタートメニューから再度起動してください。
• 画面の更新について：ダッシュボードは通常、自動的にリアルタイム更新されます。もし数値が止まったままの場合は、一度左側メニューから「統計」など別の画面に切り替えてから、再度「リアルタイム」に戻ってみてください。
• アプリを再起動する：一時的な不具合の場合、アプリを再起動すると解消することがあります。起動時には自動的にデータ修復プロセスも実行されます。

11.2 エクスポート/インポートができない

• アクセス権限の確認：保存先や読み込み元のフォルダに対して、書き込み/読み込み権限があるか確認してください（デスクトップやドキュメントフォルダを使用することをお勧めします）。
• ファイル形式の確認：インポートしようとしているファイルが、ActCheckTrackerでエクスポートされた正しいJSONファイルか確認してください。手動で編集されたファイルは読み込めない場合があります。

11.3 セキュリティソフトが警告を表示する

本アプリは、キーボードとマウスの操作を監視するために低レベルフックを使用しているため、セキュリティソフトが警告を表示する場合があります。

• 警告の意味：セキュリティソフトは、キーボード入力を監視するアプリケーションを「キーロガー」や「スパイウェア」として検出する可能性があります。これは誤検知です。本アプリは入力内容を記録せず、統計情報のみを記録します。
• 対処方法：
  • Windows Defenderの場合：「Windows セキュリティ」→「ウイルスと脅威の防止」→「設定の管理」→「除外」で、ActCheckTrackerを除外リストに追加してください。
  • その他のセキュリティソフトの場合：各ソフトの設定画面で、ActCheckTrackerを「信頼できるアプリケーション」または「除外リスト」に追加してください。
• 注意：Microsoft Storeから入手したアプリケーションは、Microsoftによる審査を通過した安全なアプリケーションです。信頼できるソフトウェアであることを確認した上で、除外設定を行ってください。

11.4 アプリが正常に動作しない

• 他の監視アプリとの競合：他のキーボード・マウス監視アプリケーションと同時に使用すると、競合が発生する可能性があります。他の監視アプリを終了してから、本アプリを再起動してください。
• ゲームやフルスクリーンアプリでの動作：一部のゲームやフルスクリーンアプリケーションでは、低レベルフックが正常に動作しない場合があります。これは、これらのアプリケーションが独自の入力処理を行っているためです。
• 仮想マシン環境：仮想マシン内での動作は、ホストOSの設定によっては制限される場合があります。

12. よくある質問 (FAQ)

12.4 ライセンス・試用版について

13. 品質について

13.1 テスト実施の概要

ActCheckTrackerは、高品質なソフトウェアを提供するため、包括的なテストを実施しています。 アプリケーションの信頼性と安定性を向上させるため、様々な種類のテストを継続的に実施しています。

現在、47個のテストファイルに630以上のテストケースを実装し、 自動化されたユニットテスト、統合テスト、UIテストに加えて、実際の使用環境での動作確認も行っています。 これにより、理論的な動作だけでなく、実際のユーザー体験に近い環境での検証を実施しています。

テストは、xUnitテストフレームワークを使用して実装され、継続的に実行・更新されています。 新機能の追加や修正のたびに、関連するテストも追加・更新され、品質の維持に努めています。

13.2 実施したテストの種類

ユニットテスト（Unit Tests）

各機能の最小単位（クラス、メソッド）を個別にテストしています。以下の領域をカバーしています：

• Core層（12個のテストファイル）：
  • エンティティ（Session、TimeSlot、InputEvent、DailySummary、ClickBreakdown、KeyCategoryCountsなど）
  • 値オブジェクト（ActivityScore）
  • ドメインサービス（ActivityScoreCalculator、StatisticsAggregator、AggregationService）
  • ヘルパークラス（DateTimeHelper）
• Application層（15個のテストファイル）：
  • ユースケース（9個：StartMonitoring、StopMonitoring、GetStatistics、GetVisualizationData、DeleteAllData、DeleteDataByPeriod、GetDeletionPreview、ExportData、ImportData）
  • サービス（2個：MonitoringService、DataCollectionService）
  • DTO（2個：DailySummaryDto、SessionDto）
  • マッパー（1個：EntityToDtoMapper）
  • イベント（3個：InputEventOccurred、SessionEnded、StatisticsUpdated）
• Infrastructure層（6個のテストファイル）：
  • データリポジトリ（JsonDataRepository）
  • シリアライザー（JsonDataSerializer）
  • データストア（FileSystemDataStore、DeviceIdManager）
  • 統計計算（StatisticsCalculator）
  • 可視化データプロバイダー（VisualizationDataProvider）
• Presentation層（4個のテストファイル）：
  • ViewModel（ViewModelBase）
  • サービス（NavigationService、SettingsService、ThemeManager）

統合テスト（Integration Tests）

複数のコンポーネントが連携して動作することを確認するテストを実施しています。 実際のアプリケーションを起動し、エンドツーエンドの動作を検証しています。

• 1個のテストファイル：AppIntegrationTests
• アプリケーションの起動と基本動作の確認
• 監視機能の自動開始の確認

UIテスト（UI Tests）

FlaUIを使用した自動UIテストを実施しています。7個のテストファイルで以下の画面と機能をテストしています：

• MainWindowUiTests：メインウィンドウの表示と基本操作
• RealTimeDashboardUiTests：リアルタイムダッシュボードの表示
• StatisticsPageUiTests：統計画面の表示と操作
• NavigationUiTests：ナビゲーション機能
• MonitoringControlUiTests：監視制御機能
• StatisticsContextMenuUiTests：コンテキストメニューの動作

すべてのUIテストは、同じアプリケーションインスタンスを使用して効率的に実行されます。

手動テスト（Manual Testing）

実際の使用環境で手動による動作確認も実施しています。 様々な使用パターンやエッジケースを想定し、実際にアプリケーションを操作して動作を確認しています。 多様なシナリオを想定した動作確認により、実際のユーザー体験に近い環境での検証を行っています。

13.3 テスト結果

現在のテスト実施状況は以下の通りです（測定日時：2025年12月18日）：

• テストファイル数：47個以上
• 総テストケース数：637個（実行：633個、スキップ：4個）
• テスト成功率：100%（633個すべてのテストが成功、失敗：0）
• コードカバレッジ（測定日時：2025年12月18日）：
  • 全体のカバレッジ：
    • ラインカバレッジ：13.9%（6453 of 46433）
    • ブランチカバレッジ：12.1%（1434 of 11882）
  • 各層のカバレッジ：
    • Core層：95.8%
    • Application層：55.9%
    • Infrastructure層：38.2%
    • Presentation層：2.4%
  • 主要な機能領域（ビジネスロジック、データ処理、統計計算）で重点的にテストを実施
• テスト対象領域の内訳：
  • Core層：エンティティと値オブジェクトのバリデーション、ドメインロジックの正確性
  • Application層：ユースケースの動作、サービスの機能、データ変換の正確性
  • Infrastructure層：データの永続化と復元、シリアライズ/デシリアライズ、統計計算
  • Presentation層：ViewModelの動作、サービスの機能、UIコンポーネントの表示と操作

テストは継続的に実施され、新機能の追加や修正のたびに、関連するテストも更新・追加されています。 テスト実行は自動化されており、コード変更のたびに自動的にテストが実行され、品質の維持に努めています。

13.4 品質について

14. ライセンスと謝辞

ActCheckTrackerは、多くの優れたオープンソースソフトウェアによって支えられています。
これらのプロジェクトの開発者およびコミュニティに深く感謝いたします。

主な使用ライブラリ・ソフトウェア

本ソフトウェアは、以下のオープンソースソフトウェアを含んでいるか、または利用しています。

Core Framework & Runtime

• .NET 10.0 (SDK/Runtime) - https://dotnet.microsoft.com/ (MIT License)
• Windows Presentation Foundation (WPF) - https://github.com/dotnet/wpf (MIT License)

UI & Utilities

• CommunityToolkit.Mvvm (v8.4.0) - https://github.com/CommunityToolkit/dotnet (MIT License)
  MVVMパターン実装のための強力なツールキットです。
• Microsoft.Web.WebView2 (v1.0.2849.39) - https://github.com/MicrosoftEdge/WebView2Feedback (MIT License)
  統計画面の表示に使用している最新のWebブラウザコンポーネントです。
• System.Reactive (v6.1.0) - https://github.com/dotnet/reactive (MIT License)
  イベント処理と非同期データフローを扱うためのライブラリです。
• Microsoft.Extensions.DependencyInjection (v10.0.0) - https://github.com/dotnet/runtime (MIT License)
  アプリケーションの依存関係を管理するためのコンテナです。
• Microsoft.Extensions.DependencyInjection.Abstractions (v10.0.0) - https://github.com/dotnet/runtime (MIT License)
  依存性注入の抽象化インターフェース（推移的依存関係）です。

Visualization

• Chart.js (v4.5.1) - https://www.chartjs.org/ (MIT License)
  統計データの視覚化に使用している、シンプルで柔軟なJavaScriptチャートライブラリです。
• chartjs-adapter-date-fns (v3.0.0) - https://github.com/chartjs/chartjs-adapter-date-fns (MIT License)
  Chart.jsの時間軸チャート表示に使用しているアダプターです（アプリに同梱）。
• date-fns - https://date-fns.org/ (MIT License)
  日付処理ユーティリティです（アダプターのbundle内に含まれます）。

同梱コンポーネント

• Microsoft Edge WebView2 Fixed Version Runtime (v143.0.3650.80, x64) - https://developer.microsoft.com/microsoft-edge/webview2/ (Microsoft Software License Terms)
  統計画面などのWeb表示を安定して動作させるため、固定版ランタイムを同梱しています。

開発・テスト用ツール（本番ビルドには含まれません）

以下のライブラリは開発・テスト目的でのみ使用されており、本番アプリケーションのビルドには含まれません。

• xunit (v2.9.3) - https://github.com/xunit/xunit (Apache License 2.0)
  .NET用単体テストフレームワークです。
• Moq (v4.20.70) - https://github.com/moq/moq (BSD-3-Clause License)
  .NET用モックフレームワークです。
• FlaUI (v5.0.0) - https://github.com/FlaUI/FlaUI (MIT License)
  UI自動化テストフレームワークです。
• coverlet.collector (v6.0.4) - https://github.com/coverlet-coverage/coverlet (MIT License)
  コードカバレッジ収集ツールです。

ライセンス情報について

本アプリケーションはスタンドアロン（Self-Contained）配布のため、直接参照と推移的依存関係のすべてが最終的な出力に含まれます。

完全なライセンス情報（ライセンス全文を含む）については、アプリケーションの配布物に含まれる libraries_and_licenses.txt ファイルを参照してください。

各ライブラリのライセンス詳細については、上記のリンク先をご参照ください。本アプリケーションで使用しているすべてのライブラリは、商用利用が可能な寛容なオープンソースライセンス（MIT、Apache 2.0、BSD-3-Clause）の下で提供されています。