Simplified Process With Symfony Workflow

These slides were presented on Symfony Conference 2023, in Brussels.

Transcript

1. Simplified Processes With Symfony Workflow
2. Who Am I? I am Brazilian but living in Ireland I am a Symfony Lover ❤ You can find me at @Bruno_HSouza on Twitter Or @bruno7strings on Instagram
3. AGENDA What Is a Process and Symfony Workflow? How to use Symfony Workflow? Workflow VS State Machine? The Real Case Scenario Generating Graphs Automatically
4. What is a Process? A set of interrelated actions and activities performed to achieve a specified set of products, results, or services. A Guide to the Project Management Body of Knowledge (PMBOK® Guide). Project Management Institute, 2017
5. 1 2 3 4 5 Enjoy The Talks Arriving in the event venue Get a Transport Get Out From Home How To Get To The Symfony Con 2023? The Steps Of The Going Process Select Your Room
6. What is the Symfony Workflow? A workflow is a model of a process in the application
7. What is the Symfony Workflow? A workflow is a model of a process in the application Consists of places and actions to get from one place to another
8. What is the Symfony Workflow? A workflow is a model of a process in the application Consists of places and actions to get from one place to another Terminology definition: Place - step or stage in the process Transition - is the action of getting from one place to another Definition - set of places and transactions Marking - current state position Marking Store - a place to store the state
9. Init Transition Start Place A Symfony Workflow Terminology Transition 2 Place B Transition 3
10. Place Trans ition Place Trans ition Place Enjoy The Talks Select Your Room Arriving in the event venue Get a Transport Get Out From Home How To Get To The Symfony Con 2023? The Symfony Workflow Terminology
11. Place Trans action Place Trans action Place Enjoy The Talks Select Your Room Arriving in the event venue Get a Transport Get Out From Home How To Get To The Symfony Con 2023? The Symfony Workflow Terminology Marking
12. Place Trans action Place Trans action Place Enjoy The Talks Select Your Room Arriving in the event venue Get a Transport Get Out From Home How To Get To The Symfony Con 2023? The Symfony Workflow Terminology Definition
13. How To Use The Symfony Workflow? How to install and configure the component in our applications
14. Installation
15. How to find the Workflow service class in the project?
16. The Symfony Workflow configuration options To know all the configuration options from the component:
17. The config:dump-reference workflows response
18. Workflow VS State Machine What is the difference between the workflow and state machine types?
19. Workflow VS State Machines Workflows can be in more than one place at the same time, the multiple-state terminology
20. Workflow VS State Machines Workflows can be in more than one place at the same time, the multiple-state terminology The state machine uses the single-state terminology. The order can be only in a single place per time
21. Workflow VS State Machines Workflows can be in more than one place at the same time, the multiple-state terminology The state machine uses the single-state terminology. The order can be only in a single place per time To apply a transition, workflows require that the object is in all the previous places of the transition
22. Workflow VS State Machines Workflows can be in more than one place at the same time, the multiple-state terminology The state machine uses the single-state terminology. The order can be only in a single place per time To apply a transition, workflows require that the object is in all the previous places of the transition To apply a transition, state machines only require that the object is at least in one of those previous places
23. MarkingStoreInterface
24. MarkingStoreInterface
25. The main difference is the way that Symfony Workflow stores the place data: Workflow: App\Entity\SalesOrder::getCurrentPlace(): ?array State Machine: App\Entity\SalesOrder::getCurrentPlace(): ?string The difference between workflow and state machine
26. The Real Case Scenario How we are using the Symfony Workflow in our projects?
27. >= 22 valid status More than 7 applications involved More than 5 different scenarios 2 of the main applications are using Symfony Workflow Let’s talk about the entry application The sales order flow in the company
28. 1 Sales Order Creation Request 2 Order Validation 3 Accepted 4 Persist the Order 7 Complete 6 Processing 5 Send to the next application The Sales Order Flow The happy path for the order flow in the entry application
29. The Symfony Workflow Definition
30. The Symfony Workflow Transitions
31. The Symfony Workflow Dependency Injection
32. The Symfony WorkflowInterface
33. The Symfony Workflow Use Case
34. The Symfony Workflow Use Case
35. The DDD Structure How to apply the Symfony Workflow in a DDD architecture
36. The DDD archicteture
37. DON’T TALK TO ME OR MY DOMAIN EVER AGAIN The DDD archicteture Evans, E. (2004) Domain-Driven Design. p. 70 DDD only really requires one isolated layer which is the Domain Layer. The "domain layer" is the manifestation of the domain model and all directly related design elements.
38. The DDD archicteture
39. The DDD archicteture
40. The DDD archicteture
41. Generating graphs How to use the Symfony Workflow to generate graphs automatically
42. It is possible to generate a visual representation of them as SVG or PNG images using: Graphviz, provides the dot command; Mermaid CLI, provides the mmdc command; PlantUML, provides the plantuml.jar file (which requires Java). Generating graphs
43. Generating graphs
44. From the Symfony 6.4 version, it is possible to use some metadata tags to style the workflow graphs: for places: bg_color: a color; description: a string that describes the state. for transitions: label: a string that replaces the name of the transition; color: a color; arrow_color: a color. Generating graphs - Stylish
45. Generating graphs - Stylish
46. Generating graphs - Stylish
47. Generating graphs - Stylish
48. Thank You!