PepsSpace Docs

Internal Documentation & Reference

PepsSpace
Ecosystem Documentation

Referensi teknis Pepo (AI Assistant & Web Builder), PepsStudio OS (operasional studio), situs PEPSPACE, dan alur patch/backup yang dipakai dari dulu sampai sekarang.

OwnerVicky
Last Updated17 November 2026
Versi PepoBeta 2.0.183 (pepo191)
StatusFokus: undangan digital premium

00 Gambaran Besar

Empat bagian yang saling terhubung di bawah umbrella PepsSpace.

PepsSpace (umbrella) ├── Pepo (AI Assistant & Web Builder) │ → pepoai.id (dulu dev.pepsspace.com → kini dialihkan 301) │ → *.pepoai.web.id (website/undangan buatan user) │ → pepoai.id/a/<id> (halaman yang dibagikan lewat link) ├── PepStudio OS (Internal Ops) │ → os.pepsspace.com ├── PEPSPACE (situs korporat) │ → pepsspace.com (konten dikelola dari Admin Pepo) └── PepStudio (entitas bisnis foto/video)
ProyekURLVercel projectFungsi
Pepopepoai.idvibe-chatAI asisten + pembuat website/undangan, gratis selama beta
Situs user*.pepoai.web.idpepo-<string>Website/undangan hasil Pepo (maks. 5 subdomain per user)
PepsStudio OSos.pepsspace.compepsstudio-osBooking, absensi, keuangan, Meja Kerja
PEPSPACEpepsspace.compepsspace.comSitus korporat; pesanan masuk ke PepsOS

Infrastruktur: Vercel (region sin1, paket gratis), Supabase (Pepo dan katalog PepsOS di project terpisah), Kenari (model AI, paket Studio), domain di DomaiNesia, cPanel di Rapidplex (folder sumber untuk deploy).

01 Pepo — AI Assistant & Web Builder

Membuat website, undangan digital, dokumen, gambar, dan menjawab tugas lewat obrolan. Stack: Next.js 16 (App Router) · Supabase · Kenari · Vercel. Alur kerja: rancangan di chat → "Lanjut jadikan proyek" (rancangan dipasang persis) → Preview → Deploy ke subdomain → bagikan ke tamu.

Sedang dikerjakan (Nov 2026)

Mutu undangan digital: hasil harus setara undangan di video iklan Pepo (barier minimum). Sejak pepo183 ada penjaga mutu otomatis; pepo188 rancangan undangan langsung ditulis model kuat; pepo189 penyempurnaan punya waktu penuh. Masih menunggu uji live.

File Kunci & Kenapa Dibuat

FileFungsiKenapa dibuat
src/app/api/chat/route.tsOtak utama Pepo: memilah obrolan vs kerja (rancangan, mode kerja, gambar, diagram, dokumen), menyusun prompt sistem (karakter, aturan premium, memori, Knowledge Base, Asset Base), memilih model per tingkat, streaming SSE, dan penjaga mutu rancangan.Sejak awal; terus diperluas di hampir setiap patch.
src/components/workspace/Canvas.tsxLayar chat + preview: kirim pesan, baca stream, kartu Pepo, antrean pesan saat Pepo bekerja, "Lanjut jadikan proyek" tanpa AI, penyempurnaan rancangan di latar.Pusat UI sejak migrasi UX Manus; pepo181/183/189 menambah jalur pasang rancangan & penyempurnaan.
src/components/workspace/canvas/AssistantCards.tsxMerender kartu khusus di jawaban Pepo (pepo-preview, pepo-ask, pepo-doc, pepo-image, kuis, dll.).Supaya jawaban bisa berisi rancangan/kuis/gambar yang interaktif, bukan teks saja.
src/lib/ai/premium-web.tsPrompt sistem "standar premium" untuk website & undangan: brief user menang, resep undangan, panduan adat, kerangka kode, BARIER MINIMUM dari video iklan.pepo174/177/178/184/187: hasil awal tidak premium; user minta prompt sistem digabung prompt user, bukan template.
src/lib/ai/draft-gate.tsPenjaga mutu rancangan: memeriksa data brief, fitur wajib, barier minimum, foto, warna; menyusun perintah penyempurnaan.pepo183: rancangan undangan terlalu sederhana & revisi menghapus isi.
src/app/api/draft-refine/route.tsPenyempurnaan rancangan sebagai permintaan terpisah dengan waktu penuh.pepo189: penyempurnaan di permintaan chat kehabisan batas 300 dtk dan gagal diam-diam.
src/lib/asset-base.ts + src/lib/server/asset-base.tsAsset Base: kategori/subkategori aset desain resmi (adat, usaha, logo bank), pemilihan aset untuk tiap permintaan.pepo175: "seperti Knowledge Base, tapi untuk aset" agar hasil premium walau bahan user minim.
src/components/workspace/admin/AssetsTab.tsxAdmin › Asset Base: unggah, peran ditebak dari isi gambar, paket, aktif/nonaktif.pepo175; pepo182 dipercepat (tanpa pilih peran per file).
src/lib/workspace/attachment-kind.tsMemisahkan lampiran: aset untuk halaman (public/uploads) vs referensi/screenshot (uploads/lampiran, tidak ikut deploy).pepo174: screenshot error ikut masuk landing page.
src/lib/workspace/local-assets.tsUnggah tertunda: foto disimpan lokal (IndexedDB) dan hanya yang dipakai halaman diunggah ke Supabase saat deploy.Hemat storage; pepo174 menegaskan foto tak terpakai tidak diunggah.
src/lib/server/gen-image.ts + src/app/api/image/route.tsGambar AI di chat (kartu pepo-image), kunci gambar tetap (tidak dibayar dua kali), versi latar transparan.pepo173: "buatkan gambar" dulu masuk mode kerja 5 menit dan jadi SVG.
src/lib/workspace/invite-share.ts + ShareGuests.tsxLink tamu ?to=Nama, template pesan WA, salin semua link.pepo180: Pepo harus memberi tahu cara membagikan undangan.
src/components/workspace/DeployDialog.tsxDeploy ke subdomain *.pepoai.web.id; subdomain melekat per obrolan.pepo180: deploy ulang tidak perlu menulis subdomain lagi; pepo168: subdomain milik pemakai pertama.
src/app/a/[id] + src/lib/workspace/artifact-doc.tsHalaman bagikan pepoai.id/a/&lt;id&gt; untuk halaman interaktif/rancangan; status penonton lokal; ?to= diteruskan ke iframe.pepo-v21 (artefak); pepo185: nama tamu tidak muncul di link bagikan.
src/lib/pepo-changelog.tsRiwayat patch yang dibaca obrolan Sistem Pepo (ditimpa tiap patch).Supaya Sistem Pepo tahu semua perbaikan (permintaan Vicky).
src/lib/app-version.tsVersi & build yang tampil di badge "Beta 2.0.x".Memastikan patch benar-benar live.
src/lib/ai/pepo-models.tsNama tingkat model (Nawasena, Sigra, Niskala, Adikara) & keahlian (Dahayu, Aksara, Ananta, Jagat, Swara, Gati), pemetaan ke model mitra.Branding nama Sansekerta, satu nama = sekelompok model setingkat.
public/undangan-premium/jawa-gunungan.htmlUndangan Jawa premium buatan tangan (dari video iklan); kini dipakai sebagai contoh acuan mutu, bukan template otomatis.pepo176 (template, dimatikan pepo177); pepo186/188 jadi acuan mutu.
public/aset-base/…Aset bawaan Asset Base (paket Gunungan Cat Air Vintage: gunungan, lanskap, sudut, untaian, bingkai, pemisah, tekstur, 4 kupu-kupu).pepo175: aset hasil Pepo dimasukkan sebagai rujukan.

Daftar lengkap semua 308 file sumber ada di bagian 03.

Skema Supabase (Pepo)

  • profiles — saldo/kredit, is_admin, is_pro_account, tanggal lahir terenkripsi
  • projects — obrolan + file proyek (files, messages jsonb), vercel_url, custom_domain
  • user_memories — Memori Pepo per user
  • pepo_settings — pengaturan global (Beta gratis, Asset Base asset_base, dll.)
  • pepo_artifacts — halaman yang dibagikan lewat link
  • Knowledge Base (dokumen + potongan + embeddings), pepo_lessons, bug_reports, konten situs PEPSPACE, transaksi & top up
  • Storage bucket project-assets — foto proyek (unggah tertunda) dan gambar AI (gen/)

File SQL (jalankan sekali di Supabase → SQL Editor, aman diulang)

FileIsi / kenapa dibuat
pepo-v14.sqlPelajaran bersama Pepo (belajar dari rating jawaban, anonim)
pepo-v15.sqlLaporan bug (dulu Bug Challenge, kini laporan biasa)
pepo-v16.sqlTanggal lahir terenkripsi + izin orang tua/wali
pepo-v17.sqlKnowledge Base (dokumen rujukan, full-text search)
pepo-v18.sqlPencarian makna KB (embeddings) + batas endpoint AI publik
pepo-v19.sqlKonten situs PEPSPACE dari Admin Pepo (tanpa cPanel)
pepo-v20.sqlpepo_settings: pengaturan global (Beta gratis, Asset Base, dll.)
pepo-v21.sqlpepo_artifacts: halaman yang dibagikan lewat pepoai.id/a/<id>
pepo-v22.sqlPeta struktur database untuk obrolan Sistem (baca saja)
pepo-v23.sqlOpsional: kunci satu subdomain = satu website di database
pepsos-v4.sqlPeta struktur database PepsOS untuk obrolan Sistem

Model AI (nama Pepo → model Kenari)

Nama PepoKeteranganModel (bawaan)
NawasenaAdaptif untuk setiap tugas (bawaan)dipilih sistem per pekerjaan
SigraCepat untuk keperluan harianclaude-haiku-5-5 · gemini-3-8-flash · deepseek-v4-flash
NiskalaPenalaran lebih mendalamgpt-6-luna
AdikaraKemampuan tertinggikimi-k3 · claude-sonnet-5-5
Dahayu · Aksara · Ananta · Jagat · Swara · GatiDesain & gambar · menulis · dokumen panjang · info web · suara/musik · videolabel keahlian
Rancangan undanganpepo188claude-sonnet-5-5 (env PEPO_INVITE_DRAFT_MODEL)
Gambar AIkartu pepo-imagegpt-image-2 · qwen-image-3.0-pro · nano-banana-2-lite

Env Vercel (nama saja — nilainya tidak pernah ditulis di dokumen)

NamaKeterangan
KENARI_API_KEYwajib / inti
KENARI_BASE_URLwajib / inti
NEXT_PUBLIC_SUPABASE_URLwajib / inti
NEXT_PUBLIC_SUPABASE_ANON_KEYwajib / inti
SUPABASE_SERVICE_ROLE_KEYwajib / inti
VERCEL_TOKENwajib / inti
VERCEL_TEAM_IDwajib / inti
NEXT_PUBLIC_SITE_URLwajib / inti
NEXT_PUBLIC_SITES_DOMAINwajib / inti
UNSPLASH_ACCESS_KEYwajib / inti
PEPSOS_SUPABASE_URLwajib / inti
PEPSOS_SUPABASE_KEYwajib / inti
PEPO_PII_KEYwajib / inti
PEPO_JOB_SECRETwajib / inti
VAPID_PUBLIC_KEYwajib / inti
VAPID_PRIVATE_KEYwajib / inti
PEPO_IMAGE_MODELS / PEPO_IMAGE_CREDITSopsional: model & biaya gambar AI
PEPO_DRAFT_MODEL / PEPO_DRAFT_THINKopsional: model rancangan umum
PEPO_INVITE_DRAFT_MODEL / PEPO_INVITE_STRONGopsional: rancangan undangan langsung model kuat (pepo188)
PEPO_DRAFT_GATE / PEPO_DRAFT_REFINE_MODELopsional: penjaga mutu & model penyempurna (pepo183/189)
PEPO_TRIAL_MODEL / PEPO_TRIAL_MESSAGESopsional: jatah model bagus untuk tamu/gratis
PEPO_BACKGROUNDopsional: mode kerja di latar (0 = mati)
PEPO_KB_* opsional: Knowledge Base (model meta, OCR, rerank, skor minimum)
PEPO_BETAopsional: saklar beta gratis

02 Alur Patch & Backup

Semua perubahan Pepo dikirim sebagai zip patch kumulatif (pepoNN.zip; satu zip terbaru sudah berisi semua patch sebelumnya, sejak pepo75). Kode sumber hidup di folder cPanel ~/dev.pepsspace.com, lalu dideploy ke Vercel.

1

Terima zip pepoNN.zip → upload ke folder home cPanel (atau public/ proyek).

2

bash pepo → pepo-helper.sh mencari zip terbaru, membongkar ke folder sementara, memastikan isinya zip patch Pepo, lalu menjalankan pepo-install.sh.

3

Validasi dulu, baru menimpa: folder proyek benar (package.json + file inti ada), semua file UTF-8 valid dan tidak kosong. Gagal = tidak ada yang diubah.

4

Backup otomatis file yang akan ditimpa ke ~/.pepo-backups/terakhir (di LUAR proyek supaya tidak ikut ter-deploy; satu backup, ditimpa tiap patch, dengan INFO.txt tanggal & nama patch). File lama yang bentrok/tidak aman dipindah ke terakhir/dihapus; backup lama (*.bak, *.orig, dll.) dibersihkan.

5

Salin patch (src/, public/), lalu deploy di latar: npx vercel --prod lewat nohup (aman walau terminal tertutup / sinyal putus). Log: bash pepo log; deploy ulang tanpa patch: bash pepo deploy.

6

Langkah manual bila ada (tertulis di PEPONN.md di dalam zip): SQL baru di Supabase, env baru di Vercel.

7

Cek live: badge versi di aplikasi (src/lib/app-version.ts, mis. Beta 2.0.183 = pepo191).

Kenapa alurnya begini

  • Kumulatif: patch yang terlewat tidak merusak apa pun; cukup pasang zip terbaru.
  • Catatan patch di zip (PEPONN.md) dan src/lib/pepo-changelog.ts: obrolan Sistem Pepo membaca riwayat ini supaya tahu apa yang sudah diubah, kenapa, dan di file mana. Catatan dari obrolan Sistem sendiri ada di pepo-changelog-sistem.ts (tidak ditimpa patch).
  • Paket sinkron dari Sistem Pepo (berisi .no-deploy): kode sudah live, jadi hanya disalin ke cPanel tanpa deploy ulang.
  • Backup di luar proyek: dulu file *.bak ikut ter-deploy dan memenuhi folder.
  • Pemulihan: salin isi ~/.pepo-backups/terakhir kembali ke proyek lalu bash pepo deploy.

Backup data obrolan & hasil

Menu unduh obrolan menghasilkan ZIP: obrolan.md (bisa dibaca), obrolan.json (data lengkap), rancangan/*.html, lampiran/*, proyek/*. ZIP ini juga yang dipakai untuk menganalisis bug & mutu hasil sebelum patch berikutnya.

PepsOS

Pola yang sama: bash pepsos memasang patch pepsosNN.zip.

03 Semua File & Kenapa Dibuat

Diambil dari catatan di bagian atas setiap file sumber Pepo (versi pepo191, 308 file). Ketuk grup untuk membuka.

src/app/api/ 69 file
FileKenapa dibuat / fungsinya (dari catatan di kode)
app/api/admin/assets/route.tsAdmin › Asset Base: daftar, unggah (multipart), ubah peran/paket/status, hapus aset. Unggahan disimpan di bucket project-assets folder asset-base/<kategori>/<sub>/<paket>/, daftarnya di pepo_settings "asset_base".
app/api/admin/beta/route.tsAdmin › Beta gratis: saklar + batas, dan pemakaian hari ini / 7 hari terakhir terhadap kuota paket Kenari.
app/api/admin/bugs/route.tsAdmin Laporan Bug: daftar laporan, tandai status, kelola "bug yang sudah diketahui". Tanpa hadiah sejak pepo158. Nilai status "dibayar" di database kini berarti SUDAH DIPERBAIKI (lihat src/lib/server/bugs.ts).
app/api/admin/domains/route.ts(tidak ada catatan di kode — komponen/utilitas pendukung)
app/api/admin/economics/route.tsGET /api/admin/economics?days=30 — Credit Utilization & Unit Economics (khusus admin). Data dari pepo_economics() (pepo-v13.sql) + perhitungan biaya penyedia nyata + temuan otomatis dalam bahasa biasa. Prinsip: harga aman pada pemakaian 100%, profitabilitas dinilai dari pemakaian NYATA, dan selalu dipecah per paket, cohort bulan pembelian, dan usia langganan.
app/api/admin/knowledge/route.tsAdmin Knowledge Base: tambah dokumen rujukan (bertahap per potongan teks), aktif/nonaktif, hapus, uji pencarian.
app/api/admin/model-speed/route.tsPOST /api/admin/model-speed — KHUSUS ADMIN: ukur kecepatan model lewat Kenari (detik sampai kata pertama). Tiap model diuji 2×: pesan mini ("halo", tanpa prompt sistem) dan pesan dengan prompt sistem sepanjang prompt Pepo (~6.000 token). Bedanya menunjukkan apakah yang lambat model/penyedianya, atau panjang prompt Pepo. Biaya sangat kecil (maks 30 token keluaran per uji).
app/api/admin/overview/route.tsRingkasan dashboard admin: angka yang perlu dilihat setiap hari dalam satu permintaan. Setiap angka diambil terpisah; tabel yang belum ada (SQL belum dijalankan) cukup menghasilkan null.
app/api/admin/site-content/route.tsAdmin: konten situs korporat (PEPSPACE) — karya/galeri, katalog, testimoni, mitra, FAQ, dan pesan masuk. Dikelola dari Admin Pepo supaya pemilik tidak perlu membuka cPanel untuk menambah foto/katalog.
app/api/admin/topup-approve/route.tsPOST /api/admin/topup-approve { requestId } — admin menyetujui pembayaran. Jumlah kredit DIHITUNG SERVER dari paket (bukan dari isian user), jadi permintaan tidak bisa dimanipulasi.
app/api/admin/usage/route.tsGET /api/admin/usage?days=30 — biaya model nyata, kredit tertagih, pendapatan, margin, dan kuota paket penyedia
app/api/admin/users/route.ts(tidak ada catatan di kode — komponen/utilitas pendukung)
app/api/agent/jobs/[id]/route.tsGET /api/agent/jobs/:id?from=N — status realtime + events baru + file hasil kerja POST /api/agent/jobs/:id { action: 'stop' | 'resume' | 'note' | 'ack', ... }
app/api/agent/jobs/route.tsGET /api/agent/jobs?projectId=... — job proyek ini yang masih berjalan atau hasilnya belum diterapkan
app/api/agent/run/route.tsPOST /api/agent/run (internal) — menjalankan satu sesi job di latar belakang
app/api/agent/sweep/route.tsGET /api/agent/sweep?key=... — membangunkan job yang macet (dipanggil cron tiap 5 menit)
app/api/artifact/route.tsArtefak: halaman interaktif buatan Pepo yang dibagikan lewat link pepoai.id/a/<id>. POST { title, html } → simpan (atau pakai ulang bila isi sama) dan kembalikan { id, url } GET → daftar artefak milik pengguna DELETE { id } → cabut link Wajib login. Batas: 1,5 MB per artefak, 60 artefak per akun (yang tertua harus dicabut dulu).
app/api/badge/route.tsPOST /api/badge { key } → izin menyimpan SATU hasil (rancangan/video) tanpa badge "Dibuat dengan Pepo". Gratis untuk admin & pelanggan Plus/Pro. Pengguna lain dipotong PEPO_FILE_BADGE_CREDITS (bawaan 10) sekali per hasil.
app/api/beta/route.tsGET /api/beta — status Beta gratis untuk tampilan aplikasi (publik, tanpa data pribadi).
app/api/bugs/route.tsLapor Bug Pepo (tanpa hadiah; dulu Bug Challenge) GET /api/bugs → { open, known[], mine[] } (mine hanya bila login) POST /api/bugs (multipart, wajib login) → kirim laporan
app/api/chat/result/route.tsGET /api/chat/result?id=<resumeId> — ambil jawaban chat yang ditulis server saat aplikasi sempat ditinggal
app/api/chat/route.ts(tidak ada catatan di kode — komponen/utilitas pendukung)
app/api/credits/route.tsGET /api/credits — status kredit, tier, dan BATAS PENGGUNAAN user (atau tamu) untuk tampilan aplikasi
app/api/custom-domain/route.ts(tidak ada catatan di kode — komponen/utilitas pendukung)
app/api/decompose/suggest-fix/route.ts(tidak ada catatan di kode — komponen/utilitas pendukung)
app/api/deploy/cleanup/route.ts(tidak ada catatan di kode — komponen/utilitas pendukung)
app/api/deploy/route.ts(tidak ada catatan di kode — komponen/utilitas pendukung)
app/api/deploy/status/route.ts(tidak ada catatan di kode — komponen/utilitas pendukung)
app/api/draft-refine/route.tsPOST /api/draft-refine { html, brief, photos?: string[], prevHtml?, request? } Penyempurna rancangan undangan/website (pepo189) sebagai PERMINTAAN TERPISAH dengan anggaran waktu penuh. Dipanggil aplikasi bila jawaban chat menandai _refine (penjaga mutu menemukan kekurangan, tetapi waktu di permintaan chat tidak cukup atau penyempurnaan di sana gagal). Mengembalikan { html } yang lebih baik, atau { unchanged: true }.
app/api/feedback/route.ts/api/feedback — POST kirim rating (jawaban Pepo / aplikasi), GET ringkasan untuk admin
app/api/fetch-url/route.ts(tidak ada catatan di kode — komponen/utilitas pendukung)
app/api/generate-title/route.ts(tidak ada catatan di kode — komponen/utilitas pendukung)
app/api/google/connect/route.ts/api/google/connect — status ekstensi, nyalakan/matikan per ekstensi, hubungkan (kode dari popup Google), putuskan.
app/api/google/token/route.tsGET /api/google/token — token akses Google berumur pendek (±1 jam) untuk akun yang sudah menghubungkan ekstensi. Refresh token tidak pernah keluar dari server.
app/api/image/edit/route.tsPOST /api/image/edit (multipart: image, prompt, model, aspect) — KHUSUS ADMIN, untuk menguji model edit foto. Satu model per panggilan (klien memanggil beberapa model paralel). Mencoba dua cara kirim foto referensi: 1) /images/edits (multipart, standar OpenAI) 2) /images/generations dengan field `image` (data URL) Mengembalikan {ok, url, model, method, ms, cost} atau {ok:false, error, tried}. Tidak memotong kredi
app/api/image/route.tsPOST /api/image { prompt, aspect: 'landscape' | 'portrait' | 'square', transparent?: boolean } Membuat gambar dengan model gambar Kenari (OpenAI-compatible /v1/images/generations), menyimpannya ke Supabase Storage (bucket project-assets, folder gen/), lalu mengembalikan URL publiknya. - Hanya untuk user yang login. Memotong kredit (PEPO_IMAGE_CREDITS, bawaan 5) kecuali gambar yang sama sudah pernah dibuat. - Gambar
app/api/image/template/route.tsPOST /api/image/template (multipart: template, image) — edit foto user memakai template populer. Prompt template ada di server (tersembunyi). Model: PEPO_EDIT_MODEL (bawaan gpt-image-2, wajahnya paling mirip saat diuji). Kredit dipotong sama seperti /api/image (PEPO_IMAGE_CREDITS), hanya setelah gambar berhasil dibuat.
app/api/image/template/thumbs/route.tsPOST /api/image/template/thumbs {id, rebase?} — KHUSUS ADMIN: buat thumbnail contoh satu template. Thumbnail dibuat dengan proses yang SAMA seperti milik pengguna: foto "sebelum" (foto orang rekaan yang sesuai konteks template, templates/<id>-base.png) diedit memakai prompt template yang sama dan model yang sama → contoh = hasil yang akan didapat pengguna. Foto "sebelum" dibuat per template sesuai konteksnya (atau ul
app/api/kb/contribute/route.tsKontributor Knowledge Base: HANYA menambah dokumen baru. Tidak bisa melihat isi KB, mengubah, atau menghapus (semua itu dari Admin › Knowledge Base). Siapa yang boleh diatur admin di Admin › Knowledge Base › Kontributor. GET → { role, categories, mine: dokumen yang dikirim akun ini (judul saja) } POST { action: 'create' } → dokumen baru (nonaktif sampai kiriman terakhir) POST { action: 'sugg
app/api/leads/route.tssrc/app/api/leads/route.ts
app/api/memory/route.ts/api/memory — GET daftar, POST tambah manual, DELETE ?id=... atau ?all=1
app/api/model-info/route.ts(tidak ada catatan di kode — komponen/utilitas pendukung)
app/api/music/route.tsSkill Musik & Ringtone. POST /api/music { prompt, lyrics?, instrumental?, title? } → pembuatan lagu dimulai di latar (2–3 menit), balas { id }. GET /api/music?id=... → status; saat selesai berisi URL lagu di Supabase Storage (gen/music/<id>.<format>). Kredit dipotong hanya bila lagu berhasil dibuat (Kenari juga tidak menagih lagu yang gagal).
app/api/notices/route.tsPemberitahuan untuk akun yang login (dari admin: batas harian direset, kredit ditambah, izin baru, dll). GET → { notices: terbaru dulu } POST { action: 'read' } → tandai semua sudah dibaca
app/api/preview/auto-fix/route.ts(tidak ada catatan di kode — komponen/utilitas pendukung)
app/api/preview/cleanup/route.ts(tidak ada catatan di kode — komponen/utilitas pendukung)
app/api/pricing/estimates/route.tsGET /api/pricing/estimates — kisaran kredit per aktivitas dari pemakaian NYATA 30 hari terakhir. Aktivitas dengan data < MIN_SAMPLE tidak ditampilkan (jangan menampilkan angka sebelum datanya cukup).
app/api/profile/age/route.tsGET /api/profile/age → { ok, needs, age, group, birthday } (tanggal lahir TIDAK pernah dikirim balik) ?md=BB-HH&y=TTTT = tanggal hari ini di perangkat pengguna; birthday = true bila hari itu ulang tahunnya (lahir 29 Feb dirayakan 28 Feb pada tahun bukan kabisat). Tanpa ?md dipakai tanggal WIB. POST /api/profile/age { birth_date: 'YYYY-MM-DD', guardian_ok?: boolean } → simpan tanggal lahir TERENKRIPSI Tanggal lahir
app/api/push/last/route.tsPOST /api/push/last { endpoint } — isi notifikasi terakhir untuk langganan ini (dipanggil service worker) URL endpoint push bersifat rahasia per perangkat, jadi dipakai sebagai kunci akses.
app/api/push/route.ts/api/push — GET kunci publik, POST simpan langganan, DELETE hapus langganan
app/api/share/[token]/route.ts(tidak ada catatan di kode — komponen/utilitas pendukung)
app/api/share/route.ts(tidak ada catatan di kode — komponen/utilitas pendukung)
app/api/skills/route.tsGET /api/skills → harga skill kreatif (kredit per pemakaian), dibaca kartu & menu Skill.
app/api/stock-photo/route.tsFoto contoh Unsplash untuk kartu rancangan (img data-photo). Hanya untuk pengguna yang login.
app/api/system/deploy/route.tsDeploy sistem Pepo dalam DUA tahap (khusus admin, endpoint & env var Vercel yang sama): 1) POST {stage:'verify', files, deleted} review statis (sintaks, JSON, import) → build PREVIEW di project yang sama (tsc + next build sungguhan, tidak menyentuh produksi) → {id, url, token} 2) GET ?id=dpl_xxx&smoke=1 → status build; bila READY, uji asap halaman preview 3) POST {stage:'production', files, deleted, previewId, tok
app/api/system/route.tsGET /api/system → status sistem: project Vercel, deployment produksi, domain, daftar deployment untuk rollback (khusus admin) GET /api/system?tree=1 → daftar file produksi [path, sha1] POST /api/system {action:'rollback', id} → promote deployment produksi READY sebelumnya (khusus admin)
app/api/system/upload/route.tsPOST /api/system/upload (byte mentah, maks 4 MB) — KHUSUS ADMIN. Mengunggah satu berkas kode/gambar Pepo ke penyimpanan file Vercel dan mengembalikan {sha, size} untuk dipakai deploy sistem (shaFiles). Dipakai saat ZIP kode Pepo diimpor ke obrolan Sistem.
app/api/tts/route.ts(tidak ada catatan di kode — komponen/utilitas pendukung)
app/api/upgrade/route.tsPOST /api/upgrade — aktivasi berbayar yang dihitung & dipotong di SERVER (bukan di aplikasi user): { kind: 'project', projectId } -> deploy untuk satu proyek (ACTIVATION.project kredit) { kind: 'unlimited' } -> deploy tanpa batas untuk semua proyek { kind: 'account' } -> akun Pro (custom domain)
app/api/upload/route.tsPOST /api/upload (multipart: file, projectId, path) — publikasi aset proyek ke penyimpanan Pepo. Wajib login dan pemilik proyek. Nama file tetap per proyek+path (upsert), jadi Deploy ulang tidak menggandakan file.
app/api/v1/categories/route.tssrc/app/api/v1/categories/route.ts
app/api/v1/chat/route.ts(tidak ada catatan di kode — komponen/utilitas pendukung)
app/api/v1/inquiry/route.tsPublik: formulir kontak situs korporat → disimpan untuk dibaca di Admin Pepo (tab Situs PEPSPACE → Pesan masuk). Pengaman: hanya dari domain yang diizinkan, batas laju per IP (bersama widget AI), honeypot anti-bot, panjang dibatasi.
app/api/v1/personas/route.ts(tidak ada catatan di kode — komponen/utilitas pendukung)
app/api/v1/site-content/route.tsPublik: konten situs korporat yang sudah dipublikasikan (karya, katalog, testimoni, mitra, FAQ). Dibaca server situs pepsspace.com (tanpa Origin) dan browser pengunjung. Hanya data publik; di-cache 60 detik.
app/api/v1/site-context/route.tssrc/app/api/v1/site-context/route.ts Site-aware chat endpoint: inject knowledge base per site_id
app/api/v1/suggest-roles/route.tssrc/app/api/v1/suggest-roles/route.ts
app/api/version/route.tsGET /api/version → penanda versi yang sedang live (publik, tanpa data sensitif). Cek dari browser: https://pepoai.id/api/version → "build" harus sama dengan yang tertulis di CATATAN patch.
app/api/video/route.tsSkill Video AI. POST /api/video { prompt, aspect: '9:16' | '16:9' | '1:1', title?, image? (data URL) | image_url? (storage Pepo) } → mulai render di Kenari, potong kredit, balas { id }. GET /api/video?id=... → status. Saat selesai, klip disalin ke Supabase Storage (gen/video/<id>.mp4) lalu dibalas URL publiknya. Render gagal/kedaluwarsa → kredit dikembalikan (Kenari juga tidak menagih).
src/app/ 23 file
FileKenapa dibuat / fungsinya (dari catatan di kode)
app/a/[id]/ArtifactView.tsxPenampil artefak publik: halaman dijalankan di iframe ber-sandbox (tanpa akses ke akun/cookie pepoai.id). Status penonton (centang, isian) disimpan di perangkatnya sendiri lewat shim localStorage.
app/a/[id]/page.tsxHalaman publik artefak: pepoai.id/a/<id>. Tidak diindeks mesin pencari; siapa pun yang punya link bisa membuka.
app/app/page.tsxHalaman aplikasi: pepoai.id/app. Isi menyesuaikan perangkat (dibaca dari user-agent di server, jadi tanpa kedip): Android → tombol unduh APK · iPhone/iPad → cara Tambah ke Layar Utama lewat Safari · laptop → buka di HP Browser bawaan Instagram/Facebook/TikTok → diminta buka di Chrome/Safari dulu (di sana unduh & pasang sering gagal) ?os=android | ?os=ios untuk melihat panduan perangkat lain.
app/auth/callback/page.tsxKembalian login Google/Microsoft/Apple. Semua diproses DI BROWSER, satu tempat: - ?code=... → alur PKCE (bawaan @supabase/ssr). Klien Supabase menukar kode otomatis saat dimuat. - #access_token=ey... → alur lama/implicit (mis. tautan email lama). Dipasang manual lalu DIHAPUS dari alamat. - ?error_description= → pesan dari Supabase/Google, ditampilkan dengan bahasa sederhana. Token tidak pernah dibiarkan
app/bug/page.tsxpepoai.id/bug — Lapor Bug Pepo (tanpa hadiah; dulu Bug Challenge). Pepo gratis selama beta.
app/coba/page.tsxPintu masuk dari situs lain (mis. widget "Coba Pepo" di pepsspace.com): pepoai.id/coba?prompt=... Prompt dititipkan (30 menit) lalu otomatis terisi di kolom chat Pepo. TIDAK dikirim otomatis: pengguna yang menekan Kirim.
app/ketentuan/page.tsx(tidak ada catatan di kode — komponen/utilitas pendukung)
app/layout.tsx(tidak ada catatan di kode — komponen/utilitas pendukung)
app/page.tsxHalaman depan Pepo: - Sudah login → langsung ke percakapan (/workspace) - Menekan "Coba tanpa akun" → percakapan sebagai tamu, hanya selama aplikasi/tab ini terbuka (tidak diingat) - Pengunjung baru → Masuk / Daftar / Tamu (form sama dengan dialog di navbar)
app/panduan/[slug]/page.tsxHalaman satu tutorial: langkah bernomor, contoh kasus (bisa langsung dipakai), dan masalah umum.
app/panduan/page.tsxPusat panduan: rumus prompt, tutorial fitur per kelompok, dan pintu ke contoh prompt.
app/panduan/prompt/page.tsxDokumentasi prompt: rumus, tips, dan 100+ contoh kasus prompt kurang vs lebih baik.
app/privasi/page.tsx(tidak ada catatan di kode — komponen/utilitas pendukung)
app/reset-password/page.tsx(tidak ada catatan di kode — komponen/utilitas pendukung)
app/robots.tsrobots.txt: izinkan halaman publik dibaca mesin pencari & mesin jawaban AI; ruang kerja, API, dan link Bagikan tidak.
app/share/[token]/page.tsx(tidak ada catatan di kode — komponen/utilitas pendukung)
app/share/layout.tsxHalaman pribadi (ruang kerja / link Bagikan untuk client): jangan diindeks mesin pencari.
app/sitemap.tssitemap.xml: daftar halaman publik Pepo untuk Google Search Console.
app/solusi/[slug]/page.tsxHalaman solusi per kata kunci (mis. /solusi/ai-agent-umkm). Server component statis: cepat dan mudah dibaca mesin pencari & mesin jawaban AI. Isi diambil dari src/lib/seo-pages.ts.
app/solusi/page.tsxDaftar semua halaman solusi: pintu masuk internal link untuk mesin pencari.
app/tentang/page.tsxHalaman publik "Tentang Pepo": dibaca mesin pencari & mesin jawaban AI (server component, tanpa JavaScript).
app/workspace/layout.tsxHalaman pribadi (ruang kerja / link Bagikan untuk client): jangan diindeks mesin pencari.
app/workspace/page.tsx(tidak ada catatan di kode — komponen/utilitas pendukung)
src/components/workspace/ 28 file
FileKenapa dibuat / fungsinya (dari catatan di kode)
components/workspace/AIPanel.tsx(tidak ada catatan di kode — komponen/utilitas pendukung)
components/workspace/AccountAvatar.tsxIdentitas akun yang mudah dikenali: avatar inisial (login) atau label "Tamu". Dipakai di tombol menu kanan atas, kartu akun di menu, dan bagian bawah sidebar.
components/workspace/AdminNotifBell.tsx(tidak ada catatan di kode — komponen/utilitas pendukung)
components/workspace/AdminPanel.tsx(tidak ada catatan di kode — komponen/utilitas pendukung)
components/workspace/Canvas.tsx(tidak ada catatan di kode — komponen/utilitas pendukung)
components/workspace/CustomDomainDialog.tsx(tidak ada catatan di kode — komponen/utilitas pendukung)
components/workspace/DeployDialog.tsx(tidak ada catatan di kode — komponen/utilitas pendukung)
components/workspace/ExtensionsDialog.tsxMenu Ekstensi: satu toggle per ekstensi. Izin Google diminta saat Drive/Sheets pertama kali dinyalakan, lalu tersimpan di akun (tidak diminta lagi). Pepo membaca status ini untuk menyesuaikan tawaran & alatnya.
components/workspace/FeedbackDialog.tsx(tidak ada catatan di kode — komponen/utilitas pendukung)
components/workspace/FileTreeItem.tsx(tidak ada catatan di kode — komponen/utilitas pendukung)
components/workspace/Header.tsx(tidak ada catatan di kode — komponen/utilitas pendukung)
components/workspace/KbContributeDialog.tsxKontributor Knowledge Base: hanya menambah dokumen (unggah file atau tempel teks). Tidak menampilkan isi Knowledge Base; hanya judul dokumen yang pernah dikirim akun ini.
components/workspace/KbJobPill.tsxPenanda kemajuan unggahan Knowledge Base yang berjalan di latar (lihat lib/workspace/kb-upload-job.ts). Bentuknya bulatan kecil (cincin persentase) di kanan atas di bawah header, tidak menutupi kolom chat. Bisa digeser (posisi diingat di perangkat), ketuk untuk melihat rincian / Batal. Disembunyikan saat log out; proses tetap jalan.
components/workspace/MemoryDialog.tsxPanel Memori Pepo: fakta yang diingat Pepo tentang user, bisa ditambah dan dihapus.
components/workspace/MobileWorkspace.tsx(tidak ada catatan di kode — komponen/utilitas pendukung)
components/workspace/OnboardingWizard.tsx(tidak ada catatan di kode — komponen/utilitas pendukung)
components/workspace/PricingHelp.tsxBagian bawah halaman Top Up: perkiraan pemakaian kredit (dari data nyata) + tanya jawab aturan kredit & langganan.
components/workspace/ShareDialog.tsx(tidak ada catatan di kode — komponen/utilitas pendukung)
components/workspace/ShareGuests.tsx"Bagikan ke tamu": tempel daftar nama tamu (satu per baris) → link pribadi ?to=Nama + pesan WhatsApp siap kirim.
components/workspace/Sidebar.tsx(tidak ada catatan di kode — komponen/utilitas pendukung)
components/workspace/SkillsDialog.tsxMenu Skill: skill kreatif (Foto AI, Video AI, Musik & Ringtone) + pintu ke Aplikasi terhubung (ekstensi Google, WhatsApp, Email).
components/workspace/StatsModal.tsxStatistik percakapan yang sedang dibuka. Semua angka berasal dari data nyata (lihat lib/workspace/session-stats.ts).
components/workspace/TopUpDialog.tsx(tidak ada catatan di kode — komponen/utilitas pendukung)
components/workspace/TreeItem.tsx(tidak ada catatan di kode — komponen/utilitas pendukung)
components/workspace/UpgradeDialog.tsxAjakan upgrade: muncul saat jatah gratis habis, kredit habis, atau berkala setelah beberapa jawaban Pepo Lite.
components/workspace/UpsellDialog.tsx(tidak ada catatan di kode — komponen/utilitas pendukung)
components/workspace/UsageDialog.tsx"Batas penggunaan": berapa yang sudah dipakai hari ini, sisa, dan kapan direset. Data dari /api/credits (dimuat Header). UsageNudge memakai data yang sama untuk peringatan di atas kolom pesan.
components/workspace/WorkspaceActions.tsx(tidak ada catatan di kode — komponen/utilitas pendukung)
src/components/workspace/canvas/ 29 file
FileKenapa dibuat / fungsinya (dari catatan di kode)
components/workspace/canvas/ActionCard.tsx(tidak ada catatan di kode — komponen/utilitas pendukung)
components/workspace/canvas/ActivityLog.tsxLog aktivitas Pepo (khusus mode kerja). Jawaban chat biasa TIDAK memakai komponen ini. - LiveActivityLog: saat Pepo bekerja. Ringkas 1 baris secara default; panah bawah membuka tampilan penuh dengan animasi mengetik, jadi user bisa melihat apa yang sedang ditulis Pepo. - ActivityLogBlock: log yang sudah selesai di riwayat chat, terlipat secara default.
components/workspace/canvas/AgentActivityCard.tsx(tidak ada catatan di kode — komponen/utilitas pendukung)
components/workspace/canvas/AgentMessage.tsxTampilan balasan agent: narasi + semua tahap dalam SATU "Log aktivitas" yang terlipat (isi tahap bisa dibuka), laporan akhir dan status berhenti punya kartu sendiri.
components/workspace/canvas/AgentStatusCard.tsx(tidak ada catatan di kode — komponen/utilitas pendukung)
components/workspace/canvas/AssistantCards.tsxKartu asisten di jawaban chat: ```pepo-event {json}``` → kartu jadwal (Simpan ke Google Calendar / kalender HP dengan pengingat) ```pepo-sheet {json}``` → kartu tabel catatan (Catat ke Google Sheets / unduh CSV / salin) Blok yang belum lengkap (masih streaming) disembunyikan sampai selesai.
components/workspace/canvas/AttachmentThumbs.tsxThumbnail lampiran di gelembung chat user. Ketuk foto untuk melihat ukuran penuh.
components/workspace/canvas/BadgeToggle.tsxPilihan badge "Dibuat dengan Pepo" untuk satu hasil (rancangan, gambar cetak, video). Plus/Pro/admin: badge mati dan gratis. Lainnya: badge kecil menyala; menghapusnya memotong kredit sekali per hasil.
components/workspace/canvas/ChatGreeting.tsxUcapan ringan di obrolan baru (menggantikan "Halo, saya Pepo Assistant" + penjelasan panjang): - hari ulang tahun pengguna → "Selamat ulang tahun, <nama>" - Sabtu/Minggu → "Selamat akhir pekan, <nama>" - selain itu menurut jam perangkat → Selamat pagi / siang / sore / malam Ulang tahun ditanyakan ke server (GET /api/profile/age?md=BB-HH → { birthday }): tanggal lahir tersimpan terenkripsi dan tidak pernah dikirim ke
components/workspace/canvas/ChecklistCard.tsx(tidak ada catatan di kode — komponen/utilitas pendukung)
components/workspace/canvas/CodeBlock.tsxBlok kode berwarna ala terminal untuk jawaban Pepo (markdown). Dipakai lewat markdownComponents.
components/workspace/canvas/CodePane.tsx(tidak ada catatan di kode — komponen/utilitas pendukung)
components/workspace/canvas/CommandBar.tsx(tidak ada catatan di kode — komponen/utilitas pendukung)
components/workspace/canvas/ConversationTimeline.tsx(tidak ada catatan di kode — komponen/utilitas pendukung)
components/workspace/canvas/CopyButton.tsx(tidak ada catatan di kode — komponen/utilitas pendukung)
components/workspace/canvas/DatabasePane.tsx(tidak ada catatan di kode — komponen/utilitas pendukung)
components/workspace/canvas/DecomposeCard.tsx(tidak ada catatan di kode — komponen/utilitas pendukung)
components/workspace/canvas/FileManagerPane.tsxFile Manager: mengelola berkas (buka di editor, ganti nama, salin, pindah, unduh, hapus). Sengaja TIDAK menampilkan editor kode; editor ada di tab Code Editor.
components/workspace/canvas/MediaCards.tsxKartu skill media di chat: ```pepo-video {"title","prompt","scenes":[...],"aspect":"9:16","caption"}``` ```pepo-music {"title","style","lyrics","instrumental":false,"ringtone":true}``` Kartu menampilkan RANCANGAN dulu (naskah/lirik). Video/lagu baru dibuat (dan kredit dipotong) setelah user menekan "Buat".
components/workspace/canvas/MessageRenderer.tsx(tidak ada catatan di kode — komponen/utilitas pendukung)
components/workspace/canvas/PipelineProgress.tsx(tidak ada catatan di kode — komponen/utilitas pendukung)
components/workspace/canvas/PreviewPane.tsx(tidak ada catatan di kode — komponen/utilitas pendukung)
components/workspace/canvas/ProgressCard.tsx(tidak ada catatan di kode — komponen/utilitas pendukung)
components/workspace/canvas/TaskProgressCard.tsx(tidak ada catatan di kode — komponen/utilitas pendukung)
components/workspace/canvas/TemplateGallery.tsxGaleri Template: dibuka dari tombol di KIRI kolom chat (menggantikan deretan template di atas kolom chat). - Foto AI: kartu edit foto populer. Thumbnail = hasil asli prompt template pada foto contoh (dibuat admin). - Tab lain: contoh prompt siap pakai (dari Panduan Prompt). Ketuk → prompt masuk ke kolom chat untuk diedit dulu.
components/workspace/canvas/VoiceMode.tsx(tidak ada catatan di kode — komponen/utilitas pendukung)
components/workspace/canvas/preview/NextJSPreview.tsx(tidak ada catatan di kode — komponen/utilitas pendukung)
components/workspace/canvas/preview/SandpackPreview.tsx(tidak ada catatan di kode — komponen/utilitas pendukung)
components/workspace/canvas/preview/SystemPreview.tsxPanel Preview obrolan Sistem: daftar file yang berubah + tombol "Bangun preview" (versi uji Pepo di Vercel dari semua file live + perubahan di obrolan ini). Hasilnya dibuka di tab baru (preview Vercel bisa meminta login Vercel) atau langsung di panel. Produksi tidak tersentuh; rilis tetap lewat patch + `bash pepo` atau perintah deploy ke Pepo.
src/components/workspace/admin/ 9 file
FileKenapa dibuat / fungsinya (dari catatan di kode)
components/workspace/admin/AssetsTab.tsxAdmin › Asset Base: pustaka aset desain yang menjadi rujukan Pepo (undangan per adat, website per jenis usaha). Unggah aset per kategori › subkategori › paket, atur perannya (ornamen utama, sudut, bingkai, kupu-kupu, ...), aktif/nonaktif, hapus. Pepo memilih paket sesuai tema yang diminta user; peran kosong diisi aset "dipakai bersama".
components/workspace/admin/BetaTab.tsxAdmin › Beta gratis: satu saklar untuk menggratiskan semua fitur Pepo selama beta, dengan batas yang menjaga pemakaian tetap di dalam kuota paket Kenari. Angka pemakaian diambil dari catatan biaya model (usage_daily).
components/workspace/admin/BugsTab.tsxAdmin Laporan Bug: periksa laporan (urut terbaru), tandai Terkonfirmasi / Sudah diperbaiki / Duplikat / Bukan bug, kelola daftar "bug yang sudah diketahui". Tanpa hadiah sejak pepo158 (nilai status "dibayar" = sudah diperbaiki).
components/workspace/admin/EconomicsTab.tsxAdmin › Ringkasan & Analisis: Credit Utilization & Unit Economics tanpa membuka SQL. 4 metrik utama (diberikan, dipakai, hangus, biaya nyata) lalu dipecah per paket, cohort bulan pembelian, usia langganan, jenis pemakaian, dan pengguna paling aktif. Temuan otomatis ditulis dalam bahasa biasa.
components/workspace/admin/ImageLabTab.tsxTab admin: uji beberapa model gambar dengan foto + prompt yang sama (untuk fitur template foto tren).
components/workspace/admin/KnowledgeTab.tsxAdmin Knowledge Base: tambah dokumen rujukan (unggah file atau tempel teks), atur kategori, aktif/nonaktif, hapus, dan uji pencarian (melihat potongan apa yang akan dibaca Pepo untuk sebuah pertanyaan).
components/workspace/admin/OverviewTab.tsxBeranda admin: angka harian yang paling sering dicek, masing-masing bisa diketuk untuk membuka bagiannya.
components/workspace/admin/SiteContentTab.tsxAdmin "Situs PEPSPACE": kelola karya/galeri, katalog, testimoni, mitra, FAQ, dan pesan masuk situs korporat tanpa cPanel. Foto dikecilkan di browser (maks 1600px) sebelum diunggah. Perubahan tampil di situs ±1 menit.
components/workspace/admin/SystemTab.tsxTab admin: obrolan khusus untuk memperbaiki Pepo / situs PepsSpace / PepsOS + status produksi + rollback per aplikasi.
src/components/ 21 file
FileKenapa dibuat / fungsinya (dari catatan di kode)
components/analytics/GoogleAnalytics.tsxsrc/components/analytics/GoogleAnalytics.tsx Google Analytics 4 untuk statistik lalu lintas aplikasi Pepo (kunjungan, halaman, perangkat, asal pengunjung). - ID Pengukuran bersifat publik. Bisa diganti lewat env NEXT_PUBLIC_GA_ID; isi "off" untuk mematikan. - Dimuat setelah halaman interaktif (tidak memperlambat tampilan pertama). - Hanya aplikasi Pepo yang diukur. Website yang dibuat/di-deploy user TIDAK ikut diberi
components/android/AndroidAppPrompt.tsxAjakan memasang aplikasi Android (kecil, bisa ditutup): muncul 5 detik setelah halaman dibuka, lalu muncul lagi SETIAP 2 MENIT setelah ditutup, hanya di HP Android yang BELUM memakai aplikasinya.
components/android/InstalledNotice.tsxDi halaman /app: bila Pepo sudah dibuka sebagai aplikasi (APK Android atau ikon layar utama iPhone), beri tahu dan arahkan ke Pepo.
components/auth/AuthDialog.tsxDialog Masuk/Daftar dari navbar. Isinya form yang SAMA dengan halaman depan (AuthForm), ditampilkan sebagai lembar kaca dari bawah di HP dan kartu di tengah di layar besar.
components/auth/AuthForm.tsxSatu form Masuk / Daftar / Lupa password untuk SEMUA tempat: halaman depan (/) dan dialog dari navbar. Ubah di sini, keduanya ikut berubah.
components/auth/LogoDrawIntro.tsxLogo Pepo di atas form masuk: digambar garis demi garis (draw-on, tempo pelan ±5 detik), lalu berubah jadi logo asli, memudar, dan digambar lagi: berulang selama halaman terbuka. Murni SVG + CSS. Bila perangkat meminta gerakan dikurangi (prefers-reduced-motion), logo langsung tampil tanpa animasi. Garis diambil dari /icons/pepo-mark.png (700x785). Tanpa teks.
components/bug/BugChallenge.tsxHalaman Lapor Bug (pepoai.id/bug): form laporan (wajib login), bug yang sudah diketahui, dan status laporan milikku. Tanpa hadiah sejak pepo158: dulu Bug Challenge berhadiah; Pepo gratis selama beta. Nama file dipertahankan.
components/i18n/Translator.tsxPenerjemah tampilan statis: saat Basa Jawa dipilih, teks tombol/menu/label diganti dari kamus (lib/i18n/jv.ts). Tidak menyentuh isi chat, kode, kolom ketik, dan preview (iframe), dan tidak memanggil AI.
components/icons/index.tsx(tidak ada catatan di kode — komponen/utilitas pendukung)
components/legal/LegalPage.tsxKerangka halaman Kebijakan Privasi & Ketentuan Layanan (server component, tanpa JavaScript di browser)
components/profile/BirthDateFields.tsxIsian tanggal lahir: 3 pilihan (tanggal, bulan, tahun) supaya mudah di HP; tahun lahir lama tidak perlu digulir dari kalender.
components/profile/ProfileCompletePrompt.tsxPopup "Lengkapi profil": akun yang belum punya tanggal lahir (terdaftar sebelum aturan ini, atau daftar lewat Google). Bisa ditunda ("Nanti saja"), tapi muncul lagi setiap aplikasi dibuka sampai diisi. Daftar lewat Google: tanggal lahir yang diisi di form daftar dititipkan di perangkat lalu dikirim otomatis di sini.
components/public/PromptExplorer.tsxDaftar contoh prompt dengan pencarian & filter kategori. Semua isi tetap dirender di server (terbaca mesin pencari).
components/public/PublicShell.tsxKerangka semua halaman publik Pepo (Tentang, Solusi, Panduan, Privasi, Ketentuan): menu atas & bawah yang sama di setiap halaman supaya navigasi konsisten. Server component, tanpa JavaScript.
components/public/UsePrompt.tsxTombol di halaman panduan: salin prompt, atau "Pakai di Pepo" (prompt dititipkan lalu otomatis terisi di kolom chat).
components/ui/Badge.tsx(tidak ada catatan di kode — komponen/utilitas pendukung)
components/ui/Button.tsx(tidak ada catatan di kode — komponen/utilitas pendukung)
components/ui/Logo.tsx(tidak ada catatan di kode — komponen/utilitas pendukung)
components/ui/Panel.tsx(tidak ada catatan di kode — komponen/utilitas pendukung)
components/ui/Skeleton.tsx(tidak ada catatan di kode — komponen/utilitas pendukung)
components/ui/Toast.tsx(tidak ada catatan di kode — komponen/utilitas pendukung)
src/lib/ai/ 23 file
FileKenapa dibuat / fungsinya (dari catatan di kode)
lib/ai/agent-client.tssrc/lib/ai/agent-client.ts (CLIENT) Orkestrator lanjut-otomatis: jalankan sesi agent berulang sampai selesai.
lib/ai/agent-plan.tssrc/lib/ai/agent-plan.ts (dipakai server dan client) Membaca rencana tahap dari prompt user ("TAHAP 1 — AUDIT MANDIRI", dst.).
lib/ai/agent-types.tssrc/lib/ai/agent-types.ts Protocol types untuk agent loop dengan 2-fase (plan → execute)
lib/ai/agent.tssrc/lib/ai/agent.ts Orchestrator 2-fase: plan → execute loop. Semua read/list dieksekusi lokal di client (file ada di workspace state).
lib/ai/app-guide.tsPeta aplikasi Pepo untuk Pepo sendiri: fitur terbaru, letak menu, harga & aturan kredit. Angka dibaca dari plan-config & media.ts, jadi jawaban Pepo ikut berubah saat harga/kuota diubah. Disisipkan hanya bila user bertanya tentang Pepo/aplikasinya (hemat token untuk chat biasa).
lib/ai/chunker.tssrc/lib/ai/chunker.ts Client-side orchestrator: outline → loop sections → merge → final HTML
lib/ai/context-templates.tssrc/lib/ai/context-templates.ts Template kategori + field + role mapping per industri
lib/ai/decompose-executor.tssrc/lib/ai/decompose-executor.ts Orchestrator untuk eksekusi project bertahap. Setiap task dieksekusi 1-turn via /api/chat mode 'direct'.
lib/ai/draft-gate.ts===== PENJAGA MUTU RANCANGAN WEB (pepo183) ===== Model chat kadang menulis rancangan undangan/website yang jauh lebih sederhana dari aturan premium (tanpa hitung mundur, tanpa nama tamu ?to=, data user hilang, kupu-kupu emoji), dan revisi kecil ("tambahin kupu-kupu") kadang menulis ulang rancangan dari nol sehingga data & bagian lama hilang. Modul ini memeriksa kartu pepo-preview TERAKHIR secara deterministik; bila k
lib/ai/humanize.tssrc/lib/ai/humanize.ts Menghapus/mengganti nama alat internal (list_files, write_file, dst.) dari teks yang dibaca user.
lib/ai/kenari-models.tsKemampuan model dari daftar resmi Kenari (GET /v1/models, publik). Dipakai untuk: mengatur penalaran per tugas, memaksa tool hanya pada model yang mendukung tool, dan memilih model embedding/moderasi. Disimpan di memori server 1 jam; bila gagal diambil, semua fungsi jatuh ke perilaku aman (tidak mengirim parameter yang belum pasti didukung).
lib/ai/memory.ts(tidak ada catatan di kode — komponen/utilitas pendukung)
lib/ai/models.tssrc/lib/ai/models.ts
lib/ai/page-test.tssrc/lib/ai/page-test.ts Uji statis halaman HTML (tanpa browser): validasi CTA, link, anchor, gambar, meta mobile. Tanpa dependency eksternal. TIDAK mengeksekusi JavaScript dan TIDAK merender tampilan.
lib/ai/patch.tssrc/lib/ai/patch.ts Line + anchor based patch applier untuk AI actions (hemat token)
lib/ai/pepo-models.tsNama model Pepo (keluarga model, bukan satu model). Tiap nama = sekelompok model setingkat dari mitra AI; Pepo memilih model terbaik di dalam kelompok itu dan berpindah ke cadangan bila sibuk. Nama penyedia asli TIDAK ditampilkan ke pengguna (hanya admin melihat model asli di catatan waktu).
lib/ai/persona.tssrc/lib/ai/persona.ts Preset persona + resolver untuk multi-persona
lib/ai/premium-web.tsRESEP PREMIUM untuk website, landing page, dan undangan digital Pepo. Diturunkan dari video iklan "Undangan Jawa Premium" (pepo174): sampul pembuka yang dibuka, aset ilustrasi berlapis (sudut bunga, bingkai lengkung, untaian, pemisah, tekstur kertas), gerak halus (muncul saat digulir, Ken Burns, kupu-kupu terbang), tipografi serif + script, warna diturunkan dari aset. Dipakai di rancangan (kartu pepo-preview) dan di
lib/ai/pricing.tssrc/lib/ai/pricing.ts (HANYA server) Tarif model dalam Rupiah per 1 juta token, diambil dari katalog penyedia (diperbarui tiap 24 jam). Tabel cadangan di bawah = katalog per 4 Nov 2026 (katalog memakai micro-Rupiah; sudah dibagi 1.000.000).
lib/ai/router.tssrc/lib/ai/router.ts
lib/ai/stream-call.tssrc/lib/ai/stream-call.ts Satu panggilan chat-completions dengan STREAMING. - Token mengalir terus, jadi tidak ada koneksi diam yang diputus proxy/Kenari/Vercel. - Teks diteruskan lewat onText (efek mengetik di UX). - Watchdog: tidak ada data selama idleMs = dianggap macet; deadlineMs = batas mutlak panggilan.
lib/ai/text-attachments.tssrc/lib/ai/text-attachments.ts Ubah lampiran teks/kode dari user (data URL) menjadi file yang bisa dibaca Pepo via read_file.
lib/ai/tools.ts(tidak ada catatan di kode — komponen/utilitas pendukung)
src/lib/server/ 29 file
FileKenapa dibuat / fungsinya (dari catatan di kode)
lib/server/admin.tssrc/lib/server/admin.ts (HANYA server) Akses database dengan service role, verifikasi login user, dan token internal antar-fungsi server.
lib/server/asset-base.tsAsset Base Pepo (server): menyimpan daftar aset unggahan admin di pepo_settings (kunci "asset_base") dan memilih aset yang cocok untuk permintaan user (tema adat/kategori usaha), lalu menuliskannya ke prompt Pepo. Paket bawaan (BUILTIN_ASSETS) ikut aplikasi di /public/aset-base dan selalu tersedia kecuali dinonaktifkan admin.
lib/server/beta.tsMode "Beta gratis": semua fitur Pepo gratis untuk semua akun (dan tamu, lebih terbatas) selama masa beta. Tidak ada kredit yang dipotong; biaya model tetap dicatat. Supaya tidak melewati kuota paket Kenari, ada: - jatah biaya harian per akun (userDailyIdr) & per tamu (guestDailyIdr) - rem anggaran harian global (dailyBudgetIdr, bawaan = kuota mingguan Kenari / 7 × 90%) Jatah habis → akun kembali ke aturan biasa (akun
lib/server/bugs.tsLaporan bug Pepo (server). Dulu "Bug Challenge" berhadiah; sejak pepo158 (versi 2.0.150) menjadi halaman Lapor Bug biasa tanpa hadiah, karena Pepo gratis selama beta. Tabel tetap sama (pepo-v15.sql), jadi tidak perlu SQL baru. Status (nilai di database tetap): baru · valid (= terkonfirmasi, sedang diperbaiki) · dibayar (= SUDAH DIPERBAIKI; nama lama dipertahankan supaya tidak perlu mengubah constraint tabel) · duplik
lib/server/chat-results.tssrc/lib/server/chat-results.ts (SERVER) Penyimpanan jawaban chat yang sedang/selesai ditulis, supaya aplikasi yang sempat ditinggal (pindah aplikasi, layar terkunci, ditutup) bisa mengambil jawabannya tanpa membuat ulang (kredit tidak terpotong dua kali).
lib/server/db-schema.tssrc/lib/server/db-schema.ts (HANYA server, HANYA untuk obrolan Sistem milik admin) Peta database untuk obrolan Sistem: membaca STRUKTUR database (tabel, kolom, aturan, akses/RLS, fungsi, bucket), bukan isi data pengguna, lewat fungsi public.pepo_schema() (pepo-v22.sql di Supabase Pepo, pepsos-v4.sql di Supabase PepsOS). - db "pepo" → Supabase Pepo (dipakai Pepo dan situs PepsSpace lewat API /api/v1/*) - db "pepsos
lib/server/design-ref.tsReferensi desain dari URL user ("buatin undangan dengan referensi ini: https://..."). Model chat tidak bisa membuka link, jadi server membaca halamannya sekali: judul, deskripsi, font, warna dominan, urutan bagian & potongan teks. Hasilnya dipakai sebagai ARAH GAYA (bukan untuk disalin). Halaman yang dirender JavaScript (isi kosong saat diambil server) dilaporkan apa adanya.
lib/server/gen-image.tsKunci & URL gambar AI Pepo (kartu ```pepo-image``` dan data-gen). Dipakai /api/image (membuat & menyimpan) dan /api/chat (mendaftar aset gambar yang sudah dibuat di obrolan supaya bisa dipakai di website/undangan). PENTING: rumus kunci tidak boleh berubah, karena gambar lama dicari ulang dengan kunci yang sama.
lib/server/google.tssrc/lib/server/google.ts (SERVER) Ekstensi Google "sekali per akun": refresh token disimpan terenkripsi (AES-256-GCM) di tabel google_connections. Env wajib (rahasia, hanya di Vercel): GOOGLE_CLIENT_SECRET. Client ID diambil dari env publik / bawaan.
lib/server/image-edit.tsEdit foto dengan foto referensi lewat Kenari: /images/edits dulu, lalu /images/generations + field `image`.
lib/server/image-template-prompts.tsPrompt tersembunyi tiap template. `edit` dipakai untuk mengedit foto user; `scene` untuk membuat thumbnail contoh (orang rekaan, bukan orang sungguhan). Jangan impor file ini dari komponen klien.
lib/server/kb-access.tsHak akses Knowledge Base: admin : semua (lihat, tambah, ubah, hapus, uji cari, indeks makna) lewat Admin › Knowledge Base kontributor : HANYA menambah dokumen baru (tidak bisa melihat isi KB, mengubah, atau menghapus) Daftar email kontributor disimpan di pepo_settings (kunci "kb_contributors"), diatur dari Admin › Knowledge Base. Env PEPO_KB_CONTRIBUTORS (dipisah koma) ikut dihitung sebagai cadangan.
lib/server/kb-append.tsMenambah isi dokumen Knowledge Base per bagian (dipakai Admin › Knowledge Base dan dialog Kontributor). Aman diulang: klien mengirim `offset` (jumlah karakter yang seharusnya sudah tersimpan). Bila bagian yang sama terkirim dua kali (jawaban server hilang di jalan lalu dicoba lagi), bagian itu tidak disimpan ganda. Potongan sisa dari kiriman yang terputus di tengah dibersihkan dulu sebelum menyimpan.
lib/server/kb-embed.tsPencarian MAKNA untuk Knowledge Base (lintas bahasa): embeddings + rerank dari Kenari. - POST /v1/embeddings (kompatibel OpenAI): teks → vektor. Pertanyaan berbahasa Indonesia bisa menemukan materi berbahasa Korea, dst. - POST /v1/rerank: mengurutkan kandidat dari pencarian kata kunci + makna, dan membuang yang tidak relevan. Model dipilih dari env (PEPO_EMBED_MODEL / PEPO_RERANK_MODEL) atau otomatis dari katalog Ken
lib/server/kb-meta.tsUsulan judul, kategori, dan sumber dokumen Knowledge Base dari isi file (halaman-halaman awal), supaya admin/kontributor tidak perlu mengisi manual. Model kecil dalam paket (biaya sangat kecil, ±1 panggilan per unggahan). Kalau model gagal atau isi tidak terbaca (mis. PDF hasil scan), judul diambil dari nama file.
lib/server/kb-ocr.tsOCR satu halaman PDF hasil scan untuk Knowledge Base: gambar halaman (JPEG data URL, dibuat di perangkat pengunggah) dibaca oleh model vision dalam paket Kenari. Model bisa diganti lewat env PEPO_KB_OCR_MODEL (dipisah koma = cadangan).
lib/server/kb-router.tsPenebak konteks Knowledge Base: dari pertanyaan saja (tanpa user menyebut nama dokumen, bab, mata pelajaran, atau kelas), tentukan dokumen & bagian KB yang paling relevan. Berlaku untuk SEMUA jenis dokumen (pelajaran, SOP, produk, hukum, dll). Cara: "peta KB" (judul dokumen + kategori + judul-judul bagian) dicocokkan oleh model cepat (masuk kuota langganan), lalu potongan berurutan dari awal bagian itu diambil. Peta
lib/server/kb-ticket.tsTiket unggahan Knowledge Base: dibuat saat unggahan dimulai (butuh login), lalu dipakai untuk OCR/simpan selama unggahan berjalan, sehingga proses tetap jalan walau pengguna log out atau sesinya habis di tengah jalan. Hanya berlaku untuk aksi unggah (ocr-page, suggest-meta, create, append, fail), maksimal 6 jam.
lib/server/kb.tsKnowledge Base Pepo (HANYA server): dokumen rujukan yang dikurasi admin, dipakai Pepo saat menjawab. Pencarian = full-text search Postgres (pepo-v17.sql), tanpa biaya model. Tabel belum ada → semua fungsi diam (kosong).
lib/server/maps-link.tsLink Google Maps di pesan user. Halaman Maps tidak bisa dibaca sebagai teks (seluruhnya JavaScript), tetapi ALAMAT link-nya memuat nama tempat dan koordinat. Link pendek (maps.app.goo.gl) hanya pengalihan ke alamat panjang itu, jadi cukup diikuti tanpa mengunduh halamannya.
lib/server/media.tsBantuan bersama untuk skill media (foto, video, musik) yang memakai Kenari. Model gambar/video/musik selalu dibayar dari saldo PAYG Kenari (tidak termasuk paket langganan chat).
lib/server/moderation.tsModerasi untuk pengguna DI BAWAH 18 TAHUN (batas usia anak menurut UU Perlindungan Anak). Memakai endpoint moderasi Kenari (POST /v1/moderations, kompatibel OpenAI). - Input anak diperiksa sebelum dijawab: konten seksual ditolak tanpa memanggil model; tanda menyakiti diri tidak ditolak, tapi Pepo diberi arahan untuk menanggapi dengan empati & mengarahkan ke bantuan. - Jawaban untuk anak dirilis per paragraf setelah l
lib/server/pii.tsEnkripsi data pribadi sensitif (tanggal lahir) sebelum disimpan di database. HANYA server. Kunci: env PEPO_PII_KEY (disarankan, string acak panjang). Bila kosong, diturunkan dari SUPABASE_SERVICE_ROLE_KEY. PENTING: jangan ganti/hapus kunci setelah dipakai; data lama tidak bisa dibaca lagi (user diminta mengisi ulang).
lib/server/public-ai-guard.tsPengaman endpoint AI publik (/api/v1/chat, /api/v1/site-context). Endpoint ini dipanggil widget di website (lintas domain), jadi tidak bisa memakai login. Lapisan pengaman: 1) Origin: hanya domain Pepo, website Pepo, dan domain yang didaftarkan admin (env PEPO_PUBLIC_AI_ORIGINS). Request tanpa Origin (server/skrip) ditolak, kecuali membawa header x-pepo-key = env PEPO_PUBLIC_API_KEY. 2) Batas laju yang dicatat di dat
lib/server/site-content.tsKonten situs korporat yang dikelola dari Admin Pepo (lihat pepo-v19.sql).
lib/server/stock-photos.tsFoto stok bebas pakai (Unsplash) untuk desain yang butuh foto katalog/galeri, sebagai FOTO CONTOH. Pepo menulis <img data-photo="query bahasa Inggris" data-aspect="portrait|landscape|square" alt="...">, lalu server/kartu rancangan mengisinya dengan foto asli Unsplash (bukan link karangan AI yang sering rusak). Butuh env Vercel UNSPLASH_ACCESS_KEY (gratis dari unsplash.com/developers). Tanpa kunci: fitur nonaktif. Ses
lib/server/system-source.tssrc/lib/server/system-source.ts (HANYA server) Mode "Sistem Pepo": admin memperbaiki kode Pepo sendiri lewat chat, lalu deploy dari server (tanpa terminal). Cara kerja: - Sumber kode dibaca dari deployment PRODUKSI project Vercel Pepo lewat API Vercel (bukan dari disk: di Vercel disk read-only). - Perubahan hanya disimpan sebagai "overlay" (file yang diubah) di proyek admin; tidak menyentuh produksi sampai deploy.
lib/server/user-limits.tsReset batas harian dan pemberitahuan akun, diatur admin. Reset batas harian TIDAK menghapus catatan pemakaian (statistik biaya tetap utuh). Yang disimpan adalah "titik nol" hari ini: pemakaian akun saat direset (biaya, pesan Pepo Lite, sesi riset web). Semua pengecekan batas harian mengurangi angka ini, jadi akun mulai dari nol lagi sampai pergantian hari (WIB). Disimpan di pepo_settings kunci "usage_resets". Pembe
lib/server/user-name.tsNama panggilan user untuk Pepo: dari nama akun (Google/Microsoft/Apple), atau dirapikan dari bagian depan email.
src/lib/workspace/ 25 file
FileKenapa dibuat / fungsinya (dari catatan di kode)
lib/workspace/approved-draft.tssrc/lib/workspace/approved-draft.ts (CLIENT + SERVER, tanpa dependensi) Mencari rancangan (kartu pepo-preview / pepo-doc / pepo-slides / pepo-sheet) yang DISETUJUI user supaya Pepo mengerjakan proyek persis sesuai rancangan itu, di semua sesi kerja (bukan hanya sesi pertama).
lib/workspace/artifact-doc.tsArtefak = halaman interaktif mandiri buatan Pepo (jadwal, tracker, kalkulator, checklist, dll.). Halaman dijalankan di iframe ber-sandbox TANPA allow-same-origin (tidak bisa menyentuh akun/cookie pepoai.id), sehingga localStorage asli tidak tersedia. Shim di bawah menyediakan localStorage tiruan: isi awalnya disuntikkan saat halaman dibuat, dan setiap perubahan dikirim ke halaman induk (postMessage) untuk disimpan pe
lib/workspace/attachment-kind.tsLampiran foto di chat: ASET (bahan website/undangan/desain) atau REFERENSI (screenshot, foto error, contoh desain orang lain). - Aset → public/uploads/<nama> : dipakai di halaman & ikut deploy. - Referensi → uploads/lampiran/<nama> : hanya untuk DIBACA Pepo, tidak dipakai di halaman, tidak ikut deploy. Dulu semua foto masuk public/uploads, sehingga screenshot error ikut dianggap bahan landing pag
lib/workspace/busy.tsDaftar obrolan yang sedang dijawab, disimpan di tingkat modul (bukan di state komponen), supaya panel Riwayat yang baru dibuka/dipasang ulang (mis. laci di HP) langsung tahu animasi mana yang harus tampil.
lib/workspace/chat-save.tsObrolan baru hanya ada di layar sampai ada isinya (lihat lib/workspace/context.tsx). Beberapa permintaan ke server butuh baris obrolannya SUDAH ada di database (mode kerja di latar belakang, unggah foto). Sebelum permintaan itu dikirim, panggil ensureChatSaved(id): baris dibuat bila belum ada. Tidak pernah melempar error dan tidak menahan lebih dari beberapa detik, jadi pengiriman pesan tidak pernah terhalang olehnya
lib/workspace/context.tsx(tidak ada catatan di kode — komponen/utilitas pendukung)
lib/workspace/file-readers.tssrc/lib/workspace/file-readers.ts (CLIENT) Membaca file sehari-hari di HP user supaya isinya bisa dibaca Pepo: PDF, Word (.docx), Excel (.xlsx), PowerPoint (.pptx), OpenDocument (.odt/.ods/.odp), dan ZIP. Tidak ada file yang dikirim ke pihak lain: semuanya diurai di browser dengan pustaka yang disertakan Pepo sendiri (public/vendor). - .docx/.xlsx/.pptx/.odt = arsip ZIP berisi XML → dibaca dengan JSZip - PDF → pdf.j
lib/workspace/highlight.tssrc/lib/workspace/highlight.ts Pewarnaan sintaks ringan (tanpa library) untuk Code Editor dan blok kode di chat. Menghasilkan token; teks SELALU di-escape, jadi aman dirender sebagai HTML.
lib/workspace/inline-assets.tssrc/lib/workspace/inline-assets.ts (CLIENT + SERVER) Preview/Bagikan merender HTML lewat srcDoc, jadi <link href="css/style.css"> dan <script src="js/app.js"> tidak punya alamat untuk dimuat (halaman polos + error). File di proyek TETAP terpisah; hanya saat dirender, CSS/JS lokal disisipkan ke HTML. URL luar (https://, //, data:) dibiarkan.
lib/workspace/invite-share.tsMembagikan UNDANGAN DIGITAL yang dibuat user: link pribadi per tamu (?to=Nama) + template pesan WhatsApp. Dipakai DeployDialog (setelah deploy berhasil) dan pesan panduan di chat.
lib/workspace/kb-auto-meta.tsIsi otomatis judul, kategori, dan sumber dokumen Knowledge Base saat file dipilih (Admin › Knowledge Base dan dialog Kontributor). Hanya halaman-halaman awal yang dibaca di perangkat; cuplikannya dikirim ke server untuk diberi judul oleh model kecil. Isian yang sudah diketik sendiri tidak ditimpa.
lib/workspace/kb-upload-job.tsUnggahan Knowledge Base yang berjalan di latar: panel Admin / dialog Kontributor boleh ditutup, proses tetap jalan selama tab Pepo terbuka (kemajuan tampil di pil kecil, lihat KbJobPill). Hasil OCR per halaman disimpan di perangkat (IndexedDB), jadi kalau tab sempat tertutup, unggah ulang file yang sama hanya membaca halaman yang belum selesai.
lib/workspace/live-check.tssrc/lib/workspace/live-check.ts (CLIENT) Uji halaman LIVE setelah deploy: membuka URL di iframe tersembunyi dengan ?pepo-check=<token>. Skrip uji kecil yang disisipkan saat deploy (lihat api/deploy) mengirim balik: error JavaScript, jumlah elemen, panjang teks, dan apakah #root kosong. "Sukses" hanya jika halaman benar-benar tampil.
lib/workspace/local-assets.tssrc/lib/workspace/local-assets.ts (CLIENT) "Lazy upload" foto/aset proyek: 1. Saat diunggah, file asli disimpan di PERANGKAT (IndexedDB browser/PWA). Proyek hanya menyimpan penanda kecil "pepo-asset:local", jadi database dan sinkronisasi tidak membengkak oleh base64. 2. Preview di aplikasi membaca file dari perangkat. 3. Saat Deploy atau Bagikan, file diunggah ke penyimpanan Pepo, penanda diganti "pepo-asset:remote;
lib/workspace/md-html.tssrc/lib/workspace/md-html.ts Markdown sederhana → HTML (untuk diimpor jadi Google Docs). Teks di-escape; hanya tag dasar yang dihasilkan.
lib/workspace/mockup-export.tssrc/lib/workspace/mockup-export.ts (CLIENT) Mengubah kartu rancangan (HTML+CSS mandiri) menjadi FILE untuk client, tanpa link/browser: - Gambar PNG utuh (langsung tampil di chat WhatsApp) - Presentasi PDF: sampul + slide berisi layar-layar HP berurutan Tanpa library luar: HTML digambar lewat SVG <foreignObject> ke canvas, PDF ditulis manual (JPEG per halaman).
lib/workspace/office-export.tssrc/lib/workspace/office-export.ts (CLIENT) Membuat file yang biasa dipakai orang awam, langsung di HP (tanpa server, tanpa Google): Word (.docx) dari Markdown, Excel (.xlsx) dari tabel, PDF lewat menu Cetak browser, dan ZIP proyek. .docx/.xlsx = arsip ZIP berisi XML (dibuat dengan JSZip yang disertakan Pepo).
lib/workspace/preview-check.tssrc/lib/workspace/preview-check.ts (CLIENT) Menjalankan halaman HTML SUNGGUHAN di browser user (iframe tersembunyi, JavaScript dieksekusi), lalu mengumpulkan error JavaScript, console, gambar rusak, dan elemen yang melebar di layar HP. Hasilnya dikirim balik ke Pepo sebagai data untuk sesi berikutnya.
lib/workspace/project-kind.tssrc/lib/workspace/project-kind.ts Menentukan apakah proyek berisi website/app (butuh Preview & Deploy) dan daftar halaman HTML-nya.
lib/workspace/ringtone.tsMemotong lagu jadi ringtone (default 30 detik, fade in/out) langsung di browser, hasilnya WAV. WAV bisa dipasang sebagai nada dering di Android, dan bisa diimpor ke GarageBand di iPhone.
lib/workspace/server-check.tssrc/lib/workspace/server-check.ts (SERVER) Uji halaman di server, dipakai saat tugas berjalan di latar belakang (aplikasi user tidak perlu terbuka). Tidak menjalankan browser; yang diperiksa adalah hal yang paling sering membuat halaman rusak: 1) CSS/JS/gambar/halaman lokal yang dirujuk tapi tidak ada di proyek 2) Kesalahan sintaks JavaScript (diparse, tidak dieksekusi) 3) Elemen yang dipanggil JavaScript (getElemen
lib/workspace/session-stats.tssrc/lib/workspace/session-stats.ts (CLIENT) Statistik per percakapan (proyek). Angkanya diambil dari data nyata: - file, pesan, tes preview, deploy: dihitung dari riwayat pesan (ikut tersimpan, akurat walau halaman dimuat ulang) - kredit, waktu kerja, langkah kerja: dicatat saat Pepo bekerja, disimpan di perangkat per percakapan
lib/workspace/system-import.tsObrolan "Sistem Pepo" (admin): impor ZIP kode Pepo → SEMUA file masuk File Manager obrolan itu, lalu deploy hanya mengirim yang benar-benar berbeda dari produksi (dibandingkan dengan sidik sha1 dari Vercel). Penyimpanan di proyek: - file teks → isi teks apa adanya (bisa dibaca & diubah Pepo) - gambar yang BERUBAH → data:...;base64 (dibutuhkan untuk diunggah saat deploy) - gambar yang SAMA dengan produksi →
lib/workspace/system-preview.tsPreview obrolan Sistem: build versi uji Pepo di Vercel dari SEMUA file live + perubahan di obrolan ini. File yang tidak berubah dipakai ulang langsung dari deployment live (sha), jadi tidak perlu diunggah ulang. Produksi tidak disentuh. Dipakai panel Preview obrolan Sistem (tombol "Bangun preview").
lib/workspace/video-badge.tsMenambahkan badge kecil "Dibuat dengan Pepo" ke video langsung di HP/browser: video diputar ke canvas + badge, lalu direkam ulang (MediaRecorder) bersama suaranya. Lama proses = durasi video. Bila browser tidak mendukung, kembalikan null (pemanggil memakai file asli).
src/lib/credits/ 4 file
FileKenapa dibuat / fungsinya (dari catatan di kode)
lib/credits/context.tsx(tidak ada catatan di kode — komponen/utilitas pendukung)
lib/credits/meter.tssrc/lib/credits/meter.ts (HANYA server) Siapa user ini (Tamu / Free / Top-up / Plus / Pro), berapa kreditnya, dan pemotongan kredit dari biaya model nyata.
lib/credits/packages.ts(tidak ada catatan di kode — komponen/utilitas pendukung)
lib/credits/plan-config.tssrc/lib/credits/plan-config.ts (dipakai server & aplikasi) SEMUA angka bisnis ada di sini. Ubah di sini saja. Dasar hitungan: 1 kredit = Rp100 biaya model pada tarif PAYG penyedia (bukan harga diskon langganan), jadi margin tetap aman walau kuota langganan penyedia habis dan pindah ke saldo PAYG.
src/lib/agent/ 1 file
FileKenapa dibuat / fungsinya (dari catatan di kode)
lib/agent/jobs.tssrc/lib/agent/jobs.ts (HANYA server) Menjalankan tugas mode kerja di server, sesi demi sesi, tanpa bergantung pada aplikasi yang terbuka. Tiap sesi = satu panggilan /api/chat (mode agent streaming) yang sama persis dengan yang dipakai aplikasi.
src/lib/ 45 file
FileKenapa dibuat / fungsinya (dari catatan di kode)
lib/age.tsUsia pengguna dari tanggal lahir (YYYY-MM-DD). Dipakai di form daftar, popup lengkapi profil, dan server.
lib/analytics.tssrc/lib/analytics.ts (CLIENT) Event funnel Pepo ke Google Analytics 4. Aman dipanggil di mana saja: diam bila GA belum dimuat atau diblokir. Tidak pernah mengirim isi pesan, nama file, email, atau data pribadi lain; hanya nama event + label pendek.
lib/android/app-release.tsInfo rilis aplikasi Android (APK langsung dari pepoai.id). Ganti nilai di sini setiap APK baru diunggah ke public/download/pepo-assistant.apk (nama file tetap sama supaya link lama tidak putus).
lib/app-version.tsVersi yang tampil di aplikasi (badge di samping "Pepo Assistant"). 2.0 = generasi tampilan baru; angka terakhir = jumlah patch sejak 2.0 (pepo9 s.d. pepo191 = 183 patch). NAIKKAN angka terakhir setiap kali patch dipasang, termasuk perbaikan dari obrolan Sistem Pepo.
lib/asset-base.tsASSET BASE PEPO: pustaka aset desain resmi (seperti Knowledge Base, tapi untuk gambar) yang menjadi rujukan Pepo saat membuat undangan digital, website, dan landing page untuk SEMUA user, walau user tidak punya aset sendiri. Struktur: kategori › subkategori (mis. Undangan › Adat Jawa) › paket (satu set aset serasi) › aset (punya PERAN). File ini aman dipakai di browser (tanpa impor server).
lib/assistant/config.tssrc/lib/assistant/config.ts (CLIENT + SERVER) Pengaturan Mode Asisten di satu tempat. Semua sudah punya nilai bawaan, jadi TIDAK ada env yang wajib diisi. NEXT_PUBLIC_PEPO_ASSISTANT "off" untuk menyembunyikan tombol Mode Asisten (bawaan: aktif) NEXT_PUBLIC_GOOGLE_CLIENT_ID OAuth Client ID (Web) → bawaan sudah terisi di google-drive.ts NEXT_PUBLIC_GOOGLE_API_KEY API key (dibatasi domain) →
lib/auth/context.tsx(tidak ada catatan di kode — komponen/utilitas pendukung)
lib/beta/useBeta.tsStatus "Beta gratis" (saklar di Admin). Dibaca sekali per halaman lalu dibagikan ke semua komponen.
lib/context.tsx(tidak ada catatan di kode — komponen/utilitas pendukung)
lib/guest/context.tsx(tidak ada catatan di kode — komponen/utilitas pendukung)
lib/hooks/useKeyboardViewport.tsKeyboard iPhone: Safari TIDAK mengecilkan 100dvh saat keyboard muncul, melainkan menggulir seluruh halaman ke atas → header & isi chat terdorong keluar layar dan kotak ketik tampak "kegeser". Hook ini mengikat tinggi aplikasi ke area yang benar-benar terlihat (visualViewport) lewat CSS var --app-h, dan mengembalikan gulir halaman ke 0.
lib/i18n/jv.tsKamus tampilan Basa Jawa (ngoko). Kunci = teks Indonesia persis seperti di tampilan (spasi dirapikan). Istilah teknis yang lumrah (deploy, preview, link, file, website) sengaja tidak diterjemahkan. Teks yang tidak ada di kamus tetap tampil dalam Bahasa Indonesia.
lib/i18n/lang.tsBahasa tampilan Pepo. 'id' = Bahasa Indonesia (bawaan), 'jv' = Basa Jawa ngoko. Disimpan di perangkat (localStorage + cookie) supaya berlaku juga untuk tamu.
lib/image-templates.tsTemplate edit foto populer (bagian yang aman dilihat klien: nama, warna cadangan, lokasi thumbnail). Prompt aslinya ada di src/lib/server/image-template-prompts.ts dan tidak pernah dikirim ke browser.
lib/integrations/extensions.tssrc/lib/integrations/extensions.ts (CLIENT) Status ekstensi Pepo (Google Drive, Google Sheets, Google Calendar) per akun. - Izin Google diminta SEKALI, saat ekstensi Drive/Sheets pertama kali dinyalakan (popup resmi Google). - Setelah itu token akses diambil dari server Pepo (refresh token tersimpan terenkripsi di server), tanpa popup lagi. - Calendar tidak butuh izin Google (kartu jadwal membuka Google Calendar / k
lib/integrations/google-drive.tssrc/lib/integrations/google-drive.ts (CLIENT) "Ambil dari Google Drive": user memilih file sendiri lewat Google Picker resmi. Izin yang diminta hanya drive.file (Pepo cuma bisa membuka file yang DIPILIH user, bukan seluruh Drive). Izin diberikan sekali per akun saat ekstensi dinyalakan; token akses berumur pendek diambil dari server Pepo. Nilai publik (memang terlihat di browser, aman). API key dibatasi ke https://d
lib/kb-classify.tsTebak kelas, jenjang, jenis buku, dan mata pelajaran dari JUDUL dokumen Knowledge Base (untuk filter di daftar). Hanya dari judul: tidak perlu kolom database baru. Judul yang tidak menyebut kelas masuk "Lainnya".
lib/kb-note.tsCatatan dokumen Knowledge Base (kolom note) memuat tiga bagian, dipakai server dan tampilan: <catatan biasa> mis. "Dikirim kontributor: email" \n[laporan] {json} laporan unggah: berapa halaman file, berapa yang terbaca, yang gagal, jumlah karakter \n[gagal] <alasan (jam)> alasan unggahan terakhir gagal (hanya selama dokumen belum selesai) Laporan dibuat saat unggah (hanya saat itu jumlah halaman
lib/leads/keys.tssrc/lib/leads/keys.ts (hanya dipakai server)
lib/leads/validate.tssrc/lib/leads/validate.ts (fungsi murni, aman diuji)
lib/memory/lessons.tssrc/lib/memory/lessons.ts (HANYA server) "Pelajaran bersama": Pepo belajar dari rating jawaban SEMUA pengguna, lalu menerapkannya di konteks serupa. Aman privasi: - Yang disimpan hanya pelajaran UMUM tentang cara menjawab (mis. "Untuk website katering, langsung sertakan paket harga dan tombol WhatsApp"), BUKAN isi percakapan. Model penyaring diminta membuang nama, angka, kontak, merek pribadi; setelah itu angka/ema
lib/memory/store.tssrc/lib/memory/store.ts (HANYA server) Memori lintas percakapan: fakta penting tentang user, bisa dilihat & dihapus user di panel Memori.
lib/notifications/useAdminNotifications.ts(tidak ada catatan di kode — komponen/utilitas pendukung)
lib/notifications/useTopUpNotifier.ts(tidak ada catatan di kode — komponen/utilitas pendukung)
lib/pepo-changelog-sistem.tsCatatan perubahan yang dibuat lewat obrolan Sistem Pepo (deploy dari aplikasi). Terbaru di atas. Format tiap entri: "## YYYY-MM-DD · versi 2.0.x — judul" lalu poin: apa yang diubah, kenapa, file yang disentuh. Patch pepoNN dari luar TIDAK menimpa file ini (patch hanya membawa src/lib/pepo-changelog.ts).
lib/pepo-changelog.tsRIWAYAT PERUBAHAN PEPO (dari patch pepoNN yang dipasang lewat `bash pepo`). Dibaca obrolan Sistem Pepo supaya tahu apa saja yang sudah diubah, kenapa, dan di file mana. File ini DITIMPA setiap patch baru: catatan perubahan dari obrolan Sistem Pepo sendiri ditulis di src/lib/pepo-changelog-sistem.ts (tidak pernah ditimpa patch). Urutan: terbaru di atas.
lib/prompt-guide.tssrc/lib/prompt-guide.ts Panduan prompt Pepo: contoh prompt yang KURANG vs yang LEBIH BAIK, per kebutuhan. Dipakai halaman /panduan-prompt (juga dibaca mesin pencari & mesin jawaban AI).
lib/push/webpush.tssrc/lib/push/webpush.ts (HANYA server) Web Push tanpa payload terenkripsi: server hanya "membangunkan" service worker, lalu service worker mengambil isi notifikasi dari /api/push/last.
lib/safe-top-script.tsJarak aman atas (--pepo-safe-top) untuk Pepo yang dipasang di Home Screen iPhone (PWA), dihitung di perangkat masing-masing, bukan satu angka untuk semua: 1. Bila iOS melaporkan env(safe-area-inset-top) > 0, angka itu yang dipakai (sudah pas per model). 2. iOS 26.1+ / 27 kadang melaporkan 0 padahal bilah sistemnya (bening berkabut) menutupi bagian atas app (WebKit bug 301994). Bila begitu, tinggi bilah diperkirakan d
lib/seo-pages.tssrc/lib/seo-pages.ts Halaman solusi per kata kunci pencarian (/solusi/<slug>). Isinya sengaja spesifik dan jujur sesuai fitur Pepo, supaya dinilai bermanfaat oleh Google dan bisa dikutip mesin jawaban AI.
lib/seo.tssrc/lib/seo.ts Satu sumber untuk teks SEO, FAQ, dan data terstruktur (JSON-LD) Pepo. Dipakai oleh layout (metadata), halaman /tentang, sitemap, dan llms.txt supaya isinya selalu sama.
lib/site-config.tsAlamat Pepo (aplikasi) dan domain untuk website buatan pengguna. Diatur lewat env Vercel: NEXT_PUBLIC_SITE_URL = https://pepoai.id (aplikasi; dev.pepsspace.com dialihkan ke sini) NEXT_PUBLIC_SITES_DOMAIN = pepoai.web.id (website pengguna: <nama>.pepoai.web.id) Sebelum env diisi, semuanya tetap seperti lama (dev.pepsspace.com & <nama>.pepsspace.com).
lib/site-context/index.ts(tidak ada catatan di kode — komponen/utilitas pendukung)
lib/site-context/pepsspace.tsPengetahuan Pepo sebagai CUSTOMER SERVICE situs pepsspace.com (popup chat di semua halaman). Bagian statis di bawah = fakta tetap situs. Bagian dinamis (katalog, FAQ, karya) ditambahkan dari Admin Pepo (tab Situs PEPSPACE) lewat buildPepsspaceContext(), jadi yang diubah admin langsung diketahui Pepo.
lib/skills.tsSkill kreatif Pepo: Foto AI, Video AI, Musik & Ringtone. Status nyala/mati disimpan di perangkat. Harga per pemakaian diambil dari server (/api/skills) supaya sama dengan yang dipotong.
lib/supabase/client.ts(tidak ada catatan di kode — komponen/utilitas pendukung)
lib/system-marker.tsPenanda & helper bersama (klien + server) untuk obrolan khusus admin "Sistem Pepo". Proyek ini hanya menyimpan OVERLAY: file kode Pepo yang diubah lewat chat. Sumber produksi dibaca server dari Vercel. Penanda saja tidak memberi akses apa pun: server memeriksa is_admin di setiap panggilan.
lib/templates.tsTEMPLATE PREMIUM Pepo: halaman buatan tangan (animasi & tata letak terjamin) yang hanya diisi DATA oleh Pepo. File template ada di public/undangan-premium/. Aset ornamennya dari Asset Base (paket bawaan di public/aset-base/).
lib/tutorials.tssrc/lib/tutorials.ts Tutorial fitur Pepo yang butuh beberapa langkah. Dipakai halaman /panduan dan /panduan/<slug>. Setiap langkah ditulis sesuai tampilan aplikasi yang sebenarnya.
lib/upsell/context.tsx(tidak ada catatan di kode — komponen/utilitas pendukung)
lib/utils.ts(tidak ada catatan di kode — komponen/utilitas pendukung)
lib/utils/image.tsCompress & resize image di browser pakai Canvas API. Output: data URL (JPEG atau PNG).
lib/utils/zip.ts(tidak ada catatan di kode — komponen/utilitas pendukung)
lib/web/fetcher.ts(tidak ada catatan di kode — komponen/utilitas pendukung)
lib/web/security.ts(tidak ada catatan di kode — komponen/utilitas pendukung)
src/hooks/ 1 file
FileKenapa dibuat / fungsinya (dari catatan di kode)
hooks/useMediaQuery.ts(tidak ada catatan di kode — komponen/utilitas pendukung)
src/(root src)/ 1 file
FileKenapa dibuat / fungsinya (dari catatan di kode)
proxy.ts1) Pengalihan permanen (301) dari alamat lama aplikasi (dev.pepsspace.com) ke alamat utama (NEXT_PUBLIC_SITE_URL). Hanya aktif bila NEXT_PUBLIC_SITE_URL sudah diisi alamat lain. API tidak dialihkan supaya aplikasi lama yang masih terbuka di HP pengguna tetap bisa menyimpan pekerjaannya. 2) Header keamanan dasar untuk semua halaman (temuan uji QA 14 Nov 2026: tidak ada satu pun yang terpasang). Sengaja TIDAK memakai X

04 PepsStudio OS

Operasional studio foto/video: booking (pesanan dari PEPSPACE masuk ke sini), kalender sebagai sumber jadwal kosong, absensi dengan face recognition, keuangan, checklist item paket, dan Meja Kerja untuk karyawan.

URLos.pepsspace.com (Vercel: pepsstudio-os)
StackNext.js 14 · React · Tailwind · Supabase · Kenari · face-api.js · Web Push
Jam studio09.00–18.00 tepat (telat / pulang cepat tercatat); alpha tidak bisa diubah, izin di hari itu juga

Struktur Folder

app/ ├── api/ │ ├── ai/generate-image/route.ts │ └── chat/ai/route.ts ├── bookings/page.tsx ⭐ 3 section: Aktif/Selesai/Batal ├── calendar/page.tsx ← Kalender + REALTIME ├── dashboard/page.tsx ⭐ KPI + chart + upcoming ├── employee-dashboard/page.tsx ⭐ Absen + face recognition + Izin/Sakit ├── finance/page.tsx ⭐ group by date + tab ├── meja/page.tsx ⭐ Meja Kerja ├── packages/page.tsx ⭐ task template form components/ ├── ChatBox.tsx ⭐ Floating chat (drag + bubble) └── Navbar.tsx ⭐ employee tanpa hamburger lib/ ├── ai-executor.ts ⭐ Eksekutor tool ├── ai-tools.ts ⭐ Tool definitions ├── face-api.ts ← Face recognition └── kenari-image.ts ← Image gen/edit

Skema Supabase (PepsOS)

  • customers — id, name, phone, address, workspace_id
  • bookings — customer_id, package_id, total_price, guest_count, booking_date, status, is_outdoor, assigned_employee_id
  • packages — name, price, category, default_is_outdoor, is_active
  • employees — name, employee_id, role, photo_url, face_descriptor
  • attendance — check_in/out, lat/lng, selfie_url, is_late, late_penalty, overtime_bonus, work_type
  • finance — amount, type (income/expense), category
  • invoices — invoice_number, items, subtotal, total, status
  • package_items & booking_items — checklist template & per booking
Auto-Populate Trigger

Trigger on_booking_created_populate_items menyalin package_items ke booking_items untuk setiap booking baru, deadline = booking_date + 14 hari.

Obrolan Sistem di Pepo bisa membaca struktur database PepsOS (pepsos-v4.sql) dan ikut menangani perbaikan PepsOS & PEPSPACE.

05 AI Tools (PepsOS)

Tool yang bisa dipanggil PEPO via function calling.

ToolFungsi
create_bookingBuat booking baru (setelah konfirmasi)
check_availabilityCek slot jadwal kosong
update_bookingEdit booking (jumlah orang, tanggal, jam)
get_booking_itemsAmbil checklist item untuk booking
update_booking_itemTandai item done/pending
create_expenseCatat pengeluaran (auto-detect category)
get_expense_summaryRingkasan bulanan + breakdown kategori

06 Patch Log

Era awal (sebelum patch bernomor tercatat di backup ini)

  • Batch A — Quick Wins: fix model vision, pipeline kontekstual, middleware auth redirect.
  • Batch B — Thumbnail & File Management: thumbnail file tree, preview bubble chat, rename/hapus folder, upload ke root.
  • Batch C — Prompt AI & Landing: PATCH MODE diperkuat, CTA konsisten, counter gratis komunikatif.
  • Manus UI Overhaul: sidebar riwayat, glassmorphism, SSE real-time, Memory System, unggah tertunda.
  • pepo75–93: patch kumulatif awal (rincian ada di catatan zip masing-masing).
  • PepsOS sesi 14 Okt: fix is_outdoor, alpha absensi, booking default confirmed, tombol Finance di Meja Kerja.

pepo94 – pepo191 (terbaru di atas, ringkasan dari catatan patch)

PatchIsi utama
pepo191foto per mempelai dipotong dari foto berdua bila foto sendiri tidak ada
pepo190ucapan selamat yang hangat boleh lagi
pepo189penyempurnaan tidak lagi gagal diam-diam + ucapan selamat dihapus
pepo188rancangan undangan langsung ditulis model kuat + contoh acuan
pepo187BARIER MINIMUM undangan = undangan di video iklan Pepo
pepo186penyempurna undangan diberi contoh acuan mutu premium
pepo185nama tamu ?to= juga jalan di link bagikan pepoai.id/a/<id>
pepo184kupu-kupu terbang & latar bergerak jadi standar minimum undangan
pepo183penjaga mutu rancangan undangan/website + revisi tidak menghapus isi
pepo182unggah Asset Base lebih cepat (peran ditebak dari isi gambar)
pepo181"Lanjut jadikan proyek" langsung memasang rancangan (tanpa mode kerja)
pepo180bagikan undangan ke tamu + alamat website melekat di obrolan
pepo179rancangan = hasil jadi (tidak berubah kecuali user minta)
pepo178"brief user menang" (dari penilaian tes undangan Alya & Bima, nilai 6/10)
pepo177prompt premium sistem + prompt user, untuk SEMUA adat dan SEMUA website
pepo176TEMPLATE PREMIUM undangan Jawa (hasil = video iklan, Pepo hanya mengisi data)
pepo175ASSET BASE (pustaka aset desain resmi Pepo)
pepo174undangan/website "standar premium" + aset obrolan dipakai semua + folder lampiran terpisah
pepo173"buatkan gambar …" langsung jadi gambar AI di chat (bukan 5 menit mode kerja)
pepo172daftar Knowledge Base tersegmentasi
pepo171filter & cari di Admin › Knowledge Base
pepo170atur batas pemakaian Pepo untuk kontributor + pemberitahuan di akun mereka
pepo169batas unggah per kontributor + pemberitahuan di akun mereka
pepo168deploy admin ditolak "Batas maksimal 5 subdomain tercapai"
pepo167laporan kelengkapan per dokumen
pepo166Galat "Database menolak menyimpan (kode 22P05)" saat mengunggah buku (mis. Matematika) diperbaiki. · Setiap unggahan yang gagal menyebut tahap dan sebabnya. · Alasan gagal tersimpan di dokumennya.
pepo165Setiap unggahan yang gagal menyebut tahap dan sebabnya. · Alasan gagal tersimpan di dokumennya. · Unggah ulang melanjutkan dokumen yang sama.
pepo164Deploy tidak lagi ditolak dengan "Import tidak ditemukan: @/...". · Pertanyaan, keluhan, dan foto dijawab langsung. · review_changes dan deploy_system melihat SEMUA perubahan draf.
pepo163Knowledge Base: teks yang ditempel (tanpa file) kini diproses. · Pemberitahuan (toast) tampil di atas semua panel & dialog
pepo162Obrolan Sistem (Pepo, PepsSpace, PepsOS) kini memahami seluruh ekosistem dan databasenya. · Riwayat SQL Pepo ikut tersimpan di kode
pepo161Tandai & hapus beberapa obrolan sekaligus. · Ikon riwayat obrolan diganti
pepo160Kalimat pembuka tidak lagi dobel di kartu rancangan. · Judul obrolan dibuat dari pesan pertama yang berisi tugas, bukan dari sapaan. · Halaman interaktif tidak lagi berjalan di mode lama browser (quirks).
pepo159Navbar di aplikasi iPhone (PWA) tidak lagi tertutup jam/status bar setelah aplikasi memuat ulang. · Maskot di atas sapaan obrolan baru diganti animasi garis logo Pepo yang digambar berulang (draw-on)
pepo158Aplikasi langsung terbuka di obrolan baru, tanpa menunggu database. · Animasi memuat = garis logo Pepo digambar berulang (draw-on), tanpa logo utuh di akhir · Preview proyek punya tombol "Tutup" yang jelas
pepo157Popup "Selamat Datang · Pilih jenis project" tidak lagi muncul otomatis · Ucapan ringan di obrolan baru
pepo156"Layar penuh" pada kartu rancangan / halaman interaktif sekarang bisa ditutup.
pepo155Pepo memutuskan sendiri kapan membuat halaman interaktif; user tidak perlu tahu kata "artefak". · Istilah "artefak" tidak lagi tampil ke pengguna. · Logo di halaman masuk digambar berulang
pepo154Halaman masuk dibuat bersih, dengan logo Pepo yang digambar di atasnya. · Animasi logo (draw-on, tempo pelan ±5 detik)
pepo153WAJIB: jalankan `pepo-v21.sql` di Supabase › SQL Editor · Artefak: halaman interaktif siap pakai di dalam chat. · Bagikan lewat link (pepoai.id/a/<id>)
pepo152Bagian atas navbar tidak lagi buram di PWA iPhone (iOS 26.1+/27).
pepo151Area status bar iPhone (PWA) tidak lagi terlihat buram.
pepo150Unggahan PDF besar tidak lagi mati di tengah (±50%) di HP. · HP terkunci atau pindah aplikasi tidak menghabiskan percobaan OCR. · Di HP memakai 4 halaman sekaligus
pepo149Penanda unggahan Knowledge Base jadi bulatan kecil yang bisa digeser. · Disembunyikan saat log out.
pepo148Halaman scan yang masih punya sedikit teks kini ikut di-OCR.
pepo147Pil unggahan Knowledge Base tampil di atas panel Admin. · Tidak bisa memproses file yang sama dua kali sekaligus. · Unggahan tetap berjalan walau log out.
pepo146Nomor bab tidak lagi hilang di potongan Knowledge Base.
pepo145Unggahan Knowledge Base (termasuk OCR) berjalan di latar. · OCR lebih cepat dan bisa dilanjutkan.
pepo144Judul, kategori, dan sumber Knowledge Base terisi otomatis dari isi file. · Judul bab bergaya "CHAPTER / judul / 30" dikenali.
pepo143perbaikan kecil / lanjutan patch sebelumnya
pepo142Foto di rancangan dalam ZIP obrolan kini tampil. · Revisi rancangan tidak bertanya balik tanpa perlu.
pepo141Kontributor Knowledge Base.
pepo140Preview/deploy Next.js yang memakai Prisma tidak gagal build lagi karena "prisma generate". · Laporan "Preview gagal" kini menampilkan detail error asli dari server
pepo139Kirim foto tanpa teks gagal · Pesan error mentah dari penyedia (sering berbahasa asing) tidak lagi ditampilkan. · Preview mengenali proyek Next.js dengan folder app/ di akar
pepo138WAJIB: jalankan pepo-v20.sql di Supabase → SQL Editor · Mode Beta gratis (Admin → Beta gratis). · Angka paket Kenari diperbarui ke Studio
pepo137Tombol "Coba lagi" pindah ke bawah pesan user
pepo136Badge versi bertuliskan "Beta 2.0.x"
pepo135Tombol "Coba lagi" di setiap jawaban yang gagal.
pepo134Satu jawaban gagal tidak lagi "meracuni" seluruh obrolan.
pepo133Perbaikan "halo" gagal di Sigra/Adikara sejak pepo130. · Admin langsung melihat penyebab bila semua model gagal. · Ikon di root untuk iPhone
pepo132Pengurut hasil Knowledge Base (rerank) dimatikan bawaan
pepo131Obrolan Sistem Pepo sekarang tahu semua perbaikan. · Perubahan dari obrolan Sistem Pepo juga tercatat.
pepo130Tingkat pilihan (Adikara/Niskala/Sigra) tidak lagi menunggu model macet sampai habis.
pepo129Model macet tidak lagi berakhir "Koneksi ke model terputus".
pepo128Penalaran model rancangan dimatikan · Catatan waktu rancangan di log Vercel
pepo127Jawaban kartu pertanyaan tidak lagi nyasar ke "Jagat" lalu terputus. · Link referensi desain dibaca server. · Rancangan langsung dibuat, tidak ditunda untuk bertanya.
pepo126Pepo menebak konteks dari isi pertanyaan, untuk SEMUA jenis dokumen Knowledge Base
pepo125Pepo tahu konteks materi. · Kelas dicocokkan ke buku · Pertanyaan lanjutan tetap di materi yang sama
pepo124Knowledge Base paham "bagian ke-N" untuk SEMUA dokumen · Semua pencarian KB · Unggahan baru
pepo123Pepo Sigra benar-benar cepat. · Knowledge Base paham "bab N". · Materi belajar boleh ditampilkan.
pepo122Kesan pertama untuk tamu & akun gratis · Pepo Sigra
pepo121Revisi mockup memakai mockup yang benar. · Menambah foto contoh ke rancangan tidak memakai mode kerja · Instruksi "Kerjakan:" tidak lagi terpotong & bocor ke layar.
pepo120Foto Unsplash bisa ditambahkan ke kartu rancangan.
pepo119Pepo tidak lupa brief/prompt panjang. · Revisi mockup tetap di kartu rancangan. · Tingkat pilihan dihormati.
pepo118Foto contoh otomatis untuk galeri/katalog/portofolio/hero
pepo117Desain tidak terasa "template AI" · boleh memakai Google Fonts · tidak lagi otomatis berlatar gelap
pepo116Nama model Pepo · Nawasena · (cepat untuk keperluan harian)
pepo115Rancangan / mockup website kini memakai Claude Sonnet 5.5 · Model rancangan bisa diganti tanpa patch
pepo114Chatbot customer service pepsspace.com · paket & harga resmi dari PepsOS
pepo113Beranda admin
pepo112URL artikel dari pencarian web kini benar-benar tertangkap.
pepo111Instruksi "Kerjakan: ..." tidak tampil lagi. · "Cari kan beritanya", "carikan info terbaru", "cek sumbernya" · Semua tahap dalam satu "Log aktivitas".
pepo110Indeks makna
pepo109Status proses Pepo hanya dari kejadian nyata (seperti asisten AI lain)
pepo108Keyboard iPhone tidak lagi menggeser halaman. · Kartu palsu "Belum selesai: 0 dari 2 tahap" di obrolan biasa dihilangkan.
pepo107Knowledge Base mendukung semua aksara. · "bab 31" ketemu walau buku menulis "CHAPTER 31" / "31과" / "unit 31". · Materi berbahasa asing dijelaskan dalam bahasa user
pepo106Preview di obrolan Sistem = versi uji Pepo yang sungguhan. · Bangun preview
pepo105Obrolan Sistem tidak lagi mencoba build Preview website.
pepo104Kode dasar obrolan Sistem = versi yang benar-benar live. · Tidak ada lagi "Tahap 3" hantu. · Pilih elemen yang benar.
pepo103Obrolan Sistem: path "src/src" diperbaiki di sumbernya. · Pepo tidak lupa tahapan buatannya sendiri. · Admin/akun login tidak lagi dianggap tamu
pepo102Jalur "chunked" lama dimatikan. · Menulis buku/cerita · Tidak ada lagi "Menyusun jawaban" ratusan detik
pepo101Knowledge Base (Admin → Alat → Knowledge Base)
pepo100Tanggal lahir wajib & usia diketahui Pepo
pepo99Pepo untuk siswa SD–SMA (ditebak otomatis, tanpa pengaturan) · kuis latihan
pepo98Simpan dokumen panjang ke Memori Pepo. · Pepo tidak lagi mengaku "sudah disimpan" bila belum.
pepo97Obrolan baru tidak lagi terjebak di Preview. · Prompt panjang dirender sebagai Markdown
pepo96Link navigasi di Preview tidak lagi memuat Pepo.
pepo95Pepo bisa membaca foto yang sudah ada di proyek. · Foto terlampir terbaca semua & tajam.
pepo94"Gambar utuh" kini bernama `.jpg` (isinya memang JPEG). "Siap cetak (PNG)" tetap PNG asli.

07 Roadmap & Pekerjaan Tertunda

  • Uji live mutu undangan (pepo183–191): penjaga mutu, barier minimum video iklan, potong foto per mempelai, penyempurnaan terpisah.
  • Pesan user yang terpecah saat Pepo sedang menjawab: mekanisme gabung/batalkan (keterbatasan yang diketahui).
  • Aplikasi Android (APK PWABuilder di pepoai.id/app); pertimbangan Play Store / App Store.
  • Knowledge Base untuk siswa: prioritas per jenjang kelas; kontributor hapus unggahan dalam 24 jam.
  • Buku Bab 17–24 di Claude Docs (dijeda).
  • Jangka panjang: mengganti Vercel/Kenari/Supabase dengan alternatif sendiri; Pepo as a Service (white-label).

08 Kontak & Akun

LayananAkunCatatan
Vercelvickywa45vibe-chat (Pepo), pepsstudio-os, pepsspace.com, pepo-<string> (situs user); region sin1
Supabase—Project Pepo + project katalog/PepsOS terpisah
Kenarikenari.idPaket Studio; API key hanya di env Vercel
GitHubvickywa45Repo: vibe-chat
Domain & hostingDomaiNesia · Rapidplexpepoai.id, pepoai.web.id, pepsspace.com; cPanel = folder sumber deploy
SosialTikTok @pepo.idPEPO ASSISTANT; Instagram Pepstudio

Tim: Vicky (Owner/Admin, developer solo Pepo), Triska (Admin), Tulus (Photographer & CS studio).

09 Catatan Kerja

Prinsip Kerja
  • Patch dari file asli, typecheck sebelum dikirim, satu zip kumulatif per perubahan.
  • Setiap perbaikan dicatat di catatan patch & changelog supaya obrolan Sistem Pepo tahu.
  • Rahasia hanya di env Vercel: dokumen & kode hanya menyebut nama env, tidak pernah nilainya.
  • Hasil premium dari prompt sistem + prompt user, bukan template tetap; aset dari Asset Base; sumber luar boleh asal berlisensi bebas.
  • Rancangan = hasil jadi: tidak berubah kecuali user memintanya.
  • Vision model: gemini-3-8-flash.
Pasang patch + deploy Pepo:  bash pepo
Deploy ulang saja:           bash pepo deploy
Lihat log deploy:            bash pepo log
Patch PepsOS:                bash pepsos
Pulihkan patch terakhir:     salin ~/.pepo-backups/terakhir → ~/dev.pepsspace.com, lalu bash pepo deploy
PepsSpace Ecosystem Documentation v2.0 · Pepo Beta 2.0.183 · Vicky
Dibuat dengan Pepo