Wallet Engineering Documentation

Technical documentation for the Member Wallet system.

Quick Links

Area	Description
Architecture	System design and components
Development	Local setup and API reference
Engineering Status	Implementation status and roadmap
Notifications Plan	Wallet notification implementation
Operations	Monitoring and troubleshooting
Admin Wallet Flows	SCL admin and MCA wallet flows
Runbooks	Incident response procedures

System Overview

The Wallet system provides prepaid account functionality for club members:

Key Libraries

Library	Purpose	Path
@hub/wallet-core	Domain models and business logic	libs/wallet/core
@hub/wallet-prisma	Database schema and client	libs/wallet/prisma
@hub/wallet-api	REST API controllers	libs/wallet/api
@hub/wallet-pass	Apple/Google Wallet integration	libs/wallet/pass
@hub/wallet-notifications	Notification handlers	libs/wallet/notifications

Related Systems

System	Description
Payments API	Payment processing and checkout integration
SCL Backend	Subscription and membership management
Notifications	Multi-channel messaging (SMS, email, push)

Getting Started

1. Local Development Setup