Maintenance & Operations Guide

このドキュメントは、放課後リンク プロジェクトの継続的なメンテナンスと運用のためのナレッジベースです。

1. ディレクトリ管理と整理

ルートディレクトリを清潔に保つため、以下のルールを推奨します。

定期的なクリーンアップ

• ビルドログ: 開発中に生成される build_warnings_*.log や build_log.txt は、問題が解決次第削除してください。
• Release ディレクトリ: release/ には常に最新のデモ用バイナリを配置します。古いバージョンが必要な場合は、Gitのタグ機能を利用するか、外部ストレージに退避させてください。
• Build ディレクトリ: build/ フォルダは中間生成物を含みます。対象を確認したうえで、各ビルドスクリプトの -Clean または PowerShell の Remove-Item -LiteralPath で対象アプリの出力だけを整理してください。存在しない scripts/clean-build.ps1 は使用しません。

2. 既知の不具合と対処 (Troubleshooting)

Kiosk アプリの「操作不能」問題

• 現象: 起動直後にタッチやスクロールが反応しない。一度スリープさせると治る。
• 原因: UIスレッドの初期化タイミングにより、メインWindowにフォーカスが当たっていない、または透明なオーバーレイがヒットテストを遮断している。
• 対処:
  • MainView.axaml.cs の InitializeAppSafe メソッド内にある「遅延フォーカス処理（Task.Delay(500)）」が正しく機能しているか確認してください。
  • 新しいオーバーレイを追加する場合、必ず IsHitTestVisible="{Binding $self.IsVisible}" を設定し、非表示時にタッチを邪魔しないようにしてください。

Guardian PWA のテーマ不整合

• 現象: 「システム設定」を選択しても、OSのダークモードと同期しない。
• 原因: CSSのメディアクエリとJSのテーマ属性（data-theme）が競合している。
• 対処: システム設定時は document.documentElement から data-theme 属性を完全に削除してください。これにより、index.css 内の @media (prefers-color-scheme: dark) が優先されます。

3. ビルドとリリース

• 一括ビルド: ./scripts/build-demo-artifacts.ps1 を使用してください。
• 個別ビルド: 各アプリ（app/Facility, app/Guardian 等）の npm run build を使用しますが、出力先が ../../build/[app-name] になるように設定されていることを確認してください。

4. セキュリティ

• PII（個人情報）を含むデータは必ずローカルで暗号化してください。
• 暗号化ロジックを変更する場合は、docs-dev/security-guideline.md を参照してください。