"
)
+def _page_footer(
+ brand, # type: ignore[no-untyped-def]
+ report_num: str,
+ report_date: dt.date,
+ page_note: str | None = None,
+ *,
+ valid_until: dt.date | None = None,
+) -> str:
+ """Единый footer — порт 3-частной композиции Footer.tsx (/trade-in/v2), но
+ развёрнутый в 2 явных строки, а не 3 flex-item'а с fallback-переносом в одну
+ (см. ниже #overflow-hardening про причину):
+
+ строка 1 — mono meta (№ отчёта / дата / срок действия); тонкая градиентная
+ линия-разделитель; строка 2 — точка акцента + wordmark (brand.name — НЕ
+ хардкод «МЕРА», white-label остаётся рабочим) + версия движка отчёта.
+
+ page_note — старый текст footer'а (бренд/подзаголовок/№ страницы/дисклеймер
+ на офер-странице), которого нет в веб-референсе (там нет пагинации). Не
+ удалён — вынесен приглушённой строкой НАД HUD-баром, чтобы не терять
+ полезную для печатного многостраничного отчёта информацию.
+ """
+ note_html = ""
+ if page_note:
+ note_html = (
+ f'
{page_note}
'
+ )
+ valid_until_html = ""
+ if valid_until is not None:
+ valid_until_html = (
+ f'ДЕЙСТВИТЕЛЕН ДО '
+ f'{valid_until.strftime("%d.%m.%Y")}'
+ )
+ mono_family = "'IBM Plex Mono','DejaVu Sans Mono',monospace"
+ # #overflow-hardening: изначально meta / декоративная линия-коннектор / wordmark
+ # были 3 flex-child'а ОДНОЙ строки с `flex-wrap:wrap` как fallback на случай
+ # нехватки места. На практике meta (особенно со СРОК ДЕЙСТВИЯ на Cover) почти
+ # всегда заполняет строку целиком, так что wordmark systematically уезжал на
+ # свою отдельную строку — но даже НА ОТДЕЛЬНОЙ, целиком его строке, WeasyPrint
+ # заметно занижал доступную ширину wordmark-item (воспроизводится детерминированно
+ # и не зависело от max-width/margin декоративной линии или flex-shrink на самом
+ # wordmark — похоже на ограничение реализации multi-line flex-wrap в WeasyPrint,
+ # а не на конкуренцию за ширину), из-за чего даже короткий generic бренд
+ # «Trade-In» рвался ПОСРЕДИ слова («TRADE-» / «IN») на КАЖДОЙ странице с footer'ом.
+ # Фикс — не патчить flex-veights, а убрать саму двусмысленность: 2 явные
+ # block-строки (meta / wordmark) вместо одной строки с fallback-переносом.
+ # Декоративный коннектор (2 точки+градиент с каждой стороны) как самостоятельный
+ # flex-item убран — он дублировал функцию border-top (уже отделяет footer от
+ # тела страницы) и был источником сложности; заменён на простую тонкую
+ # градиентную линию-разделитель между строками meta/wordmark.
+ return f"""
+
+ {note_html}
+
+
+ ОТЧЁТ {_html.escape(report_num)}
+ ДАТА
+ {report_date.strftime("%d.%m.%Y")}
+ {valid_until_html}
+
+"""
+
+
# ── Price range chart — matplotlib SVG bullet/range chart (real chart, не div) ──
# Раньше рендерилась одним div с фиксированной 64%-заливкой/14%-отступом — числа
# НЕ определяли позицию заливки (чисто декоративный "прогресс-бар", не привязанный
@@ -421,7 +616,7 @@ def _price_range_chart_svg(
(lo_m - pad, track_bottom),
(hi_m - lo_m) + 2 * pad,
track_h,
- facecolor=_BORDER,
+ facecolor=_TRACK,
edgecolor="none",
zorder=1,
)
@@ -457,7 +652,7 @@ def _price_range_chart_svg(
xycoords="data",
xytext=(0, -4),
textcoords="offset points",
- color=_FG,
+ color=_INK,
fontsize=10.5,
ha=ha,
va="top",
@@ -536,13 +731,20 @@ def _price_figure_cell(
Каждое под-поле (диапазон / ₽/м²) рендерится только при валидном значении —
как web (guard на typeof number). delta_pct — опциональный chip «−N%».
- Все числовые значения — DejaVu Sans Mono (tabular-nums), как на web (.mono)."""
+ Все числовые значения — DejaVu Sans Mono (tabular-nums), как на web (.mono).
+
+ HUD-карточка (card-glass + bracket-tr, corner-bracket accent из tokens.ts) —
+ вложенный
внутри
(НЕ position:relative на самом
— надёжность
+ absolute-позиционированного ::before внутри table cell в разных движках
+ рендеринга непредсказуема). padding-right на label-строке — clearance от
+ delta_chip (короткий bounded chip, но всё равно на одной строке с label)."""
delta_chip = ""
if delta_pct is not None:
delta_chip = (
f"{_mono(f'−{delta_pct}%')}"
+ f"border-radius:8pt;vertical-align:middle;white-space:nowrap;'>"
+ f"{_mono(f'−{delta_pct}%')}"
)
range_html = ""
if range_low is not None and range_high is not None and range_high > range_low:
@@ -550,24 +752,25 @@ def _price_figure_cell(
f"{_html.escape(_fmt_rub_m(range_low))} – {_html.escape(_fmt_rub_m(range_high))}"
)
range_html = (
- f"
"
- f"{_mono(range_text)}
"
+ f"
{_mono(range_text)}
"
)
perm2_html = ""
if per_m2 is not None and per_m2 > 0:
perm2_html = (
- f"
"
)
@@ -623,6 +826,169 @@ def _dual_price_block(estimate: AggregatedEstimate, brand) -> str: # type: igno
)
+# ── Shared HUD chrome for page bodies (Mera v2 — section-badge/status-pill/
+# card-glass+bracket) — used by all 4 page-builders below. ──────────────────
+
+
+def _section_heading(number: str, text: str, *, tag: str = "h2", extra_right: str = "") -> str:
+ """Заголовок страницы (h1 Cover / h2 Listings-Deals-Offer) с моно-нумерацией
+ секции — HUD-идиома ObjectSummary.tsx («03 СВОДКА ОБЪЕКТА»), теперь общая для
+ всех 4 страниц отчёта (раньше — только у cover не было border-bottom, у
+ остальных был раздельный inline-стиль на каждой странице).
+
+ extra_right — опциональный элемент справа (напр. status-pill); свой flex-item
+ с flex-shrink:0, заголовок — flex:1 1 auto с min-width:0, чтобы длинный текст
+ (в этом модуле текст заголовков статический, но структура остаётся safe by
+ construction для любого будущего динамического текста) переносился, а не
+ наезжал на правый элемент."""
+ size = _FS_XL if tag == "h1" else _FS_LG
+ right_html = f'{extra_right}' if extra_right else ""
+ return (
+ '
"
+ )
+
+
+def _freshness_status_pill(freshness_minutes: int | None) -> str:
+ """Status-pill (.status-pill — ObjectSummary.tsx «АКТУАЛЬНО» идиома) — честная
+ метка свежести данных из estimate.data_freshness_minutes (реальное поле, НЕ
+ fabricated метрика). Пусто, если поле не заполнено (graceful — старые записи
+ без этого поля/пустой рехайдрат) — по аналогии с остальными optional-полями
+ оценки в этом модуле (см. _dual_price_block)."""
+ if freshness_minutes is None:
+ return ""
+ hours = freshness_minutes / 60
+ if hours <= 24:
+ label, color, border = "АКТУАЛЬНО", _SUCCESS, _SUCCESS_BORDER
+ elif hours <= 24 * 7:
+ label, color, border = "ОБНОВЛЕНО НА ЭТОЙ НЕДЕЛЕ", _WARN, "#e3d4b3"
+ else:
+ label, color, border = "ТРЕБУЕТ ОБНОВЛЕНИЯ", _DANGER, "#e8c9c9"
+ # Три фиксированных RU-строки из закрытого набора (не free-form данные) —
+ # nowrap оправдан тем же порядком, что и у web-референса (ObjectSummary.tsx
+ # ставит whiteSpace:"nowrap" на идентичный pill).
+ return (
+ f"{label}"
+ )
+
+
+# Слоты источников для «Качество данных» — портировано 1:1 из mappers.ts
+# SOURCE_SLOTS/TOTAL_SOURCES (см. buildSources/activeSourceCount): 5 живых
+# источников; N1/Restate намеренно исключены там же (#2081/#2204 — мёртвые).
+_QUALITY_SOURCE_SLOTS: tuple[tuple[str, ...], ...] = (
+ ("cian",),
+ ("yandex",),
+ ("rosreestr",),
+ ("avito", "avito_imv"),
+ ("domklik", "domclick"),
+)
+_TOTAL_SOURCES = len(_QUALITY_SOURCE_SLOTS)
+
+# Web-референс (ObjectSummary.tsx, статичная demo-fixture): confidence="средняя"
+# → strokeDasharray=126/strokeDashoffset=72 → дуга заполнена ~43%. low/high —
+# пропорциональная экстраполяция. Это категориальное визуальное кодирование ТОГО
+# ЖЕ поля confidence, что уже показано текстом рядом (см. _conf_label) — НЕ
+# отдельная выдуманная точная метрика (в AggregatedEstimate нет отдельного
+# числового quality-score).
+_QUALITY_TIER_PCT: dict[str, float] = {"high": 0.78, "medium": 0.43, "low": 0.22}
+
+
+def _coeff_var_pct(values: list[float]) -> int | None:
+ """Коэффициент вариации (%, округлён до целого) — портировано 1:1 из
+ mappers.ts coeffVar/cvStr (population stddev / mean × 100). None при <2
+ валидных (>0) значениях — как на web рендерится «—»."""
+ clean = [v for v in values if v and v > 0]
+ if len(clean) < 2:
+ return None
+ mean = sum(clean) / len(clean)
+ if mean == 0:
+ return None
+ variance = sum((v - mean) ** 2 for v in clean) / len(clean)
+ return round((variance**0.5) / mean * 100)
+
+
+def _active_source_count(estimate: AggregatedEstimate) -> int:
+ """Портировано 1:1 из mappers.ts activeSourceCount/buildSources — слот
+ активен, если он в sources_used ИЛИ реально дал лоты (analogs+actual_deals)."""
+ counts: dict[str, int] = {}
+ for lot in (*estimate.analogs, *estimate.actual_deals):
+ s = (lot.source or "").lower()
+ if s:
+ counts[s] = counts.get(s, 0) + 1
+ used = {s.lower() for s in (estimate.sources_used or [])}
+ active = 0
+ for slot in _QUALITY_SOURCE_SLOTS:
+ count = sum(counts.get(k, 0) for k in slot)
+ if count > 0 or any(k in used for k in slot):
+ active += 1
+ return active
+
+
+def _data_quality_gauge_svg(confidence: str, *, size: int = 46) -> str:
+ """Кольцевой SVG-индикатор — техника ObjectSummary.tsx (2 концентрических
+ , stroke-dasharray/stroke-dashoffset), инлайн в HTML (WeasyPrint
+ поддерживает inline