graph TB
  subgraph mono["haulx-platform monorepo"]
    direction TB
    subgraph apps["apps/ (npm workspaces)"]
      ops["apps/ops
Ops Dashboard + Mobile"]
      store["apps/store
Storefront + Store Admin"]
    end
    subgraph plat["platform/"]
      admin["platform/admin
Platform Admin UI"]
      landing["platform/landing
Marketing Landing"]
      provision["platform/provision
Provisioning Worker"]
    end
    subgraph infra["scripts/ + .github/"]
      deploy["scripts/deploy.js
Root deploy orchestrator"]
      deployAll["scripts/deploy-all.js
Multi-tenant deploy"]
      gha[".github/workflows/
CI/CD pipelines"]
    end
  end
  ops -->|"Cloudflare Pages"| cfOps["Per-Tenant
Ops Dashboard"]
  store -->|"Cloudflare Pages"| cfStore["Per-Tenant
Storefront + Admin"]
  admin -->|"Cloudflare Pages"| cfAdmin["Platform Admin"]
  provision -->|"Cloudflare Worker"| cfProv["Provisioning API"]
  landing -->|"Cloudflare Pages"| cfLand["Landing Page"]
            

graph LR
  subgraph edge["Cloudflare Edge (per tenant)"]
    pages["Pages Project
(static assets)"]
    funcs["Pages Functions
(serverless API)"]
    d1["D1 Database
(SQLite)"]
    kv["KV Namespace
(sessions/cache)"]
    r2["R2 Bucket
(images/files)"]
    cron["Cron Worker
(scheduled tasks)"]
  end

  browser["Browser"] -->|"GET /"| pages
  browser -->|"POST /api"| funcs
  funcs -->|"SQL queries"| d1
  funcs -->|"get/put sessions"| kv
  funcs -->|"upload/serve images"| r2
  cron -->|"scheduled jobs"| d1
  cron -->|"sync data"| kv

  subgraph shared["Shared Platform Resources"]
    registry["platform-registry D1"]
    provWorker["Provisioning Worker"]
    adminUI["Platform Admin"]
  end

  adminUI -->|"manage tenants"| registry
  provWorker -->|"create resources"| edge
  provWorker -->|"register tenant"| registry
            

graph TB
  subgraph platform["Platform Layer"]
    registryDB["platform-registry D1
(tenant metadata)"]
    provisionW["Provisioning Worker"]
    adminPanel["Platform Admin"]
    deployScript["deploy-all.js"]
  end

  subgraph tenantA["Tenant: Haulx Recycling"]
    pagesA["Pages: haulx-dashboard"]
    d1A["D1: haulx-dashboard-db"]
    kvA["KV: haulx-ops-kv"]
    r2A["R2: haulx-ops-assets"]
    storeA["Pages: haulx-online"]
    storeAdminA["Pages: haulx-admin"]
    storeD1A["D1: haulx-online-db"]
  end

  subgraph tenantB["Tenant: Acme Hauling"]
    pagesB["Pages: acme-dashboard"]
    d1B["D1: acme-ops-db"]
    kvB["KV: acme-ops-kv"]
    r2B["R2: acme-ops-assets"]
  end

  registryDB -->|"tracks"| tenantA
  registryDB -->|"tracks"| tenantB
  deployScript -->|"reads registry"| registryDB
  deployScript -->|"deploys to each"| tenantA
  deployScript -->|"deploys to each"| tenantB
            

flowchart TD
  push["Push to main branch"] --> pathCheck{"Path-based trigger"}
  pathCheck -->|"apps/ops/** changed"| opsWf["deploy-ops.yml"]
  pathCheck -->|"apps/store/** changed"| storeWf["deploy-store.yml"]

  opsWf --> canaryOps["Job: canary"]
  canaryOps --> buildOps["Build ops for Haulx tenant
TENANT_NAME=Haulx
TENANT_DOMAIN=dashboard.haulxrecycling.com"]
  buildOps --> deployCanary["wrangler pages deploy
--project-name=haulx-dashboard"]
  deployCanary --> healthCheck["Health Check
POST /api action=health"]
  healthCheck -->|"200 OK"| deployAllOps["Job: deploy-all
node deploy-all.js --app ops --exclude haulx"]
  healthCheck -->|"Not 200"| failPipeline["Pipeline FAILS
Other tenants NOT deployed"]
  deployAllOps --> readReg["Read tenant list from
platform-registry D1"]
  readReg --> batchDeploy["Deploy in batches of 3
Build per tenant, wrangler pages deploy"]

  storeWf --> canaryStore["Job: canary"]
  canaryStore --> buildStore["Build store for Haulx tenant"]
  buildStore --> deploySf["Deploy storefront + admin"]
  deploySf --> deployAllStore["Job: deploy-all
node deploy-all.js --app store --exclude haulx"]
            

flowchart LR
  run["npm run deploy"] --> loadCache["Load .deploy-cache.json"]
  loadCache --> hashFiles["SHA-256 hash
all tracked source files"]
  hashFiles --> compare{"Any hash
changed?"}
  compare -->|"No"| skip["Skip deploy
(nothing changed)"]
  compare -->|"Yes"| identify["Identify changed targets
(dashboard, mobile, etc.)"]
  identify --> incBuild["Incremental build
--only=dashboard,mobile"]
  incBuild --> wrangler["wrangler pages deploy"]
  wrangler --> updateCache["Update .deploy-cache.json
with new hashes"]
            

flowchart TD
  subgraph source["Source Templates (apps/ops/templates/)"]
    main["Dashboard.html
(entry point)"]
    css["Dashboard_CSS.html"]
    header["Dashboard_Header.html"]
    jobs["Dashboard_Jobs.html"]
    dispatch["Dashboard_Dispatch.html"]
    jsFile["Dashboard_JS.html"]
    more["...18 more templates"]
  end

  main -->|"include"| css
  main -->|"include"| header
  main -->|"include"| jobs
  main -->|"include"| dispatch
  main -->|"include"| jsFile
  main -->|"include"| more

  subgraph buildStep["build.js processing"]
    resolve["Resolve all includes
recursively"]
    inject["Inject google.script.run shim
into head"]
    overlay["Inject crew-login overlay
after body"]
    tenant["Replace TENANT_NAME,
TENANT_DOMAIN, etc."]
  end

  main --> resolve
  resolve --> inject
  inject --> overlay
  overlay --> tenant

  subgraph output["Build Output (apps/ops/dist/)"]
    indexHtml["index.html"]
    mobileHtml["mobile.html"]
    estimateHtml["estimate.html"]
    manifest["manifest.json"]
    funcsDir["functions/ (copied)"]
  end

  tenant --> indexHtml
  tenant --> mobileHtml
  tenant --> estimateHtml
  tenant --> manifest
  tenant --> funcsDir
            

sequenceDiagram
  participant Client as Admin UI / API
  participant PW as Provisioning Worker
  participant CF as Cloudflare API
  participant Reg as platform-registry D1

  Client->>PW: POST /provision
{company_name, owner_email, industry}
  PW->>PW: Validate input, generate slug
  PW->>Reg: Check slug uniqueness
  Reg-->>PW: OK (no conflict)

  rect rgb(30, 40, 30)
    Note over PW,CF: Resource Creation (with rollback)
    PW->>CF: Create D1 database ({slug}-ops-db)
    CF-->>PW: database_id
    PW->>CF: Run schema SQL
    PW->>CF: Run seed SQL (admin user, defaults)
    PW->>CF: Create KV namespace ({slug}-ops-kv)
    CF-->>PW: namespace_id
    PW->>CF: Create R2 bucket ({slug}-ops-assets)
    CF-->>PW: bucket created
    PW->>CF: Create Pages project ({slug}-dashboard)
    CF-->>PW: project created
  end

  PW->>Reg: INSERT INTO tenants
(slug, ids, domain, status=active)
  PW-->>Client: 201 {tenant_id, slug, domain}
            

flowchart TD
  trigger["Admin clicks 'Enable Storefront'"] --> apiCall["POST /api
action: enableStorefront, slug"]
  apiCall --> provCall["Platform Admin calls
Provisioning Worker
POST /provision-store"]

  provCall --> createD1["Create D1: {slug}-store-db
Run store schema + seed"]
  provCall --> createKV["Create KV: {slug}-store-kv"]
  createD1 --> createSfPages["Create Pages: {slug}-storefront"]
  createKV --> createAdminPages["Create Pages: {slug}-store-admin"]

  createSfPages --> updateReg["Update registry:
store_enabled = true
store_pages_project, store_d1_database_id, etc."]
  createAdminPages --> updateReg

  updateReg --> done["Tenant now has ops + store"]
            

flowchart LR
  subgraph sfDeploy["Storefront Deploy"]
    sf1["setupStorefrontFunctions()"]
    sf2["Create temp functions/
- storefront-api.js
- _shared/ (d1-backend, d1-router, kv-cache)"]
    sf3["wrangler pages deploy
dist-storefront/
--project-name=haulx-online"]
    sf4["cleanFunctions()
Remove temp functions/"]
    sf1 --> sf2 --> sf3 --> sf4
  end

  subgraph adminDeploy["Store Admin Deploy"]
    ad1["setupAdminFunctions()"]
    ad2["Create temp functions/
- api/[[path]].js (admin-api)
- _shared/"]
    ad3["wrangler pages deploy
dist-admin/
--project-name=haulx-admin"]
    ad4["cleanFunctions()"]
    ad1 --> ad2 --> ad3 --> ad4
  end