# nextquotes-edge/ai-front-desk architecture

> Architecture diagram of the GitHub repository nextquotes-edge/ai-front-desk, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-29). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/nextquotes-edge/ai-front-desk
- Repository: https://github.com/nextquotes-edge/ai-front-desk

## Overview

AI Front Desk is a web dashboard for configuring and monitoring an AI receptionist across business locations. The apparent user workflow is account access and setup, configuration of the assistant and business resources, review of calls and bookings, then performance and quality analysis. The repository evidence shows a frontend demo: its service layer simulates latency and reads mock datasets rather than calling a live backend. Page-to-page wiring and several feature implementations were not sampled, so uncertain connections are omitted.

Main entry points: [`src/services/index.ts`](https://github.com/nextquotes-edge/ai-front-desk/blob/master/src/services/index.ts) (Mock service layer), [`src/app/login/page.tsx`](https://github.com/nextquotes-edge/ai-front-desk/blob/master/src/app/login/page.tsx) (Sign in), [`src/lib/auth.ts`](https://github.com/nextquotes-edge/ai-front-desk/blob/master/src/lib/auth.ts) (Local auth state), [`src/components/layout/auth-guard.tsx`](https://github.com/nextquotes-edge/ai-front-desk/blob/master/src/components/layout/auth-guard.tsx) (Route guard)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_access["Access and setup"]
  node_landing["Product landing<br/>[page.tsx]"]
  node_login["Sign in<br/>[page.tsx]"]
  node_auth["Local auth state<br/>[auth.ts]"]
  node_guard["Route guard<br/>[auth-guard.tsx]"]
  node_onboarding["Business setup<br/>[page.tsx]"]
end

subgraph group_configuration["Business configuration"]
  node_ai["AI control center<br/>[page.tsx]"]
  node_knowledge["Knowledge base<br/>[page.tsx]"]
  node_flows["Conversation flows<br/>[page.tsx]"]
  node_integrations["Integrations<br/>[page.tsx]"]
  node_business["Business settings<br/>[page.tsx]"]
end

subgraph group_operations["Front desk operations"]
  node_calls["Calls and transcripts<br/>[page.tsx]"]
  node_live["Live calls<br/>[page.tsx]"]
  node_reservations["Reservations<br/>[page.tsx]"]
  node_customers["Customer records<br/>[page.tsx]"]
  node_messaging["Messaging<br/>[page.tsx]"]
end

subgraph group_insights["Monitoring and insights"]
  node_analytics["Analytics<br/>[page.tsx]"]
  node_quality["Call quality<br/>[page.tsx]"]
  node_audit["Audit logs<br/>[page.tsx]"]
  node_status["System status<br/>[page.tsx]"]
end

subgraph group_shared["Shared application"]
  node_shell["Dashboard shell<br/>[app-shell.tsx]"]
  node_services["Mock service layer<br/>[index.ts]"]
  node_mockdata["Mock business data<br/>[mock-data.ts]"]
  node_mockanalytics["Mock analytics data<br/>[mock-analytics.ts]"]
  node_types["Domain types<br/>[index.ts]"]
end

node_user(("Business user"))

node_user -->|"visits"| node_landing
node_user -->|"signs in"| node_login
node_user -->|"sets up"| node_onboarding
node_login -->|"checks auth"| node_auth
node_auth -->|"stores session"| node_login
node_guard -->|"checks session"| node_auth
node_user -->|"uses dashboard"| node_shell
node_shell -->|"guards access"| node_guard
node_user -->|"configures assistant"| node_ai
node_user -->|"manages content"| node_knowledge
node_user -->|"configures flows"| node_flows
node_user -->|"manages connections"| node_integrations
node_user -->|"manages locations"| node_business
node_user -->|"reviews calls"| node_calls
node_user -->|"monitors calls"| node_live
node_user -->|"manages bookings"| node_reservations
node_user -->|"reviews customers"| node_customers
node_user -->|"manages messages"| node_messaging
node_user -->|"reviews metrics"| node_analytics
node_user -->|"reviews quality"| node_quality
node_user -->|"reviews activity"| node_audit
node_user -->|"checks health"| node_status
node_quality -->|"fetches analytics"| node_services
node_services -->|"loads mock records"| node_mockdata
node_services -->|"loads mock metrics"| node_mockanalytics

click node_landing "https://github.com/nextquotes-edge/ai-front-desk/blob/master/src/app/page.tsx"
click node_login "https://github.com/nextquotes-edge/ai-front-desk/blob/master/src/app/login/page.tsx"
click node_auth "https://github.com/nextquotes-edge/ai-front-desk/blob/master/src/lib/auth.ts"
click node_guard "https://github.com/nextquotes-edge/ai-front-desk/blob/master/src/components/layout/auth-guard.tsx"
click node_onboarding "https://github.com/nextquotes-edge/ai-front-desk/blob/master/src/app/onboarding/page.tsx"
click node_shell "https://github.com/nextquotes-edge/ai-front-desk/blob/master/src/components/layout/app-shell.tsx"
click node_ai "https://github.com/nextquotes-edge/ai-front-desk/blob/master/src/app/(app)/ai/page.tsx"
click node_knowledge "https://github.com/nextquotes-edge/ai-front-desk/blob/master/src/app/(app)/knowledge/page.tsx"
click node_flows "https://github.com/nextquotes-edge/ai-front-desk/blob/master/src/app/(app)/flows/page.tsx"
click node_integrations "https://github.com/nextquotes-edge/ai-front-desk/blob/master/src/app/(app)/integrations/page.tsx"
click node_business "https://github.com/nextquotes-edge/ai-front-desk/blob/master/src/app/(app)/locations/page.tsx"
click node_calls "https://github.com/nextquotes-edge/ai-front-desk/blob/master/src/app/(app)/calls/page.tsx"
click node_live "https://github.com/nextquotes-edge/ai-front-desk/blob/master/src/app/(app)/live/page.tsx"
click node_reservations "https://github.com/nextquotes-edge/ai-front-desk/blob/master/src/app/(app)/reservations/page.tsx"
click node_customers "https://github.com/nextquotes-edge/ai-front-desk/blob/master/src/app/(app)/customers/page.tsx"
click node_messaging "https://github.com/nextquotes-edge/ai-front-desk/blob/master/src/app/(app)/messaging/page.tsx"
click node_analytics "https://github.com/nextquotes-edge/ai-front-desk/blob/master/src/app/(app)/analytics/page.tsx"
click node_quality "https://github.com/nextquotes-edge/ai-front-desk/blob/master/src/app/(app)/quality/page.tsx"
click node_audit "https://github.com/nextquotes-edge/ai-front-desk/blob/master/src/app/(app)/audit-logs/page.tsx"
click node_status "https://github.com/nextquotes-edge/ai-front-desk/blob/master/src/app/(app)/system-status/page.tsx"
click node_services "https://github.com/nextquotes-edge/ai-front-desk/blob/master/src/services/index.ts"
click node_mockdata "https://github.com/nextquotes-edge/ai-front-desk/blob/master/src/lib/mock-data.ts"
click node_mockanalytics "https://github.com/nextquotes-edge/ai-front-desk/blob/master/src/lib/mock-analytics.ts"
click node_types "https://github.com/nextquotes-edge/ai-front-desk/blob/master/src/types/index.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_landing,node_login,node_auth,node_guard,node_onboarding,node_user toneBlue
class node_ai,node_knowledge,node_flows,node_integrations,node_business toneAmber
class node_calls,node_live,node_reservations,node_customers,node_messaging toneMint
class node_analytics,node_quality,node_audit,node_status toneRose
class node_shell,node_services,node_mockdata,node_mockanalytics,node_types toneIndigo
```

## Components

### Access and setup

- [Product landing](https://github.com/nextquotes-edge/ai-front-desk/blob/master/src/app/page.tsx): `src/app/page.tsx`
- [Sign in](https://github.com/nextquotes-edge/ai-front-desk/blob/master/src/app/login/page.tsx): `src/app/login/page.tsx`
- [Local auth state](https://github.com/nextquotes-edge/ai-front-desk/blob/master/src/lib/auth.ts): `src/lib/auth.ts`
- [Route guard](https://github.com/nextquotes-edge/ai-front-desk/blob/master/src/components/layout/auth-guard.tsx): `src/components/layout/auth-guard.tsx`
- [Business setup](https://github.com/nextquotes-edge/ai-front-desk/blob/master/src/app/onboarding/page.tsx): `src/app/onboarding/page.tsx`

### Business configuration

- [AI control center](https://github.com/nextquotes-edge/ai-front-desk/blob/master/src/app/(app)/ai/page.tsx): `src/app/(app)/ai/page.tsx`
- [Knowledge base](https://github.com/nextquotes-edge/ai-front-desk/blob/master/src/app/(app)/knowledge/page.tsx): `src/app/(app)/knowledge/page.tsx`
- [Conversation flows](https://github.com/nextquotes-edge/ai-front-desk/blob/master/src/app/(app)/flows/page.tsx): `src/app/(app)/flows/page.tsx`
- [Integrations](https://github.com/nextquotes-edge/ai-front-desk/blob/master/src/app/(app)/integrations/page.tsx): `src/app/(app)/integrations/page.tsx`
- [Business settings](https://github.com/nextquotes-edge/ai-front-desk/blob/master/src/app/(app)/locations/page.tsx): `src/app/(app)/locations/page.tsx`

### Front desk operations

- [Calls and transcripts](https://github.com/nextquotes-edge/ai-front-desk/blob/master/src/app/(app)/calls/page.tsx): `src/app/(app)/calls/page.tsx`
- [Live calls](https://github.com/nextquotes-edge/ai-front-desk/blob/master/src/app/(app)/live/page.tsx): `src/app/(app)/live/page.tsx`
- [Reservations](https://github.com/nextquotes-edge/ai-front-desk/blob/master/src/app/(app)/reservations/page.tsx): `src/app/(app)/reservations/page.tsx`
- [Customer records](https://github.com/nextquotes-edge/ai-front-desk/blob/master/src/app/(app)/customers/page.tsx): `src/app/(app)/customers/page.tsx`
- [Messaging](https://github.com/nextquotes-edge/ai-front-desk/blob/master/src/app/(app)/messaging/page.tsx): `src/app/(app)/messaging/page.tsx`

### Monitoring and insights

- [Analytics](https://github.com/nextquotes-edge/ai-front-desk/blob/master/src/app/(app)/analytics/page.tsx): `src/app/(app)/analytics/page.tsx`
- [Call quality](https://github.com/nextquotes-edge/ai-front-desk/blob/master/src/app/(app)/quality/page.tsx): `src/app/(app)/quality/page.tsx`
- [Audit logs](https://github.com/nextquotes-edge/ai-front-desk/blob/master/src/app/(app)/audit-logs/page.tsx): `src/app/(app)/audit-logs/page.tsx`
- [System status](https://github.com/nextquotes-edge/ai-front-desk/blob/master/src/app/(app)/system-status/page.tsx): `src/app/(app)/system-status/page.tsx`

### Shared application

- [Dashboard shell](https://github.com/nextquotes-edge/ai-front-desk/blob/master/src/components/layout/app-shell.tsx): `src/components/layout/app-shell.tsx`
- [Mock service layer](https://github.com/nextquotes-edge/ai-front-desk/blob/master/src/services/index.ts): `src/services/index.ts`
- [Mock business data](https://github.com/nextquotes-edge/ai-front-desk/blob/master/src/lib/mock-data.ts): `src/lib/mock-data.ts`
- [Mock analytics data](https://github.com/nextquotes-edge/ai-front-desk/blob/master/src/lib/mock-analytics.ts): `src/lib/mock-analytics.ts`
- [Domain types](https://github.com/nextquotes-edge/ai-front-desk/blob/master/src/types/index.ts): `src/types/index.ts`

### Other components

- **Business user**

## Connections

- Business user → Product landing: visits
- Business user → Sign in: signs in
- Business user → Business setup: sets up
- Sign in → Local auth state: checks auth
- Local auth state → Sign in: stores session
- Route guard → Local auth state: checks session
- Business user → Dashboard shell: uses dashboard
- Dashboard shell → Route guard: guards access
- Business user → AI control center: configures assistant
- Business user → Knowledge base: manages content
- Business user → Conversation flows: configures flows
- Business user → Integrations: manages connections
- Business user → Business settings: manages locations
- Business user → Calls and transcripts: reviews calls
- Business user → Live calls: monitors calls
- Business user → Reservations: manages bookings
- Business user → Customer records: reviews customers
- Business user → Messaging: manages messages
- Business user → Analytics: reviews metrics
- Business user → Call quality: reviews quality
- Business user → Audit logs: reviews activity
- Business user → System status: checks health
- Call quality → Mock service layer: fetches analytics
- Mock service layer → Mock business data: loads mock records
- Mock service layer → Mock analytics data: loads mock metrics