# t7451/unifyone-netlify-supabase architecture

> Architecture diagram of the GitHub repository t7451/unifyone-netlify-supabase, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/t7451/unifyone-netlify-supabase
- Repository: https://github.com/t7451/unifyone-netlify-supabase

## Overview

UnifyOne is a gig-worker and 1099 finance product with a second, multi-tenant commerce capability. The principal workflow is a worker entering the React app, viewing unified earnings and mileage, and managing tax and money tasks; commerce users also manage stores, products, orders, and customers. The Express/tRPC backend, domain services, and PostgreSQL schema provide the main internal layers, with auth, payments, AI, and MCP integrations alongside them. Some feature links are documented in the README but their implementation was not sampled, so those edges cite the README.

Main entry points: [`client/src/app/routes.tsx`](https://github.com/t7451/unifyone-netlify-supabase/blob/main/client/src/app/routes.tsx) (App routes), [`client/src/pages/MoneyManager.tsx`](https://github.com/t7451/unifyone-netlify-supabase/blob/main/client/src/pages/MoneyManager.tsx) (Money Manager), [`drizzle/schema.ts`](https://github.com/t7451/unifyone-netlify-supabase/blob/main/drizzle/schema.ts) (PostgreSQL schema), [`netlify/functions/server.ts`](https://github.com/t7451/unifyone-netlify-supabase/blob/main/netlify/functions/server.ts) (API server)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["User application"]
  node_routes["App routes<br/>[routes.tsx]"]
  node_dashboard["Dashboard shell"]
end

subgraph group_gig["Gig finance"]
  node_gig_iq["GigIQ<br/>[GigHome.tsx]"]
  node_tax_tools["Tax tools"]
  node_money_manager["Money Manager<br/>[MoneyManager.tsx]"]
  node_rules["Financial rules<br/>[ruleEngine.ts]"]
end

subgraph group_commerce["Commerce platform"]
  node_commerce_dashboard["Commerce dashboard<br/>[index.tsx]"]
  node_catalog["Products and themes<br/>[index.tsx]"]
  node_orders["Orders and checkout<br/>[index.tsx]"]
  node_customers["Customers<br/>[Customers.tsx]"]
end

subgraph group_backend["API and data"]
  node_api_server["API server<br/>[server.ts]"]
  node_auth["Authentication"]
  node_domain_data["Domain services<br/>[gigWorker.ts]"]
  node_schema[("PostgreSQL schema<br/>[schema.ts]")]
  node_payment_routes["Payment webhooks<br/>[webhooks.ts]"]
end

subgraph group_integrations["Integrations and content"]
  node_mcp["MCP interface<br/>[mcp.mts]"]
  node_kai["Kai assistant<br/>[ai.service.ts]"]
  node_marketing["Marketing site<br/>[waitlist.ts]"]
end

node_worker(("Gig worker"))
node_commerce_user(("Commerce user"))

node_worker -->|"uses app"| node_routes
node_commerce_user -->|"uses app"| node_routes
node_routes -->|"renders"| node_dashboard
node_routes -.->|"routes to"| node_gig_iq
node_routes -.->|"routes to"| node_tax_tools
node_routes -.->|"routes to"| node_money_manager
node_routes -.->|"routes to"| node_commerce_dashboard
node_routes -.->|"routes to"| node_catalog
node_routes -.->|"routes to"| node_orders
node_routes -.->|"routes to"| node_customers
node_gig_iq -.->|"unifies earnings"| node_money_manager
node_gig_iq -.->|"supports tax planning"| node_tax_tools
node_money_manager -.->|"evaluates rules"| node_rules
node_api_server -.->|"uses data model"| node_schema
node_api_server -->|"dispatches routes"| node_auth
node_auth -->|"reads and writes"| node_schema
node_rules -->|"reads and writes"| node_schema
node_rules -->|"credits envelopes"| node_money_manager
node_payment_routes -.->|"updates records"| node_schema
node_api_server -.->|"serves endpoint"| node_mcp
node_mcp -.->|"exposes commerce data"| node_commerce_dashboard
node_kai -.->|"answers questions"| node_worker

click node_routes "https://github.com/t7451/unifyone-netlify-supabase/blob/main/client/src/app/routes.tsx"
click node_dashboard "https://github.com/t7451/unifyone-netlify-supabase/blob/main/client/src/components/DashboardLayout.tsx"
click node_gig_iq "https://github.com/t7451/unifyone-netlify-supabase/blob/main/client/src/pages/GigHome.tsx"
click node_tax_tools "https://github.com/t7451/unifyone-netlify-supabase/blob/main/client/src/pages/tools/QuarterlyTaxEstimator.tsx"
click node_money_manager "https://github.com/t7451/unifyone-netlify-supabase/blob/main/client/src/pages/MoneyManager.tsx"
click node_rules "https://github.com/t7451/unifyone-netlify-supabase/blob/main/server/lib/ruleEngine.ts"
click node_commerce_dashboard "https://github.com/t7451/unifyone-netlify-supabase/blob/main/client/src/pages/Dashboard/index.tsx"
click node_catalog "https://github.com/t7451/unifyone-netlify-supabase/blob/main/client/src/pages/Products/index.tsx"
click node_orders "https://github.com/t7451/unifyone-netlify-supabase/blob/main/client/src/pages/Orders/index.tsx"
click node_customers "https://github.com/t7451/unifyone-netlify-supabase/blob/main/client/src/pages/Customers.tsx"
click node_api_server "https://github.com/t7451/unifyone-netlify-supabase/blob/main/netlify/functions/server.ts"
click node_auth "https://github.com/t7451/unifyone-netlify-supabase/blob/main/server/_core/customAuthRoutes.ts"
click node_domain_data "https://github.com/t7451/unifyone-netlify-supabase/blob/main/server/db/gigWorker.ts"
click node_schema "https://github.com/t7451/unifyone-netlify-supabase/blob/main/drizzle/schema.ts"
click node_payment_routes "https://github.com/t7451/unifyone-netlify-supabase/blob/main/server/payments/stripe/webhooks.ts"
click node_mcp "https://github.com/t7451/unifyone-netlify-supabase/blob/main/netlify/functions/mcp.mts"
click node_kai "https://github.com/t7451/unifyone-netlify-supabase/blob/main/server/routers/ai/ai.service.ts"
click node_marketing "https://github.com/t7451/unifyone-netlify-supabase/blob/main/apps/unifyone/src/pages/api/waitlist.ts"

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_routes,node_dashboard,node_commerce_user toneBlue
class node_gig_iq,node_tax_tools,node_money_manager,node_rules toneAmber
class node_commerce_dashboard,node_catalog,node_orders,node_customers toneMint
class node_api_server,node_auth,node_domain_data,node_schema,node_payment_routes,node_worker toneRose
class node_mcp,node_kai,node_marketing toneIndigo
```

## Components

### User application

- [App routes](https://github.com/t7451/unifyone-netlify-supabase/blob/main/client/src/app/routes.tsx): `client/src/app/routes.tsx`
- [Dashboard shell](https://github.com/t7451/unifyone-netlify-supabase/blob/main/client/src/components/DashboardLayout.tsx): `client/src/components/DashboardLayout.tsx`

### Gig finance

- [GigIQ](https://github.com/t7451/unifyone-netlify-supabase/blob/main/client/src/pages/GigHome.tsx): `client/src/pages/GigHome.tsx`
- [Tax tools](https://github.com/t7451/unifyone-netlify-supabase/blob/main/client/src/pages/tools/QuarterlyTaxEstimator.tsx): `client/src/pages/tools/QuarterlyTaxEstimator.tsx`
- [Money Manager](https://github.com/t7451/unifyone-netlify-supabase/blob/main/client/src/pages/MoneyManager.tsx): `client/src/pages/MoneyManager.tsx`
- [Financial rules](https://github.com/t7451/unifyone-netlify-supabase/blob/main/server/lib/ruleEngine.ts): `server/lib/ruleEngine.ts`

### Commerce platform

- [Commerce dashboard](https://github.com/t7451/unifyone-netlify-supabase/blob/main/client/src/pages/Dashboard/index.tsx): `client/src/pages/Dashboard/index.tsx`
- [Products and themes](https://github.com/t7451/unifyone-netlify-supabase/blob/main/client/src/pages/Products/index.tsx): `client/src/pages/Products/index.tsx`
- [Orders and checkout](https://github.com/t7451/unifyone-netlify-supabase/blob/main/client/src/pages/Orders/index.tsx): `client/src/pages/Orders/index.tsx`
- [Customers](https://github.com/t7451/unifyone-netlify-supabase/blob/main/client/src/pages/Customers.tsx): `client/src/pages/Customers.tsx`

### API and data

- [API server](https://github.com/t7451/unifyone-netlify-supabase/blob/main/netlify/functions/server.ts): `netlify/functions/server.ts`
- [Authentication](https://github.com/t7451/unifyone-netlify-supabase/blob/main/server/_core/customAuthRoutes.ts): `server/_core/customAuthRoutes.ts`
- [Domain services](https://github.com/t7451/unifyone-netlify-supabase/blob/main/server/db/gigWorker.ts): `server/db/gigWorker.ts`
- [PostgreSQL schema](https://github.com/t7451/unifyone-netlify-supabase/blob/main/drizzle/schema.ts): `drizzle/schema.ts`
- [Payment webhooks](https://github.com/t7451/unifyone-netlify-supabase/blob/main/server/payments/stripe/webhooks.ts): `server/payments/stripe/webhooks.ts`

### Integrations and content

- [MCP interface](https://github.com/t7451/unifyone-netlify-supabase/blob/main/netlify/functions/mcp.mts): `netlify/functions/mcp.mts`
- [Kai assistant](https://github.com/t7451/unifyone-netlify-supabase/blob/main/server/routers/ai/ai.service.ts): `server/routers/ai/ai.service.ts`
- [Marketing site](https://github.com/t7451/unifyone-netlify-supabase/blob/main/apps/unifyone/src/pages/api/waitlist.ts): `apps/unifyone/src/pages/api/waitlist.ts`

### Other components

- **Gig worker**
- **Commerce user**

## Connections

- Gig worker → App routes: uses app
- Commerce user → App routes: uses app
- App routes → Dashboard shell: renders (evidence: `client/src/app/routes.tsx`)
- App routes → GigIQ: routes to
- App routes → Tax tools: routes to
- App routes → Money Manager: routes to
- App routes → Commerce dashboard: routes to (evidence: `client/src/app/routes.tsx`)
- App routes → Products and themes: routes to (evidence: `client/src/app/routes.tsx`)
- App routes → Orders and checkout: routes to (evidence: `client/src/app/routes.tsx`)
- App routes → Customers: routes to (evidence: `client/src/app/routes.tsx`)
- GigIQ → Money Manager: unifies earnings
- GigIQ → Tax tools: supports tax planning
- Money Manager → Financial rules: evaluates rules
- API server → PostgreSQL schema: uses data model
- API server → Authentication: dispatches routes
- Authentication → PostgreSQL schema: reads and writes (evidence: `server/_core/customAuthRoutes.ts`)
- Financial rules → PostgreSQL schema: reads and writes (evidence: `server/lib/ruleEngine.ts`)
- Financial rules → Money Manager: credits envelopes (evidence: `server/lib/ruleEngine.ts`)
- Payment webhooks → PostgreSQL schema: updates records (evidence: `server/payments/stripe/webhooks.ts`)
- API server → MCP interface: serves endpoint
- MCP interface → Commerce dashboard: exposes commerce data
- Kai assistant → Gig worker: answers questions
