Linear migration metadata¶

• Linear issue: TAK-243
• Linear URL: https://linear.app/takayuki-komoda/issue/TAK-243/core-プロジェクト配下にアプリケーションログを出力する
• Linear status: Backlog
• Linear team: Takayuki Komoda
• Linear project: EPAA Core
• Linear assignee:
• Linear labels:
• Linear created: 2026-08-29T09:27:40.651Z
• Linear updated: 2026-08-29T09:27:40.651Z
• Linear archived:

Original description¶

背景¶

TAK-241 のサンプルアプリインストールでは、利用者向けエラー表示は分かりやすい粒度に抑えつつ、サポート時には詳細な技術情報を確認できる必要がある。
現在のCoreにはサンプルインストール失敗時に提供してもらう前提のアプリケーションログ機能が不足しているため、Core共通のログ出力機能として整備する。

要件¶

• Coreの各プロジェクトディレクトリ配下に logs ディレクトリを作成できる。
• Core GUIの主要処理で、利用者向けメッセージとは別に詳細なアプリケーションログをテキスト出力できる。
• サンプルカタログ取得、テンプレートZIP取得、manifest/checksum検証、インストールプレビュー、下書き反映、validate-metadata失敗など、TAK-241で必要なログ出力に対応できる。
• ログ行には検索しやすい識別子として ERROR、WARNING、INFO などのレベルを含める。
• 失敗・成功に関わらず同じログ出力経路を使う。
• ユーザー向けエラー画面では、詳細ログを確認またはサポートへ提供するよう促せる。
• ログには秘密値、APIキー、パスワード、接続文字列などを出力しない。
• 初期実装では自動削除や容量制限付きログローテーションは必須にしない。容量が増えた場合はユーザーが logs 配下を削除できる前提とする。
• ただし単一ファイル肥大化を避けるため、日付別または実行単位のログファイル名を設計で検討する。

受け入れ条件¶

• プロジェクトディレクトリ配下に logs ディレクトリが作成される。
• Core GUIから実行した処理の詳細がテキストログとして残る。
• ログに ERROR、WARNING、INFO などの識別子が含まれる。
• サンプルインストール関連エラーで、画面には概要、ログには詳細が出る設計に接続できる。
• ログに秘密情報が出力されない。
• ログ削除はユーザーがファイル削除で対応できる。

非対象¶

• 生成アプリのDB監査ログ実装。
• サーバ側集中ログ基盤。
• 初期実装での自動ログローテーション、圧縮、世代管理。
• ログビューアの高度検索機能。

影響範囲メモ¶

• FE: エラー表示からログ確認/コピーを促す導線が必要になる可能性あり。
• BE/Core GUI service: ログ出力サービス、ログディレクトリ作成、ログ書き込み、秘密値マスク。
• DB: なし。
• Docs: Core GUI操作・サポート時ログ提供手順の記載を検討。
• Test: ログ出力、レベル識別子、秘密値マスク、プロジェクト別出力先の確認。

注意事項¶

• TAK-241の初期スコープでサンプルインストールを実装する前に、ログ出力先とログ記録形式を決める。
• プロジェクトパスはユーザー指定のため、ログは選択中プロジェクトディレクトリ配下に置く。
• logs は利用者環境の運用ログであり、Git管理対象にしない方針を検討する。