# danncode10/juanproperty architecture

> Architecture diagram of the GitHub repository danncode10/juanproperty, 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/danncode10/juanproperty
- Repository: https://github.com/danncode10/juanproperty

## Overview

JuanProperty is a property-management SaaS with a public marketing and blog site, an authenticated dashboard for operational work, and an AI Secretary for data summaries and scheduling. The main user journey is entering through the site, signing in, and managing workspace data; the chat route separately streams assistant responses and persists chat messages. Dashboard capabilities and several domain modules are visible in the tree but were not sampled, so their internal connections are left unverified rather than inferred.

Main entry points: [`src/app/page.tsx`](https://github.com/danncode10/juanproperty/blob/main/src/app/page.tsx) (Home page), [`src/utils/supabase/server.ts`](https://github.com/danncode10/juanproperty/blob/main/src/utils/supabase/server.ts) (Supabase clients), [`src/app/api/chat/route.ts`](https://github.com/danncode10/juanproperty/blob/main/src/app/api/chat/route.ts) (Chat API), [`src/ai/tools`](https://github.com/danncode10/juanproperty/tree/main/src/ai/tools) (Assistant tools)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_public["Public site"]
  node_home["Home page<br/>[page.tsx]"]
  node_landing["Landing sections"]
  node_feature_tabs["Feature tabs<br/>[features-tabs.tsx]"]
  node_navbar["Site navigation<br/>[navbar.tsx]"]
  node_site_config["Site configuration<br/>[config.ts]"]
  node_blog_pages["Blog pages"]
  node_blog_preview["Blog preview<br/>[blog-preview.tsx]"]
end

subgraph group_workspace["Workspace operations"]
  node_blog_service["Blog service<br/>[blog.ts]"]
  node_login["Login page<br/>[page.tsx]"]
  node_dashboard["Dashboard pages"]
  node_dashboard_service["Dashboard service<br/>[dashboard.ts]"]
  node_operations["Leads, bookings, gallery, team"]
  node_services_tab["Services editor<br/>[services-tab.tsx]"]
  node_services_service["Services service<br/>[services.ts]"]
  node_bir_tax["BIR tax calculations"]
  node_scheduling["Scheduling domain"]
end

subgraph group_assistant["AI Secretary"]
  node_chat_ui["Chat interface"]
  node_chat_route["Chat API<br/>[route.ts]"]
  node_chat_service["Chat persistence<br/>[ai-chat.service.ts]"]
  node_ai_tools["Assistant tools"]
  node_document_preview["Artifact preview"]
end

subgraph group_platform["Platform services"]
  node_auth_services["Authentication services<br/>[auth.ts]"]
  node_supabase_clients["Supabase clients<br/>[server.ts]"]
  node_schema["Database schema types<br/>[schema.ts]"]
  node_database[("Supabase database")]
end

node_visitor(("Visitor"))
node_ai_model["OpenAI model"]

node_visitor -.->|"opens"| node_home
node_home -->|"renders"| node_navbar
node_home -->|"renders"| node_landing
node_home -->|"renders"| node_feature_tabs
node_home -->|"loads profile data"| node_dashboard_service
node_home -->|"reads configuration"| node_site_config
node_blog_pages -->|"loads posts"| node_blog_service
node_blog_preview -->|"loads posts"| node_blog_service
node_login -->|"uses authentication"| node_auth_services
node_services_tab -->|"manages services"| node_services_service
node_chat_ui -.->|"sends chat requests"| node_chat_route
node_chat_route -->|"persists messages"| node_chat_service
node_chat_route -->|"selects enabled tools"| node_ai_tools
node_chat_route -->|"streams completion"| node_ai_model
node_chat_service -->|"queries database"| node_supabase_clients
node_ai_tools -->|"reads workspace data"| node_supabase_clients
node_ai_tools -.->|"may create schedules"| node_scheduling
node_services_service -->|"reads and writes services"| node_supabase_clients
node_blog_service -->|"queries content"| node_supabase_clients
node_supabase_clients -.->|"reads and writes"| node_database
node_dashboard -.->|"manages records"| node_operations
node_dashboard -.->|"offers tax workflows"| node_bir_tax
node_document_preview -.->|"shares chat artifacts"| node_chat_ui

click node_home "https://github.com/danncode10/juanproperty/blob/main/src/app/page.tsx"
click node_landing "https://github.com/danncode10/juanproperty/tree/main/src/components/landing"
click node_feature_tabs "https://github.com/danncode10/juanproperty/blob/main/src/components/features-tabs.tsx"
click node_navbar "https://github.com/danncode10/juanproperty/blob/main/src/components/navbar.tsx"
click node_site_config "https://github.com/danncode10/juanproperty/blob/main/src/lib/config.ts"
click node_blog_pages "https://github.com/danncode10/juanproperty/tree/main/src/app/blog"
click node_blog_preview "https://github.com/danncode10/juanproperty/blob/main/src/components/landing/blog-preview.tsx"
click node_blog_service "https://github.com/danncode10/juanproperty/blob/main/src/services/blog.ts"
click node_login "https://github.com/danncode10/juanproperty/blob/main/src/app/login/page.tsx"
click node_dashboard "https://github.com/danncode10/juanproperty/tree/main/src/app/dashboard"
click node_dashboard_service "https://github.com/danncode10/juanproperty/blob/main/src/services/dashboard.ts"
click node_operations "https://github.com/danncode10/juanproperty/tree/main/src/services"
click node_services_tab "https://github.com/danncode10/juanproperty/blob/main/src/components/dashboard/tabs/services-tab.tsx"
click node_services_service "https://github.com/danncode10/juanproperty/blob/main/src/services/services.ts"
click node_bir_tax "https://github.com/danncode10/juanproperty/tree/main/src/bir/core"
click node_scheduling "https://github.com/danncode10/juanproperty/tree/main/src/scheduling/core"
click node_chat_ui "https://github.com/danncode10/juanproperty/blob/main/src/hooks/use-active-chat.tsx"
click node_chat_route "https://github.com/danncode10/juanproperty/blob/main/src/app/api/chat/route.ts"
click node_chat_service "https://github.com/danncode10/juanproperty/blob/main/src/services/ai-chat.service.ts"
click node_ai_tools "https://github.com/danncode10/juanproperty/tree/main/src/ai/tools"
click node_document_preview "https://github.com/danncode10/juanproperty/blob/main/src/components/chat/document-preview.tsx"
click node_auth_services "https://github.com/danncode10/juanproperty/blob/main/src/services/auth.ts"
click node_supabase_clients "https://github.com/danncode10/juanproperty/blob/main/src/utils/supabase/server.ts"
click node_schema "https://github.com/danncode10/juanproperty/blob/main/src/lib/db/schema.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_home,node_landing,node_feature_tabs,node_navbar,node_site_config,node_blog_pages,node_blog_preview toneBlue
class node_blog_service,node_login,node_dashboard,node_dashboard_service,node_operations,node_services_tab,node_services_service,node_bir_tax,node_scheduling toneAmber
class node_chat_ui,node_chat_route,node_chat_service,node_ai_tools,node_document_preview toneMint
class node_auth_services,node_supabase_clients,node_schema,node_database toneRose
class node_visitor,node_ai_model toneIndigo
```

## Components

### Public site

- [Home page](https://github.com/danncode10/juanproperty/blob/main/src/app/page.tsx): `src/app/page.tsx`
- [Landing sections](https://github.com/danncode10/juanproperty/tree/main/src/components/landing): `src/components/landing`
- [Feature tabs](https://github.com/danncode10/juanproperty/blob/main/src/components/features-tabs.tsx): `src/components/features-tabs.tsx`
- [Site navigation](https://github.com/danncode10/juanproperty/blob/main/src/components/navbar.tsx): `src/components/navbar.tsx`
- [Site configuration](https://github.com/danncode10/juanproperty/blob/main/src/lib/config.ts): `src/lib/config.ts`
- [Blog pages](https://github.com/danncode10/juanproperty/tree/main/src/app/blog): `src/app/blog`
- [Blog preview](https://github.com/danncode10/juanproperty/blob/main/src/components/landing/blog-preview.tsx): `src/components/landing/blog-preview.tsx`

### Workspace operations

- [Blog service](https://github.com/danncode10/juanproperty/blob/main/src/services/blog.ts): `src/services/blog.ts`
- [Login page](https://github.com/danncode10/juanproperty/blob/main/src/app/login/page.tsx): `src/app/login/page.tsx`
- [Dashboard pages](https://github.com/danncode10/juanproperty/tree/main/src/app/dashboard): `src/app/dashboard`
- [Dashboard service](https://github.com/danncode10/juanproperty/blob/main/src/services/dashboard.ts): `src/services/dashboard.ts`
- [Leads, bookings, gallery, team](https://github.com/danncode10/juanproperty/tree/main/src/services): `src/services`
- [Services editor](https://github.com/danncode10/juanproperty/blob/main/src/components/dashboard/tabs/services-tab.tsx): `src/components/dashboard/tabs/services-tab.tsx`
- [Services service](https://github.com/danncode10/juanproperty/blob/main/src/services/services.ts): `src/services/services.ts`
- [BIR tax calculations](https://github.com/danncode10/juanproperty/tree/main/src/bir/core): `src/bir/core`
- [Scheduling domain](https://github.com/danncode10/juanproperty/tree/main/src/scheduling/core): `src/scheduling/core`

### AI Secretary

- [Chat interface](https://github.com/danncode10/juanproperty/blob/main/src/hooks/use-active-chat.tsx): `src/hooks/use-active-chat.tsx`
- [Chat API](https://github.com/danncode10/juanproperty/blob/main/src/app/api/chat/route.ts): `src/app/api/chat/route.ts`
- [Chat persistence](https://github.com/danncode10/juanproperty/blob/main/src/services/ai-chat.service.ts): `src/services/ai-chat.service.ts`
- [Assistant tools](https://github.com/danncode10/juanproperty/tree/main/src/ai/tools): `src/ai/tools`
- [Artifact preview](https://github.com/danncode10/juanproperty/blob/main/src/components/chat/document-preview.tsx): `src/components/chat/document-preview.tsx`

### Platform services

- [Authentication services](https://github.com/danncode10/juanproperty/blob/main/src/services/auth.ts): `src/services/auth.ts`
- [Supabase clients](https://github.com/danncode10/juanproperty/blob/main/src/utils/supabase/server.ts): `src/utils/supabase/server.ts`
- [Database schema types](https://github.com/danncode10/juanproperty/blob/main/src/lib/db/schema.ts): `src/lib/db/schema.ts`
- **Supabase database**

### Other components

- **Visitor**
- **OpenAI model**

## Connections

- Visitor → Home page: opens
- Home page → Site navigation: renders (evidence: `src/app/page.tsx`)
- Home page → Landing sections: renders (evidence: `src/app/page.tsx`)
- Home page → Feature tabs: renders (evidence: `src/app/page.tsx`)
- Home page → Dashboard service: loads profile data (evidence: `src/app/page.tsx`)
- Home page → Site configuration: reads configuration (evidence: `src/app/page.tsx`)
- Blog pages → Blog service: loads posts (evidence: `src/app/blog/[slug]/page.tsx`)
- Blog preview → Blog service: loads posts (evidence: `src/components/landing/blog-preview.tsx`)
- Login page → Authentication services: uses authentication (evidence: `src/app/login/page.tsx`)
- Services editor → Services service: manages services (evidence: `src/components/dashboard/tabs/services-tab.tsx`)
- Chat interface → Chat API: sends chat requests
- Chat API → Chat persistence: persists messages (evidence: `src/app/api/chat/route.ts`)
- Chat API → Assistant tools: selects enabled tools (evidence: `src/app/api/chat/route.ts`)
- Chat API → OpenAI model: streams completion (evidence: `src/app/api/chat/route.ts`)
- Chat persistence → Supabase clients: queries database (evidence: `src/services/ai-chat.service.ts`)
- Assistant tools → Supabase clients: reads workspace data (evidence: `src/ai/tools/getDatabaseSummary.ts`)
- Assistant tools → Scheduling domain: may create schedules
- Services service → Supabase clients: reads and writes services (evidence: `src/services/services.ts`)
- Blog service → Supabase clients: queries content (evidence: `src/services/blog.ts`)
- Supabase clients → Supabase database: reads and writes
- Dashboard pages → Leads, bookings, gallery, team: manages records
- Dashboard pages → BIR tax calculations: offers tax workflows
- Artifact preview → Chat interface: shares chat artifacts
