# gcina12/wagebridge-hackathon-app architecture

> Architecture diagram of the GitHub repository gcina12/wagebridge-hackathon-app, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/gcina12/wagebridge-hackathon-app
- Repository: https://github.com/gcina12/wagebridge-hackathon-app

## Overview

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: [`backend/routers/wagebridge.py`](https://github.com/gcina12/wagebridge-hackathon-app/blob/main/backend/routers/wagebridge.py) (WageBridge workflows), [`backend/main.py`](https://github.com/gcina12/wagebridge-hackathon-app/blob/main/backend/main.py) (FastAPI application), [`frontend/web/src/App.js`](https://github.com/gcina12/wagebridge-hackathon-app/blob/main/frontend/web/src/App.js) (App routing), [`backend/database.py`](https://github.com/gcina12/wagebridge-hackathon-app/blob/main/backend/database.py) (Database connection)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Web application"]
  node_frontend_app["App routing<br/>[App.js]"]
  node_login["Employee login<br/>[LoginPage.js]"]
  node_verify["Employee verification<br/>[VerifyEmployee.js]"]
  node_employer_dash["Employer dashboard"]
  node_employee_dash["Employee dashboard"]
  node_advance_consent["Advance consent<br/>[ConfirmAdvance.js]"]
  node_admin_dash["Admin dashboard<br/>[AdminDashboard.js]"]
end

subgraph group_backend["WageBridge backend"]
  node_api["FastAPI application<br/>[main.py]"]
  node_wagebridge_routes["WageBridge workflows<br/>[wagebridge.py]"]
  node_payroll_mock["Payroll signal<br/>[payroll_mock.py]"]
  node_bank_mock["Salary landing mock<br/>[bank_mock.py]"]
  node_admin_routes["Admin reporting<br/>[admin.py]"]
  node_float_service["Float accounting<br/>[float_service.py]"]
end

subgraph group_integrations["External services"]
  node_mailer["Email service<br/>[index.js]"]
  node_open_banking["Open Banking sandbox"]
end

subgraph group_data["Persistence"]
  node_database["Database connection<br/>[database.py]"]
  node_models["Domain records<br/>[models.py]"]
  node_postgres[("Postgres database")]
end

node_employer(("Employer"))
node_employee(("Employee"))
node_salary_bank["Employee bank"]

node_employer -->|"manages payroll"| node_employer_dash
node_employee -->|"signs in"| node_login
node_employee -->|"requests access"| node_employee_dash
node_frontend_app -->|"renders"| node_login
node_frontend_app -->|"routes to"| node_verify
node_frontend_app -->|"routes to"| node_advance_consent
node_frontend_app -->|"renders"| node_employer_dash
node_frontend_app -->|"renders"| node_employee_dash
node_frontend_app -->|"routes to"| node_admin_dash
node_employer_dash -.->|"calls API"| node_api
node_login -.->|"calls API"| node_api
node_verify -.->|"calls API"| node_api
node_employee_dash -->|"requests data"| node_wagebridge_routes
node_advance_consent -.->|"confirms advance"| node_wagebridge_routes
node_admin_dash -.->|"loads dashboard"| node_admin_routes
node_api -->|"registers routes"| node_wagebridge_routes
node_api -->|"registers routes"| node_bank_mock
node_api -->|"registers routes"| node_payroll_mock
node_api -->|"registers routes"| node_admin_routes
node_wagebridge_routes -->|"sends email"| node_mailer
node_wagebridge_routes -->|"requests consent"| node_open_banking
node_employee_dash -.->|"links account"| node_open_banking
node_wagebridge_routes -->|"adjusts float"| node_float_service
node_admin_routes -->|"reads float"| node_float_service
node_wagebridge_routes -->|"checks salary status"| node_bank_mock
node_wagebridge_routes -->|"checks payroll signal"| node_payroll_mock
node_wagebridge_routes -->|"uses sessions"| node_database
node_admin_routes -->|"uses sessions"| node_database
node_float_service -->|"uses sessions"| node_database
node_database -->|"provides base"| node_models
node_models -->|"maps records"| node_postgres
node_database -->|"connects"| node_postgres
node_bank_mock -->|"simulates landing"| node_salary_bank
node_wagebridge_routes -->|"links account"| node_salary_bank
node_mailer -.->|"emails consent"| node_employee

click node_frontend_app "https://github.com/gcina12/wagebridge-hackathon-app/blob/main/frontend/web/src/App.js"
click node_login "https://github.com/gcina12/wagebridge-hackathon-app/blob/main/frontend/web/src/screens/LoginPage.js"
click node_verify "https://github.com/gcina12/wagebridge-hackathon-app/blob/main/frontend/web/src/screens/VerifyEmployee.js"
click node_employer_dash "https://github.com/gcina12/wagebridge-hackathon-app/blob/main/frontend/web/src/screens/EmployerDashboard.js"
click node_employee_dash "https://github.com/gcina12/wagebridge-hackathon-app/blob/main/frontend/web/src/screens/EmployeeDashboard.js"
click node_advance_consent "https://github.com/gcina12/wagebridge-hackathon-app/blob/main/frontend/web/src/screens/ConfirmAdvance.js"
click node_admin_dash "https://github.com/gcina12/wagebridge-hackathon-app/blob/main/frontend/web/src/screens/AdminDashboard.js"
click node_api "https://github.com/gcina12/wagebridge-hackathon-app/blob/main/backend/main.py"
click node_wagebridge_routes "https://github.com/gcina12/wagebridge-hackathon-app/blob/main/backend/routers/wagebridge.py"
click node_payroll_mock "https://github.com/gcina12/wagebridge-hackathon-app/blob/main/backend/routers/payroll_mock.py"
click node_bank_mock "https://github.com/gcina12/wagebridge-hackathon-app/blob/main/backend/routers/bank_mock.py"
click node_admin_routes "https://github.com/gcina12/wagebridge-hackathon-app/blob/main/backend/routers/admin.py"
click node_float_service "https://github.com/gcina12/wagebridge-hackathon-app/blob/main/backend/float_service.py"
click node_mailer "https://github.com/gcina12/wagebridge-hackathon-app/blob/main/mail-service/index.js"
click node_database "https://github.com/gcina12/wagebridge-hackathon-app/blob/main/backend/database.py"
click node_models "https://github.com/gcina12/wagebridge-hackathon-app/blob/main/backend/models.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_frontend_app,node_login,node_verify,node_employer_dash,node_employee_dash,node_advance_consent,node_admin_dash toneBlue
class node_api,node_wagebridge_routes,node_payroll_mock,node_bank_mock,node_admin_routes,node_float_service toneAmber
class node_mailer,node_open_banking toneMint
class node_database,node_models,node_postgres toneRose
class node_employer,node_employee,node_salary_bank toneIndigo
```

## Components

### Web application

- [App routing](https://github.com/gcina12/wagebridge-hackathon-app/blob/main/frontend/web/src/App.js): `frontend/web/src/App.js`
- [Employee login](https://github.com/gcina12/wagebridge-hackathon-app/blob/main/frontend/web/src/screens/LoginPage.js): `frontend/web/src/screens/LoginPage.js`
- [Employee verification](https://github.com/gcina12/wagebridge-hackathon-app/blob/main/frontend/web/src/screens/VerifyEmployee.js): `frontend/web/src/screens/VerifyEmployee.js`
- [Employer dashboard](https://github.com/gcina12/wagebridge-hackathon-app/blob/main/frontend/web/src/screens/EmployerDashboard.js): `frontend/web/src/screens/EmployerDashboard.js`
- [Employee dashboard](https://github.com/gcina12/wagebridge-hackathon-app/blob/main/frontend/web/src/screens/EmployeeDashboard.js): `frontend/web/src/screens/EmployeeDashboard.js`
- [Advance consent](https://github.com/gcina12/wagebridge-hackathon-app/blob/main/frontend/web/src/screens/ConfirmAdvance.js): `frontend/web/src/screens/ConfirmAdvance.js`
- [Admin dashboard](https://github.com/gcina12/wagebridge-hackathon-app/blob/main/frontend/web/src/screens/AdminDashboard.js): `frontend/web/src/screens/AdminDashboard.js`

### WageBridge backend

- [FastAPI application](https://github.com/gcina12/wagebridge-hackathon-app/blob/main/backend/main.py): `backend/main.py`
- [WageBridge workflows](https://github.com/gcina12/wagebridge-hackathon-app/blob/main/backend/routers/wagebridge.py): `backend/routers/wagebridge.py`
- [Payroll signal](https://github.com/gcina12/wagebridge-hackathon-app/blob/main/backend/routers/payroll_mock.py): `backend/routers/payroll_mock.py`
- [Salary landing mock](https://github.com/gcina12/wagebridge-hackathon-app/blob/main/backend/routers/bank_mock.py): `backend/routers/bank_mock.py`
- [Admin reporting](https://github.com/gcina12/wagebridge-hackathon-app/blob/main/backend/routers/admin.py): `backend/routers/admin.py`
- [Float accounting](https://github.com/gcina12/wagebridge-hackathon-app/blob/main/backend/float_service.py): `backend/float_service.py`

### External services

- [Email service](https://github.com/gcina12/wagebridge-hackathon-app/blob/main/mail-service/index.js): `mail-service/index.js`
- **Open Banking sandbox**

### Persistence

- [Database connection](https://github.com/gcina12/wagebridge-hackathon-app/blob/main/backend/database.py): `backend/database.py`
- [Domain records](https://github.com/gcina12/wagebridge-hackathon-app/blob/main/backend/models.py): `backend/models.py`
- **Postgres database**

### Other components

- **Employer**
- **Employee**
- **Employee bank**

## Connections

- Employer → Employer dashboard: manages payroll (evidence: `README.md`)
- Employee → Employee login: signs in (evidence: `README.md`)
- Employee → Employee dashboard: requests access (evidence: `README.md`)
- App routing → Employee login: renders (evidence: `frontend/web/src/App.js`)
- App routing → Employee verification: routes to (evidence: `frontend/web/src/App.js`)
- App routing → Advance consent: routes to (evidence: `frontend/web/src/App.js`)
- App routing → Employer dashboard: renders (evidence: `frontend/web/src/App.js`)
- App routing → Employee dashboard: renders (evidence: `frontend/web/src/App.js`)
- App routing → Admin dashboard: routes to (evidence: `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 (evidence: `frontend/web/src/screens/EmployeeDashboard.js`)
- Advance consent → WageBridge workflows: confirms advance
- Admin dashboard → Admin reporting: loads dashboard
- FastAPI application → WageBridge workflows: registers routes (evidence: `backend/main.py`)
- FastAPI application → Salary landing mock: registers routes (evidence: `backend/main.py`)
- FastAPI application → Payroll signal: registers routes (evidence: `backend/main.py`)
- FastAPI application → Admin reporting: registers routes (evidence: `backend/main.py`)
- WageBridge workflows → Email service: sends email (evidence: `backend/routers/wagebridge.py`)
- WageBridge workflows → Open Banking sandbox: requests consent (evidence: `backend/routers/wagebridge.py`)
- Employee dashboard → Open Banking sandbox: links account
- WageBridge workflows → Float accounting: adjusts float (evidence: `backend/routers/wagebridge.py`)
- Admin reporting → Float accounting: reads float (evidence: `backend/routers/admin.py`)
- WageBridge workflows → Salary landing mock: checks salary status (evidence: `README.md`)
- WageBridge workflows → Payroll signal: checks payroll signal (evidence: `README.md`)
- WageBridge workflows → Database connection: uses sessions (evidence: `backend/routers/wagebridge.py`)
- Admin reporting → Database connection: uses sessions (evidence: `backend/routers/admin.py`)
- Float accounting → Database connection: uses sessions (evidence: `backend/float_service.py`)
- Database connection → Domain records: provides base (evidence: `backend/database.py`)
- Domain records → Postgres database: maps records (evidence: `backend/models.py`)
- Database connection → Postgres database: connects (evidence: `backend/database.py`)
- Salary landing mock → Employee bank: simulates landing (evidence: `backend/routers/bank_mock.py`)
- WageBridge workflows → Employee bank: links account (evidence: `README.md`)
- Email service → Employee: emails consent
