= Functions, Procedures, Triggers = == Функции == Функциите ги пресметуваат износите и поените и ја проверуваат важноста на договорите. Припаѓаат на шемата `kbnteam`, се напишани на SQL и се означени како STABLE. Читаат податоци и враќаат вредност без да ги менуваат табелите. Можат да се користат во SQL изрази и во логиката на процедурите и тригерите. ||= Функција ||= Намена ||= Повратен тип || || [#fn_has_active_contract fn_has_active_contract] || Проверка на активен договор || `BOOLEAN` || || [#fn_calculate_order_total fn_calculate_order_total] || Пресметка на вкупен износ || `NUMERIC(10,2)` || || [#fn_calculate_customer_loyalty_points fn_calculate_customer_loyalty_points] || Пресметка на поени за лојалност || `INTEGER` || [[Anchor(fn_has_active_contract)]] === fn_has_active_contract === Враќа TRUE ако постои договор за зададената компанија и ресторан со статус active, а зададениот датум е меѓу почетниот и крајниот датум, вклучувајќи ги границите. Инаку враќа FALSE. Кога датумот не е зададен, се користи тековниот датум. Називот на статусот се споредува без разлика на големината на буквите. ||= Својство ||= Вредност || || Повратен тип || `BOOLEAN` || || Изворни табели || `contract`, `contract_status` || ||= Параметар ||= Тип ||= Стандардна вредност ||= Опис || || `p_company_id` || `INTEGER` || — || Идентификатор на компанијата. || || `p_rest_id` || `INTEGER` || — || Идентификатор на ресторанот. || || `p_on_date` || `DATE` || `CURRENT_DATE` || Датум за проверка на важноста на договорот. || Се користи од: [#trg_order_drink_guard_and_total trg_order_drink_guard_and_total], [#trg_order_meal_guard_and_total trg_order_meal_guard_and_total], [#pr_assign_delivery_to_company_order pr_assign_delivery_to_company_order], [#pr_add_order_item pr_add_order_item], [#pr_change_order_status pr_change_order_status], [#pr_submit_customer_order pr_submit_customer_order]. [[Anchor(fn_calculate_order_total)]] === fn_calculate_order_total === Ги собира тековните цени на јадењата и пијалоците поврзани со нарачката. Ако нема ставки, враќа 0.00. Не применува попуст за лојалност или дополнителен надомест за достава и не ја менува нарачката; запишувањето на пресметаниот износ го вршат процедурите и тригерите. ||= Својство ||= Вредност || || Повратен тип || `NUMERIC(10,2)` || || Изворни табели || `order_meal`, `meal`, `order_drink`, `drink` || ||= Параметар ||= Тип ||= Стандардна вредност ||= Опис || || `p_order_id` || `INTEGER` || — || Идентификатор на клиентската нарачка. || Се користи од: [#trg_order_drink_guard_and_total trg_order_drink_guard_and_total], [#trg_order_meal_guard_and_total trg_order_meal_guard_and_total], [#pr_remove_order_item pr_remove_order_item], [#pr_add_order_item pr_add_order_item], [#pr_finalize_company_order pr_finalize_company_order], [#pr_change_order_status pr_change_order_status], [#pr_submit_customer_order pr_submit_customer_order]. [[Anchor(fn_calculate_customer_loyalty_points)]] === fn_calculate_customer_loyalty_points === Ги собира износите на нарачките на клиентот, го заокружува збирот надолу и враќа цел број. Нарачките со статус cancelled придонесуваат со нула. Останатите статуси, вклучително pending и refunded, се вклучени. Ако нема нарачки, враќа нула. Функцијата ги пресметува поените, а нивното запишување го врши процедурата за освежување на лојалноста. ||= Својство ||= Вредност || || Повратен тип || `INTEGER` || || Изворни табели || `customer_order`, `order_status` || ||= Параметар ||= Тип ||= Стандардна вредност ||= Опис || || `p_customer_user_id` || `INTEGER` || — || Идентификатор на клиентот. || Се користи од: [#pr_refresh_customer_loyalty pr_refresh_customer_loyalty]. == Процедури == Процедурите ги опфаќаат операциите за договори, нарачки, достави, рецензии и лојалност. Припаѓаат на шемата `kbnteam`, се напишани на PL/pgSQL и се повикуваат со `CALL`. Проверките и промените на податоците се извршуваат во рамки на тековната трансакција. === Договори === ||= Процедура ||= Намена ||= Директно изменети табели || || [#pr_activate_or_renew_contract pr_activate_or_renew_contract] || Активирање или обновување договор || `contract` || === Нарачки и фактурирање === ||= Процедура ||= Намена ||= Директно изменети табели || || [#pr_create_company_order pr_create_company_order] || Создавање компаниска нарачка || `company_order` || || [#pr_create_customer_order pr_create_customer_order] || Создавање клиентска нарачка || `customer_order` || || [#pr_add_order_item pr_add_order_item] || Додавање јадење или пијалак || `order_meal`, `order_drink`, `customer_order` || || [#pr_remove_order_item pr_remove_order_item] || Отстранување јадење или пијалак || `order_meal`, `order_drink`, `customer_order` || || [#pr_submit_customer_order pr_submit_customer_order] || Поднесување клиентска нарачка || `customer_order` || || [#pr_change_order_status pr_change_order_status] || Промена на статус на нарачка || `customer_order` || || [#pr_finalize_company_order pr_finalize_company_order] || Финализирање и фактурирање || `customer_order`, `invoice` || === Достави === ||= Процедура ||= Намена ||= Директно изменети табели || || [#pr_assign_delivery_to_company_order pr_assign_delivery_to_company_order] || Доделување достава || `delivery`, `company_order` || || [#pr_change_delivery_status pr_change_delivery_status] || Промена на статус на достава || `delivery` || === Рецензии === ||= Процедура ||= Намена ||= Директно изменети табели || || [#pr_create_order_review pr_create_order_review] || Оценување клиентска нарачка || `review`, `order_review` || || [#pr_create_delivery_review pr_create_delivery_review] || Оценување достава || `review`, `delivery_review` || === Лојалност === ||= Процедура ||= Намена ||= Директно изменети табели || || [#pr_refresh_customer_loyalty pr_refresh_customer_loyalty] || Освежување лојалност || `customer_loyalty` || == Параметри и однесување == Параметрите без наведена насока се влезни (IN). Параметарот INOUT е истовремено влезен и излезен. Единствено создавањето компаниска нарачка го враќа новиот идентификатор преку INOUT параметар; останатите процедури немаат излезни параметри. [[Anchor(pr_activate_or_renew_contract)]] === pr_activate_or_renew_contract === Проверува дали компанијата и ресторанот постојат и дали периодот е валиден. Кога постои активен договор со период што се преклопува или е непосредно соседен, го проширува неговиот период. Ако нема таков договор, создава нов со статус active. Обновувањето се одбива ако проширениот период се преклопува со друг активен договор. ||= Параметар ||= Тип ||= Насока ||= Стандардна вредност ||= Опис || || `p_company_id` || `INTEGER` || IN || — || Компанија на која се однесува операцијата. || || `p_rest_id` || `INTEGER` || IN || — || Ресторан поврзан со договорот. || || `p_start_date` || `DATE` || IN || — || Почетен датум на договорот. || || `p_end_date` || `DATE` || IN || — || Краен датум на договорот. || [[Anchor(pr_create_company_order)]] === pr_create_company_order === Проверува дали компанијата постои и создава компаниска нарачка без доделена достава. Новиот идентификатор се враќа преку параметарот p_comp_order_id. ||= Параметар ||= Тип ||= Насока ||= Стандардна вредност ||= Опис || || `p_company_id` || `INTEGER` || IN || — || Компанија на која се однесува операцијата. || || `p_comp_order_id` || `INTEGER` || INOUT || `NULL` || Се пополнува со идентификаторот на новата компаниска нарачка. || [[Anchor(pr_create_customer_order)]] === pr_create_customer_order === Проверува дали клиентот и компаниската нарачка постојат и припаѓаат на иста компанија. Не дозволува додавање нарачка кон компаниска нарачка за која веќе има фактура. Создава клиентска нарачка со зададениот статус и почетен износ нула. ||= Параметар ||= Тип ||= Насока ||= Стандардна вредност ||= Опис || || `p_customer_user_id` || `INTEGER` || IN || — || Идентификатор на клиентот. || || `p_comp_order_id` || `INTEGER` || IN || — || Идентификатор на компаниската нарачка. || || `p_o_status_id` || `INTEGER` || IN || — || Почетен статус на клиентската нарачка. || [[Anchor(pr_add_order_item)]] === pr_add_order_item === Го прифаќа типот meal или drink и проверува дали производот постои. За ресторанот на производот е потребен активен договор со компанијата на клиентот на датумот на нарачката. Не дозволува повторно додавање на истиот производ, измена на нарачка со статус completed, cancelled или refunded, ниту измена по фактурирање. По додавањето повторно го пресметува вкупниот износ. ||= Параметар ||= Тип ||= Насока ||= Стандардна вредност ||= Опис || || `p_order_id` || `INTEGER` || IN || — || Идентификатор на клиентската нарачка. || || `p_item_type` || `VARCHAR(10)` || IN || — || Тип на производ: meal или drink. || || `p_item_id` || `INTEGER` || IN || — || Идентификатор на јадењето или пијалакот. || [[Anchor(pr_remove_order_item)]] === pr_remove_order_item === Го отстранува зададениот производ од нарачката и повторно го пресметува износот. Одбива отстранување производ што не е дел од нарачката. Не дозволува измени при статус completed, cancelled или refunded, ниту по фактурирање. ||= Параметар ||= Тип ||= Насока ||= Стандардна вредност ||= Опис || || `p_order_id` || `INTEGER` || IN || — || Идентификатор на клиентската нарачка. || || `p_item_type` || `VARCHAR(10)` || IN || — || Тип на производ: meal или drink. || || `p_item_id` || `INTEGER` || IN || — || Идентификатор на јадењето или пијалакот. || [[Anchor(pr_submit_customer_order)]] === pr_submit_customer_order === Проверува дали нарачката содржи барем едно јадење или пијалак и дали за секој вклучен ресторан постои активен договор на датумот на нарачката. Не дозволува поднесување при статус completed, cancelled или refunded, ниту по фактурирање. Го пресметува износот и го поставува статусот на pending. ||= Параметар ||= Тип ||= Насока ||= Стандардна вредност ||= Опис || || `p_order_id` || `INTEGER` || IN || — || Идентификатор на клиентската нарачка. || [[Anchor(pr_change_order_status)]] === pr_change_order_status === Проверува дали нарачката и новиот статус постојат и дали преминот е дозволен. За completed бара барем еден производ и активни договори со вклучените ресторани на датумот на нарачката, а потоа го пресметува износот. По фактурирање дозволува само премин од completed во refunded. При премин во completed, cancelled или refunded ја повикува процедурата за освежување на лојалноста. Повторно задавање на тековниот статус не предизвикува промена. ||= Параметар ||= Тип ||= Насока ||= Стандардна вредност ||= Опис || || `p_order_id` || `INTEGER` || IN || — || Идентификатор на клиентската нарачка. || || `p_new_status_id` || `INTEGER` || IN || — || Идентификатор на новиот статус. || [[Anchor(pr_finalize_company_order)]] === pr_finalize_company_order === Бара компаниската нарачка да постои, да нема фактура и да содржи клиентски нарачки. Сите клиентски нарачки мора да бидат completed и да содржат барем еден производ. Повторно ги пресметува нивните износи и создава една фактура за компаниската нарачка. Не бара доставата да има статус delivered. ||= Параметар ||= Тип ||= Насока ||= Стандардна вредност ||= Опис || || `p_comp_order_id` || `INTEGER` || IN || — || Идентификатор на компаниската нарачка. || [[Anchor(pr_assign_delivery_to_company_order)]] === pr_assign_delivery_to_company_order === За компаниска нарачка без достава создава нова достава и ја поврзува со нарачката. Проверува дали доставувачот постои и дали неговиот ресторан има активен договор со компанијата на датумот на доставата. Датумот, статусот и забелешките се запишуваат во новата достава. ||= Параметар ||= Тип ||= Насока ||= Стандардна вредност ||= Опис || || `p_comp_order_id` || `INTEGER` || IN || — || Идентификатор на компаниската нарачка. || || `p_driver_user_id` || `INTEGER` || IN || — || Идентификатор на доставувачот. || || `p_d_status_id` || `INTEGER` || IN || — || Почетен статус на доставата. || || `p_delivery_date` || `DATE` || IN || `CURRENT_DATE` || Датум на доставата. || || `p_delivery_notes` || `VARCHAR(255)` || IN || `NULL` || Забелешки за доставата. || [[Anchor(pr_change_delivery_status)]] === pr_change_delivery_status === Проверува дали доставата и новиот статус постојат и дали преминот е дозволен. Статусите assigned, picked up, on the way, delivered и delayed бараат назначен доставувач. За delivered дополнително бара доставата да биде поврзана со компаниска нарачка. Повторно задавање на тековниот статус не предизвикува промена. ||= Параметар ||= Тип ||= Насока ||= Стандардна вредност ||= Опис || || `p_delivery_id` || `INTEGER` || IN || — || Идентификатор на доставата. || || `p_new_status_id` || `INTEGER` || IN || — || Идентификатор на новиот статус. || [[Anchor(pr_create_order_review)]] === pr_create_order_review === Бара завршена нарачка со статус completed, поврзана со зададениот клиент, и проверува дали веќе постои рецензија за неа. Запишува општа оценка и коментар, како и посебни оценки за храната и ресторанот. Оценките се во опсег од 1 до 5. ||= Параметар ||= Тип ||= Насока ||= Стандардна вредност ||= Опис || || `p_order_id` || `INTEGER` || IN || — || Идентификатор на клиентската нарачка. || || `p_customer_user_id` || `INTEGER` || IN || — || Идентификатор на клиентот. || || `p_review_rating` || `INTEGER` || IN || — || Општа оценка од 1 до 5. || || `p_review_comment` || `VARCHAR(255)` || IN || — || Коментар за рецензијата. || || `p_food_rating` || `INTEGER` || IN || — || Оценка за храната од 1 до 5. || || `p_restaurant_rating` || `INTEGER` || IN || — || Оценка за ресторанот од 1 до 5. || [[Anchor(pr_create_delivery_review)]] === pr_create_delivery_review === Бара достава со статус delivered и клиент што има нарачка поврзана со таа достава. Не дозволува втора рецензија за истата достава, независно од клиентот. Запишува општа оценка и коментар, како и оценки за доставувачот и брзината, во опсег од 1 до 5. ||= Параметар ||= Тип ||= Насока ||= Стандардна вредност ||= Опис || || `p_delivery_id` || `INTEGER` || IN || — || Идентификатор на доставата. || || `p_customer_user_id` || `INTEGER` || IN || — || Идентификатор на клиентот. || || `p_review_rating` || `INTEGER` || IN || — || Општа оценка од 1 до 5. || || `p_review_comment` || `VARCHAR(255)` || IN || — || Коментар за рецензијата. || || `p_courier_rating` || `INTEGER` || IN || — || Оценка за доставувачот од 1 до 5. || || `p_speed_rating` || `INTEGER` || IN || — || Оценка за брзината од 1 до 5. || [[Anchor(pr_refresh_customer_loyalty)]] === pr_refresh_customer_loyalty === Ги пресметува поените на клиентот и избира ниво чиј опсег ги содржи поените. При повеќе совпаѓања го избира нивото со најголем долен праг; ако нема совпаѓање, го избира нивото со најмал долен праг. Го користи статусот на лојалност со најмал идентификатор. Создава членство или ги ажурира поените, нивото и статусот на постојното членство. ||= Параметар ||= Тип ||= Насока ||= Стандардна вредност ||= Опис || || `p_customer_user_id` || `INTEGER` || IN || — || Идентификатор на клиентот. || == Дозволени промени на статус == === Клиентска нарачка === ||= Тековен статус ||= Дозволени следни статуси || || `pending` || `on-hold`, `backorder`, `completed`, `cancelled` || || `on-hold` || `pending`, `backorder`, `completed`, `cancelled` || || `backorder` || `pending`, `on-hold`, `completed`, `cancelled` || || `completed` || `refunded` || || `cancelled`, `refunded` || Нема премин во друг статус. || Овие премини се однесуваат на [#pr_change_order_status pr_change_order_status]. За нарачка во фактурирана компаниска нарачка е дозволен само преминот completed → refunded. Создавањето нарачка го користи зададениот почетен статус, а поднесувањето ја поставува на pending според сопствените проверки. === Достава === ||= Тековен статус ||= Дозволени следни статуси || || `pending` || `assigned`, `cancelled` || || `assigned` || `picked up`, `delayed`, `failed`, `cancelled` || || `picked up` || `on the way`, `delayed`, `failed`, `cancelled` || || `on the way` || `delivered`, `delayed`, `failed` || || `delayed` || `assigned`, `picked up`, `on the way`, `delivered`, `failed`, `cancelled` || || `delivered`, `failed`, `cancelled` || Нема премин во друг статус. || Овие премини се однесуваат на [#pr_change_delivery_status pr_change_delivery_status]. При создавање достава се користи зададениот почетен статус. Во двете процедури за промена на статус, називите се споредуваат без разлика на големината на буквите и повторување на тековниот статус завршува без измена. == Тригери == Тригерите автоматски се активираат при промени на податоците. Сите се извршуваат за секој засегнат ред. Проверката на компанијата се извршува пред промената на клиентската нарачка, а проверките на ставките и пресметката на износот по нивното внесување, измена или бришење. ||= Тригер ||= Табела ||= Момент ||= Настан || || [#trg_validate_customer_order_company trg_validate_customer_order_company] || `kbnteam.customer_order` || `BEFORE` || `INSERT OR UPDATE OF customer_user_id, comp_order_id` || || [#trg_order_meal_guard_and_total trg_order_meal_guard_and_total] || `kbnteam.order_meal` || `AFTER` || `INSERT OR UPDATE OR DELETE` || || [#trg_order_drink_guard_and_total trg_order_drink_guard_and_total] || `kbnteam.order_drink` || `AFTER` || `INSERT OR UPDATE OR DELETE` || [[Anchor(trg_validate_customer_order_company)]] === trg_validate_customer_order_company === Проверува дали клиентот и компаниската нарачка постојат и припаѓаат на иста компанија. При неуспешна проверка ја прекинува наредбата со исклучок. При успешна проверка го враќа новиот ред (NEW). Проверката се активира при внесување нарачка и при ажурирање што ги наведува customer_user_id или comp_order_id. Ажурирање само на order_total или статусот не го активира овој тригер. ||= Својство ||= Вредност || || Табела || `kbnteam.customer_order` || || Момент || `BEFORE` || || Настан || `INSERT OR UPDATE OF customer_user_id, comp_order_id` || || Опфат || За секој засегнат ред (FOR EACH ROW). || || Тригер-функција || [#tf_validate_customer_order_company tf_validate_customer_order_company] || [[Anchor(trg_order_meal_guard_and_total)]] === trg_order_meal_guard_and_total === При внесување или измена на ставка проверува дали нарачката е поврзана со валиден клиент и компанија и дали постои активен договор со ресторанот на јадењето на датумот на нарачката. Потоа повторно го пресметува и запишува вкупниот износ на нарачката. При бришење не проверува договор, туку го освежува износот на старата нарачка. Ако со UPDATE ставката се префрли во друга нарачка, ги освежува износите и на новата и на старата нарачка. ||= Својство ||= Вредност || || Табела || `kbnteam.order_meal` || || Момент || `AFTER` || || Настан || `INSERT OR UPDATE OR DELETE` || || Опфат || За секој засегнат ред (FOR EACH ROW). || || Тригер-функција || [#tf_order_meal_guard_and_total tf_order_meal_guard_and_total] || Ги користи [#fn_has_active_contract fn_has_active_contract] за проверка на договорот и [#fn_calculate_order_total fn_calculate_order_total] за пресметка на износот. Бидејќи се извршува AFTER, пресметката ја опфаќа изменетата состојба на ставките. Исклучок од проверката ја прекинува тековната наредба. [[Anchor(trg_order_drink_guard_and_total)]] === trg_order_drink_guard_and_total === При внесување или измена на ставка проверува дали нарачката е поврзана со валиден клиент и компанија и дали постои активен договор со ресторанот на пијалакот на датумот на нарачката. Потоа повторно го пресметува и запишува вкупниот износ на нарачката. При бришење не проверува договор, туку го освежува износот на старата нарачка. Ако со UPDATE ставката се префрли во друга нарачка, ги освежува износите и на новата и на старата нарачка. ||= Својство ||= Вредност || || Табела || `kbnteam.order_drink` || || Момент || `AFTER` || || Настан || `INSERT OR UPDATE OR DELETE` || || Опфат || За секој засегнат ред (FOR EACH ROW). || || Тригер-функција || [#tf_order_drink_guard_and_total tf_order_drink_guard_and_total] || Ги користи [#fn_has_active_contract fn_has_active_contract] за проверка на договорот и [#fn_calculate_order_total fn_calculate_order_total] за пресметка на износот. Бидејќи се извршува AFTER, пресметката ја опфаќа изменетата состојба на ставките. Исклучок од проверката ја прекинува тековната наредба. === Тригер-функции === Тригер-функциите се напишани на PL/pgSQL и враќаат тип TRIGGER. Немаат декларирани влезни параметри; ги користат податоците за активирањето и редовите NEW и OLD. Нивното извршување го повикува соодветниот тригер. [[Anchor(tf_validate_customer_order_company)]] ==== tf_validate_customer_order_company ==== ||= Својство ||= Вредност || || Повратен тип || `TRIGGER` || || Активиран преку || [#trg_validate_customer_order_company trg_validate_customer_order_company] || || Однесување || Го враќа NEW по успешна проверка на компанијата. || [[Anchor(tf_order_meal_guard_and_total)]] ==== tf_order_meal_guard_and_total ==== ||= Својство ||= Вредност || || Повратен тип || `TRIGGER` || || Активиран преку || [#trg_order_meal_guard_and_total trg_order_meal_guard_and_total] || || Однесување || Го враќа COALESCE(NEW, OLD). Кај AFTER тригерот повратниот ред не го заменува запишаниот ред; ефектот е проверката и ажурирањето на износот. || [[Anchor(tf_order_drink_guard_and_total)]] ==== tf_order_drink_guard_and_total ==== ||= Својство ||= Вредност || || Повратен тип || `TRIGGER` || || Активиран преку || [#trg_order_drink_guard_and_total trg_order_drink_guard_and_total] || || Однесување || Го враќа COALESCE(NEW, OLD). Кај AFTER тригерот повратниот ред не го заменува запишаниот ред; ефектот е проверката и ажурирањето на износот. || === Поврзаност со процедурите === Проверките за статус на нарачката и за постоење фактура се дел од процедурите за додавање и отстранување производи. Тригерите за ставки ги проверуваат договорите и го освежуваат износот, но не ги повторуваат тие проверки за статус и фактурирање. Процедурите за додавање и отстранување производи исто така го пресметуваат износот. Кога тригерите се активни, пресметката се извршува и автоматски при промената на ставките. Ажурирањето на order_total не го активира тригерот за проверка на компанијата. == Поврзаност меѓу операциите == Компаниската нарачка ги обединува клиентските нарачки на една компанија. Во клиентските нарачки се додаваат производи, се проверуваат договорите и се пресметуваат износите. Завршените нарачки можат да се оценуваат, а компаниската нарачка се финализира со создавање фактура. Доставата има сопствен тек на статуси и може да се оценува откако ќе биде доставена. === Помошни пресметки и проверки === ||= Функција ||= Улога || || [#fn_has_active_contract fn_has_active_contract] || Проверува дали за компанијата и ресторанот постои договор со статус active што го опфаќа зададениот датум. || || [#fn_calculate_order_total fn_calculate_order_total] || Ги собира тековните цени на јадењата и пијалоците во нарачката. || || [#fn_calculate_customer_loyalty_points fn_calculate_customer_loyalty_points] || Го заокружува надолу збирот на износите на нарачките на клиентот, при што нарачките со статус cancelled придонесуваат со нула. Останатите статуси, вклучително refunded, се вклучени во тековната пресметка. || Процедурата [#pr_change_order_status pr_change_order_status] ја повикува [#pr_refresh_customer_loyalty pr_refresh_customer_loyalty] при промена во completed, cancelled или refunded. Освежувањето бара постојни нивоа и статуси на лојалност.