Changes between Initial Version and Version 1 of Book

Timestamp:

03/03/26 09:06:51 (3 weeks ago)

Author:

202033

Comment:

--

Book

@@ +1 @@
+= Резервирање термин
+
+== Актери
+ * Најавен корисник (клиент)
+
+== Чекор 1
+Најавениот корисник кликнува на копчето „Book Now“ од главната навигација.
+
+== Чекор 2
+Системот ја прикажува страницата за резервирање термин со:
+ * листа на услуги по категории (име, цена, времетраење),
+ * листа на пакети (име, максимален број користења, вкупна цена и услуги во пакетот),
+ * формa за избор на датум, термин и начин на плаќање.
+
+Податоците за категориите и услугите се вчитани преку SQL погледот `v_services_grouped_by_category`:
+
+{{{
+SELECT category_id, category_name, services
+FROM v_services_grouped_by_category
+ORDER BY category_id;
+}}}
+
+Пакетите се вчитуваат со:
+
+{{{
+SELECT
+  p.package_id,
+  p.name AS package_name,
+  p.max_usage,
+  CASE
+    WHEN EXISTS (
+      SELECT 1
+      FROM information_schema.columns
+      WHERE table_name = 'package'
+        AND column_name = 'total_price'
+    ) THEN p.total_price
+    ELSE package_price.calc_total_price
+  END::numeric AS total_price,
+  s.service_id,
+  s.name AS service_name,
+  ps.discounted_price
+FROM Package p
+LEFT JOIN LATERAL (
+  SELECT COALESCE(SUM(ps2.discounted_price), 0)::numeric AS calc_total_price
+  FROM PackageService ps2
+  WHERE ps2.package_id = p.package_id
+) package_price ON true
+LEFT JOIN PackageService ps
+  ON ps.package_id = p.package_id
+LEFT JOIN Service s
+  ON s.service_id = ps.service_id
+ORDER BY p.package_id, s.name;
+}}}
+
+== Чекор 3
+Корисникот избира една или повеќе услуги (пр. Anti-cellulite, Back Massage…).
+
+Системот ја пресметува вкупната цена и вкупното времетраење на терминот врз основа на избраните услуги.  
+Овие податоци подоцна ќе се користат при креирањето на терминот во базата (преку функциите `fn_service_total_minutes` и `fn_service_total_price` кои ги користи `sp_create_appointment`).
+
+== Чекор 4
+Корисникот избира датум за резервација во делот „Choose Date & Time“.
+
+Системот, врз основа на избраниот датум и избраните услуги, ги вчитува сите слободни термински слотови за тој ден, користејќи ја функцијата `fn_available_slots`:
+
+{{{
+SELECT
+  to_char(start_time, 'YYYY-MM-DD"T"HH24:MI:SS') AS start_time,
+  to_char(end_time,   'YYYY-MM-DD"T"HH24:MI:SS') AS end_time
+FROM fn_available_slots($1::date, $2::int[]);
+}}}
+
+Параметри:
+ * `$1` – избраниот датум,
+ * `$2` – низа од `service_id` на избраните услуги.
+
+Функцијата `fn_available_slots` ги користи записите од табелата `availability` (само оние со `is_closed = false`) и ги исклучува сите слотови кои се преклопуваат со постоечки закажани термини (`SCHEDULED` appointments).
+
+== Чекор 5
+Системот му прикажува на корисникот листа од достапни термини (почетно време и траење) за избраниот датум.
+
+Корисникот избира еден термин од листата (пример 2025-05-10 14:00–15:00).
+
+== Чекор 6
+Корисникот во делот „Payment Option“ ја избира опцијата **„Pay now (online card payment)“** и по желба внесува број на лојалти поени што сака да ги искористи.
+
+Системот ја прикажува проценетата вредност:
+ * вкупна сума,
+ * можен попуст преку поени,
+ * финална сума за плаќање.
+
+(Пресметката на овој чекор е на апликативно ниво, но истиот број поени и сума ќе се користат во SQL функцијата за креирање плаќање.)
+
+== Чекор 7
+Корисникот го потврдува закажувањето со клик на „Confirm booking“.
+
+Системот креира нов appointment во базата со повик на функцијата `sp_create_appointment`:
+
+{{{
+SELECT sp_create_appointment($1, $2::timestamp, $3::int[], $4) AS appointment_id;
+}}}
+
+Параметри:
+ * `$1` – `user_id` на најавениот корисник,
+ * `$2` – избраниот `appointment_time` (почетно време на терминот),
+ * `$3` – низа од избрани `service_id`,
+ * `$4` – текстуална забелешка (`notes`), може да биде и `NULL`.
+
+Функцијата `sp_create_appointment`:
+ * проверува дека сите услуги постојат во табелата `service`,
+ * ја пресметува вкупната должина и крајното време на терминот,
+ * го наоѓа статусот `SCHEDULED` во табелата `status`,
+ * внесува запис во табелата `appointment`,
+ * внесува записи во табелата `appointmentservice` за сите услуги,
+ * ја повикува функцијата `fn_validate_appointment`, која проверува:
+   * дека терминот е во иднина,
+   * дека терминот е внатре во некој прозорец од табелата `availability`,
+   * дека нема преклопување со друг `SCHEDULED` термин.
+
+== Чекор 8
+По успешно креирање на appointment-от, системот креира плаќање за истиот термин користејќи ја функцијата `sp_create_payment`:
+
+{{{
+SELECT *
+FROM sp_create_payment($1, $2::int, $3::text, $4::int);
+}}}
+
+Параметри:
+ * `$1` – `user_id` на корисникот,
+ * `$2` – `appointment_id` од претходниот чекор,
+ * `$3` – метод на плаќање, на пример `'CARD'`,
+ * `$4` – број на лојалти поени што корисникот сака да ги искористи.
+
+Функцијата:
+ * го зема `total_price` од табелата `appointment`,
+ * ја проверува лојалти картичката (`loyaltycard`) преку `sp_ensure_loyalty_card`,
+ * пресметува колку поени може да се искористат (ограничено на процент од сумата),
+ * внесува запис во табелата `payment` со статус `PENDING` и поле `points_used`.
+
+== Чекор 9
+Кога плаќањето е успешно потврдено, системот го означува плаќањето како платено и ги ажурира лојалти поените со повик на функцијата `sp_mark_payment_paid`:
+
+{{{
+SELECT sp_mark_payment_paid($1::int) AS points_used;
+}}}
+
+Параметар:
+ * `$1` – `payment_id` на креираното плаќање.
+
+Функцијата:
+ * го ажурира статусот на записот во `payment` на `PAID`,
+ * ги намалува поените на корисникот (доколку користел поени) и ја поставува финалната сума,
+ * осигурува дека нема друго `PAID` плаќање за истиот appointment.
+
+== Резултат
+ * Во табелата `appointment` и `appointmentservice` се запишува успешно креиран термин со избраните услуги и временски опсег.
+ * Во табелата `payment` постои запис за плаќањето со статус `PAID` и коректно ажурирани `points_used` и износ.
+ * Корисникот на екранот добива потврда за успешно резервиран термин и подоцна може да го прегледа во „My Appointments“, како и да остави рецензија по извршување на услугата.