🏠 Repair Estimator

Нарисуйте комнату — получите смету ремонта с вилкой цен.

Веб-калькулятор стоимости ремонта: по форме и размерам помещения считает площади, материалы по нормам расхода, работы специалистов и итоговую вилку минимум / средняя / максимум — с детальной ведомостью закупки и планом работ.

Что это

Слева — 2D-редактор: тяните углы плана, кликайте по стене, чтобы добавить точку, по размеру — чтобы задать длину. Справа — живая смета: площади, вилка стоимости, ведомость материалов и план работ. Всё считается на backend по прозрачным нормам расхода.

Возможности

• ✏️ 2D-редактор помещения — многоугольник любой формы, несколько комнат, высота потолка, форма потолка (плоский / многоуровневый / мансардный скат), двери и окна.
• 📐 Точная геометрия — площадь пола и потолка, периметр, площадь стен за вычетом проёмов; расчёт в Decimal, площадь по формуле шнурования.
• 🧱 Материалы по нормам — расход, округление вверх до фасовки, запас 8–12 %.
• 👷 Работы специалистов — стоимость по операциям с делением на черновые, предчистовые и чистовые этапы.
• 🎚️ Объём ремонта — только чистовая / черновая + чистовая / только черновая.
• 💰 Вилка цены — минимум / средняя / максимум отдельно по материалам и работам, а для ключевых позиций — варианты «Эконом / Стандарт / Премиум».
• 🔍 Прозрачные цены — у каждой строки источник (ссылка на карточку товара или прайс компании), регион и дата обновления; выбор магазина (Мегастрой / Леман).
• 🕳️ Скрытые работы — отдельная вилка возможных доплат за то, что вскрывается только на объекте (демонтаж, выравнивание, стяжка, штробление).
• 💾 Проекты — сохранение сметы и ссылка «поделиться».
• 📄 Экспорт — PDF, Excel, печать сметы (кириллица, раскрытый состав).
• 🖼️ Загрузка чертежа (beta) — система пытается извлечь размеры, пользователь подтверждает и правит вручную. Основной сценарий MVP — ручной 2D-ввод.

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

1. Задаёте помещение как 2D-многоугольник (через редактор или таблицу точек).
2. Указываете высоту и форму потолка, двери и окна.
3. Выбираете объём ремонта (только чистовая / черновая + чистовая / только черновая), город и магазин, а также набор работ и отделку по каждой поверхности (пол, стены, потолок, электрика, сантехника).

→ Система считает площади, материалы и работы и собирает детальную смету с вилкой стоимости и ссылками на реальные источники цен.

Стек

Слой	Технологии
Frontend	React + TypeScript + Vite, Zustand, SVG/Konva
Backend	Python 3.12, FastAPI, SQLAlchemy, Alembic, pytest
БД	PostgreSQL
Инфраструктура	Docker Compose, GitHub Actions

Быстрый старт

git clone https://github.com/Ka1Zed/repair-estimator.git
cd repair-estimator
cp .env.example .env
docker compose up -d        # поднять PostgreSQL

Дальше backend и frontend в отдельных терминалах:

# backend
cd backend && python -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt
alembic upgrade head && python -m app.db.seed
uvicorn app.main:app --reload          # http://localhost:8000

# frontend
cd frontend && npm install
npm run dev                            # http://localhost:5173

Подробности (Apple Silicon, poppler, переменные окружения, тесты, миграции) — в docs/development.md. Деплой на сервер одной командой — в docs/deployment.md; там же — как доставить пере-калиброванные seed-цены на прод (python -m app.db.seed --refresh-seed-prices).

Документация

• Локальная разработка — запуск, окружение, тесты, миграции
• Развёртывание — деплой на сервер через Docker Compose, резервные копии БД и восстановление
• Как мы работаем с репозиторием — ветки, PR, коммиты, роли
• API-контракт — формат запросов и ответов frontend ↔ backend
• Архитектура
• Правила расчёта сметы — нормы расхода и формулы
• Источники и обновление цен

Ограничения MVP

В первую версию сознательно не входят: BIM/CAD, идеальное автораспознавание чертежей, 3D-визуализация, авторизация с ролями, оплата, маркетплейс специалистов, мобильное приложение. Загрузка чертежа — экспериментальная beta-функция с обязательным ручным подтверждением размеров.

Команда

Учебный проект. Авторы и зоны ответственности — в AUTHORS и docs/contributing.md.

Лицензия

© 2026 авторы Repair Estimator (см. AUTHORS).

Проект распространяется под GNU AGPL-3.0. Коротко это значит: изучать, использовать и дорабатывать код можно свободно, но любой, кто запускает производную версию как сетевой сервис, обязан открыть её исходный код на тех же условиях. Это сохраняет проект открытым и не даёт «закрыть» его в проприетарном продукте.

Двойное лицензирование. Авторское право принадлежит авторам проекта, поэтому по запросу мы можем предоставить отдельную (в т.ч. коммерческую или MIT-) лицензию без обязательств AGPL — например, для использования в закрытом продукте. По таким вопросам — к авторам (контакты в AUTHORS).