Skip to content

Service Configurations

There are a few things that have to be set up before you start using JDK Freght Management System

Emails

For emails to be sent from your application you have to configure the connection details. Sendgrid, Mailgun, Sparkpost and SMPT are all supported out of the box

Sendgrid

To use Sendgrid go to your sendgrid dashboard and get your credentials. Check your .env file and configure these variables:

MAIL_MAILER=smtp
# MAIL_DRIVER=smtp # for laravel < 7
MAIL_HOST=smtp.sendgrid.net
MAIL_PORT=587
MAIL_USERNAME=apikey
MAIL_PASSWORD=sendgrid_api_key
MAIL_ENCRYPTION=tls
MAIL_FROM_NAME="John Smith"
MAIL_FROM_ADDRESS=from@example.com
Mailgun

To use mailgun go to your mailgun dashboard and get your credentials.

  • From the .env file in the root folder,Set your #Email connection details (MAIL_USERNAME,MAIL_PASSWORD, MAIL_HOST,MAIL_HOST).

MAIL_MAILER=mailgun 
MAIL_HOST=smtp.mailgun.org 
MAIL_PORT=587 
MAIL_USERNAME=postmaster@xxxxxxxxxxxxxxxxxxxxxxxxxxxx.mailgun.org 
MAIL_PASSWORD=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 
MAIL_ENCRYPTION=SSL # Encryption Format
MAIL_FROM_ADDRESS="someone@example.com" 
MAIL_FROM_NAME="${APP_NAME}"
MAILGUN_DOMAIN=sandbox1b0b6c203ee446178d79ac2bf92c0213.mailgun.org 
MAILGUN_SECRET=53c65413085a9c2f4bd0165cc3b32ae4-90346a2d-f6713c21
Sparkpost

Similar to Mailgun only that you have to save your keys on the sparkpost part .

System Configurations

Before you start creating trips and adding expenses please make sure you have added:

Workflows

The following workflows are predefined in FMS:

  • Expense Approval - Once an expense is created it will trigger approval set under this workflow.
  • Invoice Approval - Triggered once a invoice is created.
  • Trip Loaded Approval - Triggered when a trip status is updated to loaded.
  • Trip Offloaded Approval - Triggered once the trip status is updated to offloaded.
  • Invoice Payment Approval - Triggered when a payment to a invoice is made.
  • Expense Payment Approval - triggered when an expense is payed.

workflows

The approval stages and approvers for the various stages can be added as show below.

i.e for INVOICE APPROVAL WORKFLOW

workflows

Adding approval for the Admin Approval stage.

workflows

User Accounts

Admin user has a default email of didinkaj@gmail.com and a default password didinkaj@gmail.com however when a user is signed up a confirmation link is send to them from which they can set their password.