Agencija i posao
CTORevizija kodaTehnička dubinska analizaNext.jsReactFlutterCI/CDSigurnostObservability

CTO kontrolna lista: kako procijeniti Next.js, React i Flutter codebase prije nego preuzmete odgovornost

AO
Adrijan Omićević
·18 min čitanja

# Što ovaj vodič pokriva#

Primopredaja codebasea rijetko je samo pitanje kvalitete koda. Radi se o operativnom kontinuitetu: može li vaš novi tim sigurno isporučivati, brzo debugirati produkcijske probleme i proći osnovnu sigurnosnu provjeru bez neugodnih iznenađenja.

Ova CTO kontrolna lista za primopredaju codebasea napravljena je za proizvode s Next.js ili React na web strani, Flutter na mobilnoj strani te tipičnom kombinacijom third-party API-ja, cloud servisa i CI pipelineova. Uključuje konkretne kriterije prihvata, crvene zastavice koje bi trebale potaknuti eskalaciju i “quick wins” koje možete implementirati u prvih 30 dana.

Ako trebate širi okvir dubinske analize preko legacy sustava, krenite s našim detaljnijim playbookom: tehnička dubinska analiza za agencije i audit legacy koda.

# Kako provesti ovaj audit u 1 tjednu#

Audit tretirajte kao trijažu. Cilj nije refaktorirati sve, nego identificirati rizik, kvantificirati ga i uspostaviti kontrolu.

Praktičan ritam koji radi za većinu timova:

DanFokusRezultat
1Pristup i ponovljivi buildoviBuild i run potvrđeni lokalno i u CI-ju, inventar okruženja i tajni
2Arhitektura i ovisnostiMapa sustava, granice modula, lista rizika ovisnosti
3Sigurnost i rukovanje podacimaThreat hotspotovi, stanje tajni, problemi na OWASP razini
4Testiranje i pouzdanost izdanjaProcjena test strategije, popis flaky testova, rupe u coverageu
5Observability i spremnost za on-callStatus logova, metrika i tracinga, rupe u runbookovima
6 do 7KonsolidacijaRegistar rizika, plan za 30 dana, briefing za dionike

ℹ️ Napomena: U Google Cloud anketi iz 2024., više od polovice developera navelo je da značajno vrijeme troše na debugiranje produkcijskih problema u odnosu na izradu novih funkcionalnosti. Najbrži način da nakon primopredaje smanjite taj “porez” jest osigurati da možete reproducirati buildove i vidjeti što se događa u produkciji.

# Pregled kontrolne liste audita s kriterijima prihvata#

Koristite ovu tablicu kao glavni scorecard. Svaka kategorija ima minimalno prihvatljivo stanje koje možete provjeriti unutar nekoliko sati.

PodručjeMinimalni kriteriji prihvata za primopredajuTipični dokazi
ArhitekturaJasne granice modula, mapa vlasništva, bez skrivenog spajanja s infrastrukturomDijagram visoke razine, folder konvencije, ADR-ovi
SigurnostNema hardcodiranih tajni, skeniranje ovisnosti je postavljeno, osnovni headeri i auth flowovi su provjereniKorištenje secret managera, SCA izvještaji, sigurnosna kontrolna lista
TestiranjeCI pokreće unit testove, postoje smoke testovi, flaky testovi se prateCI logovi, test reportovi, sažetak coveragea
ObservabilityCentralizirani logovi, praćenje grešaka, postoje osnovni SLO-ovi ili alertiDashboardi, alert pravila, runbookovi
CI/CD“One-button” build i deploy po okruženju, rollback dokumentiranPipeline konfiguracija, release notes, tagovi
DokumentacijaSetup, arhitektura, runbookovi i API ugovori dokumentiraniREADME, runbookovi, API schema dokumenti

# 1) Audit arhitekture za Next.js, React i Flutter#

Arhitekturni problemi su skupi nakon primopredaje jer novi timovi tjednima uče gdje se logika nalazi i zašto promjene lome nepovezane funkcionalnosti. Cilj je potvrditi da granice postoje i da se provode.

Što provjeriti#

StavkaKriteriji prihvataKako brzo provjeriti
Granice modulaUI, domain i data slojevi su odvojeni i konzistentniPregled foldera i importa, provjera circular deps
Mapa vlasništvaMožete dodijeliti jasno vlasništvo po modulu ili featureuCodeowners datoteka ili dokumentirano vlasništvo
Izolacija okruženjaDev, staging, prod imaju eksplicitne konfiguracije.env.* politika, config dokumenti, CI env varovi
Spajanje s vanjskim servisimaIntegracije su iza adaptera ili service slojevaPretraga direktnog SDK korištenja kroz UI
Upravljanje stanjemJedan primarni pristup stanju, ne više konkurentskih obrazacaReact: Context ili Redux ili Zustand, Flutter: Riverpod ili Bloc, ne sve odjednom

Next.js i React specifične provjere#

  • Strategija routinga je eksplicitna: App Router naspram Pages Router je jasno, ne miješa se.
  • Obrasci dohvaćanja podataka su konzistentni: server actions, route handlers i client fetching imaju dokumentirano pravilo.
  • Način renderiranja je namjeran: SSR, SSG, ISR i client-only se koriste s razlogom, ne nasumično.

Konkretni kriteriji prihvata koje možete primijeniti:

TemaKriteriji prihvata
Granice server-clientNema osjetljivih tokena ili tajni u client bundleovima, server-only moduli su enforced
API slojSvi API pozivi idu kroz jednog klijenta s tipiziranim odgovorima i error handlingom
PerformanseNajveće stranice zadovoljavaju mjerljiv budžet, npr. ispod 200 kilobajta JS-a po ruti u prosjeku
Monorepo “zdrav razum”Ako koristite monorepo, paketi imaju jasan smjer ovisnosti i build caching

Flutter specifične provjere#

  • Slojevi aplikacije postoje: vidljiva je podjela na presentation, domain i data.
  • Networking je centraliziran: nema razbacanih HTTP poziva iz widgeta.
  • Build flavori su postavljeni: konfigurirani su dev, staging, production flavori.
  • Permissions i platform kod su pregledani: Android manifest i iOS entitlements odgovaraju potrebama proizvoda.

Kriteriji prihvata koji sprječavaju bolne mobilne regresije:

TemaKriteriji prihvata
Ažuriranja ovisnostipubspec.lock je commitan, ograničenja ovisnosti su razumna
Build pipelineCI proizvodi signane artefakte ili barem ponovljive buildove
Crash reportingCrashlytics ili ekvivalent je uključen, s uploadanim simbolima
Feature flagoviVisokorizične funkcije se mogu togglati bez punog redeploya

Crvene zastavice u arhitekturi#

Crvena zastavicaZašto je bitnoTipičan simptom
Poslovna logika u UI komponentamaPromjene postaju rizične i netestabilneReact komponente od 1.000 linija, teška logika u widgetima
Direktan DB pristup iz API ruta bez data slojaProblemi sigurnosti i konzistentnostiRaw queryji u mnogim route handlerima
Više frameworka za state managementKognitivno opterećenje i bugoviRedux plus MobX plus ad hoc Context
Nema definiranog API ugovoraIntegracije pucaju bez upozorenjaFrontend “pogađa” payloadove backenda

🎯 Ključna poruka: Arhitektura spremna za primopredaju nije “savršeno čista”. Ona je predvidiva: svaki feature slijedi iste obrasce kako bi novi inženjeri mogli sigurno isporučivati već u prvom tjednu.

# 2) Sigurnosna kontrolna lista audita s konkretnim kriterijima#

Sigurnost tijekom primopredaje znači minimizirati nepoznanice: gdje podaci prolaze, gdje se čuvaju tajne i kako se provode autentikacija i autorizacija. Za detaljniju listu koristite naš zaseban vodič: kontrolna lista sigurnosti web aplikacija.

Sigurnosna baseline kontrolna lista#

KontrolaKriteriji prihvataDokaz
Upravljanje tajnamaNema tajni u repozitoriju, tajne u vaultu ili platform secret storeuSecret scan izvještaj, CI detekcija tajni
Higijena ovisnostiAutomatizirano skeniranje ovisnosti, kritični CVE-ovi trijažiraniIzlaz SCA alata, Dependabot PR-ovi
AuthAuth je centraliziran, pohrana tokena je sigurnaStrategija session cookieja, secure storage na mobilnom
AutorizacijaProvjere uloga enforced na serveru, ne samo u UI-juAPI middleware, route guardovi
Validacija inputaServer validira inpute, client validacija se ne smatra pouzdanomSchema validacija, DTO-i
Sigurnost transportaHTTPS enforced, HSTS uključen gdje je primjenjivoProvjera headera, platform konfiguracija
Privatnost podatakaPostoji mapa PII podataka, pravila zadržavanja dokumentiranaData inventar, GDPR bilješke

Next.js i React sigurnosne kritične točke#

  • Server Actions i Route Handlers: provjerite autorizaciju na svakoj putanji koja radi mutacije.
  • Cookies i sesije: osigurajte da su cookieji HttpOnly, Secure i SameSite usklađeni s vašim auth modelom.
  • CORS: osigurajte da nije postavljen wildcard za autentificirane endpointove.
  • Source mapovi: potvrdite da su production source mapovi kontrolirani kako ne bi curio kod.

Flutter sigurnosne kritične točke#

  • Pohrana tokena: koristite platform secure storage, ne shared preferences.
  • Certificate pinning: nije uvijek nužan, ali odluka mora biti dokumentirana.
  • Deep linkovi: validirajte inpute i izbjegavajte slanje tajni kroz URL-ove.
  • Jailbreak ili root provjere: ako su potrebne radi compliancea, potvrdite implementaciju i očekivanja oko otpornosti na zaobilaženje.

⚠️ Upozorenje: Najčešći sigurnosni incident nakon primopredaje nije exploit. To je slučajno curenje: tajne u .env, admin vjerodajnice u dijeljenim dokumentima ili build pipeline koji ispisuje tokene u logove.

Sigurnosne crvene zastavice#

Crvena zastavicaUtjecajŠto odmah napraviti
Hardcodirani API ključevi ili privatni ključeviTrenutni rizik kompromitacijeRotirajte ključeve, uklonite iz povijesti ako je potrebno
Nema jasnog vlasništva nad authomPromjene lome login ili izlažu podatkeUspostavite auth ADR i testove
Admin funkcije ograničene samo UI-jemMoguć neautoriziran pristupEnforce server-side autorizaciju
Nepatchani kritični CVE-oviPoznati putovi exploitacijePatchajte ili izolirajte preko WAF-a i nadogradnji

# 3) Audit testiranja: povjerenje, brzina i flaky testovi#

Testni skup vrijedi samo ako je dovoljno brz da se pokreće konzistentno i dovoljno pouzdan da mu se vjeruje. Nakon primopredaje timovi često otkriju da testovi postoje, ali se ignoriraju jer su spori ili flaky.

Što mjeriti#

MetrikaCiljani kriteriji prihvataZašto je bitno
Trajanje testova u CI-juIspod 15 minuta za osnovne provjereSprječava zaobilaženje CI-ja
Flaky testoviManje od 2 posto izvršavanja pada zbog flakeaOdržava povjerenje u testove
CoveragePokriveni kritični dijelovi, ne “blanket” ciljeviFokusira trud gdje je rizik najveći
Smoke testoviBarem jedan po kritičnom korisničkom putovanjuBrzo hvata slomljene deploye

Kako izgleda “dovoljno dobro” po stacku#

StackMinimalni testovi za sigurnu primopredaju
Next.js ili ReactUnit testovi za poslovnu logiku, integracijski testovi za API klijent, 1 do 3 e2e flowa
FlutterUnit testovi za domain, widget testovi za ključne ekrane, barem 1 integracijski flow
Shared backend API-jiContract testovi ili schema validacija, testirane auth provjere

Praktična provjera: možete li pokrenuti cijeli testni skup lokalno jednom naredbom.

Bash
# Web
npm ci
npm test
 
# Flutter
flutter pub get
flutter test

Ako ovo ne prolazi na “čistoj” mašini, primopredaja nije dovršena.

Crvene zastavice u testiranju#

Crvena zastavicaZašto je bitno
Testovi ovise o produkcijskim podacima ili live API-jimaRizično, neponovljivo i sporo
Nema e2e testovaRegresije nakon deploya postaju incidenti za korisnike
Dominiraju snapshot testoviLako se “slijepo” updateaju, nizak signal
Flaky testovi se prihvaćaju kao normalniInženjeri prestaju vjerovati CI-ju

# 4) Observability audit: možete li debugirati produkciju u 15 minuta#

Tijekom tranzicije rizik incidenta raste jer nedostaje kontekst. Observability smanjuje ovisnost o “tribal knowledgeu”. Koristite naš detaljni blueprint: vodič za observability web aplikacija: logovi, metrike i tracing.

Observability kontrolna lista s kriterijima prihvata#

SlojKriteriji prihvataPrimjeri alata
LogiranjeStrukturirani logovi s request ID-jevima, PII scrubbanOpenTelemetry logging, platform logovi
GreškeError tracking s taggingom po izdanjuSentry, Crashlytics
MetrikeKljučne RED metrike za API-je, performance metrike za webPrometheus, Datadog
TracingTrace sampling konfiguriran, spanovi oko vanjskih pozivaOpenTelemetry tracing
AlertingAlerti vezani uz metrike utjecaja na korisnike, ne “buku”SLO-based alerting
RunbookoviSvaki alert linka na runbookMarkdown dokumenti u repozitoriju

Konkretne stvari za provjeriti u Next.js i React#

  • Svaka putanja API requesta uključuje correlation ID i logira ga.
  • Client greške su grupirane po verziji izdanja, ne samo po stack traceu.
  • Web vitals tracking je uključen za ključne rute ako je performansa proizvodni zahtjev.

Konkretne stvari za provjeriti u Flutteru#

  • Crash reporting je konfiguriran i za iOS i za Android.
  • Symbol datoteke su uploadane kako bi stack traceovi bili čitljivi.
  • Network failureovi se hvataju s kontekstom endpointa, bez curenja tokena.

Primjer: minimalni oblik strukturiranog loga koji biste trebali očekivati.

JSON
{
  "level": "info",
  "event": "payment_intent_created",
  "requestId": "req_123",
  "userId": "u_456",
  "durationMs": 182,
  "release": "web-2026.11.3"
}

Observability crvene zastavice#

Crvena zastavicaUtjecajHitna korekcija
Nema error trackingaIncidente otkrivaju korisniciDodajte Sentry ili ekvivalent u prvom tjednu
Logovi nisu strukturiraniPretraga postaje spora i netočnaUvedite JSON logove i standardnu shemu
Nema release markeraNe možete povezati deploye s incidentimaTagirajte izdanja i deploye svugdje
Alerti bazirani samo na CPU-uPromašuje kvarove koji utječu na korisnikeDodajte alerte za error rate i latenciju

💡 Savjet: Najbrži dobitak za novog CTO-a je dodati release tagging kroz web, backend i mobile. To pretvara “nešto se pokvarilo” u “pokvarilo se nakon izdanja X” i može značajno smanjiti vrijeme do dijagnoze incidenta.

# 5) CI/CD audit: ponovljivost, brzina i rollback#

Ako ne možete pouzdano buildati i deployati, ne posjedujete proizvod. Kvaliteta CI/CD-a određuje koliko brzo novi tim može isporučivati bez straha.

CI/CD kontrolna lista s kriterijima prihvata#

KontrolaKriteriji prihvataDokaz
Ponovljivost buildaClean checkout builda bez manualnih korakaCI build logovi, dokumentirane naredbe
OkruženjaDev, staging, prod postoje s jasnim promotion putemPipeline stageovi, deployment dokumentacija
Tajne u CI-juU CI secret storeu, nikad ne ispisuju seReview CI konfiguracije
RollbackRollback je dokumentiran i testiranRunbook, release strategija
Verzije izdanjaSemantičke verzije ili build brojevi su konzistentniGit tagovi, changelog
Mobile signingSigning ključevi se sigurno upravljajuCI tajne, Apple i Google konfiguracija

Praktična očekivanja od pipelinea#

  • Web treba proizvesti deterministički artefakt, ne “deploy s developera laptopa”.
  • Mobile treba imati automatizirane buildove, čak i ako je store deployment u startu još uvijek manualan.
  • Promjene infrastrukture trebaju biti praćene, idealno kroz infrastructure as code, ali barem kroz dokumentirane korake.

Minimalni “one command” pristup za validaciju web builda:

Bash
npm ci
npm run build
npm run start

Ako build ovisi o nedokumentiranim globalnim alatima ili manualnim podešavanjima okruženja, tretirajte to kao blocker.

CI/CD crvene zastavice#

Crvena zastavicaZašto je bitno
Manualni production deployLjudska pogreška i nedostatak audit traila
Nema staging okruženjaProdukcija postaje testno okruženje
Nema rollback planaIncidenti traju dulje nego što moraju
Mobile buildovi samo na jednom laptopuBus factor jedan i release rizik

# 6) Audit dokumentacije: preživljava li znanje primopredaju#

Dokumentacija je razlika između onboardinga u danima i onboardinga u mjesecima. Ne ciljate savršenu dokumentaciju. Ciljate minimalnu operativnu dokumentaciju koja smanjuje ovisnost o određenim ljudima.

Dokumentacijska kontrolna lista s kriterijima prihvata#

DokumentKriteriji prihvataGdje treba biti
README setupRadi na čistoj mašini unutar 30 minutaRoot repozitorija
Pregled arhitektureObjašnjava glavne module, tok podataka i ključne odluke/docs ili wiki mirroran u repo
RunbookoviDokumentirani česti ops zadaci, uključujući rollback/runbooks u repozitoriju
API ugovoriSchema ili primjeri su versionaniOpenAPI ili tipizirani klijent
ADR-oviTop 5 arhitekturnih odluka zabilježeno/docs/adr
Inventar primopredajePopis računa, servisa i okruženjaSiguran dokument, ne javno

Konkretan kriterij prihvata: novi inženjer treba moći pokrenuti aplikaciju, pokrenuti testove i napraviti staging deploy prateći dokumentaciju bez postavljanja pitanja.

Dokumentacijske crvene zastavice#

Crvena zastavicaTrošak za tim
Setup zahtijeva “tribal knowledge”Kašnjenja u onboardingu i nekonzistentna okruženja
Nema runbookovaIncidenti postaju spori i stresni
Nema inventara okruženjaIznenadni računi, nepoznati servisi, propuštene obnove
API ugovori nisu dokumentiraniIntegration bugovi i sporiji razvoj

# Crvene zastavice koje bi trebale promijeniti uvjete primopredaje#

Neki nalazi trebali bi pokrenuti renegocijaciju rokova ili zahtjev za podrškom odlazećeg tima. Koristite ovaj popis kako biste zaštitili svoj delivery raspored.

OzbiljnostCrvena zastavicaŠto implicira
KritičnoNema ponovljivog builda ili deploy putaNe možete sigurno preuzeti odgovornost
KritičnoNepoznato rukovanje PII-jem i tajnamaPravni rizik i rizik kompromitacije
VisokoNema produkcijskog pristupa, dashboarda ili logovaNe možete operirati sustav
VisokoNema rollback putaSvaki deploy je visok rizik
SrednjeJaka spregnutost i nema testovaBrzina će biti niska dok se sustav ne stabilizira
SrednjeEkosustav ovisnosti je zastarioBuduće nadogradnje postaju skupe

# Brze pobjede u 30 dana za novog CTO-a i tim#

Ovo je praktičan plan koji brzo smanjuje rizik. Prioritet su kontrola, vidljivost i ponovljivost, a ne refaktori.

Tjedan 1: preuzmite kontrolu nad osnovama#

Quick winDefinition of doneUloženi trud
Build i run dokumentiraniREADME sadrži točne naredbe i env varove0.5 do 1 dan
Zaključavanje tajniTajne premještene u siguran store, rotirane1 do 3 dana
Uključeno skeniranje ovisnostiAutomatizirani SCA radi na svakom PR-u1 dan
Release taggingVerzija izdanja vidljiva u aplikaciji i u error trackingu0.5 dana

Tjedan 2: stabilizirajte isporuku#

Quick winDefinition of doneUloženi trud
Hardenanje CI pipelineaLint, testovi i build obavezni za merge1 do 2 dana
Paritet stagingaStaging što je moguće više mirror-a prod konfiguraciju1 do 3 dana
Rollback runbookDokumentiran i testiran rollback0.5 do 1 dan
Minimalni e2e smoke testovi1 do 3 kritična flowa u CI-ju2 do 4 dana

Tjedan 3: unaprijedite observability#

Quick winDefinition of doneUloženi trud
Baseline error trackingaAlerti na nove issueve i spikeove0.5 do 1 dan
Strukturirano logiranjeUsvojeni request ID-jevi i konzistentna shema1 do 3 dana
Osnovni dashboardiDashboardi za error rate, latenciju, throughput1 do 2 dana
On-call playbookSeverity incidenta, predložak komunikacije, eskalacijski put0.5 do 1 dan

Tjedan 4: smanjite dugoročni trošak#

Quick winDefinition of doneUloženi trud
Arhitekturni ADR-oviTop odluke zabilježene i podijeljene0.5 do 1 dan
Nadogradnja kritičnih ovisnostiPatchani kritični CVE-ovi i visokorizične biblioteke1 do 5 dana
Dodajte contract validacijuSchema validacija na API granicama2 do 4 dana
Uvedite feature flagoveToggle rizičnih funkcija bez redeploya2 do 5 dana

Mala, ali “high-leverage” nadogradnja je standardizirati validaciju okruženja skriptom koja faila odmah ako nedostaju potrebne varijable.

Bash
#!/usr/bin/env bash
set -e
 
required_vars=("DATABASE_URL" "NEXTAUTH_SECRET" "SENTRY_DSN")
for v in "${required_vars[@]}"; do
  if [ -z "${!v}" ]; then
    echo "Missing env var: $v"
    exit 1
  fi
done
 
echo "Env OK"

# Isporuke koje trebate zatražiti pri primopredaji#

Primopredaju učinite konkretnom. Tražite artefakte, ne obećanja.

IsporukaKriteriji prihvata
Inventar pristupaPopis svih računa, repozitorija, cloud projekata, storeova i admina
Mapa okruženjaDev, staging, prod URL-ovi, baze podataka i third-party servisi
Mapa podatakaKoji PII postoji, gdje se pohranjuje, politika zadržavanja
Povijest incidenataNajveći incidenti i što je naučeno
Release notesZadnjih 10 izdanja i poznati problemi
Period podrškePodrška odlazećeg tima 2 do 4 tjedna nakon primopredaje

# Ključne poruke#

  • Koristite jedan scorecard za procjenu arhitekture, sigurnosti, testiranja, observabilityja, CI/CD-a i dokumentacije s eksplicitnim kriterijima prihvata.
  • Ponovljivi buildovi, rukovanje tajnama i vidljivost produkcije tretirajte kao handover blockere, ne kao “nice to have”.
  • Rano identificirajte crvene zastavice i renegocirajte uvjete primopredaje kada nedostaje operativna kontrola.
  • Isporučite quick winove u prvih 30 dana: strože CI gateove, minimalne e2e smoke testove, release tagging i baseline dashborde.
  • Pretvorite “tribal knowledge” u runbookove i ADR-ove kako bi codebase ostao operativan nakon odlaska ključnih ljudi.

# Zaključak#

Uspješna primopredaja codebasea mjeri se time može li vaš tim sigurno isporučivati, pratiti i rollbackati u prvom mjesecu, a ne time koliko “čisto” izgleda kod prvog dana. Koristite ovu CTO kontrolnu listu za primopredaju codebasea da uspostavite kontrolu, smanjite rizik i izgradite predvidiv ritam isporuke.

Ako želite da Samioda s vama provede ovaj audit i isporuči registar rizika plus plan stabilizacije za 30 dana za vaš Next.js, React ili Flutter proizvod, kontaktirajte nas putem Samioda ili krenite s našim due diligence deep diveom ovdje: tehnička dubinska analiza i audit legacy koda.

FAQ

Share
A
Adrijan OmićevićOsnivač i senior developer

Osnivač i senior developer u Samiodi. 8+ godina iskustva u izradi React, Next.js, Flutter i n8n rješenja za klijente diljem Europe.

Trebate pomoć s projektom?

Gradimo prilagođena rješenja koristeći tehnologije iz ovog članka. Senior tim, fiksne cijene.