Work & Supply Network — network map

Generated by python -m codegen.cli network-docs work_supply from networks/work_supply/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"]
  inventory["inventory"]
  asset_register["asset_register"]
  asset_lifecycle["asset_lifecycle"]
  warranty["warranty"]
  assurance["assurance"]
  catalogue["catalogue"]
  supplier["supplier"]
  sap_ap["sap_ap"]
  purchasing["purchasing"]
  asset_lifecycle -- "life_due" --> assurance
  asset_register -. "record_usage" .-> asset_lifecycle
  asset_register -- "component_installed<br/>component_removed" --> asset_lifecycle
  asset_register -- "component_installed<br/>component_removed" --> warranty
  assurance -. "create_work_order" .-> work_management
  assurance -- "obligation_assigned" --> work_management
  inventory -. "register_asset" .-> asset_register
  inventory -. "create_requirement" .-> purchasing
  inventory -- "goods_arrived<br/>item_unavailable<br/>receipt_accepted<br/>receipt_quarantined<br/>receipt_rejected" --> purchasing
  inventory -- "receipt_quarantined<br/>receipt_rejected" --> sap_ap
  inventory -- "receipt_rejected" --> supplier
  inventory -- "item_reserved<br/>item_unavailable" --> work_management
  purchasing -- "delivery_delayed" --> assurance
  purchasing -. "record_goods_arrival" .-> inventory
  purchasing -- "delivery_commitment_changed<br/>shipment_dispatched" --> inventory
  purchasing -. "post_purchase_commitment" .-> sap_ap
  purchasing -- "order_placed" --> sap_ap
  purchasing -- "delivery_delayed<br/>order_placed" --> supplier
  purchasing -- "delivery_commitment_changed<br/>delivery_delayed<br/>requirement_created" --> work_management
  sap_ap -- "invoice_match_exception" --> assurance
  sap_ap -- "purchase_commitment_posted" --> purchasing
  sap_ap -- "supplier_credit_memo_posted" --> warranty
  supplier -- "issue_opened" --> assurance
  supplier -. "dispatch_shipment<br/>record_supplier_commitment" .-> purchasing
  supplier -. "register_supplier_credit_memo<br/>register_supplier_invoice" .-> sap_ap
  supplier -. "record_claim_decision" .-> warranty
  warranty -- "claim_decided" --> assurance
  warranty -. "register_supplier_credit_memo" .-> sap_ap
  warranty -- "candidate_detected" --> work_management
  work_management -. "record_component_installation<br/>record_component_removal" .-> asset_register
  work_management -- "component_removed" --> asset_register
  work_management -. "release_reservation<br/>reserve_for_work" .-> inventory
  work_management -- "material_requirement_changed<br/>material_requirement_created" --> inventory
  work_management -. "create_requirement" .-> purchasing
  work_management -. "evaluate_candidate" .-> warranty
  work_management -- "work_closed" --> warranty
  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

R1 — Material unavailable — Work is held, Purchasing raises a requirement

sequenceDiagram
  participant work_management as work_management
  participant O as Orchestrator
  participant inventory as inventory
  participant purchasing as purchasing
  work_management->>O: work.material_requirement_created
  O->>inventory: deliver
  inventory->>O: inventory.item_unavailable
  O->>work_management: deliver
  O->>purchasing: deliver
  purchasing->>O: purchasing.requirement_created
  O->>work_management: deliver
  work_management->>O: work.material_requirement_changed
  O->>inventory: deliver

R1b — Supplier commits a delivery date — Work and Inventory know when to expect it

sequenceDiagram
  participant purchasing as purchasing
  participant O as Orchestrator
  participant supplier as supplier
  participant sap_ap as sap_ap
  participant work_management as work_management
  participant inventory as inventory
  participant assurance as assurance
  purchasing->>O: purchasing.order_placed
  O->>supplier: deliver
  O->>sap_ap: deliver
  purchasing->>O: purchasing.delivery_commitment_changed
  O->>work_management: deliver
  O->>inventory: deliver
  purchasing->>O: purchasing.delivery_delayed
  O->>work_management: deliver
  O->>assurance: deliver
  O->>supplier: deliver

R1c — Goods arrive and are accepted — the held reservation is filled and the work order can proceed

sequenceDiagram
  participant purchasing as purchasing
  participant O as Orchestrator
  participant inventory as inventory
  participant work_management as work_management
  purchasing->>O: purchasing.shipment_dispatched
  O->>inventory: deliver
  inventory->>O: inventory.goods_arrived
  O->>purchasing: deliver
  inventory->>O: inventory.receipt_accepted
  O->>purchasing: deliver
  inventory->>O: inventory.item_reserved
  O->>work_management: deliver
  work_management->>O: work.material_requirement_changed
  O->>inventory: deliver

R1d — Purchase to pay — commitment, invoice matched against the accepted receipt, AP posted, paid

sequenceDiagram
  participant purchasing as purchasing
  participant O as Orchestrator
  participant supplier as supplier
  participant sap_ap as sap_ap
  purchasing->>O: purchasing.order_placed
  O->>supplier: deliver
  O->>sap_ap: deliver
  sap_ap->>O: finance.purchase_commitment_posted
  O->>purchasing: deliver
  sap_ap->>O: finance.invoice_received
  sap_ap->>O: finance.invoice_match_completed
  sap_ap->>O: finance.ap_posted
  sap_ap->>O: finance.payment_status_changed

R11a — Component failure to warranty recovery — removal, life exposure, candidate, claim, credit memo

sequenceDiagram
  participant work_management as work_management
  participant O as Orchestrator
  participant asset_register as asset_register
  participant asset_lifecycle as asset_lifecycle
  participant warranty as warranty
  participant assurance as assurance
  participant sap_ap as sap_ap
  work_management->>O: work.component_removed
  O->>asset_register: deliver
  asset_register->>O: asset.component_removed
  O->>asset_lifecycle: deliver
  O->>warranty: deliver
  warranty->>O: warranty.candidate_detected
  O->>work_management: deliver
  warranty->>O: warranty.candidate_eligible
  warranty->>O: warranty.claim_submitted
  warranty->>O: warranty.claim_decided
  O->>assurance: deliver
  warranty->>O: warranty.recovery_approved
  sap_ap->>O: finance.supplier_credit_memo_posted
  O->>warranty: deliver
  warranty->>O: warranty.recovery_received

R11b — Selective governance — a material event becomes an accountable exception, its obligation reaches Work

sequenceDiagram
  participant supplier as supplier
  participant O as Orchestrator
  participant assurance as assurance
  participant work_management as work_management
  supplier->>O: supplier.issue_opened
  O->>assurance: deliver
  assurance->>O: governance.exception_created
  assurance->>O: governance.decision_made
  assurance->>O: governance.obligation_assigned
  O->>work_management: deliver
  assurance->>O: governance.verification_completed
  assurance->>O: governance.exception_closed

R2 — Material reserved from stock

sequenceDiagram
  participant work_management as work_management
  participant O as Orchestrator
  participant inventory as inventory
  work_management->>O: work.material_requirement_created
  O->>inventory: deliver
  inventory->>O: inventory.item_reserved
  O->>work_management: deliver
  work_management->>O: work.material_requirement_changed
  O->>inventory: deliver