# vitas1968/real_estate_serbia architecture

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

- Interactive diagram: https://gitdiagram.com/vitas1968/real_estate_serbia
- Repository: https://github.com/vitas1968/real_estate_serbia

## Overview

Недвижимость в Сербии — MVP-сервис объявлений. Основной пользовательский сценарий: посетитель просматривает публичный каталог или карту и открывает карточку объявления; владелец создаёт объект недвижимости, публикует объявление и управляет им. Backend также поддерживает аутентификацию, профиль, фотографии и проверки готовности. Показаны подтверждённые вызовы и маршрутизация; связи web-экранов с API не подтверждены представленными исходниками, поэтому не изображены. Mapbox указан в README как выбранный провайдер, но его runtime-вызов здесь не проверен.

Main entry points: [`src/backend/app/http/router.py`](https://github.com/vitas1968/real_estate_serbia/blob/main/src/backend/app/http/router.py) (HTTP route assembly), [`src/backend/modules/listings/application/listing_service.py`](https://github.com/vitas1968/real_estate_serbia/blob/main/src/backend/modules/listings/application/listing_service.py) (Listing lifecycle), [`src/client/shared/foundation/api/api_client.ts`](https://github.com/vitas1968/real_estate_serbia/blob/main/src/client/shared/foundation/api/api_client.ts) (API client), [`src/client/web/screens/public_catalog_list_screen.tsx`](https://github.com/vitas1968/real_estate_serbia/blob/main/src/client/web/screens/public_catalog_list_screen.tsx) (Public catalog)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web discovery"]
  node_web_catalog["Public catalog"]
  node_web_map["Catalog map"]
  node_web_details["Listing details"]
  node_web_views["Listing and map views"]
  node_web_router["Web routing<br/>[router.ts]"]
  node_web_i18n["Web localization<br/>[resources.ts]"]
end

subgraph group_backend["Backend API"]
  node_api_routes["HTTP route assembly<br/>[router.py]"]
  node_auth_routes["Authentication routes<br/>[auth_router.py]"]
  node_auth_service["Authentication service<br/>[auth_service.py]"]
  node_property_routes["Property routes<br/>[property_router.py]"]
  node_listing_routes["Listing routes<br/>[listing_router.py]"]
  node_catalog_routes["Catalog routes<br/>[catalog_router.py]"]
  node_profile_routes["Profile routes<br/>[profile_router.py]"]
  node_readiness["Readiness checks"]
end

subgraph group_domain["Listing domain"]
  node_property_service["Property service"]
  node_geocoder["Mapbox geocoding adapter"]
  node_listing_service["Listing lifecycle<br/>[listing_service.py]"]
  node_publication_checks["Publication checks"]
  node_photo_service["Photo handling<br/>[photo_service.py]"]
  node_catalog_service["Public discovery service<br/>[catalog_service.py]"]
  node_profile_service["Profile service<br/>[profile_service.py]"]
end

subgraph group_shared["Shared runtime"]
  node_api_client["API client<br/>[api_client.ts]"]
  node_http_client["HTTP transport<br/>[http_client.ts]"]
  node_request_context["Request context"]
  node_errors["Application errors<br/>[app_error.py]"]
end

node_visitor(("Visitor / owner"))

node_visitor -->|"browses"| node_web_catalog
node_visitor -->|"explores"| node_web_map
node_visitor -->|"opens listing"| node_web_details
node_web_router -->|"routes to"| node_web_catalog
node_web_router -->|"routes to"| node_web_details
node_web_catalog -.->|"renders"| node_web_views
node_web_map -.->|"renders"| node_web_views
node_web_catalog -.->|"requests data"| node_api_client
node_web_map -.->|"requests data"| node_api_client
node_web_details -.->|"requests data"| node_api_client
node_web_i18n -.->|"provides shared strings"| node_api_client
node_api_client -->|"uses"| node_http_client
node_api_routes -->|"mounts"| node_auth_routes
node_api_routes -->|"mounts"| node_property_routes
node_api_routes -->|"mounts"| node_listing_routes
node_api_routes -->|"mounts"| node_catalog_routes
node_api_routes -->|"mounts"| node_profile_routes
node_api_routes -->|"checks readiness"| node_readiness
node_api_routes -->|"builds context"| node_request_context
node_auth_routes -->|"calls"| node_auth_service
node_property_routes -->|"calls"| node_property_service
node_listing_routes -->|"calls"| node_listing_service
node_catalog_routes -->|"calls"| node_catalog_service
node_profile_routes -->|"calls"| node_profile_service
node_listing_service -->|"checks ownership"| node_property_service
node_listing_service -->|"loads photos"| node_photo_service
node_listing_service -->|"uses checks"| node_publication_checks
node_catalog_service -->|"reads listings"| node_listing_service
node_catalog_service -->|"reads locations"| node_property_service
node_property_service -.->|"geocodes address"| node_geocoder
node_api_routes -.->|"maps failures"| node_errors

click node_web_catalog "https://github.com/vitas1968/real_estate_serbia/blob/main/src/client/web/screens/public_catalog_list_screen.tsx"
click node_web_map "https://github.com/vitas1968/real_estate_serbia/blob/main/src/client/web/screens/public_catalog_map_screen.tsx"
click node_web_details "https://github.com/vitas1968/real_estate_serbia/blob/main/src/client/web/screens/public_listing_details_screen.tsx"
click node_web_views "https://github.com/vitas1968/real_estate_serbia/tree/main/src/client/web/features/listings"
click node_web_router "https://github.com/vitas1968/real_estate_serbia/blob/main/src/client/web/navigation/router.ts"
click node_web_i18n "https://github.com/vitas1968/real_estate_serbia/blob/main/src/client/shared/i18n/resources.ts"
click node_api_client "https://github.com/vitas1968/real_estate_serbia/blob/main/src/client/shared/foundation/api/api_client.ts"
click node_http_client "https://github.com/vitas1968/real_estate_serbia/blob/main/src/client/shared/foundation/api/http_client.ts"
click node_api_routes "https://github.com/vitas1968/real_estate_serbia/blob/main/src/backend/app/http/router.py"
click node_request_context "https://github.com/vitas1968/real_estate_serbia/blob/main/src/backend/app/http/request_context_factory.py"
click node_auth_routes "https://github.com/vitas1968/real_estate_serbia/blob/main/src/backend/modules/auth/transport/auth_router.py"
click node_auth_service "https://github.com/vitas1968/real_estate_serbia/blob/main/src/backend/modules/auth/application/auth_service.py"
click node_property_routes "https://github.com/vitas1968/real_estate_serbia/blob/main/src/backend/modules/properties/transport/property_router.py"
click node_property_service "https://github.com/vitas1968/real_estate_serbia/blob/main/src/backend/modules/properties/application/property_service.py"
click node_geocoder "https://github.com/vitas1968/real_estate_serbia/blob/main/src/backend/modules/properties/infrastructure/mapbox_property_geocoding_adapter.py"
click node_listing_routes "https://github.com/vitas1968/real_estate_serbia/blob/main/src/backend/modules/listings/transport/listing_router.py"
click node_listing_service "https://github.com/vitas1968/real_estate_serbia/blob/main/src/backend/modules/listings/application/listing_service.py"
click node_publication_checks "https://github.com/vitas1968/real_estate_serbia/blob/main/src/backend/modules/listings/application/publication_checks.py"
click node_photo_service "https://github.com/vitas1968/real_estate_serbia/blob/main/src/backend/modules/photos/application/photo_service.py"
click node_catalog_routes "https://github.com/vitas1968/real_estate_serbia/blob/main/src/backend/modules/catalog/transport/catalog_router.py"
click node_catalog_service "https://github.com/vitas1968/real_estate_serbia/blob/main/src/backend/modules/catalog/application/catalog_service.py"
click node_profile_routes "https://github.com/vitas1968/real_estate_serbia/blob/main/src/backend/modules/users/transport/profile_router.py"
click node_profile_service "https://github.com/vitas1968/real_estate_serbia/blob/main/src/backend/modules/users/application/profile_service.py"
click node_readiness "https://github.com/vitas1968/real_estate_serbia/blob/main/src/backend/modules/health/application/readiness_service.py"
click node_errors "https://github.com/vitas1968/real_estate_serbia/blob/main/src/backend/shared/errors/app_error.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_web_catalog,node_web_map,node_web_details,node_web_views,node_web_router,node_web_i18n toneBlue
class node_api_routes,node_auth_routes,node_auth_service,node_property_routes,node_listing_routes,node_catalog_routes,node_profile_routes,node_readiness toneAmber
class node_property_service,node_geocoder,node_listing_service,node_publication_checks,node_photo_service,node_catalog_service,node_profile_service toneMint
class node_api_client,node_http_client,node_request_context,node_errors toneRose
class node_visitor toneIndigo
```

## Components

### Web discovery

- [Public catalog](https://github.com/vitas1968/real_estate_serbia/blob/main/src/client/web/screens/public_catalog_list_screen.tsx): `src/client/web/screens/public_catalog_list_screen.tsx`
- [Catalog map](https://github.com/vitas1968/real_estate_serbia/blob/main/src/client/web/screens/public_catalog_map_screen.tsx): `src/client/web/screens/public_catalog_map_screen.tsx`
- [Listing details](https://github.com/vitas1968/real_estate_serbia/blob/main/src/client/web/screens/public_listing_details_screen.tsx): `src/client/web/screens/public_listing_details_screen.tsx`
- [Listing and map views](https://github.com/vitas1968/real_estate_serbia/tree/main/src/client/web/features/listings): `src/client/web/features/listings`
- [Web routing](https://github.com/vitas1968/real_estate_serbia/blob/main/src/client/web/navigation/router.ts): `src/client/web/navigation/router.ts`
- [Web localization](https://github.com/vitas1968/real_estate_serbia/blob/main/src/client/shared/i18n/resources.ts): `src/client/shared/i18n/resources.ts`

### Backend API

- [HTTP route assembly](https://github.com/vitas1968/real_estate_serbia/blob/main/src/backend/app/http/router.py): `src/backend/app/http/router.py`
- [Authentication routes](https://github.com/vitas1968/real_estate_serbia/blob/main/src/backend/modules/auth/transport/auth_router.py): `src/backend/modules/auth/transport/auth_router.py`
- [Authentication service](https://github.com/vitas1968/real_estate_serbia/blob/main/src/backend/modules/auth/application/auth_service.py): `src/backend/modules/auth/application/auth_service.py`
- [Property routes](https://github.com/vitas1968/real_estate_serbia/blob/main/src/backend/modules/properties/transport/property_router.py): `src/backend/modules/properties/transport/property_router.py`
- [Listing routes](https://github.com/vitas1968/real_estate_serbia/blob/main/src/backend/modules/listings/transport/listing_router.py): `src/backend/modules/listings/transport/listing_router.py`
- [Catalog routes](https://github.com/vitas1968/real_estate_serbia/blob/main/src/backend/modules/catalog/transport/catalog_router.py): `src/backend/modules/catalog/transport/catalog_router.py`
- [Profile routes](https://github.com/vitas1968/real_estate_serbia/blob/main/src/backend/modules/users/transport/profile_router.py): `src/backend/modules/users/transport/profile_router.py`
- [Readiness checks](https://github.com/vitas1968/real_estate_serbia/blob/main/src/backend/modules/health/application/readiness_service.py): `src/backend/modules/health/application/readiness_service.py`

### Listing domain

- [Property service](https://github.com/vitas1968/real_estate_serbia/blob/main/src/backend/modules/properties/application/property_service.py): `src/backend/modules/properties/application/property_service.py`
- [Mapbox geocoding adapter](https://github.com/vitas1968/real_estate_serbia/blob/main/src/backend/modules/properties/infrastructure/mapbox_property_geocoding_adapter.py): `src/backend/modules/properties/infrastructure/mapbox_property_geocoding_adapter.py`
- [Listing lifecycle](https://github.com/vitas1968/real_estate_serbia/blob/main/src/backend/modules/listings/application/listing_service.py): `src/backend/modules/listings/application/listing_service.py`
- [Publication checks](https://github.com/vitas1968/real_estate_serbia/blob/main/src/backend/modules/listings/application/publication_checks.py): `src/backend/modules/listings/application/publication_checks.py`
- [Photo handling](https://github.com/vitas1968/real_estate_serbia/blob/main/src/backend/modules/photos/application/photo_service.py): `src/backend/modules/photos/application/photo_service.py`
- [Public discovery service](https://github.com/vitas1968/real_estate_serbia/blob/main/src/backend/modules/catalog/application/catalog_service.py): `src/backend/modules/catalog/application/catalog_service.py`
- [Profile service](https://github.com/vitas1968/real_estate_serbia/blob/main/src/backend/modules/users/application/profile_service.py): `src/backend/modules/users/application/profile_service.py`

### Shared runtime

- [API client](https://github.com/vitas1968/real_estate_serbia/blob/main/src/client/shared/foundation/api/api_client.ts): `src/client/shared/foundation/api/api_client.ts`
- [HTTP transport](https://github.com/vitas1968/real_estate_serbia/blob/main/src/client/shared/foundation/api/http_client.ts): `src/client/shared/foundation/api/http_client.ts`
- [Request context](https://github.com/vitas1968/real_estate_serbia/blob/main/src/backend/app/http/request_context_factory.py): `src/backend/app/http/request_context_factory.py`
- [Application errors](https://github.com/vitas1968/real_estate_serbia/blob/main/src/backend/shared/errors/app_error.py): `src/backend/shared/errors/app_error.py`

### Other components

- **Visitor / owner**

## Connections

- Visitor / owner → Public catalog: browses (evidence: `README.md`)
- Visitor / owner → Catalog map: explores (evidence: `README.md`)
- Visitor / owner → Listing details: opens listing (evidence: `README.md`)
- Web routing → Public catalog: routes to
- Web routing → Listing details: routes to
- Public catalog → Listing and map views: renders
- Catalog map → Listing and map views: renders
- Public catalog → API client: requests data
- Catalog map → API client: requests data
- Listing details → API client: requests data
- Web localization → API client: provides shared strings
- API client → HTTP transport: uses (evidence: `src/client/shared/foundation/api/api_client.ts`)
- HTTP route assembly → Authentication routes: mounts (evidence: `src/backend/app/http/router.py`)
- HTTP route assembly → Property routes: mounts (evidence: `src/backend/app/http/router.py`)
- HTTP route assembly → Listing routes: mounts (evidence: `src/backend/app/http/router.py`)
- HTTP route assembly → Catalog routes: mounts (evidence: `src/backend/app/http/router.py`)
- HTTP route assembly → Profile routes: mounts (evidence: `src/backend/app/http/router.py`)
- HTTP route assembly → Readiness checks: checks readiness (evidence: `src/backend/app/http/router.py`)
- HTTP route assembly → Request context: builds context (evidence: `src/backend/app/http/router.py`)
- Authentication routes → Authentication service: calls (evidence: `src/backend/modules/auth/transport/auth_router.py`)
- Property routes → Property service: calls (evidence: `src/backend/modules/properties/transport/property_router.py`)
- Listing routes → Listing lifecycle: calls (evidence: `src/backend/modules/listings/transport/listing_router.py`)
- Catalog routes → Public discovery service: calls (evidence: `src/backend/modules/catalog/transport/catalog_router.py`)
- Profile routes → Profile service: calls (evidence: `src/backend/modules/users/transport/profile_router.py`)
- Listing lifecycle → Property service: checks ownership (evidence: `src/backend/modules/listings/application/listing_service.py`)
- Listing lifecycle → Photo handling: loads photos (evidence: `src/backend/modules/listings/application/listing_service.py`)
- Listing lifecycle → Publication checks: uses checks (evidence: `src/backend/modules/listings/application/listing_service.py`)
- Public discovery service → Listing lifecycle: reads listings (evidence: `src/backend/modules/catalog/application/catalog_service.py`)
- Public discovery service → Property service: reads locations (evidence: `src/backend/modules/catalog/application/catalog_service.py`)
- Property service → Mapbox geocoding adapter: geocodes address (evidence: `README.md`)
- HTTP route assembly → Application errors: maps failures (evidence: `src/backend/app/bootstrap/main.py`)
