brazil-swift-ops/README.md

# Brazil SWIFT Operations Platform

Regulator-grade cross-border payment rules engine and treasury management console compliant with Brazilian Banco Central (BCB) requirements, ISO 20022, and international AML/KYC standards.

## Architecture

This is a **monorepo** built with:
- **pnpm workspaces** for package management
- **Turborepo** for build orchestration
- **TypeScript** for type safety
- **React** + **Tailwind CSS** for the frontend

## Packages

- `packages/types` - Shared TypeScript types and interfaces
- `packages/utils` - Common utilities (currency, dates, validation, E&O)
- `packages/rules-engine` - Brazil regulatory rules engine
- `packages/iso20022` - ISO 20022 message handling
- `packages/treasury` - Treasury & subledger management
- `packages/risk-models` - Capital, reserves, LCR stress allocation
- `packages/audit` - Audit logging & compliance reporting
- `apps/web` - React frontend application

## Getting Started

### Prerequisites

- Node.js >= 18.0.0
- pnpm >= 8.0.0

### Installation

```bash
pnpm install
```

### Development

```bash
pnpm dev
```

### Build

```bash
pnpm build
```

### Testing

```bash
pnpm test
```

### Type Checking

```bash
pnpm type-check
```

## Features

- ✅ Brazil regulatory compliance (BCB requirements)
- ✅ ISO 20022 message support (pacs.008, pacs.009, pain.001)
- ✅ Multi-transaction batch processing
- ✅ Treasury & subledger management
- ✅ Risk, capital & liquidity stress allocation
- ✅ AML & anti-structuring detection
- ✅ IOF tax calculation
- ✅ FX contract validation
- ✅ Audit logging & compliance reporting
- ✅ Errors & Omissions (E&O) +10% uplift

## License

Private - Internal Use Only