Transformace maji svou kategorii, pribylo XML

Odstranena sluzba AI zpracovani textu. Delala totez co OpenAI, jen jinymi slovy, a dva zpusoby jak udelat jednu vec znamenaji jen otazku, ktery pouzit. Ukazkove stromy a stopy, ktere na ni odkazovaly, miri na openai.chat. - nova kategorie Transformace dat. Driv byly mezi obecnymi sluzbami vedle webhooku a pauzy; ve chvili kdy jich je vic nez tri, hleda je clovek jako skupinu, ne mezi spoustecemi. - skript transform.to-xml: zapise objekt jako XML vcetne escapovani. Cizi systemy si XML porad rikaji casto (ISDOC, EDI, banky, statni sprava) a bez toho se sestavuje retezcem v HTTP kroku, kde se na escapovani zapomene pokazde. Klice, ktere nejsou platny nazev prvku, se prejmenuji a rekne se to nahlas; klic zacinajici cislici dostane podtrzitko misto odriznuti, jinak by 2024 a 2025 byly totez. - navrh cele skupiny transformaci v 13-transformace-dat.md: formaty, pole a hodnoty, seznamy, text a kontrola, vcetne toho co v seznamu zamerne neni. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-08-28 09:05:27 +02:00
parent aa0a783095
commit e1c52e3da3
9 changed files with 287 additions and 428 deletions
@@ -188,6 +188,86 @@ nedodelku, viz [05-dashboard-a-builder.md](05-dashboard-a-builder.md).
 Neznamy prevod je pri behu chyba, ne preskoceni. Tise ho ignorovat by znamenalo
 odeslat neprevedena data a divit se az u odberatele.

+## Vlastni kategorie, ne polozka v Obecnem
+
+Transformace maji v katalogu **svou kategorii** (`transformace`). Driv byly mezi
+obecnymi sluzbami vedle webhooku a pauzy, coz prestalo davat smysl ve chvili,
+kdy jich zacalo byt vic nez tri: clovek je hleda jako skupinu, ne mezi
+spoustecemi.
+
+## Navrh cele skupiny
+
+Co uz existuje a co dava smysl doplnit. Neni to seznam vseho, co jde vymyslet,
+je to seznam toho, co v automatizacich opravdu chybi.
+
+### Formaty
+
+| Operace    | Co dela                                       | Stav   |
+| ---------- | --------------------------------------------- | ------ |
+| `to-json`  | poskladat objekt ze sablony                   | hotovo |
+| `to-xml`   | zapsat objekt jako XML vcetne escapovani      | hotovo |
+| `to-csv`   | seznam na CSV: oddelovac, hlavicka, uvozovani | navrh  |
+| `from-csv` | CSV na seznam objektu                         | navrh  |
+| `from-xml` | XML na objekt                                 | navrh  |
+| `to-text`  | textova sablona pro e-mail nebo poznamku      | navrh  |
+
+Cizi systemy si XML a CSV rikaji porad casto: ISDOC, EDI, banky, e-shopy,
+statni sluzby. Bez techhle kroku se to sestavuje retezcem v HTTP kroku
+a na escapovani se zapomene pokazde.
+
+### Pole a hodnoty
+
+| Operace      | Co dela                           | Stav   |
+| ------------ | --------------------------------- | ------ |
+| `map-fields` | premapovat pole a prevest hodnoty | hotovo |
+| `merge`      | spojit dva objekty do jednoho     | navrh  |
+
+`merge` chybi pokazde, kdyz krok dohleda zakaznika v CRM a data se maji spojit
+s tim, co prislo webhookem. Dnes se to obchazi sablonou JSON, ktera musi vypsat
+obe strany rucne.
+
+### Seznamy
+
+| Operace       | Co dela                                                 | Stav                    |
+| ------------- | ------------------------------------------------------- | ----------------------- |
+| `filter`      | nechat jen prvky, ktere splnuji podminku                | navrh                   |
+| `sort`        | seradit podle pole                                      | navrh                   |
+| `group-by`    | seskupit podle pole                                     | navrh                   |
+| `aggregate`   | soucet, pocet, prumer, min, max, volitelne po skupinach | navrh                   |
+| `deduplicate` | odstranit duplicity podle klice                         | v katalogu, bez skriptu |
+| `join`        | spojit dva seznamy podle spolecneho klice               | navrh                   |
+| `flatten`     | rozbalit zanoreni a seznamy seznamu                     | navrh                   |
+
+Tohle je nejvetsi dira. Objednavka ma polozky, faktura ma radky, report ma
+zaznamy - a dnes s nimi krok neumi udelat nic jineho nez predat je dal celé.
+
+### Text
+
+| Operace   | Co dela                              | Stav  |
+| --------- | ------------------------------------ | ----- |
+| `extract` | vytahnout hodnotu regularnim vyrazem | navrh |
+
+Variabilni symbol z predmetu e-mailu, cislo objednavky ze zpravy. Dnes na to
+musi jit jazykovy model, coz je za neco, co zvladne jeden vyraz, drahé a pomalé.
+
+### Kontrola
+
+| Operace    | Co dela                                        | Stav  |
+| ---------- | ---------------------------------------------- | ----- |
+| `validate` | overit povinna pole a typy, vratit seznam chyb | navrh |
+
+Nejdulezitejsi z celeho seznamu. Bez nej se vadna data posilaji cizi sluzbe
+a chyba se pozna az z jeji odpovedi - tedy pozde, po zapisu, a s hlaskou, ktera
+mluvi o jejich schematu, ne o nasich datech.
+
+### Co v seznamu zamerne neni
+
+- **Prevody jednotlivych hodnot** (datum, cislo, velikost pismen). Uz jsou
+  v `map-fields` jako prevody a druhy zpusob, jak udelat totez, by jen mnozil
+  otazku, ktery pouzit.
+- **Vlastni skript.** Uz existuje jako `transform.custom` a je to zamerne
+  posledni moznost, ne prvni.
+
 ## Kde to je

 ```
@@ -2,6 +2,31 @@

 Nejnovejsi nahore.

+## 2026-08-28 - transformace maji svou kategorii, pribylo XML
+
+### Odstraneno
+
+- **Sluzba AI zpracovani textu.** Delala totez co OpenAI, jen jinymi slovy.
+  Dva zpusoby, jak udelat jednu vec, znamenaji jen otazku, ktery pouzit.
+  Ukazkove stromy a stopy, ktere na ni odkazovaly, ted miri na `openai.chat`.
+
+### Pridano
+
+- **Kategorie Transformace dat.** Driv byly mezi obecnymi sluzbami vedle
+  webhooku a pauzy. Ve chvili, kdy jich je vic nez tri, je clovek hleda jako
+  skupinu, ne mezi spoustecemi.
+- **Skript `transform.to-xml`.** Zapise objekt jako XML vcetne escapovani.
+  Cizi systemy si XML porad rikaji casto (ISDOC, EDI, banky, statni sprava)
+  a bez tohohle se sestavuje retezcem v HTTP kroku, kde se na escapovani
+  zapomene pokazde.
+
+  Klice, ktere nejsou platny nazev prvku, se prejmenuji a rekne se to nahlas.
+  Klic zacinajici cislici dostane podtrzitko misto odriznuti - `2024` a `2025`
+  by jinak byly totez a v dokumentu by se srazily.
+- **Navrh cele skupiny transformaci** v [13-transformace-dat.md](13-transformace-dat.md):
+  formaty, pole a hodnoty, seznamy, text a kontrola. Vcetne toho, co v seznamu
+  zamerne neni a proc.
+
 ## 2026-08-28 - AI zpracovani textu funguje

 Sluzba byla v katalogu bez pristupovych udaju a s `appId: 'ai-text'`, tedy