Калькулятор показывает одну сумму, а менеджер получает другую — спор начинается ещё до заказа. Чтобы проверить расчёт, зафиксируйте входные данные, порядок действий, округление и версию прайса в одном техническом задании. Главный результат подготовки — таблица примеров, для которых владелец услуги и разработчик заранее согласовали одинаковый ответ.
Начните с трёх безопасных действий:
- Возьмите обезличенные примеры ручного расчёта: обычный заказ, минимальный объём и пограничное значение.
- Запишите единицы измерения, доплаты и исключения рядом с каждым примером.
- Пересчитайте примеры по одной версии прайса, не меняя действующий калькулятор и не отправляя реальные заявки.
Определите, какой результат обещает калькулятор
Укажите, что получает посетитель: точную сумму по заданным условиям, диапазон или предварительную оценку. Если цена зависит от замера, наличия материалов или индивидуального согласования, перечислите эти условия рядом с результатом. Нельзя показывать точную сумму там, где исходных данных недостаточно.
В задании отделите расчёт от дальнейших действий. Само изменение площади не должно создавать заказ. Кнопка обращения передаёт менеджеру выбранные параметры и результат; оформление и оплата требуют отдельного согласованного сценария.
Для отраслевой задачи полезен разбор калькулятора складского хранения. Здесь разберём общий способ описать вычисления так, чтобы их можно было проверить до запуска.
Опишите входы и допустимые значения
Для каждого поля нужны название, единица, обязательность, диапазон, шаг и поведение при ошибке. Одной подписи «площадь» недостаточно: квадратные метры и квадратные сантиметры дают разные исходные данные. Пустое поле, ноль и отсутствие услуги тоже могут иметь разный смысл.
Ниже — учебная модель условной услуги, не прайс OpenStart и не история клиентского проекта. Все суммы и ограничения выбраны только для примера.
| Параметр | Правило учебной модели |
|---|---|
| Площадь | От 0,1 до 100 м² включительно, шаг 0,1 м² |
| Срочность | Обычная или срочная; коэффициент 1 или 1,2 |
| Ставка за площадь | 120,55 ₽ за м² |
| Фиксированная часть | 500 ₽, добавляется один раз |
| Минимальная сумма | 1 000 ₽ после применения коэффициента |
| Результат | Рубли и копейки, два знака после запятой |
Отдельно договоритесь о вводе дробей: например, принимать точку и запятую как десятичный разделитель, затем приводить запись к одному формату. Значение 10,05 м² не соответствует шагу этой модели. Покажите ошибку с подсказкой, а не округляйте площадь незаметно.
В рабочем задании также укажите валюту, состав цены, включённые налоги и расходы, которые калькулятор не учитывает. Эти условия утверждает ответственный за прайс; разработчик не должен восстанавливать их по внешнему виду таблицы.
Зафиксируйте порядок формулы и округление
Фразу «площадь умножить на тариф и добавить срочность» можно понять по-разному. В учебной модели коэффициент срочности распространяется и на площадь, и на фиксированную часть. Минимальную сумму сравниваем с результатом после коэффициента, а округляем только итог.
Последовательность расчёта:
- Умножить площадь на 120,55 ₽.
- Добавить 500 ₽.
- Умножить сумму на коэффициент срочности.
- Если получилось меньше 1 000 ₽, взять 1 000 ₽.
- Округлить до копеек: при третьем знаке 5–9 увеличить второй знак, при 0–4 оставить его без изменения.
Например, для 10 м² без срочности получается 1 705,50 ₽. Со срочностью — 2 046,60 ₽. Для 1 м² со срочностью промежуточная сумма ниже минимума, поэтому результат — 1 000 ₽. Если сначала применить минимум, а потом коэффициент, выйдет уже 1 200 ₽: это другая формула.
Правило округления — часть задания. «Два знака на экране» не определяют, с какой точностью система считает и какую сумму сохраняет.
Обычный числовой тип JavaScript хранит дроби в двоичном представлении; некоторые десятичные значения нельзя представить точно. Это ограничение описано в документации MDN для Number. Разработчик должен выбрать подходящую денежную арифметику и проверить её на контрольных примерах. Простое хранение ставки в копейках не отменяет дробных промежуточных значений при умножении на площадь или коэффициент.
Составьте таблицу контрольных расчётов
Ожидаемый ответ считайте независимо от кода калькулятора. Если скопировать результат самой программы в колонку «должно быть», таблица повторит её ошибку. Сначала согласуйте правила и эталоны, затем сравните с ними реализацию.
Для учебной модели выше контрольные примеры выглядят так:
| Площадь, м² | Срочность | Ожидаемый результат | Что проверяем |
|---|---|---|---|
| 1 | Срочная | 1 000,00 ₽ | Минимум после коэффициента |
| 4,1 | Обычная | 1 000,00 ₽ | Значение ниже минимальной суммы |
| 4,2 | Обычная | 1 006,31 ₽ | Выход за минимальную сумму |
| 4,3 | Обычная | 1 018,37 ₽ | Округление 1 018,365 ₽ |
| 10 | Срочная | 2 046,60 ₽ | Коэффициент для всей суммы |
| 0 | Обычная | Ошибка ввода, суммы нет | Нижняя граница |
| 10,05 | Обычная | Ошибка ввода, суммы нет | Недопустимый шаг |
Добавьте точные границы 0,1 и 100 м², значения за пределами диапазона, пустое поле и неподдерживаемую опцию. Для каждого случая укажите не только сумму, но и ожидаемое сообщение. После ошибки предыдущий результат не должен выглядеть как действующий расчёт.
Если в вашей услуге есть скидки, тарифные ступени или несовместимые опции, дайте каждой развилке свой пример. Отдельно проверьте, действует новый тариф на весь объём или только на часть сверх порога. Это бизнес-правило, которое нельзя выбирать по удобству реализации.
Сохраните версию прайса и проверьте передачу результата
У прайса должны быть версия, дата и время начала действия с часовым поясом. В задании укажите, по какому событию выбирается версия: открытию формы, запуску расчёта или отправке обращения. Иначе посетитель может увидеть старую сумму, а менеджер — новую.
Один понятный вариант: при отправке сервер сверяет актуальность прайса. Если он изменился, форма показывает пересчитанную сумму и просит подтвердить условия. Уже сохранённое обращение хранит исходные параметры, принятую версию прайса, итог и время расчёта. Срок действия предложения согласуют отдельно.
Проверки нужны на сервере, даже если браузер уже ограничивает поля. OWASP в руководстве по проверке входных данных прямо указывает, что клиентскую проверку можно обойти. Итоговая цена из браузера не должна быть единственным основанием для суммы заказа: сервер проверяет параметры и выполняет согласованный расчёт.
Передачу в CRM проверяйте на тестовом контуре с отключёнными реальными уведомлениями и платежами. Сравните введённые параметры, версию прайса и сумму на экране с записью, которую получил тестовый обработчик. Если внешний источник тарифа недоступен, интерфейс должен сообщать об этом, а не подставлять ноль.
Принимайте доработку по результатам, а не по виду формы
Калькулятор готов к приёмке, когда все согласованные примеры дают ожидаемые ответы, ошибки ввода понятны, а результат связан с версией прайса. Повторите проверки на телефоне и компьютере: дробный ввод, смену опции, исправление ошибки и длинное сообщение. Кнопки и сумма должны оставаться доступными.
Попросите разработчика показать, как изменить тариф на тестовой копии и вернуться к предыдущей версии. После смены прайса повторите контрольные расчёты. Инструкция по управлению должна объяснять, кто меняет правила и как проверяет их перед включением.
Если у вас есть согласованная формула, простая форма и команда, способная проверить серверный расчёт, этой спецификации достаточно для самостоятельной постановки задачи. Специалист нужен, когда правила противоречат друг другу, калькулятор встроен в чужой код или расчёт связан с заказами и несколькими учётными системами.
OpenStart разрабатывает расчётные модули для сайтов, CRM и личных кабинетов: от проработки формулы до встраивания и проверки. Для обсуждения достаточно обезличенной таблицы входов и ожидаемых ответов, описания исключений и места калькулятора на сайте. Это позволяет определить состав доработки, не передавая пароли и клиентские документы.
