A catbuffer-generator should be used to avoid duplicated structures

[segfaultxavi]

Things like EntityDTO are already described in a catbuffer-schema.

We could avoid this redundancy by generating parts of the OpenAPI spec from the schemas using an openapi-generator. In this way we keep a single source of truth.

As a bonus, that would import the docs too \o/

[fboucquez]

This issue is related to https://github.com/symbol/catbuffer-schemas/issues/2

I did a bit of research, catbuffer schemas don't match the mongo collections completely, and the open API spec follows the mongo collections, not the catbuffer schemas. You will have mismatches as described in the schema issue

[segfaultxavi]

Ah, nice to see there's already some research into this!

I'll continue the discussion there.

[fboucquez]

Maybe we can generate the basic types or some entities, and manually create the mismatched ones. Also, there is information not found in catbuffer that can appear in open API, for example, the meta fields.