Repository navigation
feat: kesiapan deploy - metadata, keamanan, halaman galat, font, dan CI - #9
Merged
Merged
Conversation
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.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
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
/pokemons/my-pokemonCatatan
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:
metadataBasecukup mengandalkan fallback bawaan Next terbantah saat build:og:urlterbit relatif sebagai"/", karena fallback itu hanya berlaku untuk gambar sosial.useNavHeightterbantah oleh A/B blokir font: tanpa font Google, CLS/pokemonsjatuh 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