Ringkasan Proyek

github-roast adalah aplikasi web berukuran kecil dengan dua bagian: satu halaman yang meminta username GitHub dan bahasa, serta satu endpoint POST /llama yang mengambil profil publik lalu meminta gpt-4o-mini menulis roast singkat. README menyebut tumpukannya dalam satu baris: SvelteKit, Cloudflare Pages, Cloudflare D1, OpenAI gpt-4o-mini (README.md:1-3¹). Proyek di-build memakai @sveltejs/adapter-cloudflare (svelte.config.js:10²), sehingga hasil build berjalan sebagai Pages Function dan bukan server Node biasa.

Halaman utama berupa form sederhana yang di-prerender menjadi aset statis (src/routes/+page.js:3³). Form itu mengirim POST /llama dengan body { username, language } (src/routes/+page.svelte:39-45⁴). Seluruh logika produk berada di satu berkas endpoint src/routes/llama/+server.js.

Peta modul

Satu request roast melewati empat titik: halaman, cache di tabel roasts, GitHub REST API, lalu OpenAI.

graph TD
  UI["+page.svelte<br/>input username + select language"] -->|"POST /llama"| API["llama/+server.js"]
  API --> CACHE{"roasts lookup<br/>gh_username + language"}
  CACHE -->|"cache hit"| OUT["response roast"]
  CACHE -->|"cache miss"| GH["GitHub REST API"]
  GH --> DATAS["datas: profil + README + 15 repo"]
  DATAS --> PROMPT["prompt sesuai language"]
  PROMPT --> LLM["OpenAI gpt-4o-mini"]
  LLM --> STORE["INSERT INTO roasts"]
  STORE --> OUT
  OUT --> UI
  D1[("D1 binding DB")] --- CACHE
  D1 --- STORE
  ENV["OPENAI_API_KEY<br/>GITHUB_API_KEY"] -.-> API
  style D1 fill:#336791,color:#fff
  style STORE fill:#336791,color:#fff
  style CACHE fill:#8b5cf6,color:#fff
  style DATAS fill:#8b5cf6,color:#fff
  style PROMPT fill:#8b5cf6,color:#fff
  style API fill:#f59e0b,color:#000
  style ENV fill:#f59e0b,color:#000
  style GH fill:#2d7d46,color:#fff
  style LLM fill:#2d7d46,color:#fff
  style OUT fill:#2d7d46,color:#fff
%% fig: Peta modul github-roast
%% desc: Satu request roast berpindah dari halaman SvelteKit ke endpoint, cache tabel roasts, GitHub REST API, lalu gpt-4o-mini, dan kembali ke pengguna.

Berkas yang menyusun aplikasi

Tumpukan dan nilai konfigurasi

Variabel environment yang ada di .env.example adalah OPENAI_API_KEY, GITHUB_API_KEY, dan TELEGRAM_API_KEY (.env.example:1-3¹¹). Endpoint hanya mengimpor dua yang pertama (src/routes/llama/+server.js:1-7¹²).

Satu request, empat langkah

1. Endpoint memeriksa language terhadap validLanguages yang berisi 11 nilai, lalu menjalankan SELECT * FROM roasts WHERE gh_username = ? AND language = ?; kalau ada baris cocok, roast lama langsung dikembalikan tanpa memanggil GitHub (src/routes/llama/+server.js:29-47¹³).
2. Pada cache miss, endpoint mengambil profil dan daftar repo dari GitHub REST API, membaca README.md dari branch main atau master, lalu merakit object datas berisi name, bio, company, location, followers, following, public_repos, profile_readme, dan 15 repo terakhir (src/routes/llama/+server.js:111-131¹⁴).
3. datas disisipkan ke prompt sesuai bahasa, lalu dikirim ke client.chat.completions.create dengan model: 'gpt-4o-mini' dan stream: false (src/routes/llama/+server.js:180-191¹⁵).
4. Hasil roast dikembalikan sebagai { roast } dan dicoba disimpan ke tabel roasts; halaman menampilkannya lewat SvelteMarkdown (src/routes/llama/+server.js:195-208¹⁶, src/routes/+page.svelte:104-111¹⁷).

⚠️ Pemilih bahasa di UI memuat 15 pilihan, termasuk german, italian, finnish, dan portuguese, sedangkan validLanguages di endpoint hanya menerima 11 nilai. Memilih bahasa di luar daftar itu berakhir dengan status 400 dan pesan invalid language specified, please pass a valid language. (src/routes/+page.svelte:12-28¹⁸, src/routes/llama/+server.js:15-27¹⁹, src/routes/llama/+server.js:33-38²⁰). Rinciannya ada di Prompt Multibahasa.

⚠️ INSERT di endpoint menyebut kolom ip_address, tetapi database.sql tidak membuat kolom itu. Kegagalan insert ditelan blok catch {} kosong, sehingga response roast tetap terkirim ke pengguna meski barisnya tidak tersimpan (src/routes/llama/+server.js:195-208¹⁶, database.sql:2-9⁹). Rinciannya ada di Model Data Tabel roasts.