# WASL (وَصْل) Digital Wallet

WASL is a bank-grade, secure P2P and merchant digital wallet platform tailored for Syria.

## Tech Stack
- **Backend**: Laravel 11 + Laravel Octane (Swoole driver)
- **Mobile**: Flutter 3.x (Clean Architecture + BLoC/Cubit)
- **Database**: PostgreSQL 16 (with transaction audit ledgers)
- **Cache / Queue**: Redis 7
- **Storage**: MinIO (S3-compatible secure private storage)
- **Deployment**: Docker Compose

## Architectural Core Principles
- **ACID Compliance**: Ensuring complete database integrity for all financial mutation queries.
- **Double-Entry Ledger**: Every transaction produces exactly 2 balancing ledger entries (debit and credit).
- **Strict Minor Units**: All monetary values stored and processed as `BIGINT` minor units (e.g. SYP is stored as minor units to avoid floating-point inaccuracies).
- **Pessimistic Locking**: `SELECT ... FOR UPDATE` with deterministic resource locking order to prevent deadlocks.
- **Data Encryption**: AES-256 field-level encryption for sensitive PII (Phone number, National ID).
- **Audit Logging**: Immutable ledger tracking all authentication, registration, and transfer activities.

## Directory Structure
- `Backend/`: The Laravel API and administrator control panel.
- `Mobile App/`: The Flutter application codebase.
- `wasl_concept.md`: Complete details of the 4 phase implementation prompts.
- `deploy.sh`: Shell script to stage, commit, and push changes to the repository.