Predvoľby workflowov

Opakovane používajte nastavenie pravidla, kvóra a stupňov z config('approvals.workflows'):

// config/approvals.php
'workflows' => [
    'payout' => ['rule' => 'quorum', 'quorum' => 2, 'required_approvers' => 3],
    'release' => ['stages' => [
        ['rule' => 'unanimous', 'required_approvers' => 2, 'name' => 'engineering'],
        ['rule' => 'any', 'required_approvers' => 1, 'name' => 'product'],
    ]],
],

Žiadosť potom otvoríte podľa názvu predvoľby:

// Flat preset — supply the approvers:
Requests::make()->workflow('payout')->requireApprovalsFrom([$a, $b, $c])->create();

// Staged preset — one approver group per stage:
Requests::make()->workflow('release')->stageApprovers([[$eng1, $eng2], [$product]])->create();

• Jednoduché predvoľby použijú modely schvaľovateľov odovzdané cez requireApprovalsFrom(); samotné id sa odmietne výnimkou InvalidApprover.
• Viacstupňové predvoľby dostanú jednu skupinu schvaľovateľov na stupeň cez stageApprovers().
• Workflow má prednosť pred stages() aj pred jednoduchým zoznamom schvaľovateľov.
• Pri viacstupňových predvoľbách platí reject_on_stage_rejection z predvoľby, nie rejectOnStageRejection() z buildera.
• Neznáma alebo chybná predvoľba vyhodí výnimku enginu UnknownWorkflowException.

Expirácia predvoľby a termín žiadosti

Kolo z predvoľby vyprší spolu so žiadosťou: expires_at žiadosti (z expiresAt() alebo default_ttl) nahradí pre toto kolo vlastné expiry predvoľby, a to pre každý stupeň viacstupňovej predvoľby — pri vytvorení aj pri novom kole, ktoré otvorí reopen(). Žiadosť bez termínu si ponechá expiry predvoľby, prípadne žiadne:

// 'payout' => [..., 'expiry' => 3600]
Requests::make()->workflow('payout')->requireApprovalsFrom([$a])->expiresAt(now()->addDays(7))->create(); // round expires in 7 days
Requests::make()->workflow('payout')->requireApprovalsFrom([$a])->create();                               // no deadline: round expires in 1 hour

Kľúče predvoľby