AeroGuard Compliance

AeroGuard Compliance is a professional-grade flight crew logging and compliance tracking application. It is designed to handle complex FAA Part 135 and Part 91 regulatory profiles, providing real-time legality checks, fatigue risk monitoring, and automated AI-powered flight plan importing.

---

🚀 Key Features

• Regulatory Compliance Engine: Real-time checking against FAA regulations:
  • Part 135.267 (Unscheduled 1-2 Pilots)
  • Part 135.269 (Augmented Crew)
  • Part 135.265 (Scheduled)
  • Part 135.271 (HEMES)
  • Part 91 (General Aviation)
• Smart Event Logging: Intuitive timeline interface for logging Report, Block Out, Block In, and Release events.
• Fatigue Risk Management (FRMS): Built-in heuristics to calculate fatigue scores based on WOCL (Window of Circadian Low), sector count, time zones crossed, and rest efficiency.
• AI Flight Plan Import: Paste raw dispatch releases or emails, and Google Gemini 2.5 extracts the schedule, airports, and aircraft details automatically.
• Fleet Statistics: Tracks flight time by aircraft tail number and engine count (Single vs. Multi-engine).
• Offline Capable: Uses local storage persistence to ensure data is available even at 35,000 ft.

🛠️ Technology Stack

• Frontend: React 19, TypeScript
• Styling: Tailwind CSS
• Icons: Lucide React
• AI Integration: Google GenAI SDK (Gemini 2.5 Flash)
• Date Handling: date-fns
• Build Tool: Vite

⚡ Getting Started

Prerequisites

• Node.js (v18+)
• Google Gemini API Key

Installation

1. Clone the repository

   git clone https://github.com/your-username/aeroguard.git
   cd aeroguard

2. Install dependencies

   npm install

3. Configure Environment Create a .env file in the root directory and add your API key:

   API_KEY=your_google_gemini_api_key

4. Run Development Server

   npm run dev

📖 Usage Guide

Logging Flights

1. Report: Start your duty day.
2. Block Out: Enter the tail number and engine count (auto-filled from previous legs).
3. Block In: Record arrival time and time zones crossed.
4. Release: End your duty period.

Using AI Import

Click the Import button in the header. Paste unstructured text (e.g., "KPHX to KSDL at 1400Z, N12345"). The system will parse legs, times, and aircraft details.

Compliance Dashboard

The dashboard updates in real-time. It visualizes:

• Rolling 24h, 7-day, monthly, and annual flight time limits.
• Required rest periods (looking back 24h).
• Duty time limitations based on the selected crew complement.

🛡️ License

This project is licensed under the MIT License - see the LICENSE file for details.