Construction Subcontract Management

osop_version: "1.0"
id: "construction-subcontract"
name: "Construction Subcontract Management"
description: "GC posts scope → subs bid → evaluate → award → milestones → payment."

nodes:
  - id: "post_scope"
    type: "human"
    subtype: "input"
    name: "GC Posts Scope of Work"
    description: "Detailed scope, drawings, schedule, insurance requirements."

  - id: "sub_bids"
    type: "human"
    subtype: "input"
    name: "Subcontractors Submit Bids"
    description: "Itemized bids with labor, materials, timeline, and qualifications."
    timeout_sec: 604800

  - id: "bid_evaluation"
    type: "human"
    subtype: "review"
    name: "Bid Evaluation"
    description: "Compare bids on price, past performance, safety record, capacity."

  - id: "contract_award"
    type: "human"
    subtype: "review"
    name: "Contract Award"
    description: "Issue subcontract agreement with bonding and insurance requirements."
    security:
      approval_gate: true

  - id: "milestone_tracking"
    type: "system"
    name: "Milestone Tracking"
    description: "Track progress against schedule: rough-in, inspection, punch list."

  - id: "payment_completion"
    type: "api"
    name: "Payment on Completion"
    description: "Release progress payment upon milestone sign-off, retain percentage."
    security:
      risk_level: "high"

edges:
  - from: "post_scope"
    to: "sub_bids"
    mode: "sequential"
  - from: "sub_bids"
    to: "bid_evaluation"
    mode: "sequential"
  - from: "bid_evaluation"
    to: "contract_award"
    mode: "sequential"
  - from: "contract_award"
    to: "milestone_tracking"
    mode: "sequential"
  - from: "milestone_tracking"
    to: "payment_completion"
    mode: "conditional"
    when: "milestone.approved == true"
  - from: "payment_completion"
    to: "milestone_tracking"
    mode: "loop"
    when: "project.complete == false"