Light Portal Tutorial

Light-portal is the central point that provides entries for all light-platform supporting services. It is a website that integrates all services with a standard UI for users to utilize and manage these services. Behind the single-page application is a light-router instance that hosts all the virtual domains and proxy API requests to the backend services.

Most light-portal services are built on top of the light-hybrid-4j framework with Event Sourcing and CQRS. Some of the portal services like the light-oauth2 are built on top of the light-rest-4j framework.

When light-portal services are deployed with the light-hybrid-4j, there might not be a lot of volume in the beginning. We use one hybrid-command server to host all the services that update the portal and one hybrid-query server to host all the services that only read info from the portal. Each server can be scaled to multiple instances based on the read-only load or write-only load. Also, we have an option to move one or two hot services to a separate server instance and scale it accordingly later on.

Most services for the portal can be found in the light-portal repository on github.com/networknt. The UI can be found in view folder, and the UI final version is deployed to the light-config-test repository on github.com/networknt.

Build and Start Portal Service

Portal Services:

Portal View

Developer

Portal Market Place

The marketplace is the most significant component in the light-portal, and it is the primary service we are offering to the small and medium corporations. Add a new feature - How to add a new feature to the portal marketplace Read More »

Local Portal Light-Router

We now have some users who want to work on the light-portal to add more services and customize the UI to meet their requirements. In this tutorial, we are going to explore how to get the light-portal services started and exposed from light-router. With all the services available locally, we are going to demo how to use the proxy in React SPA to build UI with the hot reloader. In addition, we are going to show how to build and deploy the developed SPA to the router instance so that CORS can be avoided and maximize the performance. Read More »

Portal View Tutorial

This is a very long tutorial that documents the steps we build light-portal UI with React and other related libraries. It is not part of the core features of our light-4j platform; however, I think it is essential for the following reasons. Most of our developers are backend focused, and the front end Javascript is not the strength for us. When starting the UI for the portal, I am going to document the steps so that our team members can learn from the tutorial. Read More »

Portal Host Menu Tutorial

The host-menu service has many endpoints, and here we are going to explore all of them. Create a new host There are test cases built into the services, and we need to extract these to create curl command line to test the services live. Here is the command to create a new host. curl -k -X POST https://localhost:8443/api/json -H 'content-type: application/json' -d '{"host":"lightapi.net","service":"menu","action":"createMenu","version":"0.1.0","data":{"host":"example.org","description":"example org web site","contains":["1","2","3"]}}' The result should be something like this. Read More »

Portal - User Management Tutorial

User Management Service Introduction - User Management Service introduction User Management Integration Test - User Management Service integration test Read More »