RD BookHub ialah sistem tempahan sumber yang membolehkan kakitangan menempah peralatan, kenderaan, bilik mesyuarat, dan sumber lain secara dalam talian.

1.1 Keupayaan Staff

Jadual 1.1: Fungsi Staff

RD BookHub is a resource booking system that allows staff to book equipment, vehicles, meeting rooms, and other resources online.

1.1 Staff Capabilities

Table 1.1: Staff Functions

2.1 Pendaftaran

Jika anda belum mempunyai akaun:

Jadual 2.1: Langkah Pendaftaran

Jadual 2.2: Medan Borang Pendaftaran

2.1.1 Ralat Pendaftaran

Jadual 2.3: Ralat Pendaftaran

2.2 Log Masuk

Jadual 2.4: Langkah Log Masuk

2.2.1 Situasi Khas

Jadual 2.5: Situasi Khas Log Masuk

2.3 Lupa Kata Laluan

Jadual 2.6: Langkah Reset Kata Laluan

2.4 Pengesahan Dua Faktor (2FA)

Jika 2FA diaktifkan pada akaun anda:

• Selepas memasukkan IC dan kata laluan, anda akan diminta kod pengesahan
• Masukkan kod dari aplikasi authenticator anda
• Klik "Verify"

2.1 Registration

If you do not yet have an account:

Table 2.1: Registration Steps

Table 2.2: Registration Form Fields

2.1.1 Registration Errors

Table 2.3: Registration Errors

2.2 Login

Table 2.4: Login Steps

2.2.1 Special Situations

Table 2.5: Special Login Situations

2.3 Forgot Password

Table 2.6: Password Reset Steps

2.4 Two-Factor Authentication (2FA)

If 2FA is enabled on your account:

• After entering your IC and password, you will be prompted for a verification code
• Enter the code from your authenticator app
• Click "Verify"

URL: /dashboard

Selepas log masuk, anda akan dibawa ke halaman Dashboard.

3.1 Kad Statistik (3 KPI)

Jadual 3.1: Kad Statistik Dashboard Staff

3.2 Kalendar Tempahan

Kalendar interaktif menunjukkan semua tempahan mengikut tarikh. Anda boleh:

• Navigasi bulan (klik anak panah kiri/kanan)
• Klik pada tempahan untuk melihat butiran

3.3 Tempahan Terkini (Top 10)

Jadual menunjukkan 10 tempahan terkini anda dengan:

• Nombor tempahan, nama sumber, kategori, tarikh, status
• Butang "View" untuk melihat butiran

Klik "View All" untuk pergi ke halaman Tempahan Saya.

URL: /dashboard

After logging in, you will be taken to the Dashboard page.

3.1 Statistics Cards (3 KPIs)

Table 3.1: Staff Dashboard Statistics Cards

3.2 Booking Calendar

An interactive calendar displays all your bookings by date. You can:

• Navigate months (click left/right arrows)
• Click on a booking to view its details

3.3 Recent Bookings (Top 10)

A table displays your 10 most recent bookings with:

• Booking number, resource name, category, date, status
• "View" button to see details

Click "View All" to go to the My Bookings page.

URL: /resources

4.1 Penapis

Jadual 4.1: Penapis Sumber

Klik "Apply" untuk menapis, atau "Reset" untuk bersihkan semua penapis.

4.2 Kad Sumber

Setiap sumber dipaparkan sebagai kad yang menunjukkan:

• Gambar sumber dan badge kategori (berwarna mengikut warna yang ditetapkan oleh pentadbir)
• Nama sumber dan harga (jika ada)
• Penerangan ringkas dan kapasiti (jika ada)

4.3 Status Ketersediaan

Jadual 4.2: Status Ketersediaan

4.4 Tindakan

• "View Details" (ikon mata) — Lihat maklumat penuh sumber termasuk sub-item, gambar, dan statistik tempahan
• "Book Now" (ikon kalendar) — Terus ke halaman tempahan baru dengan sumber ini dipilih

URL: /resources

4.1 Filters

Table 4.1: Resource Filters

Click "Apply" to filter, or "Reset" to clear all filters.

4.2 Resource Cards

Each resource is displayed as a card showing:

• Resource image and category badge (coloured based on badge color set by admin)
• Resource name and price (if any)
• Brief description and capacity (if any)

4.3 Availability Status

Table 4.2: Availability Status

4.4 Actions

• "View Details" (eye icon) — View full resource information including sub-items, images, and booking statistics
• "Book Now" (calendar icon) — Go directly to the new booking page with this resource selected

5.1 Tambah ke Troli

Jadual 5.1: Langkah Tambah ke Troli

5.2 Urus Troli

URL: /cart

Di halaman troli, anda boleh:

• Melihat semua item yang ditambah
• Membuang item yang tidak diperlukan
• Meneruskan ke checkout

5.3 Checkout

Jadual 5.2: Langkah Checkout

5.3.1 Semakan Sistem

Jadual 5.3: Semakan Semasa Checkout

5.4 Keputusan Tempahan

Jadual 5.4: Keputusan Selepas Checkout

5.1 Add to Cart

Table 5.1: Add to Cart Steps

5.2 Cart Management

URL: /cart

On the cart page, you can:

• View all added items
• Remove unwanted items
• Proceed to checkout

5.3 Checkout

Table 5.2: Checkout Steps

5.3.1 System Checks

Table 5.3: Checkout Validation Checks

5.4 Booking Outcome

Table 5.4: Post-Checkout Outcomes

URL: /bookings

6.1 Penapis & Carian

Jadual 6.1: Penapis Tempahan Saya

Butang: "Start New Booking", "Export", "Reset"

6.2 Jadual Tempahan

Jadual 6.2: Lajur Jadual Tempahan

6.3 Butang Tindakan

Jadual 6.3: Butang Tindakan

URL: /bookings

6.1 Filters & Search

Table 6.1: My Bookings Filters

Buttons: "Start New Booking", "Export", "Reset"

6.2 Bookings Table

Table 6.2: Bookings Table Columns

6.3 Action Buttons

Table 6.3: Action Buttons

URL: /bookings/{id}

7.1 Kad Status

Jadual 7.1: Paparan Kad Status

7.2 Maklumat Tempahan

• Butiran sumber (nama, kategori, penerangan)
• Tarikh mula dan tamat
• Tujuan tempahan
• Senarai peserta (jika ada)
• Maklumat pelanjutan (jika telah dilanjutkan): tarikh tamat asal, siapa yang melanjutkan, dan bila

7.3 Sejarah Kutipan & Pemulangan

Jika sumber telah dikutip/dipulangkan, bahagian ini menunjukkan:

• Tarikh/masa kutipan dan siapa yang mengutip
• Item yang dikutip dan nota keadaan
• Gambar kutipan
• Tarikh/masa pemulangan dan status item (Returned / Missing)
• Gambar pemulangan

URL: /bookings/{id}

7.1 Status Card

Table 7.1: Status Card Display

7.2 Booking Information

• Resource details (name, category, description)
• Start and end dates
• Booking purpose
• Participant list (if any)
• Extension info (if extended): original end date, who extended, and when

7.3 Collection & Return History

If the resource has been collected/returned, this section shows:

• Collection date/time and who collected
• Items collected and condition notes
• Collection photos
• Return date/time and item status (Returned / Missing)
• Return photos

8.1 Bila Boleh Kutip?

Anda boleh mengutip sumber apabila:

• Status tempahan = Approved
• Masa semasa ≥ tarikh/masa mula tempahan
• Masa semasa ≤ tarikh/masa tamat tempahan

8.2 Proses Kutipan (Individu)

Jadual 8.1: Langkah Kutipan

Jadual 8.2: Medan Modal Kutipan

8.3 Kutipan Kumpulan

Untuk tempahan kumpulan:

• Klik butang "Collect" pada kumpulan
• Modal menunjukkan semua sumber dalam kumpulan dengan checkbox
• Select All untuk kutip semua sekali gus
• Isi nota keadaan dan muat naik gambar
• Klik "Confirm Collection"

8.1 When Can You Collect?

You can collect a resource when:

• Booking status = Approved
• Current time ≥ booking start date/time
• Current time ≤ booking end date/time

8.2 Collection Process (Individual)

Table 8.1: Collection Steps

Table 8.2: Collection Modal Fields

8.3 Group Collection

For group bookings:

• Click the "Collect" button on the group
• Modal shows all resources in the group with checkboxes
• Select All to collect all at once
• Fill in condition notes and upload photos
• Click "Confirm Collection"

9.1 Bila Boleh Pulang?

• Status tempahan = Collected
• Rekod kutipan wujud

9.2 Proses Pemulangan (Individu)

Jadual 9.1: Langkah Pemulangan

Jadual 9.2: Status Toggle Pemulangan

9.2.1 Susunan Pengesahan

• 1. Nota wajib dahulu (jika ada item Missing)
• 2. Gambar wajib selepas itu

9.3 Pemulangan Kumpulan

• Klik butang "Return" pada kumpulan
• Modal menunjukkan semua sumber dengan checkbox dan status
• Select All untuk tandakan/nyahtandakan semua
• Isi Return Notes (wajib jika ada yang Missing)
• Muat naik gambar dan klik "Confirm Return"

9.4 Kesan Item Missing

Jika ada sumber ditandakan sebagai Missing:

• Sumber ditetapkan sebagai tidak tersedia (is_available = false)
• Keadaan ditukar kepada "under maintenance"
• Admin diberitahu melalui notifikasi
• Nota penyelenggaraan direkodkan secara automatik

9.1 When Can You Return?

• Booking status = Collected
• Collection record exists

9.2 Return Process (Individual)

Table 9.1: Return Steps

Table 9.2: Return Status Toggle

9.2.1 Validation Order

• 1. Mandatory notes first (if any item is Missing)
• 2. Mandatory photo after that

9.3 Group Return

• Click the "Return" button on the group
• Modal shows all resources with checkboxes and status
• Select All to check/uncheck all at once
• Fill in Return Notes (mandatory if any item is Missing)
• Upload photos and click "Confirm Return"

9.4 Missing Item Impact

If any resource is marked as Missing:

• Resource is set to unavailable (is_available = false)
• Condition is changed to "under maintenance"
• Admin is notified via notification
• Maintenance notes are recorded automatically

10.1 Bila Boleh Beri Ulasan?

• Status tempahan = Returned
• Belum pernah memberi ulasan untuk tempahan ini

10.2 Proses Beri Ulasan

Jadual 10.1: Langkah Ulasan

Jadual 10.2: Medan Modal Ulasan

10.1 When Can You Review?

• Booking status = Returned
• You have not yet submitted a review for this booking

10.2 Review Process

Table 10.1: Review Steps

Table 10.2: Review Modal Fields

11.1 Bila Boleh Batal?

• Status = Pending atau Approved
• Anda ialah pemilik tempahan
• Masa semasa ≤ tarikh/masa tamat

11.2 Proses Pembatalan

Jadual 11.1: Langkah Pembatalan

11.1 When Can You Cancel?

• Status = Pending or Approved
• You are the booking owner
• Current time ≤ end date/time

11.2 Cancellation Process

Table 11.1: Cancellation Steps

Fungsi ini membolehkan anda melanjutkan tempoh tempahan sedia ada tanpa perlu membuat tempahan baru. Sistem akan menyemak ketersediaan sumber secara automatik.

12.1 Bila Boleh Extend?

• Status = Approved atau Collected (termasuk Overdue)
• Anda ialah pemilik tempahan
• Tarikh/masa tamat baru mesti lebih lewat daripada tarikh/masa tamat semasa
• Sumber mesti tersedia untuk tempoh lanjutan

12.2 Proses Pelanjutan (Individu)

Jadual 12.1: Langkah Pelanjutan Tempahan Individu

12.3 Pelanjutan Tempahan Kumpulan

Untuk tempahan kumpulan, anda boleh memilih mana-mana tempahan dalam kumpulan untuk dilanjutkan:

Jadual 12.2: Langkah Pelanjutan Tempahan Kumpulan

This feature allows you to extend the duration of an existing booking without creating a new one. The system will automatically check resource availability.

12.1 When Can You Extend?

• Status = Approved or Collected (including Overdue)
• You are the booking owner
• New end date/time must be later than the current end date/time
• Resource must be available for the extended period

12.2 Individual Extend Process

Table 12.1: Individual Extend Steps

12.3 Group Booking Extension

For group bookings, you can select which bookings within the group to extend:

Table 12.2: Group Extend Steps

Fungsi ini membolehkan kakitangan menghantar permohonan untuk membeli item. Permohonan akan disemak oleh Account dan diluluskan oleh Admin.

13.1 Senarai Permohonan Saya

URL: /purchase-requests

Halaman ini memaparkan semua permohonan pembelian anda dengan penapis berikut:

Jadual 13.1: Penapis Permohonan

13.2 Cipta Permohonan Baru

URL: /purchase-requests/create

Borang permohonan terdiri daripada 5 bahagian:

Bahagian 1: Maklumat Permohonan (auto-isi)

• Order No (auto-jana: PR-YYYYMMDD-XXXXXX)
• Tarikh, Nama Pemohon, Jabatan (dari profil pengguna)

Bahagian 2: Maklumat Vendor / Syarikat

Jadual 13.2a: Medan Vendor

Bahagian 3: Item Yang Ingin Dibeli

Jadual dinamik — boleh tambah/buang baris item.

Jadual 13.2b: Medan Item

Total per item dikira automatik: Qty × Unit Price × (1 - Discount/100)

Shipping Fees — yuran penghantaran (jika ada). Grand Total = Subtotal + Shipping Fees.

Bahagian 4: Nota / Catatan

• Priority — Keutamaan: Low, Medium, High, Urgent
• Notes / Remarks — Justifikasi untuk pembelian

Bahagian 5: Lampiran

• Muat naik sebut harga, PO, atau dokumen berkaitan (maks 5 fail, 10MB setiap satu)
• Format: JPG, PNG, WebP, PDF, DOC, DOCX
• Amaran akan dipaparkan jika jumlah ≥ RM 5,000 (sebut harga/PO diperlukan)
• Pratonton gambar untuk fail imej, ikon fail untuk dokumen
• Baru: Anda boleh menampal (Ctrl+V) tangkapan skrin atau seret & lepas fail dari desktop terus ke dalam borang

13.3 Status Permohonan

Jadual 13.3: Senarai Status Permohonan

13.4 Aliran Kelulusan

Staff hantar → Account semak (pilih kaedah penghantaran & pembayaran) → Admin luluskan/tolak → Pembelian

13.5 Butiran Permohonan

Klik pada permohonan untuk melihat butiran penuh termasuk maklumat vendor, senarai item, lampiran, dan komen semakan.

13.6 Ubah Suai Permohonan (Baru)

URL: /purchase-requests/{id}/edit

Anda kini boleh mengubah suai permohonan pembelian sendiri dalam keadaan tertentu sahaja.

Jadual 13.6: Syarat Ubah Suai

Cara Ubah Suai:

1. Dari senarai My Requests, klik ikon pensel (Edit) pada permohonan berstatus Submitted
2. Borang dimuatkan dengan nilai sedia ada (vendor, item, lampiran)
3. Kemaskini mana-mana medan. Anda boleh buang lampiran lama atau tambah lampiran baru (termasuk paste/drag-drop)
4. Klik "Update Request" untuk simpan perubahan

This feature allows staff to submit requests to purchase items. Requests will be reviewed by Account and approved by Admin.

13.1 My Request List

URL: /purchase-requests

This page displays all your purchase requests with the following filters:

Table 13.1: Request Filters

13.2 Create New Request

URL: /purchase-requests/create

The form consists of 5 sections:

Section 1: Request Information (auto-filled)

• Order No (auto-generated: PR-YYYYMMDD-XXXXXX)
• Date, Requisition By, Department (from user profile)

Section 2: Vendor / Company Information

Table 13.2a: Vendor Fields

Section 3: Items To Be Purchased

Dynamic table — add/remove item rows.

Table 13.2b: Item Fields

Total per item is auto-calculated: Qty × Unit Price × (1 - Discount/100)

Shipping Fees — delivery charges (if applicable). Grand Total = Subtotal + Shipping Fees.

Section 4: Notes / Remarks

• Priority — Low, Medium, High, Urgent
• Notes / Remarks — Justification for purchases

Section 5: Attachments

• Upload quotation, PO, or related documents (max 5 files, 10MB each)
• Formats: JPG, PNG, WebP, PDF, DOC, DOCX
• Warning alert when grand total ≥ RM 5,000 (quotation/PO required)
• Image preview for uploaded images, file icon for documents
• New: You can paste (Ctrl+V) screenshots or drag & drop files from your desktop directly into the form

13.3 Request Statuses

Table 13.3: Request Status List

13.4 Approval Flow

Staff submit → Account review (select shipping & payment method) → Admin approve/reject → Purchase

13.5 Request Details

Click on a request to view full details including vendor info, item list, attachments, and review comments.

13.6 Edit a Request (New)

URL: /purchase-requests/{id}/edit

You can now edit your own purchase request, but only under specific conditions.

Table 13.6: Edit Conditions

How to Edit:

1. From My Requests, click the pencil (Edit) icon on a request with Submitted status
2. The form loads with your existing values (vendor, items, attachments)
3. Modify any field. You can remove existing attachments or add new ones (including paste / drag & drop)
4. Click "Update Request" to save

Sistem maklum balas membolehkan anda menghantar cadangan penambahbaikan, laporan pepijat, permintaan ciri baru, atau maklum balas umum kepada pentadbir.

13.5.1 Hantar Maklum Balas

1. Pergi ke Feedback dari menu navigasi atau sidebar
2. Klik "New Feedback"
3. Isi borang:

   Jadual 13.5.1: Medan Borang Maklum Balas

   Medan	Keterangan	Wajib?
   Category	General, Improvement, Bug Report, Feature Request	Ya
   Title	Tajuk ringkas	Ya
   Description	Penerangan terperinci	Ya
   Images	Sehingga 3 gambar (JPG/PNG/WebP, maks 5MB). Baru: Tampal (Ctrl+V) atau seret & lepas disokong	Tidak

4. Klik "Submit Feedback"

13.5.2 Lihat & Balas

• Klik pada maklum balas untuk melihat butiran penuh
• Tulis balasan di ruangan "Write a Reply" dan klik "Send Reply"
• Admin akan diberitahu melalui notifikasi, e-mel, dan WhatsApp

13.5.3 Status Maklum Balas

Jadual 13.5.3: Status Maklum Balas

13.5.4 Maklum Balas Awam

Anda juga boleh menghantar maklum balas melalui halaman awam (/) → tab "Feedback". Masukkan 4 digit terakhir IC untuk pengesahan.

The feedback system allows you to submit improvement suggestions, bug reports, feature requests, or general feedback to administrators.

13.5.1 Submit Feedback

1. Go to Feedback from the navigation menu or sidebar
2. Click "New Feedback"
3. Fill in the form:

   Table 13.5.1: Feedback Form Fields

   Field	Description	Required?
   Category	General, Improvement, Bug Report, Feature Request	Yes
   Title	Brief summary	Yes
   Description	Detailed description	Yes
   Images	Up to 3 images (JPG/PNG/WebP, max 5MB each). New: Paste (Ctrl+V) or drag & drop supported	No

4. Click "Submit Feedback"

13.5.2 View & Reply

• Click on a feedback to view full details
• Write a reply in the "Write a Reply" section and click "Send Reply"
• Admin will be notified via notification, email, and WhatsApp

13.5.3 Feedback Status

Table 13.5.3: Feedback Status

13.5.4 Public Feedback

You can also submit feedback from the public page (/) → "Feedback" tab. Enter your IC last 4 digits for verification.

URL: /profile

13.1 Maklumat Yang Boleh Dikemaskini

Jadual 13.1: Medan Profil

13.2 Tukar Kata Laluan

Jadual 13.2: Medan Tukar Kata Laluan

Klik "Update Profile" untuk menyimpan. Biarkan medan kata laluan kosong jika tidak mahu menukar.

URL: /profile

13.1 Editable Fields

Table 13.1: Profile Fields

13.2 Change Password

Table 13.2: Password Change Fields

Click "Update Profile" to save. Leave the password fields empty if you do not wish to change your password.

URL: /notifications

Staff menerima notifikasi melalui e-mel dan/atau WhatsApp bergantung kepada konfigurasi yang ditetapkan oleh Superadmin. Berikut ialah senarai lengkap jenis notifikasi mengikut kategori:

15.1 Jenis Notifikasi

Jadual 15.1: Notifikasi Tempahan Individu

Jadual 15.2: Notifikasi Tempahan Kumpulan

Jadual 15.3: Notifikasi Permintaan Pembelian

Jadual 15.4: Notifikasi Lain

15.2 Urus Notifikasi

• Klik pada notifikasi untuk membacanya
• Klik "Mark as Read" untuk menandakan sebagai dibaca
• Klik "Mark All as Read" untuk menandakan semua sebagai dibaca

URL: /notifications

Staff receive notifications via email and/or WhatsApp depending on the configuration set by the Superadmin. Below is the full list of notification types by category:

15.1 Notification Types

Table 15.1: Individual Booking Notifications

Table 15.2: Group Booking Notifications

Table 15.3: Purchase Request Notifications

Table 15.4: Other Notifications

15.2 Managing Notifications

• Click on a notification to read it
• Click "Mark as Read" to mark as read
• Click "Mark All as Read" to mark all as read

16.1 Eksport Tempahan

Jadual 16.1: Langkah Eksport

Jadual 16.2: Lajur Fail Eksport

16.2 Cetak Butiran

Jadual 16.3: Langkah Cetak

16.1 Export Bookings

Table 16.1: Export Steps

Table 16.2: Export File Columns

16.2 Print Details

Table 16.3: Print Steps

Selain menggunakan sistem melalui log masuk, anda juga boleh mengakses beberapa fungsi melalui halaman awam (/) — tanpa perlu log masuk.

17.1 Halaman Utama

URL: /

Halaman utama memaparkan:

• Logo dan nama aplikasi RD BookHub
• Butang "Sign In" dan "Register here"

Halaman awam mempunyai 3 tab utama:

17.2 Layari Sumber Awam

Fungsi layari sumber di halaman awam serupa dengan halaman /resources selepas log masuk.

Jadual 17.1: Penapis Sumber Awam

Jadual 17.2: Petunjuk Status Penapis

17.3 Tempahan Melalui Halaman Awam

Anda boleh membuat tempahan tanpa log masuk melalui halaman awam.

Jadual 17.3: Langkah Tempahan Awam

Jadual 17.4: Medan Checkout Tempahan Awam

17.4 Kalendar Awam

Kalendar interaktif di halaman awam menunjukkan semua tempahan:

• Navigasi: Anak panah kiri/kanan untuk tukar bulan
• Penapis pengguna: Dropdown "All Users" sebagai lalai
• Info Status: Klik ikon ⓘ (di sebelah kanan bar penapis) untuk melihat panduan maksud setiap status tempahan (Pending, Approved, Rejected, Cancelled, Collected, Returned, Overdue, Completed, Missed)
• Tempahan individu dan kumpulan dipaparkan dengan badge status
• Klik pada tempahan untuk melihat butiran dalam modal

17.5 Kutipan Melalui Halaman Awam

Jadual 17.7: Langkah Kutipan Awam

17.6 Pemulangan Melalui Halaman Awam

Jadual 17.8: Langkah Pemulangan Awam

Jadual 17.9: Keputusan Pemulangan

17.7 Pelanjutan Melalui Halaman Awam

Jadual 17.10: Langkah Pelanjutan Awam

17.8 Pembatalan Melalui Halaman Awam

Jadual 17.11: Langkah Pembatalan Awam

Besides using the system through login, you can also access some functions via the public page (/) — without logging in.

17.1 Welcome Page

URL: /

The welcome page displays:

• Logo and application name RD BookHub
• "Sign In" and "Register here" buttons

The public page has 3 main tabs:

17.2 Public Resource Browse

The public resource browsing functions similarly to the /resources page after login.

Table 17.1: Public Resource Filters

Table 17.2: Filter Status Indicators

17.3 Public Booking

You can create bookings without logging in via the public page.

Table 17.3: Public Booking Steps

Table 17.4: Public Booking Checkout Fields

17.4 Public Calendar

An interactive calendar on the public page displays all bookings:

• Navigation: Left/right arrows to change month
• User filter: Dropdown with "All Users" as default
• Status Info: Click the ⓘ icon (right side of filter bar) to view a guide explaining what each booking status means (Pending, Approved, Rejected, Cancelled, Collected, Returned, Overdue, Completed, Missed)
• Individual and group bookings displayed with status badges
• Click on a booking to view details in a modal

17.5 Public Collection

Table 17.7: Public Collection Steps

17.6 Public Return

Table 17.8: Public Return Steps

Table 17.9: Return Results

17.7 Public Extend

Table 17.10: Public Extend Steps

17.8 Public Cancel

Table 17.11: Public Cancel Steps

Berikut ialah senarai status tempahan yang digunakan dalam sistem RD BookHub.

Jadual 18.1: Senarai Status Tempahan

Below is the list of booking statuses used in the RD BookHub system.

Table 18.1: Booking Status List

Sebagai Admin, anda mempunyai semua keupayaan Staff ditambah dengan kuasa pentadbiran untuk mengurus sistem RD BookHub.

1.1 Keupayaan Tambahan Admin

Jadual 1.1: Fungsi Tambahan Admin

As an Admin, you have all Staff capabilities plus administrative powers to manage the RD BookHub system.

1.1 Additional Admin Capabilities

Table 1.1: Additional Admin Functions

2.1 Log Masuk

Proses log masuk adalah sama seperti yang diterangkan dalam Manual Staff — gunakan IC Last 4 Digits dan Password di halaman /login.

2.2 Dashboard Admin

URL: /dashboard

2.2.1 Kad Statistik (4 KPI)

Jadual 2.1: Kad Statistik Dashboard Admin

2.2.2 Kalendar Tempahan

Kalendar interaktif menunjukkan semua tempahan. Klik pada tempahan untuk melihat butiran.

2.2.3 Jadual Pending Approvals (Top 5)

Menunjukkan 5 tempahan terkini yang menunggu kelulusan:

• Nombor tempahan
• Maklumat pengguna (avatar, nama, e-mel)
• Sumber dan kategori
• Tarikh

Jadual 2.2: Butang Tindakan Pending Approvals

2.2.4 Jadual Recently Processed (Top 8)

Menunjukkan 8 tempahan terkini yang telah diproses (diluluskan/ditolak) dengan status badge.

2.1 Login

The login process is the same as described in the Staff Manual — use your IC Last 4 Digits and Password at the /login page.

2.2 Admin Dashboard

URL: /dashboard

2.2.1 Statistics Cards (4 KPIs)

Table 2.1: Admin Dashboard Statistics Cards

2.2.2 Booking Calendar

An interactive calendar displays all bookings. Click on a booking to view its details.

2.2.3 Pending Approvals Table (Top 5)

Displays the 5 most recent bookings awaiting approval:

• Booking number
• User information (avatar, name, email)
• Resource and category
• Date

Table 2.2: Pending Approvals Action Buttons

2.2.4 Recently Processed Table (Top 8)

Displays the 8 most recently processed bookings (approved/rejected) with status badges.

Admin boleh bertukar antara 2 mod paparan di halaman /bookings.

Jadual 3.1: Mod Paparan Admin

Cara tukar: Klik butang tukar mod di halaman /bookings.

Dalam Personal Mode, anda boleh:

• Buat tempahan sendiri
• Lihat tempahan sendiri
• Kutip sumber
• Pulangkan sumber
• Beri ulasan
• Batalkan tempahan

Admins can switch between 2 view modes on the /bookings page.

Table 3.1: Admin View Modes

How to switch: Click the mode toggle button on the /bookings page.

In Personal Mode, you can:

• Create your own bookings
• View your own bookings
• Collect resources
• Return resources
• Submit reviews
• Cancel bookings

URL: /bookings (dalam Admin Mode)

Komponen: AllBookingsList

4.1 Penapis

Jadual 4.1: Penapis Semua Tempahan

4.2 Jadual

Sama seperti jadual My Bookings dalam Manual Staff, tetapi menunjukkan tempahan semua kakitangan dengan lajur tambahan:

• User — Nama dan e-mel pengguna yang membuat tempahan

4.3 Tindakan

Jadual 4.2: Tindakan Semua Tempahan

4.4 Eksport

Klik "Export" untuk memuat turun senarai tempahan dalam format Excel.

Jadual 4.3: Lajur Fail Eksport

URL: /bookings (in Admin Mode)

Component: AllBookingsList

4.1 Filters

Table 4.1: All Bookings Filters

4.2 Table

Same as the My Bookings table described in the Staff Manual, but displays bookings from all staff members with an additional column:

• User — Name and email of the user who made the booking

4.3 Actions

Table 4.2: All Bookings Actions

4.4 Export

Click "Export" to download the booking list in Excel format.

Table 4.3: Export File Columns

Admin boleh membuat tempahan bagi pihak kakitangan lain.

5.1 Proses

Jadual 5.1: Langkah Tempahan Bagi Pihak Staff

5.2 Perbezaan Dengan Tempahan Staff Biasa

Jadual 5.2: Perbezaan Tempahan Admin vs Staff

Admins can create bookings on behalf of other staff members.

5.1 Process

Table 5.1: Steps to Book on Behalf of Staff

5.2 Differences From Regular Staff Booking

Table 5.2: Admin vs Staff Booking Differences

URL: /approvals

6.1 Luluskan Tempahan (Approve)

Jadual 6.1: Langkah Kelulusan Tempahan

Jadual 6.2: Medan Modal Kelulusan

6.2 Tolak Tempahan (Reject)

Jadual 6.3: Langkah Penolakan Tempahan

Jadual 6.4: Medan Modal Penolakan

6.3 Laluan Kelulusan (Approval Paths)

Jadual 6.5: Laluan Kelulusan

6.4 Padam Tempahan

Admin boleh memadam tempahan dari halaman Approvals melalui butang padam. Pemadaman menggunakan soft delete.

URL: /approvals

6.1 Approve a Booking

Table 6.1: Booking Approval Steps

Table 6.2: Approval Modal Fields

6.2 Reject a Booking

Table 6.3: Booking Rejection Steps

Table 6.4: Rejection Modal Fields

6.3 Approval Paths

Table 6.5: Approval Paths

6.4 Delete Booking

Admins can delete bookings from the Approvals page via the delete button. Deletion uses soft delete.

Proses kutipan dan pemulangan adalah sama seperti yang diterangkan dalam Manual Staff, tetapi Admin boleh melakukannya untuk semua tempahan, bukan hanya tempahan sendiri.

7.1 Kutipan (Collection)

• Boleh mengutip sumber bagi mana-mana kakitangan
• Modal kutipan sama: checkbox sumber, nota keadaan, gambar (wajib)
• Kutipan Kumpulan (Group Collect) — kutip semua sumber sekaligus

7.2 Pemulangan (Return)

• Boleh memulangkan sumber bagi mana-mana kakitangan
• Modal pemulangan dengan status toggle:

Jadual 7.1: Status Toggle Pemulangan

• Select All toggle untuk kumpulan
• Susunan pengesahan: Nota wajib dahulu (jika Missing) kemudian Gambar wajib

7.3 Paparan Gabungan (Merged View)

Dalam Booking Details, jika tempahan kumpulan dikutip dan dipulangkan pada masa yang sama:

• Maklumat kutipan/pemulangan digabungkan dalam satu paparan
• Timestamp dikongsi (tidak diulang)
• Item dikumpulkan mengikut nama sumber
• Gambar dan nota yang sama hanya ditunjukkan sekali (deduplicated)

The collection and return process is the same as described in the Staff Manual, but Admins can perform it for all bookings, not just their own.

7.1 Collection

• Can collect resources on behalf of any staff member
• Same collection modal: resource checkboxes, condition notes, photo (mandatory)
• Group Collect — collect all resources at once

7.2 Return

• Can return resources on behalf of any staff member
• Return modal with status toggle:

Table 7.1: Return Status Toggle

• Select All toggle for group returns
• Validation sequence: Mandatory notes first (if Missing), then mandatory photo

7.3 Merged View

In Booking Details, when a group booking is collected and returned at the same time:

• Collection/return information is merged into a single view
• Timestamps are shared (not duplicated)
• Items are grouped by resource name
• Duplicate photos and notes are shown only once (deduplicated)

Admin boleh membatalkan tempahan sendiri dan melihat tempahan yang telah dibatalkan oleh kakitangan lain.

8.1 Bila Boleh Batal?

• Status tempahan = Pending atau Approved
• Anda ialah pemilik tempahan (tempahan sendiri sahaja)

8.2 Proses Pembatalan

Jadual 8.1: Langkah Pembatalan

8.3 Melihat Tempahan Dibatalkan

Untuk melihat tempahan yang telah dibatalkan oleh mana-mana kakitangan:

• Pergi ke tab All Bookings
• Gunakan penapis Status dan pilih "Cancelled"
• Senarai semua tempahan yang dibatalkan akan dipaparkan

Admins can cancel their own bookings and view bookings that have been cancelled by other staff members.

8.1 When Can You Cancel?

• Booking status = Pending or Approved
• You are the booking owner (own bookings only)

8.2 Cancellation Process

Table 8.1: Cancellation Steps

8.3 Viewing Cancelled Bookings

To view bookings that have been cancelled by any staff member:

• Go to the All Bookings tab
• Use the Status filter and select "Cancelled"
• All cancelled bookings will be listed

Admin boleh melanjutkan tempoh mana-mana tempahan kakitangan. Sistem menyemak ketersediaan sumber secara automatik sebelum melanjutkan.

9.1 Bila Boleh Extend?

• Status = Approved atau Collected (termasuk Overdue)
• Tarikh/masa tamat baru mesti lebih lewat daripada tarikh/masa tamat semasa
• Sumber mesti tersedia untuk tempoh lanjutan

9.2 Proses Pelanjutan (Individu)

Jadual 9.1: Langkah Pelanjutan Tempahan Individu

9.3 Pelanjutan Tempahan Kumpulan

Untuk tempahan kumpulan, anda boleh memilih mana-mana tempahan dalam kumpulan untuk dilanjutkan:

Jadual 9.2: Langkah Pelanjutan Tempahan Kumpulan

Admins can extend the duration of any staff booking. The system automatically checks resource availability before extending.

9.1 When Can You Extend?

• Status = Approved or Collected (including Overdue)
• New end date/time must be later than the current end date/time
• Resource must be available for the extended period

9.2 Individual Extend Process

Table 9.1: Individual Extend Steps

9.3 Group Booking Extension

For group bookings, you can select which bookings within the group to extend:

Table 9.2: Group Extend Steps

URL: /admin/resources/manage

10.1 Paparan

Halaman pengurusan memaparkan:

• 4 kad statistik: Total Resources, Available, Under Maintenance, Categories
• Penapis: Cari nama, tapis kategori
• Grid sumber: Kad untuk setiap sumber

10.2 Cipta Sumber Baru (Create Resource)

URL: /admin/resources/create

Jadual 10.1: Borang Cipta Sumber

Klik "Create Resource" untuk menyimpan.

10.3 Kemaskini Sumber (Edit Resource)

URL: /admin/resources/{id}/edit

Sama seperti borang cipta, tetapi dengan nilai sedia ada. Klik "Update Resource" untuk menyimpan.

10.4 Padam Sumber (Delete Resource)

Jadual 10.2: Langkah Padam Sumber

10.5 Togol Ketersediaan (Toggle Availability)

Klik butang togol pada sumber untuk menukar status ketersediaan antara Available dan Unavailable tanpa perlu edit penuh.

URL: /admin/resources/manage

10.1 Overview

The management page displays:

• 4 statistics cards: Total Resources, Available, Under Maintenance, Categories
• Filters: Search by name, filter by category
• Resource grid: A card for each resource

10.2 Create a New Resource

URL: /admin/resources/create

Table 10.1: Create Resource Form

Click "Create Resource" to save.

10.3 Edit a Resource

URL: /admin/resources/{id}/edit

Same as the create form, but with pre-filled values. Click "Update Resource" to save.

10.4 Delete a Resource

Table 10.2: Delete Resource Steps

10.5 Toggle Availability

Click the toggle button on a resource to switch its availability status between Available and Unavailable without opening the full edit form.

URL: /admin/users

11.1 Paparan

• 4 kad statistik: Superadmins, Admins, Account, Staff
• Jadual pengguna dengan carian dan penapis (role, department)

11.2 Cipta Pengguna (Create User)

URL: /admin/users/create

Jadual 11.1: Borang Cipta Pengguna

11.3 Kemaskini Pengguna (Edit User)

• Kemaskini semua maklumat pengguna
• Tukar peranan
• Tukar jabatan

11.4 Padam Pengguna (Delete User)

• Modal pengesahan sebelum padam
• Tidak boleh padam jika ada tempahan aktif

URL: /admin/users

11.1 Overview

• 4 statistics cards: Superadmins, Admins, Account, Staff
• User table with search and filters (role, department)

11.2 Create a User

URL: /admin/users/create

Table 11.1: Create User Form

11.3 Edit a User

• Update all user information
• Change role
• Change department

11.4 Delete a User

• Confirmation modal before deletion
• Cannot delete if the user has active bookings

URL: /admin/categories

12.1 Cipta Kategori

Jadual 12.1: Borang Cipta Kategori

12.2 Kemaskini Kategori

Tukar nama, label, warna lencana, dan status aktif kategori sedia ada.

12.3 Padam Kategori

URL: /admin/categories

12.1 Create a Category

Table 12.1: Create Category Form

12.2 Edit a Category

Change the name, label, badge color, and active status of an existing category.

12.3 Delete a Category

URL: /admin/departments

13.1 Operasi

Jadual 13.1: Operasi Pengurusan Jabatan

URL: /admin/departments

13.1 Operations

Table 13.1: Department Management Operations

URL: /collection-return

14.1 Paparan

• Penapis: Cari mengikut nombor tempahan, nama pengguna, atau nama sumber
• Tapis status: All, Collected Only, Returned Only

14.2 Jadual Rekod

Jadual 14.1: Lajur Jadual Kutipan & Pemulangan

URL: /collection-return

14.1 Overview

• Filters: Search by booking number, user name, or resource name
• Status filter: All, Collected Only, Returned Only

14.2 Records Table

Table 14.1: Collection & Return Table Columns

URL: /admin/reviews

15.1 Paparan

Jadual 15.1: Kad Statistik Ulasan

Penapis: Tapis mengikut penilaian, sumber, atau cari teks komen.

15.2 Operasi

Jadual 15.2: Operasi Pengurusan Ulasan

URL: /admin/reviews

15.1 Overview

Table 15.1: Review Statistics Cards

Filters: Filter by rating, resource, or search comment text.

15.2 Operations

Table 15.2: Review Management Operations

Admin bertanggungjawab menyemak, meluluskan atau menolak permohonan pembelian yang dihantar oleh Staff. Dalam mod peribadi, Admin juga boleh menghantar permohonan sendiri.

16.1 Senarai Permohonan (Mod Admin)

URL: /purchase-requests

Dalam mod admin, halaman ini memaparkan semua permohonan daripada semua Staff.

Jadual 16.1: Lajur Senarai Permohonan

Jadual 16.2: Penapis Senarai

16.2 Semak & Lulus / Tolak Permohonan

Klik pada permohonan untuk melihat butiran penuh. Untuk permohonan dengan status Submitted, Admin boleh:

Jadual 16.3: Tindakan Semakan

16.3 Kemaskini Status Permohonan

Selepas diluluskan, Admin boleh mengemaskini status permohonan melalui butang "Update Status":

Jadual 16.4: Aliran Status

16.4 Butiran Permohonan

URL: /purchase-requests/{id}

Halaman butiran memaparkan maklumat lengkap termasuk:

• Maklumat item (nama, jenama, harga, kuantiti, kategori)
• Keutamaan dan justifikasi
• Pautan produk dan lampiran gambar
• Maklumat penghantar dan tarikh
• Maklumat penyemak, tarikh semakan, dan komen Admin
• Butang tindakan (Approve / Reject / Update Status) mengikut status semasa

16.5 Padam Permohonan

Admin boleh memadam permohonan pembelian melalui butang padam di senarai permohonan. Pemadaman menggunakan soft delete — data tidak dipadam secara kekal.

16.5a Ubah Suai Oleh Pemohon (Baru)

Staff kini boleh mengubah suai permohonan pembelian mereka sendiri — tetapi hanya ketika status masih Submitted. Setelah anda (Admin) atau Account mula semak, butang Edit akan hilang secara automatik.

• Admin & Account akan menerima notifikasi apabila permohonan diubah suai
• Halaman butiran akan menunjukkan metadata ubah suai: bilangan kali (edit_count), tarikh terakhir (edited_at), dan siapa yang mengubah (edited_by)
• Semak maklumat terkini sebelum memberi keputusan Approve/Reject bagi permohonan yang telah diubah suai

16.6 Mod Peribadi

Dalam mod peribadi, Admin bertindak seperti Staff biasa:

• Melihat hanya permohonan sendiri
• Boleh mencipta permohonan baru di /purchase-requests/create
• Borang dan medan sama seperti yang diterangkan dalam Manual Staff

Admins are responsible for reviewing, approving, or rejecting purchase requests submitted by Staff. In personal mode, Admins can also submit their own requests.

16.1 Request List (Admin Mode)

URL: /purchase-requests

In admin mode, this page displays all purchase requests from all Staff.

Table 16.1: Request List Columns

Table 16.2: List Filters

16.2 Review & Approve / Reject Requests

Click on a request to view full details. For requests with status Submitted, Admin can:

Table 16.3: Review Actions

16.3 Update Request Status

After approval, Admin can update the request status via the "Update Status" button:

Table 16.4: Status Flow

16.4 Request Details

URL: /purchase-requests/{id}

The details page displays complete information including:

• Item information (name, brand, price, quantity, category)
• Priority and justification
• Product URL and image attachments
• Requester information and date
• Reviewer information, review date, and Admin comments
• Action buttons (Approve / Reject / Update Status) based on current status

16.5 Delete Request

Admins can delete purchase requests via the delete button on the request list. Deletion uses soft delete — data is not permanently removed.

16.5a Edits by the Requester (New)

Staff can now edit their own purchase requests — but only while the status is still Submitted. Once you (Admin) or Account begin reviewing, the Edit button disappears automatically.

• Admin & Account receive a notification whenever a request is edited
• The details page shows edit metadata: number of edits (edit_count), last edit timestamp (edited_at), and who edited it (edited_by)
• Always re-check the latest values before deciding Approve/Reject on an edited request

16.6 Personal Mode

In personal mode, Admin functions like a regular Staff member:

• Sees only their own requests
• Can create new requests at /purchase-requests/create
• Form and fields are the same as described in the Staff Manual

17.1 Profil

Proses kemaskini profil adalah sama seperti yang diterangkan dalam Manual Staff — kemaskini maklumat peribadi di /profile.

17.2 Notifikasi

URL: /notifications

Admin menerima notifikasi melalui e-mel dan/atau WhatsApp bergantung kepada konfigurasi yang ditetapkan oleh Superadmin. Berikut ialah senarai lengkap jenis notifikasi mengikut kategori:

Jadual 17.1: Notifikasi Tempahan Individu

Jadual 17.2: Notifikasi Tempahan Kumpulan

Jadual 17.3: Notifikasi Permintaan Pembelian

Jadual 17.4: Notifikasi Lain

17.1 Profile

The profile update process is the same as described in the Staff Manual — update personal information at /profile.

17.2 Notifications

URL: /notifications

Admins receive notifications via email and/or WhatsApp depending on the configuration set by the Superadmin. Below is the full list of notification types by category:

Table 17.1: Individual Booking Notifications

Table 17.2: Group Booking Notifications

Table 17.3: Purchase Request Notifications

Table 17.4: Other Notifications

Selain menggunakan sistem melalui log masuk, pengguna juga boleh mengakses beberapa fungsi melalui halaman awam (/) — tanpa perlu log masuk.

18.1 Halaman Utama

URL: /

Halaman utama memaparkan:

• Logo dan nama aplikasi RD BookHub
• Butang "Sign In" dan "Register here"

Halaman awam mempunyai 3 tab utama:

18.2 Layari Sumber Awam

Fungsi layari sumber di halaman awam serupa dengan halaman /resources selepas log masuk.

Jadual 18.1: Penapis Sumber Awam

Jadual 18.2: Petunjuk Status Penapis

18.3 Tempahan Melalui Halaman Awam

Pengguna boleh membuat tempahan tanpa log masuk melalui halaman awam.

Jadual 18.3: Langkah Tempahan Awam

Jadual 18.4: Medan Checkout Tempahan Awam

18.4 Kalendar Awam

Kalendar interaktif di halaman awam menunjukkan semua tempahan:

• Navigasi: Anak panah kiri/kanan untuk tukar bulan
• Penapis pengguna: Dropdown "All Users" sebagai lalai
• Info Status: Klik ikon ⓘ (di sebelah kanan bar penapis) untuk melihat panduan maksud setiap status tempahan (Pending, Approved, Rejected, Cancelled, Collected, Returned, Overdue, Completed, Missed)
• Tempahan individu dan kumpulan dipaparkan dengan badge status
• Klik pada tempahan untuk melihat butiran dalam modal

18.5 Kutipan Melalui Halaman Awam

Jadual 18.5: Langkah Kutipan Awam

18.6 Pemulangan Melalui Halaman Awam

Jadual 18.6: Langkah Pemulangan Awam

Jadual 18.7: Keputusan Pemulangan

18.7 Pelanjutan Melalui Halaman Awam

Jadual 18.8: Langkah Pelanjutan Awam