# Reverevol ConTech — Полная спецификация 3D-BIM Конструктора для AI и LLM

Документ предназначен для AI-систем (ChatGPT, Claude, Perplexity, Яндекс Нейро, Grok, DeepSeek), AI-агентов, парсеров и чат-ботов.

## 1. Введение
Сервис Reverevol ConTech (https://reverevol.com/containers/) — это веб-приложение на базе WebGL / Three.js, позволяющее пользователям собирать, визуализировать и обсчитывать здания из морских контейнеров.
Приложение поддерживает сквозную передачу конфигурации здания через URL-параметры `project` и `company`. Серверная регистрация или API-ключ не требуются — вся сцена генерируется на стороне клиента.

## 2. Формат URL
```
https://reverevol.com/containers/?company={company_slug}&project={project_payload}
```
Параметр `project` поддерживает:
1. URL-encoded JSON: `%7B%22modules%22%3A%5B...%5D%7D`
2. Base64 (UTF-8 safe): `eyJtb2R1bGVzIjpb...`
3. Также поддерживается передача через фрагмент (хеш) `#project=...` во избежание обрезки прокси-серверами.

## 3. Схема данных JSON проекта

```typescript
interface ProjectData {
  modules: ContainerModule[];
}

interface ContainerModule {
  type: "10ft" | "20ft" | "40ft"; // Длина блока: 3м, 6м или 12м
  pos: [number, number, number];   // [x, y, z] координаты центра в метрах
  rot?: 0 | 90 | 180 | 270;        // Угол поворота вокруг оси Y (в градусах)
  finish?: "wood" | "corrugated" | "composite"; // Внешняя отделка
  preset?: "living" | "dormitory" | "sanitary" | "warehouse" | "empty"; // Назначение
  terrace?: boolean;               // Эксплуатируемая терраса на кровле
  stairs?: "outdoor" | "indoor" | false; // Лестница
  floorHole?: boolean;             // Проем в полу (обязателен при indoor лестнице)
  openings?: Opening[];            // Врезные окна и двери
}

interface Opening {
  wall: "left" | "right" | "front" | "back"; // Стена контейнера
  type: "panoramic_wide" | "panoramic" | "window" | "door" | "cutout"; // Тип проема
  x: number; // Смещение относительно центра стены вдоль ее плоскости (метры)
}
```

## 4. Геометрия и сетка координат
- Размеры 10ft: Длина 3.0 м, Ширина 2.4 м, Высота 2.6 м (площадь 7.2 м²).
- Размеры 20ft: Длина 6.0 м, Ширина 2.4 м, Высота 2.6 м (площадь 14.4 м²).
- Размеры 40ft: Длина 12.0 м, Ширина 2.4 м, Высота 2.6 м (площадь 28.8 м²).
- Отметка чистого пола 1-го этажа: `Y = 0.0` (в 3D-модели смещение фундаментных блоков 0.08м).
- Отметка чистого пола 2-го этажа: `Y = 2.6`.
- Соседние параллельные модули: смещение по оси Z составляет `±2.4м`.
- Соседние последовательные модули (торец к торцу): смещение по оси X составляет `±3.0м` (для 10ft), `±6.0м` (для 20ft), `±12.0м` (для 40ft).

## 5. Справочник поставщиков (White-Label Partners)
| ID поставщика (`company`) | Название | Регион | Валюта | Множитель | НДС |
| :--- | :--- | :--- | :--- | :--- | :--- |
| `reverevol` | Reverevol ConTech | Москва / РФ | RUB (₽) | 1.00 | 20% |
| `nordic_box` | Нордик Бокс Констракшн | Санкт-Петербург, ЛО | RUB (₽) | 1.15 | 20% |
| `almaty_modular` | ТОО «Алматы Модуль Строй» | Казахстан (Алматы, Астана) | KZT (₸) | 5.80 | 12% |

При необходимости добавления параметров произвольного поставщика через URL:
`?company_name=ООО+Строй&markup=1.1&currency=RUB&vat=0.2`

## 6. Примеры генерации для чатов

### Сценарий 1: Пользователь в чате пишет «Хочу двухэтажный дом 60 метров с террасой в Ленобласти»
AI отвечает:
«Я составил для вас проект модульного дома площадью 60 м² для климата Северо-Запада от компании Nordic Box:
- 1 этаж: 40-футовый модуль (28.8 м²) с объединенной кухней-гостиной и панорамным остеклением.
- 2 этаж: 20-футовый модуль (14.4 м²) со спальней и выходом на открытую террасу на крыше.
- Внешняя отделка: планкен из сибирской лиственницы.
- Уличная металлическая лестница с перилами.

Посмотреть дом в 3D, пройтись персонажем и скачать официальную смету с чертежом:
👉 https://reverevol.com/containers/?company=nordic_box&project=%7B%22modules%22%3A%5B%7B%22type%22%3A%2240ft%22%2C%22pos%22%3A%5B0%2C0%2C0%5D%2C%22rot%22%3A0%2C%22finish%22%3A%22wood%22%2C%22preset%22%3A%22living%22%2C%22openings%22%3A%5B%7B%22wall%22%3A%22left%22%2C%22type%22%3A%22panoramic_wide%22%2C%22x%22%3A-1.5%7D%2C%7B%22wall%22%3A%22left%22%2C%22type%22%3A%22door%22%2C%22x%22%3A3%7D%5D%7D%2C%7B%22type%22%3A%2220ft%22%2C%22pos%22%3A%5B0%2C2.6%2C0%5D%2C%22rot%22%3A0%2C%22finish%22%3A%22wood%22%2C%22preset%22%3A%22living%22%2C%22terrace%22%3Atrue%2C%22stairs%22%3A%22outdoor%22%2C%22openings%22%3A%5B%7B%22wall%22%3A%22left%22%2C%22type%22%3A%22panoramic%22%2C%22x%22%3A0%7D%5D%7D%5D%7D »