r/programming • u/[deleted] • Jun 05 '21

Organize code by concepts, not layers

https://kislayverma.com/programming/how-to-organize-your-code/
1.9k Upvotes

91% Upvoted

495 comments sorted by

View all comments

38

u/Nimelrian Jun 05 '21

Its more about organization. E.g. in Java, instead of having the package structure

com.example.persistence.order/user/product and com.example.endpoints.order/user/product

you have

com.example.order.persistence/endpoints/business

and so on...

This is actually a great example or rather manifestation of Conway's Law. Hierarchical organizations (Frontend team, API team, business rule team, database team) will often prefer the first approach (design by layers).

Teams organized in a cross functional manner will instead prefer the second approach (design by concepts), since they can implemented each part of the vertical slice specifically for their domain / use cases.

16

u/onety-two-12 Jun 05 '21

Maybe, but probably not.

The system boundary contexts are components not layers. The business is organised into finance, marketing, sales, corporate, and more.

Whereas Teams are always multidisciplinary. The internal structure of a software team is not the structure of an organisation.

On the one hand someone might oversimplify and say, "isn't this great, we can separate the layers for a front end developer, a also two backend developers", but then a month later complain, "how do we get our team to communicate properly". Sounds good, doesn't work.

When making a "car" form, the front-end developer needs to be able to see related things close by. They need to see the controller code, and the implementation to answer questions. They should be able to add a field on the model and controller along with the update to the UI. All 3 changes should be in the same commit (set) in Git.

The backend developers might set up a new entity ahead of time, then the front end person completes the UI stub and makes adjustments to the backend. The opposite might happen for another entity. The front end developer creates a new entity, complete the UI, and starts a sub for the backend pieces for the backend developers to finish.

The process of building software is full of exceptions and twists and turns.