It's clear from your comment you've not actually used the thing you are criticizing. Nothing about the spec necessitates duplicating your DB schema. In terms

It's clear from your comment you've not actually used the thing you are criticizing. Nothing about the spec necessitates duplicating your DB schema. In terms of the data models, you only need to spec out models based on what you want returned. It's perfectly fine to have limited data models for only what's being requested in a specific use case.