# febryannnn/victoria-property-frontend architecture

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

- Interactive diagram: https://gitdiagram.com/febryannnn/victoria-property-frontend
- Repository: https://github.com/febryannnn/victoria-property-frontend

## Overview

Victoria Property is a real-estate discovery and administration web application built with Next.js. Visitors browse and filter listings, open property details, and access favorites; account pages support login and registration. Admin routes cover dashboard statistics, users, and property management. The frontend’s service modules call a separately hosted backend through shared HTTP helpers. Sampled sources and the source index support these main routes and service boundaries; details of unsampled components and backend behavior are not inferred.

Main entry points: [`lib/services/property.service.ts`](https://github.com/febryannnn/victoria-property-frontend/blob/main/lib/services/property.service.ts) (Property service), [`app/properties/page.tsx`](https://github.com/febryannnn/victoria-property-frontend/blob/main/app/properties/page.tsx) (Property catalog), [`lib/http.ts`](https://github.com/febryannnn/victoria-property-frontend/blob/main/lib/http.ts) (HTTP helpers), [`lib/services/dashboard.service.ts`](https://github.com/febryannnn/victoria-property-frontend/blob/main/lib/services/dashboard.service.ts) (Dashboard service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_discovery["Property discovery"]
  node_home["Home experience<br/>[Index.tsx]"]
  node_catalog["Property catalog<br/>[page.tsx]"]
  node_search["Search autocomplete"]
  node_detail["Property details<br/>[page.tsx]"]
  node_listing_card["Listing card<br/>[PropertyCard.tsx]"]
end

subgraph group_accounts["Accounts and favorites"]
  node_favorites["Saved properties<br/>[page.tsx]"]
  node_login["Login<br/>[page.tsx]"]
  node_register["Registration<br/>[page.tsx]"]
end

subgraph group_management["Administration"]
  node_admin_dashboard["Admin dashboard<br/>[page.tsx]"]
  node_admin_users["User administration<br/>[page.tsx]"]
  node_admin_properties["Property administration<br/>[Properties.tsx]"]
end

subgraph group_data["API and data"]
  node_auth_service["Authentication service<br/>[auth.service.ts]"]
  node_property_service["Property service"]
  node_favorite_service["Favorites service"]
  node_dashboard_service["Dashboard service"]
  node_http["HTTP helpers<br/>[http.ts]"]
  node_property_types["Property data types<br/>[property.ts]"]
end

node_visitor(("Visitor"))
node_backend{{"Hosted backend API"}}

node_visitor -->|"opens"| node_home
node_visitor -->|"browses"| node_catalog
node_catalog -->|"renders"| node_search
node_catalog -->|"loads listings"| node_property_service
node_catalog -->|"loads saved IDs"| node_favorite_service
node_catalog -->|"renders"| node_listing_card
node_search -->|"queries"| node_property_service
node_visitor -->|"opens listing"| node_detail
node_detail -->|"loads listing"| node_property_service
node_visitor -->|"views saved"| node_favorites
node_favorites -->|"loads favorites"| node_favorite_service
node_favorites -->|"renders"| node_listing_card
node_visitor -->|"signs in"| node_login
node_visitor -->|"registers"| node_register
node_login -->|"submits credentials"| node_auth_service
node_register -->|"submits registration"| node_auth_service
node_auth_service -->|"sends requests"| node_http
node_visitor -->|"opens admin"| node_admin_dashboard
node_admin_dashboard -->|"loads statistics"| node_dashboard_service
node_visitor -->|"manages users"| node_admin_users
node_admin_users -->|"loads users"| node_dashboard_service
node_visitor -->|"manages listings"| node_admin_properties
node_admin_properties -.->|"delegates management"| node_property_service
node_property_service -->|"sends requests"| node_http
node_favorite_service -->|"sends requests"| node_http
node_dashboard_service -->|"sends requests"| node_http
node_property_service -->|"uses types"| node_property_types
node_dashboard_service -->|"uses types"| node_property_types
node_http -->|"fetches API"| node_backend

click node_home "https://github.com/febryannnn/victoria-property-frontend/blob/main/app/Index.tsx"
click node_catalog "https://github.com/febryannnn/victoria-property-frontend/blob/main/app/properties/page.tsx"
click node_search "https://github.com/febryannnn/victoria-property-frontend/blob/main/components/SearchAutoComplete.tsx"
click node_detail "https://github.com/febryannnn/victoria-property-frontend/blob/main/app/property/%5Bid%5D/page.tsx"
click node_listing_card "https://github.com/febryannnn/victoria-property-frontend/blob/main/components/PropertyCard.tsx"
click node_favorites "https://github.com/febryannnn/victoria-property-frontend/blob/main/app/favorites/page.tsx"
click node_login "https://github.com/febryannnn/victoria-property-frontend/blob/main/app/login/page.tsx"
click node_register "https://github.com/febryannnn/victoria-property-frontend/blob/main/app/register/page.tsx"
click node_auth_service "https://github.com/febryannnn/victoria-property-frontend/blob/main/lib/services/auth.service.ts"
click node_admin_dashboard "https://github.com/febryannnn/victoria-property-frontend/blob/main/app/admin/dashboard/page.tsx"
click node_admin_users "https://github.com/febryannnn/victoria-property-frontend/blob/main/app/admin/users/page.tsx"
click node_admin_properties "https://github.com/febryannnn/victoria-property-frontend/blob/main/app/admin/properties/Properties.tsx"
click node_property_service "https://github.com/febryannnn/victoria-property-frontend/blob/main/lib/services/property.service.ts"
click node_favorite_service "https://github.com/febryannnn/victoria-property-frontend/blob/main/lib/services/favorites.service.ts"
click node_dashboard_service "https://github.com/febryannnn/victoria-property-frontend/blob/main/lib/services/dashboard.service.ts"
click node_http "https://github.com/febryannnn/victoria-property-frontend/blob/main/lib/http.ts"
click node_property_types "https://github.com/febryannnn/victoria-property-frontend/blob/main/lib/types/property.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_catalog,node_search,node_detail,node_listing_card toneBlue
class node_favorites,node_login,node_register toneAmber
class node_admin_dashboard,node_admin_users,node_admin_properties,node_backend toneMint
class node_auth_service,node_property_service,node_favorite_service,node_dashboard_service,node_http,node_property_types toneRose
class node_visitor toneIndigo
```

## Components

### Property discovery

- [Home experience](https://github.com/febryannnn/victoria-property-frontend/blob/main/app/Index.tsx): `app/Index.tsx`
- [Property catalog](https://github.com/febryannnn/victoria-property-frontend/blob/main/app/properties/page.tsx): `app/properties/page.tsx`
- [Search autocomplete](https://github.com/febryannnn/victoria-property-frontend/blob/main/components/SearchAutoComplete.tsx): `components/SearchAutoComplete.tsx`
- [Property details](https://github.com/febryannnn/victoria-property-frontend/blob/main/app/property/%5Bid%5D/page.tsx): `app/property/[id]/page.tsx`
- [Listing card](https://github.com/febryannnn/victoria-property-frontend/blob/main/components/PropertyCard.tsx): `components/PropertyCard.tsx`

### Accounts and favorites

- [Saved properties](https://github.com/febryannnn/victoria-property-frontend/blob/main/app/favorites/page.tsx): `app/favorites/page.tsx`
- [Login](https://github.com/febryannnn/victoria-property-frontend/blob/main/app/login/page.tsx): `app/login/page.tsx`
- [Registration](https://github.com/febryannnn/victoria-property-frontend/blob/main/app/register/page.tsx): `app/register/page.tsx`

### Administration

- [Admin dashboard](https://github.com/febryannnn/victoria-property-frontend/blob/main/app/admin/dashboard/page.tsx): `app/admin/dashboard/page.tsx`
- [User administration](https://github.com/febryannnn/victoria-property-frontend/blob/main/app/admin/users/page.tsx): `app/admin/users/page.tsx`
- [Property administration](https://github.com/febryannnn/victoria-property-frontend/blob/main/app/admin/properties/Properties.tsx): `app/admin/properties/Properties.tsx`

### API and data

- [Authentication service](https://github.com/febryannnn/victoria-property-frontend/blob/main/lib/services/auth.service.ts): `lib/services/auth.service.ts`
- [Property service](https://github.com/febryannnn/victoria-property-frontend/blob/main/lib/services/property.service.ts): `lib/services/property.service.ts`
- [Favorites service](https://github.com/febryannnn/victoria-property-frontend/blob/main/lib/services/favorites.service.ts): `lib/services/favorites.service.ts`
- [Dashboard service](https://github.com/febryannnn/victoria-property-frontend/blob/main/lib/services/dashboard.service.ts): `lib/services/dashboard.service.ts`
- [HTTP helpers](https://github.com/febryannnn/victoria-property-frontend/blob/main/lib/http.ts): `lib/http.ts`
- [Property data types](https://github.com/febryannnn/victoria-property-frontend/blob/main/lib/types/property.ts): `lib/types/property.ts`

### Other components

- **Visitor**
- **Hosted backend API**

## Connections

- Visitor → Home experience: opens (evidence: `app/Index.tsx`)
- Visitor → Property catalog: browses (evidence: `app/properties/page.tsx`)
- Property catalog → Search autocomplete: renders (evidence: `app/properties/page.tsx`)
- Property catalog → Property service: loads listings (evidence: `app/properties/page.tsx`)
- Property catalog → Favorites service: loads saved IDs (evidence: `app/properties/page.tsx`)
- Property catalog → Listing card: renders (evidence: `app/properties/page.tsx`)
- Search autocomplete → Property service: queries (evidence: `components/SearchAutoComplete.tsx`)
- Visitor → Property details: opens listing (evidence: `app/property/[id]/page.tsx`)
- Property details → Property service: loads listing (evidence: `app/property/[id]/page.tsx`)
- Visitor → Saved properties: views saved (evidence: `app/favorites/page.tsx`)
- Saved properties → Favorites service: loads favorites (evidence: `app/favorites/page.tsx`)
- Saved properties → Listing card: renders (evidence: `app/favorites/page.tsx`)
- Visitor → Login: signs in (evidence: `app/login/page.tsx`)
- Visitor → Registration: registers (evidence: `app/register/page.tsx`)
- Login → Authentication service: submits credentials (evidence: `app/login/page.tsx`)
- Registration → Authentication service: submits registration (evidence: `app/register/page.tsx`)
- Authentication service → HTTP helpers: sends requests (evidence: `lib/services/auth.service.ts`)
- Visitor → Admin dashboard: opens admin (evidence: `app/admin/dashboard/page.tsx`)
- Admin dashboard → Dashboard service: loads statistics (evidence: `app/admin/dashboard/page.tsx`)
- Visitor → User administration: manages users (evidence: `app/admin/users/page.tsx`)
- User administration → Dashboard service: loads users (evidence: `app/admin/users/page.tsx`)
- Visitor → Property administration: manages listings
- Property administration → Property service: delegates management
- Property service → HTTP helpers: sends requests (evidence: `lib/services/property.service.ts`)
- Favorites service → HTTP helpers: sends requests (evidence: `lib/services/favorites.service.ts`)
- Dashboard service → HTTP helpers: sends requests (evidence: `lib/services/dashboard.service.ts`)
- Property service → Property data types: uses types (evidence: `lib/services/property.service.ts`)
- Dashboard service → Property data types: uses types (evidence: `lib/services/dashboard.service.ts`)
- HTTP helpers → Hosted backend API: fetches API (evidence: `lib/http.ts`)
