feat: replace required attribute on @Schema by requiredMode

[nvervelle]

Add a property requiredMode on @Schema annotations that allows deciding if the heuristics on annotations like @NotNull should apply, so we can have a property annotated @NotNull but still have required = false in the openapi spec.

This is a second proposal for issue #4213, other proposal was #4216