
Market data
GatewayIngestion (REST/WebSocket), snapshots, reference data, normalization.
Integrations
Keep the domain core stable while vendors evolve. Integrations live behind ports, are auditable, and support both synchronous workflows and async processing.
Operfix is built to connect to the ecosystem around portfolio, trading, and reporting—without leaking vendor complexity into core workflow.

Ingestion (REST/WebSocket), snapshots, reference data, normalization.

Order routing, acknowledgements, execution updates, cancellations.

Settlement status, confirmations, reconciliations, exceptions.

Instrument metadata, curves, corporate actions feeds.

Vendor overlays, emissions factors, scenario outputs.

OIDC/SAML, SCIM provisioning, enterprise policy hooks.
Integrations are where operational risk concentrates. We design for traceability, idempotency, and controlled failure modes.
Contract boundary
Ports
Domain stays vendor-agnostic
Execution model
Sync + async
Workflows + job queues
Failure handling
Visible states
No silent drops
Traceability
Audit-by-default
Event IDs and correlation
A consistent pattern across modules: API action → use case → port → adapter → vendor.
Route handlers accept a request, validate it, and call an application use case—no vendor code in the HTTP layer.
The use case applies policy, lifecycle transitions, and emits domain events for audit and async work.
Adapters implement ports, translate formats, apply retries/backoff, and attach correlation IDs.
Choose the integration shape based on the risk and latency requirements.
| Capability | Use for | Guarantees | Operational notes |
|---|---|---|---|
| Synchronous (request/response) | Approvals, compliance checks, order actions | Immediate feedback, consistent user experience | Timeout budgets, clear error mapping, no long-running tasks |
| Asynchronous (jobs/events) | Market ingestion, risk runs, report generation | Retries, dedupe, backpressure | Queue visibility, dead-letter handling, measurable SLAs |
| Hybrid (sync trigger + async completion) | Trade confirmation, settlement updates, vendor reconciliation | User gets a tracking ID, status updates later | Status pages, audit trail, operator runbooks |
Ports keep workflow stable; adapters evolve per vendor. Every vendor call is traceable, retryable where safe, and reflected in lifecycle state.
Cross-links across the public site for architecture, trust, specialty modules, and rollout.

Versioned contracts and workflow-oriented endpoints.

Bounded contexts for core and expansion capabilities.

Async processing model for heavy workloads and reliability.

Structured logs, trace context, and queue visibility.

Commercial, technical, and governance inquiry channels.

Exception-first handling for non-happy paths.