Mapping the Core Interactions That Define the FX Repatriation Workflow

Overview

Three task flows were developed to map the core interactions within the FX Repatriation Widget — the sequential workflow that takes a middle office user from raw FCM balance data through AI-generated trade recommendations into trade execution. Each flow represents a distinct phase of that journey, with a clear entry point, a defined set of steps, and a completion state that enables the next flow to begin.

How the Flows Connect

The three flows are designed as a sequential pipeline. A user does not skip ahead — each flow unlocks the next. This mirrors the actual logic of the repatriation workflow: you cannot run analysis on data you haven't fetched, and you cannot execute trades that haven't been recommended and reviewed. The sequential CTA button structure in the FX Repatriation Widget enforces this order at the interaction level — three CTAs progress in order: Fetch FCM → Run Analysis → View Insights.

Flow 1: Data Aggregation ↓ FCM file fetched, Currency Trade Table populated Flow 2: AI Recommendation ↓ AI analysis complete, recommendations surfaced in table Flow 3: Trade Execution ↓ Recommendations reviewed, executed (or overridden), and confirmed

Flow 1 — Data Aggregation

Entry point: Middle office user navigates to the FX Repatriation Widget

Goal: Retrieve the week's FCM foreign currency balance file and populate the Currency Trade Table with position data

Step 1 — Select Portfolio The user selects their portfolio from the left-hand navigation panel. This scopes the dashboard to the relevant fund and makes the widget set available.

Step 2 — Navigate to FX Repatriation Widget The user selects the FX Repatriation Widget from the dashboard. The widget loads with the Currency Trade Table empty and three sequential CTA buttons across the top — Fetch FCM, Run Analysis, and View Insights. Only Fetch FCM is active at this stage. The phase stepper below the table shows Phase 1 (Data Aggregation) as active.

Step 3 — Fetch FCM File The user selects the Fetch FCM button. A loading indicator appears as the system retrieves the FTP file from the FCM. This replaces the manual process of downloading and importing the FCM statement.

Step 4 — Currency Trade Table Populates On successful retrieval, the Currency Trade Table populates with the week's foreign currency balance data — including currency, pair, exposure, FX rate, AI Rec, priority, estimated impact, and action columns. The Fetch FCM button moves to a completed state. The Run Analysis button activates. The phase stepper advances visually.

Completion state: Currency Trade Table populated with FCM data. System ready for AI analysis.