Koha-clms/t/db_dependent/Koha/Booking.t

730 lines
27 KiB
Perl
Executable File

#!/usr/bin/perl
# Copyright 2024 Koha Development team
#
# This file is part of Koha
#
# Koha is free software; you can redistribute it and/or modify it
# under the terms of the GNU General Public License as published by
# the Free Software Foundation; either version 3 of the License, or
# (at your option) any later version.
#
# Koha is distributed in the hope that it will be useful, but
# WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with Koha; if not, see <https://www.gnu.org/licenses>.
use Modern::Perl;
use utf8;
use Test::More tests => 3;
use Test::NoWarnings;
use Test::Warn;
use Test::Exception;
use Koha::DateUtils qw( dt_from_string );
use Koha::Notice::Template;
use Koha::Notice::Templates;
use t::lib::TestBuilder;
use t::lib::Mocks;
my $schema = Koha::Database->new->schema;
my $builder = t::lib::TestBuilder->new;
subtest 'Relation accessor tests' => sub {
plan tests => 6;
subtest 'biblio relation tests' => sub {
plan tests => 3;
$schema->storage->txn_begin;
my $biblio = $builder->build_sample_biblio;
my $booking =
$builder->build_object( { class => 'Koha::Bookings', value => { biblio_id => $biblio->biblionumber } } );
my $THE_biblio = $booking->biblio;
is( ref($THE_biblio), 'Koha::Biblio', "Koha::Booking->biblio returns a Koha::Biblio object" );
is( $THE_biblio->biblionumber, $biblio->biblionumber, "Koha::Booking->biblio returns the links biblio object" );
$THE_biblio->delete;
$booking = Koha::Bookings->find( $booking->booking_id );
is( $booking, undef, "The booking is deleted when the biblio it's attached to is deleted" );
$schema->storage->txn_rollback;
};
subtest 'patron relation tests' => sub {
plan tests => 3;
$schema->storage->txn_begin;
my $patron = $builder->build_object( { class => "Koha::Patrons" } );
my $booking =
$builder->build_object( { class => 'Koha::Bookings', value => { patron_id => $patron->borrowernumber } } );
my $THE_patron = $booking->patron;
is( ref($THE_patron), 'Koha::Patron', "Koha::Booking->patron returns a Koha::Patron object" );
is(
$THE_patron->borrowernumber, $patron->borrowernumber,
"Koha::Booking->patron returns the links patron object"
);
$THE_patron->delete;
$booking = Koha::Bookings->find( $booking->booking_id );
is( $booking, undef, "The booking is deleted when the patron it's attached to is deleted" );
$schema->storage->txn_rollback;
};
subtest 'pickup_library relation tests' => sub {
plan tests => 3;
$schema->storage->txn_begin;
my $pickup_library = $builder->build_object( { class => "Koha::Libraries" } );
my $booking =
$builder->build_object(
{ class => 'Koha::Bookings', value => { pickup_library_id => $pickup_library->branchcode } } );
my $THE_pickup_library = $booking->pickup_library;
is( ref($THE_pickup_library), 'Koha::Library', "Koha::Booking->pickup_library returns a Koha::Library object" );
is(
$THE_pickup_library->branchcode, $pickup_library->branchcode,
"Koha::Booking->pickup_library returns the linked pickup library object"
);
$THE_pickup_library->delete;
$booking = Koha::Bookings->find( $booking->booking_id );
is( $booking, undef, "The booking is deleted when the pickup_library it's attached to is deleted" );
$schema->storage->txn_rollback;
};
subtest 'item relation tests' => sub {
plan tests => 3;
$schema->storage->txn_begin;
my $item = $builder->build_sample_item( { bookable => 1 } );
my $booking =
$builder->build_object( { class => 'Koha::Bookings', value => { item_id => $item->itemnumber } } );
my $THE_item = $booking->item;
is( ref($THE_item), 'Koha::Item', "Koha::Booking->item returns a Koha::Item object" );
is(
$THE_item->itemnumber, $item->itemnumber,
"Koha::Booking->item returns the links item object"
);
$THE_item->delete;
$booking = Koha::Bookings->find( $booking->booking_id );
is( $booking, undef, "The booking is deleted when the item it's attached to is deleted" );
$schema->storage->txn_rollback;
};
subtest 'checkout relation tests' => sub {
plan tests => 4;
$schema->storage->txn_begin;
my $patron = $builder->build_object( { class => "Koha::Patrons" } );
my $item = $builder->build_sample_item( { bookable => 1 } );
my $booking = $builder->build_object(
{
class => 'Koha::Bookings',
value => {
patron_id => $patron->borrowernumber,
item_id => $item->itemnumber,
status => 'completed'
}
}
);
my $checkout = $booking->checkout;
is( $checkout, undef, "Koha::Booking->checkout returns undef when no checkout exists" );
my $issue = $builder->build_object(
{
class => 'Koha::Checkouts',
value => {
borrowernumber => $patron->borrowernumber,
itemnumber => $item->itemnumber,
booking_id => $booking->booking_id
}
}
);
$checkout = $booking->checkout;
is( ref($checkout), 'Koha::Checkout', "Koha::Booking->checkout returns a Koha::Checkout object" );
is( $checkout->issue_id, $issue->issue_id, "Koha::Booking->checkout returns the linked checkout" );
is( $checkout->booking_id, $booking->booking_id, "The checkout is properly linked to the booking" );
$schema->storage->txn_rollback;
};
subtest 'old_checkout relation tests' => sub {
plan tests => 4;
$schema->storage->txn_begin;
my $patron = $builder->build_object( { class => "Koha::Patrons" } );
my $item = $builder->build_sample_item( { bookable => 1 } );
my $booking = $builder->build_object(
{
class => 'Koha::Bookings',
value => {
patron_id => $patron->borrowernumber,
item_id => $item->itemnumber,
status => 'completed'
}
}
);
my $old_checkout = $booking->old_checkout;
is( $old_checkout, undef, "Koha::Booking->old_checkout returns undef when no old_checkout exists" );
my $old_issue = $builder->build_object(
{
class => 'Koha::Old::Checkouts',
value => {
borrowernumber => $patron->borrowernumber,
itemnumber => $item->itemnumber,
booking_id => $booking->booking_id
}
}
);
$old_checkout = $booking->old_checkout;
is(
ref($old_checkout), 'Koha::Old::Checkout',
"Koha::Booking->old_checkout returns a Koha::Old::Checkout object"
);
is(
$old_checkout->issue_id, $old_issue->issue_id,
"Koha::Booking->old_checkout returns the linked old_checkout"
);
is( $old_checkout->booking_id, $booking->booking_id, "The old_checkout is properly linked to the booking" );
$schema->storage->txn_rollback;
};
};
subtest 'store() tests' => sub {
plan tests => 16;
$schema->storage->txn_begin;
my $patron = $builder->build_object( { class => "Koha::Patrons" } );
t::lib::Mocks::mock_userenv( { patron => $patron } );
my $biblio = $builder->build_sample_biblio();
my $item_1 = $builder->build_sample_item( { biblionumber => $biblio->biblionumber } );
my $start_0 = dt_from_string->subtract( days => 2 )->truncate( to => 'day' );
my $end_0 = $start_0->clone()->add( days => 6 );
my $deleted_item = $builder->build_sample_item( { biblionumber => $biblio->biblionumber } );
$deleted_item->delete;
my $wrong_item = $builder->build_sample_item();
my $booking = Koha::Booking->new(
{
patron_id => $patron->borrowernumber,
biblio_id => $biblio->biblionumber,
item_id => $deleted_item->itemnumber,
pickup_library_id => $deleted_item->homebranch,
start_date => $start_0,
end_date => $end_0
}
);
throws_ok { $booking->store() } 'Koha::Exceptions::Object::FKConstraint',
'Throws exception if passed a deleted item';
$booking = Koha::Booking->new(
{
patron_id => $patron->borrowernumber,
biblio_id => $biblio->biblionumber,
item_id => $wrong_item->itemnumber,
pickup_library_id => $wrong_item->homebranch,
start_date => $start_0,
end_date => $end_0
}
);
throws_ok { $booking->store() } 'Koha::Exceptions::Object::FKConstraint',
"Throws exception if item passed doesn't match biblio passed";
$booking = Koha::Booking->new(
{
patron_id => $patron->borrowernumber,
biblio_id => $biblio->biblionumber,
item_id => $item_1->itemnumber,
pickup_library_id => $item_1->homebranch,
start_date => $start_0,
end_date => $end_0
}
);
# FIXME: Should this be allowed if an item is passed specifically?
throws_ok { $booking->store() } 'Koha::Exceptions::Booking::Clash',
'Throws exception when there are no items marked bookable for this biblio';
$item_1->bookable(1)->store();
$booking->store();
ok( $booking->in_storage, 'First booking on item 1 stored OK' );
# Bookings
# ✓ Item 1 |----|
# ✗ Item 1 |----|
my $start_1 = dt_from_string->truncate( to => 'day' );
my $end_1 = $start_1->clone()->add( days => 6 );
$booking = Koha::Booking->new(
{
patron_id => $patron->borrowernumber,
biblio_id => $biblio->biblionumber,
item_id => $item_1->itemnumber,
pickup_library_id => $item_1->homebranch,
start_date => $start_1,
end_date => $end_1
}
);
throws_ok { $booking->store } 'Koha::Exceptions::Booking::Clash',
'Throws exception when passed booking start_date falls inside another booking for the item passed';
# Bookings
# ✓ Item 1 |----|
# ✗ Item 1 |----|
$start_1 = dt_from_string->subtract( days => 4 )->truncate( to => 'day' );
$end_1 = $start_1->clone()->add( days => 6 );
$booking = Koha::Booking->new(
{
patron_id => $patron->borrowernumber,
biblio_id => $biblio->biblionumber,
item_id => $item_1->itemnumber,
pickup_library_id => $item_1->homebranch,
start_date => $start_1,
end_date => $end_1
}
);
throws_ok { $booking->store } 'Koha::Exceptions::Booking::Clash',
'Throws exception when passed booking end_date falls inside another booking for the item passed';
# Bookings
# ✓ Item 1 |----|
# ✗ Item 1 |--------|
$start_1 = dt_from_string->subtract( days => 4 )->truncate( to => 'day' );
$end_1 = $start_1->clone()->add( days => 10 );
$booking = Koha::Booking->new(
{
patron_id => $patron->borrowernumber,
biblio_id => $biblio->biblionumber,
item_id => $item_1->itemnumber,
pickup_library_id => $item_1->homebranch,
start_date => $start_1,
end_date => $end_1
}
);
throws_ok { $booking->store } 'Koha::Exceptions::Booking::Clash',
'Throws exception when passed booking dates would envelope another booking for the item passed';
# Bookings
# ✓ Item 1 |----|
# ✗ Item 1 |--|
$start_1 = dt_from_string->truncate( to => 'day' );
$end_1 = $start_1->clone()->add( days => 4 );
$booking = Koha::Booking->new(
{
patron_id => $patron->borrowernumber,
biblio_id => $biblio->biblionumber,
item_id => $item_1->itemnumber,
pickup_library_id => $item_1->homebranch,
start_date => $start_1,
end_date => $end_1
}
);
throws_ok { $booking->store } 'Koha::Exceptions::Booking::Clash',
'Throws exception when passed booking dates would fall wholly inside another booking for the item passed';
my $item_2 = $builder->build_sample_item( { biblionumber => $biblio->biblionumber, bookable => 1 } );
my $item_3 = $builder->build_sample_item( { biblionumber => $biblio->biblionumber, bookable => 0 } );
# Bookings
# ✓ Item 1 |----|
# ✓ Item 2 |--|
$booking = Koha::Booking->new(
{
patron_id => $patron->borrowernumber,
biblio_id => $biblio->biblionumber,
item_id => $item_2->itemnumber,
pickup_library_id => $item_2->homebranch,
start_date => $start_1,
end_date => $end_1
}
)->store();
ok(
$booking->in_storage,
'First booking on item 2 stored OK, even though it would overlap with a booking on item 1'
);
# Bookings
# ✓ Item 1 |----|
# ✓ Item 2 |--|
# ✘ Any |--|
$booking = Koha::Booking->new(
{
patron_id => $patron->borrowernumber,
biblio_id => $biblio->biblionumber,
pickup_library_id => $item_2->homebranch,
start_date => $start_1,
end_date => $end_1
}
);
throws_ok { $booking->store } 'Koha::Exceptions::Booking::Clash',
'Throws exception when passed booking dates would fall wholly inside all existing bookings when no item specified';
# Bookings
# ✓ Item 1 |----|
# ✓ Item 2 |--|
# ✓ Any |--|
$start_1 = dt_from_string->add( days => 5 )->truncate( to => 'day' );
$end_1 = $start_1->clone()->add( days => 4 );
$booking = Koha::Booking->new(
{
patron_id => $patron->borrowernumber,
biblio_id => $biblio->biblionumber,
pickup_library_id => $item_2->homebranch,
start_date => $start_1,
end_date => $end_1
}
)->store();
ok( $booking->in_storage, 'Booking stored OK when item not specified and the booking slot is available' );
ok( $booking->item_id, 'An item was assigned to the booking' );
subtest '_assign_item_for_booking() tests' => sub {
plan tests => 5;
# Bookings
# ✓ Item 1 |----|
# ✓ Item 2 |--|
# ✓ Any (X) |--|
my $valid_items = [ $item_1->itemnumber, $item_2->itemnumber ];
my $assigned_item = $booking->item_id;
is(
( scalar grep { $_ == $assigned_item } @$valid_items ), 1,
'The item assigned was one of the valid, bookable items'
);
my $second_booking = Koha::Booking->new(
{
patron_id => $patron->borrowernumber,
biblio_id => $biblio->biblionumber,
pickup_library_id => $item_2->homebranch,
start_date => $start_1,
end_date => $end_1
}
)->store();
isnt( $second_booking->item_id, $assigned_item, "The subsequent booking picks the only other available item" );
# Cancel both bookings so we can check that cancelled bookings are allowed in the auto-assign
$booking->status('cancelled')->store();
$second_booking->status('cancelled')->store();
is( $booking->status, 'cancelled', "Booking is cancelled" );
is( $second_booking->status, 'cancelled', "Second booking is cancelled" );
# Test randomness of selection
my %seen_items;
foreach my $i ( 1 .. 10 ) {
my $new_booking = Koha::Booking->new(
{
patron_id => $patron->borrowernumber,
biblio_id => $biblio->biblionumber,
pickup_library_id => $item_1->homebranch,
start_date => $start_1,
end_date => $end_1
}
);
$new_booking->store();
$seen_items{ $new_booking->item_id }++;
$new_booking->delete();
}
ok(
scalar( keys %seen_items ) > 1,
'Multiple different items were selected randomly across bookings, and a cancelled booking is allowed in the selection'
);
};
subtest 'confirmation notice trigger' => sub {
plan tests => 4;
# FIXME: This is a bandaid solution to prevent test failures when running
# the Koha_Main_My8 job because notices are not added at upgrade time.
my $template = Koha::Notice::Templates->search(
{
module => 'bookings',
code => 'BOOKING_CONFIRMATION',
message_transport_type => 'email',
}
)->single;
if ( !$template ) {
my $default_content = Koha::Notice::Template->new(
{
module => 'bookings',
code => 'BOOKING_CONFIRMATION',
lang => 'default',
message_transport_type => 'email',
}
)->get_default();
Koha::Notice::Template->new(
{
module => 'bookings',
code => 'BOOKING_CONFIRMATION',
name => 'BOOKING_CONFIRMATION Test Notice',
title => 'BOOKING_CONFIRMATION Test Notice',
content => $default_content || 'Dummy content for BOOKING_CONFIRMATION.',
branchcode => undef,
message_transport_type => 'email',
}
)->store;
}
my $original_notices_count = Koha::Notice::Messages->search(
{
letter_code => 'BOOKING_CONFIRMATION',
borrowernumber => $patron->borrowernumber,
}
)->count;
# Reuse previous booking to produce a clash
warning_like(
sub {
throws_ok {
Koha::Booking->new( $booking->unblessed )->store
}
'Koha::Exceptions::Object::DuplicateID',
'Exception is thrown correctly';
},
qr{Duplicate entry '(.*?)' for key '(.*\.?)PRIMARY'}
);
my $post_notices_count = Koha::Notice::Messages->search(
{
letter_code => 'BOOKING_CONFIRMATION',
borrowernumber => $patron->borrowernumber,
}
)->count;
is(
$post_notices_count,
$original_notices_count,
'Koha::Booking->store should not have enqueued a BOOKING_CONFIRMATION email if booking creation fails'
);
$start_1 = dt_from_string->add( months => 1 )->truncate( to => 'day' );
$end_1 = $start_1->clone()->add( days => 1 );
$booking = Koha::Booking->new(
{
patron_id => $patron->borrowernumber,
biblio_id => $biblio->biblionumber,
pickup_library_id => $item_2->homebranch,
start_date => $start_1->datetime(q{ }),
end_date => $end_1->datetime(q{ }),
}
)->store;
$post_notices_count = Koha::Notice::Messages->search(
{
letter_code => 'BOOKING_CONFIRMATION',
borrowernumber => $patron->borrowernumber,
}
)->count;
is(
$post_notices_count,
$original_notices_count + 1,
'Koha::Booking->store should have enqueued a BOOKING_CONFIRMATION email for a new booking'
);
};
subtest 'modification/cancellation notice triggers' => sub {
plan tests => 5;
# FIXME: This is a bandaid solution to prevent test failures when running
# the Koha_Main_My8 job because notices are not added at upgrade time.
for my $notice_type (qw(BOOKING_MODIFICATION BOOKING_CANCELLATION)) {
my $template = Koha::Notice::Templates->search(
{
module => 'bookings',
code => $notice_type,
message_transport_type => 'email',
}
)->single;
if ( !$template ) {
my $default_content = Koha::Notice::Template->new(
{
module => 'bookings',
code => $notice_type,
lang => 'default',
message_transport_type => 'email',
}
)->get_default();
Koha::Notice::Template->new(
{
module => 'bookings',
code => $notice_type,
name => "$notice_type Test Notice",
title => "$notice_type Test Notice",
content => $default_content || "Dummy content for $notice_type.",
branchcode => undef,
message_transport_type => 'email',
}
)->store;
}
}
my $original_modification_notices_count = Koha::Notice::Messages->search(
{
letter_code => 'BOOKING_MODIFICATION',
borrowernumber => $patron->borrowernumber,
}
)->count;
my $original_cancellation_notices_count = Koha::Notice::Messages->search(
{
letter_code => 'BOOKING_CANCELLATION',
borrowernumber => $patron->borrowernumber,
}
)->count;
$start_1 = dt_from_string->add( months => 1 )->truncate( to => 'day' );
$end_1 = $start_1->clone()->add( days => 1 );
# Use datetime formatting so that we don't get DateTime objects
$booking = Koha::Booking->new(
{
patron_id => $patron->borrowernumber,
biblio_id => $biblio->biblionumber,
pickup_library_id => $item_2->homebranch,
start_date => $start_1->datetime(q{ }),
end_date => $end_1->datetime(q{ }),
}
)->store;
my $post_modification_notices_count = Koha::Notice::Messages->search(
{
letter_code => 'BOOKING_MODIFICATION',
borrowernumber => $patron->borrowernumber,
}
)->count;
is(
$post_modification_notices_count,
$original_modification_notices_count,
'Koha::Booking->store should not have enqueued a BOOKING_MODIFICATION email for a new booking'
);
my $item_4 = $builder->build_sample_item( { biblionumber => $biblio->biblionumber, bookable => 1 } );
$booking->update(
{
item_id => $item_4->itemnumber,
}
);
$post_modification_notices_count = Koha::Notice::Messages->search(
{
letter_code => 'BOOKING_MODIFICATION',
borrowernumber => $patron->borrowernumber,
}
)->count;
is(
$post_modification_notices_count,
$original_modification_notices_count,
'Koha::Booking->store should not have enqueued a BOOKING_MODIFICATION email for a booking with modified item_id'
);
$booking->update(
{
start_date => $start_1->clone()->add( days => 1 )->datetime(q{ }),
}
);
# start_date, end_date and pickup_library_id should behave identical
$post_modification_notices_count = Koha::Notice::Messages->search(
{
letter_code => 'BOOKING_MODIFICATION',
borrowernumber => $patron->borrowernumber,
}
)->count;
is(
$post_modification_notices_count,
$original_modification_notices_count + 1,
'Koha::Booking->store should have enqueued a BOOKING_MODIFICATION email for a booking with modified start_date'
);
$booking->update(
{
end_date => $end_1->clone()->add( days => 1 )->datetime(q{ }),
}
);
$booking->update(
{
status => 'completed',
}
);
my $post_cancellation_notices_count = Koha::Notice::Messages->search(
{
letter_code => 'BOOKING_CANCELLATION',
borrowernumber => $patron->borrowernumber,
}
)->count;
is(
$post_cancellation_notices_count,
$original_cancellation_notices_count,
'Koha::Booking->store should NOT have enqueued a BOOKING_CANCELLATION email for a booking status change that is not a "cancellation"'
);
$booking->update(
{
status => 'cancelled',
}
);
$post_cancellation_notices_count = Koha::Notice::Messages->search(
{
letter_code => 'BOOKING_CANCELLATION',
borrowernumber => $patron->borrowernumber,
}
)->count;
is(
$post_cancellation_notices_count,
$original_cancellation_notices_count + 1,
'Koha::Booking->store should have enqueued a BOOKING_CANCELLATION email for a booking status change that is a "cancellation"'
);
};
subtest 'status change exception' => sub {
plan tests => 3;
$booking->discard_changes;
my $status = $booking->status;
warning_like(
sub {
throws_ok { $booking->update( { status => 'blah' } ) } 'Koha::Exceptions::Object::BadValue',
'Throws exception when passed booking status would fail enum constraint';
},
qr{Data truncated for column 'status'}
);
# Status unchanged
$booking->discard_changes;
is( $booking->status, $status, 'Booking status is unchanged' );
};
$schema->storage->txn_rollback;
};