# 3D-конструктор трубопроводов PP-R онлайн — полное описание

## О проекте
Это SPA-приложение на Three.js (WebGL) для трёхмерного проектирования трубных систем из полипропилена PP-R (PPR, ППР). Работает полностью онлайн, не требует установки NanoCAD, SketchUp, AutoCAD или другого ПО.
Сейчас приложение на этапе прототипа, первой редакции, есть много идей инструментов, привязки, автоматические генерации и трассировки, подключение LLM.
Видимо первоочередное, что нужно сделать это редактор стен.
На данном этапе предоставляется бесплатно.

**URL:** https://pipes.applicode.ru/

## Ключевые возможности

### 3D-сцена
- WebGL-визуализация через Three.js с OrbitControls
- Навигационный куб (ViewCube) — клик по грани/ребру для точного поворота
- Поворот сцены левой кнопкой мыши
- Перемещение сцены правой кнопкой
- Масштаб колесом мыши

### Редактирование
- Имеется встроенный демо-проект с простой обвязкой водоснабжения в котельной
- Клик по фитингу/трубе — выделение объекта
- Drag-перемещение фитингов с привязкой по портам
- Поворот фитинга колесом мыши при зажатой левой кнопке (по оси привязки)
- Изменение длины трубы перетаскиванием за её порт
- Создание новой трубы перетаскиванием за свободный порт фитинга
- Привязка к незанятым портам (чем ближе — тем точнее)
- Система Undo/Redo: Ctrl+Z — отмена, Ctrl+Y — повтор
- Copy/Paste: Ctrl+C / Ctrl+V
- Сохранение проекта: Ctrl+S (в localStorage)

### Каталог фитингов PP-R
- Встроенный каталог типовых фитингов PP-R (PPR)
- Поиск по названию фитинга
- Фильтрация по тегам (клик по тегу — фильтр, повторный клик — исключение тега)
- Клик по детали в каталоге — добавление на сцену
- Ведётся работа по добавлению собственных 3D-моделей

### Стены
- Поддержка стен на сцене (пока без редактора стен)
- Расстояние до стен отображается при перемещении

### Спецификация
- Автоматическая генерация спецификации проекта
- Кнопка "Показать спецификацию"

## Целевая аудитория
- Инженеры-сантехники
- Проектировщики водоснабжения и отопления
- Монтажники PP-R систем
- Студенты строительных специальностей
- Мастера по ремонту

## Технический стек
- **Рендеринг:** Three.js (WebGL)
- **Архитектура:** SPA (Single Page Application)
- **Сборка:** Vite
- **Стили:** Bootstrap 5
- **Хранение:** localStorage (на стороне браузера)
- **Серверная часть:** Самописная API на PHP для сохранения проектов
- **Домены:** pipes.applicode.ru (основной), max.ru (каталог)

## План развития
Реализовано:
- [x] Привязка по портам
- [x] Выделение фитингов
- [x] Copy/Paste
- [x] Каталог фитингов
- [x] Навигационный куб
- [x] Сохранение/восстановление проекта
- [x] Фильтр тегов + исключение тега
- [x] Undo/Redo (MoveCommand, удаление, перемещение)
- [x] Изменение длины трубы через порт
- [x] Создание трубы из порта фитинга
- [x] Поворот фитинга по оси привязки
- [x] Спецификация

В планах:
- [ ] Нанесение размеров на сцену (сейчас есть возможность отобразить длины сразу всех труб, и расстояние от фитинга до стен)
- [ ] Редактор стен
- [ ] Загрузка пользовательских 3D-моделей (.glb)
- [ ] Групповое выделение и операции с группой
- [ ] Перемещение трубы с привязками
- [ ] Привязка к стене
- [ ] Привязка по осям фитингов
- [ ] Инструмент соединения фитингов трубой при соосности портов
- [ ] Пересчёт связанных фитингов (перестроение трассы) при перемещении объекта
- [ ] Фиксация фитингов при автоматическом перестроении трассы
- [ ] Пользователи и управление проектами пользователей
- [ ] Учёт деталей в наличии
- [ ] Управление материалами и цветами
- [ ] Инженерные расчёты
- [ ] ИИ-распознавание плана помещения
- [ ] ИИ-генерация проекта, трассировка трасс
- [ ] Оптимизация стоимости сметы путём подбора фитингов
- [ ] Оптимизация для работы с мобильного телефона, например для поворота фитинга можно попробовать работать двумя пальцами двух рук, наподобие управления в игре

## Конкуренты и позиционирование
В отличие от настольных САПР (NanoCAD, SketchUp, AutoCAD), эта программа:
1. Не требует установки и лицензий — работает в браузере (размер JS сборки порядка 900Кб)
2. Бесплатна
3. Специализируется именно на PP-R системах (не универсальная САПР)
4. Имеет встроенный каталог фитингов PP-R
5. Проста в освоении для монтажников