Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/tanbirhossain/vehicletracking
Vehicle location tracking system
https://github.com/tanbirhossain/vehicletracking
cqrs docker dotnet-core integration-test kubernetes mediator-pattern sql-server unit-test
Last synced: 19 days ago
JSON representation
Vehicle location tracking system
- Host: GitHub
- URL: https://github.com/tanbirhossain/vehicletracking
- Owner: tanbirhossain
- Created: 2021-05-30T15:13:54.000Z (over 3 years ago)
- Default Branch: master
- Last Pushed: 2021-07-05T02:30:20.000Z (over 3 years ago)
- Last Synced: 2024-11-17T21:40:52.441Z (3 months ago)
- Topics: cqrs, docker, dotnet-core, integration-test, kubernetes, mediator-pattern, sql-server, unit-test
- Language: C#
- Homepage:
- Size: 99.6 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Vehicle Tracking Api
## Installing
#### Visual studio
Please make sure you've already installed Visual Studio 2019, .Net 5 SDK and SQL Server 2019 on your Windows 10 platform.
[Visual Studio 2019](https://visualstudio.microsoft.com/downloads/)
[.Net 5](https://dotnet.microsoft.com/download/dotnet/5.0)
[Sql Server 2019](https://www.microsoft.com/en-us/sql-server/sql-server-downloads)
Select **VehicleTracking.sln** from `/VehicleTracking/` directory.
Change database connection in `appsettings.json` from `VehicleTracking.Api` project .
`ConnectionStrings` section in `appsettings.json`:
```
"ConnectionStrings": {
"VehicleTrackingConn": "Server=localhost;Database=VehicleTrackingDb;user id=sa;password=123456789;"
},
```
Run `VehicleTracking.Api` application.
I have implemented swagger documentation . You can see api documentation below url
```
Api documentation: https://localhost:5001/swagger/index.html
```
#### Docker
Make sure you have installed and configured docker in your environment. After that, you can run the below commands from the `/VehicleTracking/` directory and get started with the VehicleTracking api immediately.
```powershell
docker-compose build
docker-compose up
```
You should be able to access api components of the application by using the below URLs :
```
Api: http://localhost:5100/
```
#### Local Kubernetes
Make sure you have installed and configured Kubernetes in your environment.
After that, you can run the below commands from the `/VehicleTracking/Kubernetes/` directory.
```powershell
./build-images.ps1
./deploy-all.ps1
```
You should be able to access api components of the application by using the below URLs :
```
Api: http://localhost:5100/
```
## How it works
1. Register a client with first name, last name, email, password .
2. Client can login with email, password.
3. A registered client can add multiple vehicle with Name, DeviceId. DeviceId is unique id which you get from the GPS device.
4. GPS device send vehicle location with deviceId, latitude, longitude for the authentic client.
5. Authentic client can see their vehicle current location by vehicleId. Api will return longitude , latitude and address name. Google map api will return current address name based on the position.
6. Client can also see the vehicle journey by vehicleId, start and end datetime.
**Demo Login Credentials:**
URL: `https://localhost:5001/api/v1/Account/Login`
```
{
"email": "[email protected]",
"password": "1234"
}
```
## Extensibility
If the customer wants to add more properties then you should update Data Model.
After that have to do migration below commands.
```package manager
add-migration "Added properties"
update-database
```
## Bonus
I have implemented google map geocode which will send address based on latitude and longitude. You can find in the `GoogleApiService` .