Integration Platform — UI surfaces¶
Target
This page describes intended behaviour or structure. No implementation is claimed unless a section is explicitly marked Current implementation or Evidence.
Screens fed by the platform¶
| Studio work area | Screen | Read model | Commands |
|---|---|---|---|
| Governance & administration | Connections: provider, state, health, rotation due, grants | GET /factory/connections |
RegisterConnection, VerifyConnection, SetGrant, RotateCredential (production-class), RevokeConnection (production-class) |
| Assets | Connectors: capabilities, adapter version, webhook scheme, certification state | GET /factory/connectors |
CertifyConnector |
| Workspace | Subscriptions of a project: connector, connection, event types, target, ingress | subscription read model | CreateSubscription (external-class) |
| Operations & usage | Deliveries: direction, connector, state, attempts, receipts; failed deliveries queue | GET /factory/deliveries |
ReplayDelivery (Operator) |
| Operations & usage | Ingress rejections by outcome (bad signature, replayed, unknown ingress, rate limited, oversized) | InboundDeliveryRejected through the BFF |
none |
State families shown¶
| Family | Values |
|---|---|
| Connection | Draft, Verified, Active, Degraded, Suspended, Revoked |
| Connector | Draft, Certified, Active, Deprecated |
| Delivery | Received, Verified, Deduplicated, Dispatched, Acknowledged, Failed, Replayed, Rejected |
| Verification outcome | Verified, BadSignature, Replayed, UnknownIngress, RateLimited, Oversized |
Rules the clients must honour¶
- Credential values are never displayed or entered in the Studio; the connection form takes a Key Vault reference or launches the Secret Broker's capture flow.
- Grants are explicit: a connection screen shows exactly which projects, agents, tools, sources and servers may use it.
- Replay is an operator action with the receipt of the failed delivery shown; the Studio never re-posts payloads itself.
- Rotation due is a task, surfaced on the connection and in the operator inbox.
CLI and VS Code¶
factory connections list|register|verify|grant|rotate|revoke, factory connectors list|certify, factory subscriptions create, factory deliveries list|replay.