[HARD][DASHBOARD] Build wallet transaction ledger dashboard with reconciliation views

[Obiajulu-gif]

Overview

Build a wallet transaction ledger dashboard that gives investors, drivers, and admins a clear view of wallet funding, repayments, payouts, internal credits, debits, and reconciliation status.

Problem

ChainMove handles wallet funding and repayment flows. Users and admins need a transparent ledger-style dashboard that explains every balance movement and helps identify failed, pending, duplicated, or unreconciled transactions.

Expected solution

Create transaction ledger views for:

• investor wallet funding
• driver repayments
• internal wallet credits/debits
• payout records
• pending/failed/successful transactions
• provider references such as Paystack references
• mock payment references for local development
• admin reconciliation status

Dashboard requirements

• role-aware access: users see their own records; admins see all records
• search/filter by date, type, status, provider, and reference
• transaction detail drawer/modal
• balance summary cards
• pagination or infinite loading for large ledgers
• export-ready table structure where possible

Files likely involved

• wallet dashboard pages/components
• transaction model/API routes
• Paystack/payment helpers
• admin dashboard components
• table/filter components
• route guards

Acceptance criteria

• Users can view their own transaction history.
• Admins can view and filter global transaction records.
• Ledger entries show type, amount, status, date, reference, and source.
• Pending/failed transactions are visually clear.
• Data access is properly scoped by role.
• Empty/loading/error states are implemented.
• npm run lint and npm run build pass.

Suggested labels

dashboard, wallet, payments, admin, backend, frontend, hard

Difficulty

Hard

[ekwe7]

I would love to work on this issue. I have experience building production ready applications and collaborating through GitHub workflows. I'll carefully analyze the current implementation, propose a reliable solution, and submit a well-tested PR. My focus is on clean code, maintainability, and timely delivery

[Kureszn]

I've reviewed the issue and believe I can contribute effectively. My experience spans software development, blockchain technologies, cybersecurity and open source collaboration. I take a structured approach to contributions carefully understanding the existing codebase, identifying the root cause and delivering a thoroughly tested implementation.

[ZuLu0890]

I would love to work on this issue

[ZuLu0890]

I would love to work on this issue

[Joycejay17]

Hi maintainer, I'd like to apply for this issue.

Relevant experience:
I've built wallet/ledger-style dashboards before — including role-aware transaction views (user vs admin scoping), filterable transaction tables with status indicators (pending/failed/success), and payment provider integrations similar to Paystack. I'm comfortable with the full scope here: balance summary cards, transaction detail drawers, search/filter by date/type/status/provider, and pagination for large datasets.

Approach:
Review the existing wallet/transaction models and Paystack helper functions to understand current data shape and reference handling (including mock references for local dev)
Design the ledger schema/API response to unify investor funding, driver repayments, internal credits/debits, and payouts into one consistent transaction type
Build role-based route guards so users only query their own records while admins get a global, filterable view
Implement the dashboard UI — summary cards, filterable/paginated table, and a detail drawer for individual transaction inspection
Handle empty, loading, and error states throughout
Verify npm run lint and npm run build pass before submitting

Looking forward to working on this.

[grantfox-oss]

🦊 GrantFox — @Joycejay17 has been assigned to this issue as part of the Official Campaign campaign!

Next steps:

1. Open a Pull Request referencing this issue (e.g., Closes #47)
2. Your PR will be reviewed by the Chainmove maintainers

Good luck! Track your progress on GrantFox.

[grantfox-oss]

🎉 This issue has been marked as completed on GrantFox as part of the Official Campaign campaign!

@Joycejay17's PR #56 was approved and merged by @Obiajulu-gif.

🏆 @Joycejay17: You earned 35 FoxPoints for this contribution! Your current tier: Explorer (118 total points). Track your full progress on GrantFox.

👏 Great work, @Joycejay17! Keep contributing to Chainmove.