Cum lucrez, arătat pe un proiect real
Oricine poate promite că lucrează atent. Așa a arătat când am făcut upgrade unui sistem de comenzi aflat în producție, pe care o firmă funcționează în fiecare zi, de la CakePHP 3.6 pe PHP 7.4 la CakePHP 5.4 pe PHP 8.5.
Șase reguli după care lucrez
Mai întâi o plasă de siguranță
Înainte să schimb o linie, scriu teste automate care înregistrează cum se comportă sistemul dumneavoastră azi. Fiecare pas merge mai departe doar dacă testele trec în continuare.
Dovedesc că nu s-a schimbat nimic
Vechiul și noul se compară pe date reale: PDF-uri, exporturi, importuri, totaluri. „Pare că merge” nu este un test.
Repar ce găsesc
Dacă dau peste o breșă de securitate sau un bug vechi, nu trec pe lângă doar pentru că nu era în ofertă. Îl repar și vă spun.
Producția este sfântă
Mai întâi staging, lansare în afara programului de lucru, un plan scris de revenire și o copie a bazei de date făcută chiar înainte de trecere.
Rămân cu ochii pe sistem după lansare
După o actualizare majoră citesc chiar eu jurnalele, zile la rând. Problemele sunt rezolvate înainte ca dumneavoastră sau utilizatorii dumneavoastră să aflați că au existat.
Sun înainte să se strice
Când ceva vă amenință sistemul, aflați de la mine primul, împreună cu ce am făcut deja în privința asta.
Proiectul
O firmă olandeză de e-commerce își desfășoară toată activitatea pe un sistem propriu de gestionare a comenzilor: comenzile din magazinul online intră prin webhook, biroul se ocupă de comenzi și oferte, depozitul gestionează stocul, iar curierii își planifică și parcurg rutele de pe telefon. Sistemul rula pe CakePHP 3.6 și PHP 7.4, ambele fără actualizări de securitate de ani de zile.
Înainte de upgrade: sistemul a rămas pornit când alții și-au oprit site-urile
Chiar înainte de upgrade a fost publicată o vulnerabilitate critică de PHP, care afecta serverele rămase pe versiuni vechi, iar pentru PHP 7.4 nu exista în acel moment nicio remediere. O reacție frecventă a fost oprirea site-urilor afectate până puteau fi reparate.
Pentru această firmă, oprit înseamnă fără comenzi, fără rute și fără livrări. Așa că am sunat clientul înainte să afle din altă parte și am pus un lacăt temporar în fața sistemului: angajații se autentificau cu o parolă în plus, iar comenzile mai puteau fi livrate doar din rețeaua platformei magazinului online. Firma a lucrat mai departe și nu s-a pierdut nicio comandă.
Asta a câștigat timpul necesar pentru rezolvarea adevărată, făcută cum trebuie: upgrade-ul de mai jos. Lacătul a fost scos după ce noua versiune a intrat în producție.
O plasă de siguranță înainte să mă ating de cod
Primele teste au fost scrise și rulate pe versiunea veche, ca să fixeze cum se comporta sistemul cu adevărat: webhook-ul de comenzi, ecranele de administrare, PDF-urile, exporturile Excel, stocul și rezervările. Suita a crescut cu fiecare pas.
- O bază de date de test separată, cu structura din producție, dar cu comenzi și clienți fictivi
- Webhook-ul de comenzi testat câmp cu câmp, inclusiv duplicatele și eșecurile
- Fluxuri complete: comandă prin webhook → rezervare de stoc → curier → rută → livrat
- Drepturile pe fiecare rol, fiecare job programat, fiecare export
Upgrade în pași, nu dintr-un singur salt
CakePHP 3.6 → 4.6 → 5.4 și PHP 7.4 → 8.4 → 8.5. Fiecare pas a mers mai departe doar când aceleași teste treceau în continuare.
- Fiecare bibliotecă actualizată; cele abandonate au fost înlocuite cu unele întreținute sau cu puțin cod scris de mine
- Autentificarea refăcută pe noua bibliotecă, cu parolele existente păstrate valabile
- 144 de șabloane de ecran, 13 comenzi programate și 5 pluginuri proprii portate
- 223 de reguli de validare rescrise de mână
- Analiza statică (PHPStan) și verificările de stil de cod, fără erori
- Frontend-ul lăsat intenționat neatins, ca fiecare ecran să arate și să funcționeze la fel
Dovada că nu s-a schimbat nimic
Pe staging, cu o copie proaspătă a datelor din producție, vechiul și noul au fost puse față în față:
- PDF-urile pentru comenzi, oferte, rute și etichete: text identic
- Un import real de comandă din magazinul online: 56 de câmpuri identice
- Sincronizarea prețurilor de la furnizor: 618 produse identice
- Contoarele de stoc ale tuturor celor 1.535 de produse, totalurile din dashboard și din statistici
- Toate cele 189 de pagini din meniu deschise, toate cele 31 de filtre salvate numărate față de baza de date
- Autentificare cu fiecare rol și clic pe fiecare link din meniu, plus o zi de testare făcută de client
Lansare noaptea, cu drum de întoarcere
Mai întâi a trecut staging-ul. Producția a fost comutată într-o zi de luni, la 23:34, după un plan de lansare scris, cu o copie completă a bazei de date făcută cu cinci minute înainte și cu versiunea veche pregătită pentru restaurare. A doua zi dimineață utilizatorii au trebuit doar să se autentifice încă o dată.
Trei zile mai târziu, serverul a trecut de la PHP 8.4 la PHP 8.5 în mijlocul unei zile de lucru. Biroul a salvat comenzi în continuare în timp ce se întâmpla.
Rămân cu ochii pe sistem și repar înainte să afle cineva
Nu mă opresc la lansare. În prima săptămână am citit jurnalele la fiecare 30 de minute: cine lucra, dacă cineva a primit o eroare, dacă au trecut comenzile și job-urile de noapte.
Așa au apărut trei probleme. Fiecare a fost reparată, acoperită cu un test nou, încercată pe staging și pusă în producție în aceeași zi, înainte ca un utilizator să dea peste ea. Una era un avertisment dintr-un fișier de jurnal, pe care nimeni nu l-ar fi văzut vreodată pe ecran. Clientul a aflat de ele de la mine, din raport, ca lucruri deja rezolvate.
După acea săptămână preia monitorizarea: sistemul îmi trimite un e-mail când o integrare nu mai funcționează și încă unul când își revine.
Ce am reparat fără să-mi ceară nimeni
Lucrarea era „upgrade de framework”. Cine citește fiecare fișier al unui sistem vede ce nu este în regulă cu el. Nimic din toate acestea nu era în ofertă și toate au fost reparate.
Breșe de securitate
- Hash-urile parolelor erau trimise în browser de către tabelele de date
- Filtrele de căutare rulau ca SQL brut venit din browser: oricine era autentificat putea citi sau modifica orice date
- XSS stocat prin filtrele salvate și partajate
- Nicio protecție CSRF pe formulare și butoane
- Paginile puteau fi deschise prin URL fără dreptul de a le vedea
- Webhook-ul de comenzi accepta apeluri de la oricine, iar jurnalul lui păstra date ale clienților
- O încărcare de fișiere prin care se putea pune un script pe server
- O cheie de API care ajungea în exporturile Excel
Bug-uri care erau acolo de ani de zile
- Același webhook sosit de două ori crea comanda de două ori sau rezerva stocul de două ori. Acum este blocat chiar de baza de date
- Ștergerea unei setări putea șterge pe nesimțite toate comenzile care o foloseau
- Prețurile de curierat își pierdeau zecimalele: 9,99 devenea 10
- Mesajele de succes și de eroare nu mai erau afișate de la un upgrade mai vechi, lăsat pe jumătate
- Din exporturile Excel lipseau coloanele de dată
- Exporturile foarte mari blocau serverul
- Mai multe pagini care erau stricate de ani de zile funcționează din nou
Ca să nu se mai întâmple
- API-ul unui furnizor fusese odată căzut două luni fără să observe nimeni. Acum este verificat la fiecare 30 de minute, cu un e-mail când pică și când își revine
- O sincronizare care nu primește nimic contează acum ca eșec, nu ca „nu s-a schimbat nimic”
- Mediul de staging nu poate trimite niciodată e-mailuri către clienți reali
- Drepturile urmează regula „interzis dacă nu este permis”, verificate rol cu rol față de situația veche: 0 diferențe
- Avertismentele de depreciere au fost curățate, așa că următorul upgrade va fi unul mic
Code review la preț fix: €950
Nu știți sigur în ce stare este sistemul dumneavoastră sau ce ar presupune un upgrade? Citesc codul și vă spun, în scris, înainte să vă angajați la ceva mai mare.
- Citesc codul și dependențele unei aplicații
- Un raport scris pe înțelesul tuturor: ce este depășit, ce este riscant și ce este în regulă
- Problemele de securitate găsite, ordonate după urgență
- Un plan pas cu pas pentru upgrade sau reparație, cu ofertă la preț fix
- O discuție în care vă explic raportul
Dacă comandați lucrarea din raport, cei €950 se scad din acea factură.
Sistemul dumneavoastră este foarte mare? Atunci vă spun înainte să încep, nu după.