log-design

原文涵盖的主题

• Log Design Check - ログ設計チェック
• 実行フロー
• Step 1: 現状分析
• Step 2: 一般的ログ基準チェック
• ログレベル基準
• 構造化ログ実装パターン
• 機密情報マスキングパターン
• ログインジェクション防止

導入先の補足ファイル documents/development/project/log-design.md があれば、その段で読む。補足ファイルは製品への当てはめ（コマンド・パス・ポート等）だけを持ち、本スキルの規則を緩めない。食い違えば本スキルが優先する。 プロジェクトのログ設計が一般的な基準と法的要件を満たしているか体系的にチェックし、不足があれば実装パターンを提示する。 参照: セキュリティ関連のログルールは documents/development/coding-rules/common-rules.md Section 4 も併せて確認すること。 -- 以下を確認する： ログライブラリ・設定ファイル（logback-spring.xml、pino設定等） 既存のログ出力箇所 取り扱うデータの種類（取引データ、個人情報、メール送信等） -- | レベル | 用途 | 例 | |--------|------|-----| | ERROR | システム異常、復旧不可能なエラー | DB接続失敗、外部API障害、未処理例外 | | WARN | 想定内だが注意が必要な事象 | リトライ発生、閾値超過、非推奨API使用 | | INFO | ビジネス上重要なイベント | ユーザーログイン/ログアウト、決済完了、重要な状態遷移 | | DEBUG | 開発・調査用の詳細情報 | リクエスト/レスポンス詳細、SQL実行詳細（本番では無効化） | Spring Boot + Logback (JSON形式): Next.js (API Routes / Server Actions): ログに出力してはいけない情報: パスワード、トークン、APIキー クレジットカード番号（PCI DSS） マイナンバー（個人番号） マスキング実装例 (Java): ユーザー入力をログ出力する際、改行コード（CR/LF）を含む文字列がそのまま出力されると、偽のログ行が挿入される（ログインジェクション/ログフォージング）。監査ログの信頼性を損なうため、必ずサニタイズする。 フロントエンド (Server-side only): | カテゴリ | ログ対象 | レベル | |---------|---------|--------| | 認証 | ログイン成功/失敗、ログアウト、トークンリフレッシュ | INFO | | 認可 | 権限不足によるアクセス拒否 | WARN | | データ変更 | 重要データのCRUD操作（誰が・いつ・何を） | INFO | | 決済 | 決済開始・完了・失敗 | INFO/ERROR | | 外部連携 | 外部API呼び出し（リクエスト/レスポンス概要） | INFO | | エラー | 未処理例外、システム障害 | ERROR | -- 該当

这里只展示节选，请以完整原文和当前要求为准。