# markrotar1000-code/windowsbyclearveiw architecture

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

- Interactive diagram: https://gitdiagram.com/markrotar1000-code/windowsbyclearveiw
- Repository: https://github.com/markrotar1000-code/windowsbyclearveiw
- Video tour (about a minute): https://gitdiagram.com/markrotar1000-code/windowsbyclearveiw/video

## Overview

Clearview Windows combines a public marketing and lead-intake site with a phone-first internal quoting and operations platform, plus a customer-facing assistant. The main business workflow is estimate intake through internal lead handling, quote/signature, job operations, and follow-up; the internal analytics helper describes the sales stages through collected revenue. Public pages and many internal screens are documented but not present in the supplied tree, so their implementation is not separately mapped. Edges reflect the excerpts, SOURCE INDEX references, or README; unsampled integrations are omitted.

Main entry points: [`functions/ask/api/chat.js`](https://github.com/markrotar1000-code/windowsbyclearveiw/blob/main/functions/ask/api/chat.js) (Ask chat API), [`functions/api/estimate.js`](https://github.com/markrotar1000-code/windowsbyclearveiw/blob/main/functions/api/estimate.js) (Estimate endpoint), [`workers/ops-cron/src/index.js`](https://github.com/markrotar1000-code/windowsbyclearveiw/blob/main/workers/ops-cron/src/index.js) (Scheduled worker), [`workers/ops-cron/src/backup.mjs`](https://github.com/markrotar1000-code/windowsbyclearveiw/blob/main/workers/ops-cron/src/backup.mjs) (D1 backup)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_public["Public experience"]
  node_marketing["Marketing content<br/>[site.ts]"]
end

subgraph group_intake["Lead intake"]
  node_estimate["Estimate endpoint<br/>[estimate.js]"]
  node_leadservice["Lead service tagging<br/>[lead-service.mjs]"]
  node_leads[("Lead storage<br/>[lead-service.mjs]")]
  node_leadalerts["Lead alerts<br/>[lead-alert.mjs]"]
end

subgraph group_assistant["Customer assistant"]
  node_askchat["Ask chat API<br/>[chat.js]"]
  node_askrouter["Intent routing<br/>[icm-router.mjs]"]
  node_specialists["Specialist prompts"]
  node_asktools["Answer tools<br/>[tools.mjs]"]
  node_embeddings["Guide embeddings<br/>[embeddings.mjs]"]
  node_vision["Photo analysis<br/>[vision.mjs]"]
  node_asklogs[("Ask log scrubbing<br/>[log-scrub.mjs]")]
end

subgraph group_operations["Internal operations"]
  node_internalapi["Command Center APIs"]
  node_quotes["Quote management<br/>[index.js]"]
  node_signing["Quote signing<br/>[quote-signing.mjs]"]
  node_jobs["Job operations<br/>[jobs.js]"]
  node_tasks["Follow-up queue<br/>[tasks.js]"]
  node_followups["Quote follow-up sync"]
  node_pipeline["Pipeline analytics"]
  node_d1[("D1 business data")]
end

subgraph group_scheduled["Scheduled services"]
  node_cron["Scheduled worker<br/>[index.js]"]
  node_backup["D1 backup<br/>[backup.mjs]"]
  node_digest["Follow-up digest<br/>[digest.mjs]"]
  node_r2[("Backup storage")]
  node_opsalert["Operations alert<br/>[lead-alert.mjs]"]
end

node_visitor(("Customer"))
node_internaluser(("Staff"))

node_visitor -.->|"views"| node_marketing
node_visitor -.->|"submits estimate"| node_estimate
node_marketing -.->|"offers intake"| node_estimate
node_estimate -->|"tags service"| node_leadservice
node_estimate -->|"saves lead"| node_leads
node_estimate -->|"sends alert"| node_leadalerts
node_visitor -.->|"asks question"| node_askchat
node_askchat -->|"routes intent"| node_askrouter
node_askchat -->|"selects prompt"| node_specialists
node_askchat -->|"runs tools"| node_asktools
node_askchat -->|"embeds query"| node_embeddings
node_askchat -->|"analyzes photo"| node_vision
node_askchat -->|"records turns"| node_asklogs
node_internaluser -.->|"uses Command Center"| node_internalapi
node_internalapi -.->|"reads and writes"| node_d1
node_internaluser -.->|"manages quotes"| node_quotes
node_quotes -.->|"uses signing"| node_signing
node_internaluser -.->|"manages jobs"| node_jobs
node_internaluser -.->|"views follow-ups"| node_tasks
node_tasks -->|"syncs reminders"| node_followups
node_internaluser -.->|"views analytics"| node_pipeline
node_pipeline -.->|"summarizes stages"| node_d1
node_cron -->|"runs backup"| node_backup
node_cron -->|"builds digest"| node_digest
node_backup -.->|"backs up"| node_d1
node_backup -.->|"stores backups"| node_r2
node_cron -->|"alerts on failure"| node_opsalert

click node_marketing "https://github.com/markrotar1000-code/windowsbyclearveiw/blob/main/src/data/site.ts"
click node_estimate "https://github.com/markrotar1000-code/windowsbyclearveiw/blob/main/functions/api/estimate.js"
click node_leadservice "https://github.com/markrotar1000-code/windowsbyclearveiw/blob/main/functions/_lib/lead-service.mjs"
click node_leads "https://github.com/markrotar1000-code/windowsbyclearveiw/blob/main/functions/_lib/lead-service.mjs"
click node_leadalerts "https://github.com/markrotar1000-code/windowsbyclearveiw/blob/main/functions/_lib/lead-alert.mjs"
click node_askchat "https://github.com/markrotar1000-code/windowsbyclearveiw/blob/main/functions/ask/api/chat.js"
click node_askrouter "https://github.com/markrotar1000-code/windowsbyclearveiw/blob/main/functions/ask/_lib/icm-router.mjs"
click node_specialists "https://github.com/markrotar1000-code/windowsbyclearveiw/blob/main/functions/ask/_lib/icm-specialists.mjs"
click node_asktools "https://github.com/markrotar1000-code/windowsbyclearveiw/blob/main/functions/ask/_lib/tools.mjs"
click node_embeddings "https://github.com/markrotar1000-code/windowsbyclearveiw/blob/main/functions/ask/_lib/embeddings.mjs"
click node_vision "https://github.com/markrotar1000-code/windowsbyclearveiw/blob/main/functions/ask/_lib/vision.mjs"
click node_asklogs "https://github.com/markrotar1000-code/windowsbyclearveiw/blob/main/functions/ask/_lib/log-scrub.mjs"
click node_internalapi "https://github.com/markrotar1000-code/windowsbyclearveiw/tree/main/functions/internal/api"
click node_quotes "https://github.com/markrotar1000-code/windowsbyclearveiw/blob/main/functions/internal/api/quotes/index.js"
click node_signing "https://github.com/markrotar1000-code/windowsbyclearveiw/blob/main/functions/internal/_lib/quote-signing.mjs"
click node_jobs "https://github.com/markrotar1000-code/windowsbyclearveiw/blob/main/functions/internal/api/jobs.js"
click node_tasks "https://github.com/markrotar1000-code/windowsbyclearveiw/blob/main/functions/internal/api/tasks.js"
click node_followups "https://github.com/markrotar1000-code/windowsbyclearveiw/blob/main/functions/internal/_lib/quote-follow-ups.mjs"
click node_pipeline "https://github.com/markrotar1000-code/windowsbyclearveiw/blob/main/functions/internal/_lib/pipeline-summary.mjs"
click node_cron "https://github.com/markrotar1000-code/windowsbyclearveiw/blob/main/workers/ops-cron/src/index.js"
click node_backup "https://github.com/markrotar1000-code/windowsbyclearveiw/blob/main/workers/ops-cron/src/backup.mjs"
click node_digest "https://github.com/markrotar1000-code/windowsbyclearveiw/blob/main/workers/ops-cron/src/digest.mjs"
click node_opsalert "https://github.com/markrotar1000-code/windowsbyclearveiw/blob/main/functions/_lib/lead-alert.mjs"

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_marketing toneBlue
class node_estimate,node_leadservice,node_leads,node_leadalerts toneAmber
class node_askchat,node_askrouter,node_specialists,node_asktools,node_embeddings,node_vision,node_asklogs toneMint
class node_internalapi,node_quotes,node_signing,node_jobs,node_tasks,node_followups,node_pipeline,node_d1 toneRose
class node_cron,node_backup,node_digest,node_r2,node_opsalert,node_visitor,node_internaluser toneIndigo
```

## Components

### Public experience

- [Marketing content](https://github.com/markrotar1000-code/windowsbyclearveiw/blob/main/src/data/site.ts): `src/data/site.ts`

### Lead intake

- [Estimate endpoint](https://github.com/markrotar1000-code/windowsbyclearveiw/blob/main/functions/api/estimate.js): `functions/api/estimate.js`
- [Lead service tagging](https://github.com/markrotar1000-code/windowsbyclearveiw/blob/main/functions/_lib/lead-service.mjs): `functions/_lib/lead-service.mjs`
- [Lead storage](https://github.com/markrotar1000-code/windowsbyclearveiw/blob/main/functions/_lib/lead-service.mjs): `functions/_lib/lead-service.mjs`
- [Lead alerts](https://github.com/markrotar1000-code/windowsbyclearveiw/blob/main/functions/_lib/lead-alert.mjs): `functions/_lib/lead-alert.mjs`

### Customer assistant

- [Ask chat API](https://github.com/markrotar1000-code/windowsbyclearveiw/blob/main/functions/ask/api/chat.js): `functions/ask/api/chat.js`
- [Intent routing](https://github.com/markrotar1000-code/windowsbyclearveiw/blob/main/functions/ask/_lib/icm-router.mjs): `functions/ask/_lib/icm-router.mjs`
- [Specialist prompts](https://github.com/markrotar1000-code/windowsbyclearveiw/blob/main/functions/ask/_lib/icm-specialists.mjs): `functions/ask/_lib/icm-specialists.mjs`
- [Answer tools](https://github.com/markrotar1000-code/windowsbyclearveiw/blob/main/functions/ask/_lib/tools.mjs): `functions/ask/_lib/tools.mjs`
- [Guide embeddings](https://github.com/markrotar1000-code/windowsbyclearveiw/blob/main/functions/ask/_lib/embeddings.mjs): `functions/ask/_lib/embeddings.mjs`
- [Photo analysis](https://github.com/markrotar1000-code/windowsbyclearveiw/blob/main/functions/ask/_lib/vision.mjs): `functions/ask/_lib/vision.mjs`
- [Ask log scrubbing](https://github.com/markrotar1000-code/windowsbyclearveiw/blob/main/functions/ask/_lib/log-scrub.mjs): `functions/ask/_lib/log-scrub.mjs`

### Internal operations

- [Command Center APIs](https://github.com/markrotar1000-code/windowsbyclearveiw/tree/main/functions/internal/api): `functions/internal/api`
- [Quote management](https://github.com/markrotar1000-code/windowsbyclearveiw/blob/main/functions/internal/api/quotes/index.js): `functions/internal/api/quotes/index.js`
- [Quote signing](https://github.com/markrotar1000-code/windowsbyclearveiw/blob/main/functions/internal/_lib/quote-signing.mjs): `functions/internal/_lib/quote-signing.mjs`
- [Job operations](https://github.com/markrotar1000-code/windowsbyclearveiw/blob/main/functions/internal/api/jobs.js): `functions/internal/api/jobs.js`
- [Follow-up queue](https://github.com/markrotar1000-code/windowsbyclearveiw/blob/main/functions/internal/api/tasks.js): `functions/internal/api/tasks.js`
- [Quote follow-up sync](https://github.com/markrotar1000-code/windowsbyclearveiw/blob/main/functions/internal/_lib/quote-follow-ups.mjs): `functions/internal/_lib/quote-follow-ups.mjs`
- [Pipeline analytics](https://github.com/markrotar1000-code/windowsbyclearveiw/blob/main/functions/internal/_lib/pipeline-summary.mjs): `functions/internal/_lib/pipeline-summary.mjs`
- **D1 business data**

### Scheduled services

- [Scheduled worker](https://github.com/markrotar1000-code/windowsbyclearveiw/blob/main/workers/ops-cron/src/index.js): `workers/ops-cron/src/index.js`
- [D1 backup](https://github.com/markrotar1000-code/windowsbyclearveiw/blob/main/workers/ops-cron/src/backup.mjs): `workers/ops-cron/src/backup.mjs`
- [Follow-up digest](https://github.com/markrotar1000-code/windowsbyclearveiw/blob/main/workers/ops-cron/src/digest.mjs): `workers/ops-cron/src/digest.mjs`
- **Backup storage**
- [Operations alert](https://github.com/markrotar1000-code/windowsbyclearveiw/blob/main/functions/_lib/lead-alert.mjs): `functions/_lib/lead-alert.mjs`

### Other components

- **Customer**
- **Staff**

## Connections

- Customer → Marketing content: views (evidence: `README.md`)
- Customer → Estimate endpoint: submits estimate (evidence: `README.md`)
- Marketing content → Estimate endpoint: offers intake (evidence: `README.md`)
- Estimate endpoint → Lead service tagging: tags service (evidence: `functions/api/estimate.js`)
- Estimate endpoint → Lead storage: saves lead (evidence: `functions/api/estimate.js`)
- Estimate endpoint → Lead alerts: sends alert (evidence: `functions/api/estimate.js`)
- Customer → Ask chat API: asks question (evidence: `README.md`)
- Ask chat API → Intent routing: routes intent (evidence: `functions/ask/api/chat.js`)
- Ask chat API → Specialist prompts: selects prompt (evidence: `functions/ask/api/chat.js`)
- Ask chat API → Answer tools: runs tools (evidence: `functions/ask/api/chat.js`)
- Ask chat API → Guide embeddings: embeds query (evidence: `functions/ask/api/chat.js`)
- Ask chat API → Photo analysis: analyzes photo (evidence: `functions/ask/api/chat.js`)
- Ask chat API → Ask log scrubbing: records turns (evidence: `functions/ask/api/chat.js`)
- Staff → Command Center APIs: uses Command Center (evidence: `README.md`)
- Command Center APIs → D1 business data: reads and writes (evidence: `README.md`)
- Staff → Quote management: manages quotes (evidence: `README.md`)
- Quote management → Quote signing: uses signing (evidence: `README.md`)
- Staff → Job operations: manages jobs (evidence: `README.md`)
- Staff → Follow-up queue: views follow-ups (evidence: `README.md`)
- Follow-up queue → Quote follow-up sync: syncs reminders (evidence: `functions/internal/api/tasks.js`)
- Staff → Pipeline analytics: views analytics (evidence: `README.md`)
- Pipeline analytics → D1 business data: summarizes stages (evidence: `README.md`)
- Scheduled worker → D1 backup: runs backup (evidence: `workers/ops-cron/src/index.js`)
- Scheduled worker → Follow-up digest: builds digest (evidence: `workers/ops-cron/src/index.js`)
- D1 backup → D1 business data: backs up (evidence: `README.md`)
- D1 backup → Backup storage: stores backups (evidence: `README.md`)
- Scheduled worker → Operations alert: alerts on failure (evidence: `workers/ops-cron/src/index.js`)
