Asset Work Network — network map

Generated by python -m codegen.cli network-docs asset_work from networks/asset_work/system.manifest.yaml and the members' integration contracts — do not edit by hand; regenerate after changing either.

Members

Who sends what to whom

Solid arrows are events (publisher → subscriber). Dotted arrows are commands an application is allowed to send (listed in the receiving app accepted_from) — not necessarily traffic today; commands the orchestrator issues are listed in the catalogue only. Every message travels through the orchestrator, which is left out of the map to keep it readable.

flowchart LR
  work_management["work_management"]
  mwem["mwem"]
  haul_road["haul_road"]
  scrm["scrm"]
  msam["msam"]
  psam["psam"]
  fins["fins"]
  ext_asset["asset (not in the network yet)"]:::ext
  ext_catalogue["catalogue (not in the network yet)"]:::ext
  ext_classification["classification (not in the network yet)"]:::ext
  ext_governance["governance (not in the network yet)"]:::ext
  ext_lifecycle["lifecycle (not in the network yet)"]:::ext
  ext_purchasing["purchasing (not in the network yet)"]:::ext
  ext_warranty["warranty (not in the network yet)"]:::ext
  ext_workforce["workforce (not in the network yet)"]:::ext
  ext_asset -- "asset_group_reference_changed<br/>asset_reference_changed<br/>component_reference_changed" --> work_management
  ext_catalogue -- "item_reference_changed" --> work_management
  ext_classification -- "modifier_reference_changed<br/>smcs_reference_changed" --> work_management
  ext_governance -- "obligation_assigned" --> work_management
  ext_lifecycle -- "usage_metric_type_reference_changed" --> work_management
  ext_purchasing -. "record_job_cost" .-> work_management
  ext_warranty -- "candidate_detected" --> work_management
  ext_workforce -- "employee_changed<br/>employee_left<br/>employee_registered<br/>trade_reference_changed" --> work_management
  haul_road -. "post_journal" .-> fins
  haul_road -. "change_reservation<br/>issue_to_work<br/>release_reservation<br/>return_from_work" .-> msam
  haul_road -- "material_requirement_changed<br/>material_requirement_created" --> msam
  haul_road -. "create_requirement" .-> psam
  haul_road -- "material_requirement_changed<br/>material_requirement_created<br/>readiness_changed<br/>work_closed<br/>work_completed<br/>work_started<br/>work_suspended<br/>work_verified" --> scrm
  msam -. "post_journal" .-> fins
  msam -- "item_issued" --> fins
  msam -- "item_issued<br/>item_reserved<br/>item_returned<br/>item_unavailable" --> haul_road
  msam -- "item_issued<br/>item_reserved<br/>item_returned<br/>item_unavailable" --> mwem
  msam -. "create_requirement" .-> psam
  msam -- "item_unavailable<br/>receipt_accepted<br/>receipt_quarantined<br/>receipt_rejected" --> psam
  msam -- "item_issued<br/>item_reserved<br/>item_unavailable" --> work_management
  mwem -. "post_journal" .-> fins
  mwem -. "change_reservation<br/>issue_to_work<br/>release_reservation<br/>return_from_work" .-> msam
  mwem -. "create_requirement" .-> psam
  psam -. "post_journal" .-> fins
  psam -- "delivery_commitment_changed<br/>delivery_delayed<br/>requirement_created" --> haul_road
  psam -- "delivery_commitment_changed<br/>delivery_delayed<br/>requirement_created" --> mwem
  psam -- "delivery_commitment_changed<br/>delivery_delayed<br/>requirement_created" --> work_management
  scrm -. "assign_campaign" .-> mwem
  work_management -. "post_journal" .-> fins
  work_management -. "change_reservation<br/>issue_to_work<br/>release_reservation<br/>return_from_work" .-> msam
  work_management -. "create_requirement" .-> psam
  classDef ext stroke-dasharray: 4 4,color:#888

Message catalogue

Events

Commands

Queries

🔁 published automatically when the record changes · ✅ handler implemented · ⏳ declared, no handler yet (answers handler not found) · 🧪 stub (stands in for an app not built yet)

Entities: ownership and references

Reference flows

A1 — A part is short for fixed plant work - purchasing orders it, it arrives, is reserved, issued and its cost posted

sequenceDiagram
  participant haul_road as haul_road
  participant O as Orchestrator
  participant scrm as scrm
  participant msam as msam
  participant work_management as work_management
  participant mwem as mwem
  participant psam as psam
  participant fins as fins
  haul_road->>O: work.material_requirement_created
  O->>scrm: deliver
  O->>msam: deliver
  msam->>O: inventory.item_unavailable
  O->>work_management: deliver
  O->>mwem: deliver
  O->>haul_road: deliver
  O->>psam: deliver
  psam->>O: purchasing.requirement_created
  O->>work_management: deliver
  O->>mwem: deliver
  O->>haul_road: deliver
  psam->>O: purchasing.order_placed
  psam->>O: purchasing.delivery_commitment_changed
  O->>work_management: deliver
  O->>mwem: deliver
  O->>haul_road: deliver
  msam->>O: inventory.receipt_accepted
  O->>psam: deliver
  msam->>O: inventory.item_reserved
  O->>work_management: deliver
  O->>mwem: deliver
  O->>haul_road: deliver
  msam->>O: inventory.item_issued
  O->>work_management: deliver
  O->>mwem: deliver
  O->>haul_road: deliver
  O->>fins: deliver
  fins->>O: finance.document_posted

A2 — Haul road material is in stock - reserved at once, issued and its cost posted, the work completed and closed

sequenceDiagram
  participant haul_road as haul_road
  participant O as Orchestrator
  participant scrm as scrm
  participant msam as msam
  participant work_management as work_management
  participant mwem as mwem
  participant fins as fins
  haul_road->>O: work.work_order_created
  haul_road->>O: work.material_requirement_created
  O->>scrm: deliver
  O->>msam: deliver
  msam->>O: inventory.item_reserved
  O->>work_management: deliver
  O->>mwem: deliver
  O->>haul_road: deliver
  msam->>O: inventory.item_issued
  O->>work_management: deliver
  O->>mwem: deliver
  O->>haul_road: deliver
  O->>fins: deliver
  fins->>O: finance.document_posted
  haul_road->>O: work.work_completed
  O->>scrm: deliver
  haul_road->>O: work.work_closed
  O->>scrm: deliver

A3 — A late delivery and then a cancelled order - the work application is told the new date, then that none is expected

sequenceDiagram
  participant msam as msam
  participant O as Orchestrator
  participant work_management as work_management
  participant mwem as mwem
  participant haul_road as haul_road
  participant psam as psam
  msam->>O: inventory.item_unavailable
  O->>work_management: deliver
  O->>mwem: deliver
  O->>haul_road: deliver
  O->>psam: deliver
  psam->>O: purchasing.requirement_created
  O->>work_management: deliver
  O->>mwem: deliver
  O->>haul_road: deliver
  psam->>O: purchasing.delivery_commitment_changed
  O->>work_management: deliver
  O->>mwem: deliver
  O->>haul_road: deliver
  psam->>O: purchasing.delivery_delayed
  O->>work_management: deliver
  O->>mwem: deliver
  O->>haul_road: deliver
  psam->>O: purchasing.order_cancelled
  psam->>O: purchasing.delivery_commitment_changed
  O->>work_management: deliver
  O->>mwem: deliver
  O->>haul_road: deliver

S1 — A shutdown follows its work - orders are put in scope and assigned, readiness and progress arrive, the campaign completes

sequenceDiagram
  participant scrm as scrm
  participant O as Orchestrator
  participant haul_road as haul_road
  scrm->>O: campaign.readiness_changed
  haul_road->>O: work.readiness_changed
  O->>scrm: deliver
  scrm->>O: campaign.scope_frozen
  haul_road->>O: work.work_started
  O->>scrm: deliver
  scrm->>O: campaign.milestone_reached
  haul_road->>O: work.work_completed
  O->>scrm: deliver
  haul_road->>O: work.work_closed
  O->>scrm: deliver

S2 — Scope added after the freeze is a change to be decided before the work order is assigned

sequenceDiagram
  participant scrm as scrm
  participant O as Orchestrator
  scrm->>O: campaign.scope_frozen
  scrm->>O: campaign.scope_change_requested
  scrm->>O: campaign.scope_change_decided

H1 — A serious defect is reported - a work order is made for it at once; the segment is closed for wet weather and reopened

sequenceDiagram
  participant haul_road as haul_road
  participant O as Orchestrator
  haul_road->>O: work.defect_recorded
  haul_road->>O: work.work_order_created
  haul_road->>O: work.subject_closed
  haul_road->>O: work.subject_reopened