Skip to content

CLAUDE.md

Latest commit

 

History

History
137 lines (103 loc) · 5.57 KB

CLAUDE.md

File metadata and controls

137 lines (103 loc) · 5.57 KB

CLAUDE.md

このファイルは、このリポジトリでコードを扱う際のClaude Code (claude.ai/code)へのガイダンスを提供します。

プロジェクト概要

RST (Rymansat Satellite Tracker) は、衛星追跡およびアンテナ制御のためのElectronベースのデスクトップアプリケーションです。 フロントエンド（レンダラープロセス）にはVue 3 + TypeScript + Vuetify、バックエンド（メインプロセス）にはNode.js + TypeScriptを使用して構築されています。

開発コマンド

開発

# 開発モード起動（TypeScriptビルド + Vite開発サーバー実行 + Electron起動）
npm run app:dev

# Vite開発サーバーのみ実行
npm run vite:dev

# TypeScriptコンパイルのみ監視
npm run watch

テスト

# 全てのJestユニットテストをカバレッジ付きで実行
npm run test

# 特定のテストファイルを実行
npm run test -- FileName_part

# ファイル内の特定のテストを実行
npm run test -- FileName_part -t "test name"

# PlaywrightでE2Eテスト実行
npm run test:e2e

ビルド

# プレビュー用ビルド（Viteビルド + TypeScriptコンパイル + Electron実行）
npm run app:preview

# 全プラットフォーム向けプロダクションアプリビルド
npm run app:build

# プラットフォーム固有ビルド
npm run app:build-win
npm run app:build-mac
npm run app:build-linux

# フロントエンドのみビルド
npm run vite:build

# TypeScriptのみコンパイル
npm run ts

コードフォーマット

# Prettierで全コードをフォーマット
npm run format

アーキテクチャ

プロセス構造

  • メインプロセス (src/main/): システム相互作用、ファイルI/O、ハードウェア通信を処理するElectronメインプロセス
  • レンダラープロセス (src/renderer/): UIのためのVue.jsフロントエンド
  • 共通 (src/common/): メインプロセスとレンダラープロセス間で共有されるコード

主要ディレクトリ

  • src/main/service/: コアビジネスロジックサービス（衛星計算、ハードウェア制御、データ管理）
  • src/renderer/service/: UIロジックとデータ表示のためのフロントエンドサービス
  • src/renderer/components/: atoms/molecules/organismsとして組織化されたVueコンポーネント
  • src/common/model/: プロセス間で共有されるTypeScriptモデル
  • src/__tests__/: ソース構造をミラーリングしたJestユニットテスト

メインプロセスサービス

  • StartupService.ts: アプリケーション初期化とTLEデータローディング
  • ActiveSatService.ts: アクティブな衛星追跡と計算
  • RotatorService.ts / TransceiverService.ts: アンテナローテーターと無線機のハードウェア制御
  • DefaultSatelliteService.ts: 衛星データ管理とTLE更新

レンダラープロセスサービス

  • ActiveSatServiceHub.ts: UI内での衛星追跡を調整
  • FrequencyTrackService.ts: ドップラー周波数補償を管理
  • AntennaAutoTrackingService.ts: 自動アンテナ追跡を処理

ハードウェア統合

アプリケーションが制御するもの：

  • アンテナローテーター: アンテナ位置決めのためのシリアル通信
  • 無線機: 周波数制御と衛星モード管理
  • 位置サービス: 地上局位置決めのためのGPS/ジオロケーション

TypeScript設定

  • パスエイリアスを使用: @/* は ./src/* にマップ
  • インポートエイリアス置換: tscpathsが本番ビルド用にエイリアスを相対パスに変換
  • CommonJS（メインプロセス）とESモジュール（レンダラープロセス）の両方に対応

テスト

ユニットテスト（Jest）

  • src/__tests__/にソースをミラーリングした構造で配置
  • TypeScriptサポートのためにts-jestを使用
  • カバレッジレポートを自動生成
  • moduleNameMapperでパスエイリアスを設定

E2Eテスト（Playwright）

  • src/__tests__/playwright/に配置
  • アプリケーション全体のワークフローをテスト

開発ツール

Nodeバージョン管理

  • Node.jsバージョン管理にVoltaを使用（package.jsonで設定）
  • 対象Node.jsバージョン: 22.18.0

VSCodeデバッグ

  • メインプロセス: ビルド後に"Electron: Main"設定を使用
  • レンダラープロセス: app:dev実行中に"Electron: Renderer"設定を使用
  • Jestテスト: 個別テストデバッグのためのJest Runner拡張機能をインストール

ビルドプロセス

  1. vite:build - Vueフロントエンドをビルド
  2. tsc - メインプロセス用TypeScriptをコンパイル
  3. app:import-replace - tscpathsを使用してパスエイリアスを相対インポートに変換
  4. electron-builder - アプリケーションをパッケージ

重要な注意事項

  • ログファイルはユーザーディレクトリに保存（例: Windows の %APPDATA%/rst/logs/rst.log）
  • TLE（Two-Line Element）データは衛星追跡のために外部ソースから取得
  • アプリケーションはハードウェア制御のためのシリアルポート通信を処理
  • UIコンポーネントにVuetify、Material Designアイコンを使用
  • I18nサービスを通じた多言語サポート