Skip to content

TK-data/BilparkApp

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

TK_DATA

NTNU Course IT2901 (Bachelorproject) repository for group 15 with the task TK_DATA.

List of contents

Overview

The system will be a portal for businesses to manage their fleet of cars. Each company that wants to use the platform will get access to two main features. The person in charge from the company will have access to an administration dashboard, which is a web application. The employees of the company that use company vehicles will use a mobile application to log any car related activities.

The Application

The application will give the employees a range of functionality that will make it easier to use the car at work.

Examples of functionalities:

  • Driving log: The employe can register work related car trips.
  • Damage report: The employe can register any damage on the vehicle.
  • Fuel refill notification: The employe can choose when he/she want's to refill fuel and then get a notification every week on the same day and time.

The Dashboard

The dashboard will give an overview of all car related activities that the employees in the company registers. For now the only thing that is ready is the login page and a page that shows all the cars in the database.

Future development will give the person in charge from the company a complete overview of everything about their fleet of cars. Ranging from when people refill and how long every car has driven, to when the insurance of each car expires.

The Backend

The backend is made with Sails which is a MVC framework built on Node.js. It serves as an API endpoint on our backend and lets users manipulate and fetch data from the database, by using our frontend applications.

The Application and the Dashboard are both connected to the same backend.

Development Setup

Do the following steps to set up and run the application for development. To make the application work properly, the backend has to be up and running.

Backend

First you need to clone https://github.com/TK-data/BilparkBackend.

git clone https://github.com/TK-data/BilparkBackend.git

Install sails globally for the sails command to work:

npm i -g sails

To install the application, navigate to the backend folder and install dependencies:

cd Backend
npm install

Populating your DB with example data.

Example admin user is [email protected], adminsen

sails console
sails.services.userdataservice.createExampleCompanies()
sails.services.userdataservice.createExampleAdmin()
.exit

To locally run the backend on your machine serve it with:

sails lift

You need to set up the environment variables for the DSM API and the database. Duplicate app-env.example and rename it app-env Open up app-env and edit the variables to the correct values for your DSM account and database (variables for database is not needed if you are using local disk adapter).

To add these variables to the enviroment, open up console at the backend folder, and execute source app-env

React Native Application

First you need to clone https://github.com/TK-data/BilparkApp.

git clone https://github.com/TK-data/BilparkApp.git

Then point to the address of the machine that is running the backend:

  1. Navigate to BilparkApp\src\config - cd BilparkApp\src\config
  2. Duplicate connections.js.example and rename it connections.js
  3. Edit the API_ADDRESS to where the backend is running (your local IP if running on the same machine)
  4. Save the file

Then install the dependencies and run the application:

cd BilparkApp
npm install
npm start

You can now run the application on mobile devices* or in an emulator.

* You need the Expo app to run the app on mobile devices. Use the Expo app to scan the QR code shown in the terminal.

Dashboard React Application

First you need to clone https://github.com/TK-data/BilparkDashboard.

git clone https://github.com/TK-data/BilparkDashboard.git

First point to the address of the machine that is running the backend:

  1. Navigate to bpdashboard\src\config - cd bpdashboard\src\config
  2. Duplicate connections.js.example and rename it connections.js
  3. Edit the API_ADDRESS to where the backend is running (your local IP if running on the same machine)
  4. Save the file

Then install the dependencies and run the application:

cd bpdashboard
npm install
npm start

The Dashboard will automatically open in your preferred browser. (If not, go to http://localhost:3000/)

React Native App Description

Components, containers, modules and other parts of the React Native "Mobile" Application.

Containers/modules

Login

Is put together by LoginScreen and LoginForm which give the user the possibility to log into the application.

UserRegister

Is put together by UserRegisterScreen and UserRegisterForm which give the user the possibility to register into the application.

Menu

Is put together by MenuScreen, MenuBox, ProfileButton, Slide1 and Slide2. You will be able to navigate to all functionality from the Menu.

DamageReport

Is put together by DamageReportScreen and DamageReportForm*. The user can register damages on his/her vehicle from this component.

FuelDay

Is put together by FuelDayScreen and FuelDayForm. The user can change when it wants notification about when to refill from this component.

FuelDayModal

FuelSetNotificationScreen will tell the user how much he/she can save by refueling on specific days.

FuelRefill

Is put together by FuelRefillScreen, FuelRefillList, FuelRefillItem, FuelRefillForm and SettingsButton. This component gives the user the possibility to register when they did refill, how much the petrol cost and how much they paid.

RegisterCompany

Is put together by RegisterCompanyScreen and CompanyPicker. This component lets the user choose which company they are connected to.

RegisterVehicle

Is put together by GetCarScreen, GetCarForm and CarForm which together lets the user search for their car and then accept if it is theirs.

TravelLog

Is put together by TravelLogScreen, TravelLogInput, TravelLogPassengerForm, TravelLogCargoForm, GooglePlacesAutocompleteFrom and GooglePlacesAutocompleteTo.


Components

LoginScreen

Container for LoginForm.

LoginForm *

A form with username and password fields.

UserRegisterScreen

Container for UserRegisterForm.

UserRegisterForm *

A form with Email, First-name, Last-name, Address and Password fields.

MenuScreen

Container for MenuBox, ProfileButton, Slide1 and Slide2.

MenuBox

Main buttons for navigating to other modules in the application

ProfileButton

Button for navigating to the users profile.

Slide1

Slide with information about the users car, if he/she has registered one.

Slide2

Slide with information about the company the user are connected to.

DamageReportScreen

Container for DamageReportForm

DamageReportForm *

A form with several fields to register damage on the users vehicle. Does also let the user write an optional comment if there has been any damage on parts of the car.

FuelDayScreen

Container for FuelDayForm.

FuelDayForm *

A form that lets the user set time, day and if it want's a notification.

FuelSetNotificationScreen

A modal to tell the user how much he/she can save by refueling on specific days. Shows over FuelRefillScreen if the user hasn't set notification.

FuelRefillScreen

Container for FuelRefillList, FuelRefillItem, FuelRefillForm and SettingsButton.

FuelRefillList

Maps the users registered refills to a list of FuelRefillItem

FuelRefillItem

A listitem for date, time, price and rate of the refill.

FuelRefillForm

Lets the user tell data, time, how much they payed in total and per liter.

SettingsButton

Button that navigates to FuelDay.

RegisterCompanyScreen

Container for CompanyPicker

CompanyPicker

Dropdown menu with all the companies in the database. Lets the user choose which it belongs to.

GetCarScreen

Container for GetCarForm

GetCarForm

Includes CarForm

CarForm *

A form with registration number as field, validates on submit.

TravelLogScreen

Container for TravelLogInput

TravelLogInput

Includes TravelLogPassengerForm, TravelLogCargoForm, GooglePlacesAutocompleteFrom and GooglePlacesAutocompleteTo.

TravelLogPassengerForm *

A form with field that tells how many that were passengers. Will dynamically load text inputs for each passenger.

TravelLogCargoForm *

A form with a checkbox for cargo and a comment field.

GooglePlacesAutocompleteFrom **

Autocompletes input and gives the user alternatives for street names.

GooglePlacesAutocompleteTo **

Autocompletes input and gives the user alternatives for street names.

* These components are using tcomb-form-native

** These components are using Google places autocomplete


Service classes

This application handles state with Redux, you can therefore find all service classes in BilparkApp/src/actions.

React Dashboard Description

Components, containers, modules and other parts of the React "Dashboard" Application.

Containers/modules/Components

Login

A username and password field that lets the user login on the dashboard.

Cars

Gets all the cars from the database and shows them in a table view.

Service classes

This dashboard handles state with Redux, you can therefore find all service classes in bpdashboard/src/actions.

Sailsjs Backend Description

Our backend is based on Sails, an MVC and API framework that builds upon Express.js for Node.js

API Reference

User

GET /api/user

Get an array of user objects, in JSON format. limited to logged in admins.

POST /api/user

Register a new user. Required fields in http body: Email, Password(min length 8 chars) Fname, Lname, Address.

POST /api/user/login

Log in as a user. Required fields in http body: Email, Password

GET /api/user/logout

Log out current user. It just nulls your authentication and UserID in session.

GET /api/user/current

Get current logged in user. Will get forbidden if not logged in.

POST /api/user/notification

Updates the user with what time they want to save their push notification. Need to be logged in.

Required fields in http body: FuelTime: 12-00, FuelDay: 0-6, FuelNotification: 'true'

Car

POST /api/dsm?regnr=XX00000

Get json car object for the input registration number, or a 404 error if no such car exists

POST /api/car/save

Save a car object to a logged in user.

Example of car object:

"car": {
  "RegNr": "VH XXXXX",
  "Cas": "XXXXXXXXXXXX",
  "Brand": "MERCEDES-BENZ",
  "Model": "GLC 350 E 4MATIC/204 X",
  "FuelType": null,
  "RegYear": "2016",
  "VehicleGroup": "PERSONBIL",
  "Co2Emission": null,
  "NoxEmission": null,
  "FuelConsumption": null,
  "ParticleEmmision": null,
  "NextVI": null,
  "NextVINotification": null,
}

FuelRefilll

POST /api/fuelrefill/register

Registers a new fuelrefill entry.

Required fields in http body: FuelTime, Price, Rate

POST /api/fuelrefill/remove

Removes a refill entry, for a logged in user.

Required field in http body: RefillID

GET /api/fuelrefill/getall

Gets all refill entries for a logged in user.

DamageReport

POST /api/damagereport/register

Register a new damage report.

Example of http body for POST request, notice description is not required:

{
	"Items": [
		{
			"ItemType": "Wheel",
			"Damaged": true,
			"Description": "tire frame exploded",
		},
		{
			"ItemType": "Window",
			"Damaged": true,
		},
	]
}
GET /api/damagereport/getall

Gets all damage reports from a logged in user

GET /api/damagereport/getcurrent

Gets the latest damage report from a logged in user

DrivingLog

POST /api/drivinglog/save

Saves a driving log for the current user

GET /api/drivinglog/getall

Get all driving logs for current user

POST /api/drivinglog/remove

Deletes a driving log

Admin

POST /api/admin/login

Login as admin

GET /api/admin/logout

Logs out the current user

Company

POST /api/company/save

Saves the company on the current user.

Backend content

Models

To make logic for our controllers to get different data from specific tables in our database, we defined different models based on the attributes of the different data we would handle.

  • Car
  • Company
  • DamageReport
  • DamageReportItem
  • DrivingLog
  • FuelRefill
  • User
  • Admin

Controllers

  • CarController
    • Provides the save functionality to link a logged in user with a car
  • CompanyController
    • Provides the save functionality to link a logged in user with a company
  • DamageReportController
    • Provides saving and various getters for handling damage reports of a user and a car
  • DrivingLogController
    • Provides saving and various getters for handling driving logs of a user and a car
  • FuelRefillController
    • Provides saving and various getters for handling fuel refills of a user
  • DSMController
    • Provides the API to act as a middle man of the frontend applications and the DSM for receiving details about a car.
  • UserController
    • Provides all the APIs to register and authenticate users
  • AdminController
    • Providing different API routes and functionality for admins. Authentication included.

Policies

To set restrictions on what API routes can be accessed by different people, we modified the policy configuration in our backend to suit our needs.

 UserController: {
    '*': false,
    create: true,
    find: 'adminAuth',
    findOne: 'adminAuth',
    destroy: 'adminAuth',
    populate: 'adminAuth',
    login: true,
    logout: true,
    current: true,
    notification: true,
  },
  DSMController: {
    '*': false,
    getCar: 'sessionAuth',
  },
  FuelRefillController: {
    '*': false,
    register: 'sessionAuth',
    getAll: 'sessionAuth',
    remove: 'sessionAuth',
  },
  CarController: {
    '*': false,
    save: 'sessionAuth',
    find: 'adminAuth',
    findOne: 'adminAuth',
    destroy: 'adminAuth',
    populate: 'adminAuth',
  },
  AdminController: {
    '*': false,
    create: 'adminAuth',
    login: true,
    logout: true,
  },
  DrivingLogController: {
    '*': false,
    find: 'adminAuth',
    save: 'sessionAuth',
    getAll: 'sessionAuth',
    remove: 'sessionAuth',
  },
  DamageReport: {
    '*': false,
    register: 'sessionAuth',
    getall: 'sessionAuth',
    getCurrent: 'sessionAuth',
  },
  DamageReportItem: {
    '*': false,
  },
  CompanyController: {
    '*': false,
    find: 'sessionAuth',
    save: 'sessionAuth',
  },

You can see how by default every route is set to blocked, then we further specify if an admin, logged in user or anyone can access other routes.

Session

We utilize the built in features of handling and storing sessions by SailsJS.

Further details is documented at their website

Database

For our project we Utilized the MySQL adapter for translating SailsJS' high level Waterline Orm into mysql queries that would fetch or manipulate data in our database.

On the master branch it's a local disk adapter that allows you to run the project locally without the need to set up a database.

Linting

We use ESLint to ensure code standards. The rules are defined in Backend/.eslintrc and BilparkApp/.eslintrc.

For setup: Install "linter" and "linter-eslint" in Atom. For other text editors, search for similar solutions.

Continous Integration

We use Travis CI, a tool for Continuous Integration, to run our tests and upload code coverage reports to codecov.io.

Travis is activated on the repository and project/language specific settings are specified in the .travis.yml.

To make our workflow support continous delivery, we've added the option to automatically deploy pull requests when they are made to dev and master branch, using Appr. When we use this, it automatically posts a link and QR code to the pull request, so we can run the app on our device or emulator.

Deployment

React Native Application

We use Expo to deploy our application. Login with your Expo account using exp login

Android Deployment

  • Run exp build:android
  • Wait for build to finnish
  • Copy/paste link in browser to download APK.
  • Drag and drop .apk file into emulator, or download/transfer it to an Android Device.
  • (Upload .apk to Google Play Store)
To run on your connected Android Device:

iOS Deployment

  • Need to have an Apple Developer Account
  • Run exp build:ios

React Dashboard

Build the Dashboard

npm run build

The project is now built assuming it is hosted at the server root.

On the dashboard repository Travis CI is setup to auto-deploy new pushes to the master branch directly to surge.sh. See the .travis.yml file for settings and the deployment address.

If you want to read more about other methods for deployment, check out React Deployment.

Backend

For our backend, we used Heroku to host it. Therefore this deployement method will be specific for that service.

Install Heroku

npm install -g heroku

Verify that it is installed using

heroku --version

Login to Heroku

Login using your heroku account.

heroku login

Create a Heroku app

You can skip this step if you already have a Heroku app

heroku create insertAppName

This will create a Heroku app on your account, with the provided name for the app. If you don't provide a name, a random one will be generated for you

Deploy sails app

  1. Navigate to the root folder - cd ..
  2. heroku git:remote -a yourAppName
  3. git subtree push --prefix Backend heroku master
  4. Check if it is up and running: https://yourAppName.herokuapp.com/

This will deploy the backend app to the Heroku app directory you have setup during deployment.

Authors