Light1YT
d4068a255b
Hand-rolled детерминированный DCF (без numpy-financial/новых deps): _npv / _irr_monthly (bisection с bracket-guard) / _payback_months над помесячным cashflow, построенным из статического каскада (PR-1) + калиброванной цены (PR-2) по дефолтным нормативам фаз (ПИР 6мес → СМР по development_type 24/36/48 → распродажа, дисконт 15%). - Налоги прорейтятся на признание выручки → Σ недисконтированного cashflow == net_profit (ИНВАРИАНТ, тест — гарантия что DCF не разошёлся со статикой). - IRR настоящий когда есть смена знака; вырожденный поток → fallback на roi-proxy (irr_is_proxy=True). Честно помечено. - График продаж привязан к завершению стройки: sales_end = max(sales_start + длительность, construction_end) — продажи не заканчиваются раньше ввода (РФ ДДУ/эскроу). Без этого high_rise распродавался за 12 мес ДО ввода → двойная смена знака → profitable-проект молча падал в proxy + инверсия NPV. - FinancialModel +npv_rub/payback_months/discount_rate_used/schedule_is_default (additive). development_type проброшен через placement. - UI/PDF: NPV/IRR/PBP + честный caveat «график — типовое допущение, точность зависит от него». api-types регенерён авторитетно. mypy strict clean (generative.*), +15 тестов (DCF helpers на учебных значениях, ИНВАРИАНТ, IRR real-vs-proxy обе ветки, PBP, sales≥construction для всех типов, profitable high_rise → настоящий IRR). 48 passed. Refs #1881
112 lines
5.6 KiB
Python
112 lines
5.6 KiB
Python
from typing import Any, Literal
|
||
|
||
from pydantic import BaseModel, Field
|
||
|
||
|
||
class ConceptInput(BaseModel):
|
||
"""Stage 1a — input contract. Frozen interface for frontend codegen."""
|
||
|
||
parcel_geojson: dict[str, Any] = Field(
|
||
..., description="GeoJSON Polygon of the parcel (WGS84 / EPSG:4326)"
|
||
)
|
||
housing_class: Literal["econom", "comfort", "business"] = "comfort"
|
||
target_floors: int = Field(9, ge=1, le=30)
|
||
development_type: Literal["spot", "mid_rise", "high_rise"] = "mid_rise"
|
||
land_cost_rub: float | None = Field(
|
||
None, ge=0, description="Optional land cost for financial model"
|
||
)
|
||
|
||
|
||
class TEAP(BaseModel):
|
||
"""Технико-экономические показатели."""
|
||
|
||
built_area_sqm: float
|
||
total_floor_area_sqm: float
|
||
residential_area_sqm: float
|
||
apartments_count: int
|
||
density: float
|
||
parking_spaces: int
|
||
|
||
|
||
class FinancialModel(BaseModel):
|
||
"""Static developer P&L + monthly-DCF investment metrics (PR-1/PR-3, эпик #1881).
|
||
|
||
Full static cost cascade + VAT + profit tax → net profit + ROI (PR-1). On top
|
||
of that static P&L, PR-3 lays the cascade onto a **monthly cashflow schedule**
|
||
(default phase norms — ПИР → СМР → продажи) and runs a real DCF: NPV, IRR
|
||
(bisection over the monthly cashflow) and *undiscounted* cumulative payback.
|
||
See ``compute_financial`` docstring for the schedule assumptions and the
|
||
налоги/рассрочка phasing choices.
|
||
|
||
``irr`` is a **real** annualised DCF IRR when ``irr_is_proxy is False``; for a
|
||
degenerate cashflow with no sign change (e.g. always-loss) the bisection cannot
|
||
bracket a root, so we fall back to the PR-1 annualised-ROI proxy and flag
|
||
``irr_is_proxy=True``. VAT is a documented simplification (see docstring), not
|
||
exact НК РФ mechanics.
|
||
|
||
The legacy summary fields (``revenue_rub`` / ``cost_rub`` /
|
||
``gross_margin_rub`` / ``irr``) are kept for backward-compat; the new fields
|
||
expose the full cascade, the net P&L and the DCF metrics.
|
||
"""
|
||
|
||
# ── Legacy summary (backward-compat) ───────────────────────────────────────
|
||
revenue_rub: float
|
||
cost_rub: float
|
||
gross_margin_rub: float
|
||
irr: float
|
||
|
||
# ── Revenue breakdown ──────────────────────────────────────────────────────
|
||
revenue_residential_rub: float
|
||
revenue_parking_rub: float
|
||
|
||
# ── Cost cascade ───────────────────────────────────────────────────────────
|
||
construction_rub: float
|
||
pir_rub: float
|
||
networks_rub: float
|
||
developer_services_rub: float
|
||
contingency_rub: float
|
||
marketing_rub: float
|
||
land_rub: float
|
||
|
||
# ── БДР / taxes → net profit ───────────────────────────────────────────────
|
||
vat_rub: float
|
||
profit_before_tax_rub: float
|
||
profit_tax_rub: float
|
||
net_profit_rub: float
|
||
|
||
# ── Metrics ────────────────────────────────────────────────────────────────
|
||
roi: float # net profit / total cost
|
||
margin_pct: float # net profit / revenue
|
||
irr_is_proxy: bool = True # frontend caveat: True → IRR is the ROI-proxy, not DCF
|
||
|
||
# ── DCF / investment metrics (PR-3, эпик #1881) ────────────────────────────
|
||
# NPV дисконтированного помесячного cashflow по ставке ``discount_rate_used``.
|
||
npv_rub: float = 0.0
|
||
# Окупаемость (мес) по НЕдисконтированному накопительному cashflow, линейная
|
||
# интерполяция дробного месяца. ``None`` — проект не окупается на горизонте.
|
||
payback_months: float | None = None
|
||
# Годовая ставка дисконтирования, фактически применённая в NPV (норматив).
|
||
discount_rate_used: float = 0.0
|
||
# График фаз/продаж — типовые нормативные ДОПУЩЕНИЯ (не график конкретного
|
||
# проекта). True → UI/PDF показывают caveat «график — типовое допущение».
|
||
schedule_is_default: bool = True
|
||
|
||
# ── Price calibration (PR-2, эпик #1881) ───────────────────────────────────
|
||
# Цена продажи жилья, руб/кв.м, фактически использованная в выручке. Либо
|
||
# калиброванная по рынку (Objective / district reference), либо норматив класса.
|
||
# ``price_source`` honest-flag для UI/PDF: не выдавать норматив за рынок.
|
||
price_per_sqm_used: float
|
||
price_is_calibrated: bool = False
|
||
# Значения: "objective_district_median" | "district_reference" | "class_norm".
|
||
price_source: str = "class_norm"
|
||
|
||
|
||
class ConceptVariant(BaseModel):
|
||
strategy: Literal["max_area", "max_insolation", "balanced"]
|
||
buildings_geojson: dict[str, Any]
|
||
teap: TEAP
|
||
financial: FinancialModel
|
||
|
||
|
||
class ConceptOutput(BaseModel):
|
||
variants: list[ConceptVariant]
|