КОНТЕКСТ

Прототип платформы поддержки инженерных решений в строительстве. По координатам участка собирает климатический паспорт площадки, подбирает материалы и считает стоимость владения зданием на весь срок службы.

Охват — климат + материалы + стоимость владения + проверка теплотехнических нормативов (этапы 1–2 дорожной карты). Геология, сейсмика, BIM-интеграция и анализ рисков не реализованы.

Запуск

python3 -m venv venv && ./venv/bin/pip install -r requirements.txt
./venv/bin/uvicorn app.main:app --port 8321

Открыть http://localhost:8321

./venv/bin/python -m pytest tests/ -q

Как это работает

1. Паспорт площадки — суточный архив Open-Meteo за год по координатам сводится в проектные показатели: градусо-сутки отопления, циклы замораживания-оттаивания, глубина промерзания, ветровая и снеговая нагрузка.
2. Подбор материалов (app/materials.py) — правила отсекают неподходящие решения: толщина утеплителя от минимальной температуры, тип фундамента от глубины промерзания, усиление фасада от скорости ветра, защита от коррозии от влажности.
3. Стоимость владения (app/lcc.py) — по каждому сценарию считается:
   • CAPEX как сумма компонентов (₽/м² × площадь);
   • отопление из теплопотерь по площадям оболочки — стены, окна, покрытие и пол суммируются раздельно как Σ(A·U), потому что остекление на порядок менее сопротивляемо, чем стена вокруг него, — плюс вентиляция с учётом рекуперации;
   • обслуживание (₽/м²·год);
   • замены компонентов по их сроку службы внутри горизонта расчёта.
4. Рекомендация — сценарий с наименьшей LCC среди тех, что проходят проверенные нормативы и укладываются в бюджет. Соответствие фильтрует раньше цены: советовать более дешёвый вариант, нарушающий теплозащиту, значит перечеркнуть смысл инструмента. Не захардкожен — на разных горизонтах и площадках выигрывают разные сценарии.
5. Проверка нормативов (app/compliance.py) — чек-лист соответствий по каждому сценарию.

Границы проверки нормативов

Проверка реализована только там, где требование — документированная функция от данных, которые система действительно вычисляет:

• Теплозащита по СП 50.13330: нормируемое сопротивление R = a·ГСОП + b для стен, окон, покрытия и перекрытия по грунту. ГСОП считается по определению свода правил — за отопительный период (сутки со средней температурой ≤ +8 °C) относительно расчётной внутренней +20 °C, а не как градусо-сутки по базе 18 °C.
• Фундамент относительно глубины промерзания (СП 22.13330).

Пожарная безопасность, эвакуация, инсоляция и доступность для МГН не проверяются: для них нужны планировки, генплан и отчёт изысканий. Такие пункты получают статус not_evaluated и никогда не выдаются за выполненные. Сводный вердикт при наличии непроверенных пунктов — partial, а не pass.

Числовые коэффициенты и приведённые сопротивления остекления перенесены в код как типовые значения и подлежат сверке с действующей редакцией нормативов и декларациями производителей.

API

Метод	Путь	Назначение
POST	/api/projects	создать проект
GET	/api/projects	список проектов
GET	/api/projects/{id}/passport	климатический паспорт площадки
POST	/api/projects/{id}/scenarios	три сценария с LCC и накопительной кривой
GET	/api/projects/{id}/report	пояснительная записка (паспорт + сценарии)

Климат кешируется в SQLite после первого запроса по проекту.

Ограничения модели

• Климат — архив за 2023 год, не многолетние нормы Росгидромета.
• Снеговая нагрузка оценивается по осадкам в дни с отрицательной температурой, это не расчётное значение по СП 20.13330.
• Удельные стоимости — модельные, не привязаны к региональной сметной базе.
• Инструмент поддержки принятия решений, не замена проекту лицензированного инженера.