Membuat Transaksi Peminjaman Buku dengan CodeIgniter 4 pada Aplikasi SIPUS

By | November 20, 2026
SIPUS Transaksi

MWI – Halo sobat pembelajar web MuSa, yuk kita lanjutkan kembali pembahasan tentang Aplikasi SIPUS, kali ini kita akan membahas tentang Transaksi.

Pendahuluan

Transaksi peminjaman buku merupakan salah satu fitur utama dalam aplikasi Sistem Informasi Perpustakaan Sekolah (SIPUS). Setelah menyelesaikan fitur Authentication, CRUD Kategori, CRUD Buku, dan CRUD Anggota, sekarang kita akan menghubungkan seluruh data tersebut melalui proses peminjaman.

Pada tutorial ini, kita akan membuat transaksi peminjaman buku dengan CodeIgniter 4 dan Bootstrap 5. Petugas dapat memilih anggota, menentukan beberapa judul buku, memasukkan jumlah buku yang dipinjam, kemudian menyimpan transaksi.

Namun, proses peminjaman tidak hanya menyimpan data ke database. Sistem juga harus melakukan beberapa pemeriksaan sebelum transaksi berhasil.

Berikut aturan bisnis yang akan kita terapkan:

  1. Anggota harus memiliki status active.
  2. Satu transaksi maksimal berisi 5 judul buku.
  3. Jumlah buku yang dipinjam minimal 1 eksemplar.
  4. Stok buku harus mencukupi jumlah peminjaman.
  5. Lama peminjaman adalah 7 hari.
  6. Sistem mencatat petugas yang melayani transaksi.
  7. Setelah transaksi berhasil, stok tersedia otomatis berkurang.
  8. Jika salah satu proses gagal, seluruh perubahan database harus dibatalkan.

Dengan demikian, data peminjaman dan stok buku akan tetap konsisten.

1. Memahami Alur Transaksi Peminjaman

Sebelum menulis kode, kita perlu memahami urutan proses yang akan kita lakukan aplikasi SIPUS.

1.1. Alur bisnis peminjaman

Proses peminjaman kita mulai ketika petugas membuka menu Peminjaman dan memilih anggota yang akan meminjam buku.

Selanjutnya, petugas memilih buku yang tersedia dan memasukkan jumlah eksemplar yang kita pinjam.

Sebelum menyimpan transaksi, sistem melakukan pemeriksaan terhadap data anggota dan stok buku.

Urutan prosesnya adalah:

  1. Petugas membuka halaman transaksi peminjaman.
  2. Sistem menampilkan daftar anggota aktif.
  3. Petugas memilih anggota.
  4. Petugas memilih maksimal 5 judul buku.
  5. Petugas memasukkan jumlah setiap buku.
  6. Sistem memeriksa kembali status anggota.
  7. Sistem memeriksa ketersediaan stok setiap buku.
  8. Sistem membuat data utama peminjaman.
  9. Sistem menyimpan detail buku yang kita pinjam.
  10. Sistem mengurangi stok tersedia.
  11. Sistem menyelesaikan transaksi database.

Jika seluruh proses berhasil, aplikasi menampilkan pesan bahwa peminjaman berhasil tersimpan.

1.2. Contoh transaksi peminjaman

Misalnya, anggota bernama Andi meminjam dua judul buku.

BukuStok awalJumlah dipinjam
Pemrograman PHP102
Basis Data51

Setelah transaksi berhasil, stok tersedia berubah menjadi:

BukuStok awalDipinjamStok akhir
Pemrograman PHP1028
Basis Data514

Sistem juga mencatat tanggal peminjaman dan tanggal jatuh tempo.

Jika peminjaman yang kita lakukan pada tanggal 20 November 2026, maka tanggal jatuh tempo adalah 27 November 2026.

1.3. Mengapa menggunakan database transaction?

Dalam satu proses peminjaman, aplikasi melakukan beberapa perubahan database sekaligus.

Misalnya:

  • Menyimpan data ke tabel loans.
  • Menyimpan beberapa baris ke tabel loan_details.
  • Mengurangi stok pada tabel books.

Bagaimana jika data transaksi berhasil tersimpan, tetapi proses pengurangan stok gagal?

Jika tidak menggunakan database transaction, database bisa menyimpan data yang tidak konsisten.

Oleh karena itu, kita menggunakan fitur database transaction dari CodeIgniter 4:

$db->transBegin();

// Proses database

$db->transCommit();

Jika terjadi kesalahan, kita membatalkan seluruh perubahan:

$db->transRollback();

Dengan demikian, seluruh proses peminjaman kita perlakukan sebagai satu kesatuan.

2. Menyiapkan Struktur Tabel Peminjaman

Transaksi peminjaman menggunakan dua tabel utama:

  • loans: menyimpan informasi utama transaksi.
  • loan_details: menyimpan daftar buku yang kita pinjam.

Kedua tabel tersebut terhubung dengan tabel members, users, dan books yang sudah dibuat pada tahap sebelumnya.

2.1. Struktur tabel loans

Tabel loans menyimpan informasi umum transaksi peminjaman.

FieldTipe dataKeterangan
idINTPrimary key
loan_codeVARCHAR(30)Kode transaksi
member_idINTID anggota
user_idINTID petugas
loan_dateDATETanggal peminjaman
due_dateDATETanggal jatuh tempo
statusVARCHAR(20)Status transaksi
created_atDATETIMEWaktu pembuatan
updated_atDATETIMEWaktu perubahan

Untuk tahap peminjaman, status awal transaksi menggunakan nilai active.

Status partial dan completed akan digunakan ketika kita membangun fitur pengembalian pada artikel berikutnya.

2.2. Struktur tabel loan_details

Tabel loan_details menyimpan daftar buku yang dipinjam dalam satu transaksi.

FieldTipe dataKeterangan
idINTPrimary key
loan_idINTRelasi ke tabel loans
book_idINTRelasi ke tabel books
quantityINTJumlah buku dipinjam
created_atDATETIMEWaktu pembuatan
updated_atDATETIMEWaktu perubahan

Mengapa perlu tabel detail?

Karena satu transaksi dapat berisi beberapa judul buku. Jika seluruh data buku disimpan langsung pada tabel loans, struktur database akan menjadi tidak fleksibel.

Dengan tabel detail, satu transaksi dapat memiliki beberapa baris buku.

Contohnya:

Tabel loans

idloan_codemember_idstatus
1PJM-20261120-1235active

Tabel loan_details

idloan_idbook_idquantity
1122
2141

Artinya, transaksi nomor 1 berisi dua judul buku.

2.3. Relasi tabel

Gambaran relasi tabel peminjaman:

members
   |
   | 1 : N
   |
 loans -------- users
   |
   | 1 : N
   |
loan_details
   |
   | N : 1
   |
 books

Relasi tersebut menjelaskan bahwa:

  • Satu anggota dapat memiliki banyak transaksi peminjaman.
  • Satu petugas dapat melayani banyak transaksi.
  • Satu transaksi dapat memiliki banyak detail buku.
  • Satu buku dapat muncul dalam banyak detail peminjaman.

3. Membuat Migration Tabel Loans

Kita mulai dengan membuat migration untuk tabel loans.

Buka terminal pada folder utama proyek SIPUS, kemudian jalankan:

php spark make:migration CreateLoansTable

CodeIgniter akan membuat file migration di folder:

app/Database/Migrations/

Buka file tersebut, kemudian sesuaikan method up() menjadi:

public function up()
{
    $this->forge->addField([
        'id' => [
            'type'           => 'INT',
            'unsigned'       => true,
            'auto_increment' => true,
        ],
        'loan_code' => [
            'type'       => 'VARCHAR',
            'constraint' => 30,
        ],
        'member_id' => [
            'type'     => 'INT',
            'unsigned' => true,
        ],
        'user_id' => [
            'type'     => 'INT',
            'unsigned' => true,
        ],
        'loan_date' => [
            'type' => 'DATE',
        ],
        'due_date' => [
            'type' => 'DATE',
        ],
        'status' => [
            'type'       => 'VARCHAR',
            'constraint' => 20,
            'default'    => 'active',
        ],
        'created_at' => [
            'type' => 'DATETIME',
            'null' => true,
        ],
        'updated_at' => [
            'type' => 'DATETIME',
            'null' => true,
        ],
    ]);

    $this->forge->addKey('id', true);
    $this->forge->addUniqueKey('loan_code');
    $this->forge->addKey('member_id');
    $this->forge->addKey('user_id');
    $this->forge->addKey('status');

    $this->forge->createTable(
        'loans',
        true,
        ['ENGINE' => 'InnoDB']
    );
}

Kemudian isi method down():

public function down()
{
    $this->forge->dropTable('loans', true);
}

Penjelasan beberapa bagian penting:

  • id menjadi primary key.
  • loan_code memiliki unique index agar kode transaksi tidak boleh sama.
  • member_id menyimpan ID anggota.
  • user_id menyimpan ID petugas yang melayani.
  • loan_date menyimpan tanggal peminjaman.
  • due_date menyimpan tanggal jatuh tempo.
  • status menyimpan kondisi transaksi.

Kita menggunakan InnoDB karena proses peminjaman membutuhkan dukungan database transaction.

4. Membuat Migration Tabel Loan Details

Selanjutnya, buat migration kedua:

php spark make:migration CreateLoanDetailsTable

Buka file migration yang dibuat, kemudian isi method up():

public function up()
{
    $this->forge->addField([
        'id' => [
            'type'           => 'INT',
            'unsigned'       => true,
            'auto_increment' => true,
        ],
        'loan_id' => [
            'type'     => 'INT',
            'unsigned' => true,
        ],
        'book_id' => [
            'type'     => 'INT',
            'unsigned' => true,
        ],
        'quantity' => [
            'type'     => 'INT',
            'unsigned' => true,
        ],
        'created_at' => [
            'type' => 'DATETIME',
            'null' => true,
        ],
        'updated_at' => [
            'type' => 'DATETIME',
            'null' => true,
        ],
    ]);

    $this->forge->addKey('id', true);
    $this->forge->addKey('loan_id');
    $this->forge->addKey('book_id');

    $this->forge->addUniqueKey([
        'loan_id',
        'book_id',
    ]);

    $this->forge->createTable(
        'loan_details',
        true,
        ['ENGINE' => 'InnoDB']
    );
}

Isi method down():

public function down()
{
    $this->forge->dropTable('loan_details', true);
}

Kita menggunakan unique key gabungan loan_id dan book_id.

Tujuannya adalah mencegah satu judul buku tersimpan dua kali dalam transaksi yang sama.

Jika anggota meminjam tiga eksemplar buku yang sama, sistem menyimpannya dalam satu baris dengan quantity bernilai 3.

Catatan relasi database: kedua migration di atas membuat primary key dan indeks. Untuk menjaga integritas referensial, proyek dapat menambahkan foreign key ke members, users, books, dan loans. Pastikan tabel induk sudah tersedia, tipe kolomnya sama, serta urutan penghapusan migration memperhatikan ketergantungan tabel. Jangan menghapus tabel induk ketika masih memiliki data transaksi yang merujuk kepadanya.

5. Menjalankan Migration

Setelah kedua migration selesai kita buat, jalankan:

php spark migrate

Jika migration berhasil, periksa database melalui phpMyAdmin.

Pastikan tabel berikut sudah tersedia:

loans
loan_details

Jika sebelumnya tabel tersebut sudah kita buat, jangan membuat ulang tabel dengan nama yang sama. Periksa migration yang sudah ada dan sesuaikan kode dengan struktur aktual.

6. Membuat Model Transaksi

Selanjutnya, kita membuat dua model untuk mengelola data peminjaman.

Jalankan perintah:

php spark make:model LoanModel
php spark make:model LoanDetailModel

6.1. Membuat LoanModel

Buka file:

app/Models/LoanModel.php

Kemudian isi:

<?php

namespace App\Models;

use CodeIgniter\Model;

class LoanModel extends Model
{
    protected $table            = 'loans';
    protected $primaryKey       = 'id';
    protected $useAutoIncrement = true;
    protected $returnType       = 'array';

    protected $allowedFields = [
        'loan_code',
        'member_id',
        'user_id',
        'loan_date',
        'due_date',
        'status',
    ];

    protected $useTimestamps = true;
    protected $dateFormat    = 'datetime';
}

Model ini kita gunakan untuk mengelola data utama peminjaman.

Properti $table menentukan tabel yang digunakan. Sementara itu, $allowedFields menentukan kolom yang boleh diisi melalui operasi model.

Kita juga mengaktifkan $useTimestamps karena tabel loans memiliki kolom created_at dan updated_at.

6.2. Membuat LoanDetailModel

Buka file:

app/Models/LoanDetailModel.php

Kemudian isi:

<?php

namespace App\Models;

use CodeIgniter\Model;

class LoanDetailModel extends Model
{
    protected $table            = 'loan_details';
    protected $primaryKey       = 'id';
    protected $useAutoIncrement = true;
    protected $returnType       = 'array';

    protected $allowedFields = [
        'loan_id',
        'book_id',
        'quantity',
    ];

    protected $useTimestamps = true;
    protected $dateFormat    = 'datetime';
}

Model ini kita gunakan untuk menyimpan detail buku pada setiap transaksi peminjaman.

Dengan memisahkan kedua model, pengelolaan data utama transaksi dan detail buku menjadi lebih terstruktur.

7. Membuat Controller Loans

Sekarang kita membuat controller untuk mengelola proses peminjaman.

Jalankan:

php spark make:controller Loans

Buka file:

app/Controllers/Loans.php

Tambahkan import model berikut:

use App\Models\LoanModel;
use App\Models\LoanDetailModel;
use App\Models\BookModel;
use App\Models\MemberModel;

Controller Loans akan memiliki tiga method utama:

  • index(): menampilkan daftar peminjaman.
  • new(): menampilkan form peminjaman.
  • create(): memproses dan menyimpan transaksi.

7.1. Membuat halaman daftar peminjaman

Tambahkan method index():

public function index()
{
    $db = db_connect();

    $loans = $db->table('loans l')
        ->select(
            'l.*, members.member_code, members.name,
             users.username'
        )
        ->join('members', 'members.id = l.member_id')
        ->join('users', 'users.id = l.user_id')
        ->orderBy('l.id', 'DESC')
        ->get()
        ->getResultArray();

    return view('loans/index', [
        'loans' => $loans,
    ]);
}

Method tersebut mengambil data transaksi dari tabel loans.

Kita menggunakan JOIN untuk menampilkan kode anggota, nama anggota, dan nama pengguna petugas.

Dengan demikian, halaman daftar transaksi tidak hanya menampilkan ID anggota dan ID petugas.

Penyesuaian: contoh di atas menggunakan kolom users.username. Jika tabel users pada proyek SIPUS menggunakan nama kolom berbeda, ganti username dengan kolom yang benar. Pastikan pula primary key tabel users memang id.

7.2. Membuat halaman form peminjaman

Tambahkan method new():

public function new()
{
    $memberModel = new MemberModel();
    $bookModel   = new BookModel();

    $members = $memberModel
        ->where('status', 'active')
        ->orderBy('name', 'ASC')
        ->findAll();

    $books = $bookModel
        ->where('is_active', 1)
        ->where('stock_available >', 0)
        ->orderBy('title', 'ASC')
        ->findAll();

    return view('loans/create', [
        'members' => $members,
        'books'   => $books,
        'errors'  => session()->getFlashdata('errors') ?? [],
    ]);
}

Method ini mengambil data anggota aktif dan buku yang masih memiliki stok.

Mengapa kita menggunakan kondisi status = active?

Karena anggota yang tidak aktif tidak boleh melakukan peminjaman.

Sementara itu, kondisi stock_available > 0 memastikan daftar buku yang ditampilkan hanya berisi buku dengan stok tersedia.

Meskipun demikian, pemeriksaan tersebut hanya untuk membantu tampilan. Controller tetap harus melakukan validasi ulang ketika petugas menyimpan transaksi.

7.3. Membuat proses penyimpanan peminjaman

Bagian ini merupakan inti dari modul transaksi.

Tambahkan method create():

public function create()
{
    $memberId = (int) $this->request->getPost('member_id');

    $bookIds = $this->request->getPost('book_id') ?? [];
    $quantities = $this->request->getPost('quantity') ?? [];

    // Validasi anggota.
    if ($memberId < 1) {
        return redirect()->back()
            ->withInput()
            ->with('error', 'Anggota harus dipilih.');
    }

    // Validasi format data buku.
    if (! is_array($bookIds) || ! is_array($quantities)) {
        return redirect()->back()
            ->withInput()
            ->with('error', 'Data buku tidak valid.');
    }

    // Validasi jumlah judul buku.
    if (count($bookIds) < 1 || count($bookIds) > 5) {
        return redirect()->back()
            ->withInput()
            ->with('error', 'Pilih minimal 1 dan maksimal 5 judul buku.');
    }

    if (count($bookIds) !== count($quantities)) {
        return redirect()->back()
            ->withInput()
            ->with('error', 'Data jumlah buku tidak sesuai.');
    }

    // Pastikan ID buku tidak duplikat.
    $normalizedIds = [];

    foreach ($bookIds as $bookId) {
        $id = filter_var($bookId, FILTER_VALIDATE_INT);

        if ($id === false || $id < 1) {
            return redirect()->back()
                ->withInput()
                ->with('error', 'ID buku tidak valid.');
        }

        $normalizedIds[] = $id;
    }

    if (count($normalizedIds) !== count(array_unique($normalizedIds))) {
        return redirect()->back()
            ->withInput()
            ->with('error', 'Judul buku tidak boleh dipilih dua kali.');
    }

    // Siapkan detail buku.
    $items = [];

    foreach ($bookIds as $index => $bookId) {
        $quantity = filter_var(
            $quantities[$index] ?? null,
            FILTER_VALIDATE_INT
        );

        if ($quantity === false || $quantity < 1) {
            return redirect()->back()
                ->withInput()
                ->with('error', 'Jumlah buku minimal 1.');
        }

        $items[] = [
            'book_id' => (int) $bookId,
            'quantity' => $quantity,
        ];
    }

    $db = db_connect();

    $db->transBegin();

    try {
        // Periksa anggota langsung dari database.
        $member = $db->query(
            'SELECT * FROM members WHERE id = ? FOR UPDATE',
            [$memberId]
        )->getRowArray();

        if (! $member) {
            throw new \RuntimeException(
                'Anggota tidak ditemukan.'
            );
        }

        if ($member['status'] !== 'active') {
            throw new \RuntimeException(
                'Anggota tidak aktif dan tidak dapat meminjam buku.'
            );
        }

        // Siapkan tanggal peminjaman.
        $loanDate = date('Y-m-d');

        $dueDate = date(
            'Y-m-d',
            strtotime($loanDate . ' +7 days')
        );

        // Buat kode transaksi.
        $loanCode = 'PJM-' . date('YmdHis')
            . '-' . random_int(100, 999);

        // Ambil ID petugas dari session login.
        $userId = (int) session()->get('user_id');

        if ($userId < 1) {
            throw new \RuntimeException(
                'Sesi petugas tidak ditemukan. Silakan login kembali.'
            );
        }

        // Simpan data utama peminjaman.
        $loanModel = new LoanModel();

        $loanId = $loanModel->insert([
            'loan_code' => $loanCode,
            'member_id' => $memberId,
            'user_id'   => $userId,
            'loan_date' => $loanDate,
            'due_date'  => $dueDate,
            'status'    => 'active',
        ]);

        if ($loanId === false) {
            throw new \RuntimeException(
                'Gagal menyimpan transaksi peminjaman.'
            );
        }

        // Simpan detail dan kurangi stok setiap buku.
        $detailModel = new LoanDetailModel();

        foreach ($items as $item) {

            // Kunci baris buku selama transaksi berlangsung.
            $book = $db->query(
                'SELECT * FROM books WHERE id = ? FOR UPDATE',
                [$item['book_id']]
            )->getRowArray();

            if (! $book) {
                throw new \RuntimeException(
                    'Salah satu buku tidak ditemukan.'
                );
            }

            if ((int) $book['is_active'] !== 1) {
                throw new \RuntimeException(
                    'Buku ' . $book['title'] . ' tidak aktif.'
                );
            }

            if (
                (int) $book['stock_available'] <
                $item['quantity']
            ) {
                throw new \RuntimeException(
                    'Stok buku ' . $book['title'] . ' tidak mencukupi.'
                );
            }

            // Simpan detail peminjaman.
            $detailId = $detailModel->insert([
                'loan_id'  => $loanId,
                'book_id'  => $book['id'],
                'quantity' => $item['quantity'],
            ]);

            if ($detailId === false) {
                throw new \RuntimeException(
                    'Gagal menyimpan detail peminjaman.'
                );
            }

            // Kurangi stok tersedia.
            $updated = $db->table('books')
                ->where('id', $book['id'])
                ->update([
                    'stock_available' =>
                        (int) $book['stock_available']
                        - $item['quantity'],
                ]);

            if ($updated === false) {
                throw new \RuntimeException(
                    'Gagal memperbarui stok buku.'
                );
            }
        }

        // Periksa status transaksi database.
        if ($db->transStatus() === false) {
            throw new \RuntimeException(
                'Proses transaksi database gagal.'
            );
        }

        // Simpan seluruh perubahan.
        $db->transCommit();

        return redirect()->to(site_url('loans'))
            ->with(
                'success',
                'Transaksi peminjaman berhasil disimpan.'
            );

    } catch (\Throwable $e) {

        // Batalkan seluruh perubahan jika terjadi kesalahan.
        $db->transRollback();

        return redirect()->back()
            ->withInput()
            ->with(
                'error',
                $e->getMessage()
            );
    }
}

Mari kita pahami bagian terpenting dari kode tersebut.

A. Validasi jumlah judul buku

if (count($bookIds) < 1 || count($bookIds) > 5) {
    return redirect()->back()
        ->withInput()
        ->with('error', 'Pilih minimal 1 dan maksimal 5 judul buku.');
}

Bagian ini membatasi satu transaksi maksimal lima judul buku.

Pembatasan kita lakukan di controller karena data dari browser dapat dimodifikasi oleh pengguna.

B. Memeriksa status anggota

$member = $db->query(
    'SELECT * FROM members WHERE id = ? FOR UPDATE',
    [$memberId]
)->getRowArray();

if (! $member || $member['status'] !== 'active') {
    throw new \RuntimeException(
        'Anggota tidak ditemukan atau tidak aktif.'
    );
}

Sistem memeriksa kembali status anggota langsung dari database.

Dengan demikian, anggota yang sebelumnya aktif tetapi kemudian kita nonaktifkan tidak dapat melanjutkan peminjaman.

C. Menghitung tanggal jatuh tempo

$loanDate = date('Y-m-d');

$dueDate = date(
    'Y-m-d',
    strtotime($loanDate . ' +7 days')
);

Tanggal jatuh tempo terhitung otomatis tujuh hari setelah tanggal peminjaman.

Petugas tidak perlu memasukkan tanggal jatuh tempo secara manual.

D. Memeriksa stok buku

if (
    (int) $book['stock_available'] <
    $item['quantity']
) {
    throw new \RuntimeException(
        'Stok buku tidak mencukupi.'
    );
}

Sistem membandingkan stok tersedia dengan jumlah yang akan kita pinjam.

Jika stok tidak mencukupi, sistem menolak transaksi.

Kita juga menggunakan FOR UPDATE untuk mengunci baris buku selama proses transaksi database berlangsung. Cara ini membantu mencegah dua proses peminjaman menggunakan stok yang sama secara bersamaan.

E. Mengurangi stok otomatis

$updated = $db->table('books')
    ->where('id', $book['id'])
    ->update([
        'stock_available' =>
            (int) $book['stock_available'] - $item['quantity'],
    ]);

Setelah detail buku berhasil tersimpan, sistem mengurangi stok tersedia.

Contohnya, stok tersedia sebanyak 10 dan anggota meminjam 2 eksemplar. Setelah proses berhasil, stok tersedia menjadi 8.

F. Menggunakan commit dan rollback

Jika seluruh proses berhasil, sistem menjalankan:

$db->transCommit();

Namun, jika terjadi kesalahan, sistem menjalankan:

$db->transRollback();

Dengan demikian, data transaksi, detail buku, dan perubahan stok tidak akan tersimpan sebagian.

Catatan penting: contoh controller menggunakan session()->get('user_id') sebagai ID petugas. Sesuaikan dengan nama key session yang benar-benar kita gunakan pada fitur Authentication SIPUS. Jangan mengambil ID petugas dari input form karena identitas petugas harus berasal dari sesi login.

Selain itu, pesan exception tersebut kita buat untuk kebutuhan pembelajaran. Pada aplikasi produksi, catat detail kesalahan ke log dan tampilkan pesan yang aman kepada pengguna.

8. Membuat View Daftar Peminjaman

Selanjutnya, kita membuat halaman untuk menampilkan seluruh transaksi peminjaman.

Buat folder:

app/Views/loans/

Kemudian buat file:

app/Views/loans/index.php

Isi dengan kode berikut:

<?= $this->extend('layouts/main') ?>

<?= $this->section('content') ?>

<div class="container-fluid">

    <div class="d-flex justify-content-between
                align-items-center mb-4">

        <h4>Transaksi Peminjaman</h4>

        <a href="<?= site_url('loans/new') ?>"
           class="btn btn-primary">

            Tambah Peminjaman

        </a>

    </div>

    <?php if (session()->getFlashdata('success')): ?>

        <div class="alert alert-success">
            <?= esc(session()->getFlashdata('success')) ?>
        </div>

    <?php endif; ?>

    <?php if (session()->getFlashdata('error')): ?>

        <div class="alert alert-danger">
            <?= esc(session()->getFlashdata('error')) ?>
        </div>

    <?php endif; ?>

    <div class="card">

        <div class="card-body table-responsive">

            <table class="table table-bordered table-striped">

                <thead>
                    <tr>
                        <th>No.</th>
                        <th>Kode Transaksi</th>
                        <th>Anggota</th>
                        <th>Petugas</th>
                        <th>Tanggal Pinjam</th>
                        <th>Jatuh Tempo</th>
                        <th>Status</th>
                    </tr>
                </thead>

                <tbody>

                    <?php if (empty($loans)): ?>

                        <tr>
                            <td colspan="7" class="text-center">
                                Belum ada transaksi peminjaman.
                            </td>
                        </tr>

                    <?php else: ?>

                        <?php foreach ($loans as $index => $loan): ?>

                            <tr>

                                <td><?= $index + 1 ?></td>

                                <td>
                                    <?= esc($loan['loan_code']) ?>
                                </td>

                                <td>
                                    <?= esc($loan['member_code']) ?>
                                    -
                                    <?= esc($loan['name']) ?>
                                </td>

                                <td>
                                    <?= esc($loan['username']) ?>
                                </td>

                                <td>
                                    <?= esc($loan['loan_date']) ?>
                                </td>

                                <td>
                                    <?= esc($loan['due_date']) ?>
                                </td>

                                <td>
                                    <span class="badge bg-primary">
                                        <?= esc(ucfirst($loan['status'])) ?>
                                    </span>
                                </td>

                            </tr>

                        <?php endforeach; ?>

                    <?php endif; ?>

                </tbody>

            </table>

        </div>

    </div>

</div>

<?= $this->endSection() ?>

Halaman tersebut menggunakan layout utama SIPUS melalui:

<?= $this->extend('layouts/main') ?>

Dengan demikian, navbar dan sidebar yang sudah tersedia sebelumnya tetap kita gunakan.

9. Membuat View Form Peminjaman

Sekarang kita membuat form untuk memasukkan data peminjaman.

Buat file:

app/Views/loans/create.php

Isi dengan kode berikut:

<?= $this->extend('layouts/main') ?>

<?= $this->section('content') ?>

<div class="container-fluid">

    <h4 class="mb-4">Form Peminjaman Buku</h4>

    <?php if (session()->getFlashdata('error')): ?>

        <div class="alert alert-danger">
            <?= esc(session()->getFlashdata('error')) ?>
        </div>

    <?php endif; ?>

    <form action="<?= site_url('loans/create') ?>"
          method="post">

        <?= csrf_field() ?>

        <div class="card mb-3">

            <div class="card-header">
                Data Peminjaman
            </div>

            <div class="card-body">

                <div class="mb-3">

                    <label class="form-label">
                        Anggota
                    </label>

                    <select name="member_id"
                            class="form-select"
                            required>

                        <option value="">
                            Pilih Anggota
                        </option>

                        <?php foreach ($members as $member): ?>

                            <option
                                value="<?= $member['id'] ?>"
                                <?= old('member_id') == $member['id']
                                    ? 'selected' : '' ?>>

                                <?= esc($member['member_code']) ?>
                                -
                                <?= esc($member['name']) ?>

                            </option>

                        <?php endforeach; ?>

                    </select>

                </div>

                <div class="alert alert-info mb-0">

                    Lama peminjaman adalah 7 hari.
                    Maksimal 5 judul buku dalam satu transaksi.

                </div>

            </div>

        </div>

        <div class="card mb-3">

            <div class="card-header">
                Daftar Buku
            </div>

            <div class="card-body">

                <div id="book-list">

                    <div class="row g-2 mb-3 book-row">

                        <div class="col-md-8">

                            <select name="book_id[]"
                                    class="form-select"
                                    required>

                                <option value="">
                                    Pilih Buku
                                </option>

                                <?php foreach ($books as $book): ?>

                                    <option value="<?= $book['id'] ?>">

                                        <?= esc($book['title']) ?>

                                        (Stok:
                                        <?= $book['stock_available'] ?>)

                                    </option>

                                <?php endforeach; ?>

                            </select>

                        </div>

                        <div class="col-md-3">

                            <input type="number"
                                   name="quantity[]"
                                   class="form-control"
                                   min="1"
                                   value="1"
                                   required>

                        </div>

                        <div class="col-md-1">

                            <button type="button"
                                    class="btn btn-danger remove-book">

                                X

                            </button>

                        </div>

                    </div>

                </div>

                <button type="button"
                        class="btn btn-outline-primary"
                        id="add-book">

                    Tambah Buku

                </button>

            </div>

        </div>

        <button type="submit"
                class="btn btn-success">

            Simpan Peminjaman

        </button>

        <a href="<?= site_url('loans') ?>"
           class="btn btn-secondary">

            Kembali

        </a>

    </form>

</div>

<script>
document.addEventListener('DOMContentLoaded', function () {

    const bookList = document.getElementById('book-list');
    const addButton = document.getElementById('add-book');

    function updateButtons() {

        const rows = bookList.querySelectorAll('.book-row');

        addButton.disabled = rows.length >= 5;

        rows.forEach(function (row) {

            const removeButton =
                row.querySelector('.remove-book');

            removeButton.disabled = rows.length <= 1;

        });
    }

    addButton.addEventListener('click', function () {

        const rows = bookList.querySelectorAll('.book-row');

        if (rows.length >= 5) {
            return;
        }

        const newRow = rows[0].cloneNode(true);

        newRow.querySelector('select').value = '';
        newRow.querySelector('input').value = 1;

        bookList.appendChild(newRow);

        updateButtons();

    });

    bookList.addEventListener('click', function (event) {

        if (event.target.classList.contains('remove-book')) {

            const rows = bookList.querySelectorAll('.book-row');

            if (rows.length > 1) {

                event.target.closest('.book-row').remove();

            }

            updateButtons();

        }

    });

    updateButtons();

});
</script>

<?= $this->endSection() ?>

9.1. Memahami fungsi JavaScript

Pada form tersebut, kita menggunakan JavaScript untuk menambah dan menghapus baris buku.

Ketika petugas menekan tombol Tambah Buku, sistem membuat baris baru.

Namun, jumlah baris dibatasi maksimal lima.

if (rows.length >= 5) {
    return;
}

Kita juga menyediakan tombol untuk menghapus baris yang tidak diperlukan.

Meskipun demikian, JavaScript hanya membantu interaksi pengguna. Validasi utama tetap berada di controller karena pengguna dapat mengubah data form melalui browser.

10. Menambahkan Routes Peminjaman

Setelah controller dan view selesai, kita perlu mendaftarkan route.

Buka:

app/Config/Routes.php

Tambahkan route berikut ke dalam grup yang sudah dilindungi filter Authentication:

$routes->group('', ['filter' => 'auth'], static function ($routes) {

    $routes->get('loans', 'Loans::index');

    $routes->get('loans/new', 'Loans::new');

    $routes->post('loans/create', 'Loans::create');

});

Pastikan alias filter auth sesuai dengan konfigurasi filter yang sudah digunakan pada proyek SIPUS.

Route yang digunakan adalah:

MethodURLController
GETloansLoans::index
GETloans/newLoans::new
POSTloans/createLoans::create

Kita menggunakan method POST untuk menyimpan transaksi karena proses tersebut mengubah data database.

Pastikan juga CSRF protection tetap aktif.

11. Menambahkan Menu Peminjaman pada Sidebar

Agar petugas mudah membuka halaman transaksi, tambahkan menu Peminjaman pada sidebar.

Buka file:

app/Views/layouts/sidebar.php

Tambahkan menu berikut sesuai struktur sidebar yang sudah digunakan:

<li class="nav-item">

    <a href="<?= site_url('loans') ?>"
       class="nav-link">

        <i class="bi bi-journal-plus"></i>

        <span>Peminjaman</span>

    </a>

</li>

Jika proyek belum menggunakan Bootstrap Icons, kita dapat menggunakan ikon yang sudah tersedia atau menghilangkan elemen ikon tersebut.

12. Menguji Transaksi Peminjaman

Setelah seluruh file dibuat, jalankan aplikasi SIPUS:

php spark serve

Buka aplikasi melalui browser dan login menggunakan akun petugas atau admin yang memiliki hak akses transaksi.

Kemudian lakukan beberapa pengujian berikut.

12.1. Pengujian peminjaman anggota aktif

Langkah pengujian:

  1. Buka menu Peminjaman.
  2. Klik tombol Tambah Peminjaman.
  3. Pilih anggota dengan status active.
  4. Pilih satu buku.
  5. Masukkan jumlah peminjaman.
  6. Klik Simpan Peminjaman.

Hasil yang diharapkan:

  • Data transaksi tersimpan di tabel loans.
  • Detail buku tersimpan di tabel loan_details.
  • Stok tersedia berkurang.
  • Status transaksi menjadi active.
  • Tanggal jatuh tempo terisi otomatis.

12.2. Pengujian anggota tidak aktif

Langkah pengujian:

  1. Buka data anggota.
  2. Ubah status salah satu anggota menjadi inactive.
  3. Coba kirim transaksi menggunakan anggota tersebut.

Hasil yang diharapkan:

  • Sistem menolak transaksi.
  • Tidak ada data transaksi baru yang tersimpan.
  • Stok buku tidak berubah.

12.3. Pengujian stok tidak mencukupi

Misalnya, stok buku tersedia hanya 2 eksemplar.

Kemudian petugas mencoba meminjam 3 eksemplar.

Hasil yang diharapkan:

  • Sistem menolak peminjaman.
  • Transaksi tidak tersimpan.
  • Detail peminjaman tidak tersimpan.
  • Stok tetap 2.

12.4. Pengujian maksimal judul buku

Coba masukkan enam judul buku dalam satu transaksi.

Hasil yang diharapkan:

  • Form membatasi penambahan setelah lima judul.
  • Jika data tetap dikirim secara manual, controller menolak transaksi.
  • Tidak ada perubahan data database.

12.5. Pengujian database rollback

Pengujian ini penting untuk memastikan seluruh proses berjalan sebagai satu kesatuan.

Contohnya:

  • Buku pertama memiliki stok cukup.
  • Buku kedua memiliki stok tidak cukup.
  • Petugas mencoba meminjam kedua buku dalam satu transaksi.

Hasil yang diharapkan:

  • Sistem menolak transaksi.
  • Data utama pada loans tidak tersimpan.
  • Detail buku pada loan_details tidak tersimpan.
  • Stok buku pertama tidak berkurang.
  • Stok buku kedua tetap sama.

Jika hasilnya demikian, proses rollback sudah bekerja sesuai tujuan.

13. Memastikan Perubahan Stok Konsisten

Stok tersedia merupakan bagian penting dalam aplikasi perpustakaan.

Pada proses peminjaman, kita menggunakan rumus:

Stok tersedia setelah peminjaman
= Stok tersedia sebelumnya - Jumlah dipinjam

Contohnya:

Stok tersedia sebelumnya = 10
Jumlah dipinjam           = 3

Stok tersedia setelah peminjaman = 10 - 3
                                 = 7

Sistem juga harus menjaga agar stok tidak menjadi negatif.

Untuk menjaga konsistensi, perhatikan hal berikut:

  1. Selalu periksa stok dari database ketika transaksi disimpan.
  2. Jangan hanya mengandalkan stok yang ditampilkan pada form.
  3. Gunakan database transaction.
  4. Gunakan InnoDB.
  5. Jangan mengurangi stok sebelum pemeriksaan berhasil.
  6. Jangan mengubah stok melalui proses terpisah dari penyimpanan transaksi.

Dengan cara tersebut, risiko ketidaksesuaian data stok dapat dikurangi.

14. Struktur File Modul Peminjaman

Setelah mengikuti tutorial, struktur file yang berkaitan dengan transaksi peminjaman akan menjadi seperti berikut:

app/
├── Controllers/
│   └── Loans.php
│
├── Models/
│   ├── LoanModel.php
│   └── LoanDetailModel.php
│
├── Views/
│   └── loans/
│       ├── index.php
│       └── create.php
│
├── Database/
│   └── Migrations/
│       ├── ...CreateLoansTable.php
│       └── ...CreateLoanDetailsTable.php
│
└── Config/
    └── Routes.php

Struktur tersebut mengikuti pola MVC CodeIgniter 4:

  • Model mengelola akses dan struktur data.
  • Controller mengatur alur peminjaman dan aturan bisnis.
  • View menampilkan halaman kepada pengguna.
  • Routes menghubungkan URL dengan controller.

15. Kesimpulan

Pada tutorial ini, kita telah membuat dasar transaksi peminjaman buku pada aplikasi SIPUS menggunakan CodeIgniter 4 dan Bootstrap 5.

Kita memulai dengan memahami aturan bisnis, membuat tabel loans dan loan_details, kemudian membuat model serta controller untuk memproses peminjaman.

Selanjutnya, kita membuat halaman daftar transaksi dan form peminjaman. Sistem juga telah menerapkan pemeriksaan anggota aktif, pengecekan stok, pembatasan maksimal lima judul buku, serta perhitungan tanggal jatuh tempo tujuh hari.

Hal terpenting adalah penggunaan database transaction untuk menjaga konsistensi data. Ketika seluruh proses berhasil, sistem menyimpan transaksi dan mengurangi stok secara otomatis. Sebaliknya, jika salah satu proses gagal, sistem membatalkan seluruh perubahan.

Dengan selesainya fitur ini, SIPUS sudah memiliki dasar proses peminjaman buku.

Pada tutorial berikutnya, kita akan melanjutkan dengan membuat Transaksi Pengembalian Buku. Fitur tersebut akan memungkinkan petugas mencatat pengembalian secara bertahap maupun sekaligus, menambah stok secara otomatis, dan mengubah status transaksi menjadi selesai ketika seluruh buku telah dikembalikan.


Referensi dan tautan pendukung

Catatan implementasi: sesuaikan nama kolom users.username, session user_id, dan alias filter Authentication dengan implementasi SIPUS yang sudah ada. Pastikan migration tabel transaksi tidak dibuat ulang jika tabel tersebut sudah tersedia. Sebelum digunakan, uji peminjaman normal, stok tidak cukup, anggota tidak aktif, dan rollback database.

Tinggalkan Balasan

Alamat email Anda tidak akan dipublikasikan. Ruas yang wajib ditandai *

Situs ini menggunakan Akismet untuk mengurangi spam. Pelajari bagaimana data komentar Anda diproses