48ccbdafc8
Доп. поля для трейд-ин менеджера: тип собственности, ипотека/ обременение, имя и телефон клиента. На расчёт оценки не влияют — сохраняются в trade_in_estimates вместе с записью. - data/sql/008_crm_fields.sql — 4 колонки в trade_in_estimates. - TradeInEstimateInput + estimator INSERT — приём и сохранение. - EstimateForm — секция «CRM — для менеджера» (4 поля). Closes #395
78 lines
3.2 KiB
Python
78 lines
3.2 KiB
Python
"""Pydantic schemas for Trade-In Estimator.
|
|
|
|
POST /api/v1/trade-in/estimate → AggregatedEstimate
|
|
"""
|
|
|
|
from __future__ import annotations
|
|
|
|
from datetime import date, datetime
|
|
from typing import Literal
|
|
from uuid import UUID
|
|
|
|
from pydantic import BaseModel, Field
|
|
|
|
|
|
class TradeInEstimateInput(BaseModel):
|
|
address: str = Field(min_length=3, max_length=500)
|
|
area_m2: float = Field(gt=10, lt=500)
|
|
rooms: int = Field(ge=0, le=10) # 0 = студия
|
|
floor: int = Field(ge=1, le=100)
|
|
total_floors: int = Field(ge=1, le=100)
|
|
year_built: int | None = Field(default=None, ge=1800, le=2100)
|
|
house_type: Literal["panel", "brick", "monolith", "monolith_brick", "other"] | None = None
|
|
repair_state: Literal["needs_repair", "standard", "good", "excellent"] | None = None
|
|
has_balcony: bool | None = None
|
|
# CRM-поля (#395) — операционные, на расчёт оценки не влияют
|
|
ownership_type: str | None = Field(default=None, max_length=100)
|
|
has_mortgage: bool | None = None
|
|
client_name: str | None = Field(default=None, max_length=200)
|
|
client_phone: str | None = Field(default=None, max_length=50)
|
|
|
|
|
|
class AnalogLot(BaseModel):
|
|
address: str
|
|
area_m2: float
|
|
rooms: int
|
|
floor: int | None
|
|
total_floors: int | None
|
|
price_rub: int
|
|
price_per_m2: int
|
|
listing_date: date | None
|
|
days_on_market: int | None
|
|
photo_url: str | None = None
|
|
# ── Новые поля (Слой 5.2 — clickable links) ──
|
|
source: str | None = None # 'avito' / 'cian' / 'domklik' / 'rosreestr'
|
|
source_url: str | None = None # ссылка на оригинальное объявление / сделку
|
|
distance_m: int | None = None # расстояние до целевой квартиры в метрах
|
|
|
|
|
|
class AggregatedEstimate(BaseModel):
|
|
estimate_id: UUID
|
|
median_price_rub: int
|
|
range_low_rub: int
|
|
range_high_rub: int
|
|
median_price_per_m2: int
|
|
confidence: Literal["low", "medium", "high"]
|
|
confidence_explanation: str | None = None # «Найдено 15 аналогов, разброс ±7%»
|
|
n_analogs: int
|
|
period_months: int # 24
|
|
analogs: list[AnalogLot] # top 5-10 listings
|
|
actual_deals: list[AnalogLot] # реальные продажи last 12 mo
|
|
expires_at: datetime
|
|
# ── Дополнительные метаданные ──
|
|
target_address: str | None = None # geocoded full address
|
|
target_lat: float | None = None
|
|
target_lon: float | None = None
|
|
sources_used: list[str] = Field(default_factory=list) # ['avito', 'cian', 'rosreestr']
|
|
data_freshness_minutes: int | None = None # сколько минут назад был самый свежий парсинг
|
|
est_days_on_market: int | None = None # прогноз срока продажи (медиана по аналогам)
|
|
|
|
|
|
class PhotoMeta(BaseModel):
|
|
"""Метаданные фото квартиры (#394). Содержимое отдаётся отдельным эндпоинтом."""
|
|
|
|
id: UUID
|
|
filename: str | None = None
|
|
content_type: str
|
|
size_bytes: int | None = None
|
|
uploaded_at: datetime
|