Alan Exchange - Hawala Management System
A back office for a multi-branch currency exchange and hawala business. Transfers between offices, live exchange rates, commission and cashbox tracking, expenses, and audit-ready reporting - all in Kurdish, right to left.
Client
Kak Alan
Type
System
Timeline
1 Week
Deliverables
Multi-currency office transfer workflow (send, request, receive, convert) · Append-only exchange rate management with historical snapshots · Cashbox and commission tracking · Expense management · Seven report types - daily, weekly, monthly, currency, commission and profit, expenses, transfers · Dashboard with profit and transfer-volume charts · Full transaction history with filtering · Right-to-left Kurdish interface · Activation-code licensing · Database migrations and legacy data import tooling · Regression test harness and pre-client sign-off documentation
THE CHALLENGE
Money moves between branches in several currencies, at rates that change during the day. Tracked in notebooks and spreadsheets, every correction quietly overwrites the record it corrects, and by month-end nobody can prove what a branch actually owes. The system had to make financial history impossible to rewrite, keep inter-office balances reconciled to the currency's smallest unit, and be usable in Kurdish by staff who don't work in English.
THE SOLUTION
Next.js 16, React 19 and TypeScript, organised as one module per business domain - offices, transfers, rates, commissions, expenses, reports - each with its own UI, service, repository and storage layer. Every amount is held as an integer in the currency's minor unit and flows through a single authoritative calculation layer, so no figure is ever rounded twice. Financial tables are append-only, enforced both in application logic and in SQLite triggers: a correction posts a reversing entry, it never edits the original. Transfers store the exact exchange rate snapshot resolved at posting time, and realized FX gain and loss is computed from FIFO-tracked currency lots. The whole interface is right-to-left Kurdish, behind an Argon2id activation gate, with a regression harness that replays the core money scenarios end to end.
THE RESULT
A thirteen-scenario sign-off matrix - overflow balances, FX profit and loss, FIFO lots, filtered reports, cross-page consistency - passed with exact expected figures. Dashboard, cashbox, expenses, reports and transaction history all report the same numbers from the same stored truth, and every transfer stays auditable years later because the rate it used is stored with it.