No description
  • Python 67.7%
  • HTML 23.6%
  • JavaScript 5.6%
  • CSS 1.8%
  • Nix 0.9%
  • Other 0.4%
Find a file
2026-11-19 16:54:52 +01:00
app Fidget with templates 2026-11-19 16:54:52 +01:00
cobuild Cobuild: add basic cobuild config 2026-08-06 13:24:56 +02:00
container uwsgi: tune workers and timeouts, drop dead static-map 2026-08-06 13:24:56 +02:00
.containerignore Fix fio api token and optimize 2026-07-03 11:46:04 +02:00
.editorconfig Format 2026-05-13 16:30:32 +02:00
.gitignore Cobuild: add basic cobuild config 2026-08-06 13:24:56 +02:00
Containerfile Fix rights for the /data/helenka and run migration under www-data 2026-08-06 13:24:56 +02:00
flake.lock Make ready for production and fmt 2026-03-18 22:12:31 +01:00
flake.nix Add parallel testing 2026-11-10 15:07:34 +01:00
README.md Fix after refactor 2026-11-12 14:44:56 +01:00

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_KEY
    • ALLOWED_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ětev
  • feature/* - 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/