How madhankumar98/clearset-ai works
ClearSet AI is a post-trade settlement operations copilot. Analysts review detected exceptions, inspect deterministic risk factors, run a procedural investigation with policy and historical evidence, and make the required human authorization decision. The React client uses a shared application context and API client; the Express backend provides Snowflake-backed data and reporting. README capabilities also include impact metrics, predictive risk, settlement-chain visualization, CoCo replay, and optional Slack notifications. Some links are documented rather than verified from source excerpts; those are marked accordingly.
Main entry points: App.tsx Application Shell · index.ts Express API · apiClient.ts Frontend API Client · AppContext.tsx Application State
Components 28
Analyst Console
- Application Shell
src/App.tsx - Exception Queue
src/views/ExceptionsView.tsx - Operations Dashboard
src/views/DashboardView.tsx - Investigation Workspace
src/views/InvestigationView.tsx - Cases Ledger
src/views/CasesView.tsx - Copilot View
src/views/CopilotView.tsx - Policy Library View
src/views/PoliciesView.tsx - CoCo Replay Panel
src/components/CocoReplayPanel.tsx - Settlement Chain View
src/components/SettlementChainViz.tsx - Prediction Panel
src/components/PredictionPanel.tsx - Impact Metrics Tile
src/components/ImpactMetricsTile.tsx
Settlement Intelligence
- Application State
src/context/AppContext.tsx - Settlement Data Service
src/services/settlementService.ts - Deterministic Risk Engine
src/engine/riskEngine.ts - Investigation Orchestrator
src/engine/agentOrchestrator.ts - SOP Knowledge Base
src/data/knowledgeBase.ts - Local Trade Data
src/data/syntheticData.ts - Cortex Service
src/services/cortexService.ts
Backend Services
- Frontend API Client
src/services/apiClient.ts - Express API
server/index.ts - Prediction API
server/routes/predict.ts - Predictive Engine
server/services/predictiveEngine.ts - Impact Metrics
server/services/metricsService.ts - Audit Reports
server/services/auditReportService.ts
Data and Integrations
- Snowflake Client
server/snowflakeClient.ts - Slack Notifications
server/services/slackService.ts - Snowflake Cortex
Other components
- Operations Analyst
Connections 39
- Operations Analyst → Application Shell: uses
README.md - Application Shell → Exception Queue: routes to
src/App.tsx - Application Shell → Operations Dashboard: routes to
src/App.tsx - Application Shell → Investigation Workspace: routes to
src/App.tsx - Application Shell → Cases Ledger: routes to
src/App.tsx - Application Shell → Copilot View: routes to
src/App.tsx - Application Shell → Policy Library View: routes to
src/App.tsx - Application Shell → Application State: provides state
src/App.tsx - Application State → Settlement Data Service: loads exceptions
src/context/AppContext.tsx - Application State → Cortex Service: runs investigation
src/context/AppContext.tsx - Application State → Frontend API Client: checks status
src/context/AppContext.tsx - Settlement Data Service → Frontend API Client: fetches data
src/services/settlementService.ts - Settlement Data Service → Local Trade Data: falls back to
src/services/settlementService.ts - Local Trade Data → Deterministic Risk Engine: scores trades
src/data/syntheticData.ts - Cortex Service → Investigation Orchestrator: delegates steps
src/services/cortexService.ts - Cortex Service → Frontend API Client: requests Cortex
src/services/cortexService.ts - Investigation Orchestrator → Deterministic Risk Engine: calculates score
src/engine/agentOrchestrator.ts - Investigation Orchestrator → SOP Knowledge Base: uses procedures
src/engine/agentOrchestrator.ts - Exception Queue → Application State: reads queue
src/views/ExceptionsView.tsx - Investigation Workspace → Application State: advances workflow
src/views/InvestigationView.tsx - Investigation Workspace → Investigation Orchestrator: displays evidence
src/views/InvestigationView.tsx - Investigation Workspace → Deterministic Risk Engine: shows risk math
src/views/InvestigationView.tsx - Policy Library View → SOP Knowledge Base: displays procedures
src/views/PoliciesView.tsx - Cases Ledger → Frontend API Client: loads cases
src/views/CasesView.tsx - Operations Dashboard → Impact Metrics Tile: renders metrics
src/views/DashboardView.tsx - Operations Dashboard → Prediction Panel: renders forecasts
src/views/DashboardView.tsx - Operations Dashboard → Settlement Chain View: renders settlement chain
src/views/DashboardView.tsx - Operations Dashboard → CoCo Replay Panel: renders replay
src/views/DashboardView.tsx - Frontend API Client → Express API: calls API
src/services/apiClient.ts - Express API → Snowflake Client: queries
server/index.ts - Express API → Snowflake Cortex: uses Cortex
README.md - Express API → Impact Metrics: computes metrics
server/index.ts - Express API → Audit Reports: generates reports
server/index.ts - Express API → Slack Notifications: notifies optionally
server/index.ts - Express API → Prediction API: mounts routes
server/index.ts - Prediction API → Predictive Engine: runs predictions
server/routes/predict.ts - Impact Metrics Tile → Frontend API Client: fetches metrics
src/components/ImpactMetricsTile.tsx - Prediction Panel → Frontend API Client: requests predictions
src/components/PredictionPanel.tsx - Settlement Chain View → Frontend API Client: fetches chain data
src/components/SettlementChainViz.tsx