Přeskočit na hlavní obsah

Getting started

Getting started​

In this document you will find all necessary information about setting up your development environment and application.

This consists of several steps:

  1. AVAplace account creation/registration on a desired environment(s)
  2. Application registration and development environment setup
  3. Setting up application configuration in the application project
  4. Setting up package feed to obtain all necessary packages for front-end and back-end functionality

Environments:​

There are several development environments

Initialize your user accounts​

  • Registration on AVAplace demo stage
    • Anonymously or by invitation (you must contact the tenant's administrator)
    • Wait for completed registration process

Register your application into DevOps and start development​

You need Product manager role to this.

On "Management" / "Store editor" page make your application registration.

  1. Open DevOps application on https://demo.avaplace.com and switch into "Management" > "Store editor"
  2. Make your application registration
    • If you have an account with access to multiple different tenants - make sure that the correct tenant of the application manufacturer is used to register the application.
  3. Click Save draft button to persist your application.
  4. Click Release button to confirm your application and create GIT repository for you.
    • This process take a few minutes, please be patient.
  5. In DevOps application switch into "Development" > "Applications" and search your new application.
  6. Switch to GIT tab and click Generate access token button.
    • This is needed only for the first time and again when your token expires (lifetime for GIT token is 6 months)
    • Remember generated token and user name showed in dialog.
  7. Open your installed developer tools.
  8. Clone git repository from URL which you see on GIT tab in DevOps application.
    • Use User name from point 2.
    • Use Token from point 6. as your git password.
  9. Git checkout develop branch and pull latest changes.
    • The next step is in the readme.md file inside git.
  10. To start development, follow the steps in the readme.md file generated on your application GIT repository.

Example secrets.json for local development​

Example:

{
  "ConnectionStrings": {
    "AppDbConnectionString": "Your localhost database server connection string."
  },
  "SsoAuth": {
    "Authority": "https://alpha.avaplace.com/api/asol/idp",
    "ClientId": "Your Client Id for alpha.avaplace.com",
    "ClientSecret": "Your Client Secret for alpha.avaplace.com"
  },
  "Messaging": {
    "RabbitMq": {
      "HostName": "localhost",
      "UserName": "guest for localhost RabbitMQ",
      "Password": "guest for localhost RabbitMQ",
    }
  }
}

Backend architecture overview​

images/BE-service-arch.png

Backend native application solution clean architecture​

images/BE-service-clean-arch.png

Nuget and NPM feeds​

Once your application - project is ready for development, you will need packages/libraries which will provide a necessary functionality for your application.

These are available at: