Osobný projekt · api.pnacek.sk

SensorMetrics

Platforma, ktorá prijíma merania z čidiel (teplota, vlhkosť, CO₂, výkon…) cez REST API, ukladá ich do MySQL/MariaDB a podľa zvoleného obdobia ich agreguje do grafov a dashboardov skladaných z widgetov. Keď hodnota prekročí prah alebo čidlo prestane posielať dáta, pošle upozornenie e-mailom alebo webhookom.

Rola
Autor — návrh, vývoj, prevádzka
Obdobie
2026 – dnes
Jazyky
SK
Stav
V prevádzke
Aplikácia SensorMetrics — graf priebehu teplôt z viacerých čidiel s voľbou obdobia
SensorMetrics v mobile — graf priebehu teplôt a dolná navigácia

Technológie

PHP 8.4 Symfony 7.4 Doctrine DBAL MySQL / MariaDB Twig Stimulus Symfony Messenger Chart.js GridStack Deployer

Čo aplikácia robí

Dashboardy z widgetov Graf, štatistika, tabuľka a meradlo. Widgety sa presúvajú a menia sa ich veľkosti, stránok je ľubovoľne veľa.
Minimá a maximá Extrémne hodnoty a priemer za hodinu, deň, týždeň alebo mesiac.
Správa metrík Typ, jednotka, ikonka a farba každej metriky, stav online/offline a ručné doplnenie záznamov.
Alerty a upozornenia Pravidlá pre prah alebo výpadok čidla, upozornenie e-mailom či podpísaným webhookom a denné zhrnutie stavu.
Verejný pohľad pre TV Dashboard len na čítanie na vlastnej adrese alebo subdoméne, bez prihlásenia.

Technické riešenia

Príjem dát aj zo zariadení bez HTTPS Mikrokontroléry ako NodeMCU nevedia HTTPS, preto zápis chráni API kľúč, z ktorého sa v databáze ukladá len SHA-256 hash. Voliteľne pribudne HMAC podpis s časovou pečiatkou a ochranou proti prehraniu požiadavky. Kľúč slúži len na zápis, nedá sa ním prihlásiť ani čítať, a zápisy limituje rate limiter. Chybné čítanie čidla (napr. −127 °C z DS18B20) sa nezapíše, ale nahradí sa predchádzajúcim meraním.
Graf Rozlíšenie grafu sa mení podľa zvoleného obdobia — minúty, 15-minútové, hodinové a denné priemery — takže mesačný graf zostane rýchly aj pri státisícoch meraní. Metrika bez merania dlhšie ako 15 minút sa označí ako offline.
Viac používateľov bez ORM Dáta sa čítajú a píšu ručne písaným SQL cez Doctrine DBAL, schému spravujú Doctrine Migrations a ORM sa nepoužíva. Každá metrika patrí jednému používateľovi a všetky dopyty ho filtrujú, takže cudzie dáta sa nedajú načítať ani cez ID vo widgete. Registrácia má overenie e-mailu, prihlásenie cez Google, honeypot a Cloudflare Turnstile.
Verejné dashboardy na subdoméne Stránku možno zverejniť na /v/slug alebo na vlastnej subdoméne cez wildcard DNS. Verejný pohľad beží mimo session, vracia noindex a no-store hlavičky a na takom hoste neexistuje nič iné ako samotný dashboard.
Alerty Vyhodnotenie beží ako stavový automat (ok → čaká → spustené) a mení stav podmieneným UPDATE-om, takže zápis dát a plánovač nevytvoria tú istú udalosť dvakrát. Notifikácie sa najprv zapíšu do fronty a odosiela ich worker s opakovaním a limitom na účet, takže výpadok SMTP príjem meraní nezastaví. Webhook je podpísaný HMAC a chránený proti SSRF.
Ďalší projekt Hivey AI aplikácia pre včelárov: hlasová nahrávka z prehliadky sa na pozadí prepíše mo
Plánujete podobnú aplikáciu? Porozprávajme sa →