# secretgspot/25-cariari.agency architecture

> Architecture diagram of the GitHub repository secretgspot/25-cariari.agency, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-16). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/secretgspot/25-cariari.agency
- Repository: https://github.com/secretgspot/25-cariari.agency

## Overview

Cariari.Agency is a real-estate listings platform for the Cariari area. Buyers browse and filter properties, inspect map previews and details, then submit inquiries; agents authenticate to create or maintain listings, capture locations and photos, and produce printable QR flyers. Separate branches provide a read-only public property API, agency contact, and sitemap generation. The README documents these capabilities; sampled server code confirms inquiry handling and listing writes, but most page and map implementations were not sampled, so their internal links are not asserted.

Main entry points: [`src/routes/(app)/properties/add/+page.server.js`](https://github.com/secretgspot/25-cariari.agency/blob/main/src/routes/(app)/properties/add/%2Bpage.server.js) (Create listing), [`src/routes/(app)/[id]/+page.server.js`](https://github.com/secretgspot/25-cariari.agency/blob/main/src/routes/(app)/%5Bid%5D/%2Bpage.server.js) (Inquiry handling), [`src/routes/(app)/+page.svelte`](https://github.com/secretgspot/25-cariari.agency/blob/main/src/routes/(app)/%2Bpage.svelte) (Map explorer), [`src/lib/map/MapLibre.svelte`](https://github.com/secretgspot/25-cariari.agency/blob/main/src/lib/map/MapLibre.svelte) (MapLibre explorer)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_discovery["Property discovery"]
  node_home["Map explorer<br/>[+page.svelte]"]
  node_map["MapLibre explorer<br/>[MapLibre.svelte]"]
  node_preview["Property preview<br/>[Preview.svelte]"]
  node_filters["Listing filters<br/>[Filters.svelte]"]
  node_listinggrid["Listings grid<br/>[+page.svelte]"]
  node_detail["Property details<br/>[+page.svelte]"]
end

subgraph group_operations["Listing operations"]
  node_auth["Authentication<br/>[+page.server.js]"]
  node_add["Create listing<br/>[+page.server.js]"]
  node_edit["Edit listing<br/>[+page.server.js]"]
  node_uploader["Photo uploader<br/>[Uploader.svelte]"]
  node_picker["Location picker<br/>[MapPicker.svelte]"]
  node_print["QR flyer<br/>[+page.svelte]"]
end

subgraph group_engagement["Buyer engagement"]
  node_inquiry["Inquiry handling<br/>[+page.server.js]"]
  node_contact["Agency contact<br/>[+page.server.js]"]
end

subgraph group_public["Public access"]
  node_api["Properties API<br/>[+server.js]"]
  node_apiitem["Single-property API<br/>[+server.js]"]
  node_sitemap["SEO sitemap<br/>[+server.js]"]
end

node_visitor(("Buyer or visitor"))
node_agent(("Listing agent"))
node_database[("Supabase data")]
node_storage[("Supabase Storage")]
node_email["Email transport"]

node_visitor -->|"browses"| node_home
node_home -->|"shows listings"| node_map
node_visitor -->|"filters listings"| node_listinggrid
node_listinggrid -->|"filters by"| node_filters
node_visitor -->|"opens listing"| node_detail
node_map -->|"previews property"| node_preview
node_agent -->|"signs in"| node_auth
node_agent -->|"creates listing"| node_add
node_agent -->|"maintains listing"| node_edit
node_add -->|"captures location"| node_picker
node_add -->|"adds photos"| node_uploader
node_edit -->|"manages photos"| node_storage
node_agent -->|"prints flyer"| node_print
node_visitor -->|"submits inquiry"| node_inquiry
node_inquiry -->|"saves lead"| node_database
node_inquiry -->|"notifies agent"| node_email
node_visitor -->|"contacts agency"| node_contact
node_contact -->|"sends message"| node_email
node_visitor -->|"requests properties"| node_api
node_visitor -->|"requests property"| node_apiitem
node_api -->|"queries listings"| node_database
node_apiitem -->|"queries listing"| node_database
node_sitemap -->|"reads listings"| node_database

click node_home "https://github.com/secretgspot/25-cariari.agency/blob/main/src/routes/(app)/%2Bpage.svelte"
click node_map "https://github.com/secretgspot/25-cariari.agency/blob/main/src/lib/map/MapLibre.svelte"
click node_preview "https://github.com/secretgspot/25-cariari.agency/blob/main/src/lib/Preview.svelte"
click node_filters "https://github.com/secretgspot/25-cariari.agency/blob/main/src/lib/Filters.svelte"
click node_listinggrid "https://github.com/secretgspot/25-cariari.agency/blob/main/src/routes/(app)/properties/%2Bpage.svelte"
click node_detail "https://github.com/secretgspot/25-cariari.agency/blob/main/src/routes/(app)/%5Bid%5D/%2Bpage.svelte"
click node_auth "https://github.com/secretgspot/25-cariari.agency/blob/main/src/routes/(auth)/login/%2Bpage.server.js"
click node_add "https://github.com/secretgspot/25-cariari.agency/blob/main/src/routes/(app)/properties/add/%2Bpage.server.js"
click node_edit "https://github.com/secretgspot/25-cariari.agency/blob/main/src/routes/(app)/%5Bid%5D/edit/%2Bpage.server.js"
click node_uploader "https://github.com/secretgspot/25-cariari.agency/blob/main/src/lib/Uploader.svelte"
click node_picker "https://github.com/secretgspot/25-cariari.agency/blob/main/src/lib/map/MapPicker.svelte"
click node_print "https://github.com/secretgspot/25-cariari.agency/blob/main/src/routes/(app)/%5Bid%5D/print/%2Bpage.svelte"
click node_inquiry "https://github.com/secretgspot/25-cariari.agency/blob/main/src/routes/(app)/%5Bid%5D/%2Bpage.server.js"
click node_contact "https://github.com/secretgspot/25-cariari.agency/blob/main/src/routes/(app)/about/%2Bpage.server.js"
click node_api "https://github.com/secretgspot/25-cariari.agency/blob/main/src/routes/(api)/api/properties/%2Bserver.js"
click node_apiitem "https://github.com/secretgspot/25-cariari.agency/blob/main/src/routes/(api)/api/properties/%5Bid%5D/%2Bserver.js"
click node_sitemap "https://github.com/secretgspot/25-cariari.agency/blob/main/src/routes/sitemap.xml/%2Bserver.js"

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_map,node_preview,node_filters,node_listinggrid,node_detail toneBlue
class node_auth,node_add,node_edit,node_uploader,node_picker,node_print,node_database,node_storage toneAmber
class node_inquiry,node_contact toneMint
class node_api,node_apiitem,node_sitemap toneRose
class node_visitor,node_agent,node_email toneIndigo
```

## Components

### Property discovery

- [Map explorer](https://github.com/secretgspot/25-cariari.agency/blob/main/src/routes/(app)/%2Bpage.svelte): `src/routes/(app)/+page.svelte`
- [MapLibre explorer](https://github.com/secretgspot/25-cariari.agency/blob/main/src/lib/map/MapLibre.svelte): `src/lib/map/MapLibre.svelte`
- [Property preview](https://github.com/secretgspot/25-cariari.agency/blob/main/src/lib/Preview.svelte): `src/lib/Preview.svelte`
- [Listing filters](https://github.com/secretgspot/25-cariari.agency/blob/main/src/lib/Filters.svelte): `src/lib/Filters.svelte`
- [Listings grid](https://github.com/secretgspot/25-cariari.agency/blob/main/src/routes/(app)/properties/%2Bpage.svelte): `src/routes/(app)/properties/+page.svelte`
- [Property details](https://github.com/secretgspot/25-cariari.agency/blob/main/src/routes/(app)/%5Bid%5D/%2Bpage.svelte): `src/routes/(app)/[id]/+page.svelte`

### Listing operations

- [Authentication](https://github.com/secretgspot/25-cariari.agency/blob/main/src/routes/(auth)/login/%2Bpage.server.js): `src/routes/(auth)/login/+page.server.js`
- [Create listing](https://github.com/secretgspot/25-cariari.agency/blob/main/src/routes/(app)/properties/add/%2Bpage.server.js): `src/routes/(app)/properties/add/+page.server.js`
- [Edit listing](https://github.com/secretgspot/25-cariari.agency/blob/main/src/routes/(app)/%5Bid%5D/edit/%2Bpage.server.js): `src/routes/(app)/[id]/edit/+page.server.js`
- [Photo uploader](https://github.com/secretgspot/25-cariari.agency/blob/main/src/lib/Uploader.svelte): `src/lib/Uploader.svelte`
- [Location picker](https://github.com/secretgspot/25-cariari.agency/blob/main/src/lib/map/MapPicker.svelte): `src/lib/map/MapPicker.svelte`
- [QR flyer](https://github.com/secretgspot/25-cariari.agency/blob/main/src/routes/(app)/%5Bid%5D/print/%2Bpage.svelte): `src/routes/(app)/[id]/print/+page.svelte`

### Buyer engagement

- [Inquiry handling](https://github.com/secretgspot/25-cariari.agency/blob/main/src/routes/(app)/%5Bid%5D/%2Bpage.server.js): `src/routes/(app)/[id]/+page.server.js`
- [Agency contact](https://github.com/secretgspot/25-cariari.agency/blob/main/src/routes/(app)/about/%2Bpage.server.js): `src/routes/(app)/about/+page.server.js`

### Public access

- [Properties API](https://github.com/secretgspot/25-cariari.agency/blob/main/src/routes/(api)/api/properties/%2Bserver.js): `src/routes/(api)/api/properties/+server.js`
- [Single-property API](https://github.com/secretgspot/25-cariari.agency/blob/main/src/routes/(api)/api/properties/%5Bid%5D/%2Bserver.js): `src/routes/(api)/api/properties/[id]/+server.js`
- [SEO sitemap](https://github.com/secretgspot/25-cariari.agency/blob/main/src/routes/sitemap.xml/%2Bserver.js): `src/routes/sitemap.xml/+server.js`

### Other components

- **Buyer or visitor**
- **Listing agent**
- **Supabase data**
- **Supabase Storage**
- **Email transport**

## Connections

- Buyer or visitor → Map explorer: browses
- Map explorer → MapLibre explorer: shows listings
- Buyer or visitor → Listings grid: filters listings
- Listings grid → Listing filters: filters by
- Buyer or visitor → Property details: opens listing
- MapLibre explorer → Property preview: previews property
- Listing agent → Authentication: signs in
- Listing agent → Create listing: creates listing
- Listing agent → Edit listing: maintains listing
- Create listing → Location picker: captures location
- Create listing → Photo uploader: adds photos
- Edit listing → Supabase Storage: manages photos (evidence: `src/routes/(app)/[id]/edit/+page.server.js`)
- Listing agent → QR flyer: prints flyer
- Buyer or visitor → Inquiry handling: submits inquiry
- Inquiry handling → Supabase data: saves lead (evidence: `src/routes/(app)/[id]/+page.server.js`)
- Inquiry handling → Email transport: notifies agent (evidence: `src/routes/(app)/[id]/+page.server.js`)
- Buyer or visitor → Agency contact: contacts agency
- Agency contact → Email transport: sends message (evidence: `src/routes/(app)/about/+page.server.js`)
- Buyer or visitor → Properties API: requests properties
- Buyer or visitor → Single-property API: requests property
- Properties API → Supabase data: queries listings
- Single-property API → Supabase data: queries listing
- SEO sitemap → Supabase data: reads listings (evidence: `src/routes/sitemap.xml/+server.js`)
