Vizuální automatizace procesů a workflow v N8N stylu. Propojte události (nová poptávka, formulář, časovač či webhook) s chytrou logikou (podmínky IF/Switch, smyčky, filtrování) a automatickými akcemi (odeslání e-mailu, HTTP požadavky nebo logování). Vše přehledně na drag-and-drop plátně bez psaní kódu s živým náhledem dat, bezpečnostním štítem a kompletní historií exekucí.
Vizuální automatizace procesů a workflow v N8N stylu. Propojte události (nová poptávka, formulář, časovač či webhook) s chytrou logikou (podmínky IF/Switch, smyčky, filtrování) a automatickými akcemi (odeslání e-mailu, HTTP požadavky nebo logování). Vše přehledně na drag-and-drop plátně bez psaní kódu s živým náhledem dat, bezpečnostním štítem a kompletní historií exekucí.
{{ $json.pole }}, bezpečné Rhai skripty, řazení a odstraňování duplicit.Po zapnutí pluginu přibude v adminu položka Pluginy → Automatizace. Detailní technický manuál a specifikace je k dispozici v docs/todo-automatizace.md.
Cílem plugin balíčku je nebobtnat binárku ani admin.wasm:
automation-core/ crate) — typy grafu, výrazy, podmínky,
katalog uzlů, čisté transformace a validace + topologické pořadí. Kompiluje se
nativně do API i do wasm fasády → jediný zdroj pravdy, žádný type drift.api/src/automation/) — orchestrace běhu (graf + smyčky), akční
uzly s IO (e-mail/HTTP/log), čekání, dispatch doménových událostí. Žije
v jádru API (rozhodnutí: „prostě v jádru"), ale je za runtime vypínačem
(Nastavení → Funkce → automation).admin/static/automation-editor/) hostovaný
v adminu přes <iframe>. Katalog uzlů, počty portů, validaci grafu i náhled
výrazů volá přes wasm fasádu automation-core-js (stejný vzor jako
wave-core-js) → nula bajtů navíc v admin.wasm (Leptos bundlu).Plugin je tedy deklarativní descriptor — Riplet nikdy nespouští jeho kód
(viz docs/plugins.md). Chování je v jádru, tady je metadata + dokumentace.
| Typ | Kategorie | Vstupy | Výstupy | Popis |
|---|---|---|---|---|
trigger.event | trigger | 0 | 1 | Doménová událost (inquiry.created, form.submitted, subscriber.confirmed) |
trigger.schedule | trigger | 0 | 1 | Interval v minutách (scheduler) |
trigger.webhook | trigger | 0 | 1 | POST /api/automation/webhook/{path} — vyžaduje sdílené tajemství (parameters.secret) v hlavičce X-Riplet-Token |
trigger.manual | trigger | 0 | 1 | Jen ruční spuštění z editoru |
logic.if | logic | 1 | 2 (true/false) | Rozvětvení podle podmínek |
logic.filter | logic | 1 | 1 | Propustí jen items splňující podmínky |
logic.switch | logic | 1 | N (dle pravidel) | Routing do víc výstupů, volitelný fallback |
logic.merge | logic | 2 | 1 | Append / spojení podle pořadí / podle klíče / výběr větve |
logic.wait | logic | 1 | 1 | Pauza (strop 300 s) |
logic.split_batches | logic | 1 | 2 (loop/done) | Dávkování se smyčkou (N8N „Loop Over Items") |
transform.set | transform | 1 | 1 | Nastaví/přepíše pole z výrazů |
transform.code | transform | 1 | 1 | JSON šablona s výrazy (žádný JS runtime) |
transform.aggregate | transform | 1 | 1 | Sloučí proud do jednoho itemu |
transform.datetime | transform | 1 | 1 | Formátování / posun data a času |
transform.sort | transform | 1 | 1 | Řazení podle polí |
transform.limit | transform | 1 | 1 | Prvních/posledních N items |
transform.remove_duplicates | transform | 1 | 1 | Odstranění duplicit |
core.noop | transform | 1 | 1 | Průchozí (spojka větví) |
core.sticky | note | 0 | 0 | Poznámka na plátně (engine ignoruje) |
action.email | action | 1 | 1 | Zařadí e-mail do fronty |
action.http_request | action | 1 | 1 | HTTP volání (opt-in, SSRF guard) |
action.log | action | 1 | 1 | Zápis do tracing + audit logu |
Uzel lze vypnout (disabled) — zůstane v grafu i s hranami, ale při běhu
jen propustí data dál (N8N „deactivate").
logic.split_batches je jediný uzel, do kterého smí vést zpětná hrana: tělo
smyčky se vrací na jeho vstup, uzel vydá další dávku a po vyčerpání pošle
nasbíraná data na výstup done. Validace takovou hranu nepovažuje za cyklus
(validate::back_edges), editor ji kreslí čárkovaně. Počet iterací je zastropován
(1000) a vnořené smyčky podporované nejsou.
Textová pole podporují {{ … }} vsuvky (bezpečná podmnožina, žádný JS runtime):
{{ $json }} / {{ $json.contact.email }} / {{ $json["a"]["b"] }} — aktuální item{{ $node["Název"].json.pole }} — výstup pojmenovaného uzlu{{ $now }} (RFC3339) / {{ $today }} (YYYY-MM-DD)"text", čísla, true/false/null{{ výraz }} → zachová typ; jinak string interpolace.
Vedoucí = značí výrazové pole (jako v N8N).Editor u každého výrazového pole ukazuje živý náhled vyhodnocený stejnou
funkcí, kterou použije engine (automation_core::expr přes wasm) — náhled tedy
nemůže lhát.
Texty editoru jsou i18n (admin/i18n/*.json, klíče auto.*); jazyk a motiv
předává admin v query parametrech iframu.
automation (Nastavení → Funkce) NIKDY
nespustí žádné workflow (event, plán ani webhook).secret (min. 24 znaků, editor ho vygeneruje), volající ho
posílá v hlavičce X-Riplet-Token (nebo Authorization: Bearer). Bez
tajemství se workflow neuloží, nezapne a webhook ho nespustí. K tomu rate
limity 30/10 min per IP a 120/10 min per cesta a tělo max 64 KB; neznámá
cesta i špatné tajemství vrací shodnou 404. Detail: docs/security.md.site_settings.automation.allow_http (default false).
SSRF guard blokuje loopback/privátní rozsahy (IPv4 i IPv6, včetně
IPv4-mapped), jen http/https, redirecty se nenásledují.Plugin se instaluje z katalogu: Admin → Pluginy → Dostupné → Instalovat. Ověřit balíček ze zdrojů jde i ručně:
sh registry/plugins/automation/run.sh
Skript jen validuje balíček (JSON manifest). Funkce samotná je vestavěná v jádru — zapne se v Admin → Nastavení → Funkce, položka menu se objeví po zapnutí pluginu v Admin → Pluginy.