KyoshinEewViewerIngen: Instructions file for Claude Code

CLAUDE.md

プロジェクト概要

KyoshinEewViewer for ingen — 日本の防災情報アプリケーション。

• C# .NET 10.0 + Avalonia UI によるクロスプラットフォーム対応
• 強震モニタ・気象庁(JMA)の地震情報を監視し、緊急地震速報や地震情報をリアルタイム表示する

言語ポリシー

防災アプリケーションという性質上、ユーザーに届く情報はすべて日本語で書く。

• UIテキスト・ダイアログ・エラーメッセージ: 日本語
• ログメッセージ: 日本語
• コード内コメント: 日本語
• 用語: 地震・津波・気象用語は気象庁(JMA)の標準に従う
• 技術ドキュメントやコード構造の説明は英語でもよいが、実装内容の説明は日本語を優先する

ビルド

# メインプロジェクト
dotnet build src/KyoshinEewViewer/KyoshinEewViewer.csproj

# デスクトップ版
dotnet build src/KyoshinEewViewer.Desktop/KyoshinEewViewer.Desktop.csproj

ソースジェネレータが絡む変更 ([ObservableProperty] の付け外し、DI登録、CSV辞書など) を検証するときは -t:Rebuild を付ける。 増分ビルドは古い生成物を再利用してエラーを見逃すことがあり、実際にはコンパイルできない状態で「成功」と報告される。

dotnet build KyoshinEewViewer.sln -t:Rebuild

アーキテクチャ

Series アーキテクチャ

監視機能ごとにモジュール分割されたプラグイン型の構成。

Series	役割
KyoshinMonitor	強震モニタの監視・緊急地震速報
Earthquake	JMA XML 地震情報の処理
Tsunami	津波警報
Typhoon	台風追跡
Lightning	落雷検知
Radar	気象レーダー
Qzss	衛星災害危機管理通報(災危通報)

各 Series の構成 (src/KyoshinEewViewer/Series/[SeriesName]/): View (AXAML/ViewModel)、Layer (地図描画)、Services (データ処理)、Models、SettingPages (設定UI)、Templates (通知テンプレート)、Workflow。

プロジェクト構成

• KyoshinEewViewer: メインアプリ (Series、UI、サービス)
• KyoshinEewViewer.Desktop: デスクトップ版エントリポイント
• KyoshinEewViewer.Core: 共有モデル・テーマ・ユーティリティ
• KyoshinEewViewer.Map: 地図描画・投影
• KyoshinEewViewer.CustomControl: カスタムUIコントロール
• KyoshinEewViewer.JmaXmlParser: JMA XML パーサー
• KyoshinEewViewer.DCReportParser: QZSS 災危通報パーサー
• KyoshinEewViewer.CsvSourceGenerator: CSV辞書のコード生成
• common.props: 共有 MSBuild プロパティ (.NET 10.0、Nullable など)

技術スタック

Avalonia UI (AXAML / MVVM / コンパイル済みバインディング)、CommunityToolkit.Mvvm、R3、System.Reactive、Microsoft.Extensions.DependencyInjection / Logging、KyoshinMonitorLib、FluentAvalonia、Scriban (テンプレートエンジン)、ManagedBass (音声)。

ReactiveUI / Splat / DynamicData は使わない (移行済み)。対応は以下のとおり。

旧 (ReactiveUI / Splat)	現行
ReactiveObject / RaiseAndSetIfChanged	ObservableObject / [ObservableProperty] (CommunityToolkit.Mvvm)
WhenAnyValue(x => x.Foo)	ObservePropertyChanged(x => x.Foo) (R3)
WhenAnyValue(x => x.A.B) (入れ子)	ObservePropertyChanged(x => x.A, x => x.B)
WhenAnyValue(a, b, (x, y) => ...) (合成)	Observable.CombineLatest(...)
ToProperty / ObservableAsPropertyHelper	通常プロパティ + Subscribe で代入
MessageBus.Current.Listen<T>() / SendMessage	StrongReferenceMessenger.Default.Register<T> / Send
ReactiveCommand.Create / CreateFromTask	RelayCommand / AsyncRelayCommand
Locator.Current / SplatRegistrations	ServiceLocator.Current / IServiceCollection
ILogManager / LogHost	ILogger<T> / AppLog