How itsnatch22/eaziwageapp works
EaziWage is an earned-wage-access platform connecting employees, employers, and administrators to advance requests, approvals, real-money disbursement, and payday repayment. The principal employee workflow submits an advance request, checks fraud risk, reserves employer funds, and disburses through DusuPay; callbacks and scheduled reconciliation resolve payment outcomes. Documented supporting areas include employer payroll and funding, KYC, risk review, wallets, reporting, authentication, and notifications. The graph combines README-described flows with relationships visible in sampled source; unsampled dashboard-to-API links are omitted or marked unverified.
Main entry points: admin Admin dashboard · supabaseAdmin.ts Supabase data · employee-dashboard Employee dashboard · employer-dashboard Employer dashboard
Components 24
Access and dashboards
- Employee dashboard
app/dashboards/employee-dashboard - Employer dashboard
app/dashboards/employer-dashboard - Admin dashboard
app/admin - Authentication
app/api/auth
Advance lifecycle
- Advance request
app/api/employee-dashboard/request-advance/route.ts - Fraud screening
lib/fraud-engine.ts - Advance approval
lib/services/advance-approval.ts - Payout service
lib/services/payout-service.ts
Funding and repayment
- DusuPay gateway
- Payment callbacks
app/api/webhook/dusupay/route.ts - Employer wallet
app/api/employer-dashboard/wallet/route.ts - Payday recoupment
lib/services/payday-recoupment-service.ts - Payment reconciliation
app/api/cron/reconcile-dusupay/route.ts - Stanbic banking
lib/stanbic/client.ts
Operations and compliance
- KYC review
app/admin/kyc-review/KycReviewClient.tsx - Payroll management
app/api/employer-dashboard/payroll - Risk and fraud review
app/admin/fraud-detection/FraudDetectionClient.tsx - Reporting and reconciliation
app/api/admin/reports
Platform services
- Supabase data
lib/supabaseAdmin.ts - Notification service
lib/notifications.ts - Realtime refresh
hooks/useRealtimeRefresh.ts
Other components
- Employee
- Employer
- Administrator
Connections 33
- Employee → Employee dashboard: uses
- Employer → Employer dashboard: uses
- Administrator → Admin dashboard: uses
- Employee dashboard → Authentication: authenticates
- Employer dashboard → Authentication: authenticates
- Admin dashboard → Authentication: authenticates
- Employee dashboard → Advance request: submits request
- Advance request → Fraud screening: checks risk
app/api/employee-dashboard/request-advance/route.ts - Advance request → Advance approval: tries approval
app/api/employee-dashboard/request-advance/route.ts - Advance approval → Payout service: disburses
- Payout service → DusuPay gateway: sends funds
- Payout service → Employer wallet: reserves funds
- DusuPay gateway → Payment callbacks: sends callbacks
- Payment callbacks → Supabase data: updates payments
app/api/webhook/dusupay/route.ts - Payment callbacks → Payday recoupment: applies collection
app/api/webhook/dusupay/route.ts - Payment callbacks → Notification service: notifies users
app/api/webhook/dusupay/route.ts - Payday recoupment → DusuPay gateway: collects liability
- Payment reconciliation → DusuPay gateway: checks status
- Payment reconciliation → Supabase data: records drift
app/api/cron/reconcile-dusupay/route.ts - Payment reconciliation → Notification service: alerts operations
app/api/cron/reconcile-dusupay/route.ts - Employer dashboard → Payroll management: manages payroll
- Admin dashboard → KYC review: reviews documents
- Admin dashboard → Risk and fraud review: reviews risk
- Admin dashboard → Reporting and reconciliation: views reports
- Admin dashboard → Employer wallet: manages funding
- KYC review → Supabase data: reviews records
- Risk and fraud review → Supabase data: reviews alerts
- Reporting and reconciliation → Supabase data: reads records
- Stanbic banking → Employer wallet: records deposits
- Notification service → Supabase data: writes notices
lib/notifications.ts - Employee dashboard → Realtime refresh: refreshes live
- Employer dashboard → Realtime refresh: refreshes live
- Admin dashboard → Realtime refresh: refreshes live
app/admin/kyc-review/KycReviewClient.tsx