Add OpenAPI to support creating API documentation with OpenAPI

[suho]

Why

The team now has OpenAPI Training Path to learn and practice. OpenAPI on Compass for developers to follow conventions and best practices. NO OpenAPI boilerplates currently exist in the elixir templates to support web developers in creating API documentation with OpenAPI.

Acceptance Criteria

• Only add OpenAPI when create API template (--api)
• Add OpenAPI addon as a required addon in the template.
• Add OpenAPI tooling (Spectral, Elements, Lint).
• Create an endpoint (e.g., GET {{base_url}}/api/docs/openapi) to access the API documentation through the browser.
• Add CI workflow to run linting
• Add Mock Server with Prims (related to this API Mock Server with OpenAPI) as an optional add-on.
• Add CD workflow to deploy mock server to fly.io if the developer select mock server add-on.

Resources

• Add OpenAPI to Web templates
• [#1] As a developer, I can create a mock project based on a template api-mock-templates#3
• https://github.com/nimblehq/nimble-survey-web

Who Benefits?

Everyone

[andyduong1920]

@suho could you update the link for OpenAPI Training Path as the current link show 404 page

[suho]

@andyduong1920 Sorry for the late, I updated the link