impl-azercell

Base Azercell mWallet Implementation

Development ruless

Follow the rules and patterns described in:

• Composable microservices
• Standard structure of UT microservice module
• Software development rules

Project links

• Skype chat
• Continuous Integration (Jenkins)
• Continuous Deployment (Azure DevOps)
• Static Code Analysis (SonarQube)
• Error aggregator (Sentry)

Staging environment

• Platform Administration Portal
• Self Service Portal
• Unified Solutions Portal
• API
• Log console
• Metrics (Grafana)
• Logs (Kibana)
• Logs (Loki)
• Graph(Kiali)

Development tasks

The instructions below assume VSCode is being used for development...

Install recommended extensions

This project Includes a list of VSCode recommended extensions. Press F1 and type show recommended extensions, then install all the extensions listed in workspace recommendations.

Create a configuration file

Put a file named .ut_mwallet_devrc in project folder or in your home folder. The file has the following recommended structure:

db:
  connection:
    server: database-server
    database: impl-mwallet-firstname-lastname
    user: firstname.lastname
    password: secret-password
  create:
    user: user-that-can-create-db
    password: password-for-the-above-user
utAudit:
  db:
    connection:
      server: database-server
      database: impl-mwallet-firstname-lastname-audit
      user: firstname.lastname
      password: secret-password
    create:
      user: user-that-can-create-db
      password: password-for-the-above-user
utHistory:
  db:
    connection:
      server: database-server
      database: impl-mwallet-firstname-lastname-history
      user: firstname.lastname
      password: secret-password
    create:
      user: user-that-can-create-db
      password: password-for-the-above-user
utEmail:
  settings:
    auth:
      user: email-account-user
      pass: email-account-password

Create the database

Use the DB run configuration to create the database.

Build the production front end

Use npm run build to create the front end for the 3 portals

Serve front end with hot reload

Use npm run start to start webpack-dev-server which will build the front end and monitor it for hot reload.

You need to run also the appropriate launch configuration to start the back end.

When using webpack dev server, portal links and their corresponding back ends are:

• http://localhost:5000/a/browser/admin.html + Admin portal
• http://localhost:5000/a/browser/solution.html + Solution portal
• http://localhost:5000/a/browser/service.html + Service portal

Run the back end server

Use one of the XXX portal run configuration to run the respective portal back end

Run automated tests locally

• To run automated tests, make sure you have configuration file .ut_mwallet_testrc in the project or home folder that points to appropriate databases.
• Use the Integration test create db run configuration to create the databases used for tests, if required.
• Use the Integration test run configuration to run the tests. This will prompt for one of the parallel test jobs to be selected. This run configuration is trying to be as close as possible to the way tests are run in Jenkins.
• Use the Integration test single run configuration then type the name of test you need to run.

Jenkins

This project will be automatically discovered by Jenkins and build jobs will be created for each branch or merge request.

All the created jobs are available here.

Project configuration

"utWallet": {
    "project": {
        "mainOrganization": {
            "name": "XXXX",
            "countryCode": "BG"
        }
    }
}

• mainOrganization - object to configure default main business unit settings
  • name - name of default business unit
  • countryCode - ISO 3166-1 alpha-2 country code - assigned to default BU