Je lokálna verzia rovnaká ako cloud na app.alven.sk?

Áno. Balík vzniká automaticky z rovnakého kódu pri každom nasadení webu, vrátane miezd, DPH a závierky. Cloud pridáva len prevádzku: zálohy, aktualizácie, TLS a podporu.

Môžem Alven používať vo firme alebo v účtovnej kancelárii zadarmo?

Áno, AGPL-3.0 komerčné použitie povoľuje. Podmienka zverejnenia zdrojového kódu sa týka len upravených verzií, ktoré prevádzkujete ako službu pre tretie strany.

Nikam. Databáza beží v Docker kontajneri na vašom počítači, aplikácia je dostupná len na localhost. Registre (RPO, VIES) sa dopytujú priamo z vášho počítača na verejné služby štátu a EÚ.

Potrebujem vedieť programovať?

Nie. Stačí Docker Desktop a jeden skript. Programátorom navyše sprístupňujeme celé monorepo (NestJS, React, PostgreSQL) s návodom na vývoj v README.md.

Ako nahlásim chybu alebo navrhnem zmenu?

Napíšte na info@alven.sk s verziou z VERSION.txt. Postup pre príspevky do kódu je v CONTRIBUTING.md, bezpečnostné hlásenia v SECURITY.md.

Stiahnuť Alven — open-source účtovníctvo a mzdy pre Mac a Windows

Čo je v balíku

Podvojné účtovníctvo: denník, hlavná kniha, predvaha, saldokonto, účtový rozvrh, predkontácie, uzávierka
DPH: priznanie (DPHv25), kontrolný výkaz, súhrnný výkaz — XML pre eDane validované proti XSD finančnej správy
Účtovná závierka: súvaha a výkaz ziskov a strát (Úč POD, Úč MÚJ) s krížovými kontrolami; daň z príjmov PO
Fakturácia a e-faktúra: UBL 2.1 / EN 16931, Peppol BIS Billing 3.0, príjem e-faktúr z XML, PDF s PAY by square
Mzdy a personalistika: zamestnanci, pracovné pomery a dohody, výpočet miezd a odvodov, uzávierka obdobia
Majetok a odpisy, pokladňa, sklad, kniha jázd a cestovné náhrady, ostatné pohľadávky a záväzky so zápočtami
Banka: import výpisov CAMT.053 a CSV, párovanie úhrad, SEPA platobné príkazy
Registre RPO a VIES, migrácia z MRP (XML), REST API s OpenAPI, multi-tenant architektúra, demo subjekty

Slovenská legislatíva v kóde

Každý výpočet v kóde odkazuje na konkrétny paragraf a každá legislatívna konštanta (sadzby, lehoty, koeficienty) má uvedený zdroj a príznak overenia — register je v balíku v docs/legal-facts.md. Kód pracuje najmä s týmito predpismi:

Zákon č. 431/2002 Z. z. o účtovníctve a opatrenia MF SR k účtovnej závierke (MF/23377/2014-74 pre podnikateľov, MF/15464/2013-74 v znení MF/18008/2014-74 pre mikro ÚJ) — účtová osnova, denník, súvaha, výkaz ziskov a strát
Zákon č. 222/2004 Z. z. o DPH — sadzby 23 / 19 / 5 %, náležitosti dokladov, priznanie DPHv25, kontrolný a súhrnný výkaz, zámok podaného obdobia (§ 78)
Zákon č. 595/2003 Z. z. o dani z príjmov — odpisové skupiny a metódy (§ 26 – § 28), technické zhodnotenie, zaokrúhľovanie (§ 47), daň z príjmov právnických osôb
Zákonník práce, zákon č. 461/2003 Z. z. o sociálnom poistení, zákon č. 580/2004 Z. z. o zdravotnom poistení a zákon č. 663/2007 Z. z. o minimálnej mzde — pracovné pomery a dohody, odvody, minimálna mzda vrátane hodinovej odmeny dohodárov
Zákon č. 283/2002 Z. z. o cestovných náhradách — stravné a základná náhrada podľa opatrení a oznámení MPSVR s platnosťou od–do
Zákon č. 394/2012 Z. z. o obmedzení platieb v hotovosti — kontrola limitov v pokladni
Zákon č. 385/2025 Z. z. — povinná elektronická fakturácia od 1. 1. 2027 (EN 16931, Peppol BIS Billing 3.0, prechodný režim § 85o)
Rozpočtové pravidlá územnej samosprávy (zákon č. 583/2004 Z. z.) a obecné zriadenie (zákon č. 369/1990 Zb.) — demo scenáre obce a neziskovej organizácie

Čo potrebujete

Docker Desktop — pre macOS (Intel aj Apple Silicon), Windows 10/11 (WSL 2) alebo Docker Engine na Linuxe
4 GB RAM pre Docker a približne 3 GB miesta na disku
Internet pri prvom spustení (sťahujú sa obrazy PostgreSQL a Node, zostavuje sa aplikácia — 3 až 8 minút)

Spustenie

macOS a Linux

Rozbaľte ZIP — vznikne priečinok alven.
Otvorte v ňom Terminál a spustite ./start.sh.
Po správe Alven beží: http://localhost:8080 sa otvorí prehliadač. Zastavenie: ./stop.sh.

Windows

Nainštalujte a spustite Docker Desktop (potvrďte WSL 2).
Rozbaľte ZIP a v priečinku alven dvakrát kliknite na start.cmd.
Po správe Alven beží: http://localhost:8080 sa otvorí prehliadač. Zastavenie: stop.cmd.

Po spustení

http://localhost:8080 — aplikácia; vlastnú účtovnú jednotku založíte registráciou
http://localhost:8080/demo — ukážkové subjekty s reálnymi scenármi (s. r. o., a. s., SZČO, obec, nezisková organizácia); pripravia sa na pozadí do 1–2 minút
http://localhost:8080/api/docs — OpenAPI dokumentácia REST API
http://localhost:8025 — Mailpit: všetky odoslané e-maily sa zachytávajú lokálne, kým nenastavíte vlastný SMTP

Aktualizácia a dáta

Balík na tejto stránke je vždy aktuálny stav kódu, ktorý beží aj v cloude. Nová verzia: spustite update.sh (macOS/Linux) alebo update.cmd (Windows) — skript stiahne aktuálny ZIP, overí kontrolný súčet SHA-256, rozbalí ho vedľa a spustí; alebo ZIP stiahnite ručne, rozbaľte do nového priečinka, skopírujte súbor .env a spustite start. Databázové migrácie sa aplikujú automaticky, dáta sú v Docker volume alven-local_pgdata. Zálohu urobíte jedným príkazom pg_dump; podrobnosti sú v INSTALL.md v balíku.

Licencia

Zdrojový kód je pod GNU AGPL-3.0: môžete ho používať, študovať, upravovať a šíriť, aj komerčne. Ak upravenú verziu prevádzkujete ako službu pre iných, musíte sprístupniť zdrojový kód svojich úprav. Označenie Alven a logo nie sú súčasťou licencie. Softvér sa poskytuje bez záruky; za správnosť účtovníctva a miezd zodpovedá účtovná jednotka — preto má každá legislatívna konštanta v kóde uvedený zdroj a príznak overenia (docs/legal-facts.md).

Časté otázky

Je lokálna verzia rovnaká ako cloud na app.alven.sk?: Áno. Balík vzniká automaticky z rovnakého kódu pri každom nasadení webu, vrátane miezd, DPH a závierky. Cloud pridáva len prevádzku: zálohy, aktualizácie, TLS a podporu.
Môžem Alven používať vo firme alebo v účtovnej kancelárii zadarmo?: Áno, AGPL-3.0 komerčné použitie povoľuje. Podmienka zverejnenia zdrojového kódu sa týka len upravených verzií, ktoré prevádzkujete ako službu pre tretie strany.
Kam idú moje dáta?: Nikam. Databáza beží v Docker kontajneri na vašom počítači, aplikácia je dostupná len na localhost. Registre (RPO, VIES) sa dopytujú priamo z vášho počítača na verejné služby štátu a EÚ.
Potrebujem vedieť programovať?: Nie. Stačí Docker Desktop a jeden skript. Programátorom navyše sprístupňujeme celé monorepo (NestJS, React, PostgreSQL) s návodom na vývoj v README.md.
Ako nahlásim chybu alebo navrhnem zmenu?: Napíšte na [email protected] s verziou z VERSION.txt. Postup pre príspevky do kódu je v CONTRIBUTING.md, bezpečnostné hlásenia v SECURITY.md.

Stiahnite si celý Alven. Účtovníctvo aj mzdy, kompletný kód.