Evidence digitální modelové železnice

Aplikace Vláčky

Webová aplikace, která drží pohromadě všechno o kolejišti: lokomotivy, jejich dekodéry a nastavení CV, výhybky, návěstidla a další příslušenství. Běží doma na vlastním NAS a otevřete ji v počítači, tabletu i telefonu.

K čemu aplikace slouží

Pro modeláře, kterým se nastavení dekodérů rozlezlo po sešitech, tabulkách a hlavě.

Aplikace nahrazuje poznámky ke každé lokomotivě a každému modulu. Víte, jakou má lokomotiva adresu, jaký dekodér, jak jste ho nastavili a co jste na něm kdy opravovali. Hodnoty CV můžete číst přímo z centrály a před uložením si prohlédnout rozdíly. Stejná evidence platí i pro příslušenství pod kolejištěm: moduly, jejich výstupy a čísla výhybek. Na dotazy a vyplnění údajů pomáhá volitelný AI asistent, který nic nezapíše bez vašeho potvrzení.

Hodí se pro menší až střední kolejiště v DCC. Aplikace je soukromý nástroj, běží u vás doma a data zůstávají na vašem zařízení. Seznam lokomotiv na tomto webu se načítá přímo z ní.

Hlavní funkce

Lokomotivy a vozidla

  • karta s údaji, titulní fotkou a dalšími fotkami a přílohami
  • jedinečná DCC adresa, stav vozidla jako barevná kontrolka
  • seznam nebo galerie, filtry a řazení
  • seznam přání s odkazem na obchod
  • servisní záznamy, duplikování lokomotivy
  • tisk karty a QR štítky, čtečka QR přímo v aplikaci

Dekodéry a CV

  • evidence dekodérů a jejich typů
  • tabulka CV a funkce F0 až F28 u každé lokomotivy
  • šablony CV podle dekodéru, adresní CV se při použití šablony vynechají
  • zálohy CV s možností obnovy
  • knihovna definic dekodérů převzatá z projektu JMRI (přes 3 900 modelů) s českými popisky tam, kde existují
  • rozpoznání typu dekodéru z přečtených CV

Příslušenství a moduly

  • moduly s jedním účelem: výhybky, serva, světla, efekty, návěstidla
  • výstupy modulu a položky na nich, zvlášť číslo výhybky na kolejišti a DCC číslo
  • samostatné výhybky s vlastní adresou bez modulu
  • CV patří modulu, adresa je vidět v jeho hlavičce
  • mapa čísel s hlídáním duplicit a nabídkou nejbližšího volného čísla
  • barvy a čísla vodičů, QR štítek modulu
  • okno Programátor pro programovací kolej

Správa dat a přístup

  • přihlášení heslem, relace 30 dní, omezení počtu pokusů
  • HTTPS přímo v aplikaci s certifikátem z NAS
  • automatická záloha databáze (výchozí 14 kusů) a obnova
  • export JSON a CSV, import CSV s náhledem před uložením
  • tmavý režim, instalace na plochu jako PWA
  • jiné rozložení pro počítač (široké) a pro mobil

Zpětná hlášení

Evidence hlásičů obsazení (například 16vstupový modul DR4088LN-CS): kolik má vstupů, jaké adresy a ke kterému úseku patří.

Jen evidence Aplikace zatím nezobrazuje živé obsazení kolejí.

Řízení lokomotivy

Záložka Řízení nabízí rychlost, směr, funkce F0 až F28 a nouzové zastavení. Při ztrátě spojení se lokomotiva automaticky zastaví.

Zkoušeno na simulaci Funguje přes centrálu Z21, zatím vyzkoušeno proti simulované centrále.

AI asistent

Chat dostupný v celé aplikaci z ikony v horní liště. Ví, na které záložce a u kterého záznamu právě jste, čte evidenci (moduly, položky, CV, zpětná hlášení, lokomotivy, dekodéry) a hledá na internetu, například v návodech výrobců. Zdroj uvádí v odpovědi.

Změny pouze navrhuje jako karty s údaji, důvodem a zdrojem. Do evidence se zapíšou až po kliknutí na „Použít návrh“ a platí stejné kontroly jako při ručním zadání, například překryv čísel.

Vyžaduje vlastní API klíč Potřebuje klíč Anthropic API (placené podle spotřeby, hledání na webu stojí navíc). Klíč se ukládá jen na serveru a do prohlížeče se nevrací.

Napojení na centrálu

Aplikace umí číst a zapisovat CV z programovací i hlavní koleje a ukládá je až po vašem potvrzení.

Centrála / protokolCo aplikace umíStav
Roco / Z21 (Z21 LAN, UDP)čtení a zápis CV na programovací i hlavní koleji, zjištění stavu, řízení lokomotivyHlavní podporovaný způsob
Digikeijs DR5000, YaMoRC YD7001 (LocoNet přes TCP)programovací slot LocoNet, čtení CV z hlavní koleje přes RailComImplementováno, na všech zařízeních neověřeno
LocoNet přes Z21 LANalternativa k přímému protokolu Z21V kódu označeno jako nevyzkoušené
Zimo MX10, z21 startuvedeno v katalogu centrálPodle katalogu
ESU ECoS, Märklin CS, Uhlenbrock Intellibox, Lenz LZV, jinájen evidence centrályBez komunikace

Když je centrála v jiné síti než NAS

Pokud se síť s centrálou a síť s NAS nedají propojit, použijete malý připojovací agent (nejde o AI asistenta). Je to jednoduchý Python program (3.8 a novější, bez instalace dalších balíčků), který běží na počítači v síti centrály. Spojení vždy navazuje agent směrem k aplikaci přes HTTPS, takže do domácí sítě nemusíte otvírat žádný port. Agent si vyzvedává úlohy čtení a zápisu CV a vrací výsledky. Přihlašuje se klíčem, který vytvoříte v aplikaci; ta si ukládá jen jeho otisk.

Technické požadavky

Server

  • NAS s Dockerem, ověřeno na Synology s DSM 7.1 a Dockerem 20.10 (docker-compose funguje)
  • kontejner s Pythonem 3.11, FastAPI a uvicorn, databáze SQLite
  • zpracování fotek (Pillow) a QR kódů (segno)
  • data (databáze, fotky, soubory, zálohy, nastavení) leží ve sdílené složce NAS mimo kontejner
  • běžný port 8090 do kontejneru, HTTPS s certifikátem z NAS, který se po obnově sám načte

Klient a kolejiště

  • jakýkoli moderní prohlížeč v počítači, tabletu nebo telefonu
  • DCC centrála dostupná po síti (viz tabulka výše)
  • pro cizí síť centrály počítač s Windows nebo jiným systémem s Pythonem pro agenta
  • pro AI asistenta přístup serveru k internetu a účet s API klíčem Anthropic; bez něj ostatní funkce fungují beze změny
  • pro přístup zvenku například DDNS adresa NAS a přesměrovaný port, vždy s heslem a HTTPS

Aplikace se instaluje vlastním sestavením kontejneru ze zdrojového kódu. Není to hotová služba k přihlášení na cizím serveru.

Přínosy a omezení

Přínosy

  • jedno místo pro lokomotivy, dekodéry i příslušenství
  • CV jde číst z centrály a zálohovat, před přepsáním vidíte rozdíly
  • hotové definice dekodérů z JMRI ušetří ruční zadávání
  • data zůstávají doma, žádný cloud ani předplatné
  • obsluha z tabletu u kolejiště
  • čeština v celém rozhraní

Omezení

  • nenahrazuje ovládací software kolejiště: nemá jízdní řády, automatiku ani zabezpečovací zařízení
  • živý stav výhybek a obsazení kolejí, zkušební povel výhybce zatím nejsou
  • podpora LocoNetu a RailComu je ověřená jen částečně, vyzkoušejte ji na své centrále
  • jen protokol DCC
  • AI asistent může odpovědět nepřesně, proto nic nezapisuje bez potvrzení a údaje z jeho návrhů je třeba ověřit; je placený podle spotřeby
  • jediný uživatel s jedním heslem, ne víceuživatelský systém
  • instalace předpokládá základní práci s Dockerem
  • definice JMRI nemá všechny dekodéry, například produkty menších výrobců se doplňují ručně

Popis vychází ze stavu aplikace k 26. 10. 2026. Aplikace vzniká postupně a funkce označené jako ověřené jen částečně je dobré vyzkoušet na vlastním kolejišti. Definice dekodérů pocházejí z projektu JMRI (licence GPL v2).