Skip to content

README_JA.md

Latest commit

 

History

History
98 lines (70 loc) · 3.5 KB

README_JA.md

File metadata and controls

98 lines (70 loc) · 3.5 KB
Raw

🚗 燃費・メンテナンス・トラッカー (Fuel & Maintenance Tracker)

中文 | 日本語 | English

車両の管理、燃費の追跡、およびメンテナンス時期の予測を行うためのモダンなWebアプリケーションです。

📸 アプリのスクリーンショット

📱 ホーム画面に追加

このアプリはスマホにインストールして、ネイティブアプリのように使用できます：

  • Android (Chrome): メニューボタン (⋮) をタップ -> **「ホーム画面に追加」**を選択。
  • iOS (Safari): 共有ボタン (四角から矢印) をタップ -> スクロールして**「ホーム画面に追加」**を選択。

✨ 主な機能

  • 複数車両管理: 自動車、バイク、三輪車など、複数の車両を登録・管理できます。
  • 給油記録: 給油の詳細（走行距離、リッター数、価格、満タンかどうか）を簡単に記録できます。
  • スマート統計: 平均燃費 (L/100km)、kmあたりのコスト、総走行距離を自動計算します。
  • メンテナンス予測: あなたの運転習慣に基づいて、次回のサービス日を予測します。
  • ガソリンスタンド検索: 統合された地図機能で、近くのガソリンスタンドを素早く見つけられます。
  • 多言語対応: 日本語、中国語、英語にネイティブ対応しています。
  • モバイル対応: レスポンシブデザインにより、スマートフォンとデスクトップの両方で快適に利用できます (Material Design 3)。

🛠️ 技術スタック

  • フレームワーク: Next.js 16 (App Router)
  • データベース: Prisma (SQLite)
  • スタイル: TailwindCSS + CSS Modules (Material Design 3 スタイル)
  • 地図: Leaflet + OpenStreetMap
  • デプロイ: Docker 対応

🚀 クイックスタート

ローカル開発

  1. リポジトリのクローン

    git clone https://github.com/yourusername/fuel-maintenance-tracker.git
cd fuel-maintenance-tracker

  2. 依存関係のインストール

    npm install

  3. データベースの初期化

    npx prisma migrate dev

  4. 開発サーバーの起動

    npm run dev

    http://localhost:3000 にアクセスしてください。

🐳 Docker デプロイ

詳細な Docker デプロイメントガイド (英語/中国語) をご用意しています。

簡易コマンド:

docker build -t fuel-tracker .
docker run -d -p 9521:9521 -v ./data:/app/prisma/db fuel-tracker

📂 プロジェクト構造

src/
├── app/              # Next.js App Router ページ
├── components/       # React UI コンポーネント
├── lib/              # ユーティリティ (計算ロジック, DB, i18n)
└── ...

🤝 貢献

プルリクエストや Issue の報告は大歓迎です！

📄 ライセンス

MIT License