Describe the enhancement requested

We need to have a focused discussion on the overall architecture of the Java repository. While we’ve had preliminary conversations in comments (#738, #739), those discussions lack a consolidated summary and clear direction.

To move forward, we should revisit key architectural details, and ultimately produce a design document that will guide the development of remaining work.

Component(s)

Java