Issue #168: OpenAPI documentation

[alexmerlin]

Note

• calling $this->created(); from all entities because Psalm complained about $this->created not being initialized from anywhere
• role(s) must be set when super/admin creates a user (instead of assigning default user role as before) - when users register their account, default role user is automatically assigned, as before
• prevented MySQL error thrown on getCollection routes if sortBy field's value does not exist as a column in the database

Usage

Default:

vendor/bin/openapi src

Specify output file path:

vendor/bin/openapi src -o public/openapi.yaml

Specify OpenAPI version (default is 3.0.0):

vendor/bin/openapi src -o public/openapi.yaml --version 3.1.0