Skip to content

Self-hosted house planner: true-scale 2D floor plan, 3D, satellite map overlay, sewer, electrical, water and underfloor heating with calculations, priced bill of materials. React + PHP, no database. By the team behind homedesignsai.pro

16.6 KB
Raw Blame

House Planner

Планировщик частного дома на своём хостинге: 2D-план в реальном масштабе, 3D, план на спутниковой карте, инженерные сети и смета с ценами — всё хранится на вашем PHP-хостинге.

От команды homedesignsai.pro — ИИ, который помогает с дизайном дома.

License: MIT Build Node 22 React 19 TypeScript PHP 8.x Self-hosted PRs welcome Live demo

English | Русский

House Planner: демо-дом в 3D, вид «Материалы»

2D-редактор плана
2D-редактор плана
3D с низкими стенами
3D с низкими стенами
Просмотр с телефона
Просмотр с телефона
План на спутниковой карте
План на спутниковой карте
Смета на листе A4
Смета на листе A4
Электрика: группы и трассы
Электрика: группы и трассы
Петли тёплого пола
Петли тёплого пола
Версии и снимки
Версии и снимки

Живое демо: общая копия без входа, сбрасывается каждый час, см. демо-режим. Интерфейс на английском и русском.

Возможности

2D-редактор плана

  • Черчение в миллиметрах в реальном масштабе: стены с толщиной и материалом, двери, окна, гаражные ворота, мебель из каталога с реальными размерами, зоны участка (отсыпка, газон, мощение).
  • Привязка к концам стен и сетке 100 мм, размерные линии, линейка (M, цепочкой), отмена и повтор.
  • Поворот вида шагом 15° и «Север вверх», выделение здания (B), чтобы сдвинуть или повернуть дом целиком, подписи комнат с площадью в чистоте по стенам.
  • Сводка площадей: общая и жилая, комнаты, спальни, санузлы, пятно застройки, процент застройки участка.

3D

  • Два вида: «Макет» (чистые объёмы) и «Материалы» (текстуры по материалу стен и отделке фасада).
  • Цвет стен и акцента из палитры RAL, низкие стены (1 м и уровень пола), чтобы смотреть планировку сверху, камеры 3/4, сверху, спереди.

Участок и карта

  • План поверх спутникового снимка по геопривязке (широта и долгота начала координат плана и поворот).
  • Граница участка из GeoJSON (например, кадастровый участок), смежные участки из data/parcel.geojson, ручное выравнивание снимка.
  • Необязательные неизменяемые данные участка на сервере: юридическую границу нельзя сдвинуть из редактора.

Инженерные сети (каждая — слой со своим редактором, расчётом и группой в смете)

  • Канализация с септиком: трасса от приборов, стояки, ревизии, выпуски; уклоны, отметки лотка, фитинги, проверки расстояний.
  • Электрика: розетки, выключатели, светильники, щит и группы; автотрасса по стенам, длины кабеля, автоматы и УЗО, проверки нагрузки и падения напряжения, правила для мокрых зон (ПУЭ, ГОСТ Р 50571).
  • Водопровод лучевой: скважина или колодец, насос, фильтр, бойлер, коллекторы холодной и горячей воды, отдельная линия к каждому прибору, теплоизоляция и греющий кабель снаружи.
  • Водяной тёплый пол: автораскладка петель по комнатам, краевые зоны, разрезка петель длиннее 80 м, теплоотдача против теплопотерь, расходы и балансировка, место коллектора.

Смета

  • Количества считаются по плану и сетям, цены — из JSON-каталога, лист A4 для печати.
  • Галочки «Куплено» с фактической ценой и датой, выгрузка CSV для Excel, корзина в Петровиче одной кнопкой.

Хранение и доступ

  • План хранится на сервере в JSON; каждое сохранение — пронумерованная версия, плюс именованные снимки с восстановлением.
  • Оптимистичная блокировка (If-Match / 409): несколько вкладок и скрипты правят без потерь.
  • Вход по одному паролю, файлы данных закрыты кукой, на телефоне — режим просмотра.

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

Docker

git clone https://github.com/egmalt/house-planner.git
cd house-planner
docker compose up -d --build

Откройте http://localhost:8080/ и задайте пароль в мастере /api/setup.php. Без мастера — передать пароль при первом старте: HOUSE_PASSWORD='длинный-пароль' docker compose up -d --build. Порт задаёт HOUSE_PORT (по умолчанию 8080). План, все версии и конфигурация лежат в томе house-data и переживают пересборку и перезапуск. HOUSE_PASSWORD применяется только к пустому хранилищу; чтобы потом сменить пароль, удалите config.php из тома (docker compose exec house-planner rm /var/lib/house-planner/config.php) и запустите снова с новым HOUSE_PASSWORD или через мастер. Резервные копии и HTTPS за обратным прокси — в руководстве по установке.

Режим разработки

Нужны Node.js 22 и PHP 8.1+. Два терминала:

npm i
npm run dev:api     # терминал 1: PHP API на 127.0.0.1:8000 прямо из public/
npm run dev         # терминал 2: Vite на http://localhost:5173 с горячей перезагрузкой

Откройте http://localhost:5173/api/setup.php, задайте пароль и работайте на http://localhost:5173/. Vite проксирует /api, /data и /plans на PHP-сервер, сборка не нужна. Хранилище — $HOUSE_STORAGE, если задан, иначе ./storage в корне репозитория (в .gitignore). scripts/dev-router.php повторяет правила .htaccess для встроенного сервера PHP; он только для своей машины.

Подробнее — в руководстве по установке.

Свой хостинг

Подойдёт любой виртуальный хостинг с PHP 8.1+ (с расширением curl для корзины Петровича) и Apache или LiteSpeed с mod_rewrite. Ни базы данных, ни Node.js на сервере не нужно.

  1. Сборка локально: npm ci && npm run build. Получается статическая папка dist/ с PHP API в dist/api/.
  2. Заливка содержимого dist/ в корень сайта: scripts/deploy.sh (rsync по SSH или зеркало по FTP, настройки в .env.deploy, пример — .env.deploy.example) или любой FTP-клиент.
  3. Мастер установки: один раз откройте https://ваш-сайт/api/setup.php. Он выбирает место хранилища, спрашивает пароль (от 8 символов), пишет storage/config.php с хешем пароля и случайным токеном куки и закрывает этой кукой data/ и plans/. Дальше мастер отвечает 403. Переменная окружения HOUSE_SETUP_KEY заставит мастер спросить дополнительный ключ.
  4. Хранилище ищется по порядку: $HOUSE_STORAGE, <корень сайта>/../storage (вне корня сайта, предпочтительно), <корень сайта>/storage (внутри, закрыто .htaccess). В нём config.php, current.json, все версии в versions/ и снимки в snapshots/.
  5. HTTPS: включите на хостинге (Let's Encrypt обычно одной кнопкой). Кука входа — HttpOnly, SameSite=Lax, на HTTPS автоматически получает Secure.

На nginx без Apache .htaccess не работает: закройте /storage, /data и /plans в конфигурации сервера. Пошагово, с обновлением и резервными копиями — в руководстве по заливке.

Формат плана

План — один JSON-документ в целых миллиметрах: site (размер, граница, геопривязка, зоны), materials, walls (осевая линия a → b, толщина, высота, материал), openings (двери, окна, ворота со смещением вдоль стены), furniture, rooms, estimate и networks (sewer, electric, water, heating). Источник истины — zod-схема в src/model/schema.ts; npm run plan:validate проверяет ею демо-план.

Полное описание: docs/plan-format.md. HTTP API: docs/api.md.

Работа с ИИ-ассистентом

План — обычный JSON со строгой схемой, поэтому его может править любой LLM-ассистент: «добавь стену 5 м из угла дома на восток», «окно 1200 по центру стены w2», «проведи раковину в санузле к стояку». Цикл:

scripts/plan-pull.sh                    # сервер → plans/server.json
# правка plans/server.json руками или ассистентом
node scripts/plan-validate.mts plans/server.json
scripts/plan-push.sh                    # → новая версия на сервере

plan-push.sh ходит в тот же API с версиями, что и браузер: если план за это время изменился, он сохраняет серверную копию в *.conflict.json и выходит с кодом 2, ничего не перезаписывая. Открытые вкладки подхватывают новую версию сами. Руководство с промптом и подводными камнями — правка плана через JSON.

Стек

React 19, TypeScript, Vite, Zustand + zundo (отмена), zod, Konva / react-konva (2D), three.js с React Three Fiber, drei и postprocessing (3D), three-bvh-csg (проёмы), clipper2 (смещение полигонов), MapLibre GL и proj4 (карта), PHP без фреймворка для API с хранением в файлах и flock.

Планы

  • Кровля: формы, уклоны, стропильная система и кровельные материалы в 3D и в смете.
  • Фундамент: плита, лента, сваи — объёмы и арматура.
  • Водопровод с расчётом напора и подбором насоса.
  • Экспорт в PDF и DXF.
  • Больше языков интерфейса: сейчас английский и русский, переводы приветствуются.

Оговорки

  • Цены в public/data/catalog.json — пример, собранный по магазинам Санкт-Петербурга на дату из поля checkedAt каждой позиции. Это не оферта, цены устаревают — заменяйте своими.
  • Нормы (СП, ПУЭ, СанПиН, ГОСТ) используются как справочные проверки. Расчёты не заменяют проект, сделанный специалистом.
  • Демо-план — вымышленный одноэтажный дом в северном стиле с гаражом на участке 30 × 45 м в Эстонии.

Частые вопросы

Хостинг, пароль, резервные копии, обновление, свой участок, каталог, телефон, работа без интернета — в FAQ. Повседневная работа в редакторе — в руководстве пользователя.

Участие

Задачи и пул-реквесты приветствуются. Сначала прочитайте CONTRIBUTING.md; участвуя, вы соглашаетесь с кодексом поведения. Об уязвимостях — SECURITY.md. Изменения — CHANGELOG.md.

Авторы

House Planner делает и поддерживает команда homedesignsai.pro. Связь: [email protected].

Лицензия

MIT. У сторонних текстур и моделей мебели свои лицензии — см. public/textures/LICENSE.txt и public/models/furniture/LICENSES.md.