Have a look at this [InfoQ article](https://www.infoq.com/articles/architecting-java-persistence-patterns-and-strategies/). We need to have something in this tone describing our approach and why we do things the way we do.