Skip to content
john911120Public

About

ErrorWikiは、開発中に発生したエラー、ログ、調査根拠、確認手順、解決結果を整理し、Wikiとして蓄積するSpring Bootアプリケーションです。 生成AIの回答をそのまま確定情報として保存せず、利用者が確認・修正した内容を記録する運用を前提にしています。

Resources

Stars

1 star

Watchers

0 watching

Forks

Latest commit

 

History

1 Commit

Folders and files

Repository files navigation

ErrorWiki 1.5

ErrorWikiは、開発中に発生したエラー、ログ、調査根拠、確認手順、解決結果を整理し、Wikiとして蓄積するSpring Bootアプリケーションです。 生成AIの回答をそのまま確定情報として保存せず、利用者が確認・修正した内容を記録する運用を前提にしています。

1.5の位置付け

1.5は、3.5系の最終OSSラインからSpring Boot 4.1系へ基盤を移行し、Spring AIも2.0系へ更新した保守・セキュリティ強化版です。 既存の分析、Wiki、ログ、PDF、添付、AIルーティング機能を維持しながら、今後の保守を続けやすい基準線へ更新しています。

  • Spring Boot 3.5.16 → 4.1.1
  • Spring Framework 6.2.x → Boot 4.1.1が管理する7.0.9+ライン
  • Spring AI 1.1.7 → BOM 2.0.1
  • Spring Data JPAをBoot 4.1.1管理ラインへ更新
  • Web starterをBoot 4のspring-boot-starter-webmvcへ移行
  • Jackson 2 API利用箇所をJackson 3 (tools.jackson.*)へ移行
  • 添付ファイルのContent-Disposition用ファイル名をアプリケーション側でも正規化し、制御文字・パス区切り文字をヘッダーへ流さない
  • 製品バージョン表示を1.5へ統一
  • Windowsパッケージングの処理ロジック、ランチャー、アイコンは変更しない

Spring AI 2.0.1でもChatClientとentity(Class)の利用方法は維持されているため、既存のDraft生成プロンプトと分析方針は変更していません。入力原文だけを分類し、AI出力を保存前に人が確認する既存方針を継続します。

主な機能

  • エラー内容の生成AI分析とローカル分析へのフォールバック
  • 自由記述から分析フォーム用Draftへの安全な整理
  • Claude、OpenAI、Gemini、Ollamaの複数モデルプロファイル管理
  • 機能別AIルーティング、自動フォールバック、利用量・推定コスト表示
  • Wiki保存前の確認・修正、類似記事確認、変更履歴
  • 調査チェックリスト、解決確認、再オープン
  • ログファイル分析、障害タイムライン、PDF出力
  • 根拠資料の添付、プレビュー、削除
  • データZIPバックアップ
  • ライト/ダークテーマとキャラクター表示

主な画面

URL 用途
/ エラー分析
/log-analysis ログ分析
/wiki Wiki検索・一覧
/dashboard Wikiダッシュボード
/wiki/history 変更履歴
/usage AI運用ダッシュボード
/ai-settings AIモデル管理
/maintenance バックアップ
/settings キャラクター設定

技術構成

  • Java 21
  • Spring Boot 4.1.1
  • Spring AI BOM 2.0.1
  • Spring Framework 7.0.9+(Spring Boot管理)
  • Spring Data JPA(Spring Boot管理)
  • Jackson 3
  • Thymeleaf
  • H2 Database
  • OpenHTMLtoPDF
  • Lombok
  • Maven

起動

開発環境ではMavenを利用します。

mvn spring-boot:run

既定ポートは8181です。データ保存先の既定値は${user.home}/.errorwikiです。

Windowsインストーラーの作成はプロジェクト直下のpackage-windows.batを使用します。パッケージング処理のロジックは1.4.1から変更していません。パッケージング固有の手順はpackaging/windows/README_JPACKAGE.mdを参照してください。

文書

詳細資料はdoc/INDEX.mdから確認できます。1.5への基盤移行内容はdoc/MIGRATION_1_5.mdにまとめています。

運用上の注意

  • AI出力は提案として扱い、保存前に必ず人が確認してください。
  • APIキー、パスワード、トークン、個人情報をログや添付資料へ含めないでください。
  • DB、設定、添付ファイルを更新前にバックアップしてください。
  • 1.4.0形式で保存されたAI設定との互換性維持のため、暗号化形式EWAI140と鍵導出用バージョン1.4.0は1.5でも変更していません。これは製品バージョンとは別の保存形式バージョンです。

About

ErrorWikiは、開発中に発生したエラー、ログ、調査根拠、確認手順、解決結果を整理し、Wikiとして蓄積するSpring Bootアプリケーションです。 生成AIの回答をそのまま確定情報として保存せず、利用者が確認・修正した内容を記録する運用を前提にしています。

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages