= Резервирање термин

== Актери
 * Најавен корисник (клиент)

== Чекор 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“, како и да остави рецензија по извршување на услугата.