= Купување пакет

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

== Чекор 1
Најавениот корисник ја отвора страницата за пакети, на пример:
 * страницата '''Book an Appointment''' (/book), каде се прикажува листа на пакети, или  
 * страницата '''My Packages''' (/my-packages).

Системот му прикажува листа на достапни пакети со:
 * име на пакет,
 * максимален број користења (max_usage),
 * вкупна цена,
 * услугите што се вклучени во пакетот.

Податоците за пакетите се вчитуваат со следниот SQL:

{{{
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;
}}}
== Чекор 2
Корисникот избира едно од две можни дејства:

 * '''Buy only''' – корисникот го купува пакетот, без веднаш да резервира термин.  
   Во овој случај, системот само ја евидентира куповката во базата.

 * '''Buy & use now''' – корисникот го купува пакетот и веднаш планира да го искористи во тековната резервација.  
   Во овој случај, по успешно купување, сценариото продолжува кон чекорите за резервирање термин, при што купениот пакет ќе се примени на резервацијата.
== Чекор 3
Системот го проверува избраниот пакет и ја пресметува вкупната цена што треба да се плати.

Се вчитува пакетот од базата според ''package_id'':

{{{
SELECT
  p.package_id,
  p.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
FROM package p
LEFT JOIN LATERAL (
  SELECT COALESCE(SUM(ps.discounted_price), 0)::numeric AS calc_total_price
  FROM packageservice ps
  WHERE ps.package_id = p.package_id
) package_price ON true
WHERE p.package_id = $1;
}}}

Параметар:
 * $1 – ''package_id'' на избраниот пакет.

Ако пакетот не постои, системот враќа грешка и купувањето се прекинува.

== Чекор 4
Доколку пакетот е валиден, системот креира запис дека корисникот го купил пакетот, преку складираната функција '''sp_user_purchase_package''':

{{{
SELECT sp_user_purchase_package($1::int, $2::int) AS purchase_id;
}}}

Параметри:
 * $1 – ''user_id'' на најавениот корисник,
 * $2 – ''package_id'' на избраниот пакет.

Функцијата ''sp_user_purchase_package'' вметнува ред во табелата ''UserPackagePurchase'' со:
 * ''user_id'' – корисникот кој купува пакет,
 * ''package_id'' – избраниот пакет,
 * ''total_uses'' – максимален број користења (''max_usage'' од ''Package''),
 * ''remaining_uses'' – почетно еднакво на ''total_uses'',
 * ''status'' – 'ACTIVE'.

== Чекор 5
Потоа системот креира запис за плаќањето на овој пакет во табелата ''payment''.  
Ова плаќање е поврзано со купениот пакет (''package_purchase_id''), а не со конкретен термин (''appointment_id'' е NULL):

{{{
INSERT INTO payment (amount, method, status, appointment_id, points_used, package_purchase_id)
VALUES ($1::numeric, $2::text, 'PENDING', NULL, 0, $3::int)
RETURNING payment_id;
}}}

Параметри:
 * $1 – вкупната цена на пакетот (''total_price'' од Чекор 3),
 * $2 – метод на плаќање, на пример 'online' или 'CARD',
 * $3 – ''purchase_id'' добиен од ''sp_user_purchase_package''.

Во овој тек:
 * ''appointment_id'' е NULL (се купува пакет, не термин),
 * ''points_used = 0'' – не се дозволува користење лојалти поени за купување пакет.

Ограничувањата за ова плаќање се спроведуваат и преку trigger функцијата '''trg_payment_validate''', која осигурува дека:
 * има или ''appointment_id'' или ''package_purchase_id'',
 * за купување пакет (''appointment_id IS NULL'' и ''package_purchase_id IS NOT NULL'') сумата на плаќањето одговара на вкупната цена на пакетот,
 * не може да се користат лојалти поени (''points_used'' мора да биде 0).

== Чекор 6
По успешно креирање на плаќањето, системот го означува плаќањето како платено и доделува лојалти поени на корисникот со повик на функцијата '''sp_mark_payment_paid''':

{{{
SELECT sp_mark_payment_paid($1::int) AS points_used;
}}}

Параметар:
 * $1 – ''payment_id'' на креираното плаќање.

Во случај на купување пакет (т.е. кога плаќањето има ''package_purchase_id'' и ''appointment_id IS NULL''), функцијата:

 * проверува дека не постои друго 'PAID' плаќање за истото ''package_purchase_id'',
 * ја ажурира табелата ''payment'':
   * ''status = 'PAID' '',
   * ''amount'' = вкупната цена на пакетот,
   * ''points_used = 0'',
 * се грижи да постои лојалти картичка за корисникот преку ''sp_ensure_loyalty_card'',
 * пресметува колку поени да се доделат (на пример 5% од вкупната цена на пакетот) и ги зголемува ''points'' во табелата ''loyaltycard''.

Пример логика за доделување поени (во функцијата):

 * ''v_points_earned := FLOOR(COALESCE(v_total_price, 0) * 0.05);''
 * ''UPDATE loyaltycard SET points = points + v_points_earned WHERE user_id = v_user_id;''

== Чекор 7
По означувањето на плаќањето како платено, системот ги враќа деталите за купениот пакет за прикажување на корисникот:

{{{
SELECT
  upp.purchase_id,
  upp.package_id,
  p.name AS package_name,
  upp.total_uses,
  upp.remaining_uses,
  upp.status,
  upp.purchased_at,
  upp.expires_at
FROM userpackagepurchase upp
JOIN package p
  ON p.package_id = upp.package_id
WHERE upp.purchase_id = $1
LIMIT 1;
}}}

Параметар:
 * $1 – ''purchase_id'' на купениот пакет.

Дополнително, се вчитува и моменталниот број лојалти поени:

{{{
SELECT points
FROM loyaltycard
WHERE user_id = $1;
}}}

== Резултат
 * Во табелата ''UserPackagePurchase'' постои нов запис за купениот пакет, со ''status = 'ACTIVE' '' и иницијално ''remaining_uses = total_uses''.
 * Во табелата ''payment'' постои запис за плаќањето на пакетот со ''status = 'PAID' '', правилен износ и ''points_used = 0''.
 * Во табелата ''loyaltycard'' се ажурира бројот на поени на корисникот (се доделуваат поени за купениот пакет).
 * Корисникот на екранот добива потврда дека пакетот е успешно купен и може:
   * да го види во '''My Packages''' со број на преостанати користења, или
   * во случај на опцијата '''Buy & use now''', веднаш да го искористи при создавање термин