Fix spec
- fixes the spec in order to be valid open-api
- extends the ci-pipeline to verify validity
- adds tooling for local development
- not yet: bundled api is not published or pushed, should be done after the gitlab upgrade
WARNING! Gitlab maintenance operation scheduled for Thursday, 7 May between 12:00 and 14:00 (CET). During this time window, short service interruptions (less than 5 minutes) may occur. Thank you in advance for your understanding.