User Tools

Site Tools


development:applications:ticketer_lite

This is an old revision of the document!


Ticketer Lite Development Details

Updated by Yanjun Wang 17/12/2020

Overview

The purpose of the Ticketer Lite project is to bring the look and feel as well as the technology stack of the existing ticketer application up to date. The Ticketer is one of Errigals main, heavily used applications, yet the application display could be considered quite outdated. The applications front end technology stack is currently a mixture of grails gsp controllers and SmartGWT. These are both old technologies which are no longer favoured. As well as the age of them, they are also quite limiting when it comes to implementing more complex or detailed front end features.

Ticketer Lite application uses 5 services:

  • Ticketer for Business Logic backend
  • ticketer-light-gateway for middle-ware and backend data
  • ticketer-light for frontend
  • idms-proxy for providing SnmpManager data
  • user profile for authentication

Repo:

See also: Ticketer Light Gateway (Ticketer Light Gateway)


Architecture

DIAGRAM 1

DIAGRAM 2

List of Tools & Technologies

  • Java 11
  • Spring Boot 2.4
  • Spring R2DBC 2.4
  • Spring WebFlux 2.4
  • graphql-java 16.1
  • Angular 11
  • Apollo Client
  • ngx-translate

Configuration

The ticketer-light is served via the load balancer in our server deployments. Its environment-specific variables are passed via the config.json file to the app at runtime.

Current Config Fields Are:

{
  "deployment": {
    "build": {
      "identifier": "ticketer-light » ticketer-light-feature-branches » REL-4.4.0 REL-4.4.0.3",
      "branch": "REL-4.4.0",
      "number": "3",
      "buildTime": "2022-10-06 09:35:42",
      "deploymentTime": "2022-10-06 10:18:48"
    }
  },
  "authConfig": {
    "contextPath": "ticketer-light",
    "userProfileUrl": "https://qanova.errigal.com/userprofile",
    "redirectUri": "https://qanova.errigal.com/ticketer-light/callback",
    "clientId": "0f59ca3a-353c-11eb-b954-0242ac110002",
    "gatewayUri": "https://qanova.errigal.com/ticketer-light-gateway"
  },
  "googleAnalyticsConfig": {
    "siteId": "UA-158352259-10"
  },
  "proxyConfig": {
    "proxyApiUrl": "https://qanova.errigal.com/idms-proxy/api/v0"
  },
  "snmpConfig": {
    "emsUrl": "https://qanova.errigal.com/SnmpManager/errigalEMS",
    "snmpManagerUrl": "https://qanova.errigal.com/SnmpManager"
  },
  "ticketerConfig": {
    "ticketerUrl": "https://qanova.errigal.com/Ticketer",
    "analyticalReportUrl": "https://qanova.errigal.com/bubble-app",
    "privateSalt": "BPVD05c3bvNYjntvfdhJLp2Xx4pH",
    "demarcationEnabled": false,
    "multiTenancy": false,
    "kanbanEnabled": false,
    "networkIdEnabled": true,
    "siteIdEnabled": false,
    "ticketerWorkbenchTimezone": "utc",
    "ticketerWorkbenchTimezoneOffset": 0
  },
  "commonHeaderConfig": {
    "headerUrl": "https://qanova.errigal.com/errigal-common-header/",
    "config": "atc",
    "version": "2.0",
    "css": "style.css",
    "suiteName": "IDMS - Demo Instance -",
    "appName": "Ticketer Lite"
  },
  "casConfig": {
    "casUrl": "https://qanova.errigal.com/cas",
    "casCheck": false,
    "casCheckInterval": 10000
  },
  "hotJarConfig": {
  "hotJarEnabled": false,
  "hotJarSiteId": 0,
  "hotJarSnippetVersion": 6
  }
}

Ansible Playbooks

ansible-playbook -i ../env-configuration/ENV/hosts.ini --diff --vault-id @prompt ticketer.yml --extra-vars "jenkins_build_name='ticketer-feature-branches/job/BRANCH' jenkins_job_build_num=NUM actions='upload,configure,deploy,stop,start'"

ansible-playbook -i ../env-configuration/ENV/hosts.ini --diff --vault-id @prompt idms-proxy.yml --extra-vars "jenkins_build_name='idms-proxy-feature-branches/job/BRANCH' appFileExtension='.jar' jenkins_job_build_num=NUM actions='upload,stop,deploy,configure,start'"

ansible-playbook -i ../env-configuration/nova/hosts.ini --diff --vault-id @prompt ticketer-light.yml --extra-vars "jenkins_build_name='ticketer-light-feature-branches/job/branchName' jenkins_job_build_num=buildNumber actions='upload,configure,deploy'"

ansible-playbook -i ../env-configuration/ENV/hosts.ini --diff --vault-id @prompt ticketer-light-gateway.yml --extra-vars "jenkins_build_name='ticketer-light-gateway-feature-branches/job/BRANCH' jenkins_job_build_num=NUM appFileExtension='.jar' actions='upload,stop,deploy,configure,start'"

Jenkins Build

Project Documents

For further information see requirements documentationhere

OAuth2 and CAS Integration

Userprofile is acting as the authentication server for OAuth2, and also integrated with CAS to login to IDMS.

Implementation of an authentication service (AuthService) did the following:

  • Issue a request to the Authentication server to retrieve an authentication token in JWT format.
  • Issue a request to the CAS server to login to IDMS and generate CAS TGT and cookies
  • Save token to browser session storage in the format:
    • access_token
    • token_expires_at
    • CAS cookies

Implementation of an verifier service (AuthVerifierService) did the following:

  • Generate auth token verifier hash
  • Generate auth request parameters

Decode received result using jwt decoder. Implementation of AuthGuard to detect:

  • user authentication
  • Token expiration and refresh

Implementation of a callback component in the angular front end once authenticated had been granted.

User Permission Control

User permissions for mobile are set up and managed via the User Profile Application.

See also documentation for details.

Main Screens

View 1: Login(in Userprofile)

View 2: Ticket List, Search, History

View 3: Ticket Details

View 4: Ticket Details - Attachments Popup

View 5: Ticket Details - Email Popup

View 6: Ticket Details - Ticket History Popup

View 7: Ticket Details - Ticket History Popup

View 8: Ticket Details - Manage Owners Popup

View 9: Ticket Details - Follow Up Popup

View 10: Ticket Details - Ticket Group Popup

View 11: Ticket Details - Contact Details Popup

View 13: Ticket Forms

View 14: Create Ticket

View 15: My Profile

View 16: Alarm Details Pop up on ticket

View 17: Device Details Pop up on ticket


Google Analytics

User actions are tracked via Google Analytics.

development/applications/ticketer_lite.1665574473.txt.gz · Last modified: 2022/10/12 12:34 by 10.91.110.100