Разработка калькулятора площади/объема на 1С-Битрикс

Разработка калькулятора площади/объема на 1С-Битрикс

Калькулятор площади и объёма — базовый инструмент для сайтов строительных, отделочных, клининговых компаний и производителей материалов. Задача простая на первый взгляд: пользователь вводит размеры, получает площадь или объём. На практике всё сложнее: нужны разные типы помещений, вычеты проёмов, нестандартные формы, суммирование нескольких комнат и автоматический переход к расчёту стоимости.

Геометрические формулы

Полный набор формул для строительных расчётов:

namespace MyProject\Services\Calculators;

class GeometryCalculator
{
    // Площади помещений
    public static function rectangleArea(float $width, float $length): float
    {
        return $width * $length;
    }

    public static function lShapeArea(float $w1, float $l1, float $w2, float $l2): float
    {
        // Г-образная комната: два прямоугольника
        return self::rectangleArea($w1, $l1) + self::rectangleArea($w2, $l2);
    }

    public static function circleArea(float $radius): float
    {
        return M_PI * $radius * $radius;
    }

    public static function triangleArea(float $base, float $height): float
    {
        return 0.5 * $base * $height;
    }

    // Площадь стен комнаты (с вычетом проёмов)
    public static function wallArea(
        float $perimeter,
        float $height,
        array $openings = [] // [{width, height}, ...]
    ): float {
        $totalWall   = $perimeter * $height;
        $openingsArea = array_sum(array_map(fn($o) => $o['width'] * $o['height'], $openings));
        return max(0, $totalWall - $openingsArea);
    }

    // Объёмы
    public static function boxVolume(float $width, float $length, float $height): float
    {
        return $width * $length * $height;
    }

    public static function cylinderVolume(float $radius, float $height): float
    {
        return M_PI * $radius * $radius * $height;
    }

    // Площадь кровли с учётом уклона
    public static function roofArea(float $horizontalArea, float $slopeDegrees): float
    {
        $slopeRad = deg2rad($slopeDegrees);
        return $horizontalArea / cos($slopeRad);
    }
}

Мультикомнатный калькулятор

Расчёт нескольких помещений с накоплением итога:

class RoomCalculator {
    constructor() {
        this.rooms = [];
    }

    addRoom(params) {
        const room = {
            id:      Date.now(),
            name:    params.name || `Помещение ${this.rooms.length + 1}`,
            floor:   params.width * params.length,
            ceiling: params.width * params.length,
            walls:   this.calcWalls(params),
        };
        this.rooms.push(room);
        return room;
    }

    calcWalls(params) {
        const perimeter = 2 * (params.width + params.length);
        const totalWall = perimeter * params.height;

        const openingsArea = (params.doors || []).reduce((sum, d) => sum + d.width * d.height, 0)
            + (params.windows || []).reduce((sum, w) => sum + w.width * w.height, 0);

        return totalWall - openingsArea;
    }

    getTotal() {
        return {
            totalFloor:   this.rooms.reduce((s, r) => s + r.floor, 0),
            totalCeiling: this.rooms.reduce((s, r) => s + r.ceiling, 0),
            totalWalls:   this.rooms.reduce((s, r) => s + r.walls, 0),
            rooms:        this.rooms,
        };
    }

    removeRoom(id) {
        this.rooms = this.rooms.filter(r => r.id !== id);
    }
}

Визуальный ввод параметров

Сложность — в UX. Пользователь не всегда знает точные размеры. Помогают:

Стандартные размеры. Выбор из справочника: «стандартная панельная квартира», «студия 25м²», «однушка 38м²». Автозаполнение размеров с возможностью корректировки.

SVG-схема помещения. Интерактивный чертёж, где пользователь кликает на стену и вводит размер. Реализуется через SVG + JavaScript, никаких внешних зависимостей.

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

Связь с каталогом Битрикс

После расчёта площади — автоматический переход к подбору материалов:

// AJAX-обработчик: по площади подбираем нужное количество товаров
public function suggestMaterialsAction(float $area, string $materialType): array
{
    $norm = MaterialNormRepository::getByType($materialType);

    $rawQuantity = $area * $norm['consumption_rate'] * $norm['waste_factor'];
    $packages    = ceil($rawQuantity / $norm['package_size']);

    // Проверяем наличие на складе
    $product = \CCatalogProduct::GetByID($norm['product_id']);
    $inStock  = (int)($product['QUANTITY'] ?? 0);

    return [
        'product_id'   => $norm['product_id'],
        'product_name' => $norm['product_name'],
        'packages'     => $packages,
        'in_stock'     => $inStock,
        'enough_stock' => $inStock >= $packages,
        'can_order'    => true,
    ];
}

Сохранение и печать результатов

Для сложных объектов пользователи хотят сохранить расчёт. Реализации:

Ссылка с параметрами — расчёт кодируется в URL-параметры, ссылка сохраняется или передаётся:

const paramsStr = btoa(JSON.stringify(calcParams));
const shareUrl  = `${window.location.origin}/calculator/?calc=${paramsStr}`;

PDF-выгрузка — серверная генерация через библиотеку TCPDF или mPDF, установленную через Composer в /local/:

$pdf = new \TCPDF();
$pdf->AddPage();
$pdf->writeHTML($this->renderCalcHtml($calcResult));
$pdf->Output('calc_result.pdf', 'D'); // D = force download

Email с результатом — отправка через \Bitrix\Main\Mail\Event::sendImmediate().

Сроки

Точность расчёта — главное. Ошибка на 10% в меньшую сторону означает, что клиент докупает материалы по другой (часто более высокой) цене и возвращается недовольным. Лучше добавить 5% запас явно, чем занизить и потерять доверие.