- Python 67.7%
- HTML 23.6%
- JavaScript 5.6%
- CSS 1.8%
- Nix 0.9%
- Other 0.4%
| app | ||
| cobuild | ||
| container | ||
| .containerignore | ||
| .editorconfig | ||
| .gitignore | ||
| Containerfile | ||
| flake.lock | ||
| flake.nix | ||
| README.md | ||
Helenka
Helenka je účetní aplikace postavená pro potřeby malé neziskové organizace s vícero aktivitami (semináři).
📋 Obsah
Funkce
✅ Plně funkční
- Přehled transakcí s filtry a grafy
- Evidence transakcí, vč. nahrávání dokladů
- Sledování proplácení
- Import výpisů z Fio banky (API)
⚠️ Částečně implementováno
- Fakturace (Invoicer): Modely existují, ale chybí URL, views a šablony
- Správa seminářů (vytváření, organizátoři)
- Správa uživatelů (poskytuje Django)
📌 Plánované
- Dokončení modulu fakturace
- REST API
- Export dat (CSV, PDF)
- Pokročilé vyhledávání a filtrování
Deploy
Kontejner
Nabízíme kontejner založen na gimli/base:trixie, určený pro deploy na Gimlim.
Jde o zabalenou uwsgi aplikaci, která poslouchá na portu 3031.
Uložení dat
Data ukládá do /data:
/data/helenka.env- obsahuje environment proměnné:SECRET_KEYALLOWED_HOSTS- povolené domény (bez správné konfigurace vrátí 500)FIO_API_TOKEN- token pro komunikaci s Fio bankou
/data/helenka/db.sqlite3- databáze SQLite/data/helenka/media- nahrané soubory
Import výpisu z účtu
Ve webovém rozhraní je možné požádat o výpis z bankovního účtu u Fio banky.
Důležité: Pokud se požadují data starší než 90 dní, je nutné manuálně autorizovat API klíč v internetovém bankovnictví Fio banky.
Oprávnění
Role a oprávnění
Helenka používá následující systém oprávnění:
| Role | Popis |
|---|---|
| Nepřihlášený | Možné se pouze přihlásit |
| Přihlášený | Může prohlížet semináře, ke kterým má přístup |
| Finančník | Může upravovat transakce v seminářích, do kterých má přístup |
| Správce | Může spravovat uživatele a jejich oprávnění, importovat výpisy z banky, proplácet |
Bezpečnostní opatření
- Editace záznamů: Všechny akce spojené se správou financí vyžadují oprávnění
treasurer - Správa uživatelů: Dostupná pouze uživatelům s příznakem
is_staff
Vývoj
Požadavky
- Python 3.11+
- Django 5.2+
- Nix (pro vývojové prostředí)
Spuštění testů
cd app
python manage.py test --settings=helenka.settings.development --parallel
Větve
main- Stabilní verze (releases)dev- Vývojová větevfeature/*- Větve pro nové fičury
Fičury přidáváme přes pull requesty, ty se mergují do dev, který se následně mergne do main.
Používáme sémantické verzování (SemVer).
Verze: v1.0.0
Autor: Daniel Perout (daniel@perout.me)
Zdrojový kód: gitea.ks.matfyz.cz/wikiker/helenka/