Glossary¶

Product Roles¶

Term	Meaning
Platform Admin	Administrative role with governance and oversight powers. Legacy enum: `admin`.
Operator Company	Tenant/workspace that operates merchant route workflows.
Desk Operator	Operator Company staff user who reviews sessions, quotes, proof, and manual steps. Legacy enum: `operator`.
Merchant Client	Importer or merchant receiving route recommendations. Legacy enum: `customer`.
Settlement Agent	Assigned actor for a controlled-probe settlement leg. Legacy enum: `verified_agent`.

Term	Meaning
Merchant Portal	`/merchant.html`, backed by `frontend/customer.html`.
Customer Portal	Legacy name for Merchant Portal. Served at `/customer.html`.
Admin Portal	`/index.html`, the Platform Admin / Desk Operator console.
Control API	Backend API that powers portals, route sessions, runtime requests, evidence, artifacts, and audit views.
Runtime Assistant	API-backed assistant flow through `/runtime/requests`.

Term	Meaning
Payment intent	The user's requested payment details before route generation.
Route	A candidate path from source currency to supplier settlement currency.
Hop	One step inside a route.
Provider	Bank, exchange, OTC actor, connector, manual actor, or payment service used in a route.
Manual step	A route step that requires a human proof or confirmation.
Hybrid route	Route with both automated and manual parts.
Trust score	Route/provider confidence score used by the recommendation logic.
Liquidity confidence	Confidence that the route has enough liquidity for the amount.
Slippage	Difference between expected and actual conversion outcome.
Human execution penalty	Score penalty for human/manual complexity.

Term	Meaning
NGN	Nigerian naira.
USD	United States dollar.
USDT	Tether stablecoin.
USDC	USD Coin stablecoin.
CNY	Onshore Chinese yuan.
CNH	Offshore Chinese yuan.
Nigeria-to-China	Primary product corridor for validation.

Mode	Meaning
`simulation`	No live execution. Used to compare routes safely.
`guided_execution`	Merchant/operator guided flow with approval and manual controls.
`live_safe_probe`	Small controlled live connector check with backend safety limits.
`automated_execution`	Policy-gated automation mode for supported configured connectors.

Term	Meaning
Pilot case	Route case record used to compare a merchant need, manual route, FlowClaw recommendation, quotes, proof, and outcome.
Historical case replay	Review of an old route case against FlowClaw's recommendation model.
Live quote shadowing	Comparison between FlowClaw recommendations and current quotes without executing a payment.
Controlled probe	Supervised controlled check with proof and governance controls.
Manual route	The route a human operator used or would use.
FlowClaw recommendation	The route FlowClaw recommended for a pilot case.
Quote evidence	Operator or external quote used to compare route reality.
Proof evidence	Receipt, artifact, reference, screenshot, or record supporting a route claim.
Outcome	What happened or what the case proved.
Quality flags	Flags for missing obvious route, hallucination, or weak evidence.
Readiness decision	Platform Admin governance decision based on route case evidence.

Term	Meaning
`recommendation_ready`	Route recommendation exists and can be reviewed.
`approved`	Route has been accepted/approved by the relevant workflow.
`execution_paused`	Execution is paused for human/manual work.
`step_failed`	A route step failed.
`execution_failed`	Route execution failed.
`route_degraded`	Route entered degraded state and needs review.
`waiting_for_operator`	Desk Operator action is required.
`waiting_for_user`	Merchant/user action is required.
`blocked`	Work cannot proceed without resolving a blocker.