Zverejnili sme vyše 50 Laravel balíkov ako open source

V júni sme písali o tom, prečo je open source v ére agentického kódovania dôležitejší než kedykoľvek predtým, a článok sme uzavreli prísľubom: na ceste je rozsiahly súbor open source práce pre Laravel ekosystém. Dnes je tu. Zverejňujeme vyše 50 Laravel balíkov, všetky zadarmo, pod licenciou MIT, na GitHube aj Packagiste a s kompletnou vývojárskou dokumentáciou v našom open source katalógu.

Pokrývajú základy, ktoré si takmer každá seriózna aplikácia skôr či neskôr stavia znova: médiá, e-commerce, správy, schvaľovanie, tímy, autentifikáciu, oprávnenia a infraštruktúru. Postavili sme ich, aby sme už nikdy nemuseli písať to isté odznova. Teraz nemusíte ani vy, ani váš AI agent.

Čo v nich nájdete

Balíky sú rozdelené do šiestich skupín. Každý názov nižšie otvorí jeho dokumentáciu:

• Obsah a médiá — Media Library, Posts, Translatable, Sluggable a QR.
• Commerce — Shops, Purchases, Money, Coupons, Credits, Advertisements a Trading Analytics.
• Sociálne a interakcie — Messages, Comments, Reviews, Likes, Contacts, Connections a Campaigns.
• Workflow a životný cyklus — Approvals, Requests, Appointments, Onboarding, Teams, Forms, Reports a Opening Hours.
• Dáta a modelovanie — Attributes, Options, Addresses, Enums, Metrics a Query Builder.
• Infraštruktúra — Passkeys, Two-Factor, Auth, Permissions, JWT, Refresh Tokens, Kubernetes API, Git, Certificates, Alerts a ďalších sedem.

AI tokeny míňajte na svoj produkt, nie na základy

Ak vyvíjate s Claude Code, Cursorom, Copilotom alebo iným AI agentom, každá funkcia má svoj účet za tokeny. Keď agenta požiadate, aby od nuly postavil schvaľovanie dvoma z troch ľudí, knižnicu médií alebo lajky s reakciami, musí navrhnúť schému, napísať modely a služby, napísať testy, spustiť ich, prečítať chyby a opraviť ich. Pri každom kole znova číta kód, ktorý práve napísal, takže účet rastie s každou iteráciou — a na konci aj tak máte nový, nikým neskontrolovaný kód, ktorý odteraz udržiavate vy.

S balíkom je tá istá funkcia jeden composer require, jeden či dva traity a pár riadkov konfigurácie. Agent si prečíta zdokumentovaný kontrakt namiesto toho, aby si ho vymýšľal, a svoj rozpočet minie na to, čo máte len vy: vašu doménovú logiku.

• Balíky v katalógu spolu obsahujú vyše 220 000 riadkov zdrojového kódu a 200 000 riadkov testov: zhruba 15 miliónov znakov, teda približne 3,7 milióna tokenov pri konzervatívnom odhade štyroch znakov na token — len na to, aby ich agent raz vygeneroval, ešte pred prvým spustením testov či opravou. To všetko váš agent preskočí.
• Samotný Approvals for Laravel má približne 4 300 riadkov zdrojového kódu a 3 200 riadkov testov. Použitie sú tri príkazy, tri traity a jedno volanie metódy.
• Zdokumentované a striktne typované API znamená menej chybných odhadov a každý chybný odhad stojí agenta ďalšie kolo.
• Tokeny sú viditeľná úspora, údržba je tá väčšia. Kód, ktorý nainštalujete, opravujeme my; kód, ktorý vygeneroval váš agent, opravujete natrvalo vy.

Základ navrhnutý od začiatku, nie kód vytiahnutý dodatočne

Väčšina open source vydaní je kód upratený dodatočne: pomocná trieda, ktorá vyrástla v jednom projekte, niekto ju vytiahol a zverejnil. Tieto balíky vznikli opačne. Od začiatku sme stavali vlastný základ, vrstvu, na ktorej stojí každý náš produkt aj klientsky systém, aby sa žiadny problém neriešil dvakrát. Zverejnenie bolo súčasťou plánu od prvého commitu a vidieť to na tom, čo dostanete:

• Jeden toolkit pod všetkými. Každý balík sa inicializuje cez ten istý Package Toolkit for Laravel a testuje sa tými istými testovacími nástrojmi. Keď pochopíte konfiguráciu jedného balíka, poznáte aj všetky ostatné.
• Vaša schéma, nie naša. Väčšina balíkov, ktoré pridávajú tabuľky, číta jediné nastavenie typu kľúča (bigint, UUID alebo ULID), takže zapadnú do modelov, ktoré už máte.
• Minimum závislostí. Za behu závisia len od oficiálnych komponentov Laravelu a Symfony a od nášho toolkitu. Pred inštaláciou nemusíte auditovať žiadny cudzí kód.
• Čitateľné pre ľudí aj agentov. Striktné typy, stabilné pomenovania a zdokumentované kontrakty: presne to, vďaka čomu AI agent použije balík správne na prvý pokus a nemusí hádať ani páliť tokeny na ďalšie pokusy.

Laťka kvality v číslach

V júni sme sľúbili produkčnú kvalitu, dôkladné testy a statickú analýzu. Takto to vyzerá v číslach naprieč všetkými balíkmi:

• Vyše 12 000 testov v Peste.
• Minimálne pokrytie testami aspoň 90 % pri každom balíku a pri jedenástich z nich 95 % a viac.
• Larastan (PHPStan) na úrovni 7 pri každom balíku.
• CI matica proti Laravelu 12 a 13 na PHP 8.4 a Pint, ktorý drží jednotný štýl kódu.
• Licencia MIT: môžete ich použiť v komerčných projektoch, forknúť aj ďalej šíriť.
• Dokumentácia rozdelená do sekcií pre každý balík, v angličtine aj slovenčine.

Vyskúšajte jeden za necelú minútu

Každý balík sa inštaluje rovnako. Takto vyzerá Approvals for Laravel, ktorý pridá schvaľovanie ľubovoľnému Eloquent modelu. Povedzme, že vydanie musia pred nasadením schváliť dvaja z troch ľudí (tech lead, QA a produktový manažér). Bez šablóny workflow, bez konfiguračného súboru:

composer require roundly-consulting/approvals-for-laravel

php artisan vendor:publish --tag="approvals-migrations"
php artisan migrate

use RoundlyConsulting\Approvals\Enums\ApprovalRule;
use RoundlyConsulting\Approvals\Traits\GivesApprovals;
use RoundlyConsulting\Approvals\Traits\HasApprovals;
use RoundlyConsulting\Approvals\Traits\RequiresApproval;

class User extends Model
{
    use GivesApprovals;                   // môže schvaľovať a zamietať
}

class Release extends Model
{
    use HasApprovals, RequiresApproval;   // potrebuje schválenie
}

// schválené pri 2 z 3; dve zamietnutia ho zamietnu
$release->requestApproval([$lead, $qa, $pm], ApprovalRule::Quorum, quorum: 2);

$lead->approve($release, 'Changelog skontrolovaný');
$release->isPendingApproval();   // true — 1 z 2

$qa->approve($release);
$release->isApproved();          // true — kvórum dosiahnuté, $pm nemusel nič robiť

To je celé nastavenie a zároveň všetko, čo musí váš agent napísať. Za týmito riadkami je engine pravidiel, história rozhodnutí aj s dôvodmi, udalosti a expirácia. Kvórum je jedno zo štyroch pravidiel (jednomyseľné, kvórum, ktokoľvek a vážené), a keď sa rovnaké nastavenie v aplikácii opakuje, dokumentácia Approvals ukazuje, ako ho raz pomenovať ako šablónu workflow alebo rozdeliť na postupné fázy. Od každého ďalšieho balíka vás delí len jeden composer require.

Zadarmo natrvalo, a prečo prosíme o podporu

Každý balík zostáva zadarmo pod licenciou MIT. Neexistuje platená edícia ani zadržiavané funkcie. Zverejniť kód je však tá ľahšia časť. Skutočné náklady prichádzajú po vydaní: držať krok s každou verziou Laravelu a PHP, rýchlo opravovať bezpečnostné chyby, odpovedať na hlásenia, udržiavať 12 000 testov zelených a dokumentáciu každého balíka v súlade s kódom. Je to trvalá práca a presne tú platí vaša podpora:

• Údržba a bezpečnosť — bezpečnostné opravy v označených vydaniach, aktualizácie na nové verzie Laravelu hneď, ako vyjdú, aktualizácie závislostí a triedenie hlásení.
• Nové balíky — katalóg sa ďalej rozrastá. Týmto vydaním začína, nekončí.

Prispieť môžete tromi spôsobmi:

• Členstvom na Patreone. Pravidelná podpora má najväčšiu hodnotu, pretože nám umožňuje plánovať údržbu mesiace dopredu namiesto vtesnávania medzi klientske projekty.
• Jednorazovým príspevkom cez zabezpečenú platobnú bránu Stripe. Nepotrebujete žiadny účet.
• Kryptomenami: BTC, ETH, BNB alebo SOL. Adresy nájdete na našej stránke podpory.

Nemáte rozpočet? Pomôcť môžete aj tak

• Dajte repozitárom hviezdičku na GitHube. Podľa hviezdičiek balíky nachádzajú ďalší vývojári.
• Otvárajte issues a pull requesty. Hlásenie chyby spolu s padajúcim testom je pre správcu to najlepšie, čo môže dostať.
• Pošlite tento článok Laravel vývojárovi, ktorý sa práve chystá písať vlastné schvaľovanie.
• Napíšte nám, čo máme postaviť ďalej. Najžiadanejšie nápady idú na začiatok zoznamu.

Rovnaký základ vo vašom produkte

Tieto balíky sú naším každodenným spôsobom práce. Rovnaké základy nesú webové aplikácie aj AI agentov, ktorých staviame pre klientov, a preto dodávame rýchlo bez skratiek na úkor kvality. Ak by ste niektorý z nich radšej mali zabudovaný do svojho produktu, než ho zapájať sami, napíšte nám, čo potrebujete, a do 48 hodín dostanete konkrétny návrh.