BudgetMaster

Aplikácia na peniaze do mobilu: rýchle pridanie, rozpočty od výplaty, prehľady a priestory zdieľané s partnerom.

Beží na mojom domácom serveri, takže môže byť občas nedostupné (napríklad pri výpadku elektriny alebo internetu).

Úvodná stránka BudgetMaster so zvyškom mesačného rozpočtu a tempom míňania

O projekte

Aplikácia na osobné financie, ktorú som začal v roku 2024 na Next.js a MongoDB. Neskôr som ju od základu prerobil na TanStack Start a PostgreSQL a teraz beží ako živé demo na mojom domácom serveri.

Odpovedá na tri otázky: kam išli moje peniaze, koľko ešte môžem minúť tento mesiac a čo ma čaká. Pár si môže viesť spoločný priestor domácnosti, pričom osobné peniaze zostanú osobné. Demo dá každému návštevníkovi súkromnú kópiu 14 mesiacov vzorových dát.

Čo si môžete vyskúšať

Rýchle pridanie za pár sekúnd alebo napísaný riadok ako „káva 3,20 hotovosť včera“; známi príjemcovia doplnia kategóriu
Rozpočty podľa kategórií s mesiacom, ktorý môže začínať výplatou, prenosom zvyšku a grafom tempa míňania
Pravidelné platby, ciele sporenia, rozdelené bločky a 90-dňová predpoveď zostatku
Zdieľané priestory s rolami, kto čo platil a vyrovnanie, zmeny sa hneď zobrazia aj na iných zariadeniach
Import bankového výpisu z CSV s kontrolou, rozpoznaním duplicít a možnosťou vrátiť späť
Prehľady: peňažný tok, čistý majetok, kalendár výdavkov, mesačný prehľad a zhrnutie roka
Peňaženky vo vlastných menách; súčty, rozpočty a prehľady ich prepočítajú kurzami ECB
Voliteľná pomoc od Clauda, vypnutá, kým ju nezapnete: prečíta fotku bločku alebo bankový výpis v PDF, navrhne kategóriu, odpovie na otázky o financiách alebo zhrnie mesiac
Pripomienky platieb cez push notifikácie a voliteľné týždenné zhrnutie e-mailom
Záznam o tom, kto čo zmenil, s obnovením zmazaných transakcií a vrátením zmien
Export všetkých dát do JSON alebo CSV, prípadne zmazanie účtu
Angličtina, maďarčina a slovenčina, inštalovateľná do mobilu, svetlý a tmavý režim

Ako to funguje

Serverové funkcie s validáciou cez Zod a kontrolou členstva pri každej požiadavke; sumy uložené ako celé čísla v najmenších jednotkách
Better Auth s prístupovými kľúčmi, dvojstupňovým prihlásením a prihlásením cez sociálne siete; prísna Content Security Policy a ochrana proti CSRF
Obmedzený počet pokusov o prihlásenie s limitmi uloženými v databáze; pozvánky posielajú len overené účty, najviac 10 za hodinu
Zmeny sa dostanú na ostatné zariadenia a k ostatným členom cez Server-Sent Events; moduly len pre server držia databázový ovládač mimo balíka pre prehliadač
Playwright testy s kontrolou prístupnosti cez axe na desktope aj mobile; Docker image zostavený v GitHub Actions a nasadený s nočnými zálohami databázy

Zoznam zmien

Prerobené od základu: Next.js a MongoDB nahradil TanStack Start a PostgreSQL s Drizzle
Vlastné JWT prihlasovanie nahradil Better Auth, Redux nahradili TanStack Query a Zustand
daisyUI nahradil Tailwind CSS 4 a shadcn/ui s novým dizajnom

Kedy: 2024 – 2026
Typ: Osobný
Verzie: TanStack Start 1.169
React 19.2
PostgreSQL 18
Tailwind CSS 4
TypeScript 6
Technológie: TanStack Start
React
TypeScript
PostgreSQL
Drizzle ORM
Better Auth
TanStack Query
Zustand
Tailwind CSS
shadcn/ui
Recharts
Paraglide
Playwright
Docker

Galéria

Rýchle pridanie s napísaným riadkom, ktorý doplnil sumu a príjemcu — Rýchle pridanie: napíšte „káva 3,20 hotovosť včera“ a formulár sa vyplní sám; známi príjemcovia doplnia kategóriu.

Zoznam pohybov zoskupený podľa dní s vyhľadávaním a filtrami — Pohyby: všetky transakcie zoskupené podľa dní, s vyhľadávaním a filtrami, ktoré zostanú v odkaze.

Stránka rozpočtov s grafom tempa míňania a rozpočtami kategórií — Rozpočty: tempo míňania oproti minulému mesiacu a limit pre každú kategóriu s upozornením skôr, než sa minie.

Prehľady s príjmami a výdavkami po mesiacoch — Prehľady: rok príjmov a výdavkov, tok peňazí, čistý majetok, trendy a kalendár výdavkov.

Pravidelné platby s rozvrhom a ročnou cenou — Pravidelné platby sa zapíšu samy v deň splatnosti; predplatné ukazujú, koľko stoja za rok.

Domovská stránka v maďarčine s mesačným rozpočtom a tempom míňania — Celá aplikácia funguje aj po maďarsky a slovensky, s miestnymi formátmi čísel a dátumov.