How vitas1968/real_estate_serbia works
Недвижимость в Сербии — MVP-сервис объявлений. Основной пользовательский сценарий: посетитель просматривает публичный каталог или карту и открывает карточку объявления; владелец создаёт объект недвижимости, публикует объявление и управляет им. Backend также поддерживает аутентификацию, профиль, фотографии и проверки готовности. Показаны подтверждённые вызовы и маршрутизация; связи web-экранов с API не подтверждены представленными исходниками, поэтому не изображены. Mapbox указан в README как выбранный провайдер, но его runtime-вызов здесь не проверен.
Main entry points: router.py HTTP route assembly · listing_service.py Listing lifecycle · api_client.ts API client · public_catalog_list_screen.tsx Public catalog
Components 26
Web discovery
- Public catalog
src/client/web/screens/public_catalog_list_screen.tsx - Catalog map
src/client/web/screens/public_catalog_map_screen.tsx - Listing details
src/client/web/screens/public_listing_details_screen.tsx - Listing and map views
src/client/web/features/listings - Web routing
src/client/web/navigation/router.ts - Web localization
src/client/shared/i18n/resources.ts
Backend API
- HTTP route assembly
src/backend/app/http/router.py - Authentication routes
src/backend/modules/auth/transport/auth_router.py - Authentication service
src/backend/modules/auth/application/auth_service.py - Property routes
src/backend/modules/properties/transport/property_router.py - Listing routes
src/backend/modules/listings/transport/listing_router.py - Catalog routes
src/backend/modules/catalog/transport/catalog_router.py - Profile routes
src/backend/modules/users/transport/profile_router.py - Readiness checks
src/backend/modules/health/application/readiness_service.py
Listing domain
- Property service
src/backend/modules/properties/application/property_service.py - Mapbox geocoding adapter
src/backend/modules/properties/infrastructure/mapbox_property_geocoding_adapter.py - Listing lifecycle
src/backend/modules/listings/application/listing_service.py - Publication checks
src/backend/modules/listings/application/publication_checks.py - Photo handling
src/backend/modules/photos/application/photo_service.py - Public discovery service
src/backend/modules/catalog/application/catalog_service.py - Profile service
src/backend/modules/users/application/profile_service.py
Shared runtime
- API client
src/client/shared/foundation/api/api_client.ts - HTTP transport
src/client/shared/foundation/api/http_client.ts - Request context
src/backend/app/http/request_context_factory.py - Application errors
src/backend/shared/errors/app_error.py
Other components
- Visitor / owner
Connections 31
- Visitor / owner → Public catalog: browses
README.md - Visitor / owner → Catalog map: explores
README.md - Visitor / owner → Listing details: opens listing
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
src/client/shared/foundation/api/api_client.ts - HTTP route assembly → Authentication routes: mounts
src/backend/app/http/router.py - HTTP route assembly → Property routes: mounts
src/backend/app/http/router.py - HTTP route assembly → Listing routes: mounts
src/backend/app/http/router.py - HTTP route assembly → Catalog routes: mounts
src/backend/app/http/router.py - HTTP route assembly → Profile routes: mounts
src/backend/app/http/router.py - HTTP route assembly → Readiness checks: checks readiness
src/backend/app/http/router.py - HTTP route assembly → Request context: builds context
src/backend/app/http/router.py - Authentication routes → Authentication service: calls
src/backend/modules/auth/transport/auth_router.py - Property routes → Property service: calls
src/backend/modules/properties/transport/property_router.py - Listing routes → Listing lifecycle: calls
src/backend/modules/listings/transport/listing_router.py - Catalog routes → Public discovery service: calls
src/backend/modules/catalog/transport/catalog_router.py - Profile routes → Profile service: calls
src/backend/modules/users/transport/profile_router.py - Listing lifecycle → Property service: checks ownership
src/backend/modules/listings/application/listing_service.py - Listing lifecycle → Photo handling: loads photos
src/backend/modules/listings/application/listing_service.py - Listing lifecycle → Publication checks: uses checks
src/backend/modules/listings/application/listing_service.py - Public discovery service → Listing lifecycle: reads listings
src/backend/modules/catalog/application/catalog_service.py - Public discovery service → Property service: reads locations
src/backend/modules/catalog/application/catalog_service.py - Property service → Mapbox geocoding adapter: geocodes address
README.md - HTTP route assembly → Application errors: maps failures
src/backend/app/bootstrap/main.py