Architecture changes over time and it is not easy to keep the documentation up-to-date. As a result you get an invalid description of your architecture.
One of the hidden gems of Spring Data JPA is the possibility to put your query results directly into a DTO instead of having it transformed by a mapper
How to create a JPA base entity without mapping it onto a separate table
How to change the decimal separator without changing the representation in the Postgres database