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>

documentation/04-api.md

@@ -16,6 +16,8 @@ Verejne:
 | POST   | `/api/auth/login`   | prihlaseni, vraci JWT                   |
 | POST   | `/api/contact`      | poptavka z webu                         |
 | POST   | `/webhook/:token`   | prijem dat do automatizace              |
+| POST   | `/webhook/ticket/:token` | prijem udalosti do ticketu         |
+| GET    | `/webhook/ticket/:token` | napoveda k prijmu                  |
 
 Vyzaduji `Authorization: Bearer <token>`:
 
@@ -30,6 +32,10 @@ Vyzaduji `Authorization: Bearer <token>`:
 | DELETE | `/api/dashboard/layout`                             |
 | GET    | `/api/dashboard/summary`                            |
 | GET    | `/api/dashboard/people`                             |
+| GET    | `/api/dashboard/people/:id`                         |
+| GET    | `/api/dashboard/intake`                             |
+| POST   | `/api/dashboard/intake/regenerate`                  |
+| GET    | `/api/dashboard/settings/actions/:id/scope`         |
 | GET    | `/api/dashboard/tickets`                            |
 | GET    | `/api/dashboard/tickets/workload`                   |
 | GET    | `/api/dashboard/tickets/:id`                        |
@@ -204,6 +210,24 @@ s celym chybovym hlasenim a `durationMs`. Cely prubeh se zapise do logu ticketu.
 Vestavene akce (`type`, `tags`, `group`, `assign`, `status`, `comment`) jsou
 zvlast: meni ticket sam, ne cizi sluzbu, a kazda ma vlastni pravo.
 
+## Prijem udalosti do ticketu
+
+Popis modelu je v [18-ticketovaci-system.md](18-ticketovaci-system.md).
+
+`POST /webhook/ticket/:token` je **verejny**, autorizuje token firmy v adrese.
+Vraci 201 kdyz ticket vznikl, 200 kdyz se udalost navesila na existujici:
+
+```json
+{ "ok": true, "created": false, "ticketId": "TK-4822", "externalId": "3", "eventId": "tev_2" }
+```
+
+`externalId` je unikatni **v ramci firmy**. Token urcuje firmu, takze dve firmy
+mohou obe poslat objednavku cislo 3 a nedojde ke smichani. Cislo i retezec jsou
+tentyz klic.
+
+Neznamy `typeId` se zahodi a zaloguje, ticket vznikne bez typu. Odmitnout celou
+udalost kvuli jednomu poli by znamenalo ztratu dat.
+
 ## Prava a navigace
 
 `GET /api/dashboard/access` vraci `permissions` (efektivni prava po slouceni