i1820 / backend.php

The Glue

Platform Backend

Introduction

Every microservice architecture must have a glue and its our glue for I1820 Platform. This service handles authentication, authorization, and acts as a proxy between frontend and other services. It also caches the additional information about projects and things.

Up and Running

Let's up and run this piece of shit on ubuntu 18.04 with nginx. First of all you must install the php.

sudo apt install curl php-cli php-mbstring git unzip
sudo apt install php-fpm php-pear php-dev
sudo apt install php-curl

Then you must install the php composer for php package management.

curl -sS https://getcomposer.org/installer -o composer-setup.php
sudo php composer-setup.php --install-dir=/usr/local/bin --filename=composer
rm composer-setup.php

Almost Done! Install the mongodb extension for php with the following command.

sudo pecl install mongodb
# remember to enable mongodb extension on php.ini [extension=mongodb.so]

You have the php environment so let's run this shit and its requirements!

docker-compose up -d

composer install
php artisan key:generate
php artisan config:cache
php artisan jwt:secret

# setup database
php artisan migrate:fresh
php artisan db:seed

# setup the loraserver.io as a lora connectivity
php artisan loraserver:setup

php artisan serve --host=0.0.0.0 --port=7070

Errors Numbers

sjd-backend returns the following error codes with HTTP 200 OK:

• 701 UnAuthorized
• 704 Not Found
• 706 Already Existed
• 707 Validation Error

backend.php's Issues

Project Delete

Delete project and stop its container in pm service

Production with Docker

Create a specific Dockerfile for using in production. I think this link could help us in this dark and scary way.

Packages

Corrects packages informations

Thing Remove

Remove thing from its project then delete it. it is supported in the tm service.

Thing Show/List

Provide information about the thing last seen and more in thing show API and do not return them in thing listing to improve performance.

Migration

Add database migration for collection indexes. This could help.

Jobs

Use queue and jobs to handle the time-consuming works like sending an email

Notification

Use Notification to send emails for users. The current handmade method has lots of issues.

ABP support

Adds following parameters:

• AppSKey
• NetSKey
• DeviceAddr

Remove Payment Portals

There is no usefulness in payment portals so let's drop them

Aliasing

There is a great performance degradation when the ThingController loop over all collected data so this phase must remove.

Upload Max Size

Provide the maximum size in file uploads

loraserver.io Thing Name

loraserver.io thing's names must not have any space so we cannot just pass the user entered name into loraserver.io

Project/Thing Not Found

Return related error when the given thing or project is not available instead of crashing by 500.

LoRa Application

There is no point in building an application for each project in loraserver.io.
This causes a heavy load on the backend and providing nothing.

Better Registeration

Send activation links to users with the notification system and generate links as singed URL. This article may help a lot about this.

loraserver.io Authentication

LoRa Authentication sometimes fails and returns token expires error.

Project Perimeter

Users can define perimeter for their project as a polygon using the geojson and store them. This perimeter will be shown on the project management page and their things will be there too.