{"id":28165568,"url":"https://github.com/al0olo/fleet-mangement-system","last_synced_at":"2026-01-25T09:36:20.456Z","repository":{"id":291198293,"uuid":"976908299","full_name":"Al0olo/Fleet-Mangement-System","owner":"Al0olo","description":"Basic Micro-service Based Fleet Management System for IOT integrations","archived":false,"fork":false,"pushed_at":"2025-05-05T20:26:55.000Z","size":1040,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-05-27T00:13:44.735Z","etag":null,"topics":["mern-stack","optimization","scalability","tenderd"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","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/Al0olo.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}},"created_at":"2025-05-03T01:45:21.000Z","updated_at":"2025-05-05T20:25:17.000Z","dependencies_parsed_at":null,"dependency_job_id":"ed901e72-a3ef-497c-a4e4-5fbc0aebb99d","html_url":"https://github.com/Al0olo/Fleet-Mangement-System","commit_stats":null,"previous_names":["al0olo/fleet-mangement-system"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/Al0olo/Fleet-Mangement-System","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Al0olo%2FFleet-Mangement-System","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Al0olo%2FFleet-Mangement-System/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Al0olo%2FFleet-Mangement-System/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Al0olo%2FFleet-Mangement-System/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Al0olo","download_url":"https://codeload.github.com/Al0olo/Fleet-Mangement-System/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Al0olo%2FFleet-Mangement-System/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28750875,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-25T09:00:19.176Z","status":"ssl_error","status_checked_at":"2026-01-25T09:00:04.131Z","response_time":113,"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":["mern-stack","optimization","scalability","tenderd"],"created_at":"2025-05-15T12:11:48.511Z","updated_at":"2026-01-25T09:36:20.436Z","avatar_url":"https://github.com/Al0olo.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Fleet Management System\n\n## Overview\nThis is a full-stack web application for managing a fleet of vehicles. The system allows tracking vehicle locations, maintenance records, and usage statistics. This project is presented to Tenderd as a Software Engineering Assignment.\n\n## Screenshots\n\n### Dashboard\n![Main Dashboard](./assets/main_dashboard.png)\n*Fleet overview dashboard with real-time statistics and activity charts*\n\n### Analytics\n![Analytics Dashboard](./assets/analytics_dashboard.png)\n*Comprehensive analytics dashboard with interactive charts and performance metrics*\n\n### Maintenance Management\n![Maintenance Dashboard](./assets/maintenance_dashboard.png)\n*Maintenance scheduling and record management interface*\n\n### Vehicle Management\n![Vehicle Dashboard](./assets/vehicle_dashboard.png)\n*Detailed vehicle information with tracking and performance data*\n\n## Architecture\nThis project follows a microservice architecture with:\n\n- **Frontend**: React-based web dashboard with TypeScript and Redux\n- **API Gateway**: Single entry point for all client requests\n- **Backend Microservices**: \n  - Vehicle Service\n  - Tracking Service\n  - Maintenance Service\n  - Analytics Service\n  - Simulator Service\n- **Data Layer**:\n  - MongoDB for persistent storage\n  - Redis for caching\n  - Kafka for event streaming\n  - Mongo Express for database administration\n\n\u003e **Detailed Architecture Documentation**: For comprehensive architecture diagrams, data flows, component interactions, and detailed descriptions of each microservice, please refer to the [Architecture Documentation](docs/architecture.md) in the docs directory.\n\n### Why Microservices?\nI've chosen a microservice architecture for this system for several key benefits:\n- **Scalability**: Individual services can be scaled independently based on demand\n- **Fault Isolation**: Issues in one service don't affect the entire system\n- **Technology Flexibility**: Each service can use the most suitable technology stack\n- **Independent Deployment**: Services can be developed, tested and deployed separately\n- **Easier Maintenance**: Smaller codebases are easier to understand and maintain\n\n### Component Architecture\n\n#### API Gateway\nActs as a single entry point for all client requests with these key responsibilities:\n- Request routing to appropriate microservices\n- Authentication and authorization\n- Request/response transformation\n- Rate limiting and throttling\n- Service discovery\n- Load balancing\n- Logging and monitoring\n- Caching frequently accessed data\n\n#### Vehicle Service\nHandles vehicle registration, updates, and management.\n\n#### Tracking Service\nProcesses location data from IoT devices and provides real-time tracking.\n\n#### Maintenance Service\nManages maintenance records and schedules.\n\n#### Analytics Service\nProvides comprehensive analytics and reporting features:\n- Usage statistics for individual vehicles and entire fleet\n- Performance metrics tracking and analysis\n- Cost analysis and reporting\n- Customizable reports with different time periods\n- Real-time data processing via Kafka integration\n- Historical data aggregation and analysis\n\n#### Simulator Service\nGenerates realistic IoT device data to simulate vehicle movements, sensor readings, and status updates. This service:\n- Creates synthetic location data for vehicles\n- Simulates sensor readings (fuel levels, engine status, etc.)\n- Generates events at configurable intervals\n- Allows testing the system without physical devices\n\n### Data Flow\nThe system uses event-driven architecture with key flows:\n- Real-time location updates\n- Vehicle registration\n- Maintenance scheduling\n- Analytics event processing\n\n## Technology Stack\n\n### Backend\n- **Node.js/Express**: Core server framework\n- **TypeScript**: For enhanced type safety and development experience\n- **MongoDB**: Main persistent storage\n- **Mongoose**: MongoDB object modeling\n- **Redis**: Fast caching layer\n- **Kafka**: Event streaming platform for real-time data processing\n- **API Gateway**: Express-based API gateway\n- **Swagger/OpenAPI**: API documentation\n- **Winston**: Advanced logging\n- **Prometheus**: Metrics collection for monitoring\n- **Mongo Express**: Web-based MongoDB admin interface\n\n### Frontend\n- **React**: UI library for building component-based interfaces\n- **TypeScript**: For type safety and better developer experience\n- **Redux**: For state management\n- **Recharts**: For data visualization and interactive charts\n- **CSS-in-JS**: Styled components using inline styles\n- **Responsive Design**: Mobile-friendly layouts\n- **SVG Icons**: For consistent and scalable visual elements\n\n### DevOps\n- Docker\n- Docker Compose\n- GitHub Actions CI/CD\n- Jest for testing\n- ESLint for code quality\n\n### Testing Infrastructure\n- **Unit Tests**: For isolated testing of service components\n- **Integration Tests**: For testing service interactions and API endpoints\n- **Mocking Framework**: For simulating dependencies during testing\n- **CI Pipeline**: Automated testing on pull requests and pushes\n- **Test Coverage Reports**: Track code coverage across services\n- **JUnit Reports**: Standardized test reporting\n\n## Features\n\n### Backend Requirements\n- API Gateway:\n  - Unified entry point for all client requests\n  - Authentication and authorization\n  - Service discovery and routing\n  - Request/response transformation\n  - Monitoring and observability\n\n- Vehicle Service:\n  - CRUD operations for vehicle management\n  - Vehicle registration with type, model, status etc.\n  - Fleet overview endpoints\n\n- Tracking Service:\n  - Real-time location tracking\n  - Location history\n  - Geofencing capabilities\n  - Processing IoT device data\n\n- Maintenance Service:\n  - Maintenance records\n  - Service scheduling\n  - Alerts and notifications\n\n- Analytics Service:\n  - Usage statistics and fleet-wide analytics\n  - Performance metrics tracking\n  - Cost analysis and reporting\n  - Customizable report generation\n  - Data aggregation and historical analysis\n  - Real-time event processing with Kafka\n\n- Simulator Service:\n  - Generation of synthetic IoT device data\n  - Configurable simulation parameters\n  - Multiple vehicle simulation support\n  - Various sensor data simulation (GPS, fuel, engine metrics)\n\n### Frontend Features\n- **Dashboard**:\n  - Summary cards with key metrics\n  - Interactive charts for analytics visualization\n  - Quick action buttons for common tasks\n  - Recent activity feed\n- **Vehicles Management**:\n  - Detailed vehicle listings with search and filter\n  - Comprehensive vehicle detail pages\n  - Real-time location tracking with map integration\n  - Status indicators and visual feedback\n- **Maintenance System**:\n  - Record management with detailed history\n  - Schedule planning with priority indicators\n  - Alerts for overdue maintenance\n  - Status tracking for in-progress work\n- **Analytics Platform**:\n  - Fleet-wide performance metrics\n  - Cost analysis and utilization statistics\n  - Customizable date ranges and filters\n  - Multiple visualization types (bar, line, pie charts)\n  - Data export capabilities\n\n## Installation and Setup\n\n### Prerequisites\n- Node.js (v18 or higher)\n- MongoDB\n- Redis\n- Kafka\n- Docker and Docker Compose (for containerized setup)\n\n### Starting the Backend (Microservices)\n1. Navigate to the `.docker` directory:\n   ```bash\n   cd .docker\n   ```\n2. Start all backend services using Docker Compose:\n   ```bash\n   docker-compose up\n   ```\n   This will start all the microservices, databases, and supporting infrastructure.\n\n### Starting the Frontend\n1. Navigate to the frontend directory:\n   ```bash\n   cd frontend\n   ```\n2. Install dependencies:\n   ```bash\n   npm install\n   ```\n3. Start the development server:\n   ```bash\n   npm run dev\n   ```\n4. Access the application in your browser at http://localhost:5000\n\n### Access Details\nWhen running the full stack, you can access:\n- Frontend: http://localhost:5000\n- API Gateway: http://localhost:8080\n- Mongo Express: http://localhost:8081\n- Kafka UI: http://localhost:8090\n\n## Testing\nThe project includes a comprehensive testing suite:\n\n```shell\n# Run all tests\nnpm test\n\n# Run unit tests only\nnpm run test:unit\n\n# Run integration tests only\nnpm run test:integration\n\n# Generate test coverage report\nnpm run test:coverage\n```\n\n## CI/CD\nThe project uses GitHub Actions for continuous integration and delivery. Each service has its own CI pipeline that runs on pull requests and pushes to main branches.\n\n## API Documentation\nAPI documentation is available at `/api/docs` when running the services.\n\n## Project Structure\n```\nFleet-Management-System/\n├── frontend/         # React-based web dashboard\n├── backend/          # Microservices\n│   ├── api-gateway/  # API Gateway service\n│   ├── vehicle/      # Vehicle service\n│   ├── tracking/     # Tracking service\n│   ├── maintenance/  # Maintenance service\n│   ├── analytics/    # Analytics service\n│   └── simulator/    # IoT data simulator service\n├── docs/             # Documentation\n├── .github/          # GitHub Actions workflows\n└── .docker/          # Docker configuration\n```","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fal0olo%2Ffleet-mangement-system","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fal0olo%2Ffleet-mangement-system","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fal0olo%2Ffleet-mangement-system/lists"}