> ## Documentation Index
> Fetch the complete documentation index at: https://yorber.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# System Architecture

> High-level overview of the Capital Flux ecosystem.

## Architecture Overview

Capital Flux follows a **Decoupled Client-Server** architecture with a heavy emphasis on client-side state management to support offline operations.

### Data Flow Diagram

```mermaid theme={null}
graph TD
    A[Mobile App] -->|1. Sync| B(Supabase Auth/DB)
    A -->|2. Local Storage| C[(WatermelonDB)]
    A -->|3. Rates| D{Rate Engine}
    D --> E[BCV / Parallel API]
    D --> F[Binance P2P]
    D --> G[Global Rates Adapter]
```

***

### Components

1. **Core Mobile Client:** Built with React Native, it handles the UI and optimistic updates.

2. **Rate Engine:** A sophisticated adapter that fetches, normalizes, and caches exchange rates every 30 minutes.

3. **Sync Engine:** Manages a mutation queue to ensure data consistency between the local SQLite database and Supabase.

4. **Global Rates Adapter:** Integrated in Phase 11 to provide seamless conversion for international currency pairs (USD, EUR, COP, etc.) via `open.er-api.com`.