{"id":34947888,"url":"https://github.com/anav5704/honeywell-aog-zero","last_synced_at":"2026-01-20T17:10:55.561Z","repository":{"id":329691198,"uuid":"1119213279","full_name":"anav5704/honeywell-aog-zero","owner":"anav5704","description":"Data-driven, proactive maintenance sheduling system for APUs","archived":false,"fork":false,"pushed_at":"2025-12-21T06:58:27.000Z","size":53996,"stargazers_count":0,"open_issues_count":0,"forks_count":4,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-12-23T01:07:56.829Z","etag":null,"topics":["docker","fastapi","nextjs","postgresql","scikit-learn"],"latest_commit_sha":null,"homepage":"","language":"Jupyter Notebook","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/anav5704.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-12-18T23:36:47.000Z","updated_at":"2025-12-21T06:58:30.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/anav5704/honeywell-aog-zero","commit_stats":null,"previous_names":["anav5704/honeywell-aog-zero"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/anav5704/honeywell-aog-zero","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/anav5704%2Fhoneywell-aog-zero","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/anav5704%2Fhoneywell-aog-zero/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/anav5704%2Fhoneywell-aog-zero/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/anav5704%2Fhoneywell-aog-zero/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/anav5704","download_url":"https://codeload.github.com/anav5704/honeywell-aog-zero/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/anav5704%2Fhoneywell-aog-zero/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28607624,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-20T16:10:39.856Z","status":"ssl_error","status_checked_at":"2026-01-20T16:10:39.493Z","response_time":117,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["docker","fastapi","nextjs","postgresql","scikit-learn"],"created_at":"2025-12-26T20:50:01.650Z","updated_at":"2026-01-20T17:10:55.555Z","avatar_url":"https://github.com/anav5704.png","language":"Jupyter Notebook","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Honeywell AOG Zero - APU Health Monitoring System\n\nA real-time Aircraft on Ground (AOG) prevention system that monitors Auxiliary Power Unit (APU) health across your fleet. Built with Next.js, FastAPI, and Firebase Authentication.\n\n## Preview\n\n### Fleet Page\n\n![Fleet Page](./.github/docs/fleet-page.png)\n\n\n### Sensor Data Page\n\n![Snesor Data Page](./.github/docs/sensor-data-page.png)\n\n### Aircrafts Page\n\n![Aircrafts page](./.github/docs/aircrafts-page.png)\n\n## Overview\n\nAOG Zero helps airlines prevent unplanned aircraft groundings by:\n- **Real-time APU health monitoring** with predictive analytics\n- **Fleet-wide dashboard** showing aircraft health status\n- **Priority-based alerts** (Critical, Urgent, Warning, Monitor, Healthy)\n- **Historical flight tracking** with maintenance insights\n- **Secure authentication** via Google OAuth (WorkOS AuthKit)\n\n## Project Structure\n\n```\nai-hackathon/\n├── frontend/                    # Next.js 15 + TypeScript\n│   ├── app/\n│   │   ├── page.tsx            # Landing page (redirects to /login or /dashboard)\n│   │   ├── login/              # Authentication page\n│   │   ├── dashboard/          # Protected dashboard (aircraft fleet overview)\n│   │   │   ├── page.tsx        # Server component with auth guard\n│   │   │   └── DashboardClient.tsx  # Client component with fleet data\n│   │   └── aircraft/[id]/      # Individual aircraft detail view\n│   ├── components/\n│   │   ├── AuthProvider.tsx    # Firebase auth context\n│   │   ├── Navbar.tsx          # Navigation with user menu\n│   │   └── AircraftCard.tsx    # Aircraft status card component\n│   ├── public/\n│   │   └── media/              # Static assets (logos, icons)\n│   └── .env.local              # Frontend environment variables\n│\n├── backend/                     # FastAPI + PostgreSQL\n│   ├── main.py                 # API server entry point\n│   ├── database.py             # PostgreSQL connection \u0026 models\n│   ├── models.py               # Pydantic schemas\n│   ├── scripts/\n│   │   ├── reset_database.py   # Clears database tables\n│   │   └── seed_database.py    # Populates with sample data\n│   ├── seed_apu_data.py        # Seeds APU health metrics\n│   └── requirements.txt        # Python dependencies\n│\n└── README.md\n```\n\n## Setup \u0026 Installation\n\n### Prerequisites\n\n- **Node.js** 18+ and npm/pnpm/yarn\n- **Python** 3.10+\n- **PostgreSQL** 14+ (local or cloud instance)\n- **Firebase** project (for authentication)\n- **WorkOS** account (optional, for AuthKit)\n\n### Clone the Repository\n\n```bash\ngit clone \u003crepository-url\u003e\ncd ai-hackathon\n```\n\n###  Backend Setup\n\n```bash\ncd backend\n\n# Create virtual environment\npython -m venv venv\n\n# Activate virtual environment\n# Windows:\nvenv\\Scripts\\activate\n# macOS/Linux:\nsource venv/bin/activate\n\n# Install dependencies\npip install -r requirements.txt\n\n# Initialize database\npython scripts/reset_database.py --yes\npython scripts/seed_database.py --yes\npython seed_apu_data.py\n\n# Start backend server\nuvicorn main:app --reload --reload-dir .\n```\n\nBackend runs at **http://localhost:8000**\n\n### Frontend Setup\n\n```bash\ncd frontend\n\n# Install dependencies\nnpm install\n# or\npnpm install\n# or\nyarn install\n\n# Configure environment variables\n# Create .env.local file with:\nNEXT_PUBLIC_API_URL=http://localhost:8000\nNEXT_PUBLIC_FIREBASE_API_KEY=your_firebase_api_key\nNEXT_PUBLIC_FIREBASE_AUTH_DOMAIN=your_project.firebaseapp.com\nNEXT_PUBLIC_FIREBASE_PROJECT_ID=your_firebase_project_id\nNEXT_PUBLIC_FIREBASE_STORAGE_BUCKET=your_project.appspot.com\nNEXT_PUBLIC_FIREBASE_MESSAGING_SENDER_ID=123456789\nNEXT_PUBLIC_FIREBASE_APP_ID=1:123456789:web:abcdef\n\n# Start development server\nnpm run dev\n# or\npnpm dev\n# or\nyarn dev\n```\n\nFrontend runs at **http://localhost:3000**\n\n## Firebase Authentication Setup\n\n1. Go to [Firebase Console](https://console.firebase.google.com/)\n2. Create a new project (or use existing)\n3. Enable **Authentication** → **Google Sign-In**\n4. Copy your Firebase config values to `.env.local`\n5. Add `http://localhost:3000` to authorized domains\n\n## API Endpoints\n\n| Method | Endpoint | Description |\n|--------|----------|-------------|\n| GET | `/aircrafts` | List all aircraft with health status |\n| GET | `/aircrafts/{id}` | Get specific aircraft details |\n| GET | `/aircrafts/{id}/flights` | Get flight history for aircraft |\n| GET | `/health` | API health check |\n\n##  Features\n\n### Dashboard\n- **Fleet Overview**: Real-time health status for all aircraft\n- **Filtering**: View by health category (Critical, Urgent, Warning, etc.)\n- **Sorting**: By urgency, health score, or tail number\n- **Fleet Summary**: Total aircraft count and health distribution\n\n### Aircraft Detail Page\n- **APU Health Metrics**: Temperature, pressure, vibration, oil levels\n- **Flight History**: Last 10 flights with timestamps\n- **Predictive Alerts**: AI-powered maintenance recommendations\n- **Real-time Updates**: Auto-refresh every 30 seconds\n\n### Authentication\n- **Google OAuth**: Secure sign-in with Google accounts\n- **Protected Routes**: Server-side auth guards on sensitive pages\n- **Session Management**: Persistent auth state with Firebase\n\n## Tech Stack\n\n**Frontend:**\n- Next.js 15 (App Router)\n- TypeScript\n- Firebase Authentication\n- React Hooks\n- CSS-in-JS (inline styles)\n\n**Backend:**\n- FastAPI\n- PostgreSQL\n- SQLAlchemy\n- Pydantic\n- Uvicorn\n\n## Development Notes\n\n- Frontend uses **Server Components** for auth checks (no flicker on protected routes)\n- Backend uses **async/await** for non-blocking database queries\n- Database seeding includes realistic APU metrics and flight data\n- CORS enabled for `localhost:3000` during development\n\n## Troubleshooting\n\n**Port already in use:**\n```bash\n# Windows\nnetstat -aon | findstr :3000\ntaskkill /PID \u003cPID\u003e /F\n\n# macOS/Linux\nlsof -ti:3000 | xargs kill -9\n```\n\n**Database connection error:**\n- Verify PostgreSQL is running\n- Check `DATABASE_URL` in `.env`\n- Ensure database exists: `createdb aog_zero`\n\n**Firebase auth not working:**\n- Verify all Firebase config values in `.env.local`\n- Check authorized domains in Firebase Console\n- Clear browser cookies and try again\n\n\n## 👥 Contributors\nAnav\nParvish \nTrishal\nShaneel \nYash \nShivam \nRohan\nDanvil\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fanav5704%2Fhoneywell-aog-zero","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fanav5704%2Fhoneywell-aog-zero","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fanav5704%2Fhoneywell-aog-zero/lists"}