# Changelog

Copyright © 2026 Victor Idonor. All rights reserved.

## Milestone 4 — Providers and funding (2026-11-18)

- Provider framework: capability contracts, registry, redacted request log, stored webhook callbacks.
- Mock provider for development and staging: test account numbers, simulated bank transfers and identity checks (`veli:mock-payment`). Disabled in production.
- Identity verification (BVN or NIN) with name matching; numbers stored hashed and encrypted; KYC tiers with limits.
- Virtual accounts issued after verification and shown on the wallet page.
- Funding pipeline: signed webhook → stored → verified with the provider → risk rules → wallet credit, review, or suspense.
- Risk rules: large amount, velocity, tier single/daily/balance limits, suspended account, frozen wallet.
- Admin review queue: clear (re-verifies with the provider before crediting) or reject with a mandatory reason; transaction timeline.
- Reconciliation sweep for unresolved webhooks; provider health page.
- Wallet funded notification by email and in-app; queue and sweeps run from the single cron entry.
- Monnify and PayVessel adapters are not included; see `docs/PROVIDER_INTEGRATIONS.md` §7.

## Milestone 3 — Ledger and wallets (2026-11-18)

- Chart of accounts and an immutable double-entry ledger; `Ledger::post()` is the only writer.
- Wallets with cached balance and held balance; holds with capture and release.
- Idempotent posting through dedupe keys; `idempotent` middleware for API requests.
- Row locking in a fixed order; database constraints and triggers behind every rule.
- Nightly `veli:ledger-verify` integrity check that freezes any wallet that disagrees with the ledger.
- Wallet page with statement and filters; dashboard balance; API `wallet` and `wallet/transactions`.
- Admin: trial balance, journals, journal detail, wallets (new `ledger.view` permission).
- `veli:test-credit` for non-production test money.
- Parallel-process concurrency tests on MariaDB in CI.

## Milestone 2 — Identity and access (2026-11-18)

- Accounts: registration, sign-in with lockout, sign-out, email verification by signed link, password recovery.
- Settings: profile, password change, four-digit transaction PIN (hashed, weak PINs refused, lockout after five wrong tries).
- Two-factor authentication (TOTP) with QR setup; required for administrators; codes cannot be replayed.
- Roles and permissions: seven administrative roles; admin console with overview, user search and audit log.
- Append-only audit log, enforced in the model and by database triggers.
- API v1: `auth/register`, `auth/login`, `auth/me`, `auth/logout` with expiring bearer tokens.
- Console: `veli:create-admin`, `veli:reset-two-factor`.
- Branded error pages; request correlation IDs; CI now also runs the suite on MariaDB 11.4.

## Milestone 1 — Foundation (2026-11-18)

- Laravel 13 application installed; runs on PHP 8.3 and later, targeting PHP 8.5.
- Module skeleton: fourteen business modules under `app/Modules`, loaded by `ModuleServiceProvider`.
- `App\Support\Money`: immutable, integer-kobo money type.
- Security headers with a strict content security policy; staging password gate; HTTPS forced on staging and production.
- "Ink and coral" design system: Tailwind 4 tokens, self-hosted Plus Jakarta Sans, Blade components, Alpine (CSP build).
- Landing page and component gallery (`/design`, off by default).
- Pest test suite, Pint code style, GitHub Actions CI, cPanel deployment script and guide.

## Milestone 0 — Discovery and architecture (2026-11-17)

- Requirements, assumptions, provider research, architecture, database design and roadmap.
