API Design
APIs sollten alle per CQRS funktionieren, nicht mehr mit REST.
Also nur noch "fachliche" routen. GET für Requests und POST für Commands.
Alle anderen HTTP Verben werden nicht mehr verwendet.
HTTP Status codes überdenken. Not Found z.B. darf nicht zurück gegeben werden, wenn ein Item (fachlich) nicht gefunden wurde, sondern nur wenn die Route nicht existiert. Im Falle eines nicht findens, sollte in der Rückmeldung des Controllers stehen: "Item with id xxxx was not found".
Das SDK sollte dies erkennen und dann eine "NotFoundException" zurück geben.
Submit und Edit models sollten alle überarbeitet werden (ohne Vererbung, um Pflege der Properties zu sparen)
Beim API POST und PUT dürfen niemals Entities auftauchen, sondern nur die Submitmodels, die auch Sinn machen.