- JavaScript 59.9%
- TypeScript 39.2%
- CSS 0.8%
settings.local.json (pengaturan pribadi), worktrees/ (checkout git milik sesi lain) dan launch.json (konfigurasi server dev lokal) tidak boleh masuk repo. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> |
||
|---|---|---|
| drizzle | ||
| public | ||
| src | ||
| .gitignore | ||
| components.json | ||
| DESIGN.md | ||
| docker-compose.yml | ||
| Dockerfile | ||
| drizzle.config.ts | ||
| empty-module.js | ||
| eslint.config.mjs | ||
| migrate-s3.js | ||
| next.config.ts | ||
| package-lock.json | ||
| package.json | ||
| postcss.config.mjs | ||
| README.md | ||
| ROADMAP.md | ||
| rustfs-docker-compose.yml | ||
| test-s3.js | ||
| tsconfig.json | ||
Perpustakaan Digital
Perpustakaan digital untuk siswa sekolah dasar. Baca buku gratis kapan saja, di mana saja 📚
Stack
- Next.js 16 — full-stack React framework
- SQLite + Drizzle ORM — lightweight database
- Casdoor — OIDC authentication
- react-pdf — PDF viewer
- Tailwind CSS + shadcn/ui — UI framework
- Docker — containerized deployment
Development
npm install
npm run dev
Database
npx drizzle-kit generate # Generate migration
npx drizzle-kit migrate # Apply migration
Docker Deployment
# Copy and configure environment
cp .env.example .env
# Build and run
docker compose up -d --build
Environment Variables
NEXTAUTH_URL=http://localhost:3000
NEXTAUTH_SECRET=your-secret-key
CASDOOR_ENDPOINT=http://casdoor:8000
CASDOOR_CLIENT_ID=your-client-id
CASDOOR_CLIENT_SECRET=your-client-secret
GEMINI_API_KEY=your-gemini-api-key # Optional, for AI categorization
DATA_DIR=/data # Docker volume mount point
# Lihat bagian "Katalogisasi AI" di bawah untuk provider cadangan
# (DEEPSEEK_API_KEY, MOONSHOT_API_KEY, OPENAI_API_KEY, ANTHROPIC_API_KEY).
# Optional. Pola nomor induk (accession number) untuk koleksi fisik.
# {YYYY}/{YY} = tahun, satu deret N = nomor urut (panjangnya = zero-padding).
# Deretnya tidak harus di akhir. Default: SD/{YYYY}/{NNNNN}
# Setel SEBELUM memasukkan eksemplar massal — menggantinya nanti berarti
# menomori ulang rak fisik.
INVENTORY_CODE_PATTERN=SD/{YYYY}/{NNNNN}
# Sangat disarankan. Kunci Google Books API untuk pengisian otomatis dari ISBN
# di /admin/tambah. Gratis, dibuat di Google Cloud Console (aktifkan "Books API").
# TANPA kunci ini, permintaan memakai kuota anonim bersama yang sering sudah
# habis dan membalas HTTP 429 — lookup lalu jatuh ke OpenLibrary, yang jalan
# tetapi tanpa sinopsis dan cakupan Indonesianya lebih tipis.
GOOGLE_BOOKS_API_KEY=your-google-books-api-key
Anggota perpustakaan (dari SIA)
Anggota perpustakaan adalah siswa, dan datanya milik SIA (Sitong). BACA
menarik daftar lengkap siswa dari GET /api/v1/perpustakaan/anggota di SIA
(kontraknya di ADR-0019 milik SIA) setiap MEMBER_SYNC_INTERVAL_HOURS jam, dan
pustakawan bisa menekan Sinkron sekarang di /admin/anggota.
- Dicocokkan lewat ID siswa di SIA. NISN menjadi nomor anggota; NISN yang kosong atau dipakai dua siswa dibiarkan kosong dan dilaporkan di halaman anggota.
- Siswa yang lulus, pindah, nonaktif, atau hilang dari SIA menjadi anggota nonaktif — tidak pernah dihapus, karena riwayat peminjaman menunjuk ke sana.
- Sinkron menolak menerapkan hasil yang tampak salah: SIA mengembalikan nol
siswa, atau lebih dari separuh anggota aktif akan dinonaktifkan sekaligus
(biasanya
SIA_SEKOLAHkeliru). Pustakawan bisa menerapkannya tetap setelah memeriksa. - Data anggota hanya diubah di SIA; halaman anggota di BACA sengaja hanya-baca.
SIA_URL=https://sia.sekolah.sch.id
# Wajib bila SIA melayani beberapa sekolah dan tidak diakses lewat domain
# sekolah itu sendiri: id atau slug sekolah di SIA.
SIA_SEKOLAH=
# Sama dengan Pengaturan > Integrasi > kunci integrasi di SIA. Kunci yang sama
# dipakai SIA untuk membaca katalog dan progres baca dari BACA.
SIA_INTEGRATION_KEY=
MEMBER_SYNC_INTERVAL_HOURS=6
Di SIA, modul Perpustakaan Digital harus aktif (URL BACA dan kunci integrasi
terisi), atau endpoint menjawab MODUL_NONAKTIF.
Peran
| Peran | Dari mana | Boleh |
|---|---|---|
student |
bawaan | membaca, favorit |
pustakawan |
diberikan admin di /admin/pengguna |
katalog, eksemplar, anggota, (fase 3) sirkulasi |
admin |
Casdoor (isAdmin atau peran berisi "admin") |
semua di atas + mengatur pustakawan |
superadmin |
diisi langsung di database | sama dengan admin; tidak tertimpa saat login |
Sirkulasi
Layar loket di /sirkulasi (staf): pindai kartu anggota (NISN) lalu barcode buku untuk
meminjamkan; pindai barcode buku saja untuk mengembalikan. Tidak ada denda — anggota
yang punya buku terlambat tidak bisa meminjam lagi sampai bukunya kembali. Hari libur
diatur di /admin/libur; jatuh tempo digeser ke hari buka berikutnya.
LOAN_DAYS=7 # lama pinjam (hari kalender sebelum digeser)
LOAN_MAX_ITEMS=2 # buku yang boleh dipegang sekaligus
LOAN_MAX_RENEWALS=1 # berapa kali satu pinjaman boleh diperpanjang
LIBRARY_CLOSED_WEEKDAYS=0,6 # hari tutup mingguan, 0=Minggu … 6=Sabtu; "0" untuk sekolah 6 hari
Satu eksemplar tidak mungkin punya dua pinjaman terbuka: selain dicek di dalam
transaksi, indeks unik parsial loans_one_open_per_item menolaknya di database.
Eksemplar atau judul yang punya riwayat pinjam tidak bisa dihapus — ubah statusnya ke
disiangi.
Opname, cetak, dan laporan
/admin/opname— pindai semua eksemplar di rak; saat ditutup, yang tidak ditemukan ditinjau dan bisa ditandai hilang. Buku yang sedang dipinjam tidak dihitung hilang./admin/cetak— label barcode (Code 39), label punggung (call number), dan kartu anggota. Cetak dengan skala 100%.NEXT_PUBLIC_SCHOOL_NAMEmengatur nama sekolah di kartu./admin/laporan— statistik koleksi, sirkulasi, keterlambatan, buku terpopuler, anggota teraktif, rekap per kelas, nilai aset; semuanya bisa diunduh sebagai CSV (pemisah;, siap dibuka di Excel berbahasa Indonesia).
Katalog dari foto
Untuk buku tanpa ISBN (atau yang ISBN-nya tidak dikenal Google Books/OpenLibrary — umum
untuk buku teks lama dan penerbit lokal): di /admin/tambah, buka Isi dari foto
halaman judul, foto halaman judul dan halaman hak cipta, lalu Baca dengan AI.
Butuh minimal satu provider yang bisa membaca gambar (mis. GEMINI_API_KEY). Hasilnya
selalu ditandai "periksa ejaan" sampai pustakawan menandainya sudah diperiksa di halaman
ubah buku. Foto sampul bisa ditambahkan sekalian.
Katalogisasi AI
Saat sebuah PDF diunggah, antrean latar belakang membaca beberapa halaman pertama dan meminta model bahasa mengisi judul, penulis, kategori, jenjang kelas, sinopsis, penerbit, dan tahun terbit.
Permintaan dicoba ke beberapa provider secara berurutan. Untuk tiap provider ada
maksimum 3 percobaan dengan jeda yang membesar (backoff + jitter), tapi hanya
untuk kegagalan sementara — 429, 5xx, dan timeout. Kegagalan permanen seperti 401
langsung lompat ke provider berikutnya. Ini yang mencegah 503 Service Unavailable
dari Gemini free tier menandai buku sebagai gagal permanen.
Dua jalur pembacaan: teks dan gambar
Jalur teks (utama). pdf-parse menarik lapisan teks dari 12 halaman pertama.
Murah dan akurat — dipakai selama PDF-nya punya teks.
Jalur gambar (cadangan). Buku yang dipindai dari kertas tidak punya lapisan teks sama sekali; ekstraksi mengembalikan nol karakter, dan mengulang atau berganti provider tidak menolong karena tidak ada teks untuk dibaca. Dalam kasus itu 6 halaman pertama dirender jadi JPEG dengan Ghostscript lalu dikirim ke model vision. Jauh lebih mahal dalam token, jadi hanya dipakai kalau jalur teks memang kosong.
Provider yang tidak bisa membaca gambar otomatis dilewati untuk buku pindaian. Buku yang lewat jalur ini ditandai di catatan tinjauan agar pustakawan tahu metadatanya lebih rawan salah baca.
Ghostscript sudah terpasang di image Docker (Dockerfile baris 4) dan juga dipakai
untuk membuat sampul. Kalau di mesin pengembangan Ghostscript ada tapi tidak di PATH,
setel GHOSTSCRIPT_PATH.
Semua provider opsional. Yang API key-nya kosong dilewati tanpa suara, jadi
mengisi GEMINI_API_KEY saja membuat aplikasi berperilaku persis seperti sebelumnya.
Provider yang didukung
| Nama | API key | Model default | Model untuk gambar | Harga per 1 juta token (masuk / keluar) |
|---|---|---|---|---|
gemini |
GEMINI_API_KEY |
gemini-flash-latest |
sama | Ada kuota gratis |
deepseek |
DEEPSEEK_API_KEY |
deepseek-v4-flash |
deepseek-v4-flash-vision-exp |
$0,22–0,44 / $0,66–1,32 |
moonshot (Kimi) |
MOONSHOT_API_KEY |
kimi-k2.6 |
sama | $0,95 / $4,00 |
openai |
OPENAI_API_KEY |
gpt-5.6-luna |
sama | $0,20 / $1,20 |
anthropic (Claude) |
ANTHROPIC_API_KEY |
claude-opus-5 |
sama | $5,00 / $25,00 |
Harga di atas tercatat pada September 2026 dan bisa berubah — periksa ke halaman harga masing-masing vendor. DeepSeek memberi tarif lebih murah di luar jam sibuk.
Langganan tidak bisa dipakai di sini. Claude Pro/Max hanya untuk claude.ai dan Claude Code; ChatGPT Plus hanya untuk chatgpt.com. Untuk memanggil API dari aplikasi ini diperlukan API key terpisah yang ditagih per token.
Pengaturan
# Urutan percobaan. Default: gemini,deepseek,moonshot
# Gemini didahulukan karena punya kuota gratis; provider berbayar baru dipakai
# ketika Gemini sedang padat atau kuotanya habis.
AI_PROVIDER_ORDER=gemini,deepseek,moonshot
DEEPSEEK_API_KEY=your-deepseek-api-key
MOONSHOT_API_KEY=your-moonshot-api-key
OPENAI_API_KEY=your-openai-api-key
ANTHROPIC_API_KEY=your-anthropic-api-key
# Opsional: ganti model tanpa menyentuh kode.
GEMINI_MODEL=
DEEPSEEK_MODEL=
MOONSHOT_MODEL=
OPENAI_MODEL=
ANTHROPIC_MODEL=
# Opsional: model khusus untuk membaca gambar (buku hasil pindai).
DEEPSEEK_VISION_MODEL=
MOONSHOT_VISION_MODEL=
OPENAI_VISION_MODEL=
# Opsional: lokasi Ghostscript kalau tidak ada di PATH (mis. Nix, Homebrew).
GHOSTSCRIPT_PATH=
# Opsional: batas waktu per percobaan, dalam milidetik. Default 60000.
# Naikkan kalau memakai endpoint sendiri yang lambat.
AI_REQUEST_TIMEOUT_MS=60000
# Opsional: arahkan ke endpoint lain yang kompatibel-OpenAI (mis. OpenRouter,
# atau endpoint Moonshot wilayah lain).
DEEPSEEK_BASE_URL=
MOONSHOT_BASE_URL=
OPENAI_BASE_URL=
DeepSeek, Kimi, dan OpenAI dilayani oleh satu adapter yang sama karena ketiganya
berbicara protokol chat-completions OpenAI. Menambah vendor kompatibel lain cukup
satu entri di src/lib/ai/registry.ts — tidak perlu file baru.
Jalankan npm test untuk memverifikasi logika retry, fallback, dan timeout.
Server Requirements
- Ubuntu 20.04+
- Docker & Docker Compose
- 4GB RAM minimum
- 100GB disk space