# architectural-flashing-supply/afs-platform architecture

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

- Interactive diagram: https://gitdiagram.com/architectural-flashing-supply/afs-platform
- Repository: https://github.com/architectural-flashing-supply/afs-platform

## Overview

AFS is a metal-roofing fabrication and project-services platform. Customers configure products or upload plans for AI takeoff, submit quote requests, and receive approvals that can enter production; account and tracking tools support fulfillment. Staff use command-center and admin workflows to review requests, manage pricing and jobs, and dispatch production. Architects, field users, bid monitoring, HailView, and profile design are distinct capabilities. Source excerpts establish several key calls; the README is empty, so broader page/API connections are represented conservatively from indexed references.

Main entry points: [`app/api/admin/command-center/approve-quote-request/route.ts`](https://github.com/architectural-flashing-supply/afs-platform/blob/main/app/api/admin/command-center/approve-quote-request/route.ts) (Request approval), [`app/quote/page.tsx`](https://github.com/architectural-flashing-supply/afs-platform/blob/main/app/quote/page.tsx) (Quote builder), [`app/api/chat/route.ts`](https://github.com/architectural-flashing-supply/afs-platform/blob/main/app/api/chat/route.ts) (Chat assistant), [`app/studio/draft/page.tsx`](https://github.com/architectural-flashing-supply/afs-platform/blob/main/app/studio/draft/page.tsx) (FlashDraft studio)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_customer["Customer experience"]
  node_quote["Quote builder<br/>[page.tsx]"]
  node_quoteapi["Quote requests<br/>[route.ts]"]
  node_account["Customer account"]
  node_track["Order tracking<br/>[page.tsx]"]
  node_hail["HailView<br/>[page.tsx]"]
  node_chat["Chat assistant<br/>[route.ts]"]
end

subgraph group_design["Design and estimating"]
  node_upload["Plan takeoff<br/>[page.tsx]"]
  node_takeoff["AI takeoff<br/>[route.ts]"]
  node_studio["FlashDraft studio<br/>[page.tsx]"]
  node_viewer["Profile viewer"]
  node_catalog["Product catalog<br/>[catalog.ts]"]
  node_colors["Material color rules"]
  node_architects["Architect resources"]
  node_specs["Specification writer<br/>[page.tsx]"]
end

subgraph group_operations["Sales and operations"]
  node_command["Command center"]
  node_approval["Request approval<br/>[route.ts]"]
  node_admin["Admin operations"]
  node_bid["Bid monitoring<br/>[page.tsx]"]
  node_pricing[("Pricing ledger<br/>[ledger.ts]")]
end

subgraph group_production["Fabrication and delivery"]
  node_productionq[("Production queue<br/>[shop-queue.ts]")]
  node_machine["Machine integration<br/>[route.ts]"]
  node_delivery["Delivery and dispatch<br/>[auto-schedule.ts]"]
end

subgraph group_platform["Shared services"]
  node_knowledge["Knowledge search<br/>[index.ts]"]
  node_supabase[("Supabase services<br/>[admin.ts]")]
  node_email["Email delivery<br/>[send.ts]"]
end

node_visitor(("Customer"))
node_anthropic["Anthropic AI"]
node_pathfinder["Pathfinder service"]

node_visitor -->|"configures items"| node_quote
node_quote -->|"loads catalog"| node_catalog
node_quote -->|"checks finish"| node_colors
node_quote -->|"submits request"| node_quoteapi
node_quoteapi -->|"stores request"| node_supabase
node_quoteapi -->|"sends receipt"| node_email
node_visitor -->|"uploads plans"| node_upload
node_upload -->|"requests analysis"| node_takeoff
node_takeoff -->|"reads file, saves results"| node_supabase
node_takeoff -->|"analyzes plan"| node_anthropic
node_visitor -->|"designs profile"| node_studio
node_studio -->|"renders geometry"| node_viewer
node_studio -->|"loads materials"| node_catalog
node_studio -->|"checks material rules"| node_colors
node_visitor -.->|"uses design resources"| node_architects
node_architects -.->|"opens specification tool"| node_specs
node_visitor -.->|"manages orders"| node_account
node_account -.->|"views fulfillment"| node_track
node_admin -.->|"reviews work"| node_command
node_command -.->|"approves request"| node_approval
node_admin -.->|"monitors opportunities"| node_bid
node_admin -.->|"maintains pricing"| node_pricing
node_approval -->|"records approval"| node_supabase
node_approval -->|"pushes job"| node_pathfinder
node_approval -->|"notifies customer"| node_email
node_approval -.->|"creates production job"| node_productionq
node_productionq -.->|"feeds machine jobs"| node_machine
node_productionq -.->|"coordinates fulfillment"| node_delivery
node_visitor -->|"checks storm exposure"| node_hail
node_visitor -.->|"asks product questions"| node_chat
node_chat -->|"searches knowledge"| node_knowledge
node_chat -.->|"streams response"| node_anthropic
node_chat -->|"loads context"| node_supabase

click node_quote "https://github.com/architectural-flashing-supply/afs-platform/blob/main/app/quote/page.tsx"
click node_quoteapi "https://github.com/architectural-flashing-supply/afs-platform/blob/main/app/api/quote-requests/route.ts"
click node_upload "https://github.com/architectural-flashing-supply/afs-platform/blob/main/app/upload/page.tsx"
click node_takeoff "https://github.com/architectural-flashing-supply/afs-platform/blob/main/app/api/takeoff/route.ts"
click node_studio "https://github.com/architectural-flashing-supply/afs-platform/blob/main/app/studio/draft/page.tsx"
click node_viewer "https://github.com/architectural-flashing-supply/afs-platform/blob/main/components/studio/ProfileViewer3D.tsx"
click node_catalog "https://github.com/architectural-flashing-supply/afs-platform/blob/main/lib/data/catalog.ts"
click node_colors "https://github.com/architectural-flashing-supply/afs-platform/blob/main/lib/data/material-color-requirement.ts"
click node_architects "https://github.com/architectural-flashing-supply/afs-platform/tree/main/app/(public)/architects"
click node_specs "https://github.com/architectural-flashing-supply/afs-platform/blob/main/app/(public)/architects/spec-writer/page.tsx"
click node_account "https://github.com/architectural-flashing-supply/afs-platform/tree/main/app/account"
click node_track "https://github.com/architectural-flashing-supply/afs-platform/blob/main/app/track/%5BorderId%5D/page.tsx"
click node_command "https://github.com/architectural-flashing-supply/afs-platform/tree/main/app/admin/command-center"
click node_approval "https://github.com/architectural-flashing-supply/afs-platform/blob/main/app/api/admin/command-center/approve-quote-request/route.ts"
click node_admin "https://github.com/architectural-flashing-supply/afs-platform/tree/main/app/admin"
click node_bid "https://github.com/architectural-flashing-supply/afs-platform/blob/main/app/admin/bid-monitor/page.tsx"
click node_pricing "https://github.com/architectural-flashing-supply/afs-platform/blob/main/lib/pricing/ledger.ts"
click node_productionq "https://github.com/architectural-flashing-supply/afs-platform/blob/main/lib/data/shop-queue.ts"
click node_machine "https://github.com/architectural-flashing-supply/afs-platform/blob/main/app/api/machine-bridge/pending-jobs/route.ts"
click node_delivery "https://github.com/architectural-flashing-supply/afs-platform/blob/main/lib/delivery/auto-schedule.ts"
click node_hail "https://github.com/architectural-flashing-supply/afs-platform/blob/main/app/hailview/page.tsx"
click node_chat "https://github.com/architectural-flashing-supply/afs-platform/blob/main/app/api/chat/route.ts"
click node_knowledge "https://github.com/architectural-flashing-supply/afs-platform/blob/main/lib/chatbot/knowledge/index.ts"
click node_supabase "https://github.com/architectural-flashing-supply/afs-platform/blob/main/lib/supabase/admin.ts"
click node_email "https://github.com/architectural-flashing-supply/afs-platform/blob/main/lib/resend/send.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_quote,node_quoteapi,node_account,node_track,node_hail,node_chat toneBlue
class node_upload,node_takeoff,node_studio,node_viewer,node_catalog,node_colors,node_architects,node_specs toneAmber
class node_command,node_approval,node_admin,node_bid,node_pricing toneMint
class node_productionq,node_machine,node_delivery toneRose
class node_knowledge,node_supabase,node_email,node_visitor,node_anthropic,node_pathfinder toneIndigo
```

## Components

### Customer experience

- [Quote builder](https://github.com/architectural-flashing-supply/afs-platform/blob/main/app/quote/page.tsx): `app/quote/page.tsx`
- [Quote requests](https://github.com/architectural-flashing-supply/afs-platform/blob/main/app/api/quote-requests/route.ts): `app/api/quote-requests/route.ts`
- [Customer account](https://github.com/architectural-flashing-supply/afs-platform/tree/main/app/account): `app/account`
- [Order tracking](https://github.com/architectural-flashing-supply/afs-platform/blob/main/app/track/%5BorderId%5D/page.tsx): `app/track/[orderId]/page.tsx`
- [HailView](https://github.com/architectural-flashing-supply/afs-platform/blob/main/app/hailview/page.tsx): `app/hailview/page.tsx`
- [Chat assistant](https://github.com/architectural-flashing-supply/afs-platform/blob/main/app/api/chat/route.ts): `app/api/chat/route.ts`

### Design and estimating

- [Plan takeoff](https://github.com/architectural-flashing-supply/afs-platform/blob/main/app/upload/page.tsx): `app/upload/page.tsx`
- [AI takeoff](https://github.com/architectural-flashing-supply/afs-platform/blob/main/app/api/takeoff/route.ts): `app/api/takeoff/route.ts`
- [FlashDraft studio](https://github.com/architectural-flashing-supply/afs-platform/blob/main/app/studio/draft/page.tsx): `app/studio/draft/page.tsx`
- [Profile viewer](https://github.com/architectural-flashing-supply/afs-platform/blob/main/components/studio/ProfileViewer3D.tsx): `components/studio/ProfileViewer3D.tsx`
- [Product catalog](https://github.com/architectural-flashing-supply/afs-platform/blob/main/lib/data/catalog.ts): `lib/data/catalog.ts`
- [Material color rules](https://github.com/architectural-flashing-supply/afs-platform/blob/main/lib/data/material-color-requirement.ts): `lib/data/material-color-requirement.ts`
- [Architect resources](https://github.com/architectural-flashing-supply/afs-platform/tree/main/app/(public)/architects): `app/(public)/architects`
- [Specification writer](https://github.com/architectural-flashing-supply/afs-platform/blob/main/app/(public)/architects/spec-writer/page.tsx): `app/(public)/architects/spec-writer/page.tsx`

### Sales and operations

- [Command center](https://github.com/architectural-flashing-supply/afs-platform/tree/main/app/admin/command-center): `app/admin/command-center`
- [Request approval](https://github.com/architectural-flashing-supply/afs-platform/blob/main/app/api/admin/command-center/approve-quote-request/route.ts): `app/api/admin/command-center/approve-quote-request/route.ts`
- [Admin operations](https://github.com/architectural-flashing-supply/afs-platform/tree/main/app/admin): `app/admin`
- [Bid monitoring](https://github.com/architectural-flashing-supply/afs-platform/blob/main/app/admin/bid-monitor/page.tsx): `app/admin/bid-monitor/page.tsx`
- [Pricing ledger](https://github.com/architectural-flashing-supply/afs-platform/blob/main/lib/pricing/ledger.ts): `lib/pricing/ledger.ts`

### Fabrication and delivery

- [Production queue](https://github.com/architectural-flashing-supply/afs-platform/blob/main/lib/data/shop-queue.ts): `lib/data/shop-queue.ts`
- [Machine integration](https://github.com/architectural-flashing-supply/afs-platform/blob/main/app/api/machine-bridge/pending-jobs/route.ts): `app/api/machine-bridge/pending-jobs/route.ts`
- [Delivery and dispatch](https://github.com/architectural-flashing-supply/afs-platform/blob/main/lib/delivery/auto-schedule.ts): `lib/delivery/auto-schedule.ts`

### Shared services

- [Knowledge search](https://github.com/architectural-flashing-supply/afs-platform/blob/main/lib/chatbot/knowledge/index.ts): `lib/chatbot/knowledge/index.ts`
- [Supabase services](https://github.com/architectural-flashing-supply/afs-platform/blob/main/lib/supabase/admin.ts): `lib/supabase/admin.ts`
- [Email delivery](https://github.com/architectural-flashing-supply/afs-platform/blob/main/lib/resend/send.ts): `lib/resend/send.ts`

### Other components

- **Customer**
- **Anthropic AI**
- **Pathfinder service**

## Connections

- Customer → Quote builder: configures items (evidence: `app/quote/page.tsx`)
- Quote builder → Product catalog: loads catalog (evidence: `app/quote/page.tsx`)
- Quote builder → Material color rules: checks finish (evidence: `app/quote/page.tsx`)
- Quote builder → Quote requests: submits request (evidence: `app/quote/page.tsx`)
- Quote requests → Supabase services: stores request (evidence: `app/api/quote-requests/route.ts`)
- Quote requests → Email delivery: sends receipt (evidence: `app/api/quote-requests/route.ts`)
- Customer → Plan takeoff: uploads plans (evidence: `app/upload/page.tsx`)
- Plan takeoff → AI takeoff: requests analysis (evidence: `app/upload/page.tsx`)
- AI takeoff → Supabase services: reads file, saves results (evidence: `app/api/takeoff/route.ts`)
- AI takeoff → Anthropic AI: analyzes plan (evidence: `app/api/takeoff/route.ts`)
- Customer → FlashDraft studio: designs profile (evidence: `app/studio/draft/page.tsx`)
- FlashDraft studio → Profile viewer: renders geometry (evidence: `app/studio/draft/page.tsx`)
- FlashDraft studio → Product catalog: loads materials (evidence: `app/studio/draft/page.tsx`)
- FlashDraft studio → Material color rules: checks material rules (evidence: `app/studio/draft/page.tsx`)
- Customer → Architect resources: uses design resources
- Architect resources → Specification writer: opens specification tool
- Customer → Customer account: manages orders
- Customer account → Order tracking: views fulfillment
- Admin operations → Command center: reviews work
- Command center → Request approval: approves request
- Admin operations → Bid monitoring: monitors opportunities
- Admin operations → Pricing ledger: maintains pricing
- Request approval → Supabase services: records approval (evidence: `app/api/admin/command-center/approve-quote-request/route.ts`)
- Request approval → Pathfinder service: pushes job (evidence: `app/api/admin/command-center/approve-quote-request/route.ts`)
- Request approval → Email delivery: notifies customer (evidence: `app/api/admin/command-center/approve-quote-request/route.ts`)
- Request approval → Production queue: creates production job
- Production queue → Machine integration: feeds machine jobs
- Production queue → Delivery and dispatch: coordinates fulfillment
- Customer → HailView: checks storm exposure (evidence: `app/hailview/page.tsx`)
- Customer → Chat assistant: asks product questions
- Chat assistant → Knowledge search: searches knowledge (evidence: `app/api/chat/route.ts`)
- Chat assistant → Anthropic AI: streams response
- Chat assistant → Supabase services: loads context (evidence: `app/api/chat/route.ts`)
