vytvoření návodu pro ledrich

Ledrich je aplikace na evidenci společných výdajů a dělení nákladů
(github.com/david-spacil/ledrich), nasazená na stavba.spacilovi.eu.

Návod je psaný pro účastníky knihy, ne pro správce — přihlášení, tři
záložky, zadání výdaje včetně tažení dělicího pruhu, vyrovnání dluhu,
statistiky, export CSV a správa účastníků včetně archivace.

Zatím bez screenshotů: raději žádné obrázky než odkazy na soubory, které
v navody/figs/ nejsou a rozbily by build.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01RRPMNPUDmbBhoBMfjMGe1b

_quarto.yml

@@ -8,6 +8,8 @@ website:
   #     - href: index.qmd
   #       text: Home
   #     - about.qmd
+  repo-url: https://gitea.spacilovi.eu/david-spacil/help
+  repo-actions: [issue]
   sidebar: 
     style: "docked"
     search: true
@@ -17,12 +19,16 @@ website:
       - section: "Návody"
         contents:
           - navody/immich.qmd
+          - navody/ledrich.qmd
 
 format:
   html:
     theme:
       - cosmo
       - brand
+    link-external-icon: true
+    link-external-newwindow: true
+    link-external-filter: ^(?:http:|https:)\/\/pages\.spacilovi\.eu\/david-spacil\/help
     css: styles.css
     toc: true
 

navody/immich.qmd

@@ -1,5 +1,104 @@
 ---
 title: "Návod na používání Immich"
+author: "David Spáčil"
+date: "2026-07-10"
 ---
 
-About this site
+Immich je open-source aplikace na zálohování a správu fotek a videí, kterou si provozujeme na vlastním serveru místo placených služeb jako Google Photos nebo iCloud.
+Funguje podobně – fotky z telefonu se automaticky zálohují na server, dají se procházet podle data, míst nebo lidí na fotkách, a přístup k nim máte z mobilu i z webového prohlížeče.
+Výhodou je, že si o svá data staráme sami a nejsme závislí na cizí firmě ani na jejích cenách či omezeních.
+
+
+## Registrace / přihlášení 
+
+Z důvodu zabezpečení není možná registrace bez předchozího založení účtu administrátorem.
+Ze stejného důvodu je umožněno následné **přihlašování pouze pomocí Google účtu**.
+Administrátor v případě požadavku založí účet s uživatelským e-mailem spárovaným s Google účtem, poté je možné se do systému přihlásit (viz obrazovku níže). 
+
+Adresa Immich instance: [https://immich.spacilovi.eu/](https://immich.spacilovi.eu/).
+
+![Přihlašovací obrazovka Immich](figs/immich-login.png)
+
+Po prvním přihlášení se objeví prázdná úvodní obrazovka, kterou je ideálně potřeba zaplnit.
+
+![Úvodní obrazovka Immich](figs/immich-main-page.png)
+
+
+## Orientace v prostředí
+
+![](figs/immich-main-tools.png){.img-float-left}
+
+- `Fotky`, stejně jako třeba ve Fotkách Google, představují hlavní prvek Immich – časovou osu se všemi nahranými fotkami (tedy kromě těch, které jsou archivované nebo v koši).
+- `Prozkoumat`: po přidání prvních několika fotek se v této záložce objeví identifikovaní lidé, místa a nedávno přidané fotky.
+- `Mapa`: modul zobrazuje fotografie s prostorovými informacemi na mapě (týká se většiny fotek z mobilu).
+- `Lidé`: představuje seznam všech na fotkách identifikovaných osob (záložku je potřeba povolit v nastavení).
+- `Sdílení`: v modulu se ukazuje „partnerské sdílení“ a sdílená alba.
+- `Oblíbené`: podobně jako `Fotky` ukazuje časovou osu fotek, ovšem pouze těch, které byly označeny srdíčkem.
+- `Alba`: zobrazuje vytvořená alba s fotkami seřazená podle data.
+- `Nástroje`: především nabízí možnosti údržby knihovny a hromadné správy fotek (např. kontrolu duplicit a kontrolu velkých souborů).
+- `Archiv`: do archivu se ukládají fotografie, u kterých je z nějakého důvodu nežádoucí jejich zobrazování na hlavní časové ose.
+- `Uzamčená složka`: slouží jako trezor chráněný PIN kódem.
+- `Koš`: sem putují smazané fotografie. 
+Po 30 dnech dojde k jejich trvalému odstranění.
+
+### Přidávání fotek
+
+Přidání svých fotek do Immich je snadné.
+Stačí pouze přetáhnout fotky, složky s fotkami nebo kombinaci obojího z okna průzkumníku souborů do okna Immich.
+Tímto se fotky automaticky nahrají do časové osy a seřadí se podle data pořízení.
+
+#### Přidávání fotek do alb
+
+Pro workflow typu *mám fotky lokálně roztříděné do složek podle data/události* se ale více hodí přímý upload do předpřipravených alb.
+
+1. V záložce `Alba` klepneme na možnost `Vytvořit album`.
+1. Klepnutím na `Přidat název` vytvoříme pro album vhodný název, např. *Dovolená x*.
+1. Přetáhneme fotografie z průzkumníku souborů do okna Immich (do prostoru alba).
+
+![Nahrávání fotek do alba](figs/immich-upload.webp)
+
+
+## Sdílení fotek
+
+Fotky lze v Immich sdílet více způsoby.
+Je možné sdílet jednotlivé fotografie, skupiny fotografií nebo celá alba. 
+Fotky lze sdílet jak s ostatními uživateli Immich, tak i externě pomocí odkazu.
+
+### Sdílení pomocí odkazu
+
+Sdílení pomocí odkazu je nejjednodušší a nejverzatilnější způsob sdílení.
+Umožňuje fotky za odkazem chránit heslem nebo třeba nastavit dobu platnosti odkazu.
+
+Postup:
+
+1. Vybereme jednu či více fotek, případně album.
+1. Klikneme na tlačítko `Sdílet`.
+    a) V případě přímého výběru fotek se zobrazí přímo dialog sdílení přes odkaz.
+    Stačí nechat výchozí hodnoty a stisknout `Vytvořit odkaz`.
+    a) V případě sdílení alba je potřeba ještě navíc v sekci `Sdílené odkazy` klepnout na shodně pojmenovaný link `Vytvořit odkaz`.
+    Pak je postup shodný jako v případě sdílení samostatných fotek.
+
+![Sdílení fotek přes odkaz](figs/immich-share-link.webp)
+
+### Sdílení uživatelům
+
+Sdílení uživatelům je dostupné pouze pro alba, ne pro samostatné fotografie.
+Tento způsob sdílení je preferovaný v případě, že sdílíme album osobám, které mají v Immich rovněž založený účet.
+Album sdílené s ostatními uživateli jim totiž zůstane připnuto v jejich záložce `Alba`.
+U uživatele, kterému má být album sdíleno, je možné vybrat jeho roli (`Editor` má možnost měnit úvodní obrázek alba a přidávat další fotografie, `Divák` může album pouze procházet).
+Pozvaným uživatelům přijde upozornění o sdílení jak v aplikaci Immich, tak na uvedený e-mail.
+
+Postup:
+
+1. U alba, které chceme sdílet, klepneme na tři tečky (*Zobrazit možnosti alba*).
+1. Vybereme možnost `Sdílet`.
+1. V sekci `Lidé` klepneme na tlačítko `+ Pozvat lidi`.
+1. Vybereme klepnutím všechny uživatele, kterým chceme album sdílet, a klepneme na `Přidat`.
+1. Následně lze u uživatelů v roletce měnit roli.
+
+![Sdílení fotek ostatním uživatelům](figs/immich-share-user.webp)
+
+
+## Odkazy
+
+- Kompletní nápověda (primárně pro administrátory): [docs.immich.app](docs.immich.app)

navody/ledrich.qmd

@@ -0,0 +1,161 @@
+---
+title: "Návod na používání Ledriche"
+author: "David Spáčil"
+date: "2026-08-11"
+---
+
+Ledrich je aplikace na evidenci společných výdajů a dělení nákladů – tedy na situace, kdy se skládá víc lidí a nikomu se nechce vést papírové poznámky o tom, kdo co zaplatil a komu kolik dluží.
+Funguje podobně jako známé appky typu Splitwise nebo Tricount, ale běží na našem vlastním serveru, takže data o tom, za co utrácíme, nikam ven neodcházejí.
+Používá se hlavně z mobilu – aplikace je udělaná tak, aby se výdaj dal zadat jednou rukou cestou z obchodu.
+
+Vede se v ní **kniha**: seznam účastníků, kteří se o výdaje dělí, a všechny jejich platby.
+
+## Přihlášení
+
+Registrace není možná, účty zakládá správce knihy.
+Když se má někdo přidat, správce ho přidá v `Nastavení` a předá mu heslo.
+
+Na přihlašovací obrazovce se vybere jméno ze seznamu a zadá heslo.
+Po přihlášení zůstáváte přihlášení dlouhodobě, takže se na mobilu heslo zadává jen výjimečně.
+
+::: {.callout-tip}
+Aplikaci si na mobilu můžete přidat na plochu (v prohlížeči *Přidat na plochu* / *Add to Home Screen*).
+Pak se otevírá jako běžná appka, na celou obrazovku a bez adresního řádku.
+:::
+
+Pokud po zadání hesla obrazovka „probliknutím“ spadne zpátky na přihlášení, aplikace vám sama napíše proč – nejčastěji je to tím, že se k ní jde přes nezabezpečené spojení.
+
+## Orientace v prostředí
+
+Dole jsou tři záložky a nad nimi oranžové kolečko s plusem.
+
+- `Platby` – seznam všech výdajů, od nejnovějšího. Klepnutím na výdaj se otevře k úpravě.
+- `Dluh` – kdo komu kolik dluží a tlačítko na vyrovnání.
+- `Statistiky` – souhrnná čísla, graf v čase a rozpady.
+- **Oranžové tlačítko `+`** – přidání výdaje. Je záměrně mimo záložky a nad nimi, protože je to jediná činnost, kvůli které se aplikace otevírá venku, a musí být na dosah palce.
+
+Oranžová barva patří v celé aplikaci jen tomuhle tlačítku, takže je vždycky jasné, kam sáhnout.
+
+Nahoře je název knihy a vedle něj `Nastavení` a `Odhlásit`.
+
+::: {.callout-note}
+Když v hlavičce občas problikne informace o čekajících změnách, znamená to, že byl výpadek spojení se serverem.
+**Nic se neztratilo** – zadané výdaje jsou uložené a odešlou se samy, jakmile se spojení vrátí.
+:::
+
+## Přidání výdaje
+
+Klepnutím na oranžové `+` se otevře formulář. Vyplňuje se:
+
+- **Částka** – hlavní pole, samo se zaostří. Zadává se v korunách, haléře se dají zapsat za desetinnou čárkou.
+- **Za co** – krátký popis, např. *nákup Lidl*.
+- **Kdo platil** – ten, kdo peníze skutečně vytáhl z kapsy. Není to totéž jako to, koho výdaj stál (viz dělení níž).
+- **Datum** – předvyplněné na dnešek.
+- **Jak se to dělí** – viz další sekce.
+- **Štítky** – nepovinné, slouží k roztřídění výdajů. Nabízejí se dřív použité, nový se prostě napíše.
+- **Poznámka** – nepovinná, na cokoli, co se nevejde do popisu.
+
+Uloží se tlačítkem `Přidat výdaj`.
+
+### Jak se výdaj dělí
+
+Tohle je jádro celé aplikace. Pod formulářem je **dělicí pruh** – vodorovný proužek, ve kterém má každý účastník svůj úsek.
+Poměr se mění **tažením předělu mezi úseky**; pod pruhem je hned vidět, kolik z částky komu připadá.
+
+Vedle jsou **předvolby** (`50 : 50`, `60 : 40`, `100 : 0` a podobně), což jsou jen zkratky k témuž – klepnutím se předěl přesune tam, kam patří.
+
+Nejčastější případy:
+
+- **Rovným dílem** – výchozí stav, nic se nenastavuje.
+- **Někdo platí všechno** – předvolba `100 : 0`. Hodí se, když jeden nakoupí něco, co je jen jeho, ale platí to ze společných.
+- **Nerovný poměr** – tažením předělu nebo předvolbou.
+- **Přesné částky** – když se jeden nákup rozpadá na položky, které patří různým lidem.
+
+::: {.callout-note}
+Procenta se zadávají v celých číslech.
+Když je potřeba jemnější poměr, použije se dělení v **podílech** – např. `335 : 665` znamená totéž jako 33,5 % ku 66,5 %.
+:::
+
+Aplikace hlídá, aby součet **vždycky seděl do haléře**.
+Když se 100 Kč dělí na tři, vyjde 34 + 33 + 33 – nikdy ne tři třiatřicítky, u kterých by koruna zmizela.
+
+### Zopakování výdaje
+
+U už uloženého výdaje je tlačítko na **zopakování**.
+Otevře nový formulář předvyplněný stejnými údaji, takže opakovaný nákup je otázka dvou klepnutí.
+
+### Oprava a smazání
+
+Klepnutím na výdaj v `Platbách` se otevře k úpravě, kde jde i smazat.
+Smazání není nevratné – záznam zůstává v historii a správce ho dokáže obnovit.
+
+## Dluh a vyrovnání
+
+Záložka `Dluh` říká jedinou věc: **kdo komu kolik dluží**, po započtení všech výdajů a všech dosavadních vyrovnání.
+
+Když si dluh mezi sebou skutečně srovnáte (převodem, hotově), zapíše se to tlačítkem `Vyrovnat`.
+Předvyplní se celá dlužná částka, ale dá se přepsat – **částečné vyrovnání je v pořádku**, zbytek dluhu zůstane viset dál.
+
+Vyrovnání je samostatný záznam, ne výdaj: nezapočítá se do statistik útraty, jen posune dluh.
+Dá se později upravit nebo smazat stejně jako výdaj.
+
+## Statistiky
+
+Záložka `Statistiky` je jenom na čtení – nic se v ní nezadává.
+
+Nahoře jsou souhrnná čísla za celou knihu.
+Pod nimi **měsíční graf**: sloupce ukazují, kolik se který měsíc utratilo, rozdělené barvami podle toho, **koho ten měsíc co stálo** (tedy podle konečného podílu, ne podle toho, kdo platil).
+Přes sloupce vede **kumulativní čára** – celková útrata od začátku. Má vlastní měřítko, proto je vysvětlená v legendě pod grafem.
+
+Níž jsou rozpady: kdo kolik zaplatil, kolik se utratilo za jednotlivé štítky a co bylo nejdražší.
+
+::: {.callout-tip}
+Barva patří vždy konkrétnímu člověku, ne pořadí v žebříčku.
+Ve všech grafech tedy tentýž odstín znamená tutéž osobu.
+:::
+
+Úplně dole je tlačítko **`Stáhnout CSV`**, které vyexportuje všechny výdaje do tabulky – k otevření v Excelu nebo v tabulkovém procesoru.
+
+## Nastavení
+
+Otevírá se odkazem `Nastavení` v hlavičce. Každý tu najde:
+
+- **Změnu vlastního hesla.** Vyžaduje zadání toho stávajícího.
+
+Správce knihy navíc:
+
+- **Název knihy.** Objeví se v hlavičce, na přihlašovací obrazovce i v názvu aplikace na ploše.
+- **Správu účastníků.** Přidání nového, přejmenování, nastavení hesla, udělení a odebrání práv správce.
+
+### Přidání účastníka
+
+`Nastavení` → `Přidat účastníka`. Zadá se jméno a heslo, které novému účastníkovi předáte jinou cestou (ne v aplikaci).
+Restart ani nic dalšího potřeba není, přihlásit se může hned.
+
+### Odebrání účastníka: archivace
+
+Účastníka, který už má v knize nějaké záznamy, **nejde smazat** – smazáním by přestalo dávat smysl vyčíslení dluhu u starých výdajů.
+Místo toho se **archivuje**:
+
+- nepřihlásí se,
+- nenabízí se u nových výdajů,
+- ale v historii i ve vyčíslení dluhu zůstává přesně tak, jak byl.
+
+Účastník, který ještě nemá žádný záznam, se smazat dá.
+
+::: {.callout-important}
+Kniha musí mít vždycky **aspoň jednoho správce**.
+Poslední správce si proto nemůže odebrat práva ani se archivovat.
+:::
+
+## Co s daty
+
+Data nejsou v žádné databázi, ale v obyčejných souborech verzovaných gitem.
+V praxi to pro vás znamená tři věci:
+
+- **Nic se neztrácí.** Každá změna je zapsaná i s tím, kdo ji udělal a kdy. Smazaný výdaj jde dohledat a vrátit.
+- **Zálohou je kopie repozitáře.** Když by server odešel, kniha se obnoví.
+- **Aplikace není podmínkou.** I kdyby Ledrich zítra přestal existovat, data zůstávají čitelná běžnými nástroji.
+
+Jediné, co se takhle nezálohuje, jsou **hesla** – ta jsou schválně uložená jinde.
+Po obnově ze zálohy se prostě nastaví znovu.

styles.css

@@ -1 +1,10 @@
 /* css styles */
+
+p, li {
+    text-align: justify;
+}
+
+.img-float-left {
+    float: left;
+    margin: 10px 10px 10px 0;
+}