Context Navigation

← Previous Change
Wiki History
Next Change →

Changes between Version 5 and Version 6 of DatabaseProgramming

Timestamp:: 05/27/26 00:29:05 (14 hours ago)
Author:: 231088
Comment:: --

Legend:

: Unmodified
: Added
: Removed
: Modified

DatabaseProgramming

-              v5
+              v6
+= Функции, Процедури и Тригери =
 Во оваа фаза беа имплементирани функции, процедури и тригери кои ја поддржуваат основната бизнис логика на системот за booking на артисти и бендови. Секоја компонента е одговорна за одредена операција — од пресметување статистики, преку управување со bookings, до автоматска заштита од грешки.
 …
 Функцијата {{{fn_check_artist_availability}}} проверува дали артист или бенд има слободен термин на одреден датум и враќа {{{TRUE}}} или {{{FALSE}}}.
 Наместо {{{COUNT(*)}}} кој ги брои сите редици, функцијата користи {{{EXISTS}}} кој застанува веднаш при првиот пронајден слободен слот — со што е значително поефикасна.
+Пребарува во табелата {{{AvailabilitySlot}}} дали постои слот со статус {{{AVAILABLE}}} за дадениот артист на бараниот датум. Резултатот од {{{COUNT(*)}}} се споредува со {{{0}}} и се враќа соодветна булова вредност.
 {{{
 CREATE OR REPLACE FUNCTION fn_check_artist_availability(
     p_bookable_id INT,
     p_date        DATE
+    p_date DATE
+)
 RETURNS BOOLEAN
 …
 $$
 DECLARE
+    v_exists BOOLEAN;
+BEGIN
+    SELECT EXISTS(
+        SELECT 1
+        FROM AvailabilitySlot
+        WHERE bookable_id = p_bookable_id
+          AND DATE(start_datetime) = p_date
+          AND status = 'AVAILABLE'
+    )
+    INTO v_exists;
+    RETURN v_exists;
+    v_exists INT;
+BEGIN
+    SELECT COUNT(*)
+    INTO v_exists
+    FROM AvailabilitySlot
+    WHERE bookable_id = p_bookable_id
+      AND DATE(start_datetime) = p_date
+      AND status = 'AVAILABLE';
+    RETURN v_exists > 0;
 END;
 …
 Функцијата {{{fn_total_client_bookings}}} го враќа вкупниот број на bookings направени од одреден клиент.
 Ги поврзува табелите {{{BookingRequest}}}, {{{Offer}}} и {{{Booking}}} за да го пресмета бројот на сите bookings поврзани со клиентот, без разлика на нивниот статус.
+Ги поврзува табелите {{{BookingRequest}}}, {{{Offer}}} и {{{Booking}}} и го пресметува бројот на сите bookings поврзани со клиентот, без разлика на нивниот тековен статус.
 {{{
 CREATE OR REPLACE FUNCTION fn_total_client_bookings(
 …
 == Процедури ==
 Процедурите се користат за извршување на акции врз базата — за разлика од функциите, тие не враќаат вредност туку вршат промени. Секоја процедура содржи валидација пред да изврши каква било промена, со цел да се спречат невалидни состојби во базата.
+Процедурите се користат за извршување на акции врз базата — за разлика од функциите, тие не враќаат вредност туку вршат промени. Секоја процедура е одговорна за еден конкретен процес во системот.
 === 1. sp_create_booking_request ===
 Процедурата {{{sp_create_booking_request}}} креира нов барање за booking од страна на клиент.
+Пред да го изврши вметнувањето, процедурата врши три валидации:
+ * Проверува дали клиентот постои во табелата {{{ClientProfile}}}
+ * Проверува дали локацијата постои во табелата {{{Location}}}
+ * Проверува дали датумот на настанот е во иднина
+Ако некоја од валидациите не помине, се фрла исклучок со јасна порака за грешка.
+Прима ги сите потребни параметри — ID на клиент, траење на настанот, тип на настан, датум и локација — и ги вметнува во табелата {{{BookingRequest}}}. Преку {{{FOREIGN KEY}}} ограничувањата во базата се обезбедува дека само валидни вредности можат да бидат вметнати.
 {{{
 CREATE OR REPLACE PROCEDURE sp_create_booking_request(
 …
 $$
 BEGIN
-    IF NOT EXISTS (
-        SELECT 1 FROM ClientProfile WHERE client_id = p_client_id
-    ) THEN
-        RAISE EXCEPTION 'Client with ID % does not exist!', p_client_id;
-    END IF;
-    IF NOT EXISTS (
-        SELECT 1 FROM Location WHERE location_id = p_location_id
-    ) THEN
-        RAISE EXCEPTION 'Location with ID % does not exist!', p_location_id;
-    END IF;
-    IF p_event_date <= CURRENT_DATE THEN
-        RAISE EXCEPTION 'Event date must be in the future!';
-    END IF;
     INSERT INTO BookingRequest(
 …
 Процедурата {{{sp_cancel_booking}}} го откажува постоечки booking со менување на неговиот статус во {{{CANCELLED}}}.
+Пред да го изврши откажувањето, процедурата врши три проверки:
+ * Проверува дали booking со дадениот ID воопшто постои
+ * Проверува дали booking не е веќе откажан
+ * Проверува дали booking не е веќе завршен — завршените bookings не можат да се откажат
+Без овие проверки, повикот со непостоечки ID би поминал тивко без никаква промена или грешка.
+Прима го ID на booking-от и врши {{{UPDATE}}} врз табелата {{{Booking}}}. Со промената на статусот системот го евидентира откажувањето, а тригерот {{{trg_booking_status_history}}} автоматски ја запишува промената во историјатот.
 {{{
 CREATE OR REPLACE PROCEDURE sp_cancel_booking(
 …
 AS
 $$
+DECLARE
+    v_current_status VARCHAR(30);
+BEGIN
+    SELECT booking_status
+    INTO v_current_status
+    FROM Booking
+    WHERE booking_id = p_booking_id;
+    IF NOT FOUND THEN
+        RAISE EXCEPTION 'Booking with ID % does not exist!', p_booking_id;
+    END IF;
+    IF v_current_status = 'CANCELLED' THEN
+        RAISE EXCEPTION 'Booking % is already cancelled!', p_booking_id;
+    END IF;
+    IF v_current_status = 'COMPLETED' THEN
+        RAISE EXCEPTION 'Booking % is already completed and cannot be cancelled!', p_booking_id;
+    END IF;
+BEGIN
     UPDATE Booking
 …
 Процедурата {{{sp_create_payment}}} креира ново плаќање поврзано со одреден booking.
+Клучна поправка во однос на оригиналната верзија е дека плаќањето се креира со статус {{{PENDING}}} наместо веднаш {{{PAID}}}. Ова одговара на реалниот тек — плаќањето прво се иницира, па дури потоа се потврдува.
+Процедурата врши три валидации:
+ * Проверува дали booking постои
+ * Проверува дали износот е позитивен број
+ * Проверува дали веќе не постои плаќање за истиот booking
+Прима го ID на booking-от и износот на плаќањето и ги вметнува во табелата {{{Payment}}}. Плаќањето се креира со статус {{{PAID}}}, со што се евидентира успешно извршена трансакција.
 {{{
 CREATE OR REPLACE PROCEDURE sp_create_payment(
     p_booking_id INT,
     p_amount     NUMERIC(10,2)
+    p_amount NUMERIC(10,2)
+)
 LANGUAGE plpgsql
 …
 $$
 BEGIN
-    IF NOT EXISTS (
-        SELECT 1 FROM Booking WHERE booking_id = p_booking_id
-    ) THEN
-        RAISE EXCEPTION 'Booking with ID % does not exist!', p_booking_id;
-    END IF;
-    IF p_amount <= 0 THEN
-        RAISE EXCEPTION 'Payment amount must be greater than 0!';
-    END IF;
-    IF EXISTS (
-        SELECT 1 FROM Payment WHERE booking_id = p_booking_id
-    ) THEN
-        RAISE EXCEPTION 'Payment for booking % already exists!', p_booking_id;
-    END IF;
     INSERT INTO Payment(
 …
         p_booking_id,
         p_amount,
         'PENDING'
+        'PAID'
     );
 …
 Тригерите се специјални функции кои се извршуваат автоматски при одредени настани во базата — без потреба апликацијата да ги повикува рачно. Во системот се имплементирани три тригери кои обезбедуваат конзистентност и интегритет на податоците.
+=== 1. trg_prevent_double_booking ===
+=== 1. trg_update_slot_status ===
+Тригерот {{{trg_update_slot_status}}} автоматски го означува слободниот термин на артистот како {{{BOOKED}}} во моментот кога се креира нов booking.
+Се извршува автоматски '''по''' секој нов запис во табелата {{{Booking}}} ({{{AFTER INSERT}}}). Го пронаоѓа соодветниот {{{AvailabilitySlot}}} според артистот и датумот на настанот преку subquery-и и го менува неговиот статус — со тоа се спречува двојна резервација на ист термин.
+{{{
+CREATE OR REPLACE FUNCTION fn_update_slot_status()
+RETURNS TRIGGER
+AS
+$$
+BEGIN
+    UPDATE AvailabilitySlot s
+    SET status = 'BOOKED'
+    WHERE s.bookable_id = (
+              SELECT o.bookable_id
+              FROM Offer o
+              WHERE o.offer_id = NEW.offer_id
+          )
+      AND DATE(s.start_datetime) = (
+              SELECT br.event_date
+              FROM BookingRequest br
+              JOIN Offer o2 ON o2.request_id = br.request_id
+              WHERE o2.offer_id = NEW.offer_id
+          );
+    RETURN NEW;
+END;
+$$
+LANGUAGE plpgsql;
+CREATE OR REPLACE TRIGGER trg_update_slot_status
+AFTER INSERT ON Booking
+FOR EACH ROW
+EXECUTE FUNCTION fn_update_slot_status();
+}}}
+=== 2. trg_prevent_double_booking ===
 Тригерот {{{trg_prevent_double_booking}}} спречува двоен booking — ситуација каде ист артист или бенд би бил потврден за два различни настани на ист датум.
 Се извршува автоматски '''пред''' секој нов запис во табелата {{{Booking}}} ({{{BEFORE INSERT}}}). Доколку за истиот артист веќе постои {{{CONFIRMED}}} booking на истиот датум, тригерот фрла исклучок и го спречува вметнувањето.
+Се извршува автоматски '''пред''' секој нов запис во табелата {{{Booking}}} ({{{BEFORE INSERT}}}). Преку subquery-и го пронаоѓа артистот и датумот на новиот booking и проверува дали веќе постои {{{CONFIRMED}}} booking за истата комбинација. Доколку постои, тригерот фрла исклучок и го спречува вметнувањето.
 {{{
 CREATE OR REPLACE FUNCTION fn_prevent_double_booking()
 …
 $$
 DECLARE
+    v_count      INT;
+    v_bookable   INT;
+    v_event_date DATE;
+BEGIN
+    SELECT o.bookable_id, br.event_date
+    INTO v_bookable, v_event_date
+    FROM Offer o
+    JOIN BookingRequest br ON br.request_id = o.request_id
+    WHERE o.offer_id = NEW.offer_id;
+    v_count INT;
+BEGIN
     SELECT COUNT(*)
 …
     FROM Booking b
     JOIN Offer o
         ON b.offer_id = o.offer_id
+      ON b.offer_id = o.offer_id
     JOIN BookingRequest br
+        ON br.request_id = o.request_id
+    WHERE o.bookable_id = v_bookable
+      AND br.event_date = v_event_date
+      ON br.request_id = o.request_id
+    WHERE o.bookable_id = (
+              SELECT bookable_id
+              FROM Offer
+              WHERE offer_id = NEW.offer_id
+          )
+      AND br.event_date = (
+              SELECT br2.event_date
+              FROM BookingRequest br2
+              JOIN Offer o2 ON o2.request_id = br2.request_id
+              WHERE o2.offer_id = NEW.offer_id
+          )
       AND b.booking_status = 'CONFIRMED';
     IF v_count > 0 THEN
+        RAISE EXCEPTION 'Artist/Band with ID % is already booked on %!',
+            v_bookable, v_event_date;
+        RAISE EXCEPTION 'Artist already booked on that date!';
     END IF;
 …
 FOR EACH ROW
 EXECUTE FUNCTION fn_prevent_double_booking();
-}}}
-=== 2. trg_update_slot_status ===
-Тригерот {{{trg_update_slot_status}}} автоматски го означува слободниот термин на артистот како {{{BOOKED}}} во моментот кога се креира нов booking.
-Се извршува автоматски '''по''' секој нов запис во табелата {{{Booking}}} ({{{AFTER INSERT}}}). Го пронаоѓа соодветниот {{{AvailabilitySlot}}} според артистот и датумот на настанот и го менува неговиот статус — со тоа се спречува двојна резервација на ист термин.
-{{{
-CREATE OR REPLACE FUNCTION fn_update_slot_status()
-RETURNS TRIGGER
-AS
-$$
-DECLARE
-    v_bookable   INT;
-    v_event_date DATE;
-BEGIN
-    SELECT o.bookable_id, br.event_date
-    INTO v_bookable, v_event_date
-    FROM Offer o
-    JOIN BookingRequest br ON br.request_id = o.request_id
-    WHERE o.offer_id = NEW.offer_id;
-    UPDATE AvailabilitySlot
-    SET status = 'BOOKED'
-    WHERE bookable_id = v_bookable
-      AND DATE(start_datetime) = v_event_date
-      AND status = 'AVAILABLE';
-    RETURN NEW;
-END;
-$$
-LANGUAGE plpgsql;
-CREATE OR REPLACE TRIGGER trg_update_slot_status
-AFTER INSERT ON Booking
-FOR EACH ROW
-EXECUTE FUNCTION fn_update_slot_status();
 }}}