GFS Platform Flow Diagrams

25 archify-style diagrams · 2 wall-poster canvases + 2 system overviews + 7 active job pillars (4 legacy preserved) + 3 cross-cutting pipelines + 5 workflow refs · Post-R497

Start here: The whole system in one picture

1 diagram · non-engineer friendly · 2026-05-24

If you have 60 seconds and want to understand how Jarvis (our chat) works end-to-end, look at this one diagram. Plain-language labels, top-to-bottom story: your team → chat brain → memory → Mike approves → NetSuite. Designed to print as a wall poster (1800×1300 viewBox). Use this before drilling into anything else.

Wall-poster canvases — orient cold

2 canvases · new 2026-05-24

If you only look at two diagrams, look at these. Both are wall posters at viewBox 1600x1180 designed for non-engineer users (admins, finance, K-12 buyers) to understand the whole system at a glance. Cloudflare Platform Canvas shows every CF service (Worker, D1, R2, KV, Vectorize, Queues, DOs, Workflows, Browser, AI, Email, 22 crons) laid out by category. Software & Services Canvas shows the broader estate — people, surfaces, NetSuite, Cursor, Codex, Anthropic, Dropbox — with auth flows annotated.

Start here — user surfaces

workflow · training · brain dump

Three user-facing surfaces. User Workflow Guide explains what the chatbot can do for each role. Training Surface is how Mike feeds 15 years of GFS knowledge as structured corpus entries the R89 few-shot loop injects. Entity Brain Dump captures per-customer/vendor/item narrative context (primary contacts, payment quirks, sensitivities) the chat auto-injects when answering questions about that entity.

System overview

2 flows · start here

High-level views of the post-R93 platform. Whole-system overview is the recommended first-read: Inputs → Core → Data → Outputs with the R89 decision-corpus feedback loop highlighted. System architecture drills into the Cloudflare bindings + AI layer.

Job Pillars

7 active · 4 legacy (R96 consolidation)

Each pillar diagram shows the intake → routing → tools → sources → response pipeline for a specific job function. Tools are role-gated (R85 CHAT_ROLE_FILTERS, R96 consolidated). R96 note: Order Mgmt now absorbs Inventory + Logistics + USDA functionality; Reports merged into All. Legacy pillar diagrams kept below as historical reference.

Legacy pillars (consolidated R96)

4 flows · historical reference

These 4 pillars were consolidated in R96 per architect Option C (.gfsmultiagent/architect/r96-pillar-decision.md). Diagrams preserved as historical reference to show the pre-R96 architecture. Inventory, Logistics, USDA functionality is now served by Order Management Admin; Reports tools are in All (admin catch-all).

Cross-cutting Pipelines

3 flows · system-wide infrastructure

End-to-end pipelines that span all pillars. Every chat call goes through the chat-pipeline. Every email goes through intake. Every sync round goes through sync.

Workflow references

5 flows · domain-specific deep dives

Targeted workflow diagrams that drill into specific transactional flows. Useful for onboarding + cross-team alignment.

Workflow contracts (v2)

22 workflows · 94 total fan-out targets · 20 REAL · 74 STUB · 18 HITL-gated (risk ≥ 3). Implementation status from src/lib/workflow_runner.ts.

AR & finance

workflow risk trigger fan_out real / stub doc
AR collections action plan
ar_aging_action_plan
3 · medium 3 0 / 3 open →
Service hold trigger
service_hold_trigger
4 · high 4 0 / 4 open →

Anomaly & guardrail

workflow risk trigger fan_out real / stub doc
Anomaly remediation
anomaly_remediation
2 · low 2 1 / 1 open →

Bid & spec

workflow risk trigger fan_out real / stub doc
Bid amendment arrives
bid_amendment_arrives
3 · medium 3 1 / 2 open →
Bid award notification
bid_award_notification
4 · high 4 1 / 3 open →
Bid price update (canonical)
bid_price_update
3 · medium 7 1 / 6 open →
Spec deviation during bid
spec_deviation_flagged
2 · low 2 1 / 1 open →
USDA lot drawdown commit
usda_drawdown_commit
4 · high 4 1 / 3 open →

Comms & triage

workflow risk trigger fan_out real / stub doc
Bulk customer notification
batch_notify
4 · high 3 0 / 3 open →
Inbound email triage
inbound_email_triage
2 · low 3 0 / 3 open →

Customer ops

workflow risk trigger fan_out real / stub doc
Customer invoice dispute
customer_invoice_dispute
3 · medium 3 2 / 1 open →
Customer quote (canonical)
customer_quote
3 · medium 5 0 / 5 open →
Draft customer quote
draft_quote
3 · medium 7 1 / 6 open →
New customer onboard
new_customer
3 · medium 4 0 / 4 open →

Item & vendor

workflow risk trigger fan_out real / stub doc
New assembly item (full spec → BOM → NS)
new_assembly_item
4 · high 8 0 / 8 open →
New ingredient / vendor onboard
new_ingredient_vendor_onboard
3 · medium 2 0 / 2 open →
Vendor cost update
vendor_cost_update
3 · medium 6 2 / 4 open →

Other

workflow risk trigger fan_out real / stub doc
Assembly build + BOM review
assembly_build_review
3 · medium 9 4 / 5 open →
Item record review + push-back
item_record_review
3 · medium 7 3 / 4 open →

Scheduled cycle

workflow risk trigger fan_out real / stub doc
Annual price roll (SY rollover)
annual_price_roll
5 · critical 3 0 / 3 open →
Monthly margin review
monthly_margin_review
3 · medium 3 1 / 2 open →
Quarterly bid eligibility refresh
quarterly_bid_eligibility_refresh
2 · low 2 1 / 1 open →

System flow diagrams

7 flows · new 2026-05-25 · gap-close: intake unification + memory + 5 strongly-recommended

Seven explanatory diagrams Mike flagged as gaps. Intake unification shows every way a request can enter the system — emails + chat + admin + cron + webhook + direct API — converging at the event ledger and workflow runner. Memory + learning shows the 5 memory layers (reflexion, decision corpus, wiki, training loop, knowledge chunks) plus the curation state-machine that prevents poison. Five more close strongly-recommended gaps: Council v2 (replaces stale R91 chat pipeline), customer lifecycle end-to-end (Driscoll's journey), HITL security invariant (the 4-gate audit story), cost surface (~$1.50/day), and data lineage (NS → chat answer with watermarks).

Substrate diagrams

4 flows · R549-R562 infrastructure · new 2026-05-25

Mike's substrate moves shipped (R549-R562) but lacked diagrams. These document how the new infrastructure actually works internally — the workflow runner, event ledger, HITL state machine, and customer health pipeline. Color-coded REAL vs STUB so you see at a glance what works today vs documented intent.