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
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.