Brandýs-Boleslav
Začni psát pro vyhledávání...

Úřední deska - Dokumentace

Úřední deska - Dokumentace

Automatické nasazení na serveru

Data z úřední desky se automaticky stahují při každém buildu na serveru. Není potřeba žádná manuální akce.

GitHub Pages

V GitHub Actions workflow .github/workflows/jekyll.yml:

  • Před Jekyll buildem se automaticky spustí stažení dat z API
  • Data se uloží do uredni-deska/data.json
  • Jekyll pak zkopíruje data do _site/ při buildu

Jak to funguje:

- name: Fetch Uredni Deska Data
  run: |
    mkdir -p uredni-deska
    curl -s -o uredni-deska/data.json 'http://193.85.188.109:8083/wab/eud/ODExportData.action'

Cloudflare Pages

V package.json je definován prebuild script:

"scripts": {
  "prebuild": "bash scripts/fetch_uredni_deska.sh",
  "build": "..."
}

Když Cloudflare Pages spustí npm run build, automaticky se nejdřív spustí prebuild, který stáhne data.

Cloudflare Pages build command: npm run build

Problém s Jekyll pluginy

Jekyll plugin _plugins/uredni_deska_data.rb nefunguje, protože:

  • Gem github-pages spouští Jekyll v bezpečném režimu
  • V bezpečném režimu se nepovolují custom pluginy v _plugins/
  • Proto data musíme stahovat před buildem, ne během buildu

Lokální development

Pro lokální vývoj:

# 1. Stáhnout data
./scripts/fetch_uredni_deska.sh

# 2. Spustit Jekyll server
bundle exec jekyll serve

# 3. Otevřít v prohlížeči
open http://localhost:4000/uredni-deska/

Nebo použít npm:

npm run prebuild  # Stáhne data
bundle exec jekyll serve

Automatická aktualizace dat

Denní aktualizace (GitHub Actions)

Workflow .github/workflows/daily-rebuild.yml spouští rebuild Cloudflare Pages každý den v 6:00 UTC. To zajistí, že data jsou vždy aktuální.

AI analýza dokumentů (3x denně)

Workflow .github/workflows/uredni-deska-analyzer.yml:

  • Stahuje PDF dokumenty
  • Extrahuje text pomocí pdfplumber
  • Analyzuje pomocí AI (Claude Haiku 4.5 přes OpenRouter.ai)
  • Vytváří detailní Jekyll stránky v _uredni-deska/
  • Spouští se 3x denně: 7:00, 13:00, 19:00 UTC

Vyžaduje: OPENROUTER_API_KEY v GitHub Secrets

Soubory

  • scripts/fetch_uredni_deska.sh - Bash skript pro stažení dat
  • scripts/analyze_uredni_deska.py - Python skript pro AI analýzu
  • uredni-deska/data.json - Generovaná data (ignorováno v gitu)
  • uredni-deska/app.js - Frontend JavaScript aplikace
  • _uredni-deska/*.md - AI-generované detailní stránky dokumentů

Troubleshooting

Data se nenačítají na serveru

  1. Zkontrolujte GitHub Actions logy - měl by být krok “Fetch Uredni Deska Data”
  2. Zkontrolujte Cloudflare Pages build logy - měl se spustit prebuild script
  3. Ověřte, že scripts/fetch_uredni_deska.sh má spustitelná práva (chmod +x)

API není dostupné

Pokud API úřední desky není dostupné, vytvoří se prázdný JSON s chybovou hláškou:

{
  "error": true,
  "message": "API nedostupné",
  "informace": []
}

Frontend aplikace tuto chybu zobrazí uživateli.

Lokálně se data nenačítají

Ujistěte se, že jste spustili:

./scripts/fetch_uredni_deska.sh

Data se negenerují automaticky při lokálním buildu - musíte je stáhnout ručně.