feat(finance): display organization fiat balance in navbar and finance page

[Shadow-MMN]

Pull Request

Summary

This PR implements the display of the organization’s real fiat balance across the dashboard. The balance is fetched from the backend organization_fiat_balances record (stored in kobo), converted to NGN, and formatted consistently for display in both the navbar and the finance overview page.

A reusable utility was introduced to ensure consistent currency formatting across the application.

---

Type of Change

• Feature
• Bug Fix
• Refactoring
• Documentation
• Tests
• Infrastructure / CI

---

Linked Issues

Closes #434

---

Key Changes

• Added getOrganizationFiatBalance service method to fetch fiat balance from the database
• Created reusable utility formatNairaFromKobo for consistent NGN formatting
• Added new API endpoint: GET /api/v1/finance/balance
• Integrated balance display into dashboard navbar via AppShell → DesktopHeader
• Displayed balance in finance overview page (BalanceSection)
• Added graceful fallback for missing or failed balance fetch (₦0.00)
• Ensured consistent conversion from kobo to NGN across UI layers

---

Checklist

• I have performed a self-review of my code.
• I have commented my code, particularly in hard-to-understand areas.
• My changes generate no new linting/type-checking warnings.
• I have added tests that prove my fix is effective or that my feature works.
• I have updated the documentation accordingly.

---

Screenshots / Recordings

Closes #434

[vercel]

Someone is attempting to deploy a commit to the vestroll's projects Team on Vercel.

A member of the Team first needs to authorize it.

[codeZe-us]

@Shadow-MMN is the PR ready for review or is it a work in progress

[Shadow-MMN]

@Shadow-MMN is the PR ready for review or is it a work in progress

Still in progress,I will be done by night time or tomorrow

[Shadow-MMN]

@codeZe-us we can check it out now

[codeZe-us]

@Shadow-MMN the PR points to main, it should point to dev

[Shadow-MMN]

@Shadow-MMN the PR points to main, it should point to dev

Ok let me correct that

[Shadow-MMN]

@codeZe-us I am done