MWI – Halo sobat pembelajar web MuSa, yuk kita lanjutkan kembali pembahasan tentang Aplikasi SIPUS, kali ini kita akan membahas tentang Transaksi.
Daftar Isi
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:
- Anggota harus memiliki status
active. - Satu transaksi maksimal berisi 5 judul buku.
- Jumlah buku yang dipinjam minimal 1 eksemplar.
- Stok buku harus mencukupi jumlah peminjaman.
- Lama peminjaman adalah 7 hari.
- Sistem mencatat petugas yang melayani transaksi.
- Setelah transaksi berhasil, stok tersedia otomatis berkurang.
- 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:
- Petugas membuka halaman transaksi peminjaman.
- Sistem menampilkan daftar anggota aktif.
- Petugas memilih anggota.
- Petugas memilih maksimal 5 judul buku.
- Petugas memasukkan jumlah setiap buku.
- Sistem memeriksa kembali status anggota.
- Sistem memeriksa ketersediaan stok setiap buku.
- Sistem membuat data utama peminjaman.
- Sistem menyimpan detail buku yang kita pinjam.
- Sistem mengurangi stok tersedia.
- 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.
| Buku | Stok awal | Jumlah dipinjam |
|---|---|---|
| Pemrograman PHP | 10 | 2 |
| Basis Data | 5 | 1 |
Setelah transaksi berhasil, stok tersedia berubah menjadi:
| Buku | Stok awal | Dipinjam | Stok akhir |
|---|---|---|---|
| Pemrograman PHP | 10 | 2 | 8 |
| Basis Data | 5 | 1 | 4 |
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.
| Field | Tipe data | Keterangan |
|---|---|---|
| id | INT | Primary key |
| loan_code | VARCHAR(30) | Kode transaksi |
| member_id | INT | ID anggota |
| user_id | INT | ID petugas |
| loan_date | DATE | Tanggal peminjaman |
| due_date | DATE | Tanggal jatuh tempo |
| status | VARCHAR(20) | Status transaksi |
| created_at | DATETIME | Waktu pembuatan |
| updated_at | DATETIME | Waktu 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.
| Field | Tipe data | Keterangan |
|---|---|---|
| id | INT | Primary key |
| loan_id | INT | Relasi ke tabel loans |
| book_id | INT | Relasi ke tabel books |
| quantity | INT | Jumlah buku dipinjam |
| created_at | DATETIME | Waktu pembuatan |
| updated_at | DATETIME | Waktu 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
| id | loan_code | member_id | status |
|---|---|---|---|
| 1 | PJM-20261120-123 | 5 | active |
Tabel loan_details
| id | loan_id | book_id | quantity |
|---|---|---|---|
| 1 | 1 | 2 | 2 |
| 2 | 1 | 4 | 1 |
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:
idmenjadi primary key.loan_codememiliki unique index agar kode transaksi tidak boleh sama.member_idmenyimpan ID anggota.user_idmenyimpan ID petugas yang melayani.loan_datemenyimpan tanggal peminjaman.due_datemenyimpan tanggal jatuh tempo.statusmenyimpan 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:
| Method | URL | Controller |
|---|---|---|
| GET | loans | Loans::index |
| GET | loans/new | Loans::new |
| POST | loans/create | Loans::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:
- Buka menu Peminjaman.
- Klik tombol Tambah Peminjaman.
- Pilih anggota dengan status
active. - Pilih satu buku.
- Masukkan jumlah peminjaman.
- 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:
- Buka data anggota.
- Ubah status salah satu anggota menjadi
inactive. - 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
loanstidak tersimpan. - Detail buku pada
loan_detailstidak 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:
- Selalu periksa stok dari database ketika transaksi disimpan.
- Jangan hanya mengandalkan stok yang ditampilkan pada form.
- Gunakan database transaction.
- Gunakan InnoDB.
- Jangan mengurangi stok sebelum pemeriksaan berhasil.
- 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
- Dokumentasi resmi CodeIgniter 4
- Dokumentasi Database Transactions CodeIgniter 4
- Dokumentasi Model CodeIgniter 4
- Dokumentasi Bootstrap 5
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.