Wallet Engineering Status
Priority: P1-P2
Status: ~98% Complete
Last Updated: 2025-12-29
Overview
Member wallet functionality for sports clubs and golf platforms, including balance management, top-ups, transfers, auto-recurring payments, and statement exports.
Implementation Status
| Component | Status | Notes |
|---|
| Backend Services | ✅ Complete | Double-entry ledger, auto top-up, SSE events |
| Admin UI | ✅ Complete | Dashboard, bulk adjust, audit, outbox monitoring |
| Member Portal UI | ✅ Complete | Balance, transactions, statement export |
| Mobile Integration | ✅ Complete | WalletView wired in TeeTime mobile + TeeTime Country Club |
| Deep Linking | ⚠️ Partial | Link-router /wallet route exists in repo; deployment pending in UAT/prod |
Documentation
Architecture
Three-Tier Component Library
| Library | UI Framework | Purpose |
|---|
@digiwedge/ui-wallet | Ant Design | 18 presentational components |
@digiwedge/ui-wallet-pages | Ant Design | 6 composed page components |
@digiwedge/wallet-api-hooks | React Query | 23 data fetching hooks |
@digiwedge/wallet-api-client | - | REST API client |
Backend Services
| Service | Purpose | Status |
|---|
WalletRealtimeService | Polls outbox, emits SSE events | ✅ Complete |
WalletAutoTopUpService | Auto top-up config + scheduling | ✅ Complete |
WalletAutoTopUpWorker | Scheduled/threshold job processing | ✅ Complete |
| Double-Entry Ledger | Journal entries with balanced assertions | ✅ Complete |
Issue Tracker
Gaps to Address
| Gap | Priority | Status |
|---|
Link-router /wallet route deploy | P2 | Pending UAT/prod sync |
Recently Closed
| Issue | Title | Closed |
|---|
| #10515 | feat(mobile): add Wallet deep link screen | 2025-12-31 |
Component Coverage
@digiwedge/ui-wallet (18 components)
| Component | Storybook | Tests |
|---|
| AppleWalletButton | ✅ | ✅ |
| GoogleWalletButton | ✅ | ✅ |
| WalletBalance | ✅ | ✅ |
| WalletTopUpForm | ✅ | ✅ |
| WalletTransferForm | ✅ | ✅ |
| TransactionTable | ✅ | ✅ |
| StatementExport | ✅ | ✅ |
| WalletStatusModal | ✅ | ✅ |
| WalletJournalEntryDrawer | ✅ | ✅ |
| WalletStatusTimeline | ✅ | ✅ |
| ... (8 more) | ✅ | ✅ |
@digiwedge/ui-wallet-pages (7 pages)
| Page | Audience | Status |
|---|
| WalletsDashboard | Admin | ✅ Complete |
| MemberWalletDetail | Admin | ✅ Complete |
| WalletAuditPage | Admin | ✅ Complete |
| WalletOutboxDashboard | Admin | ✅ Complete |
| WalletsBulkAdjustModal | Admin | ✅ Complete |
| MyWalletPage | Member | ✅ Complete |
| TransactionHistoryPage | Member | ✅ Complete |
- Link Router:
apps/teetime/docs-internal/docs/deep-linking/overview.md - deep linking for wallet
- SCL:
docs/epics/scl/README.md - sports club ledger integration
- TeeTime:
docs/epics/teetime/README.md - golf platform integration