Тази методология описва как определяме формулите, входните данни, тестовете и ограниченията на калкулаторите в Смятай. Един полезен инструмент трябва не само да покаже число, а да обясни как е получено, при какви допускания е валидно и кога резултатът трябва да бъде проверен по друг начин.
Различните калкулатори изискват различна проверка
Не всички изчисления имат еднакъв риск и еднакъв тип източник. Разделяме ги условно на четири групи.
Постоянните математически калкулатори използват формули, които не зависят от година, институция или местно правило. При тях основният акцент е върху правилната математическа логика, мерните единици, закръглянето и граничните стойности.
Калкулаторите с официални ставки или прагове зависят от конкретен период и юрисдикция. Данък, осигурителна вноска, тарифа или законна лихва трябва да бъде свързана с източник и дата.
Оценъчните калкулатори използват модел и допускания. Разход за ремонт, калориен прием, цена на услуга или пазарна оценка не е официална оферта или индивидуално заключение. При тях показваме кои стойности могат да бъдат променени и кои фактори остават извън модела.
Калкулаторите за преобразуване използват фиксирани или текущи коефициенти. Посочваме дали коефициентът е официално фиксиран, избран от потребителя или получен от външен източник.
Спецификация на формулата
Преди програмиране описваме какво пресмята калкулаторът и какво не пресмята. Спецификацията включва:
- входните полета и техните мерни единици;
- задължителните и незадължителните стойности;
- допустимите минимални и максимални граници;
- формулата и последователността на действията;
- начина на закръгляне;
- изходните резултати;
- използваните ставки, коефициенти и допускания;
- известните ограничения и изключения.
Когато съществуват няколко приети метода, не ги смесваме незабелязано. Избираме подходящия за целта на страницата, обясняваме избора и добавяме настройка, ако потребителят реално има нужда да промени допускането.
Как тестваме резултатите
Тестът не се състои само в натискане на бутона „Изчисли“. За всеки инструмент подготвяме контролни случаи според неговата логика:
- обичаен пример с лесно проверим резултат;
- нулева или минимална допустима стойност;
- голяма, но реалистична стойност;
- десетични стойности и български формат, когато са приложими;
- неправилни, празни или невъзможни входни данни;
- граница между две правила, ставки или категории;
- обратно изчисление, когато калкулаторът го поддържа.
Очакваният резултат се изчислява независимо от интерфейса. При постоянна формула това може да бъде ръчна сметка. При официална ставка сравняваме с публикуван пример или таблица, когато е налична. При оценъчен модел проверяваме дали промяната на всеки вход влияе логично върху резултата.
Техническият тест включва и проверка дали инструментът работи след зареждане на страницата, на мобилен екран и след обработката на WordPress и системата за кеширане.
Мерни единици и закръгляне
Показваме мерната единица до полето и до резултата. Не преобразуваме сантиметри, метри, килограми, литри, проценти или валути без това да е видимо за потребителя.
Закръглянето се определя според практическата употреба. Паричните стойности обикновено се показват с два знака, но междинните действия могат да използват по-висока точност. Брой материали, опаковки или цели дни може да изисква закръгляне нагоре. Проценти и научни стойности могат да имат различна точност според метода.
Когато закръглянето може да промени решение за покупка, плащане или количество, обясняваме как е приложено.
Променливи ставки и актуалност
За стойности, които се променят, записваме източника, периода и датата на проверка. Не представяме стара стойност като текуща само защото формулата продължава да работи технически.
Когато няма единна национална стойност, например при общинска ставка или пазарна цена, предпочитаме поле за въвеждане или ясно обозначена примерна стойност. Ако използваме външно API, описваме какви данни получаваме, какво се случва при липса на отговор и дали потребителят може да въведе стойността ръчно.
Как обясняваме резултата
Резултатът трябва да отговаря на реалния въпрос на страницата. Освен основното число, когато е полезно, показваме разбивка, междинни стойности, използвани допускания и кратко тълкуване.
Не използваме автоматични предупреждения, които звучат категорично без достатъчна основа. Ако моделът не може да определи дали кредит е подходящ, дали здравен показател означава диагноза или дали правен срок важи за конкретен казус, казваме това ясно.
Примерите са и част от проверката. Числата в примерното изчисление трябва да дават същия резултат като инструмента при същите входни данни.
Ограничения и чувствителни теми
При здравни, финансови, данъчни, правни, трудови и свързани с безопасността изчисления описваме границите на модела по-конкретно. Общ отказ от отговорност не е достатъчен, ако не е ясно кои фактори липсват.
Посочваме дали резултатът е математически, ориентировъчен, базиран на официална ставка или зависим от индивидуална преценка. Не представяме калкулатор като диагноза, оферта, административен акт или професионална консултация.
Версии и промени
За калкулаторите поддържаме запис кога е проверена формулата, кои източници са използвани и какво е променено. Козметична промяна не трябва автоматично да се представя като нова проверка на данните.
При промяна на формула, ставка или ключово допускане повтаряме засегнатите тестове. При редакция на стар калкулатор пазим резервно копие и проверяваме, че JavaScript кодът, полетата и резултатите не са повредени от промяната на текста.
Поверителност на въведените данни
Калкулаторите по правило извършват сметките в браузъра. Потребителят не трябва да въвежда ЕГН, пароли, банкови данни, медицински документи или друга чувствителна информация, освен ако страницата изрично не обяснява защо дадена стойност е необходима и как се обработва.
Сигнали за грешки
Ако резултатът не съвпада с очакваното, сигнал може да бъде изпратен през страницата Контакти. За възпроизвеждане на проблема са полезни адресът на калкулатора, използваните входни стойности, показаният резултат и надежден източник или ръчна сметка за сравнение.
Повече за целта на проекта можете да прочетете в страницата За нас.
Последна актуализация: 27 юли 2026 г.