Skip to content

About

Resources

Stars

2 stars

Watchers

0 watching

Forks

Repository files navigation

Portofolio Profesional & AI Developer Lab - Rafly Firmansyah

Landing page portofolio profesional dan Developer Lab interaktif untuk Rafly Firmansyah - Sarjana Komputer (S1 Informatika, Universitas Bina Sarana Informatika), Analis Program Terstandar BNSP, dan Software Engineer yang berfokus pada riset Natural Language Processing (NLP), Machine Learning, arsitektur backend, dan rekayasa web modern.

Aplikasi ini dibangun dengan React 19, Vite, Tailwind CSS v4, Framer Motion, dan Lenis Scroll, didukung Vercel Serverless Functions serta Supabase PostgreSQL. Desainnya menekankan aksesibilitas WCAG 2.2 AA, efisiensi bundle melalui lazy-loading dan code-splitting, serta arsitektur keamanan fail-closed dengan Row Level Security (RLS).


Fitur Utama

Terminal AI

  • Routing Multi-Provider: Failover otomatis antar penyedia model AI dengan rotasi kunci, pemantauan latensi, dan fallback berjenjang saat terjadi antrean atau limitasi.
  • Ground-Truth Portfolio: Pertanyaan seputar proyek, riset, pendidikan, dan sertifikasi dijawab dari basis data lokal terverifikasi - cepat dan bebas halusinasi.
  • Pencarian Web Real-Time: Kueri wawasan umum dan berita terkini didukung penelusuran langsung dengan penyaringan dan peringkat relevansi.
  • Memori Berkelanjutan: Menyimpan wawasan baru dan koreksi pengguna secara terstruktur, dengan konteks terpisah per sesi pengunjung.
  • Keamanan Gateway: Isolasi kunci API di sisi server, proteksi SSRF, pembatasan laju kueri, sanitasi masukan, dan CORS allowlist.

Dashboard Admin

  • Autentikasi Berlapis: Proteksi Master PIN dengan hashing kriptografis, penguncian brute-force, dan token sesi yang kedaluwarsa otomatis.
  • Data Privat: Telemetri dan memori hanya dapat dibaca melalui fungsi serverless terverifikasi akses publik ke tabel dinonaktifkan sepenuhnya via RLS.
  • Visualisasi Analitik: Statistik kunjungan, tipe perangkat, interaksi kueri, dan riwayat perintah dalam grafik interaktif.
  • Ekspor Log Terproteksi: Unduh log aktivitas dalam format JSON/CSV dengan sanitasi karakter untuk mencegah formula injection.

Desain & Performa

  • Liquid Glass Design System yang konsisten di tema gelap dan terang.
  • Aksesibilitas WCAG 2.2 AA: kontras memadai, navigasi keyboard penuh, dan atribut ARIA pada elemen interaktif.
  • Animasi & Scroll Mulus: reveal berbasis kompositor dan smooth scrolling tanpa mengorbankan performa.
  • Semantik SEO: Schema.org JSON-LD, OpenGraph, dan favicon multi-resolusi.

Struktur Proyek

.
├── index.html        # Titik masuk aplikasi (meta SEO, OpenGraph, JSON-LD)
├── src/              # Sumber aplikasi React (halaman, komponen, konteks, utilitas)
├── api/              # Fungsi serverless (gateway AI, autentikasi, data privat)
├── database/         # Skema dan migrasi Supabase
├── public/           # Aset statis (favicon, gambar, dokumen)
└── vercel.json       # Routing SPA, header keamanan, dan batas runtime

Menjalankan Secara Lokal

Prasyarat: Node.js 18+ dan npm.

# 1. Kloning repositori
git clone https://github.com/Raflyf/web-portofolio.git
cd web-portofolio

# 2. Instal dependensi
npm install

# 3. Konfigurasi environment
cp .env.example .env.local
# Sesuaikan nilai variabel sesuai kebutuhan

# 4. Jalankan server pengembangan
npm run dev

Aplikasi berjalan di http://localhost:5173.

Build produksi:

npm run build
npm run preview

Konfigurasi Environment

Variabel Client (Prefix VITE_)

Nama Deskripsi
VITE_SUPABASE_URL URL endpoint Supabase untuk telemetri.
VITE_SUPABASE_ANON_KEY Kunci publik Supabase dengan izin RLS terbatas (INSERT saja).

Variabel Server

Nama Deskripsi
SUPABASE_URL URL endpoint Supabase untuk fungsi serverless.
SUPABASE_SERVICE_ROLE_KEY Kunci privat utama hanya digunakan fungsi serverless. Dilarang diekspos ke client.
ALLOWED_ORIGIN Domain resmi yang diizinkan dalam kebijakan CORS.

Variabel tambahan untuk integrasi AI dan konfigurasi internal didokumentasikan di .env.example.


SEO dan domain utama

Situs utama: https://raflyf.vercel.app/. Domain sebelumnya dipertahankan sebagai redirect permanen ke path yang sama, bukan diputus atau diarahkan semua ke homepage. File verifikasi Google dikecualikan dari redirect agar kedua property tetap bisa diverifikasi.

  • npm run build membangun Vite ke dist/, lalu merender komponen portfolio asli ke HTML. Pengunjung dan crawler memperoleh profil, H1, proyek, dan tautan sebelum JavaScript berjalan. Client saat ini me-mount ulang snapshot yang sama; kontrol input dinonaktifkan sampai React siap supaya isian pengguna tidak hilang. Hydration ditunda sampai state browser tersimpan memiliki render awal deterministik.
  • public/robots.txt, public/sitemap.xml, dan file verifikasi Google merupakan berkas yang diterbitkan. Salinan root robots/sitemap dipertahankan dan diuji agar tidak menyimpang.
  • Sitemap memuat homepage dan /contoh-portfolio-react-tailwind, bukan dashboard atau alias duplikat. Tanggal lastmod yang tidak dapat dipastikan dihapus, bukan diganti pada setiap deploy.
  • Halaman studi kasus berisi struktur, screenshot desktop/mobile, keputusan teknis, demo, dan repo. Source code ini merupakan portfolio aktif, bukan janji template satu klik.
  • Rewrite SPA hanya berlaku pada route terdaftar. URL yang tidak ada tetap HTTP 404.
  • /dashboard, /archive-v1/dashboard, dan /preview-stitch/dashboard memperoleh X-Robots-Tag: noindex; robots mengizinkan crawl agar aturan tersebut bisa dibaca. noindex bukan pengganti autentikasi.
  • Canonical, OpenGraph, JSON-LD, tautan demo, serta origin API menggunakan domain utama baru. Domain lama hanya dipertahankan untuk migrasi.

Pemeriksaan:

npm run build
npm test

Setelah deploy, verifikasi property baru https://raflyf.vercel.app/ di Search Console, kirim https://raflyf.vercel.app/sitemap.xml, lalu inspeksi URL homepage dan studi kasus. Pertahankan verifikasi property lama dan gunakan Change of Address jika tersedia untuk kedua property. Jangan hapus redirect lama; Google menyarankan minimal satu tahun. Status alternate canonical dan page with redirect normal untuk alias, bukan target agar semua URL terindeks. Ranking/indexing tidak dijamin, dan laporan Google tidak berubah seketika.

Panduan Google: https://developers.google.com/search/docs/crawling-indexing/site-move-with-url-changes

Tanda baca

Teks UI, metadata, dan dokumentasi menggunakan tanda hubung biasa atau titik dua, bukan em dash. Terminal menormalkan em dash pada node teks Markdown setelah parsing, termasuk entitas HTML dan pesan lama yang ditampilkan kembali. URL, contoh kode, dan data riwayat tersimpan tidak ditulis ulang. Jalankan node --test tests/punctuation.test.mjs untuk memeriksa regresi.

Optimasi render internal

Baseline d8850a4 dibandingkan dengan memo transcript terminal dan satu pemilik scroll-spy bersama. DOM/class, CSS, motion, durasi reveal, typewriter 16 ms, Lenis, serta cadence penyimpanan tetap. Baris terminal digunakan ulang saat input atau kontrol berubah; pesan yang sedang diketik tetap diperbarui. Handler rollback memakai render terakhir yang sudah commit agar pesan dan lampiran tidak kedaluwarsa.

Benchmark lokal: Chrome 156.0.8078.81, viewport 1440x900, CPU 4x, tiga pasangan bergantian, konfigurasi VITE_* setara, tanpa trace. Riwayat berisi 41 pesan, 64 karakter input, scroll 9500 px turun/naik pada 1800 px/detik. Respons AI memakai fixture lokal, bukan latensi provider. Nilai tabel adalah median tiga run.

Skenario Baseline Kandidat
JavaScript saat mengetik 1168.3 ms 490.2 ms
Pembangunan ulang array transcript saat mengetik 65 0
Durasi skenario mengetik 2979.0 ms 2257.5 ms
Scroll biasa: JavaScript / p95 frame 1854.2 / 62.5 ms 1850.7 / 62.4 ms
Scroll + typewriter: JavaScript / p95 frame 6398.1 / 180.7 ms 6266.6 / 187.4 ms

Pengurangan kerja saat mengetik sekitar 58%. Durasi skenario bukan INP. Scroll biasa dan scroll saat AI mengetik belum menunjukkan peningkatan kelancaran yang konsisten. Shared scroll menghapus duplikasi listener/RAF serta pembacaan posisi; observasi ukuran delapan section menjaga cache setelah filter, resize, atau pergantian bahasa. Section masih dipasang sinkron, bukan lazy-mounted.

Verifikasi: 53 tes lulus; CSS build identik byte; DOM transcript fixture identik. Pemeriksaan browser desktop/tablet/mobile membandingkan geometri section, material kaca, navigasi, filter, bahasa, history restore, input, popup/Escape, rollback, typewriter, checkpoint, chat baru, dan remount route. Screenshot diperiksa dengan animasi tetap aktif; fase marquee dapat berbeda, sehingga bukan klaim piksel identik.

Sampel aktivasi tanpa throttle: terminal siap 466-554 ms pada baseline dan 483-501 ms pada kandidat; popup terdeteksi 17-33 ms dan 28-52 ms. Satu sampel per viewport tidak membuktikan perubahan latensi. Tidak ada lazy load, penundaan aktivasi, atau perubahan timer. Backend/latensi provider tidak diukur.

Jalankan npm run build dan npm test. Runner serta bukti lokal: benchmark berpasangan, hasil final, pemeriksaan UI, dan sampel aktivasi. Benchmark lama paired-v1 tidak dipakai karena konfigurasi build belum setara.

Keamanan aplikasi

  • Pengetahuan bersama hanya menerima penulisan sesi admin yang tervalidasi dan bertanda tangan server. Catatan pengunjung lama tetap tersimpan, tetapi tidak digunakan sebagai fakta bersama. Riwayat percakapan terikat cookie HttpOnly bertanda tangan; ID telemetri bukan kredensial.
  • Autentikasi memakai JSON POST, PIN di-hash dengan scrypt dan salt acak, sesi disimpan sebagai hash, serta perubahan PIN/OTP/logout memakai pembaruan bersyarat atomik. Operand filter PostgREST di-encode sebagai nilai kolom, bukan string JSON, agar integer dan timestamp tetap valid. Format PIN lama dimigrasikan tanpa mengganti PIN. Percobaan login dibatasi per-IP, pengiriman OTP juga dibatasi global; kegagalan database menolak operasi.
  • Health publik hanya menampilkan status. Data dashboard tidak disimpan dalam cache persisten browser. Pengambilan URL publik memvalidasi DNS dan setiap redirect, mengikat IP koneksi, serta membatasi waktu dan ukuran respons.
  • CSP produksi menolak skrip inline dan membatasi koneksi browser ke origin yang digunakan. Gaya inline tetap diperlukan untuk animasi. Tema sebelum paint memakai skrip same-origin.
  • npm test menguji regresi memakai fixture terisolasi, bukan menulis data pengujian ke produksi. Hasil tes bukan jaminan tanpa celah atau bukti ketahanan DDoS.

Lisensi

Proyek ini didistribusikan di bawah lisensi MIT License.

Hak cipta © 2026 Rafly Firmansyah. Seluruh hak dilindungi undang-undang.

About

Resources

Stars

2 stars

Watchers

0 watching

Forks

Contributors

Languages