Users api updates (#242)

* Updates based on discussion on wednesday meeting

* API tags for ORIS and CUS endpoints, extracted schemas for various types

* returned birthCertificateNumber, reorganized Licences

* email and phone are required for Contact (#3, #4), added missing natinality for user edit #4

* documented compact and full views of User details in GET /users endpoint

* added `archived` parameter to `GET /users`

* added authorization grants for endpoints + description how authorization works in Klabis API

* /users renamed to /members to follow naming conventions + reworked registration/deregistration of member APIs

* /users renamed to /members to follow naming conventions + reworked registration/deregistration of member APIs

* unified gender vs `sex` in favor of `sex` (as gender seems to the one representing  many other variants while we are interested only in "biological" 2)

* little naming fix

* Fixed Security configuration

* deregistration -> membership suspension

* added endpoint to retrieve information if account can be suspended

* GET /memberRegistrations endpoint replaced by GET /registrationNumber and GET /oris/userInfo/{orisId}

* PUT /members/{memberId} changed to PUT /members/{mamberId}/changeMemberInfo

* cleanups in names + extracted type for membership suspension blockers values

* added bodies for error responses

* HTTP 400 error attribute `errors` renamed to `validationErrors`