Chciałem mierzyć procentowo tkankę tłuszczową i skończyłem budując ponad sto kalkulatorów

Oryginalny plan był zawstydzająco prosty. Po trzech miesiącach konsekwentnych treningów waga na wadze nie zmieniła się znacznie, ale lustro mówiło inną historię. Ubrania pasowały inaczej. Poziomy energii były w górze. Ludzie robili komentarze. Oczywiste pytanie brzmiało, czy skład ciała się zmienił, nawet jeśli całkowita waga pozostała mniej więcej taka sama, a oczywista odpowiedź wymagała poznania procentu zawartości tkanki tłuszczowej zamiast tylko masy ciała. Szybkie wyszukiwanie hasła "body fat calculator" zwróciło kilkanaście stron pełnych reklam z małymi polami wejściowymi wciśniętymi między bannery reklamowe i podręczniki pop-up. Technicznie pracowały, ale doświadczenie było okropne. Wpisz kilka pomiarów, kliknij oblicz, czekaj aż strona przeładuje się przez trzy warstwy skryptów reklam, a na koniec zobacz liczbę bez kontekstu dotyczącego jej znaczenia lub porównania ze zdrowymi przedziałami dla kogoś w tym wieku i poziomie aktywności.

Proces myślowy, który nastąpił, był rodzajem, który deweloperzy natychmiast rozpoznają, a cywile uważają za zagadkowy. "Ten kalkulator jest okropny. Jak trudno jest zbudować lepszy?" Odpowiedź na to pytanie jest zawsze taka sama: zbudowanie pierwszej wersji jest łatwe, a potem scope creep przejmuje z cichą determinacją bluszczu wspinającego się po ścianie. Kalkulator zawartości tkanki tłuszczowej został ukończony popołudniu. Stosował metodę Marynarki Wojennej, wziął cztery pomiary (szyja, talia, biodra, wzrost) i wyświetlił wynik z kontekstem o zdowych przedziałach. Czysty interfejs, bez reklam, szybko. Gotowe. Z wyjątkiem tego, że nie było gotowe, bo następna myśl była "cóż, jeśli ktoś sprawdza zawartość tkanki tłuszczowej, prawdopodobnie chce też swojego BMI." Więc dodano kalkulator BMI. A potem kalkulator BMR, ponieważ znajomość podstawowego tempa metabolicznego jest niezbędna dla każdego zarządzającego spożyciem kalorii. A potem kalkulator dziennych potrzeb kalorycznych. A potem kalkulator makr. A potem kalkulator spożycia wody. Każdy trwał dzień lub dwa i każdy wydawał się naturalnym rozszerzeniem poprzedniego. Zakres pełzał, ale pełzał w kierunku, który miał sens.

Przesunięcie ze zdrowia na finanse nastąpiło w środową wieczór podczas przeglądu opcji kredytu hipotecznego. Strona internetowa banku oferowała kalkulator kredytu hipotecznego, który był jakby jeszcze gorszy niż kalkulatory zawartości tkanki tłuszczowej z oryginalnego wyszukiwania. Wymagał utworzenia konta przed wyświetleniem jakichkolwiek wyników. Właściwe konto, z krokiem potwierdzenia e-mailem, dla przywileju pomnożenia głównych przez stopę procentową i podzielenia przez dwanaście. Istniejąca struktura kalkulatora była już tam i już obsługiwała walidację wejściową i wyświetlanie wyników. Dodanie kalkulatora kredytu hipotecznego zajęło mniej czasu niż proces rejestracji banku by potrwał.

Nieunikniona ekspansja do wszystkiego, co obejmuje liczby

Gdy tylko bariera między zdrowiem a finansami została przerwana, bramy otworzyły się w sposób zarówno ekscytujący jak i nieco niepokojący. Następnie pojawiły się kalkulatory odsetek składanych, ponieważ osobiste planowanie finansowe zależy od zrozumienia, jak pieniądze rosną w czasie i większość istniejących narzędzi czyni koncepcję trudniejszą do zrozumienia niż powinna być. Następnie kalkulatory amortyzacji pożyczki, ponieważ każdy, kto porównuje opcje kredytu hipotecznego, musi również zobaczyć pełny harmonogram spłaty z podziałem odsetek według miesiąca. Następnie kalkulatory ROI, ponieważ decyzje inwestycyjne wymagają szybkich przybliżonych szacunków przed rozpoczęciem szczegółowej analizy. Następnie konwersja walut, następnie kalkulatory napiwku, następnie projekcje celów oszczędzania, następnie szacunki planowania emerytury. Każdy kalkulator podzielał tę samą architekturę: wziąć ustrukturyzowane wejścia, zastosować dobrze znaną formułę i przedstawić wynik z wystarczającą kontekstą, aby natychmiast się przydać.

Kategoria matematyki pojawiła się, gdy przyjaciel nauczający w szkole średniej zapytał, czy platforma mogła zawierać kalkulator procentowy dla uczniów zmagających się z koncepcją. To jedno żądanie spowodowało szereg podstawowych narzędzi matematycznych: kalkulatory procentowe (co to jest X% z Y, X to jaki procent Y, procentowy wzrost i spadek), przeliczniki ułamków na ułamki dziesiętne, kalkulatory pierwiastków kwadratowych, obszar i kalkulatory objętości dla typowych kształtów oraz przeliczniki jednostek obejmujące długość, wagę, temperaturę i prędkość. Żaden z nich nie jest technicznie złożony. Obliczenie procentowe to trywialny kod. Ale owinięcie tego trywialnego kodu w czysty interfejs z jasnymi etykietami, przydatnymi wyjaśnieniami i natychmiastowymi wynikami bez przeładowania strony tworzy narzędzie, które jest naprawdę bardziej przydatne niż robienie matematyki ręcznie lub szukanie jej na brudnej stronie.

Kalkulatory zysków kryptografii pojawiły się w okresie, gdy kilka pozycji kryptowalut wymagało oceny. Pytanie "jeśli kupiłem 0,5 ETH za $2.400, a teraz jest $3.100, jaki jest mój zysk po opłacie handlowej 0,1%?" to bezpośrednia arytmetyka, ale robienie tego wielokrotnie na wielu monetach o różnych cenach zakupu, ilościach i strukturach opłat szybko się nudzi. Kalkulator kryptowaluty obsługuje cenę zakupu, cenę sprzedaży, ilość i opłaty w jednym formularzu i wyświetla zysk bezwzględny, procent zwrotu i dochód netto po opłatach. Nie łączy się z żadną giełdą ani nie pobiera cen na żywo. Jest to czysty instrument obliczeniowy, którym musi być. Cena na żywo znajduje się na stronie giełdy. Obliczenie znajduje się na calculator.yeb.to.

Jak jeden kalkulator stał się architekturą

Historia techniczna wzrostu z jednego kalkulatora do ponad stu to historia decyzji architektonicznych podjętych wcześnie, które okazały się zaskakująco skalowalne. Pierwszy kalkulator zawartości tkanki tłuszczowej został zbudowany jako samodzielna strona z kodowanymi na stałe polami formularza HTML i funkcją JavaScript, która uruchomiła formułę metody Marynarki Wojennej. Na piątym kalkulatorze wzór był oczywisty: każdy kalkulator przyjmuje zestaw nazwanych wejść (wysokość, wagę, tempo, główną, cokolwiek), stosuje formułę i wyświetla jedno lub więcej nazwanych wyjść (procent zawartości tkanki tłuszczowej, spłatę miesięczną, skład). Struktura udostępniona oznaczała, że generyczny komponent kalkulatora mógł obsługiwać logikę renderowania, walidacji i wyświetlania, podczas gdy każdy kalkulator musiał tylko zdefiniować wejścia, formułę i etykiety wyjścia.

Ta abstrakcja to to, co sprawiło, że wybuch od dwudziestu kalkulatorów do stu wydawał się możliwy do zarządzania zamiast przytłaczającego. Dodanie nowego kalkulatora nie wymaga budowania zupełnie nowej strony od podstaw. Wymaga zdefiniowania wejść (nazwa, typ, jednostka, reguły walidacji), napisania funkcji obliczeniowej i określenia sposobu wyświetlania wyników. Framework obsługuje wszystko inne: responsywny układ, walidację wejściową, komunikaty o błędach, formatowanie wyników, a nawet tekst wyjaśniający, który pomaga użytkownikom zrozumieć znaczenie liczb. Cała platforma to zasadniczo jeden silnik ze stu plikami konfiguracyjnymi, dlatego może rosnąć w nieskończoność bez zagrożenia, że baza kodu stanie się niemożliwa do zarządzania.

Interfejs API kalkulatora również ujawnia ten aparat programowo. Aplikacje zewnętrzne mogą wysyłać wartości wejściowe i odbierać wyniki obliczane programowo bez żadnego interfejsu. Jest to przydatne dla aplikacji, które potrzebują możliwości obliczania wbudowanych w ich własne przepływy pracy. Aplikacja fitness, która chce wyświetlić BMI wraz ze statystyką treningu, może wywołać API zamiast ponownie implementować formułę BMI. Narzędzie planowania finansowego, które potrzebuje projektów odsetek składanych, może wywołać API zamiast utrzymywać własną logikę mieszania. Formuły są dobrze znane i nie są zastrzeżone, ale ich prawidłowe wdrożenie (obsługa przypadków brzegowych, prawidłowe zaokrąglanie, uwzględnianie lat przestępnych w obliczeniach na podstawie daty) jest rodzajem pracy, którą każdy deweloper robi trochę inaczej i często trochę źle.

Dlaczego ujednolicona platforma ma więcej sensu niż rozproszczone narzędzia

Alternatywą dla ujednoliconej platformy kalkulatora jest to, co większość ludzi doświadcza dzisiaj: oddzielna strona dla każdego typu obliczenia. Jeden zakładek dla kalkulatora kredytu hipotecznego. Inny dla kalkulatora BMI. Trzeci do narzędzia zysku kryptografii. Każda strona ma swój własny język projektowania, swoje własne umieszczenia reklam, swoje własne okno zgody na pliki cookie i swój własny sposób przedstawiania wyników. Kognitywne obciążenie przełączania się między tymi odłączonymi narzędziami jest rzeczywiste, chociaż na tyle małe, że pozostaje niezauważone, dopóki ktoś nie doświadczy alternatywy.

Posiadanie wszystkiego pod jednym dachem w calculator.yeb.to eliminuje to obciążenie. Interfejs jest spójny na wszystkich kalkulatorach. Dane wejściowe działają w ten sam sposób. Wyniki są formatowane w ten sam sposób. Wyjaśniający kontekst jest zgodny z tą samą strukturą. Użytkownik, który używał kalkulatora BMI, wie dokładnie, jak używać kalkulatora kredytu hipotecznego, ponieważ wzorzec interakcji jest identyczny. Ta konsystencja może wydawać się zaletą projektowania, ale ma mierzalny wpływ na użyteczność. Użytkownicy spędzają mniej czasu na ustaleniu, jak działa narzędzie, a więcej czasu na uzyskanie odpowiedzi, dla której przyszli.

Jest również korzyść odkrywania, której rozproszczone narzędzia nie mogą powielać. Ktoś, kto odwiedza platformę w celu obliczenia swojego BMR, może zauważyć kalkulator spożycia wody na tej samej stronie i zdać sobie sprawę, że nigdy nie obliczył, ile wody powinien pić. Ktoś sprawdzający spłatę kredytu hipotecznego może odkryć kalkulator odsetek składanych i rozpocząć prognozowanie emerytury. Bliskość powiązanych narzędzi tworzy naturalną ścieżkę eksploracji, którą izolowane witryny nie mogą zapewnić, ponieważ witryna zoptymalizowana dla jednego obliczenia nie ma powodu do ukazania niepowiązanych kalkulatorów. Ujednolicona platforma może i robi, a dane użytkowania pokazują, że znaczna część użytkowników wchodzi w interakcję z dwoma lub większą liczbą kalkulatorów na wizytę.

Liczby za liczbami

Budowanie ponad stu kalkulatorów przyniosło kilka naprawdę interesujących obserwacji na temat tego, co ludzie obliczają i kiedy. Kalkulatory zdrowia szczytują w styczniu, gdy tłum noworocznych postanowień zstępuje na kalkulatory BMI i kalorii z entuzjazmem nowych członków siłowni. Kalkulatory kredytu hipotecznego szczytują za każdym razem, gdy banki centralne ogłaszają zmiany stóp procentowych, czasami w ciągu godzin od ogłoszenia. Kalkulatory zysków kryptografii prawie doskonale korelują ze zmiennością ceny Bitcoina, gwałtownie rosnące podczas rynków byka i cicho podczas rynków niedźwiedzia. Kalkulatory podatków osiągają szczyt w tygodniach poprzedzających terminy złożenia wniosku. Nawet podstawowy kalkulator procentowy ma wzór sezonowy, a korzystanie ze studentów osiąga szczyt w okresach egzaminacyjnych.

Najpopularniejszy kalkulator na platformie, z dużą różnicą, nie jest jednym z wyrafinowanych narzędzi zdrowotnych lub finansowych. To prosty kalkulator procentowy. "Co to jest 15% z 230?" Ludzie szukają tego rodzaju pytania miliony razy dziennie na całym świecie, a odpowiedź to tylko arytmetyka, którą każdy wbudowany kalkulator telefonu mógł obsługiwać. Ale ludzie nie myślą w ten sposób. Myślą o tym jako o problemie procentowym i chcą narzędzie oznaczonego "kalkulator procentowy", które przyjmuje ich określone dane wejściowe i daje im odpowiedź. Lekcja jest taka, że wartość kalkulatora nie leży w złożoności formuły. Leży w jasności interfejsu i szybkości odpowiedzi.

Patrząc wstecz na podróż od pierwszego obliczenia zawartości tkanki tłuszczowej do platformy z ponad sto narzędziami, najbardziej zaskakującym wyobrażeniem jest, że żaden indywidualny kalkulator nie był trudny do zbudowania. Trudność polegała na uznaniu, że popyt był uniwersalny, a istniejąca podaż była pofragmentowana, pełna reklam i wroga doświadczeniu użytkownika. Każdy kalkulator jest trywialny w izolacji. Razem tworzą coś, co jest naprawdę przydatne dokładnie dlatego, że jest kompleksowe, spójne i szybkie. Pytanie dotyczące zawartości tkanki tłuszczowej, które dało początek całemu dzieł, jest nadal odpowiadane przez to samo narzędzie, a postępy w siłowni, które pomogły śledzić, były znacznie bardziej spójne niż oryginalny plan zbudowania "tylko jednego kalkulatora".

Często zadawane pytania

Jakie kalkulatory są dostępne na platformie?

Platforma zawiera ponad sto kalkulatorów w czterech głównych kategoriach: zdrowie (BMI, zawartość tkanki tłuszczowej, BMR, potrzeby kaloryczne, spożycie wody, kalkulator makr), finanse (hipoteka, odsetki składane, amortyzacja pożyczki, ROI, oszczędności, emerytura), matematyka (procent, ułamki, obszar, objętość, konwersja jednostek) i kryptografia (kalkulator zysku, kalkulator górniczy). Nowe kalkulatory są dodawane regularnie na podstawie żądań użytkowników.

Czy kalkulator zawartości tkanki tłuszczowej jest dokładny bez sprzętu zawodowego?

Kalkulator zawartości tkanki tłuszczowej stosuje metodę U.S. Navy, która wymaga pomiarów szyi, talii, bioder i wzrostu. Metoda ta została zwalidowana w badaniach klinicznych i typowo produkuje wyniki w granicach 3 do 4 punktów procentowych pomiarów skanowania DEXA. Chociaż nie tak dokładne jak metody laboratoryjne, zapewnia wiarygodne szacunki dla śledzenia zmian w czasie, co jest najczęstszym przypadkiem użycia dla osób monitorujących postęp fitness.

Czy można uzyskać dostęp do kalkulatorów za pośrednictwem API?

Tak. Interfejs API kalkulatora umożliwia zewnętrznym aplikacjom wysyłanie wartości wejściowych i odbieranie obliczonych wyników programowo. Jest to przydatne dla programistów budujących aplikacje fitness, narzędzia planowania finansowego lub dowolną aplikację, która potrzebuje wbudowanych możliwości obliczania bez ponownego wdrożenia podstawowych formuł.

Czy kalkulatory są bezpłatne w użyciu?

Kalkulatory oparte na sieci Web na stronie calculator.yeb.to są bezpłatne w użyciu bez rejestracji lub subskrypcji. Interfejs API kalkulatora do dostępu programowego stosuje model cen oparty na kredytach, gdzie obliczenia są pobierane na żądanie, co czyni je ekonomiczne zarówno dla lekkich jak i ciężkich wzorów użycia.

Jak kalkulator odsetek składanych obsługuje różne częstotliwości mieszania?

Kalkulator odsetek składanych obsługuje codzienne, miesięczne, kwartalne, półroczne i roczne częstotliwości mieszania. Użytkownicy określają główną, roczną stopę procentową, częstotliwość mieszania i czas trwania inwestycji. Kalkulator pokazuje ostateczną kwotę, łączne uzyskane odsetki i rozbicie rok na rok na to, jak inwestycja rośnie w czasie.

Dlaczego nie używać arkusza kalkulacyjnego do tych obliczeń?

Arkusze kalkulacyjne mogą wykonywać wszystkie te obliczenia, ale wymagają poprawnego ustawienia formuł, które samo w sobie jest źródłem błędów. Dedykowany kalkulator z wstępnie zbudowanymi, walidowanymi formułami eliminuje ryzyko błędów formuły i zapewnia informacje kontekstowe o tym, co oznaczają wyniki. W przypadku obliczeń jednorazowych otwarcie arkusza kalkulacyjnego i zbudowanie formuły zajmuje więcej czasu niż wpisanie wartości do narzędzia dla celów, które natychmiast zwracają odpowiedź.