Search code examples
umlanalyticsbpmn

BPMN API/Database Diagram, Good practice

For my Master Thesis, I was planning to do some BPMN diagram explaining the differents "flows" between the client, the API and the Database. I've look for similar diagrams in BPMN but I did not find any.

Could anyone tell me if this kind of diagram is good practices? I let an example under :

enter image description here

Solution

  • BPMN diagrams are used for presenting of business processes and does not support well the system level details. This might be a reason why you couldn't find examples close to what you expect.

    UML should be your choice as it offers you a range of diagram types specifically for what you want to achieve.

    Typical choice here would be be Activity Diagram (which would look pretty much similar to your diagram, just some elements would be slightly different - end activity would use a different icon with a black ball inside and decision node will be empty; moreover you'll need a fork/join elements where there are two parallel flows).

    Other option, as good as the previous one, would be a Sequence Diagram. it will be entirely different though. Yet it emphasises the responsibilities of Client, API and Database and how the messages are passed between them.

    If you're less interested in the sequence of messages you may also consider Communication Diagram.