{"id":29035359,"url":"https://github.com/sylvester-francis/telematicsdataplatform","last_synced_at":"2026-04-11T12:04:16.840Z","repository":{"id":301255707,"uuid":"1006690774","full_name":"sylvester-francis/TelematicsDataPlatform","owner":"sylvester-francis","description":"Professional telematics platform with interactive maps, real-time vehicle tracking,    and comprehensive fleet analytics. Built with Angular 18, .NET Core, Leaflet.js   mapping, and enterprise-grade architecture.","archived":false,"fork":false,"pushed_at":"2025-06-25T23:02:21.000Z","size":19622,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-06-26T00:18:41.458Z","etag":null,"topics":["angular","docker","dotnet-core","entity-framework","fleet-management","github-actions","mapping","sql-server","telematics"],"latest_commit_sha":null,"homepage":"","language":"C#","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/sylvester-francis.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-06-22T19:59:28.000Z","updated_at":"2025-06-25T23:02:23.000Z","dependencies_parsed_at":"2025-06-26T00:18:50.754Z","dependency_job_id":null,"html_url":"https://github.com/sylvester-francis/TelematicsDataPlatform","commit_stats":null,"previous_names":["sylvester-francis/telematicsdataplatform"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/sylvester-francis/TelematicsDataPlatform","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sylvester-francis%2FTelematicsDataPlatform","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sylvester-francis%2FTelematicsDataPlatform/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sylvester-francis%2FTelematicsDataPlatform/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sylvester-francis%2FTelematicsDataPlatform/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sylvester-francis","download_url":"https://codeload.github.com/sylvester-francis/TelematicsDataPlatform/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sylvester-francis%2FTelematicsDataPlatform/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":262063486,"owners_count":23252765,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["angular","docker","dotnet-core","entity-framework","fleet-management","github-actions","mapping","sql-server","telematics"],"created_at":"2025-06-26T12:08:18.568Z","updated_at":"2026-04-11T12:04:16.797Z","avatar_url":"https://github.com/sylvester-francis.png","language":"C#","funding_links":[],"categories":[],"sub_categories":[],"readme":"# TelematicsHQ - Fleet Management Platform\n\n[![Build Status](https://github.com/sylvester-francis/TelematicsDataPlatform/actions/workflows/simple-ci-cd.yml/badge.svg)](https://github.com/sylvester-francis/TelematicsDataPlatform/actions) ![Angular](https://img.shields.io/badge/Angular-18-red) ![.NET](https://img.shields.io/badge/.NET-9.0-blue) ![Docker](https://img.shields.io/badge/Docker-Ready-blue)\n\nA modern fleet management platform built with Angular 18 and .NET 9.0, featuring interactive maps and real-time vehicle tracking.\n\n## Features\n\n- **Interactive Dashboard** - Real-time fleet metrics and vehicle status\n- **Vehicle Tracking** - GPS location mapping with Leaflet.js\n- **Event Management** - Submit and track telemetry events\n- **Health Monitoring** - API health checks and system metrics\n- **Responsive Design** - Mobile-friendly interface\n\n## Quick Start\n\n### Docker (Recommended)\n```bash\n# Run full stack with database\ndocker-compose up -d\n\n# Access the application\n# Frontend: http://localhost:4201\n# Backend API: http://localhost:5000\n# Swagger: http://localhost:5000/swagger\n```\n\n### Development Setup\n```bash\n# Backend\ncd TelematicsApi\ndotnet run --urls=\"http://localhost:5000\"\n\n# Frontend\ncd telematics-ui\nnpm install\nnpm start\n```\n\n## Architecture\n\n### Frontend (Angular 18)\n- Standalone components\n- Angular Material UI\n- Leaflet maps integration\n- TypeScript strict mode\n- Responsive design\n\n### Backend (.NET 9.0)\n- Web API with Entity Framework Core\n- SQL Server with spatial data support\n- Structured logging with Serilog\n- Health checks and metrics\n- Swagger documentation\n\n## API Endpoints\n\n```\nGET    /api/vehicles                    # List all vehicles\nGET    /api/vehicles/{id}/stats        # Vehicle statistics\nGET    /api/telematics/vehicles/{id}/events  # Vehicle events\nPOST   /api/telematics/events          # Submit event\nGET    /api/health                     # Health check\nGET    /api/health/metrics             # System metrics\n```\n\n## Technology Stack\n\n**Frontend:**\n- Angular 18\n- TypeScript 5.0\n- Angular Material\n- Leaflet.js\n- SCSS\n\n**Backend:**\n- .NET 9.0\n- Entity Framework Core\n- SQL Server\n- NetTopologySuite\n- Serilog\n\n**DevOps:**\n- Docker \u0026 Docker Compose\n- GitHub Actions CI/CD\n- GitHub Container Registry\n\n## Development\n\n### Prerequisites\n- Node.js 20.19+\n- .NET SDK 9.0+\n- Docker\n\n### Running Tests\n```bash\n# Backend tests\ndotnet test\n\n# Frontend tests\ncd telematics-ui\nnpm test\n```\n\n### Building\n```bash\n# Backend\ndotnet build\n\n# Frontend\ncd telematics-ui\nnpm run build\n```\n\n## CI/CD\n\nThe project uses GitHub Actions for automated testing and deployment:\n- Backend unit tests\n- Frontend tests and builds\n- Docker image builds\n- Security scanning\n\nContainer images are published to GitHub Container Registry.\n\n## Contributing\n\n1. Fork the repository\n2. Create a feature branch\n3. Make changes and add tests\n4. Run tests locally\n5. Submit a pull request\n\n## License\n\nMIT License - see [LICENSE](LICENSE) file for details.\n\n---\n\n**Repository**: [https://github.com/sylvester-francis/TelematicsDataPlatform](https://github.com/sylvester-francis/TelematicsDataPlatform)","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsylvester-francis%2Ftelematicsdataplatform","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsylvester-francis%2Ftelematicsdataplatform","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsylvester-francis%2Ftelematicsdataplatform/lists"}