How gcina12/wagebridge-hackathon-app works
WageBridge is an earned-wage-access platform: employers register and verify employees, confirm salary releases, and employees link a bank account, request an advance, approve it by email, and receive funds from WageBridge’s float. Salary landing triggers recovery. The graph preserves employer, employee, and admin capabilities described in the README; sampled backend routes show parts of the flow, but not every endpoint or recovery detail, so undocumented connections are omitted.
Main entry points: wagebridge.py WageBridge workflows · main.py FastAPI application · App.js App routing · database.py Database connection
Components 21
Web application
- App routing
frontend/web/src/App.js - Employee login
frontend/web/src/screens/LoginPage.js - Employee verification
frontend/web/src/screens/VerifyEmployee.js - Employer dashboard
frontend/web/src/screens/EmployerDashboard.js - Employee dashboard
frontend/web/src/screens/EmployeeDashboard.js - Advance consent
frontend/web/src/screens/ConfirmAdvance.js - Admin dashboard
frontend/web/src/screens/AdminDashboard.js
WageBridge backend
- FastAPI application
backend/main.py - WageBridge workflows
backend/routers/wagebridge.py - Payroll signal
backend/routers/payroll_mock.py - Salary landing mock
backend/routers/bank_mock.py - Admin reporting
backend/routers/admin.py - Float accounting
backend/float_service.py
External services
- Email service
mail-service/index.js - Open Banking sandbox
Persistence
- Database connection
backend/database.py - Domain records
backend/models.py - Postgres database
Other components
- Employer
- Employee
- Employee bank
Connections 35
- Employer → Employer dashboard: manages payroll
README.md - Employee → Employee login: signs in
README.md - Employee → Employee dashboard: requests access
README.md - App routing → Employee login: renders
frontend/web/src/App.js - App routing → Employee verification: routes to
frontend/web/src/App.js - App routing → Advance consent: routes to
frontend/web/src/App.js - App routing → Employer dashboard: renders
frontend/web/src/App.js - App routing → Employee dashboard: renders
frontend/web/src/App.js - App routing → Admin dashboard: routes to
frontend/web/src/App.js - Employer dashboard → FastAPI application: calls API
- Employee login → FastAPI application: calls API
- Employee verification → FastAPI application: calls API
- Employee dashboard → WageBridge workflows: requests data
frontend/web/src/screens/EmployeeDashboard.js - Advance consent → WageBridge workflows: confirms advance
- Admin dashboard → Admin reporting: loads dashboard
- FastAPI application → WageBridge workflows: registers routes
backend/main.py - FastAPI application → Salary landing mock: registers routes
backend/main.py - FastAPI application → Payroll signal: registers routes
backend/main.py - FastAPI application → Admin reporting: registers routes
backend/main.py - WageBridge workflows → Email service: sends email
backend/routers/wagebridge.py - WageBridge workflows → Open Banking sandbox: requests consent
backend/routers/wagebridge.py - Employee dashboard → Open Banking sandbox: links account
- WageBridge workflows → Float accounting: adjusts float
backend/routers/wagebridge.py - Admin reporting → Float accounting: reads float
backend/routers/admin.py - WageBridge workflows → Salary landing mock: checks salary status
README.md - WageBridge workflows → Payroll signal: checks payroll signal
README.md - WageBridge workflows → Database connection: uses sessions
backend/routers/wagebridge.py - Admin reporting → Database connection: uses sessions
backend/routers/admin.py - Float accounting → Database connection: uses sessions
backend/float_service.py - Database connection → Domain records: provides base
backend/database.py - Domain records → Postgres database: maps records
backend/models.py - Database connection → Postgres database: connects
backend/database.py - Salary landing mock → Employee bank: simulates landing
backend/routers/bank_mock.py - WageBridge workflows → Employee bank: links account
README.md - Email service → Employee: emails consent