Share via


Be careful of the 'stack' diagram

I'm always a little leery of a stack diagram that shows 'systems' living at some level of the stack.  For example, a diagram that shows a series of different application user interfaces at the U/I layer, and then workflow services somewhere further down the stack. 

What makes me leery is the fiction of the diagram.  Yes, workflow services are called by the business layer of an application, and we want to make it clear where that integration lies.  But a workflow system has a user interface, middleware, and database.  It is an application in its own right, and if we were looking at a diagram of the workflow system, we'd see components living at every level of the stack.

Therefore, while the Integration to a workflow system may live at a particular level of the stack, the workflow system  itself is not at that level of the diagram.   

I guess I'm just a little cautious of these diagrams.  I'm supposed to be communicating to developers and other folks.  How well am I communicating if it isn't clear that the service interface is simply an integration end point?

SQL Server has the same issues yet I don't mind that one.  Not sure why.  Perhaps I'm just not used to seeing systems that don't provide an entire layer. 

Your opinion?