Module documentation

Pobočky

Pobočky představují fyzickou přítomnost organizace ve světě — kamenné prodejny, kanceláře, servisní centra, výdejní místa, sklady. Modul `/branch` sjednocuje jejich správu pod jednu střechu: pro každou pobočku zde vedete její adresu, GPS souřadnice, otevírací dobu, kontaktní informace a fotografie. Tato data pak systém využívá napříč celou administrací i na veřejném webu, který zákazníkům ukazuje, kde vás mohou najít.

Last updated 24 April 2026

Pobočky představují fyzickou přítomnost organizace ve světě — kamenné prodejny, kanceláře, servisní centra, výdejní místa, sklady. Modul /branch sjednocuje jejich správu pod jednu střechu: pro každou pobočku zde vedete její adresu, GPS souřadnice, otevírací dobu, kontaktní informace a fotografie. Tato data pak systém využívá napříč celou administrací i na veřejném webu, který zákazníkům ukazuje, kde vás mohou najít.

Modul současně slouží jako zdroj pravdy pro externí integrace. Pobočky se synchronizují s Firmy.cz, mapovými API a vyhledávači, každá má svou unikátní veřejnou URL a slug použitelný v SEO. Když tedy změníte otevírací dobu v administraci, zákazník ji uvidí jak na vašem webu, tak v Googlu a u přepravce.

Přehled poboček

Hlavní tabulka ukazuje všechny pobočky organizace. Pořadí je zvoleno tak, aby aktivní pobočky byly vždy nahoře a neaktivní pod nimi, v rámci jedné skupiny pak abecedně podle názvu.

  • Obrázek — miniatura hlavní fotografie pobočky doprovázená názvem a popisem, takže řádek funguje i jako vizuální vizitka.
  • Slug — technický identifikátor, který tvoří součást veřejné URL (/pobocka/<slug>).
  • Interní kód — organizační označení typu PRG-01 nebo BRN-02, které slouží k propojení s účetnictvím nebo skladem.
  • Město / adresa — souhrnný údaj složený z první řádky adresy, aby bylo jasné, o jakou pobočku jde.
  • Stav — barevná značka rozlišující aktivní (zelená) a neaktivní pobočky (šedá).
  • Webová adresa — URL pro případy, kdy má pobočka vlastní microsite.
  • Datum vytvoření a datum poslední úpravy — pomocná informace pro audit.

Seznam se automaticky obnovuje každých 30 sekund, takže stav poboček zůstává aktuální i při dlouhodobé práci v administraci.

Filtrování

Nad seznamem je plnotextové vyhledávání, které současně prohledává název pobočky, slug, interní kód a město. Tím pokrývá všechny běžné scénáře hledání — od „najdi brněnskou pobočku" po „otevři pobočku s kódem PRG-01".

Vytvoření nové pobočky

Tlačítko Create Branch v pravém horním rohu otevře formulář se základními identifikačními údaji. Povinný je jen název, zbytek se dá doplnit později. Slug se automaticky vygeneruje z názvu, pokud jej neuvedete ručně. Interní kód musí být v rámci organizace unikátní, aby se poznal jednoznačný zdroj dat v propojených systémech. Volitelně lze zadat i krátký popis, veřejnou URL pobočky a přiřadit manažera pobočky — kontakt z adresáře, který je za pobočku zodpovědný.

💡 Slug je součástí veřejné URL (například /pobocka/praha-centrum) a používá se v integracích třetích stran. Po vytvoření jej lze změnit, ale přesměrování ze starých adres si musíte zajistit sami.

Detail pobočky

Po kliknutí na název se otevře detail rozdělený do tematických záložek. Rozdělení do záložek odpovídá tomu, jak s pobočkou typicky pracujete — jinak ji zakládáte a aktualizujete základní údaje, jinak plánujete otevírací dobu, jinak spravujete fotografie.

Přehled

Obsahuje základní identifikační údaje: název, slug, interní kód, veřejnou URL a krátký popis. Dále se zde ukazují GPS souřadnice (zeměpisná šířka a délka), datum založení a manažer pobočky s odkazem na jeho kontakt v adresáři. Přepínačem Aktivní / Neaktivní lze pobočku kdykoli dočasně vypnout bez mazání dat.

Adresa

Kompletní poštovní adresa pobočky obsahuje jméno nebo firmu (pokud se liší od organizace), ulici s číslem popisným, město a případně městskou část, PSČ, stát nebo region, zemi v ISO 3166-1 alfa-2 kódu (například CZ, SK, DE) a volitelnou poznámku.

Otevírací doby

Samostatná záložka pro definici pravidelného rozvrhu a výjimek. Struktura je popsána v samostatné sekci níže.

Kontakty

Správa e-mailů a telefonních čísel pobočky. U každého kontaktu lze přiřadit roli (například Recepce, Fakturace, Hlavní, Fax) a vidět indikátor ověřenosti, který potvrzuje, že daný kanál prošel automatickou verifikací.

Galerie

Fotografie pobočky určené pro prezentaci na webu — fasáda, interiér, prodejní plocha. Podrobnosti o ovládání galerie jsou níže.

Otevírací doby a výjimky

Otevírací doby pobočky se skládají ze dvou vrstev: pravidelného rozvrhu, který se opakuje každý týden, a výjimek, které jej přepisují pro konkrétní dny. Tato dvouvrstvá struktura umožňuje pokrýt jak běžný provoz, tak státní svátky a firemní dovolené bez nutnosti kompletní rekonfigurace.

Pravidelný rozvrh

Pro každý den v týdnu (pondělí až neděle) lze nastavit čas otevření a zavření (například 08:00-17:00), případně více intervalů kvůli polední přestávce (08:00-12:00, 13:00-17:00). Každé pravidlo může mít volitelný popis (například Pouze pro registrované zákazníky), období platnosti pro sezónní rozvrhy (letní a zimní otevírací doba) a příznak aktivní / neaktivní, kterým lze pravidlo dočasně vypnout bez smazání.

ℹ️ Pondělí má v systému index 0, neděle index 6. Den bez záznamu znamená, že pobočka je v tento den zavřená. Uložení rozvrhu nahrazuje všechna stávající pravidla najednou jedním tlačítkem Uložit, aby rozvrh zůstal vnitřně konzistentní.

Výjimky

Výjimky řeší situace, kdy jeden konkrétní den vybočuje z pravidelného rozvrhu — státní svátek, firemní akce, inventura. Pro každou výjimku se zadává datum (například 24. 12. 2026), příznak otevřeno/zavřeno a důvod (Štědrý den, Inventura, Firemní akce). Výjimky mají přednost před pravidelným rozvrhem.

💡 Nastavení výjimek nejlépe provádějte na začátku roku — všechny státní svátky na celý rok zvládnete v jednom sezení. Zákazníci je uvidí jak v administraci, tak na veřejném webu.

Živý indikátor otevřeno / zavřeno

Na veřejné stránce pobočky se zobrazuje aktuální stav Otevřeno / Zavřeno spočítaný kombinací pravidelného rozvrhu, výjimek a aktuálního časového pásma organizace. Zákazník tak vždy vidí, zda se může vypravit právě teď.

Galerie

Záložka Galerie umožňuje spravovat fotografie pobočky — fasády, interiéru, prodejní plochy, parkoviště. Obrázky se nahrávají přetažením nebo tlačítkem, a u každého lze označit, zda jde o hlavní fotografii (pobočka může mít maximálně jednu hlavní) nebo o logo pobočky. Ke každému obrázku je možné napsat popis pro přístupnost a SEO. Pořadí obrázků se mění přetažením, obrázek lze dočasně deaktivovat bez smazání, nebo trvale odstranit.

ℹ️ Pokud smažete hlavní fotografii, systém automaticky nastaví jako hlavní první další aktivní obrázek. Pobočka tak nikdy nezůstane bez vizuální reprezentace v seznamu.

SEO a veřejná prezentace

Pobočka má na veřejném webu dedikovanou stránku na URL /pobocka/<slug>. Pro dobrou viditelnost ve vyhledávačích je klíčové, aby byl slug stabilní (tvoří část URL a změna rozbije zpětné odkazy), název a popis byly věcné (používají se jako HTML meta tagy) a adresa byla vyplněná kompletně včetně PSČ — strukturovaná data slouží Googlu i Firmy.cz ke zpřesnění výsledků. GPS souřadnice umožňují zobrazení v mapách a hlavní fotografie slouží jako Open Graph obrázek při sdílení na sociálních sítích.

💡 Pro zlepšení viditelnosti vyplňte všechna pole adresy včetně PSČ a GPS. V popisu nepoužívejte nadmíru marketingových frází — raději věcně popište nabízené služby, což ocení i vyhledávače.

Kontextové menu

  • Změnit slug — úprava technického identifikátoru; slug se automaticky sanitizuje a deduplikuje, aby zůstal unikátní.
  • Deaktivovat — dočasné vypnutí pobočky; všechna data (adresa, rozvrh, fotografie) zůstávají, pouze mizí z veřejných přehledů a vyhledávání.

⚠️ Deaktivace není totéž co smazání. Deaktivovaná pobočka se dá kdykoli obnovit jedním přepnutím zpět. Pokud chcete pobočku odstranit trvale, je nutné kontaktovat správce.

Další funkce

  • Automatická synchronizace s Firmy.cz — otevírací doby i kontakty se exportují ve formátu, který portál přijímá bez ruční úpravy.
  • Packeta integrace — při propojení s přepravcem se synchronizují výdejní místa.
  • OSM formát otevíracích dob — interní převod rozvrhu do standardu OpenStreetMap pro další interoperabilitu.
  • Ověření e-mailů a telefonů — každý kontaktní údaj má indikátor, zda prošel automatickým ověřením.

Tipy pro každodenní práci

  • Ke každé pobočce vyplňte GPS souřadnice — zákazníci ji najdou rychleji na mapě a snáz se k vám dostanou.
  • Na začátku roku připravte výjimky na státní svátky a odpadnou vám dotazy „máte dnes otevřeno?"
  • Používejte interní kódy (například PRG-01, BRN-02) pro snadné propojení s účetnictvím a skladovým systémem.
  • Hlavní fotografii volte v dostatečném rozlišení (minimálně 1200×800 px), aby dobře vypadala i na velkých obrazovkách.
  • Pobočku neodstraňujte, ale deaktivujte — zachováte historii objednávek a kontaktů, které s ní byly spojeny.

Build with the API

Every module shipped here is also exposed via the REST API.