ALESA Library Stack — Panduan Pengguna PPK Putrajaya

Pengenalan Sistem

ALESA Library Stack v1 ialah sistem pengurusan perpustakaan moden yang direka khusus untuk menggantikan SPPB (Sistem Pengurusan Perpustakaan Bersepadu) sedia ada di Pusat Pembelajaran Kejiranan (PPK) Perbadanan Putrajaya. Sistem ini mengekalkan setiap fungsi 13-modul ILMU sebelumnya, menyambung terus kepada hardware RFID sedia terpasang di 4 cawangan, dan menambah keupayaan moden seperti notifikasi WhatsApp dan AI augmentative.

Apa yang dikekalkan dari sistem lama

• 13 modul operasi ILMU — Acquisition, Authority, Circulation, Cataloging, Accounting, Foundation, OPAC, Receipting, Serials, Stock Take, Document Delivery, IRIS, Reporting
• Semua RFID hardware (Staff Station, Smart Gate, Book Drop, UHF Tags) — tiada penggantian, tiada re-tag 98K+ buku
• Integrasi SAP-PPi untuk pembayaran dengan SAP Kod Fi PPJ
• 4 microsite cawangan (Presint 8, 9, 11, 16) dengan kandungan tempatan
• Kawalan akses internet awam (modul PKAI) — naik taraf kepada PKAI 2.0

Apa yang ditambah

• 📱 Portal Ahli PWA — boleh dipasang di telefon, scan ISBN guna kamera, terima notifikasi tarikh pulang
• 🤖 AI Augmentative — pencarian semantik, saranan koleksi, pustakawan bot 24/7
• 📲 WhatsApp Notifikasi — auto-peringatan denda, koleksi baru, jadual aktiviti
• 📊 AI Generative Insights — laporan eksekutif untuk YBhg Pengarah, kenal pasti trend & cadangan strategik
• ♿ WCAG 2.1 AA — sokongan screen-reader, kontras tinggi untuk OKU/warga emas

3 Peranan Pengguna

Sistem mempunyai 3 peranan utama. Setiap peranan mempunyai dashboard tersendiri dengan kebenaran (RBAC) berbeza.

Cara Log Masuk

1. Buka pelayar web
   Chrome, Edge, Safari, atau Firefox versi terkini.
2. Pergi ke alamat https://demo.pasa.my/
   Halaman landing akan dipaparkan dengan 3 pilihan demo login.
3. Klik butang "🚀 Masuk Demo Sekarang"
   Anda akan dibawa ke halaman log masuk dengan reka bentuk dua-bahagian (pitch di kiri, borang di kanan).
4. Klik salah satu "Demo Login" di bawah borang
   Sistem akan auto-isi ID pengguna dan kata laluan. Atau anda boleh taip manual.
5. Klik "Log Masuk →"
   Sistem mengesahkan kelayakan. Jika berjaya, anda diarahkan ke dashboard yang sesuai dengan peranan.

Journey Admin · Dashboard Eksekutif

Sebaik log masuk sebagai admin.demo, anda akan melihat dashboard utama dengan ringkasan operasi semua 4 cawangan PPK.

Elemen Utama Dashboard

Journey Admin · Pengurusan Ahli

Modul Pengurusan Ahli ialah pengganti modul Foundation dalam ILMU sedia ada. Ia menyimpan rekod 12,847 ahli aktif merentas 4 cawangan PPK.

Bagaimana Mendaftar Ahli Baru

1. Klik "👥 Ahli" pada sidebar
   Anda akan dibawa ke senarai ahli dengan filter kategori di atas.
2. Klik butang "+ Daftar Ahli Baru" di kanan atas
   Modal popup akan muncul dengan borang pendaftaran.
3. Isi maklumat asas
   No. Kad Pengenalan (auto-validate format), nama penuh, no. telefon, e-mel.
4. Pilih Kategori Ahli
   Dewasa (RM10/tahun), Kanak-kanak (Percuma), Warga Emas (Percuma), OKU (Percuma), Pelajar (RM5/tahun).
5. Pilih Cawangan Utama
   Cawangan tempat ahli paling kerap berkunjung. Ahli boleh tetap pinjam dari mana-mana cawangan.
6. Tandakan "Opt-in WhatsApp" jika ahli setuju
   Diperlukan untuk peringatan pulang & koleksi baru. PDPA compliance.
7. Klik "Daftar + Hantar Resit"
   Sistem akan: (a) cipta rekod ahli, (b) integrate ke SAP-PPi jika ada yuran, (c) hantar resit ke WhatsApp ahli, (d) tunjuk toast pengesahan.

Bagaimana Mencari Ahli Sedia Ada

• Gunakan kotak carian di topbar — boleh taip nama, IC, atau no. ahli (cth. F20251)
• Atau gunakan filter kategori (Dewasa, Kanak-kanak, dll) di atas jadual
• Atau pilih cawangan dari dropdown
• Klik ikon 👁 di lajur "Tindakan" untuk lihat profil penuh, sejarah pinjaman, denda, aktiviti

Journey Admin · Katalog Koleksi

Modul Katalog menggabungkan Acquisition, Cataloging, Authority Maintenance, Serials, dan Stock Take dari ILMU dalam satu antara muka moden.

Tambah Koleksi Baru (3 Kaedah)

Kaedah 1 — Imbas ISBN dengan Kamera

1. Klik "+ Tambah Koleksi"
2. Klik ikon kamera dalam ruangan ISBN — sistem akan akses kamera laptop/USB scanner
3. Imbas barcode ISBN di belakang buku — auto-isi tajuk, pengarang, penerbit, kulit buku (dari Open Library API)
4. Imbas UHF tag — letakkan buku atas Staff Station
5. Lengkapkan klasifikasi DDC + lokasi rak
6. Klik "Simpan & Aktif" — koleksi sedia dipinjam

Kaedah 2 — Taip ISBN Manual

Untuk buku tanpa barcode atau imbasan gagal — taip ISBN secara manual, tekan Tab untuk trigger auto-fetch.

Kaedah 3 — Import MARC21 Pukal

Untuk perolehan besar dari vendor (DBP, dsb) — import fail .mrc atau .csv terus. Sistem akan validate dan stage untuk semakan sebelum commit.

Pencarian Semantik AI

Berbeza dari pencarian kata kunci biasa, AI Semantic Search memahami niat. Contoh: taip "buku motivasi untuk pelajar yang akan SPM", sistem akan kembali dengan 3-5 buku yang paling relevan walaupun tiada perkataan "SPM" atau "motivasi" dalam tajuk.

Stock Take Mingguan

1. Pustakawan ambil UHF Hand-held Reader dari kaunter
2. Scan rak satu demi satu — reader baca semua UHF tag dalam jarak ~3 meter
3. Sync ke sistem via WiFi PPK (auto)
4. Sistem padankan dengan rekod — paparkan buku "tidak ditemui"
5. Pustakawan lihat senarai missing dan investigate (mungkin salah rak, atau betul-betul hilang)
6. Status dikemaskini — "Hilang", "Rosak", "Salah Rak" — semua direkodkan audit trail

Journey Admin · Laporan & Analitik

Modul ini menggabungkan Reporting dan IRIS dari ILMU, ditambah dengan AI Generative Insights untuk pengurusan eksekutif.

4 KPI Eksekutif Bulanan

• Penyertaan Bulan Ini — pengguna unik yang masuk PPK (data dari PKAI + Self-Kiosk + Loan)
• Pinjaman Mei — jumlah transaksi pinjaman (semua cawangan)
• Purata Tempoh Pinjam — penunjuk engagement (semakin panjang = semakin baik kualiti koleksi)
• Hasil Yuran + Denda — auto-disambung ke SAP-PPi, boleh export untuk laporan kewangan

AI Generative Insights — Untuk YBhg Pengarah

Setiap bulan, sistem auto-jana 5 cadangan strategik berdasarkan trend data 90 hari. Contoh insight sebenar dari data demo:

Eksport Laporan

• PDF Bulanan — 1-klik download, format A4 portrait, sedia untuk mesyuarat pengurusan
• Excel/CSV — untuk analisis lanjut, integrate dengan Power BI/Tableau jika perlu
• E-mel Berjadual — hantar laporan automatik kepada YBhg Pengarah pada 1hb setiap bulan

Journey Pustakawan · Terima Koleksi Baru

Apabila vendor menghantar karton buku baru, pustakawan mengikuti prosedur berikut:

1. Buka modul Acquisition (di bawah Katalog Koleksi → tab Acquisition) untuk melihat PO yang dijangka. Sistem akan tunjuk vendor, jumlah, dan senarai ISBN dijangka.
2. Padan jumlah fizikal dengan PO. Jika ada perbezaan, klik "Lapor Perbezaan" — sistem akan jana e-mel kepada vendor.
3. Ambil buku pertama. Imbas ISBN guna kamera atau handheld scanner. Sistem akan auto-isi tajuk, pengarang, penerbit, kulit buku.
4. Imbas UHF tag kosong di atas Staff Station — sistem mengaitkan tag dengan buku ini. Tag akan diprogram dengan no. inventori unik.
5. Lekatkan UHF tag di muka belakang buku (atau di posisi standard ditetapkan PPK).
6. Lekatkan label rak dengan klasifikasi DDC (cth. 813.6 SAM) yang diprint dari sistem.
7. Klik "Sahkan & Aktif" — buku kini sedia dipinjam. Sistem auto-update statistik Acquisition.
8. Bawa buku ke rak dan letakkan mengikut klasifikasi DDC. Selesai!

Journey Pustakawan · Proses Pinjaman

Inilah operasi paling kerap di kaunter PPK. Sistem direka supaya boleh proses 3-5 buku dalam masa 10 saat.

1. Ahli datang ke kaunter dengan beberapa buku.
2. Pustakawan klik "🔄 Pinjaman & Pulangan" pada sidebar, kemudian klik "Mod Cepat (RFID Bulk)".
3. Imbas kad ahli (atau MyKad, atau no. ahli) — sistem auto-paparkan profil ahli, jumlah pinjaman semasa, dan denda jika ada.
4. Letakkan kesemua buku atas Staff Station — UHF antenna akan baca semua tag serentak dalam <2 saat.
5. Sistem auto-paparkan senarai buku. Pustakawan boleh keluarkan mana-mana buku yang ahli ubah fikiran.
6. Sahkan dengan klik "✅ Sahkan Pinjaman · Cetak Resit". Sistem akan:
   (a) Update DB · (b) De-aktif UHF tag dari smart gate · (c) Cetak resit termal di kaunter · (d) Hantar SMS/WA kepada ahli dengan tarikh pulang
7. Ahli boleh keluar dari smart gate tanpa penggera berbunyi.

Journey Pustakawan · Proses Pulangan & Denda

3 Kaedah Pulangan

Kaedah 1 — Book Drop (Luar Waktu Operasi)

1. Ahli memasukkan buku ke dalam slot Book Drop.
2. UHF reader dalam Book Drop baca tag automatik.
3. Sistem rekod pulangan dengan timestamp.
4. Jika lewat pulang, denda auto-dikira (RM 0.50/hari/buku).
5. Buku kekal dalam Book Drop sehingga pegawai ambil pagi keesokan.

Kaedah 2 — Self Check-In Kiosk

1. Ahli berdiri di kiosk dalam PPK.
2. Letakkan buku atas reader.
3. Sistem confirm dengan beep + skrin "✓ Selamat Pulang".
4. Resit pulangan dicetak (jika ahli pilih).

Kaedah 3 — Kaunter Pustakawan

1. Ahli datang ke kaunter dengan buku.
2. Pustakawan letakkan buku atas Staff Station.
3. Sistem auto-paparkan: nama ahli, tarikh pinjam, tarikh sepatutnya pulang, denda (jika ada).
4. Jika ada denda → tunjuk options bayar tunai/FPX/SAP-PPi.
5. Jika buku rosak → klik "Caj Rosak" → masuk dalam workflow Assessment.

Polisi Denda Standard PPK

Journey Pustakawan · Stock Take Mingguan

Stock take adalah proses audit fizikal vs DB untuk pastikan integriti koleksi.

1. Setiap Isnin pagi, pustakawan ambil UHF handheld reader dari kaunter (dicas malam sebelum).
2. Buka modul Katalog → tab Stock Take di tablet/laptop.
3. Pilih cawangan + julat rak (cth. P16, Rak A-101 hingga A-220).
4. Mula imbas — berjalan di hadapan rak dengan reader. Reader bunyikan beep setiap kali bertemu tag baru.
5. Sync ke sistem (auto via WiFi setiap 30 saat, atau manual jika perlu).
6. Sistem padankan dengan DB. Buku yang tidak ditemui akan masuk ke senarai "Missing".
7. Pustakawan kaji setiap entry missing — mungkin: (a) di Book Drop, (b) dipinjam tapi tag rosak, (c) salah rak, (d) benar-benar hilang.
8. Update status setiap missing entry — sistem akan kekalkan dalam DB tetapi flag untuk perhatian Acquisition.

Journey Ahli · Daftar Keahlian

Ahli baru boleh daftar (a) datang ke mana-mana cawangan PPK, atau (b) self-register online via portal awam.

Daftar Online (Self-Service)

1. Pelawat masuk ke ppk.ppj.gov.my (atau URL produksi baharu)
2. Klik "Daftar Ahli Baru" pada laman utama
3. Isi maklumat asas — IC, nama, telefon, e-mel, alamat, kategori (auto-pilih ikut umur)
4. Upload gambar diri (untuk kad keahlian) — boleh guna kamera telefon
5. Bayar yuran via FPX/Toyyibpay (jika kategori berbayar) — automatik integrate SAP-PPi
6. Terima resit + kad keahlian digital via e-mel + WhatsApp
7. Lawat cawangan dalam 14 hari untuk pengesahan + ambil kad fizikal

Daftar di Kaunter

Pustakawan mengikut Journey § 05 (Pengurusan Ahli) di atas. Ahli akan terima resit + kad terus.

Journey Ahli · Cari & Tempah Buku

Setelah log masuk ke PWA MyPPK, ahli boleh cari buku dengan 3 cara:

1. Carian Kata Kunci Standard

Taip tajuk, pengarang, atau ISBN. Sistem akan paparkan hasil dalam <1 saat.

2. Imbas ISBN dengan Kamera

Klik "📷 Scan ISBN" → benarkan akses kamera → arahkan ke barcode buku (di kedai buku, perpustakaan lain, dsb). Sistem akan semak jika PPK ada koleksi itu.

3. Pustakawan AI

Taip soalan natural — contoh:

• "Cari buku tentang astronomi untuk anak Darjah 4"
• "Saya nak baca novel Melayu klasik macam A. Samad Said"
• "Apa buku baru tentang ekonomi syariah?"

Tempah Buku (Reservation)

1. Cari buku yang dikehendaki
2. Jika "Dipinjam" — klik "📚 Tempah"
3. Pilih cawangan untuk ambil bila siap
4. Sistem cipta tempahan + sambung kepada giliran (jika ada orang lain dah tempah)
5. Sistem hantar WA bila buku tersedia (selepas pulangan)
6. Ahli ada 3 hari untuk ambil sebelum tempahan dibatal

Journey Ahli · Renew Pinjaman

Setiap pinjaman boleh diperbaharui sekali jika tiada orang lain tempah buku itu.

1. Buka PWA MyPPK
2. Pada bahagian "Pinjaman Aktif" — klik buku yang nak renew
3. Klik butang "📚 Renew"
4. Sistem semak jika ada tempahan (dari ahli lain). Jika ada → "Maaf, ada tempahan. Sila pulangkan."
5. Jika OK — tarikh pulang baru dijana (14 hari lagi dari hari ini)
6. Sistem hantar WA pengesahan

Journey Ahli · Bayar Denda

1. PWA paparkan denda dalam "Akaun" di bahagian bawah
2. Klik "💳 Bayar Denda"
3. Pilih jumlah (boleh bayar sebahagian)
4. Pilih kaedah:
   • 💳 FPX (Maybank, CIMB, dll) — direct debit dari akaun bank
   • 🅿️ Toyyibpay — bayaran kad kredit/debit
   • 💰 e-Wallet (TnG, Boost, GrabPay) — Phase 2
5. Disambungkan ke pintu bayaran rasmi PPJ (integrate SAP-PPi Kod Fi)
6. Setelah berjaya, resit auto-dijana
7. WA pengesahan dihantar dengan PDF resit
8. Status ahli ditukar dari "Disekat" ke "Aktif" serta-merta (jika ada)

Journey Ahli · Daftar Aktiviti & Bengkel

1. PWA paparkan "Aktiviti Akan Datang" dalam bentuk slider kad
2. Klik kad aktiviti untuk lihat butiran penuh
3. Lihat: Tarikh, waktu, lokasi, jumlah peserta semasa vs maksimum, yuran (jika ada)
4. Klik "Daftar →"
5. Jika berbayar — masuk pintu bayaran SAP-PPi
6. Jika percuma — terus pengesahan
7. Sistem hantar WA tiket QR
8. Pada hari aktiviti, ahli tunjuk QR di kaunter — pustakawan scan, masuk
9. Selepas aktiviti, ahli terima borang feedback via WA

Integrasi: SIP2 RFID Bridge

SIP2 (Standard Interchange Protocol v2) adalah protokol industri untuk komunikasi antara LMS dan hardware perpustakaan (RFID readers, self-check kiosks, smart gates, book drops).

Hardware yang sudah ada di PPK (4 cawangan)

• UHF Staff Station — 4 unit (1/cawangan)
• Smart Gate (anti-theft) — 4 set
• Book Drop dengan UHF reader — 4 unit
• Self Check-In Kiosk — 8 unit
• Hand-held Reader untuk Stock Take — 4 unit

Bagaimana ALESA menyambung

1. ALESA membina SIP2 Server sebagai middleware
2. Hardware berkomunikasi dengan SIP2 Server via TCP/IP port 6001 (standard)
3. SIP2 Server menterjemah ke API ALESA dalam Laravel
4. Tiada perubahan hardware diperlukan — vendor SPKK sedia ada (Bibliotheca, 3M, atau lain-lain) menyokong SIP2 secara native
5. Konfigurasi setting hardware sekali untuk halakan ke SIP2 Server baharu

Integrasi: SAP-PPi Payment

PPJ menggunakan SAP sebagai sistem kewangan utama. Setiap bayaran (yuran keahlian, denda, aktiviti berbayar) perlu masuk ke SAP via Kod Fi yang ditetapkan Jabatan Kewangan.

Aliran bayaran via PWA Ahli

Field Wajib untuk Setiap Transaksi (per SAP)

1. id_transaksi — UUID unique
2. maklumat_pemohon — IC/no. ahli
3. nama_pemohon
4. kod_fi — dari pemetaan SAP (PPK-MEM-001, PPK-FINE-001, dll)
5. caj_deposit
6. jumlah_bayaran
7. jumlah_keseluruhan
8. jenis_bayaran — Kod 2: Penuh

Integrasi: WhatsApp WAHA Notifikasi

ALESA menggunakan WAHA (WhatsApp HTTP API) untuk hantar notifikasi automatik via WhatsApp Business — kos rendah, tanpa lesen WhatsApp Business API rasmi yang mahal.

7 Templat Notifikasi Standard

Polisi Anti-Spam

• Ahli mesti opt-in semasa pendaftaran (PDPA)
• Ada butang "Unsubscribe" dalam setiap mesej
• Maksimum 1 mesej promosi/minggu
• Waktu hantar: 08:00–21:00 sahaja (selain mesej penting)

Integrasi: AI Augmentative

ALESA menggunakan AI sebagai pembantu, bukan pengganti pustakawan. 4 keupayaan utama:

1. Carian Semantik (Semantic Search)

Berdasarkan embedding model (cth. OpenAI text-embedding-3-small atau open-source sentence-transformers). Setiap rekod katalog di-embed sekali, disimpan dalam pgvector / Meilisearch. Pencarian membandingkan cosine similarity vector.

2. Saranan Koleksi (Recommendations)

Algoritma collaborative filtering — "ahli yang baca X juga baca Y". Diperhalusi dengan content-based filtering (genre, kategori, pengarang) untuk ahli baru tanpa sejarah.

3. Pustakawan AI Chatbot

LLM (open-source seperti Llama 3 atau cloud seperti Claude/GPT) yang dilengkapi dengan RAG (Retrieval-Augmented Generation) atas pangkalan data katalog PPK. Boleh jawab "ada buku tentang X?", "syor saya buku Y", dll.

4. AI Generative Insights untuk Eksekutif

Setiap bulan, sistem auto-jana 5 cadangan strategik berdasarkan trend data. Tidak menggantikan pengarah — tetapi menyumbang sebagai "Strategy Partner" yang membaca data 24/7.

Integrasi: PKAI 2.0 (Kawalan Akses Internet Awam)

PPK menyediakan akses internet awam di setiap cawangan. PKAI mengawal siapa boleh guna, untuk berapa lama, dan untuk apa.

Aliran Pengguna PKAI

1. Pengguna sambung ke WiFi PPK
2. Captive portal muncul — "Sila log masuk untuk akses internet"
3. Login dengan no. ahli PPK (atau guest dengan IC)
4. Sistem semak quota dan status
5. Akses dibenarkan selama 2 jam (boleh extend)
6. Aktiviti dilog (URL hash + timestamp) untuk audit SKMM 12 bulan
7. Kuota habis → captive portal muncul semula

Pematuhan SKMM CMA 1998 Sek 588

Log akses awam mesti disimpan selama 12 bulan, di-hash SHA-256 untuk integriti, dan boleh diserahkan kepada agensi penguatkuasaan dalam tempoh 14 hari.

Soalan Lazim (FAQ)

Glossary · Istilah Teknikal

Hubungi & Sokongan

"Kerja sampai siap, report bila done." — Falsafah ALESA