Archflow
Guides

Mapping Workflows

Connect outcome-oriented runtime journeys to architecture and behavior evidence

Workflows bridge stakeholder outcomes and technical implementation. They are also the dynamic evidence used by Coupling and Blast Radius.

1. Choose One Outcome

Good candidates include “Place order,” “Onboard customer,” “Publish content,” or “Recover failed payment.” Avoid combining unrelated journeys in one workflow.

Define the trigger, success outcome, criticality, and important failure or compensation paths before opening the canvas.

2. Add Ordered Steps

Each step should describe one meaningful action or decision and map to the architecture element responsible for it.

StepElementBehavior evidence
Submit orderCheckout APISubmitOrder command
Reserve inventoryInventory Servicereservation policy and state
Authorize paymentPayment Adapterpayment request and result event
Confirm orderOrders ServiceOrderConfirmed event

3. Build It In Archflow

  1. Open Model → Workflows and create the Workflow.
  2. Open its canvas and add the ordered steps.
  3. Map every step to its responsible System, Container, Component, or Block.
  4. Connect steps and model meaningful decisions.
  5. Save and review the complete path in read mode.

Where a transition uses an existing static Relationship, attach that Relationship. If no suitable Relationship exists, decide whether the static model is incomplete or the transition represents behavior inside one boundary.

Connect important steps to Behavior Model nodes. Capture whether the linked item occurs before, during, or after the step and add a relation note when necessary.

6. Review Analysis

  • Coupling reveals workflow co-activity without matching static intent.
  • Blast Radius shows journeys likely to degrade when an element fails.
  • Explorer traffic simulation animates the simplified path under chosen assumptions.

These tools depend on the quality and scope of the workflow. A broad “everything happens” workflow creates noisy evidence.

7. Use It In Documentation

Select relevant Workflows in a View's documentation area and include them in publication. Keep implementation minutiae out of the stakeholder journey; use Behavior Model or Architecture Documents for deeper detail.

On this page