Closes #2764

Description

This PR updates the Agora product in the monorepo to adopt specification-first development workflow. From now on, the API client for Angular will be automatically generated with OpenAPI Generator. Same goes for the API docs site using Redocly. A reverse proxy (Caddy) is added to the stack to redirect the traffic to different components (web app, REST API, and docs site).

Cc: @sagely1, @JessterB, @jay-hodgson

Changelogs

• Replace the existing project agora-api-client-angular using model-ad-api-client-angular as a template
• Add the project agora-api-docs
• Add several Angular library projects: styles, themes, ui, utils, config
• Add the Angular library project for the not-found page
• Rename the project agora-server to agora-api
• Rename the path /api by /v1 in agora-api
• Add the project agora-apex (reverse proxy)
• Update the docker compose files of Agora to deploy the new components

Preview

API Client for Angular

Let's assume that the API specification of Agora has been updated and build:

nx build agora-api-description

We can now update the API client for Angular with OpenAPI Generator:

nx run agora-api-client-angular:generate

That's it! The API client for Angular is ready to be imported in a web app project developed in the monorepo.

REST API service

Send a request directly to the API service:

$ curl agora-api:3333/v1/dataversion
{"_id":"66c64b2e18e5adec7e3894d4","data_file":"syn13363290","data_version":"68","team_images_id":"syn12861877"}

Send the request via the reverse proxy (the "apex" component):

$ curl agora-apex:8000/api/v1/dataversion
{"_id":"66c64b2e18e5adec7e3894d4","data_file":"syn13363290","data_version":"68","team_images_id":"syn12861877"}

Web App

Navigate to localhost:8000 and you will be redirected to the only page of the app.

Note that the page includes data from the REST API.