title: Byro – pomocník na byrokracii authors: Jakub Michálek a Ondřej Profant license: Affero GNU-GPL

Pomocník na byrokracii Byro

Tenhle cvičený opičák za vás rád udělá byrokracii, kterou byste ztratili hodiny práce.

Program byro je soubor utilit, které umožňují z příkazové řádky:

• sázet dobře upravené dokumenty,
• podepisovat dokumenty elektronickým podpisem,
• aktualizovat data v redmine,
• posílat dokumenty e-mailem nebo datovou schránkou,
• generovat výkazy z redmine.

Program vytvořil klub Pirátů v zastupitelstvu hl. m. Prahy.

Postup při instalaci

See INSTALL.md file.

Zapojete se!

Velmi rádi uvítáme další programátory a testy. Program sám je psán v Pythonu 3, ale pro vylepšení není potřeba mít hluboké znalosti. Program většinou jen obaluje běžné aplikace (LaTeX, pandoc, git, ...), čili můžete pomoci i pokud jen dodáte nápad na svoji oblíbenou utilitku.

Chyby a náměty hlaste v issues (česky nebo anglicky).

Používání

Klasická pracovní metoda:

• upravím soubor main.md do potřebné podoby a přílohy umístím do složky attachments,
• spustím příkaz byro pdf, abych zkontroloval, jak vypadá písemnost ve formátu PDF, a následně
• spustím příkaz byro full, který obstará celý proces včetně odeslání do datové schránky a uložení poznámky do redmine.

Program se používá podobně jako git zadáním hlavního příkazu byro a některého z následujících doprovodných příkazů:

Nová pracovní metoda

• byro new [-t template -r recipient] -- vygeneruji soubor main.md do potřebné podoby
• upravím vygenerovaný dokument a přílohy umístím do složky attachments
• spustím příkaz byro pdf a zkontroluji, že dopis je OK
• spustím příkaz byro send, který obstará celý proces včetně odeslání do datové schránky a uložení poznámky do redmine.

Program se používá podobně jako git zadáním hlavního příkazu byro a některého z následujících doprovodných příkazů:

Vysokoúrovňové metody

byro new [-t template -r recipient -f from]

DOSUD NENÍ IMPLEMENTOVÁNO

Vytvoří nový dokument z šablony template (viz seznam veřejných šablon v adresáři), který je určen instituci recipient a je odeslán od osoby from. Pole recipient má tvar např. "Ministerstvo dopravy", přičemž na základě tohoto příkazu vyhledá program jeho adresu a datovou schránku z informačního systému datových schránek (pokud je nalezeno více možností, nabídne volbu v příkazové řádce). Pokud je zadán přepínač from použijí se data osoby z informačního systému osob. Jinak se použijí výchozí data o uživateli, který systém právě používá. Pokud je dokument vytvářen ve složce, která není platným spisem, založí nový spis zatím bez čísla.

byro pdf [-t template .md]

Převede soubor main.md (nebo jiný zadaný dokument) pomocí programu pandoc do formátu PDF s využitím stylu dokumentu definovaných v repozitáři. Výchozím stylem je standardní dopis (letter). V dokumentu lze používat standardní pole šablon v popisu pandocu. Rovněž aplikuje před kompilací skript vlna, který se stará o nedělitelné mezery na konci řádku.

Šablony: letter, brochure, legal, form <<= zatím není implementováno

byro send

DOSUD NENÍ IMPLEMENTOVÁNO

Vytvoří o dokumentu záznam u příslušného úkolu v redmine (pokud úkol neexistuje, založí ho, vyžádá si jeho číslo a uloží číslo úkolu na začátek jména složky, ve které je první dokument). Dále aplikuje příkazy pdf, sign, save a podle informací v hlavičce souboru odešle datovou schránkou ds nebo e-mailem mail.

Nízkoúrovňové metody

byro save

DOSUD NENÍ IMPLEMENTOVÁNO

Stáhne aktualizace z repozitáře příkazem git pull, přidá všechny změny v daném adresáři git add ., zapíše git commit a nahraje výsledek na server git push.

byro sign

Podepíše soubor elektronickým podpisem podle uživatele definovaného v hlavičce souboru main.md. Podepíše buď konkrétní PDF soubor uvedený za příkazem anebo podepíše všechny PDF dokumenty v adresáři, chybí-li konkrétní soubor k podpisu.

byro ds

DOSUD NENÍ IMPLEMENTOVÁNO

Odešle dokument main_signed.pdf a jeho přílohy uložené v adresáři attachments do datové schránky uvedené v hlavičce souboru main.md. Vychází z pythonovského skriptu dodaného Vaškem Klecandou. Po odeslání stáhne potvrzení o dodání datové zprávy. Následně vloží jako aktualizaci úkolu v redmine odkaz na odeslaný dokument na githubu spolu s datem a dodejkou. Správný úkol vybere podle spisové značky uvedené v hlavičce souboru main.md, která koresponduje se spisovou značkou v redmine.

byro mail

DOSUD NENÍ IMPLEMENTOVÁNO

Odešle dokument main_signed.pdf a jeho přílohy uložené v adresáři attachments na e-mail uvedený v hlavičce souboru main.md. Používá přitom utilitu msmtp, viz skript zde. Následně vloží jako aktualizaci úkolu v redmine odkaz na odeslaný dokument na githubu spolu s datem odeslání.

byro ocr

byro [-o <text>.txt] file1.jpg file2.jpg