# C4 Model — Level 1: System Context.
# Fleet Mission Control in relation to its one human user and the systems it depends on.
# Rendered to c4-context.svg via: d2 docs/diagrams/c4-context.d2 docs/diagrams/c4-context.svg
direction: down

andrew: {
  shape: person
  label: "Andrew\n(fleet operator)"
}

fmc: {
  label: "Fleet Mission Control\n[Software System]\nRead-only status wall + gated\ncommand plane for the home fleet"
  shape: rectangle
  style.multiple: false
}

dispatch: {
  label: "fleet-dispatch\n[External System]\nFile-queue job runner on\nevery fleet PC"
}

governor: {
  label: "usage-governor\n[External System]\nLocal usage-tier tracker\n(state.json)"
}

agy: {
  label: "agy quota ledger (FLT-15)\n[External System]\nAppend-only spend ledger\n(agy-ledger.jsonl)"
}

jira: {
  label: "Jira Cloud\n[External System]\nFLT project board"
}

scanner: {
  label: "repo-inventory scanner\n[External System, planned]\nSigns per-PC repo inventory\n(not built in this repo)"
  style.stroke-dash: 4
}

listeners: {
  label: "Fleet PCs\n[External System]\nrun_agent / design-run\nexecuting listeners"
}

andrew -> fmc: "views status, launches/cancels\nruns, toggles availability\n(HTTPS, tailnet or localhost)"
fmc -> dispatch: "reads queue/results,\nwrites signed jobs +\navailability override\n(shared file queue)"
fmc -> governor: "reads tier snapshot\n(file read)"
fmc -> agy: "reads spend counts\n(file read, tailed)"
fmc -> jira: "reads FLT board\n(REST, Basic auth, cached 60s)"
fmc -> scanner: "reads signed repo inventory\n(file read; empty until a\nscanner ships)" {style.stroke-dash: 4}
dispatch -> listeners: "drains inbox, executes,\nwrites results"
listeners -> dispatch: "heartbeat + availability\n(gaming/streaming detection)"