---
title: "Databáza — Workflows for Laravel | Roundly"
description: "Osem tabuliek — každý stĺpec, index a cudzí kľúč, ako typy kľúčov určujú morph stĺpce a čo workflows:prune po uplynutí doby uchovania zmaže."
url: https://roundly-consulting.com/sk/open-source/navody/workflows-for-laravel/databaza
language: sk
---

[Všetky balíky](https://roundly-consulting.com/sk/open-source.md)

[Workflows for Laravel](https://roundly-consulting.com/sk/open-source/navody/workflows-for-laravel.md)

# Databáza

Osem tabuliek, ktoré publikuje workflows:install (tag workflows-migrations, s časovou pečiatkou pri publikovaní; nikdy sa nenačítavajú automaticky). Názvy pochádzajú z workflows.tables.\*. Migrácie idú len dopredu. Typy kľúčov sa určia pri migrácii — nastavte ich pred php artisan migrate:

- id a každý interný kľúčový stĺpec (\*\_id ukazujúci na tabuľku balíka) sa riadia primary\_key\_type (bigint s auto-increment alebo časovo zoradený primárny kľúč uuid / ulid).
- Morph dvojica <name>\_type + <name>\_id (nullable) drží model aplikácie. Jej stĺpec id sa riadi owner\_key\_type (owner\_\*), subject\_key\_type (subject\_\*) alebo key\_type (publisher\_\*, starter\_\*, requester\_\*).
- Každý časový údaj sa ukladá v UTC (created\_at, updated\_at a deleted\_at pri tabuľkách s mäkkým mazaním).

## workflow\_definitions

| Stĺpec | Typ | Poznámky |
| --- | --- | --- |
| `id` | key | — |
| `key` | string(100) | Jedinečný v rámci vlastníka (wdef\_key\_unique nad owner\_scope, key). |
| `name` | string(200) | — |
| `description` | text, nullable | — |
| `owner_type, owner_id` | morph, nullable | Null = celá aplikácia. |
| `owner_scope` | string(191) | Vlastník ako jeden reťazec (<morph class>:<key>, \* pre celú aplikáciu) pre jedinečný kľúč. |
| `subject_key` | string(100), nullable | Kľúč typu subjektu v registri (nikdy názov triedy). |
| `status` | string(16) | DefinitionStatus. |
| `current_version_id` | key, nullable, indexed | Publikovaná verzia, na ktorej bežia nové inštancie. |
| `webhook_id` | string(26), nullable, unique | Id prichádzajúceho webhooku (vytvorí sa pri prvom publikovaní, dá sa obnoviť). |
| `timestamps, deleted_at` | | Mäkké mazanie; zmazaná definícia si kľúč stále drží. |

## workflow\_versions

| Stĺpec | Typ | Poznámky |
| --- | --- | --- |
| `definition_id` | key | FK → definitions, pri mazaní restrict. |
| `number` | unsigned int | Jedinečné v rámci definície (wver\_number\_unique). |
| `status` | string(16) | VersionStatus. |
| `schema_version` | string(32) | roundly.workflows.graph/v1 |
| `graph / trigger / settings` | json | Celý dokument, konfigurácia uzla spúšťača, nastavenia. |
| `trigger_type / trigger_key` | string(16) / string(191), nullable | Indexované spolu so status (wver\_trigger\_idx) pre vyhľadávanie pri emite a webhooku. |
| `actor_mode` | string(16) | ActorMode. |
| `checksum` | char(64) | Kanonický odtlačok grafu (expectedChecksum, sync, export). |
| `review_flags` | json, nullable | Otvorené príznaky na kontrolu zo šablóny. |
| `published_at` | datetime, nullable | Po nastavení sú graf, spúšťač, aktér, nastavenia, kontrolný súčet a publikujúci zmrazené. |
| `publisher_type, publisher_id` | morph, nullable | Kto publikoval. |
| `schedule_cursor_at` | datetime, nullable | Posledný spracovaný termín plánu. |

## workflow\_instances

| Stĺpec | Typ | Poznámky |
| --- | --- | --- |
| `ulid` | char(26), unique | Verejné id (resources, príkazy, idempotentné kľúče). |
| `definition_id / version_id` | key | FK → definitions / versions; verzia sa nikdy nemení. |
| `owner_type, owner_id` | morph, nullable | Vlastník inštancie. |
| `subject_key, subject_type, subject_id` | string(100) / morph, nullable | Kľúč v registri a subjekt. |
| `trigger_type / trigger_key / trigger_payload` | string / json, nullable | Ako sa spustila. |
| `idempotency_digest` | char(64), nullable, indexed | — |
| `status` | string(16) | InstanceStatus. |
| `current_node_id` | string(64), nullable | — |
| `steps_count` | unsigned int, default 0 | Počíta sa voči limits.max\_steps. |
| `depth` | unsigned tinyint, default 0 | Vnorenie cez start\_workflow. |
| `parent_instance_id, parent_step_run_id, root_instance_id` | key, nullable | Rodič (FK, pri mazaní null) a koreň. |
| `actor_mode, starter_type, starter_id` | string(16) / morph, nullable | Aktér a používateľ, ktorý beh spustil. |
| `failure_code / failure_message / failed_node_id` | string(64) / text / string(64), nullable | Hodnota FailureCode alebo kód hostiteľa; správa sa ukladá pre operátorov. |
| `started_at, ended_at` | datetime, nullable | — |
| `lock_version` | unsigned int, default 0 | Zvyšuje sa pri každej zmene stavu. |

## workflow\_step\_runs

| Stĺpec | Typ | Poznámky |
| --- | --- | --- |
| `instance_id` | key | FK → instances, pri mazaní cascade. |
| `node_id / node_type` | string(64) | — |
| `visit / attempt` | unsigned int / unsigned smallint | Jedinečné spolu s instance\_id, node\_id (wstep\_attempt\_unique). |
| `status` | string(16) | StepRunStatus. |
| `idempotency_key` | string(100) | wf:{instance ulid}:{node id}:{visit} |
| `input / output` | json, nullable | Vyhodnotená konfigurácia, ktorú handler videl (strop steps\_input.max\_bytes), a jeho výstup. |
| `resume_signal` | json, nullable | Signál, ktorým bol pokus naposledy obnovený; opakovanie zlyhaného obnovenia ho prenesie. |
| `outcome` | string(32), nullable | — |
| `error_code / error_message / error_retryable` | string(64) / text / bool, nullable | — |
| `claim_token / lease_until` | string(26) / datetime, nullable | Prevzatie cez compare-and-set a jeho lease (wstep\_lease\_idx). |
| `scheduled_for, dispatched_at, started_at, finished_at, probe_pushed_at` | datetime, nullable | Časy; odoslaný probe, ktorý ešte nikto neprevzal, wake odošle znova. |

## workflow\_waits

| Stĺpec | Typ | Poznámky |
| --- | --- | --- |
| `instance_id / step_run_id` | key | FK, pri mazaní cascade. |
| `kind` | string(16) | WaitKind. |
| `due_at` | datetime, nullable | wwait\_due\_idx (status, due\_at). |
| `event_key` | string(191), nullable | wwait\_event\_idx (status, event\_key). |
| `match / condition / payload` | json, nullable | Párovanie udalosti, podmienka, doručený payload. |
| `outcome` | string(32), nullable | Výsledok časového limitu. |
| `status, claim_token, claimed_at, fired_at` | | WaitStatus a prevzatie. |

## workflow\_escalations

| Stĺpec | Typ | Poznámky |
| --- | --- | --- |
| `instance_id / step_run_id` | key | FK, pri mazaní cascade. |
| `level` | unsigned smallint | 1 = prvá. |
| `due_at` | datetime | wesc\_due\_idx (status, due\_at). |
| `actions` | json | — |
| `status, attempts` | string(16) / unsigned smallint | EscalationStatus a počet pokusov. |
| `claim_token, claimed_at, fired_at, cancelled_at, error_code, error_message` | | — |

## workflow\_idempotency\_keys

| Stĺpec | Typ | Poznámky |
| --- | --- | --- |
| `scope` | string(16) | start alebo effect. |
| `key` | char(64) | Odtlačok, nikdy pôvodný kľúč; jedinečný spolu so scope (widem\_unique). |
| `definition_id / instance_id` | key, nullable | FK (pri mazaní null / cascade). |
| `result` | json, nullable | Výsledok once(). |
| `expires_at` | datetime, nullable, indexed | Len kľúče spúšťačov (idempotency.ttl). |
| `created_at` | datetime | Bez mäkkého mazania. |

## workflow\_dry\_runs

| Stĺpec | Typ | Poznámky |
| --- | --- | --- |
| `definition_id / version_id` | key / key, nullable | FK (pri mazaní cascade / null). |
| `owner_*, subject_*, requester_*` | morphs, nullable | — |
| `input / result` | json | Vstup a DryRunResult. |
| `timestamps, deleted_at` | | Čistí sa po prune.dry\_runs\_after. |

workflow\_instances má aj winst\_overlay\_idx (version\_id, status, current\_node\_id) pre prehľad behov, winst\_rate\_idx (definition\_id, created\_at) pre limit spustení a winst\_status\_idx (status, updated\_at) pre kontrolu zaseknutých behov v doctor.

## Doba uchovania

workflows:prune (plánujte denne) natrvalo zmaže ukončené inštancie staršie než prune.instances\_after — nikdy nie tú s bežiacim dieťaťom — aj s ich krokmi, čakaniami, eskaláciami a kľúčmi efektov; vypršané kľúče spúšťačov; a záznamy skúšobných behov staršie než prune.dry\_runs\_after.

## Prejavte lásku k open source

Tento balík je zadarmo pod licenciou MIT. Ak vám šetrí čas, jednorazový príspevok alebo členstvo na Patreone nám pomôže ho ďalej udržiavať, testovať a dokumentovať.

[Ďalšie spôsoby podpory vrátane kryptomien](https://roundly-consulting.com/sk/podporte-nas.md)

Odoslaním daru súhlasíte s našimi [podmienkami prijímania darov](https://roundly-consulting.com/sk/podmienky-darov.md).

[Podporte našu open-source prácu (otvorí sa v novej karte)](https://donate.stripe.com/dRmeVe8FX5PF1Qd9pXcEw00) [Pridajte sa k nám na Patreone (otvorí sa v novej karte)](https://www.patreon.com/cw/roundly)

## Chcete to zabudovať do svojho produktu?

Naše balíky integrujeme do zákazkových Laravel a AI riešení. Napíšte nám, na čom pracujete, a ozveme sa do 48 hodín.

[Ponuka do 48 hodín](https://roundly-consulting.com/sk/kontakt.md) [Prezrieť všetky balíky](https://roundly-consulting.com/sk/open-source/navody/workflows-for-laravel.md)