Files

T

JiriUhlirandClaude Opus 5 29de584df8 Ticketovaci system: udalosti, externi ID, statistiky a widgety nad konektory

Jakakoliv udalost se muze stat ticketem. Prijem je verejny endpoint na firmu
(`POST /webhook/ticket/:token`), takze zalozit ticket jde i bez stavby stromu.

Externi ID je unikatni V RAMCI FIRMY: dalsi zprava se stejnym ID se navesi na
existujici ticket misto zalozeni druheho, a stejne ID u jine firmy je jiny
ticket. Cislo a retezec jsou tentyz klic. Udalosti se drzi cele vcetne
prijatych dat a jdou rozbalit v detailu - je to neco jineho nez log.

Ticket nove nese firstResponseAt, resolvedAt, resolvedById a reopenCount.
Bez nich neslo rict, kdo kolik odbavil ani jak dlouho zakaznik cekal.
`getAgentStats` z toho pocita vykon resitelu vcetne medianovych casu
a vracenych ticketu. Pocet vyresenych sam o sobe odmenuje toho, kdo tickety
zaviral predcasne, proto je vraceni videt vedle nej.

Widgety: klient konecne vola /widget-data. Endpoint existoval, ale nikdo ho
nepouzival, takze vlastni widget hlasil "nepodarilo se zobrazit". Pribyl zdroj
`connector` - co umi zjistit napojena sluzba, jde vytahnout do dlazdice pres
tentyz skript, ktery pouziva krok automatizace. Vysledek se cachuje.

Akce a widgety uz nejsou v nastaveni, maji vlastni zalozku vedle automatizaci.
Telo akce se sklada stromem, ne JSONem v textarei - je to tentyz editor,
jen misto karty spoustece je "spousti clovek tlacitkem na ticketu".

Nova zalozka Lide se seznamem a detailem osoby. Seznam ticketu i lidi ma dva
pohledy, tabulku a dlazdice.

Opraveno: createTicket bral typeId, fields, tags i assigneeGroupId, ale nikdy
je neukladal. Ticket zalozeny s typem zustaval bez typu a bez vlastnich poli.

Dlouhe pomlcky, sipky, vypustky a bullety pryc z celeho projektu.

Overeno 21 kontrolami proti bezicimu serveru v rezimu souboru.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

2026-08-13 15:13:09 +02:00

8.3 KiB

Raw Blame History

01 - Prehled a stav

Co aplikace je

Web a klientsky portal IT firmy. Verejna cast prodava sluzbu, cast za prihlasenim ukazuje klientovi stav jeho automatizaci, ticketu a incidentu.

Vse je jedna aplikace v jednom containeru. Express obsluhuje API i zbuildovanou React aplikaci ze slozky dist/public.

Stav

Oblast	Stav	Poznamka
Verejny web	hotovo	homepage, sluzby, o nas, kontakt, 404
Prihlaseni	hotovo	JWT, demo ucty
Dashboard	hotovo	prehled, tickety, incidenty, automatizace, nastaveni
Zivy dashboard pres SSE	hotovo	zmeny se projevi bez obnoveni stranky
Simulace provozu	hotovo	tlacitko v postrannim menu portalu
Katalog sluzeb	hotovo	29 sluzeb, 7 kategorii vcetne Obecne
Builder automatizaci	hotovo	strom akci, vetveni podminkou
Webhook s registrovanou adresou	hotovo	token generuje server, verejny endpoint validuje data
Tickety na konkretni lidi	hotovo	resitel, filtr moje, prehled vytizeni tymu
Prijem udalosti do ticketu	hotovo	webhook na firmu, externi ID unikatni za firmu
Udalosti na ticketu	hotovo	dalsi zprava se navesi na tentyz ticket
Statistiky resitelu	hotovo	odbaveno, mediany casu, vracene, fronta
Pohledy tabulka a dlazdice	hotovo	tickety i lide
Stranka Lide a detail osoby	hotovo	vykon a co ma u sebe
Log ticketu ve strome	hotovo	vcetne toho, co ktera sluzba vratila
Kanaly do ticketu	hotovo	WhatsApp, e-mail, hlas a formular jako spoustece
Parametry od sluzby	hotovo	katalog je deklaruje, server je dosazuje pri ulozeni
Nastaveni poli akci	castecne	ticket, e-mail a WhatsApp ano, ostatni jen napoveda
Obsah ticketu a sablony	hotovo	`{{parametr}}` ze spoustece do poli akce
Vystupy kroku a predvalidace	hotovo	podminka se umi zeptat, co vratil predchozi krok
Kanaly WhatsApp, FB, Instagram	hotovo	vcetne vzorovych automatizaci na prijem
Firmy a prava	hotovo	tri pohledy, uzivatel muze byt ve vic firmach
Nastavitelny dashboard	hotovo	widgety, sirky a poradi, ulozene za uzivatele a firmu
Skripty konektoru	hotovo	manifest, kontrola parametru, hot reload, iDoklad
Konektory za firmu	hotovo	pristupove udaje v konektoru, overeni napojeni
Transformace dat	hotovo	pravidla i sablona JSON, kroky si predavaji struktury
Sprava clenstvi z portalu	hotovo	uzivatele, firmy a role v Nastaveni
Role a prava jako data	hotovo	26 prav v katalogu, vlastni role za firmu
Zalozky a limity za firmu	hotovo	navigace chodi ze serveru, ne z kodu klienta
Osoby a skupiny resitelu	hotovo	ticket lze prehodit na skupinu, ne jen na cloveka
Typy ticketu a vlastni pole	hotovo	typ rozhoduje, ktere akce se na ticketu ukazou
Vydefinovane akce na ticketu	hotovo	vazba na typ nebo tag, telo je operace, strom, skript
Vlastni widgety	hotovo	vcetne zdroje z konektoru a vykonu resitelu
Telo akce jako strom	hotovo	tentyz editor jako automatizace
Audit a prepnuti na jiny ucet	hotovo	prepnuti je vychozi jen pro cteni, vse v auditu
Bugs a wishes	chybi	vyvojarska agenda, samostatna evidence vedle ticketu
Beh automatizaci	chybi	ulozeny strom se nevykonava, neni runtime
Uloziste konektoru	hotovo	Postgres, nebo JSON soubor. Udaje vzdy sifrovane
Uloziste pro zbytek	hotovo	tickety, automatizace, incidenty, rozlozeni, entity
Monetizace a cena za krok	navrh	popis v 16-monetizace.md, neni naprogramovane
Odesilani e-mailu z formulare	chybi	poptavka se zatim jen loguje

Znama omezeni

Data prezijou restart, ale ne redeploy, kdyz neni databaze. Rezim se pozna v portalu i v /health/ready a rozhoduje o nem jedno misto, viz 14-databaze.md:

Rezim	Kdy	Nasledek
`postgres`	je `DATABASE_URL` a migrace prosly	data se neztraci
`file`	neni databaze, je `DATA_DIR`	prezije restart, ne redeploy
`memory`	neni ani `DATA_DIR`	ztrati se pri restartu

Beh automatizaci zatim neexistuje: ulozeny strom se nevykonava, provoz se dela simulaci. Popis, jak to ma vypadat, je v 10-runtime-a-kapacita.md.

Obsah verejneho webu je ukazkovy. Nazev firmy, reference, tym i cisla jsou vymyslene a pred ostrym pouzitim se musi nahradit. Firemni udaje jsou na jednom miste v web/src/config/brand.ts.

Zivy stream drzi seznam posluchacu v pameti jedne instance. Pri vice instancich by ho musel nahradit sdileny kanal, napriklad Redis pub/sub.

Log ticketu zatim plni simulace, ne skutecny beh. Zaznamy jsou realisticke, ale nevznikly vykonanim ulozeneho stromu - runtime neexistuje.

Dalsi krok

Nejuzitecnejsi pristavek je runtime. Strom uz nese vsechno potrebne: spoustec s parametry, podminky a u ticketu i kanalu nastavena pole se sablonami. Chybi jen to, co ho vykona. Do te doby je ulozena automatizace popis zameru, ne provoz.

Vedle toho zbyva prevest na inputs i ostatni konektory a doplnit odkazy na vystup predchoziho kroku, ne jen na spoustec. Podrobnosti v 05-dashboard-a-builder.md.

Za rozmysleni stoji evidence bugs a wishes. Zamerne to nejsou tickety, duvod je v 06-tickety.md.

Prvni cast navrhu uz je hotova: vykonna cast konektoru, tedy skripty s manifestem a kontrolou parametru, viz 11-skripty-konektoru.md. Runner je pripraveny, chybi nad nim fronta.

Datove modely a prava z 09-navrh-rozsireni.md jsou hotove, popis stavu je v 17-nastaveni-a-prava.md. Navrh k rozhodnuti zustava 10-runtime-a-kapacita.md pro frontu, beh kroku a rozpocet na 150 klientu, a 16-monetizace.md pro cenu za krok.

Dokumentace

Soubor	O cem
02-appfactory-proxy.md	beh za reverse proxy, ROOT_PATH, health
03-architektura-a-mapa-kodu.md	kde co je
04-api.md	endpointy a to, co ze Swaggeru neni videt
05-dashboard-a-builder.md	editor automatizaci
06-tickety.md	model ticketu a log prubehu
07-firmy-a-prava.md	firmy, pohledy, kdo co vidi
08-dashboard-widgety.md	nastavitelny prehled
09-navrh-rozsireni.md	puvodni navrh rozsireni
10-runtime-a-kapacita.md	navrh: fronta, beh kroku, kapacita
11-skripty-konektoru.md	vykonna cast sluzeb
12-sluzby-a-konektory.md	sluzba, konektor, viditelnost
13-transformace-dat.md	pole na pole a JSON na JSON
14-databaze.md	tri rezimy uloziste, migrace, sifrovani
15-rejstrik-funkci.md	k cemu je jaka funkce a komponenta
16-monetizace.md	navrh: cena za krok a balicky
17-nastaveni-a-prava.md	prava, typy, akce, widgety, prepnuti uctu
18-ticketovaci-system.md	udalosti, externi ID, statistiky, pohledy
99-zmeny.md	zaznam zmen, nejnovejsi nahore

8.3 KiB Raw Blame History