Rizmajer Máté Levente

A legkisebb szerkezet, ami elbírja a feladatot. Absztrakciót akkor vezetek be, amikor a második hívó megjelenik — előtte az interfész, amit egyetlen implementáció használ, nem absztrakció, csak egy plusz fájl.

• Egy tény egy helyen él, és minden más onnan olvassa. Ez az oldal a saját kárán tanulta meg: a projektek száma négy fájlban élt párhuzamosan, amíg az egyik hamis állítássá nem avult.
• A megosztott döntések — mozgási időzítések, útvonalak, színtokenek, kétnyelvű szövegek — külön modulban vannak, hogy ne tudjanak észrevétlenül szétcsúszni.

Komponens felelősségenként, a megosztott viselkedés hookban. Az állapot ott él, ahol használják, és amit ki lehet számolni, azt nem tárolom: a nyelv például az URL-ből következik, nem egy state-ből.

• Minden aszinkron ághoz tartozik betöltési, hiba- és üres állapot, nem csak a sikeres út. Az üres állapot is szöveg, nem egy kihagyott doboz.
• Az akadálymentesség nem utólagos réteg: látható fókuszjelzés minden interaktív elemen, mért kontraszt a becsült helyett, és statikus oldal reduced-motion beállítás alatt.
• A reszponzív munka a telefonnál kezdődik, mert a látogatók nagyobb része onnan érkezik — nem a széles nézetnél, amit a fejlesztő lát maga előtt.

Erőforrás szerint szervezett REST végpontok, kiszámítható státuszkódokkal, és olyan hibaválaszokkal, amiknek ugyanaz az alakja, mint a sikereseknek — így a kliensnek nem kell kétféleképpen olvasnia ugyanazt a hívást.

• A validáció a szerveren is lefut. A böngészőben végzett ellenőrzés kényelem a felhasználónak, nem védelem a rendszernek.
• Az authentikáció és a jogosultság két külön kérdés — ki vagy, és mihez férhetsz hozzá. Egyetlen szerepkör-mezőbe összevonva a második kérdésre soha nem lehet pontosan válaszolni.
• A séma megválasztása döntés, nem szokás: kötött szerkezetű adatnál relációs, változó alakúnál dokumentum-alapú. A változások migrációban mennek, hogy visszakövethetők legyenek.

A minőség nem egy fázis a végén. Lint és teszt minden változtatás után, és maga a build is kapu: ha egy állítás nem teljesül, nincs kimenet.

• A tesztek a viselkedést rögzítik, nem az implementációt. Különben minden refaktor teszthibaként jelentkezik, és a készlet akadállyá válik ahelyett, hogy védőháló lenne.
• A néma hiba a drága. Ahol választani lehet a hangos leállás és a csendes visszaesés között, a leállást választom — a fordítási segédfüggvény például hibát dob a hiányzó szövegre ahelyett, hogy magyarra esne vissza egy angol oldalon.

Az élesítés nem a munka vége, hanem az a pont, ahol a korábbi döntések láthatóvá válnak. Amit nem lehet visszaállítani vagy megmérni, azt nem tekintem késznek.

• Security headerek és tartalombiztonsági irányelv, hogy ne csak a kód korlátozza, mi futhat az oldalon, hanem a böngésző is.
• A crawler kész HTML-t kap, nem egy üres elemet, amit majd a JavaScript tölt fel. A keresőoptimalizálás így szerkezeti kérdés, nem kulcsszavaké.
• A konfiguráció környezeti változóban él, nem a kódban, és a titkok soha nem kerülnek a böngészőbe.