# Glossary

Use these words in code, commits, UI copy keys and docs. They match the template's `CONTEXT.md`
and the API's vocabulary, so one word means one thing across every repository.

| Term | Meaning | Avoid |
| --- | --- | --- |
| **EzyFlow** | The platform and its Integrator API | — |
| **EzyOrder** | This App: the order and receipt-notice entry portal | the portal, the webapp |
| **Template** | `ezyflow-webapp-template`, the shape EzyOrder was scaffolded from | boilerplate, starter |
| **App** | One application scaffolded from the Template (EzyOrder is one) | project, site, instance |
| **Integrator** | Anyone building against the platform from outside its services | partner, client |
| **Activity** | The one EzyFlow tenant scope EzyOrder serves (`EZYFLOW_ACTIVITY`) | tenant, account |
| **API client** | The machine identity EzyOrder's server calls the API as | service account, bot |
| **App user** | A person signed in to EzyOrder through OIDC | user, customer |
| **Viewer** / **Admin** | App-user roles: read only / read and act | reader / owner, superuser |
| **SDK** | `@ezytail/ezyflow-sdk`, the generated API client and event types | wrapper, api-client |
| **Runtime** | `@ezytail/ezyflow-start`, shared behaviour (config, tokens, login, inbox, MCP) | core, lib, framework |
| **Push** | Handing one canonical event to the platform | send, post, sync |
| **Rehearsal** | A push with `dry_run: true`: answered like the real one, leaves no trace | test push, simulation |
| **Projection** | A read model the API serves per entity (list, one, timeline, graph, related) | view, cache |
| **Delivery** | One signed HTTPS POST the platform makes to EzyOrder for one event | webhook, callback |
| **Webhook** | The registration in the portal that deliveries are made for | — |
| **Inbox** | EzyOrder's durable record of verified deliveries, keyed by message id | queue, log |
| **Handler** | Code that runs once per event taken from the inbox | listener, consumer |
| **Problem** | An RFC 9457 error answer from the API, with a trace id | error payload |
| **Brief** / **Primer** | Generated agent material: `AGENTS.md` block / `docs/ezyflow/` | prompt, wiki |

## Business words → API words

| Customer says (FR) | Customer says (EN) | EzyFlow entity / event |
| --- | --- | --- |
| commande | order | entity `order`, event `order.created` / `order.cancelled` |
| annonce de réception | receipt notice | entity `procurement`, event `procurement.created` |
| réception confirmée | confirmed receipt | event `receipt.confirmed` |
| fournisseur | supplier | `supplier_reference` / `supplier_name` on a procurement; entity `partner` |
| article / variante | product / variant | entities `product`, `product_variant` |
| stock | stock level | entity `stock_level` |

UI copy is in French and English (`messages/fr.json`, `messages/en.json`); identifiers,
message keys, comments and docs are in English.