Troubleshooting & FAQ

Troubleshooting

Gejala	Penyebab umum	Perbaikan
Job stuck `QUEUED`	Worker tidak jalan	Jalankan `pnpm worker` di terminal terpisah
`ENCRYPTION_SECRET must be set`	Env belum terbaca	Pastikan `.env.local` ada; script memakai `dotenv -e .env.local`
Gagal konek DB	Compose belum up / port salah	`docker compose up -d`, cek `DATABASE_URL` (port host 5434)
Error Redis	Port/URL salah	Default Compose 6380; tanpa env, fallback kode bisa ke 6379
Pesan belum ada IMAGE credential	Settings kosong	Tambah credential IMAGE (Ideogram/dll.) di Settings
Gambar `/api/files` 404 di dev	Path salah / file belum ada	Cek folder `storage/` (runtime, tidak ikut ZIP)
`pnpm setup` gagal di tengah	Docker belum siap	`docker compose ps`, ulangi setelah healthy
Port 3000 dipakai	Proses lain	`pnpm dev -- --port 3001` atau hentikan proses lama
OAuth Drive gagal	Redirect URI tidak cocok	Samakan konsol Google Cloud dengan `GDRIVE_REDIRECT_URI`

FAQ

Apakah ini aplikasi hosted atau source code?
Source code + panduan setup. Anda self-host di komputer atau server sendiri.

Apakah ZIP sudah berisi node_modules dan .env?
Tidak. ZIP mengecualikan .git, .env*, node_modules, output/, storage/, dan artefak build. Ikuti Quick Start.

Apakah termasuk API key atau kuota AI?
Tidak. Siapkan key sendiri; isi lewat Settings (disimpan terenkripsi) atau fallback env teks.

Apakah ada login / multi-user?
Tidak. Single-user tanpa autentikasi bawaan. Lindungi sendiri jika dipasang di server publik.

Boleh dipakai untuk proyek klien?
Ya, menurut Lisensi & Dukungan. Dilarang menjual ulang atau mendistribusikan ulang source code.

Apakah ada Dockerfile untuk aplikasinya?
Belum. Compose hanya Postgres + Redis.

Tidak ada test suite?
Benar — tidak ada suite tes di scripts paket; andalkan pnpm lint, pnpm check, dan pnpm build.

Boleh saya kirim API key saat minta bantuan?
Jangan. Sebutkan hanya nama variabel atau jenis credential (TEXT/IMAGE) yang bermasalah.