Skip to content

feat: kesiapan deploy - metadata, keamanan, halaman galat, font, dan CI - #9

Merged
wahidrizka merged 13 commits into
mainfrom
feat/deploy-readiness
Jul 31, 2026
Merged

wahidrizka merged 13 commits into
mainfrom
feat/deploy-readiness

Conversation

@wahidrizka

Copy link
Copy Markdown
Owner

Menyiapkan aplikasi untuk deploy: metadata yang bisa dirayapi, header keamanan, halaman galat sendiri, font yang di-host sendiri, CI, dan README.

Yang berubah, dengan angkanya

Sebelum Sesudah
Data Pokemon di HTML server tidak ada judul, deskripsi, dan gambar per-Pokemon
Tag Open Graph dan canonical 0 lengkap, semuanya absolut
Header keamanan 0 6, termasuk CSP yang menegakkan
Origin pihak ketiga untuk skrip, gaya, dan font 2 0
CLS /pokemons 0.214 buruk 0.084 baik
CLS /my-pokemon 0.021 0.004
Nama Pokemon tak dikenal 200 dengan halaman kosong 404
Test e2e 117 147

Catatan

Seluruh isi halaman tetap diambil di peramban seperti sebelumnya. Yang pindah ke server hanya metadata.

CLS halaman detail sengaja dibiarkan di 0.187. Memperbaikinya menuntut ruang dipesan lebih dulu, dan itu membuat kartu tampil tinggi dan kosong sekitar satu detik sebelum terisi. Halaman itu dicapai lewat klik, bukan pendaratan, jadi menukar angka dengan tampilan yang lebih janggal tidak sepadan.

Tiga kesimpulan awal dibatalkan oleh pengukuran dan tidak jadi dikerjakan:

  • LCP yang semula terbaca 3228ms ternyata artefak; lima sampel ulang memberi 160ms.
  • Dugaan bahwa metadataBase cukup mengandalkan fallback bawaan Next terbantah saat build: og:url terbit relatif sebagai "/", karena fallback itu hanya berlaku untuk gambar sosial.
  • Dugaan bahwa CLS berasal dari useNavHeight terbantah oleh A/B blokir font: tanpa font Google, CLS /pokemons jatuh ke nol. Hook itu tidak jadi disentuh.

Satu test palsu juga ketahuan saat membuktikan test bisa gagal. Versi pertama menguji CSP lewat fetch lintas-origin yang gagal, padahal fetch semacam itu juga ditolak CORS, sehingga tetap hijau meski seluruh header dicabut. Penggantinya menyimak securitypolicyviolation.

Verifikasi

  • Tiap commit lolos typecheck dan lint sendiri-sendiri.
  • 147 test e2e hijau di enam perangkat.
  • Test header dan metadata dibuktikan gagal saat fiturnya dicabut, lalu lulus lagi setelah dipulihkan.
  • Halaman 404 dan kedua batas galat diperiksa dengan memicu keadaannya sungguhan, bukan dibaca saja.
  • Tampilan setelah pindah font dibandingkan per piksel, dengan potret build yang sama sebagai kontrol: halaman jelajah mobile identik mutlak.

Pemilihan entri bahasa Inggris untuk genus dan teks Pokedex sebelumnya
tertanam di dalam usePokemonDetail. Metadata halaman membutuhkan keduanya
juga, dan komponen server tidak bisa mengimpor hook client.

Mengangkatnya ke utils membuat isi halaman dan deskripsi metadata membaca
dari satu sumber, sehingga keduanya tidak mungkin menyimpang.
Seluruh isi halaman diambil di peramban, jadi HTML yang diterima perayap
dan pratinjau tautan tidak memuat apa pun: setiap Pokemon berbagi judul
"PokeCatch" yang sama, tanpa satu pun tag Open Graph.

generateMetadata mengambil detail dan species di server hanya untuk judul,
deskripsi, dan gambar; isi halaman tetap dirender di peramban seperti
sebelumnya. Artwork resmi 475x475 dipakai sebagai og:image karena sprite
96x96 terlalu kecil untuk pratinjau, dan cakupannya sama persis dengan
sprite sehingga tidak butuh gambar cadangan.

Nama yang tidak dikenal kini menjawab 404 sungguhan. notFound() di dalam
generateMetadata ternyata ditelan Next dan halamannya tetap terbit dengan
status 200, sehingga pemicunya dipindah ke komponen halaman; cache() React
menyatukan keduanya menjadi satu panggilan per kunjungan. Terverifikasi
lewat proxy penghitung: satu kunjungan mengeluarkan tepat dua permintaan.

metadataBase diisi eksplisit. Fallback bawaan Next hanya berlaku untuk
gambar sosial, sehingga tanpa itu og:url dan canonical terbit relatif --
og:url "/" tidak sah menurut spesifikasi Open Graph.

Domainnya diturunkan dari variabel yang diisi Vercel sendiri, memisahkan
pratinjau dari produksi, jadi tidak ada domain yang ditulis tangan dan
tidak ada variabel baru yang bisa lupa diisi saat deploy.

/my-pokemon tidak masuk sitemap dan ditolak robots: isinya hanya ada di
localStorage tiap peramban, jadi yang dilihat perayap selalu kosong.
Aplikasi sebelumnya menjawab tanpa satu pun header keamanan: tidak ada CSP,
X-Frame-Options, X-Content-Type-Options, Referrer-Policy, Permissions-Policy,
maupun HSTS.

Daftar origin pada CSP diturunkan dari pengamatan lalu lintas nyata keempat
rute, bukan dugaan. Pengamatan itu menemukan satu sumber yang mudah terlewat:
raw.githubusercontent.com melayani media, bukan hanya gambar, karena suara
Pokemon diputar dari sana. Tanpa media-src, tombol suara akan mati diam-diam.

Nonce tidak dipakai. Nonce menuntut middleware yang membuat setiap rute
dirender dinamis, dan aplikasi ini tidak punya auth maupun data pengguna di
server, sehingga harganya lebih besar dari manfaatnya. 'unsafe-eval' dan ws:
hanya aktif di dev, tempat HMR membutuhkannya.

Terverifikasi dua arah: fetch, script, dan gambar dari origin asing benar
ditolak peramban, sementara 24 gambar sah tetap termuat. Seluruh 117 test e2e
tetap hijau di bawah kebijakan ini.
Nama Pokemon yang tidak ada dan rute keliru sebelumnya jatuh ke halaman
bawaan Next: putih polos, tanpa font maupun warna game, tanpa jalan kembali.

ErrorScreen memuat tampilannya sekali dan dipakai bertiga. Tindakannya
dititipkan lewat children karena tiap pemakainya berbeda: 404 menawarkan
tautan, batas galat menawarkan tombol coba lagi yang hanya ada di komponen
client, dan global-error hanya menawarkan tombol karena tautan bergantung
pada router yang belum tentu hidup sejauh itu.

Lebar memakai 100% bukan 100vw seperti StartScreen: 100vw ikut menghitung
lebar batang gulir, dan guard tata letak e2e menolak dokumen yang lebih lebar
dari viewport.

Ketiganya diperiksa dengan memicu keadaannya sungguhan, bukan dibaca saja.
404 menjawab 404, batas galat menjawab 500, dan global-error tetap membawa
latar pixel-art-nya meski root layout yang biasanya memuat gaya justru
adalah yang gagal.
Font dimuat lewat @import ke Google Fonts, sehingga peramban baru menukar
font cadangan dengan VT323 setelah dua perjalanan jaringan. Pertukaran itu
ternyata satu-satunya penyebab pergeseran tata letak di halaman jelajah:
memblokir permintaan fontnya menurunkan CLS dari 0.214 menjadi 0.

Ukuran sesudah pindah, lima sampel per rute:

  /pokemons        0.214 -> 0.084   buruk menjadi baik
  /my-pokemon      0.021 -> 0.004
  /pokemon/[name]  0.196 -> 0.187   sisanya bukan font, tapi konten

next/font menyertakan font cadangan yang metriknya sudah disetarakan, jadi
pertukarannya tidak lagi menggeser apa pun.

Karena tidak ada lagi gaya maupun font dari pihak ketiga, CSP ikut dipersempit:
style-src dan font-src kini hanya 'self'. Yang tersisa hanya PokeAPI dan repo
sprite-nya, keduanya memang tidak tergantikan.

Tampilan diperiksa, bukan diasumsikan. Potret sebelum dan sesudah dibandingkan
per piksel, dengan potret build yang sama sebagai kontrol untuk memisahkan
derau: halaman jelajah mobile identik mutlak, dan pada desktop selisihnya
hanya di baris teks, pada koordinat y yang sama, berupa rumbai antialias
sub-piksel. Bentuk dan posisi huruf tidak berubah.
Lima skenario baru menutup bagian yang justru tidak pernah dilihat pengguna:
apa yang diterima perayap dan pratinjau tautan sebelum satu baris JavaScript
pun berjalan.

Cakupannya: judul dan og:url per-Pokemon beserta canonical yang absolut,
og:image yang menunjuk artwork resmi, deskripsi yang benar-benar berasal dari
/pokemon-species, nama tak dikenal yang menjawab 404 dan bukan halaman kosong,
keenam header keamanan, penegakan CSP yang sesungguhnya, serta sitemap dan
robots.

Ketiganya dibuktikan bisa gagal, bukan sekadar hijau. Mencabut header membuat
test header gagal, dan membuang og:image membuat test metadata gagal.

Pembuktian itu menemukan satu test palsu. Versi pertama menguji CSP lewat
fetch lintas-origin yang gagal, padahal fetch semacam itu juga ditolak CORS --
sehingga test tetap lulus meski seluruh header dicabut. Penggantinya menyimak
peristiwa securitypolicyviolation, yang hanya mungkin muncul dari CSP, dan
sudah diverifikasi gagal tanpa kebijakan lalu lulus lagi setelahnya di keenam
peramban.

PORT ikut diteruskan ke server e2e. SITE_URL membacanya untuk menyusun URL
absolut, jadi tanpa itu canonical dan sitemap menyebut :3000 sementara server
melayani :3100, dan test metadata akan menguji alamat yang salah.
Dua job. Yang pertama memeriksa tipe, lint, dan build; yang kedua menjalankan
test end-to-end.

Keduanya menyalin .env.example menjadi .env.local lebih dulu. Nilai berawalan
NEXT_PUBLIC_ ditanam saat build, jadi tanpa berkas itu build tetap berhasil
tapi menghasilkan URL kosong dan aplikasinya gagal tanpa pesan apa pun.
Menyalin dari .env.example sekaligus menjaga berkas contoh itu tetap sahih.

E2E hanya menjalankan satu peramban di CI, bukan keenamnya. Test menembak
PokeAPI sungguhan, dan enam kali beban itu dari alamat CI bersama mengundang
kegagalan yang tidak ada hubungannya dengan perubahan kodenya. Cakupan lintas
perangkat tetap dijalankan penuh di mesin lokal.

Urutan langkahnya dijalankan lebih dulu di mesin lokal memakai .env.example
yang sama: keempat perintah lolos, dan bundel hasilnya terbukti memuat URL
PokeAPI tanpa karakter akhir baris yang nyasar.
README masih berisi template bawaan: cara menjalankan next dev, tautan ke
dokumentasi Next, dan ajakan deploy ke Vercel. Nol informasi tentang project
ini sendiri, bahkan menyebut font Geist yang tidak dipakai di sini.

Gantinya menjelaskan permainannya, cara menjalankannya, dan struktur kodenya.
Bagian environment variable dibuat menonjol karena kegagalannya senyap: tanpa
kedua nilai itu tidak ada galat sama sekali, permintaan jatuh ke URL relatif,
dan daftar Pokemon hanya tampak kosong.
Jalan pertama memberi peringatan: checkout, setup-node, dan upload-artifact
versi v4 menargetkan Node 20, yang sudah usang di runner GitHub dan dipaksa
berjalan di Node 24.
global-error menggantikan root layout ketika layout itu sendiri gagal, jadi
ia merender html sendiri dan tidak mewarisi apa pun. next/font hanya dipanggil
di layout, sehingga --font-vt323 tidak pernah terdefinisi di sana.

Akibatnya bukan jatuh ke monospace yang tertulis di sebelahnya: var() ke
properti tak terdefinisi tanpa nilai cadangan membatalkan seluruh deklarasi,
bukan hanya entri itu. Terukur, judulnya terbit sebagai Times New Roman.

Fontnya diangkat ke modul bersama dan dipasang di kedua tempat. Sesudahnya
font-family judul terukur VT323 dengan cadangan yang metriknya disetarakan.

Pemeriksaan sebelumnya melewatkan ini karena hanya memastikan latar
pixel-art-nya termuat, bukan fontnya.
URL og:image sebelumnya disusun sendiri sebagai artwork/{id}.png, dengan
alasan cakupan artwork sama persis dengan sprite biasa. Alasan itu salah:
kesimpulannya diambil dari dua id contoh, bukan dari daftar lengkap.

Empat Pokemon punya sprite tapi tidak punya artwork -- mimikyu-busted,
mimikyu-totem-busted, dan dua bentuk mega tatsugiri. Semuanya entri sah yang
bisa dibuka dari daftar jelajah, dan semuanya menerbitkan pratinjau tautan
yang menunjuk gambar 404.

PokeAPI sendiri sudah menyediakan jawabannya: sprites.other.official-artwork
bernilai null persis untuk keempatnya. Membacanya dari respons menghapus
tebakan sekaligus konstanta POKEMON_ARTWORK_IMAGE dan bidang id yang tidak
lagi dipakai. Yang tanpa artwork memakai gambar situs sebagai cadangan.

Test metadata lama hanya menguji pikachu, jadi buta terhadap kasus ini.
Test barunya sudah dibuktikan gagal saat kode dikembalikan ke cara lama, dan
kedua test kini memeriksa gambarnya benar-benar menjawab 200.

Komentar pengecualian arsitektur ikut ditulis di page.tsx: rute ini
satu-satunya yang memanggil service langsung, karena generateMetadata
berjalan di server sementara usePokemonDetail adalah hook client. Sebelumnya
alasan itu hanya tercatat di berkas yang tidak pernah ikut ter-push.
Pengambilan daftar Pokemon tidak punya jaring pengaman, jadi satu gangguan
sesaat pada PokeAPI saat sitemap pertama kali dibuat membuat rutenya menjawab
500 dan perayap tidak mendapat apa pun.

Sekarang jatuh ke rute statis saja, mengikuti pola yang sudah dipakai di
seluruh aplikasi: kegagalan menurunkan fitur, bukan mematikannya.
Komentarnya menyatakan 100vw akan ditolak guard tata letak e2e. Itu tidak
benar: peramban headless memberi batang gulir lebar nol, sehingga 100vw dan
100% menghitung nilai yang sama dan guard tidak akan pernah menangkapnya.

Pilihan 100% tetap benar, tapi alasannya adalah peramban sungguhan yang
memberi batang gulir ruang tata letak, bukan test.
@wahidrizka
wahidrizka merged commit f747e25 into main Jul 31, 2026
2 checks passed
@wahidrizka
wahidrizka deleted the feat/deploy-readiness branch July 31, 2026 14:23
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant