# wkimball1/elitehousing architecture

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

- Interactive diagram: https://gitdiagram.com/wkimball1/elitehousing
- Repository: https://github.com/wkimball1/elitehousing

## Overview

Home Renovation Systems is a renovation-company website with a public-facing catalog and contact experience, plus a hidden employee dashboard. Visitors browse product categories or send inquiries; employees manage customer records, jobs/invoices, inventory, and related operational views. Supabase provides application data and authentication, while Stripe supports invoice and billing operations. The tree and excerpts support the main route and several service calls; other dashboard pages and integrations are represented at subsystem level where their implementation was not sampled.

Main entry points: [`app/admin/dashboard/layout.tsx`](https://github.com/wkimball1/elitehousing/blob/main/app/admin/dashboard/layout.tsx) (Dashboard shell), [`utils/supabase/client.ts`](https://github.com/wkimball1/elitehousing/blob/main/utils/supabase/client.ts) (Browser client), [`app/admin/dashboard/customer/[id]/page.tsx`](https://github.com/wkimball1/elitehousing/blob/main/app/admin/dashboard/customer/%5Bid%5D/page.tsx) (Customer jobs and invoices), [`app/admin/dashboard/customers/page.tsx`](https://github.com/wkimball1/elitehousing/blob/main/app/admin/dashboard/customers/page.tsx) (Customer records)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_public["Public website"]
  node_home["Home page<br/>[page.tsx]"]
  node_catalog["Product categories"]
  node_contact["Contact form<br/>[page.tsx]"]
end

subgraph group_admin["Employee dashboard"]
  node_login["Admin sign-in<br/>[page.tsx]"]
  node_signout["Sign-out route<br/>[route.ts]"]
  node_dashboard["Dashboard shell<br/>[layout.tsx]"]
  node_customers["Customer records<br/>[page.tsx]"]
  node_customerwork["Customer jobs and invoices<br/>[page.tsx]"]
  node_jobs["Job management<br/>[page.tsx]"]
  node_inventory["Inventory management<br/>[page.tsx]"]
  node_employees["Employee records<br/>[page.tsx]"]
  node_sales["Sales reporting<br/>[page.tsx]"]
  node_orders["Orders view<br/>[page.tsx]"]
end

subgraph group_services["Data and integrations"]
  node_email["Email sender<br/>[send-email.ts]"]
  node_supabaseclient["Browser client<br/>[client.ts]"]
  node_supabaseserver["Server client<br/>[server.ts]"]
  node_datastore[("Supabase data")]
  node_serveractions["Data actions<br/>[supabaseServer.ts]"]
  node_adminops["Database operations<br/>[admin.ts]"]
  node_stripe["Stripe billing<br/>[server.ts]"]
  node_stripewebhook["Stripe webhook<br/>[route.ts]"]
  node_emailroute["Email endpoint<br/>[route.ts]"]
end

subgraph group_shared["Shared application layer"]
  node_authbutton["Auth controls<br/>[AuthButton.tsx]"]
  node_navbar["Navigation<br/>[NavBar.tsx]"]
  node_customerpdf["Statement PDF"]
  node_types["Database types<br/>[types_db.ts]"]
end

node_visitor(("Visitor"))
node_employee(("Employee"))

node_visitor -->|"browses"| node_home
node_home -->|"renders"| node_navbar
node_visitor -->|"browses"| node_catalog
node_visitor -->|"submits inquiry"| node_contact
node_contact -->|"sends message"| node_email
node_employee -->|"signs in"| node_login
node_login -->|"renders"| node_authbutton
node_authbutton -->|"checks session"| node_supabaseclient
node_authbutton -->|"posts sign-out"| node_signout
node_employee -->|"uses"| node_dashboard
node_dashboard -.->|"opens section"| node_customers
node_dashboard -.->|"opens section"| node_jobs
node_dashboard -.->|"opens section"| node_inventory
node_dashboard -.->|"opens section"| node_employees
node_dashboard -.->|"opens section"| node_sales
node_dashboard -.->|"opens section"| node_orders
node_customers -->|"queries data"| node_supabaseclient
node_employees -->|"queries data"| node_supabaseserver
node_jobs -->|"queries data"| node_supabaseclient
node_inventory -->|"queries products"| node_supabaseclient
node_inventory -->|"creates products"| node_serveractions
node_customerwork -->|"loads customer data"| node_supabaseclient
node_customerwork -->|"creates invoices"| node_stripe
node_customerwork -->|"saves job"| node_serveractions
node_customerwork -->|"generates statement"| node_customerpdf
node_serveractions -->|"delegates writes"| node_adminops
node_adminops -->|"reads and writes"| node_datastore
node_supabaseclient -.->|"accesses"| node_datastore
node_supabaseserver -.->|"accesses"| node_datastore
node_stripewebhook -->|"updates records"| node_adminops
node_stripe -->|"uses session client"| node_supabaseserver
node_emailroute -.->|"uses sender"| node_email
node_customers -->|"loads billing data"| node_stripe
node_customers -->|"uses schema types"| node_types
node_inventory -->|"uses schema types"| node_types

click node_home "https://github.com/wkimball1/elitehousing/blob/main/app/page.tsx"
click node_catalog "https://github.com/wkimball1/elitehousing/tree/main/app/client"
click node_contact "https://github.com/wkimball1/elitehousing/blob/main/app/client/contact/page.tsx"
click node_email "https://github.com/wkimball1/elitehousing/blob/main/utils/send-email.ts"
click node_login "https://github.com/wkimball1/elitehousing/blob/main/app/admin/page.tsx"
click node_authbutton "https://github.com/wkimball1/elitehousing/blob/main/components/AuthButton.tsx"
click node_signout "https://github.com/wkimball1/elitehousing/blob/main/app/api/auth/signout/route.ts"
click node_dashboard "https://github.com/wkimball1/elitehousing/blob/main/app/admin/dashboard/layout.tsx"
click node_customers "https://github.com/wkimball1/elitehousing/blob/main/app/admin/dashboard/customers/page.tsx"
click node_customerwork "https://github.com/wkimball1/elitehousing/blob/main/app/admin/dashboard/customer/%5Bid%5D/page.tsx"
click node_jobs "https://github.com/wkimball1/elitehousing/blob/main/app/admin/dashboard/jobs/page.tsx"
click node_inventory "https://github.com/wkimball1/elitehousing/blob/main/app/admin/dashboard/inventory/page.tsx"
click node_employees "https://github.com/wkimball1/elitehousing/blob/main/app/admin/dashboard/employees/page.tsx"
click node_sales "https://github.com/wkimball1/elitehousing/blob/main/app/admin/dashboard/sales/page.tsx"
click node_orders "https://github.com/wkimball1/elitehousing/blob/main/app/admin/dashboard/orders/page.tsx"
click node_supabaseclient "https://github.com/wkimball1/elitehousing/blob/main/utils/supabase/client.ts"
click node_supabaseserver "https://github.com/wkimball1/elitehousing/blob/main/utils/supabase/server.ts"
click node_serveractions "https://github.com/wkimball1/elitehousing/blob/main/components/supabaseServer.ts"
click node_adminops "https://github.com/wkimball1/elitehousing/blob/main/utils/supabase/admin.ts"
click node_stripe "https://github.com/wkimball1/elitehousing/blob/main/utils/stripe/server.ts"
click node_stripewebhook "https://github.com/wkimball1/elitehousing/blob/main/app/api/webhooks/stripe/route.ts"
click node_emailroute "https://github.com/wkimball1/elitehousing/blob/main/app/api/email/route.ts"
click node_navbar "https://github.com/wkimball1/elitehousing/blob/main/components/NavBar.tsx"
click node_customerpdf "https://github.com/wkimball1/elitehousing/blob/main/components/CustomerDocument.tsx"
click node_types "https://github.com/wkimball1/elitehousing/blob/main/types_db.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_home,node_catalog,node_contact toneBlue
class node_login,node_signout,node_dashboard,node_customers,node_customerwork,node_jobs,node_inventory,node_employees,node_sales,node_orders toneAmber
class node_email,node_supabaseclient,node_supabaseserver,node_datastore,node_serveractions,node_adminops,node_stripe,node_stripewebhook,node_emailroute toneMint
class node_authbutton,node_navbar,node_customerpdf,node_types toneRose
class node_visitor,node_employee toneIndigo
```

## Components

### Public website

- [Home page](https://github.com/wkimball1/elitehousing/blob/main/app/page.tsx): `app/page.tsx`
- [Product categories](https://github.com/wkimball1/elitehousing/tree/main/app/client): `app/client`
- [Contact form](https://github.com/wkimball1/elitehousing/blob/main/app/client/contact/page.tsx): `app/client/contact/page.tsx`

### Employee dashboard

- [Admin sign-in](https://github.com/wkimball1/elitehousing/blob/main/app/admin/page.tsx): `app/admin/page.tsx`
- [Sign-out route](https://github.com/wkimball1/elitehousing/blob/main/app/api/auth/signout/route.ts): `app/api/auth/signout/route.ts`
- [Dashboard shell](https://github.com/wkimball1/elitehousing/blob/main/app/admin/dashboard/layout.tsx): `app/admin/dashboard/layout.tsx`
- [Customer records](https://github.com/wkimball1/elitehousing/blob/main/app/admin/dashboard/customers/page.tsx): `app/admin/dashboard/customers/page.tsx`
- [Customer jobs and invoices](https://github.com/wkimball1/elitehousing/blob/main/app/admin/dashboard/customer/%5Bid%5D/page.tsx): `app/admin/dashboard/customer/[id]/page.tsx`
- [Job management](https://github.com/wkimball1/elitehousing/blob/main/app/admin/dashboard/jobs/page.tsx): `app/admin/dashboard/jobs/page.tsx`
- [Inventory management](https://github.com/wkimball1/elitehousing/blob/main/app/admin/dashboard/inventory/page.tsx): `app/admin/dashboard/inventory/page.tsx`
- [Employee records](https://github.com/wkimball1/elitehousing/blob/main/app/admin/dashboard/employees/page.tsx): `app/admin/dashboard/employees/page.tsx`
- [Sales reporting](https://github.com/wkimball1/elitehousing/blob/main/app/admin/dashboard/sales/page.tsx): `app/admin/dashboard/sales/page.tsx`
- [Orders view](https://github.com/wkimball1/elitehousing/blob/main/app/admin/dashboard/orders/page.tsx): `app/admin/dashboard/orders/page.tsx`

### Data and integrations

- [Email sender](https://github.com/wkimball1/elitehousing/blob/main/utils/send-email.ts): `utils/send-email.ts`
- [Browser client](https://github.com/wkimball1/elitehousing/blob/main/utils/supabase/client.ts): `utils/supabase/client.ts`
- [Server client](https://github.com/wkimball1/elitehousing/blob/main/utils/supabase/server.ts): `utils/supabase/server.ts`
- **Supabase data**
- [Data actions](https://github.com/wkimball1/elitehousing/blob/main/components/supabaseServer.ts): `components/supabaseServer.ts`
- [Database operations](https://github.com/wkimball1/elitehousing/blob/main/utils/supabase/admin.ts): `utils/supabase/admin.ts`
- [Stripe billing](https://github.com/wkimball1/elitehousing/blob/main/utils/stripe/server.ts): `utils/stripe/server.ts`
- [Stripe webhook](https://github.com/wkimball1/elitehousing/blob/main/app/api/webhooks/stripe/route.ts): `app/api/webhooks/stripe/route.ts`
- [Email endpoint](https://github.com/wkimball1/elitehousing/blob/main/app/api/email/route.ts): `app/api/email/route.ts`

### Shared application layer

- [Auth controls](https://github.com/wkimball1/elitehousing/blob/main/components/AuthButton.tsx): `components/AuthButton.tsx`
- [Navigation](https://github.com/wkimball1/elitehousing/blob/main/components/NavBar.tsx): `components/NavBar.tsx`
- [Statement PDF](https://github.com/wkimball1/elitehousing/blob/main/components/CustomerDocument.tsx): `components/CustomerDocument.tsx`
- [Database types](https://github.com/wkimball1/elitehousing/blob/main/types_db.ts): `types_db.ts`

### Other components

- **Visitor**
- **Employee**

## Connections

- Visitor → Home page: browses
- Home page → Navigation: renders (evidence: `app/page.tsx`)
- Visitor → Product categories: browses
- Visitor → Contact form: submits inquiry (evidence: `app/client/contact/page.tsx`)
- Contact form → Email sender: sends message (evidence: `app/client/contact/page.tsx`)
- Employee → Admin sign-in: signs in
- Admin sign-in → Auth controls: renders (evidence: `app/admin/page.tsx`)
- Auth controls → Browser client: checks session (evidence: `components/AuthButton.tsx`)
- Auth controls → Sign-out route: posts sign-out (evidence: `components/AuthButton.tsx`)
- Employee → Dashboard shell: uses
- Dashboard shell → Customer records: opens section
- Dashboard shell → Job management: opens section
- Dashboard shell → Inventory management: opens section
- Dashboard shell → Employee records: opens section
- Dashboard shell → Sales reporting: opens section
- Dashboard shell → Orders view: opens section
- Customer records → Browser client: queries data (evidence: `app/admin/dashboard/customers/page.tsx`)
- Employee records → Server client: queries data (evidence: `app/admin/dashboard/employees/page.tsx`)
- Job management → Browser client: queries data (evidence: `app/admin/dashboard/jobs/page.tsx`)
- Inventory management → Browser client: queries products (evidence: `app/admin/dashboard/inventory/page.tsx`)
- Inventory management → Data actions: creates products (evidence: `app/admin/dashboard/inventory/page.tsx`)
- Customer jobs and invoices → Browser client: loads customer data (evidence: `app/admin/dashboard/customer/[id]/page.tsx`)
- Customer jobs and invoices → Stripe billing: creates invoices (evidence: `app/admin/dashboard/customer/[id]/page.tsx`)
- Customer jobs and invoices → Data actions: saves job (evidence: `app/admin/dashboard/customer/[id]/page.tsx`)
- Customer jobs and invoices → Statement PDF: generates statement (evidence: `app/admin/dashboard/customer/[id]/page.tsx`)
- Data actions → Database operations: delegates writes (evidence: `components/supabaseServer.ts`)
- Database operations → Supabase data: reads and writes (evidence: `utils/supabase/admin.ts`)
- Browser client → Supabase data: accesses
- Server client → Supabase data: accesses
- Stripe webhook → Database operations: updates records (evidence: `app/api/webhooks/stripe/route.ts`)
- Stripe billing → Server client: uses session client (evidence: `utils/stripe/server.ts`)
- Email endpoint → Email sender: uses sender
- Customer records → Stripe billing: loads billing data (evidence: `app/admin/dashboard/customers/page.tsx`)
- Customer records → Database types: uses schema types (evidence: `app/admin/dashboard/customers/page.tsx`)
- Inventory management → Database types: uses schema types (evidence: `app/admin/dashboard/inventory/page.tsx`)
