Logo HuTor Tech HuTor Tech
← Všetky články

· hutor.tech

Ako prevziať existujúci projekt v Laraveli

Ako prevziať existujúci projekt v Laraveli

Prevziať cudziu aplikáciu v Laraveli znamená predovšetkým znižovať neistotu. Kód je známa veličina — dá sa prečítať. Čo prečítať nejde, je nasadenie, úlohy v cron-e, workery frontu a tri premenné prostredia, o ktorých vedel iba predchádzajúci vývojár. Naše preberanie projektu sa začína práve tam, nie v editore.

Pýtajte si prístupy skôr než čokoľvek iné. Odovzdanie je hotové vtedy, keď máte repozitár, server (SSH aj panel), databázu, DNS a registrátora domény, účty poštového a platobného poskytovateľa a kľúče k API tretích strán. Chýbajúce prístupy sú najčastejší dôvod, prečo preberanie uviazne na týždne, a zbierajú sa oveľa ľahšie, kým predchádzajúci tím ešte odpovedá na správy.

Rozbehnite projekt lokálne hneď prvý deň. Klon, `composer install`, kópia `.env`, vygenerovanie kľúča, import dumpu databázy, migrácie. Každý krok, ktorý zlyhá, je nález: nezdokumentované rozšírenie PHP, balík zo súkromného repozitára, migrácia, ktorá nikdy nebežala v správnom poradí. Zapisujte tieto zlyhania priebežne — ten zoznam je prvý úprimný popis stavu projektu.

Potom čítajte tie najnudnejšie súbory:
— `composer.json` a `composer.lock`: verzia frameworku, opustené balíky, ako ďaleko ste za vydaním;
— `.env.example` oproti produkčnému `.env`: ktoré kľúče sú skutočné a ktoré dekoratívne;
— `routes/` a middleware: skutočný povrch aplikácie;
— priečinok migrácií: či je schéma vôbec popísaná migráciami, alebo žije len v databáze.

Preverte, čo beží mimo cyklu požiadavky. Naplánované príkazy v `routes/console.php`, workery frontu, konfigurácie supervisora, zálohovacie skripty, webhooky platobných brán. Práve tu zdedené aplikácie skrývajú prekvapenia a práve tu môže tichá chyba zostať nepovšimnutá celé mesiace.

Prvý týždeň nerefaktorujte. Opravte nasadenie, postavte testovaciu kópiu, pripojte sledovanie chýb a zálohu, ktorú ste aspoň raz obnovili. Až potom sa dotýkajte kódu — malými commitmi a s testom okolo všetkého, čo meníte. Dôveru klienta buduje fungujúce nasadenie a predvídateľné vydania, nie prepis odznova.

Preberanie uzavrite písomnou mapou: ako sa nasadzuje, kde sú logy, čo robí cron, ktoré časti kódu sú krehké a čoho sa chytiť ako prvého. Ak predchádzajúci tím takýto dokument nezanechal — a spravidla nezanechá —, práve ste vytvorili artefakt, vďaka ktorému bude ďalšie odovzdanie lacné.