# kashifali-it/tailgate-quote architecture

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

- Interactive diagram: https://gitdiagram.com/kashifali-it/tailgate-quote
- Repository: https://github.com/kashifali-it/tailgate-quote

## Overview

Tailgate Quote is a voice-first field-service quoting application. Its intended workflow turns a technician’s spoken job description into catalog-priced, deterministically calculated line items, records evidence, creates a draft, and requires human confirmation before sending. The sampled frontend currently provides a quote preview and health check; the README describes the broader voice-agent workflow, while backend excerpts show overlapping implementations. Edges reflect only explicit calls, frontend requests, or documented capabilities; unsampled voice routing and persistence details are not inferred.

Main entry points: [`backend/app/api/routes/voice.py`](https://github.com/kashifali-it/tailgate-quote/blob/main/backend/app/api/routes/voice.py) (Voice Route), [`backend/app/services/quote_service.py`](https://github.com/kashifali-it/tailgate-quote/blob/main/backend/app/services/quote_service.py) (Quote Service), [`backend/app/services/pricing_service.py`](https://github.com/kashifali-it/tailgate-quote/blob/main/backend/app/services/pricing_service.py) (Pricing Service), [`backend/app/tools/calculate_line_item.py`](https://github.com/kashifali-it/tailgate-quote/blob/main/backend/app/tools/calculate_line_item.py) (Line Calculation Tool)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_field["Technician Interface"]
  node_frontend["Quote Dashboard<br/>[App.tsx]"]
end

subgraph group_voice["Voice and Tools"]
  node_voice_agent["Voice Agent"]
  node_assembly_integration["AssemblyAI Integration<br/>[assemblyai.py]"]
  node_tool_schemas["Tool Schemas<br/>[tools.py]"]
  node_voice_route["Voice Route<br/>[voice.py]"]
  node_price_tool["Price Lookup Tool<br/>[get_price_list.py]"]
  node_calc_tool["Line Calculation Tool"]
  node_draft_tool["Draft Quote Tool"]
  node_confirm_tool["Confirm and Send Tool"]
end

subgraph group_quote["Quote Domain"]
  node_api_app["FastAPI Application<br/>[main.py]"]
  node_quote_routes["Quote Routes<br/>[quotes.py]"]
  node_quote_service["Quote Service<br/>[quote_service.py]"]
  node_evidence_service["Evidence Service"]
end

subgraph group_data["Catalog and Persistence"]
  node_pricing_service["Pricing Service<br/>[pricing_service.py]"]
  node_calculation_service["Calculation Service"]
  node_catalog_data["Seed Price Catalog<br/>[seed_catalog.json]"]
  node_quote_store[("Quote Store<br/>[quote_store.py]")]
  node_database["Database Setup<br/>[database.py]"]
  node_quote_model["Quote Model<br/>[quote.py]"]
  node_evidence_model["Evidence Model<br/>[evidence.py]"]
  node_catalog_model["Catalog Model<br/>[catalog_item.py]"]
end

node_technician(("Technician"))

node_technician -->|"uses"| node_frontend
node_frontend -->|"requests health and quote"| node_api_app
node_api_app -->|"registers"| node_quote_routes
node_api_app -.->|"voice endpoint documented"| node_voice_route
node_voice_agent -.->|"connects voice"| node_assembly_integration
node_assembly_integration -->|"uses definitions"| node_tool_schemas
node_voice_route -.->|"uses schemas"| node_tool_schemas
node_voice_route -.->|"dispatches tools"| node_price_tool
node_voice_route -.->|"dispatches tools"| node_calc_tool
node_voice_route -.->|"dispatches tools"| node_draft_tool
node_voice_route -.->|"dispatches tools"| node_confirm_tool
node_quote_routes -->|"calls"| node_quote_service
node_price_tool -->|"looks up prices"| node_pricing_service
node_calc_tool -->|"retrieves SKU"| node_pricing_service
node_calc_tool -->|"calculates item"| node_calculation_service
node_draft_tool -->|"creates quote"| node_quote_service
node_draft_tool -->|"records evidence"| node_evidence_service
node_confirm_tool -->|"confirms quote"| node_quote_service
node_quote_service -->|"calculates items"| node_calculation_service
node_quote_service -->|"loads and saves"| node_quote_store
node_pricing_service -->|"reads catalog"| node_catalog_data
node_calculation_service -->|"loads catalog"| node_pricing_service
node_evidence_service -->|"creates and queries"| node_evidence_model
node_quote_model -->|"uses base"| node_database
node_catalog_model -->|"uses base"| node_database
node_evidence_model -->|"uses base"| node_database
node_quote_service -.->|"persists quote records"| node_quote_model

click node_frontend "https://github.com/kashifali-it/tailgate-quote/blob/main/frontend/src/App.tsx"
click node_assembly_integration "https://github.com/kashifali-it/tailgate-quote/blob/main/backend/app/integrations/assemblyai.py"
click node_tool_schemas "https://github.com/kashifali-it/tailgate-quote/blob/main/backend/app/schemas/tools.py"
click node_voice_route "https://github.com/kashifali-it/tailgate-quote/blob/main/backend/app/api/routes/voice.py"
click node_price_tool "https://github.com/kashifali-it/tailgate-quote/blob/main/backend/app/tools/get_price_list.py"
click node_calc_tool "https://github.com/kashifali-it/tailgate-quote/blob/main/backend/app/tools/calculate_line_item.py"
click node_draft_tool "https://github.com/kashifali-it/tailgate-quote/blob/main/backend/app/tools/create_draft_quote.py"
click node_confirm_tool "https://github.com/kashifali-it/tailgate-quote/blob/main/backend/app/tools/confirm_and_send.py"
click node_api_app "https://github.com/kashifali-it/tailgate-quote/blob/main/backend/app/main.py"
click node_quote_routes "https://github.com/kashifali-it/tailgate-quote/blob/main/backend/app/api/routes/quotes.py"
click node_quote_service "https://github.com/kashifali-it/tailgate-quote/blob/main/backend/app/services/quote_service.py"
click node_evidence_service "https://github.com/kashifali-it/tailgate-quote/blob/main/backend/app/services/evidence_service.py"
click node_pricing_service "https://github.com/kashifali-it/tailgate-quote/blob/main/backend/app/services/pricing_service.py"
click node_calculation_service "https://github.com/kashifali-it/tailgate-quote/blob/main/backend/app/services/calculation_service.py"
click node_catalog_data "https://github.com/kashifali-it/tailgate-quote/blob/main/data/seed_catalog.json"
click node_quote_store "https://github.com/kashifali-it/tailgate-quote/blob/main/backend/app/storage/quote_store.py"
click node_database "https://github.com/kashifali-it/tailgate-quote/blob/main/backend/app/db/database.py"
click node_quote_model "https://github.com/kashifali-it/tailgate-quote/blob/main/backend/app/models/quote.py"
click node_evidence_model "https://github.com/kashifali-it/tailgate-quote/blob/main/backend/app/models/evidence.py"
click node_catalog_model "https://github.com/kashifali-it/tailgate-quote/blob/main/backend/app/models/catalog_item.py"

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_frontend toneBlue
class node_voice_agent,node_assembly_integration,node_tool_schemas,node_voice_route,node_price_tool,node_calc_tool,node_draft_tool,node_confirm_tool toneAmber
class node_api_app,node_quote_routes,node_quote_service,node_evidence_service toneMint
class node_pricing_service,node_calculation_service,node_catalog_data,node_quote_store,node_database,node_quote_model,node_evidence_model,node_catalog_model toneRose
class node_technician toneIndigo
```

## Components

### Technician Interface

- [Quote Dashboard](https://github.com/kashifali-it/tailgate-quote/blob/main/frontend/src/App.tsx): `frontend/src/App.tsx`

### Voice and Tools

- **Voice Agent**
- [AssemblyAI Integration](https://github.com/kashifali-it/tailgate-quote/blob/main/backend/app/integrations/assemblyai.py): `backend/app/integrations/assemblyai.py`
- [Tool Schemas](https://github.com/kashifali-it/tailgate-quote/blob/main/backend/app/schemas/tools.py): `backend/app/schemas/tools.py`
- [Voice Route](https://github.com/kashifali-it/tailgate-quote/blob/main/backend/app/api/routes/voice.py): `backend/app/api/routes/voice.py`
- [Price Lookup Tool](https://github.com/kashifali-it/tailgate-quote/blob/main/backend/app/tools/get_price_list.py): `backend/app/tools/get_price_list.py`
- [Line Calculation Tool](https://github.com/kashifali-it/tailgate-quote/blob/main/backend/app/tools/calculate_line_item.py): `backend/app/tools/calculate_line_item.py`
- [Draft Quote Tool](https://github.com/kashifali-it/tailgate-quote/blob/main/backend/app/tools/create_draft_quote.py): `backend/app/tools/create_draft_quote.py`
- [Confirm and Send Tool](https://github.com/kashifali-it/tailgate-quote/blob/main/backend/app/tools/confirm_and_send.py): `backend/app/tools/confirm_and_send.py`

### Quote Domain

- [FastAPI Application](https://github.com/kashifali-it/tailgate-quote/blob/main/backend/app/main.py): `backend/app/main.py`
- [Quote Routes](https://github.com/kashifali-it/tailgate-quote/blob/main/backend/app/api/routes/quotes.py): `backend/app/api/routes/quotes.py`
- [Quote Service](https://github.com/kashifali-it/tailgate-quote/blob/main/backend/app/services/quote_service.py): `backend/app/services/quote_service.py`
- [Evidence Service](https://github.com/kashifali-it/tailgate-quote/blob/main/backend/app/services/evidence_service.py): `backend/app/services/evidence_service.py`

### Catalog and Persistence

- [Pricing Service](https://github.com/kashifali-it/tailgate-quote/blob/main/backend/app/services/pricing_service.py): `backend/app/services/pricing_service.py`
- [Calculation Service](https://github.com/kashifali-it/tailgate-quote/blob/main/backend/app/services/calculation_service.py): `backend/app/services/calculation_service.py`
- [Seed Price Catalog](https://github.com/kashifali-it/tailgate-quote/blob/main/data/seed_catalog.json): `data/seed_catalog.json`
- [Quote Store](https://github.com/kashifali-it/tailgate-quote/blob/main/backend/app/storage/quote_store.py): `backend/app/storage/quote_store.py`
- [Database Setup](https://github.com/kashifali-it/tailgate-quote/blob/main/backend/app/db/database.py): `backend/app/db/database.py`
- [Quote Model](https://github.com/kashifali-it/tailgate-quote/blob/main/backend/app/models/quote.py): `backend/app/models/quote.py`
- [Evidence Model](https://github.com/kashifali-it/tailgate-quote/blob/main/backend/app/models/evidence.py): `backend/app/models/evidence.py`
- [Catalog Model](https://github.com/kashifali-it/tailgate-quote/blob/main/backend/app/models/catalog_item.py): `backend/app/models/catalog_item.py`

### Other components

- **Technician**

## Connections

- Technician → Quote Dashboard: uses (evidence: `readme.md`)
- Quote Dashboard → FastAPI Application: requests health and quote (evidence: `frontend/src/App.tsx`)
- FastAPI Application → Quote Routes: registers (evidence: `backend/app/main.py`)
- FastAPI Application → Voice Route: voice endpoint documented
- Voice Agent → AssemblyAI Integration: connects voice (evidence: `readme.md`)
- AssemblyAI Integration → Tool Schemas: uses definitions (evidence: `backend/app/integrations/assemblyai.py`)
- Voice Route → Tool Schemas: uses schemas (evidence: `backend/app/api/routes/voice.py`)
- Voice Route → Price Lookup Tool: dispatches tools
- Voice Route → Line Calculation Tool: dispatches tools
- Voice Route → Draft Quote Tool: dispatches tools
- Voice Route → Confirm and Send Tool: dispatches tools
- Quote Routes → Quote Service: calls (evidence: `backend/app/api/routes/quotes.py`)
- Price Lookup Tool → Pricing Service: looks up prices (evidence: `backend/app/tools/get_price_list.py`)
- Line Calculation Tool → Pricing Service: retrieves SKU (evidence: `backend/app/tools/calculate_line_item.py`)
- Line Calculation Tool → Calculation Service: calculates item (evidence: `backend/app/tools/calculate_line_item.py`)
- Draft Quote Tool → Quote Service: creates quote (evidence: `backend/app/tools/create_draft_quote.py`)
- Draft Quote Tool → Evidence Service: records evidence (evidence: `backend/app/tools/create_draft_quote.py`)
- Confirm and Send Tool → Quote Service: confirms quote (evidence: `backend/app/tools/confirm_and_send.py`)
- Quote Service → Calculation Service: calculates items (evidence: `backend/app/services/quote_service.py`)
- Quote Service → Quote Store: loads and saves (evidence: `backend/app/services/quote_service.py`)
- Pricing Service → Seed Price Catalog: reads catalog (evidence: `backend/app/services/pricing_service.py`)
- Calculation Service → Pricing Service: loads catalog (evidence: `backend/app/services/calculation_service.py`)
- Evidence Service → Evidence Model: creates and queries (evidence: `backend/app/services/evidence_service.py`)
- Quote Model → Database Setup: uses base (evidence: `backend/app/models/quote.py`)
- Catalog Model → Database Setup: uses base (evidence: `backend/app/models/catalog_item.py`)
- Evidence Model → Database Setup: uses base (evidence: `backend/app/models/evidence.py`)
- Quote Service → Quote Model: persists quote records
